Guía de Inicio Rápido de Claude Code

¡Bienvenido a Claude Code! Este poderoso asistente de programación AI puede ayudarte a mejorar la eficiencia de programación y automatizar tareas de desarrollo.

1. Instalación y Configuración

1.1 Requisitos del Sistema

• Sistema Operativo: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows vía WSL
• Hardware: 4GB+ RAM
• Software: Node.js 18+
• Red: Conexión a Internet necesaria para autenticación y procesamiento AI

1.2 Pasos de Instalación

Instalación global usando npm:

npm install -g @anthropic-ai/claude-code

Importante: No uses sudo npm install -g, puede causar problemas de permisos y riesgos de seguridad.

Después de completar la instalación, navega a tu directorio de proyecto e inicia Claude Code:

cd your-awesome-project
claude

2. Obtención y Configuración de Clave API

2.1 Registro de Cuenta

1. Visita https://coultra.blueshirtmap.com
2. Haz clic en el botón de registro para crear una nueva cuenta
3. Completa la información de registro necesaria

2.2 Creación de Clave API

1. Después del inicio de sesión exitoso, ve a la página de gestión de claves API
2. Crea un nuevo grupo de claves API
3. Selecciona "ClaudeCode" como nombre del grupo
4. Genera y copia tu clave API

3. Configuración de Archivos

3.1 Configuración de Clave API

Método de Configuración de Archivo

Crear o editar archivo de configuración:

# Configuración de usuario (global)
~/.claude/settings.json

# Configuración de proyecto (nivel de proyecto)
.claude/settings.json

Ejemplo de archivo de configuración:

{
    "env": {
      "ANTHROPIC_API_KEY": "Tu-APIkey",
      "ANTHROPIC_BASE_URL": "https://coultra.blueshirtmap.com",
      "CLAUDE_CODE_MAX_OUTPUT_TOKENS":64000,
      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1,
      "CLAUDE_MODEL": "Nombre-modelo-Claude"
    },
    "permissions": {
      "allow": [],
      "deny": []
    }
  }

3.2 Configuración de Permisos (Opcional)

Claude Code adopta una política de permisos conservadora, requiriendo confirmación del usuario para operaciones que pueden modificar el sistema por defecto. Puedes personalizar la lista de herramientas permitidas:

• Usa el comando /permissions para agregar o quitar herramientas
• Edita el archivo settings.json para configuración por lotes
• Usa la bandera CLI --allowedTools para configurar permisos específicos de sesión

3.3 Configuración de Directorio de Trabajo (Opcional)

Configurar directorios de trabajo adicionales que Claude puede acceder:

{
  "permissions": {
    "additionalDirectories": ["../docs/", "../shared/"]
  }
}

3.4 Configuración Rápida - Script de Un Clic

Después de comprar el API, solo necesitas modificar la línea 8 de este script readonly API_KEY="", completar tu APIkey (token), guardar este script como claudecode.sh, luego abrir la terminal:

chmod +x claudecode.sh
./claudecode.sh

Solo sigue las indicaciones.

#!/bin/bash

# ==============================================================================
# 🔧 Área de Configuración - Por favor configura tu API aquí
# ==============================================================================

# 🔑 Clave API - Por favor completa tu clave API
readonly API_KEY=""

# 🌐 URL Base API - Por favor completa tu dirección base API (ej: "https://coultra.blueshirtmap.com")
readonly API_BASE_URL="https://coultra.blueshirtmap.com"

# ==============================================================================
# No modifiques el contenido de abajo
# ==============================================================================

# Constantes del script
readonly CLAUDE_COMMAND="claude"
readonly NPM_PACKAGE="@anthropic-ai/claude-code"
readonly CLAUDE_DIR="$HOME/.claude"
readonly SETTINGS_FILE="$CLAUDE_DIR/settings.json"

# Detectar sistema operativo
detect_os() {
    case "$(uname -s)" in
        Darwin)
            echo "macos"
            ;;
        Linux)
            echo "linux"
            ;;
        *)
            echo "unknown"
            ;;
    esac
}

