Primeros pasos

Claude Code proporciona dos formas principales de interactuar:
  • Modo interactivo: Ejecuta claude para iniciar una sesión REPL
  • Modo de un solo uso: Usa claude -p "consulta" para comandos rápidos
# Iniciar modo interactivo
claude

# Iniciar con una consulta inicial
claude "explica este proyecto"

# Ejecutar un solo comando y salir
claude -p "¿qué hace esta función?"

# Procesar contenido canalizado
cat logs.txt | claude -p "analiza estos errores"

Comandos CLI

ComandoDescripciónEjemplo
claudeIniciar REPL interactivoclaude
claude "consulta"Iniciar REPL con prompt inicialclaude "explica este proyecto"
claude -p "consulta"Ejecutar consulta única, luego salirclaude -p "explica esta función"
cat archivo | claude -p "consulta"Procesar contenido canalizadocat logs.txt | claude -p "explica"
claude -cContinuar la conversación más recienteclaude -c
claude -c -p "consulta"Continuar en modo impresiónclaude -c -p "Busca errores de tipo"
claude -r "<session-id>" "consulta"Reanudar sesión por IDclaude -r "abc123" "Termina este PR"
claude updateActualizar a la última versiónclaude update
claude mcpConfigurar servidores de Model Context ProtocolVer sección MCP en tutoriales

Flags CLI

Personaliza el comportamiento de Claude Code con estos flags de línea de comandos:
FlagDescripciónEjemplo
--add-dirAgregar directorios de trabajo adicionales para que Claude pueda acceder (valida que cada ruta exista como directorio)claude --add-dir ../apps ../lib
--allowedToolsUna lista de herramientas que deben permitirse sin solicitar permiso al usuario, además de los archivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Write"
--disallowedToolsUna lista de herramientas que deben prohibirse sin solicitar permiso al usuario, además de los archivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Write"
--print, -pImprimir respuesta sin modo interactivo (ver documentación SDK para detalles de uso programático)claude -p "consulta"
--output-formatEspecificar formato de salida para modo impresión (opciones: text, json, stream-json)claude -p "consulta" --output-format json
--verboseHabilitar registro detallado, muestra salida completa turno por turno (útil para depuración en modos de impresión e interactivo)claude --verbose
--max-turnsLimitar el número de turnos agénticos en modo no interactivoclaude -p --max-turns 3 "consulta"
--modelEstablece el modelo para la sesión actual con un alias para el modelo más reciente (sonnet u opus) o el nombre completo de un modeloclaude --model claude-sonnet-4-20250514
--permission-prompt-toolEspecificar una herramienta MCP para manejar solicitudes de permiso en modo no interactivoclaude -p --permission-prompt-tool mcp_auth_tool "consulta"
--resumeReanudar una sesión específica por ID, o eligiendo en modo interactivoclaude --resume abc123 "consulta"
--continueCargar la conversación más reciente en el directorio actualclaude --continue
--dangerously-skip-permissionsOmitir solicitudes de permiso (usar con precaución)claude --dangerously-skip-permissions
El flag --output-format json es particularmente útil para scripts y automatización, permitiéndote analizar las respuestas de Claude programáticamente.
Para información detallada sobre el modo de impresión (-p) incluyendo formatos de salida, streaming, registro detallado y uso programático, consulta la documentación SDK.

Comandos con barra diagonal

Controla el comportamiento de Claude durante una sesión interactiva:
ComandoPropósito
/bugReportar errores (envía la conversación a Anthropic)
/clearBorrar historial de conversación
/compact [instrucciones]Compactar conversación con instrucciones de enfoque opcionales
/configVer/modificar configuración
/costMostrar estadísticas de uso de tokens
/doctorComprueba la salud de tu instalación de Claude Code
/helpObtener ayuda de uso
/initInicializar proyecto con guía CLAUDE.md
/loginCambiar cuentas de Anthropic
/logoutCerrar sesión de tu cuenta de Anthropic
/memoryEditar archivos de memoria CLAUDE.md
/modelSeleccionar o cambiar el modelo de IA
/permissionsVer o actualizar permisos
/pr_commentsVer comentarios de pull request
/reviewSolicitar revisión de código
/statusVer estados de cuenta y sistema
/terminal-setupInstalar atajo Shift+Enter para nuevas líneas (solo iTerm2 y VSCode)
/vimEntrar en modo vim para alternar entre modos de inserción y comando

Atajos especiales

Memoria rápida con #

Agrega memorias instantáneamente comenzando tu entrada con #:
# Siempre usa nombres de variables descriptivos
Se te pedirá que selecciones en qué archivo de memoria almacenar esto.

Saltos de línea en terminal

Ingresa comandos multilínea usando:
  • Escape rápido: Escribe \ seguido de Enter
  • Atajo de teclado: Option+Enter (o Shift+Enter si está configurado)
Para configurar Option+Enter en tu terminal: Para Mac Terminal.app:
  1. Abre Configuración → Perfiles → Teclado
  2. Marca “Usar Option como tecla Meta”
Para iTerm2 y terminal de VSCode:
  1. Abre Configuración → Perfiles → Teclas
  2. En General, configura la tecla Option izquierda/derecha como “Esc+”
Consejo para usuarios de iTerm2 y VSCode: Ejecuta /terminal-setup dentro de Claude Code para configurar automáticamente Shift+Enter como una alternativa más intuitiva. Consulta configuración de terminal en ajustes para detalles de configuración.

Modo Vim

Claude Code admite un subconjunto de atajos de teclado de Vim que se pueden habilitar con /vim o configurar a través de /config. El subconjunto admitido incluye:
  • Cambio de modo: Esc (a NORMAL), i/I, a/A, o/O (a INSERT)
  • Navegación: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Edición: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repetir)