Complete Claude Code Guide: From Installation to Advanced Usage

Complete Claude Code Guide: From Installation to Advanced Usage

A comprehensive tutorial covering everything you need to know about Claude Code - from basic installation and setup to advanced features like MCP integration, automation, and security best practices.

Lección 3 2025-07-03 08:02

Referencia Completa de Comandos de Código de Claude

Referencia completa de comandos de Claude Code

Esta guía de referencia exhaustiva abarca todos los comandos de Claude Code que se pueden descubrir, desde operaciones básicas de la CLI hasta características avanzadas y comandos ocultos. Tanto si eres un usuario principiante como avanzado, esta guía te ayudará a dominar el extenso conjunto de comandos de Claude Code.

Categorías de comandos

Los comandos de Claude Code se dividen en varias categorías: - Comandos de CLI: Comandos de terminal para iniciar y configurar Claude Code. - Comandos interactivos: Comandos de barra diagonal (/) utilizados dentro de las sesiones de Claude Code. - Comandos de configuración: Comandos para gestionar ajustes y preferencias. - Comandos MCP: Comandos para gestionar servidores del Protocolo de Contexto de Modelo (Model Context Protocol). - Gestión de sesiones: Comandos para manejar conversaciones y memoria.

Comandos de CLI

Comandos principales

Inicio de Claude Code

Comando Descripción Ejemplo
claude Iniciar REPL interactivo claude
claude "consulta" REPL con mensaje inicial claude "ayuda a depurar esto"
claude -p "consulta" Consulta única (modo de impresión) claude -p "explica función"

Gestión de sesiones

Comando Descripción Ejemplo
claude -c Continuar última sesión claude -c
claude -r <id> Reanudar sesión específica claude -r abc123
claude --resume <nombre> Reanudar sesión con nombre claude --resume revisión-proyecto

Gestión de configuraciones

Comando Descripción Ejemplo
claude config Configuración interactiva claude config
claude config list Listar todos los ajustes claude config list
claude config get <clave> Obtener valor específico claude config get model
claude config set <clave> <valor> Establecer valor claude config set model sonnet

Banderas y opciones de CLI

Banderas esenciales

Bandera Corto Descripción Ejemplo
--print -p Imprimir respuesta sin modo interactivo claude -p "ayuda"
--continue -c Cargar conversación más reciente claude -c
--help -h Mostrar información de ayuda claude --help
--version -v Mostrar versión claude --version

Banderas de control de salida

Bandera Opciones Descripción Ejemplo
--output-format text, json, stream-json Controlar formato de respuesta claude -p "ayuda" --output-format json
--json - Abreviatura para salida JSON claude -p "analizar" --json
--verbose - Habilitar registro detallado claude --verbose

Banderas de seguridad y permisos

Bandera Nivel de riesgo Descripción Ejemplo
--allowedTools <herramientas> BAJO Lista blanca de herramientas específicas claude --allowedTools "Edit,View"
--disallowedTools <herramientas> BAJO Lista negra de herramientas específicas claude --disallowedTools "Bash"
--dangerously-skip-permissions CRÍTICO Saltar TODAS las solicitudes de permiso claude --dangerously-skip-permissions

Banderas avanzadas

Bandera Propósito Ejemplo Notas
--add-dir <ruta> Añadir directorios de trabajo claude --add-dir ../lib ../src
--model <modelo> Establecer modelo específico claude --model sonnet
--mcp-debug Habilitar depuración de MCP claude --mcp-debug

Comandos interactivos (Comandos de barra diagonal)

Estos comandos se utilizan dentro del modo interactivo de Claude Code:

Comandos del sistema

Comando Propósito Descripción
/help Mostrar todos los comandos de barra diagonal Lista los comandos interactivos disponibles
/clear Borrar conversación actual Inicia una nueva conversación
/exit Salir de Claude de forma segura Cierra correctamente Claude Code
/bug Informar de problemas Abre la interfaz de informe de errores

Comandos de diagnóstico

Comando Propósito Descripción
/doctor Comprobación de salud completa Ejecuta diagnósticos de sistema exhaustivos
/status Información del sistema Muestra el estado y la configuración actuales
/cost Estadísticas de uso de tokens Muestra los costos de la sesión actual
/sessions Listar todas las sesiones Muestra las sesiones de conversación disponibles

Comandos de configuración

Comando Propósito Descripción
/config Menú de configuración Abre la configuración interactiva
/permissions Gestionar acceso a herramientas Configurar permisos de herramientas
/memory Editar archivos de memoria Acceder y editar la memoria del proyecto

Comandos MCP

Comando Propósito Descripción
/mcp Gestión del servidor MCP Configuración interactiva de MCP
/mcp list Listar servidores configurados Muestra todos los servidores MCP configurados
/mcp status Comprobar estado del servidor Muestra la salud del servidor MCP

Comandos de configuración

Configuración global