# Verificar si la configuración está completa
check_config() {
    if [ -z "$API_KEY" ] || [ -z "$API_BASE_URL" ]; then
        echo "❌ ¡Configuración incompleta! Por favor edita el script y completa la siguiente información:"
        echo "  - API_KEY: Tu clave API"
        echo "  - API_BASE_URL: Dirección base API (ej: https://coultra.blueshirtmap.com )"
        exit 1
    fi
}

# Instalar Homebrew (solo macOS)
install_homebrew() {
    if ! command -v brew &> /dev/null; then
        echo "Instalando Homebrew..."
        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
        
        # Agregar Homebrew al PATH
        if [[ -f "/opt/homebrew/bin/brew" ]]; then
            eval "$(/opt/homebrew/bin/brew shellenv)"
        elif [[ -f "/usr/local/bin/brew" ]]; then
            eval "$(/usr/local/bin/brew shellenv)"
        fi
        
        echo "✅ Instalación de Homebrew completada"
    else
        echo "ℹ️ Homebrew ya está instalado"
    fi
}

# Instalar paquetes en macOS
install_macos_packages() {
    install_homebrew
    
    # Instalar Node.js (incluye npm)
    if ! command -v node &> /dev/null; then
        echo "Instalando Node.js..."
        brew install node
        echo "✅ Instalación de Node.js completada"
    else
        echo "ℹ️ Node.js ya está instalado"
    fi
    
    # Instalar jq
    if ! command -v jq &> /dev/null; then
        echo "Instalando jq..."
        brew install jq
        echo "✅ Instalación de jq completada"
    else
        echo "ℹ️ jq ya está instalado"
    fi
    
    # Instalar Python3
    if ! command -v python3 &> /dev/null; then
        echo "Instalando Python3..."
        brew install python3
        echo "✅ Instalación de Python3 completada"
    else
        echo "ℹ️ Python3 ya está instalado"
    fi
}

# Instalar paquetes en Linux
install_linux_packages() {
    # Detectar distribución Linux
    if command -v apt-get &> /dev/null; then
        # Ubuntu/Debian
        echo "Sistema Ubuntu/Debian detectado"
        
        # Actualizar gestor de paquetes
        echo "Actualizando gestor de paquetes..."
        sudo apt-get update
        
        # Instalar Node.js
        if ! command -v node &> /dev/null; then
            echo "Instalando Node.js..."
            # Instalar repositorio NodeSource
            curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
            sudo apt-get install -y nodejs
            echo "✅ Instalación de Node.js completada"
        else
            echo "ℹ️ Node.js ya está instalado"
        fi
        
        # Instalar jq
        if ! command -v jq &> /dev/null; then
            echo "Instalando jq..."
            sudo apt-get install -y jq
            echo "✅ Instalación de jq completada"
        else
            echo "ℹ️ jq ya está instalado"
        fi
        
        # Instalar Python3
        if ! command -v python3 &> /dev/null; then
            echo "Instalando Python3..."
            sudo apt-get install -y python3 python3-pip
            echo "✅ Instalación de Python3 completada"
        else
            echo "ℹ️ Python3 ya está instalado"
        fi
        
    elif command -v yum &> /dev/null; then
        # CentOS/RHEL
        echo "Sistema CentOS/RHEL detectado"
        
        # Instalar Node.js
        if ! command -v node &> /dev/null; then
            echo "Instalando Node.js..."
            curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
            sudo yum install -y nodejs
            echo "✅ Instalación de Node.js completada"
        else
            echo "ℹ️ Node.js ya está instalado"
        fi
        
        # Instalar jq
        if ! command -v jq &> /dev/null; then
            echo "Instalando jq..."
            sudo yum install -y jq
            echo "✅ Instalación de jq completada"
        else
            echo "ℹ️ jq ya está instalado"
        fi
        
        # Instalar Python3
        if ! command -v python3 &> /dev/null; then
            echo "Instalando Python3..."
            sudo yum install -y python3 python3-pip
            echo "✅ Instalación de Python3 completada"
        else
            echo "ℹ️ Python3 ya está instalado"
        fi
        
    elif command -v pacman &> /dev/null; then
        # Arch Linux
        echo "Sistema Arch Linux detectado"
        
        # Instalar Node.js
        if ! command -v node &> /dev/null; then
            echo "Instalando Node.js..."
            sudo pacman -S --noconfirm nodejs npm
            echo "✅ Instalación de Node.js completada"
        else
            echo "ℹ️ Node.js ya está instalado"
        fi
        
        # Instalar jq
        if ! command -v jq &> /dev/null; then
            echo "Instalando jq..."
            sudo pacman -S --noconfirm jq
            echo "✅ Instalación de jq completada"
        else
            echo "ℹ️ jq ya está instalado"
        fi
        
        # Instalar Python3
        if ! command -v python3 &> /dev/null; then
            echo "Instalando Python3..."
            sudo pacman -S --noconfirm python python-pip
            echo "✅ Instalación de Python3 completada"
        else
            echo "ℹ️ Python3 ya está instalado"
        fi
        
    else
        echo "❌ Distribución Linux no soportada, por favor instala manualmente los siguientes paquetes:"
        echo "  - Node.js (incluye npm)"
        echo "  - jq"
        echo "  - python3"
        exit 1
    fi
}

