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

  1. --system-promptAsume por completo el indicador del sistema, eliminando las instrucciones predeterminadas
    claude --system-prompt "You are a Python expert who only writes type-annotated code"
  2. --system-prompt-fileLee el indicador desde un archivo, adecuado para escenarios estandarizados
    claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
  3. --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。

Otras extensiones