Manual de referencia de Claude Code CLI
1. Comandos de la CLI
| Comando | Descripción | Ejemplo |
|---|---|---|
claude |
Iniciar REPL interactivo | claude |
claude "query" |
Iniciar REPL con una indicación inicial | claude "explain this project" |
claude -p "query" |
Consulta SDK y salir | claude -p "explain this function" |
| cat file | claude -p "query" | Procesar entrada de tubería (pipe) | cat logs.txt | claude -p "explain" |
claude -c |
Continuar la conversación más reciente en el directorio actual | claude -c |
claude -c -p "query" |
Continuar conversación mediante el SDK | claude -c -p "Check for type errors" |
claude -r "<session>" "query" |
Reanudar sesión por ID/nombre | claude -r "auth-refactor" "Finish this PR" |
claude update |
Actualizar a la última versión | claude update |
claude mcp |
Configurar servidor MCP | ConsulteDocumentación de Claude Code MCP |
2. Banderas de la CLI
Puede personalizar el comportamiento de Claude Code mediante las siguientes banderas:
| Bandera | Descripción | Ejemplo |
|---|---|---|
--add-dir |
Agregar directorio de trabajo (valida automáticamente la ruta) | claude --add-dir ../apps ../lib |
--agent |
Especificar agente de sesión (sobrescribe laagentconfiguración predeterminada) |
claude --agent my-custom-agent |
--agents |
Definir subagentes personalizados en JSON | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools |
Herramientas disponibles sin solicitud de permisos (para restringir herramientas--tools) |
"Bash(git log:*)" "Bash(git diff:*)" "Read" |
--append-system-prompt |
Agregar contenido al indicador del sistema predeterminado (aplica en modos interactivo e impresión) | claude --append-system-prompt "Always use TypeScript" |
--betas |
Agregar encabezado Beta a las solicitudes de API (solo para usuarios con clave de API) | claude --betas interleaved-thinking |
--chrome |
Habilitar integración con el navegador Chrome (automatización web/pruebas) | claude --chrome |
--continue, -c |
Cargar la conversación más reciente del directorio actual | claude --continue |
--dangerously-skip-permissions |
Omitir avisos de permisos (usar con precaución) | claude --dangerously-skip-permissions |
--debug |
Habilitar modo de depuración, admite filtrado por categoría (p. ej.,"api,hooks") |
claude --debug "api,mcp" |
--disallowedTools |
Deshabilitar herramientas específicas (eliminarlas del contexto) | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--fallback-model |
Cambiar automáticamente cuando el modelo predeterminado esté sobrecargado (solo modo impresión) | claude -p --fallback-model sonnet "query" |
--fork-session |
Generar un nuevo ID al reanudar la sesión (junto con--resume/--continue) |
claude --resume abc123 --fork-session |
--ide |
Conectar automáticamente a un IDE disponible | claude --ide |
--include-partial-messages |
La salida incluye algunos eventos de flujo (debe combinarse con--printy--output-format=stream-json) |
claude -p --output-format stream-json --include-partial-messages "query" |
--input-format |
Formato de entrada del modo impresión (opcional:text/stream-json) |
claude -p --output-format json --input-format stream-json |
--json-schema |
Generar resultados de validación conforme a JSON Schema (solo modo impresión) | claude -p --json-schema '{"type":"object","properties":{...}}' "query" |
--max-turns |
Limitar las rondas del agente (solo modo impresión; sale con error al exceder el límite) | claude -p --max-turns 3 "query" |
--mcp-config |
Cargar configuración MCP desde un archivo/una cadena JSON | claude --mcp-config ./mcp.json |
--model |
Especificar el modelo de sesión (admite aliassonnet/opuso nombre completo) |
claude --model claude-sonnet-4-5-20250929 |
--no-chrome |
Deshabilitar la integración con Chrome | claude --no-chrome |
--output-format |
Formato de salida del modo impresión (opcional:text/json/stream-json) |
claude -p "query" --output-format json |
--permission-mode |
Iniciar en el modo de permisos especificado | claude --permission-mode plan |
--permission-prompt-tool |
Especificar herramienta de manejo de avisos de permisos en modo no interactivo | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--plugin-dir |
Cargar complementos del directorio especificado (reutilizable) | claude --plugin-dir ./my-plugins |
--print, -p |
Imprimir la respuesta y salir (modo no interactivo) | claude -p "query" |
--resume, -r |
Reanudar sesión por ID/nombre, o abrir un selector interactivo | claude --resume auth-refactor |
--session-id |
Especificar el ID de sesión (debe ser un UUID válido) | claude --session-id "550e8400-e29b-41d4-a716-446655440000" |
--setting-sources |
Especificar las fuentes de configuración a cargar (separadas por comasuser/project/local) |
claude --setting-sources user,project |
--settings |
Cargar archivo/cadena de configuración JSON personalizada | claude --settings ./settings.json |
--strict-mcp-config |
Usar solo--mcp-configconfiguración, ignorando los demás ajustes de MCP |
claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt |
Reemplazar el indicador del sistema predeterminado (aplica en modos interactivo e impresión) | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Cargar el indicador del sistema desde un archivo (reemplaza el predeterminado; solo modo impresión) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--tools |
Restringir las herramientas integradas disponibles (""deshabilitar todas,"default"habilitar todas) |
claude --tools "Bash,Edit,Read" |
--verbose |
Habilitar registro detallado, mostrando la salida completa de cada ronda | claude --verbose |
--version, -v |
Mostrar el número de versión | claude -v |
Consejo:
--output-format jsonLas banderas son ideales para scripts y escenarios de automatización, ya que permiten analizar mediante programación los resultados de las respuestas de Claude.
3. Explicaciones ampliadas
3.1 Formato de la bandera de agente
--agentsLa bandera recibe un objeto JSON para definir uno o más subagentes personalizados. Cada subagente debe configurarse con un nombre único como clave, y el valor es un objeto que contiene los siguientes campos:
| Campo | Obligatorio | Descripción |
|---|---|---|
description |
Sí | Describe los escenarios de uso del subagente |
prompt |
Sí | Indicación del sistema que define el comportamiento del subagente |
tools |
no | Lista de herramientas exclusivas del subagente (por ejemplo,["Read", "Edit"], si se omite, hereda todas las herramientas) |
model |
no | Modelo utilizado por el subagente (admitesonnet/opus/haiku, si se omite, usa el modelo predeterminado) |
Ejemplo
claude --agents '{
"code-reviewer": {
"description": "Expert code reviewer. Use proactively after code changes.",
"prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "Debugging specialist for errors and test failures.",
"prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
}
}'
Bandera de indicación del sistema
Claude Code ofrece 3 formas de personalizar el indicador del sistema para satisfacer distintas necesidades:
| Bandera | Comportamiento | Modos aplicables | Caso de uso típico |
|---|---|---|---|
--system-prompt |
Reemplaza el indicador del sistema predeterminado | Interactivo + impresión | Personalizar completamente las instrucciones de comportamiento de Claude |
--system-prompt-file |
Carga el indicador desde un archivo y lo reemplaza | Solo impresión | Plantillas de indicaciones compartidas por el equipo, control de versiones |
--append-system-prompt |
Agrega contenido al indicador predeterminado | Interactivo + impresión | Conserva las funciones predeterminadas y agrega instrucciones personalizadas |
Escenarios de uso y ejemplos
--system-promptAsume por completo el indicador del sistema, eliminando las instrucciones predeterminadasclaude --system-prompt "You are a Python expert who only writes type-annotated code"
--system-prompt-fileLee el indicador desde un archivo, adecuado para escenarios estandarizadosclaude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
--append-system-promptConserva las funciones predeterminadas y agrega requisitos personalizados (recomendado para la mayoría de los escenarios)claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
Nota:
--system-prompty--system-prompt-fileSon mutuamente excluyentes y no pueden usarse al mismo tiempo.
ConsejoPriorice el uso de--append-system-prompt, que conserva las capacidades integradas de Claude Code y satisface las necesidades de personalización; solo use las otras dos banderas cuando necesite una personalización completa.
El modo de impresión (-p) en detalle (formato de salida, transmisión en streaming, integración programática, etc.), consulte laDocumentación del SDK。