# Instalar Claude Code
install_claude_code() {
    if command -v "$CLAUDE_COMMAND" &> /dev/null; then
        echo "ℹ️ Claude Code ya está instalado"
    else
        echo "Instalando Claude Code..."
        
        if ! command -v npm &> /dev/null; then
            echo "❌ npm no está instalado, no se puede instalar Claude Code"
            exit 1
        fi
        
        if ! npm install -g "$NPM_PACKAGE"; then
            echo "❌ Falló la instalación de Claude Code"
            exit 1
        fi
        
        echo "✅ Instalación de Claude Code completada"
    fi
}

# Configurar Claude Code
configure_claude_code() {
    echo "Configurando Claude Code..."
    
    # Crear directorio .claude
    if [ ! -d "$CLAUDE_DIR" ]; then
        mkdir -p "$CLAUDE_DIR"
    fi
    
    # Respaldar configuración original (si existe)
    if [ -f "$SETTINGS_FILE" ]; then
        cp "$SETTINGS_FILE" "$SETTINGS_FILE.backup"
        echo "ℹ️ Configuración original respaldada como settings.json.backup"
    fi
    
    # Crear nuevo archivo de configuración
    cat > "$SETTINGS_FILE" << EOF
{
  "env": {
    "ANTHROPIC_API_KEY": "$API_KEY",
    "ANTHROPIC_BASE_URL": "$API_BASE_URL",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 64000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "apiKeyHelper": "echo '$API_KEY'"
}
EOF
    
    echo "✅ Archivo de configuración creado"
}

# Función principal
main() {
    echo "🚀 Script de Instalación y Configuración Automática de Claude Code"
    echo "================================================================="
    
    # Verificar configuración
    check_config
    
    # Detectar sistema operativo
    OS=$(detect_os)
    echo "Sistema operativo detectado: $OS"
    
    # Instalar dependencias según el sistema operativo
    case "$OS" in
        "macos")
            install_macos_packages
            ;;
        "linux")
            install_linux_packages
            ;;
        *)
            echo "❌ Sistema operativo no soportado: $OS"
            exit 1
            ;;
    esac
    
    # Instalar Claude Code
    install_claude_code
    
    # Configurar Claude Code
    configure_claude_code
    
    echo "🎉 ¡Toda la configuración completada!"
    echo "Ubicación del archivo de configuración: $SETTINGS_FILE"
    echo "¡Ahora puedes usar el comando 'claude'!"
}

# Ejecutar función principal
main "$@"

4. Uso Básico

4.1 Formas de Inicio

Modo Interactivo

claude

Iniciar con Prompt Inicial

claude "explain this project"

Modo No Interactivo

claude -p "explain this function"

Procesar Entrada de Pipeline

cat logs.txt | claude -p "explain"

4.2 Comandos Comunes

• claude update - Actualizar a la última versión
• claude -c - Continuar la conversación más reciente
• claude -r <session-id> - Recuperar sesión específica
• claude mcp - Configurar servidores MCP

4.3 Atajos de Teclado

Control General

• Ctrl+C: Cancelar entrada o generación actual
• Ctrl+D: Salir de la sesión de Claude Code
• Ctrl+L: Limpiar pantalla de terminal
• Up/Down: Navegar historial de comandos
• Esc + Esc: Editar último mensaje

Entrada Multi-línea

