​
Comandos de CLI

ComandoDescripciónEjemplo
claudeIniciar REPL interactivoclaude
claude "consulta"Iniciar REPL con prompt inicialclaude "explica este proyecto"
claude -p "consulta"Consultar vía SDK, 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 vía SDKclaude -c -p "Verificar errores de tipo"
claude -r "<session-id>" "consulta"Reanudar sesión por IDclaude -r "abc123" "Terminar este PR"
claude updateActualizar a la versión más recienteclaude update
claude mcpConfigurar servidores de Protocolo de Contexto de Modelo (MCP)Ver la documentación de Claude Code MCP.

​
Banderas de CLI

Personaliza el comportamiento de Claude Code con estas banderas de línea de comandos:
BanderaDescripciónEjemplo
--add-dirAgregar directorios de trabajo adicionales para que Claude acceda (valida que cada ruta exista como directorio)claude --add-dir ../apps ../lib
--agentsDefinir subagentes personalizados dinámicamente vía JSON (ver formato abajo)claude --agents '{"reviewer":{"description":"Revisa código","prompt":"Eres un revisor de código"}}'
--allowedToolsUna lista de herramientas que deberían ser permitidas sin solicitar permiso al usuario, además de archivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Read"
--disallowedToolsUna lista de herramientas que deberían ser denegadas sin solicitar permiso al usuario, además de archivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Edit"
--print, -pImprimir respuesta sin modo interactivo (ver documentación de SDK para detalles de uso programático)claude -p "consulta"
--append-system-promptAgregar al prompt del sistema (solo con --print)claude --append-system-prompt "Instrucción personalizada"
--output-formatEspecificar formato de salida para modo de impresión (opciones: text, json, stream-json)claude -p "consulta" --output-format json
--input-formatEspecificar formato de entrada para modo de impresión (opciones: text, stream-json)claude -p --output-format json --input-format stream-json
--include-partial-messagesIncluir eventos de streaming parciales en la salida (requiere --print y --output-format=stream-json)claude -p --output-format stream-json --include-partial-messages "consulta"
--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 o opus) o el nombre completo de un modeloclaude --model claude-sonnet-4-5-20250929
--permission-modeComenzar en un modo de permisos especificadoclaude --permission-mode plan
--permission-prompt-toolEspecificar una herramienta MCP para manejar prompts de permisos 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 prompts de permisos (usar con precaución)claude --dangerously-skip-permissions
La bandera --output-format json es particularmente útil para scripting y automatización, permitiéndote analizar las respuestas de Claude programáticamente.

​
Formato de bandera de agentes

La bandera --agents acepta un objeto JSON que define uno o más subagentes personalizados. Cada subagente requiere un nombre único (como clave) y un objeto de definición con los siguientes campos:
CampoRequeridoDescripción
descriptionSíDescripción en lenguaje natural de cuándo debería invocarse el subagente
promptSíEl prompt del sistema que guía el comportamiento del subagente
toolsNoArray de herramientas específicas que el subagente puede usar (ej., ["Read", "Edit", "Bash"]). Si se omite, hereda todas las herramientas
modelNoAlias de modelo a usar: sonnet, opus, o haiku. Si se omite, usa el modelo de subagente predeterminado
Ejemplo: 
claude --agents '{
  "code-reviewer": {
    "description": "Revisor de código experto. Usar proactivamente después de cambios de código.",
    "prompt": "Eres un revisor de código senior. Enfócate en calidad de código, seguridad y mejores prácticas.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Especialista en depuración para errores y fallas de pruebas.",
    "prompt": "Eres un experto en depuración. Analiza errores, identifica causas raíz y proporciona correcciones."
  }
}'
Para más detalles sobre crear y usar subagentes, ver la documentación de subagentes. Para información detallada sobre el modo de impresión (-p) incluyendo formatos de salida, streaming, registro detallado y uso programático, ver la documentación de SDK.

​
Ver también