# Ver toda la configuración
claude config list

# Obtener una configuración específica
claude config get model
claude config get allowedTools
claude config get outputFormat

# Establecer valores de configuración
claude config set model claude-sonnet-4
claude config set verbose true
claude config set outputFormat text

# Establecer configuraciones globales
claude config set -g model claude-sonnet-4
claude config set -g allowedTools "Edit,View"

Configuración del proyecto

# Configuraciones específicas del proyecto (en el directorio del proyecto)
claude config set systemPrompt "Eres un desarrollador senior"
claude config set allowedTools "Edit,View,Bash(git:*)"

# Importar configuración desde archivo
claude config import config.json

# Exportar configuración actual
claude config export > mi-config.json

Comandos MCP

Gestión de servidores

# Configuración interactiva de MCP
claude mcp

# Listar servidores configurados
claude mcp list

# Añadir nuevo servidor
claude mcp add git "git-mcp-server"
claude mcp add postgres "postgres-mcp-server --host localhost"

# Eliminar servidor
claude mcp remove git

# Comprobar estado del servidor
claude mcp status
claude mcp status git

# Reiniciar servidores
claude mcp restart git
claude mcp restart --all

# Depurar problemas de MCP
claude mcp debug
claude mcp logs git

Configuración del servidor

# Añadir servidor con variables de entorno
claude mcp add github "github-mcp-server" --env GITHUB_TOKEN=token

# Añadir servidor con argumentos específicos
claude mcp add db "postgres-mcp-server" --args "--host localhost --port 5432"

# Probar conexión del servidor
claude mcp test git
claude mcp test --all

Comandos de permisos

Patrones de permisos de herramientas

# Permitir herramientas específicas
claude --allowedTools "Edit,View"

# Permitir categorías de herramientas
claude --allowedTools "Edit,View,Bash"

# Permisos con alcance (solo operaciones de Git)
claude --allowedTools "Bash(git:*)"

# Múltiples alcances
claude --allowedTools "Bash(git:*),Bash(npm:*)"

# Permisos de herramientas MCP
claude --allowedTools "mcp__git__*"
claude --allowedTools "mcp__postgres__query,mcp__postgres__schema"

# Permisos combinados
claude --allowedTools "Edit,View,mcp__git__*,Bash(npm:*)"

Niveles de seguridad

# Restrictivo (más seguro)
claude --allowedTools "View"

# Modo de desarrollo
claude --allowedTools "Edit,View,Bash(git:*)"

# Acceso completo de desarrollo
claude --allowedTools "Edit,View,Bash,mcp__*"

# Modo peligroso (usar solo en contenedores)
claude --dangerously-skip-permissions

Comandos de gestión de sesiones

Trabajar con sesiones

# Listar todas las sesiones
claude sessions list

# Reanudar sesión específica
claude --resume nombre-sesion
claude -r id-sesion

# Crear sesión nombrada
claude --session mi-proyecto "Empezar a trabajar en la autenticación"

# Continuar última sesión
claude -c

# Borrar historial de sesiones
claude sessions clear
claude sessions clear --before "2024-01-01"

# Exportar sesión
claude sessions export id-sesion > sesion.json

# Importar sesión
claude sessions import sesion.json

Gestión de memoria

# Ver memoria del proyecto
claude /memory view

# Editar memoria del proyecto
claude /memory edit

# Borrar memoria del proyecto
claude /memory clear

# Establecer contexto del proyecto
claude /memory set "Este es un proyecto React TypeScript"

# Añadir a la memoria del proyecto
claude /memory add "Usar ESLint para el estilo del código"

Comandos de variables de entorno

Establecer variables de entorno

# Configuración principal
export ANTHROPIC_API_KEY="sk-tu-clave-aqui"
export ANTHROPIC_MODEL="claude-sonnet-4"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

# Ajustes de rendimiento
export MAX_THINKING_TOKENS=50000
export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1

# Ajustes de privacidad
export DISABLE_TELEMETRY=1
export DISABLE_ERROR_REPORTING=1

# Ajustes del proveedor de la nube
export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_VERTEX=1

# Ajustes de red
export HTTP_PROXY="http://proxy.empresa.com:8080"
export HTTPS_PROXY="https://proxy.empresa.com:8443"
export NO_PROXY="localhost,127.0.0.1,*.empresa.com"

Patrones de comandos avanzados

Canalización y automatización

# Enviar contenido a Claude mediante pipe
cat archivo.py | claude -p "revisa este código"
git diff | claude -p "explica estos cambios"
npm test 2>&1 | claude -p "arregla estos fallos de prueba"

# Encadenar comandos
claude -p "analiza registros" < app.log && echo "Análisis completo"

# Guardar salida
claude -p "genera documentación" > docs.md
claude -p "crea README" --output-format json > readme.json

Operaciones por lotes