• \ + Enter: Aplicable a todas las terminales
• Option+Enter: Predeterminado de macOS
• Shift+Enter: Disponible después de ejecutar /terminal-setup

5. Características Avanzadas

5.1 Referencia CLI

Claude Code proporciona opciones de línea de comandos ricas para personalizar su comportamiento:

Comandos CLI Básicos

Comando	Descripción	Ejemplo
claude	Iniciar REPL interactivo	claude
claude "query"	Iniciar REPL con prompt inicial	claude "explain this project"
claude -p "query"	Consultar vía SDK y salir	claude -p "explain this function"
claude -c	Continuar conversación más reciente	claude -c
claude update	Actualizar a la última versión	claude update

Banderas CLI Importantes

Bandera	Descripción	Ejemplo
--allowedTools	Lista de herramientas permitidas	--allowedTools "Bash(git log:*)" "Read"
--verbose	Habilitar registro detallado	claude --verbose
--model	Configurar modelo a usar	claude --model claude-sonnet-4
--permission-mode	Especificar modo de permisos	claude --permission-mode plan
--dangerously-skip-permissions	Omitir prompts de permisos (usar con precaución)	claude --dangerously-skip-permissions

5.2 Modo Interactivo

Modo Vim

Habilitar edición estilo vim:

/vim

Cambio de Modos

• Esc: Entrar modo NORMAL
• i: Insertar antes del cursor
• a: Insertar después del cursor
• o: Crear nueva línea abajo

Navegación (modo NORMAL)

• h/j/k/l: Mover izquierda/abajo/arriba/derecha
• w: Siguiente palabra
• 0: Inicio de línea
• $: Final de línea
• gg: Inicio del texto
• G: Final del texto

5.3 Comandos Slash

Claude Code proporciona varios comandos slash para mejorar la experiencia interactiva:

Comandos Básicos

Comando	Descripción	Ejemplo
/help	Mostrar información de ayuda	/help
/clear	Limpiar historial de conversación	/clear
/config	Gestionar configuración	/config
/permissions	Gestionar permisos	/permissions
/vim	Habilitar modo vim	/vim

Comandos Avanzados

Comando	Descripción	Funcionalidad
/init	Inicializar proyecto	Generar automáticamente archivo CLAUDE.md
/terminal-setup	Configurar terminal	Configurar atajos de teclado
/project:<command>	Comandos específicos de proyecto	Ejecutar comandos personalizados de proyecto

Comandos Slash Personalizados

Puedes crear comandos slash personalizados:

1. Crear archivos Markdown en el directorio .claude/commands/
2. El nombre del archivo se convierte en el nombre del comando
3. El contenido es la plantilla del comando, puede usar placeholder $ARGUMENTS

Ejemplo: .claude/commands/fix-github-issue.md

Por favor analiza y arregla el issue de GitHub: $ARGUMENTS.

Por favor sigue estos pasos:
1. Usar `gh issue view` para obtener detalles del issue
2. Entender la descripción del problema
3. Buscar archivos de código relacionados
4. Implementar las correcciones necesarias
5. Escribir y ejecutar pruebas
6. Asegurar que el código pase las verificaciones de lint
7. Crear mensaje de commit descriptivo
8. Hacer push y crear PR

6. Tutoriales Prácticos

6.1 Entender Nueva Base de Código

Obtener Rápidamente una Visión General de la Base de Código

Si acabas de unirte a un nuevo proyecto y quieres entender rápidamente su estructura, puedes seguir estos pasos:

1. Entrar al directorio raíz del proyecto: cd /path/to/project
2. Iniciar Claude Code: claude
3. Solicitar visión general de la base de código: > Dame una visión general de la base de código
4. Profundizar en componentes específicos:
   • > Explica los principales patrones arquitectónicos usados aquí
   • > ¿Cuáles son los modelos de datos clave?
   • > ¿Cómo se maneja la autenticación?

Consejos:

• Empieza con preguntas amplias, luego enfócate gradualmente en áreas específicas
• Pregunta sobre las convenciones de codificación y patrones usados en el proyecto
• Solicita un glosario de términos específicos del proyecto

Encontrar Código Relacionado

Cuando necesites localizar código relacionado con una funcionalidad específica, puedes operar así:

1. Solicitar a Claude buscar archivos relacionados: > Encuentra archivos que manejen autenticación de usuarios
2. Obtener contexto de interacción de componentes: > ¿Cómo trabajan juntos estos archivos de autenticación?
3. Entender el flujo de ejecución: > Rastrea el proceso de login desde frontend hasta base de datos

Consejos:

• Especifica claramente qué estás buscando
• Usa lenguaje específico del dominio del proyecto

6.2 Arreglar Bugs Eficientemente

Diagnosticar Mensajes de Error

Cuando encuentres errores, puedes encontrar y arreglar problemas de esta manera:

1. Compartir mensaje de error con Claude: > Veo este error al ejecutar npm test
2. Solicitar sugerencias de arreglo: > Proporciona algunas formas de arreglar el @ts-ignore en user.ts
3. Aplicar arreglo: > Actualiza user.ts, agrega la verificación null que sugeriste

Consejos:

• Dile a Claude el comando usado para reproducir el problema, y proporciona stack trace
• Menciona cualquier paso para reproducir el error
• Especifica si el error es intermitente o consistente

6.3 Refactorización de Código

Modernizar Código Antiguo

Cuando necesites actualizar código antiguo, adoptando patrones de programación modernos, puedes seguir estos pasos:

1. Identificar código antiguo para refactorizar: > Encuentra APIs deprecadas en nuestra base de código
2. Solicitar sugerencias de refactorización: > Sugiere cómo refactorizar utils.js usando características modernas de JavaScript
3. Aplicar cambios de forma segura: > Refactoriza utils.js usando características ES2024, manteniendo el comportamiento original
4. Verificar refactorización: > Ejecuta pruebas en el código refactorizado

Consejos:

• Pregunta a Claude sobre los beneficios de los métodos modernos
• Solicita mantener compatibilidad hacia atrás cuando sea necesario
• Realiza refactorizaciones incrementales pequeñas y probables

6.4 Manejo de Pruebas

Agregar Cobertura de Pruebas

Si necesitas agregar pruebas para código no cubierto, puedes seguir estos pasos:

1. Identificar código no probado: > Encuentra funciones no cubiertas en NotificationsService.swift
2. Generar marco de pruebas: > Agrega pruebas para el servicio de notificaciones
3. Agregar casos de prueba significativos: > Agrega casos de prueba para casos extremos en el servicio de notificaciones
4. Ejecutar y verificar pruebas: > Ejecuta las nuevas pruebas, arregla cualquier falla

Consejos:

• Solicita pruebas que cubran casos extremos y condiciones de error
• Pide pruebas unitarias e de integración según sea necesario
• Solicita a Claude que explique la estrategia de pruebas

6.5 Crear Pull Request

Generar PR Comprensivo

Cuando necesites crear un pull request bien documentado para tus cambios, sigue estos pasos:

1. Resumir tus cambios: > Resume los cambios que hice al módulo de autenticación
2. Usar Claude para generar PR: > Crea un PR
3. Revisar y mejorar descripción: > Mejora la descripción del PR, agrega más información sobre mejoras de seguridad
4. Agregar información de pruebas: > Agrega información sobre cómo probar estos cambios

Consejos:

• Solicita directamente a Claude que cree un PR para ti
• Revisa el PR generado por Claude antes de enviar
• Pide a Claude que resalte riesgos potenciales o consideraciones

6.6 Manejo de Documentación

Generar Documentación de Código

Si necesitas agregar o actualizar documentación de código, puedes seguir estos pasos:

1. Identificar código sin comentarios JSDoc apropiados: > Encuentra funciones sin comentarios JSDoc apropiados en el módulo auth
2. Generar documentación: > Agrega comentarios JSDoc a funciones sin comentarios en auth.js
3. Revisar y mejorar documentación: > Mejora la documentación generada, agrega más contexto y ejemplos
4. Verificar documentación: > Verifica si la documentación cumple los estándares de nuestro proyecto

Consejos:

• Especifica el estilo de documentación que necesitas (como JSDoc, docstrings, etc.)
• Solicita ejemplos en la documentación
• Pide documentación para APIs públicas, interfaces y lógica compleja

6.7 Uso de Imágenes

