Comandos CLI
| Comando | Descripción | Ejemplo |
|---|
claude | Iniciar REPL interactivo | claude |
claude "query" | Iniciar REPL con indicación inicial | claude "explain this project" |
claude -p "query" | Consultar a través de SDK, luego salir | claude -p "explain this function" |
cat file | claude -p "query" | Procesar contenido canalizado | cat logs.txt | claude -p "explain" |
claude -c | Continuar la conversación más reciente | claude -c |
claude -c -p "query" | Continuar a través de SDK | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | Reanudar sesión por ID | claude -r "abc123" "Finish this PR" |
claude update | Actualizar a la última versión | claude update |
claude mcp | Configurar servidores del Protocolo de Contexto de Modelo (MCP) | Consulte la documentación de Claude Code MCP. |
Banderas CLI
Personaliza el comportamiento de Claude Code con estas banderas de línea de comandos:
| Bandera | Descripción | Ejemplo |
|---|
--add-dir | Agregar directorios de trabajo adicionales para que Claude acceda (valida que cada ruta exista como un directorio) | claude --add-dir ../apps ../lib |
--agents | Definir suagentes personalizados dinámicamente a través de JSON (ver más abajo para el formato) | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools | Una lista de herramientas que deben permitirse sin solicitar permiso al usuario, además de archivos settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Read" |
--disallowedTools | Una lista de herramientas que deben deshabilitarse sin solicitar permiso al usuario, además de archivos settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--print, -p | Imprimir respuesta sin modo interactivo (consulte la documentación de SDK para detalles de uso programático) | claude -p "query" |
--system-prompt | Reemplazar todo el indicador del sistema con texto personalizado (funciona en modos interactivo e impresión; agregado en v2.0.14) | claude --system-prompt "You are a Python expert" |
--system-prompt-file | Cargar indicador del sistema desde un archivo, reemplazando el indicador predeterminado (solo modo impresión; agregado en v1.0.54) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--append-system-prompt | Agregar texto personalizado al final del indicador del sistema predeterminado (funciona en modos interactivo e impresión; agregado en v1.0.55) | claude --append-system-prompt "Always use TypeScript" |
--output-format | Especificar formato de salida para modo impresión (opciones: text, json, stream-json) | claude -p "query" --output-format json |
--input-format | Especificar formato de entrada para modo impresión (opciones: text, stream-json) | claude -p --output-format json --input-format stream-json |
--include-partial-messages | Incluir eventos de transmisión parcial en la salida (requiere --print y --output-format=stream-json) | claude -p --output-format stream-json --include-partial-messages "query" |
--verbose | Habilitar registro detallado, muestra salida completa turno por turno (útil para depuración en modos impresión e interactivo) | claude --verbose |
--max-turns | Limitar el número de turnos de agente en modo no interactivo | claude -p --max-turns 3 "query" |
--model | Establece 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 modelo | claude --model claude-sonnet-4-5-20250929 |
--permission-mode | Comenzar en un modo de permiso especificado | claude --permission-mode plan |
--permission-prompt-tool | Especificar una herramienta MCP para manejar indicadores de permiso en modo no interactivo | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--resume | Reanudar una sesión específica por ID, o eligiendo en modo interactivo | claude --resume abc123 "query" |
--continue | Cargar la conversación más reciente en el directorio actual | claude --continue |
--dangerously-skip-permissions | Omitir indicadores de permiso (usar con cuidado) | claude --dangerously-skip-permissions |
La bandera --output-format json es particularmente útil para secuencias de comandos y
automatización, permitiéndote analizar las respuestas de Claude mediante programación.
--agents acepta un objeto JSON que define uno o más suagentes personalizados. Cada suagente requiere un nombre único (como clave) y un objeto de definición con los siguientes campos:
| Campo | Requerido | Descripción |
|---|
description | Sí | Descripción en lenguaje natural de cuándo se debe invocar el suagente |
prompt | Sí | El indicador del sistema que guía el comportamiento del suagente |
tools | No | Matriz de herramientas específicas que el suagente puede usar (por ejemplo, ["Read", "Edit", "Bash"]). Si se omite, hereda todas las herramientas |
model | No | Alias de modelo a usar: sonnet, opus, o haiku. Si se omite, usa el modelo de suagente predeterminado |
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."
}
}'
Banderas de indicador del sistema
Claude Code proporciona tres banderas para personalizar el indicador del sistema, cada una sirviendo un propósito diferente:
| Bandera | Comportamiento | Modos | Caso de uso |
|---|
--system-prompt | Reemplaza todo el indicador predeterminado | Interactivo + Impresión | Control completo sobre el comportamiento e instrucciones de Claude |
--system-prompt-file | Reemplaza con contenido del archivo | Solo impresión | Cargar indicadores desde archivos para reproducibilidad y control de versiones |
--append-system-prompt | Agrega al indicador predeterminado | Interactivo + Impresión | Agregar instrucciones específicas mientras se mantiene el comportamiento predeterminado de Claude Code |
-
--system-prompt: Usa cuando necesites control completo sobre el indicador del sistema de Claude. Esto elimina todas las instrucciones predeterminadas de Claude Code, dándote una pizarra en blanco.
claude --system-prompt "You are a Python expert who only writes type-annotated code"
-
--system-prompt-file: Usa cuando quieras cargar un indicador personalizado desde un archivo, útil para la consistencia del equipo o plantillas de indicadores controladas por versiones.
claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
-
--append-system-prompt: Usa cuando quieras agregar instrucciones específicas mientras mantienes intactas las capacidades predeterminadas de Claude Code. Esta es la opción más segura para la mayoría de los casos de uso.
claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
--system-prompt y --system-prompt-file son mutuamente excluyentes. No puedes usar ambas banderas simultáneamente.
Para la mayoría de los casos de uso, se recomienda --append-system-prompt ya que preserva las capacidades integradas de Claude Code mientras agrega tus requisitos personalizados. Usa --system-prompt o --system-prompt-file solo cuando necesites control completo sobre el indicador del sistema.
-p) incluyendo formatos de salida,
transmisión, registro detallado y uso programático, consulta la
documentación de SDK.
Ver también