# Procesar múltiples archivos
for file in *.py; do
  claude -p "revisa $file en busca de problemas de seguridad" < "$file"
done

# Revisión de código automatizada
git diff HEAD~1 | claude -p "revisa los cambios y sugiere mejoras"

# Generación de documentación
find . -name "*.js" -exec claude -p "documenta esta función" {} \;

Flujos de trabajo complejos

# Flujo de trabajo de desarrollo
claude --add-dir src test \
  --allowedTools "Edit,View,Bash(git:*),mcp__*" \
  "Iniciar sesión de revisión de código"

# Análisis de base de datos
claude --allowedTools "mcp__postgres__*,View" \
  "Analiza problemas de rendimiento de la base de datos"

# Auditoría de seguridad
claude --allowedTools "View,mcp__git__*" \
  "Realiza una auditoría de seguridad de los commits recientes"

Comandos de resolución de problemas

Comandos de diagnóstico

# Comprobación de salud
claude /doctor

# Información de versión
claude --version
claude /status

# Comprobación de configuración
claude config list
claude config get allowedTools
claude config get model

# Diagnósticos de MCP
claude mcp status
claude mcp list
claude --mcp-debug

# Diagnósticos de red
curl -I https://api.anthropic.com
ping api.anthropic.com

Comandos de restablecimiento

# Restablecer configuración
claude config reset
claude config set --reset

# Borrar sesiones
claude sessions clear --all

# Reiniciar servidores MCP
claude mcp restart --all

# Borrar caché
claude cache clear

# Restablecimiento completo (opción nuclear)
rm ~/.claude.json
claude config

Comandos ocultos y avanzados

Comandos para usuarios avanzados

# Omitir todas las comprobaciones de seguridad (peligroso)
claude --dangerously-skip-permissions --no-safety-checks

# Forzar modelo específico
claude --model claude-3-opus --force-model

# Modo depuración con todas las banderas
claude --verbose --debug --mcp-debug --trace-all

# Modo rendimiento
claude --fast-mode --disable-thinking --no-context-window-management

# Características experimentales
claude --experimental-features --enable-all-tools

Comandos de desarrollo

# Modo desarrollo
claude --dev-mode --unsafe-tools --experimental

# Modo pruebas
claude --test-mode --mock-api --dry-run

# Perfilado
claude --profile --timing --memory-usage

# Depuración de API
claude --log-api-calls --show-tokens --cost-tracking

Combinaciones de comandos y flujos de trabajo

Flujo de trabajo de desarrollo diario

# Reunión matutina (standup)
claude -c --add-dir . "Muéstrame en qué estuve trabajando ayer"

# Revisión de código
claude --allowedTools "View,mcp__git__*" "Revisa los últimos commits"

# Desarrollo de características
claude --allowedTools "Edit,View,Bash(git:*)" "Ayuda a implementar la autenticación de usuarios"

# Final del día
claude "Resume el trabajo de hoy y planifica el de mañana"

Flujo de trabajo de configuración de proyectos

# Configuración inicial del proyecto
claude --add-dir . --allowedTools "Edit,View,Bash(npm:*)" \
  "Configura un nuevo proyecto React TypeScript"

# Configurar MCP
claude mcp add git "git-mcp-server"
claude mcp add postgres "postgres-mcp-server"

# Establecer memoria del proyecto
claude /memory set "Proyecto React TypeScript con PostgreSQL"

Flujo de trabajo de depuración

# Análisis de errores
tail -f app.log | claude -p "monitorea los errores y sugiere soluciones"

# Depuración de rendimiento
claude --allowedTools "View,mcp__*" "Analiza las consultas lentas de la base de datos"

# Depuración de pruebas
npm test 2>&1 | claude -p "arregla las pruebas fallidas"

Tarjeta de referencia rápida

Comandos más usados

# Iniciar Claude
claude                          # Modo interactivo
claude "pregunta"               # Con un mensaje inicial
claude -p "pregunta"            # Modo de impresión

# Sesiones
claude -c                       # Continuar la última
claude --resume nombre          # Reanudar sesión con nombre

# Configuración
claude config                  # Configuración interactiva
claude /doctor                  # Comprobación de salud

# MCP
claude mcp                      # Gestión de MCP
claude /mcp                     # MCP en sesión

# Ayuda
claude --help                   # Ayuda de CLI
claude /help                    # Ayuda interactiva

Banderas esenciales

--allowedTools "Edit,View"      # Permisos seguros
--dangerously-skip-permissions  # Modo peligroso
--output-format json            # Salida JSON
--verbose                       # Modo depuración
--add-dir ruta                  # Añadir directorio

Esta referencia de comandos proporciona una visión general completa de las capacidades de Claude Code. Recuerda siempre comenzar con permisos seguros y expandir el acceso gradualmente según sea necesario. Utiliza el comando /doctor para solucionar problemas y /help para obtener asistencia rápida dentro de las sesiones de Claude Code.