Analizar Imágenes y Capturas de Pantalla

Si necesitas usar imágenes en la base de código o hacer que Claude analice contenido de imágenes, sigue estos pasos:

1. Agregar imagen a la conversación:

   • Arrastra imagen a la ventana de Claude Code
   • Copia y pega imagen al CLI (ctrl+v)
   • Proporciona ruta de imagen: > Analiza esta imagen: /path/to/your/image.png

2. Solicitar a Claude analizar imagen:

   • > ¿Qué muestra esta imagen?
   • > Describe los elementos UI en esta captura de pantalla
   • > ¿Hay algún problema en este gráfico?

3. Usar imagen para obtener contexto:

   • > Esta es una captura del error, ¿qué lo está causando?
   • > Esta es la arquitectura actual de la base de datos, ¿cómo necesitamos modificarla para soportar la nueva funcionalidad?

4. Obtener sugerencias de código desde imágenes:

   • > Genera CSS que coincida con este boceto de diseño
   • > ¿Qué estructura HTML puede recrear este componente?

Consejos:

• Usa imágenes cuando la descripción textual no sea clara o sea tediosa
• Proporciona capturas de errores, diseños UI o diagramas para mejor contexto
• Puedes usar múltiples imágenes en la conversación

6.8 Configurar Memoria del Proyecto

Crear Archivo CLAUDE.md Efectivo

Para almacenar información importante del proyecto, convenciones y comandos comunes, puedes configurar un archivo CLAUDE.md:

Inicializar archivo CLAUDE.md para tu base de código: > /init

Consejos:

• Incluye comandos comunes (como build, test, lint) para evitar búsquedas repetidas
• Documenta preferencias de estilo de código y convenciones de nombrado
• Agrega patrones arquitectónicos importantes específicos del proyecto

Puedes agregar el archivo CLAUDE.md a la carpeta donde ejecutas Claude, directorios padre (Claude leerá automáticamente estos archivos) o subdirectorios (Claude los obtendrá según sea necesario).

6.9 Utilidades Estilo Unix

Agregar al Proceso de Verificación

Agregar Claude a tus scripts de build:

// package.json
{
  ...
  "scripts": {
    ...
    "lint:claude": "claude -p 'Eres una herramienta de verificación de código, por favor revisa las diferencias con la rama main, y reporta cualquier problema relacionado con errores de ortografía. Nombre de archivo y número de línea para cada problema en una línea, descripción en la segunda línea. No devuelvas ningún otro texto.'"
  }
}

Pipeline de Entrada y Salida

Hacer pipeline de datos a través de Claude:

cat build-error.txt | claude -p 'Explica brevemente la causa raíz de este error de build' > output.txt

6.10 Configuración de Servidores MCP

Configurar Servidores MCP

Si quieres mejorar las capacidades de Claude conectándolo a herramientas dedicadas y servidores externos, sigue estos pasos:

1. Agregar servidor MCP Stdio:

   • Sintaxis básica: claude mcp add <name> <command> [args...]
   • Ejemplo: Agregar servidor local: claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

2. Gestionar servidores MCP:

   • Listar todos los servidores configurados: claude mcp list
   • Obtener detalles de servidor específico: claude mcp get my-server
   • Eliminar servidor: claude mcp remove my-server

Consejos:

• Usa la bandera -s o --scope con project (predeterminado) o global para especificar dónde almacenar la configuración
• Usa la bandera -e o --env para configurar variables de entorno (ej., -e KEY=value)
• MCP sigue arquitectura cliente-servidor, Claude Code (cliente) puede conectarse a múltiples servidores dedicados

Conectar a Servidor MCP Postgres

Si quieres que Claude tenga acceso de solo lectura para consultar base de datos PostgreSQL y inspeccionar esquemas, sigue estos pasos:

1. Agregar servidor MCP Postgres:

   claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

2. Usar Claude para consultar base de datos:
   • > Describe el esquema de nuestra tabla de usuarios
   • > ¿Cuáles son los pedidos más recientes en el sistema?
   • > Muestra la relación entre clientes y facturas

Consejos:

• El servidor MCP Postgres proporciona acceso de solo lectura, asegurando seguridad
• Claude puede ayudarte a explorar estructura de base de datos y ejecutar consultas analíticas
• Úsalo para entender rápidamente esquemas de base de datos en proyectos desconocidos
• Asegúrate de que tu cadena de conexión use credenciales con permisos mínimos requeridos

7. Características Avanzadas

7.1 Integración IDE

Claude Code soporta conexión a IDEs principales:

• Puedes ver cambios de Claude Code directamente en el IDE, interactuar con él en el IDE
• Claude Code ahora soporta VSCode y JetBrains
• Si usas Linux / MacOS, puedes usar directamente el plugin
  • Si usas VSCode, invoca Claude Code en la terminal integrada de VSCode, el plugin se instalará automáticamente
  • Si usas JetBrains, necesitas descargar a través de este enlace: Claude Code [Beta] - IntelliJ IDEs Plugin
• Podrías necesitar especificar manualmente el IDE o verificar conexión IDE, prueba con el siguiente comando: > /ide
• Si usas VSCode+WSL, por favor instala previamente el plugin WSL en la tienda de plugins de VSCode
• Para más usos, puedes consultar la documentación oficial de Claude Code

7.2 Cambio y Configuración de Modelo

Claude Code soporta cambio flexible entre Claude 4 Opus y Claude 4 Sonnet:

• Recomendamos encarecidamente usar Claude 4 Sonnet, su experiencia de uso no tiene diferencia notable con Claude 4 Opus, pero la tasa de facturación es solo 1/5
• Seleccionamos Claude 4 Sonnet por defecto para ti, puedes modificar esta opción en la configuración después de iniciar sesión
• Si no has desactivado "Forzar uso de Sonnet" en el sitio, el modelo que cambies en /model no se cambiará
• Usar este comando en Claude Code para cambiar modelo: > /model

7.3 Gestión de Contexto

Claude Code soporta compresión de contexto para ahorrar puntos:

• Claude Code usualmente tendrá contexto largo, recomendamos usar el siguiente comando slash para comprimir y ahorrar puntos, contextos más largos a menudo requieren más puntos
• /compact [Tu descripción]

7.4 Recuperación de Conversación

Claude Code puede recuperar conversaciones anteriores:

• Usar el siguiente comando puede recuperar tu última conversación: claude --continue
• Esto recuperará inmediatamente tu conversación más reciente, sin ningún prompt
• Si necesitas mostrar tiempo, puedes introducir este comando: claude --resume
• Esto mostrará un selector de conversación interactivo, mostrando:
  • Tiempo de inicio de conversación
  • Prompt inicial o resumen de conversación
  • Número de mensajes
• Usar teclas de flecha para navegar y presionar Enter para seleccionar conversación, puedes usar este método para seleccionar contexto

7.5 Procesamiento de Imágenes

Claude Code puede procesar información de imágenes:

• Puedes usar cualquiera de los siguientes métodos:
  • Arrastrar y soltar imagen en la ventana de Claude Code (en MacOS)
  • Copiar imagen y usar Ctrl+v para pegar en CLI (en MacOS)
  • Proporcionar ruta de imagen: > Analiza esta imagen: /path/to/your/image.png
• Puedes usar completamente lenguaje natural para pedirle que trabaje, como:
  • > Esta es una captura del error. ¿Qué lo está causando?
  • > ¿Qué muestra esta imagen?
  • > Describe los elementos UI en esta captura de pantalla
  • > Genera CSS para coincidir con este modelo de diseño
  • > ¿Qué estructura HTML puede recrear este componente?

7.6 Pensamiento Profundo

Claude Code soporta pensamiento profundo:

• Necesitas pedirle que realice pensamiento profundo a través de lenguaje natural
• > Necesito implementar un nuevo sistema de autenticación usando OAuth2 para nuestra API. Piensa profundamente sobre la mejor manera de implementar esto en nuestra base de código.
• > Piensa en vulnerabilidades de seguridad potenciales en este enfoque
• > Piensa más profundamente en los casos extremos que deberíamos manejar
• Recomendamos usar esta funcionalidad cuando uses problemas complejos, esto también consumirá grandes cantidades de puntos de cuota

7.7 Operaciones Git Avanzadas

Claude Code soporta operar Git usando lenguaje natural, como:

• > Confirma mis cambios
• > Crea un pr
• > ¿Qué commit agregó pruebas markdown el diciembre pasado?
• > Rebase en la rama main y resuelve cualquier conflicto de merge

Usar Worktrees de Git

Puedes usar worktrees para crear entornos de codificación aislados:

• Si necesitas trabajar en múltiples tareas simultáneamente, y completamente aislar código entre instancias de Claude Code, puedes usar esta funcionalidad
• Los worktrees de Git te permiten hacer checkout de múltiples ramas desde el mismo repositorio a directorios separados. Cada worktree tiene su propio directorio de trabajo, los archivos están aislados, mientras comparten la misma historia de Git
• Crear nuevo worktree:

  # Crear worktree con nueva rama
  git worktree add ../project-feature-a -b feature-a
  
  # O crear worktree con rama existente
  git worktree add ../project-bugfix bugfix-123

• Ejecutar Claude Code en cada worktree:

  # Navegar a tu worktree
  cd ../project-feature-a
  
  # Ejecutar Claude Code en este entorno aislado
  claude

7.8 Otras Características Avanzadas

Claude Code soporta múltiples características avanzadas:

• Claude Code puede ser usado como herramienta tipo Unix
• Claude Code soporta instrucciones slash personalizadas
• Claude Code soporta agregar parámetros de comando usando $ARGUMENTS
• Claude Code soporta configuración de ajustes avanzados
• Claude Code soporta integración con GitHub Actions
• Claude Code soporta desarrollo SDK
• Claude Code soporta Protocolo de Contexto de Modelo (MCP)

8. Solución de Problemas Comunes

8.1 Problemas de Almacenamiento de Memoria

¿Cómo almacena memoria Claude Code?

Claude Code almacena memoria en ~/.claude, si no hay requisitos especiales, por favor no elimines este directorio.

8.2 Problemas de Nombre de Modelo

¿Por qué ocasionalmente responde nombre de modelo incorrecto?

TryAllAI te promete no reemplazar el modelo que solicitas, nunca mezclar otros modelos. Esto se debe a que Claude Code no usa modelos de la serie Claude 4 cuando usa tareas simples.

8.3 Errores de Línea de Comandos

¿Qué hacer con errores de ejecución de parámetros de línea de comandos?

Este tipo de problemas son comunes en WSL, es un error del Agent mismo. Recomendamos usar MacOS/Ubuntu, estos entornos a menudo tienen menos problemas.

8.4 Limpiar Claude Code

¿Cómo limpiar completamente Claude Code?

Puedes ejecutar el siguiente comando para limpiar información de inicio de sesión de Claude Code:

rm ~/.claude* -rf

8.5 Errores de API

¿Qué hacer con API Error, Tools Error?

Esto usualmente es un problema de red, por favor sal y usa claude -c para re-ejecutar. Si el problema persiste, por favor contacta soporte post-venta.

8.6 Errores de Verificación OAuth

Solución para errores de verificación OAuth

• Por favor asegúrate de que no haya proxy configurado en variables de entorno antes de hacer verificación de inicio de sesión
• Si el problema persiste, por favor ignora el navegador que aparece y copia el enlace en la terminal y ábrelo, verifica a través del método de código de verificación

8.7 Problemas de Timeout de Respuesta

¿Qué hacer cuando no hay respuesta por largo tiempo?

• Recomendamos presionar ctrl+c y reiniciar Claude Code, esto a menudo es un problema de red
• Si la línea de comandos sigue sin responder, recomendamos matar el proceso y re-hacer sesión, esto no afectará tu progreso de trabajo
• Puedes recuperar tu última sesión con el siguiente comando: claude -c

9. Conclusión

Claude Code es un poderoso asistente de programación AI, a través de configuración y uso razonables, puede mejorar significativamente tu eficiencia de desarrollo. Te sugerimos:

1. Empezar con funcionalidades básicas, explorar gradualmente características avanzadas
2. Personalizar configuración según necesidades del proyecto
3. Usar archivos CLAUDE.md para registrar información específica del proyecto
4. Usar gestión de permisos razonablemente para asegurar seguridad
5. Explorar MCP y características de extensión de comandos personalizados

¡Disfruta usándolo! Si tienes preguntas, por favor consulta la documentación oficial o soporte de la comunidad.