SpyBara
Go Premium

cli-reference.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

68 added, 68 removed.

2026
Sat 15 04:58 Fri 14 23:00 Thu 13 23:57 Wed 12 23:59 Tue 11 22:03 Mon 10 22:57 Sun 9 04:02 Sat 8 04:59 Fri 7 23:57 Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

Referencia de CLI

Referencia completa de la interfaz de línea de comandos de Claude Code, incluyendo comandos y banderas.

Comandos CLI

Puede iniciar sesiones, canalizar contenido, reanudar conversaciones y administrar actualizaciones con estos comandos:

Comando Descripción Ejemplo
claude Iniciar sesión interactiva claude
claude "query" Iniciar sesión interactiva 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 en el directorio actual claude -c
claude -c -p "query" Continuar a través de SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Reanudar sesión por ID o nombre claude -r "auth-refactor" "Finish this PR"
claude update Actualizar a la versión más reciente claude update
claude gateway Iniciar el servidor de puerta de enlace de aplicaciones Claude autohospedado, para administradores que implementan SSO y política frente a Claude Code en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Requiere --config apuntando a un gateway.yaml. Disponible en Claude Code v2.1.195 y posterior. claude gateway --config gateway.yaml
claude install [version] Instalar o reinstalar el binario nativo. Acepta una versión como 2.1.118, o stable o latest. Consulte Instalar una versión específica claude install stable
claude auth login Inicie sesión en su cuenta de Anthropic. Use --email para rellenar previamente su dirección de correo electrónico, --sso para forzar la autenticación SSO y --console para iniciar sesión con Anthropic Console para facturación de uso de API en lugar de una suscripción a Claude claude auth login --console
claude auth logout Cerrar sesión en su cuenta de Anthropic claude auth logout
claude auth status Mostrar estado de autenticación como JSON. Use --text para salida legible por humanos. Sale con código 0 si ha iniciado sesión, 1 si no claude auth status
claude agents Abrir vista de agentes para monitorear y enviar sesiones de fondo paralelas. Use --cwd <path> para mostrar solo sesiones iniciadas en ese directorio, o --json para imprimir sesiones activas como una matriz JSON para scripts (--json --all también incluye sesiones de fondo completadas). Pase --permission-mode, --model, --effort o --agent para establecer valores predeterminados para sesiones enviadas. Acepta --settings, --add-dir, --plugin-dir y --mcp-config como el comando claude de nivel superior. Abrir la vista de agentes requiere una terminal interactiva claude agents --json
claude attach <id> Adjuntar a una sesión de fondo en esta terminal claude attach 7c5dcf5d
claude auto-mode defaults Imprimir las reglas del clasificador de auto mode integradas como JSON. Use claude auto-mode config para ver su configuración efectiva con la configuración aplicada. }--label <prefix> imprime solo las reglas cuya etiqueta comienza con ese prefijo, coincidiendo sin distinción de mayúsculas y minúsculas. Requiere Claude Code v2.1.208 o posterior claude auto-mode defaults --label 'Git Destructive'
claude daemon status Imprimir el estado del supervisor de sesión de fondo, versión, directorio de socket y recuento de trabajadores para diagnósticos. Sale con 1 si el supervisor no se está ejecutando claude daemon status
claude daemon stop --any Detener el supervisor de sesión de fondo y las sesiones que aloja. Pase --keep-workers para dejar las sesiones de fondo en ejecución para que el próximo supervisor se reconecte a ellas. --any confirma la detención de un supervisor bajo demanda, que es el predeterminado. Use esto para recuperarse de un supervisor que no responde claude daemon stop --any --keep-workers
claude doctor Imprimir diagnósticos de instalación y configuración de solo lectura desde la terminal sin iniciar una sesión, incluida la salud de la instalación, errores de validación de archivos de configuración e idoneidad de Remote Control. Para la verificación de configuración en sesión que también puede aplicar correcciones, ejecute /doctor claude doctor
claude logs <id> Imprimir salida reciente de una sesión de fondo claude logs 7c5dcf5d
claude mcp Configurar servidores Model Context Protocol (MCP) Consulte la documentación de Claude Code MCP.
claude mcp login <name> Ejecutar el flujo OAuth de un servidor MCP configurado sin abrir el panel interactivo /mcp. Funciona para servidores HTTP, SSE y conectores de claude.ai. Agregue --no-browser sobre SSH para imprimir la URL de autorización en lugar de abrir un navegador, luego pegue la URL de redirección nuevamente en el indicador. Requiere Claude Code v2.1.186 o posterior. Consulte Autenticar desde la línea de comandos claude mcp login sentry
claude mcp logout <name> Borrar credenciales OAuth almacenadas para un servidor MCP. Requiere Claude Code v2.1.186 o posterior claude mcp logout sentry
claude plugin Administrar Claude Code plugins. Alias: claude plugins. Consulte referencia de plugins para subcomandos claude plugin install code-review@claude-plugins-official
claude project purge [path] Eliminar todo el estado local de Claude Code para un proyecto: transcripciones, listas de tareas, registros de depuración, historial de edición de archivos, líneas de historial de indicaciones y la entrada del proyecto en ~/.claude.json. Omita [path] para elegir de una lista interactiva. Banderas: --dry-run para vista previa, -y/--yes para omitir confirmación, -i/--interactive para confirmar cada elemento, --all para cada proyecto. Consulte Borrar datos locales claude project purge ~/work/repo --dry-run
claude remote-control Iniciar un servidor de Remote Control para controlar Claude Code desde Claude.ai o la aplicación Claude. Se ejecuta en modo servidor (sin sesión interactiva local). Consulte Banderas de modo servidor claude remote-control --name "My Project"
claude respawn <id> Reiniciar una sesión de fondo, en ejecución o detenida, con su conversación intacta. Use --all para reiniciar cada sesión en ejecución, por ejemplo, para recoger un binario de Claude Code actualizado claude respawn 7c5dcf5d
claude rm <id> Eliminar una sesión de fondo de la lista. La transcripción de la conversación permanece en su máquina local, disponible a través de claude --resume claude rm 7c5dcf5d
claude setup-token Generar un token OAuth de larga duración para CI y scripts. Imprime el token en la terminal sin guardarlo. Requiere una suscripción a Claude. Consulte Generar un token de larga duración claude setup-token
claude stop <id> Detener una sesión de fondo. También acepta claude kill claude stop 7c5dcf5d
claude ultrareview [target] Ejecutar ultrareview de forma no interactiva. Imprime los hallazgos en stdout y sale con 0 en caso de éxito o 1 en caso de fallo. Use --json para la carga útil sin procesar y --timeout <minutes> para anular el valor predeterminado de 30 minutos claude ultrareview 1234 --json

Si escribe mal un subcomando, Claude Code sugiere la coincidencia más cercana y sale sin iniciar una sesión. Por ejemplo, claude udpate imprime Did you mean claude update?.

A partir de v2.1.199, claude --dangerously-skip-permissions daemon <subcommand> ejecuta el subcomando daemon. Las versiones anteriores trataban daemon <subcommand> como el indicador para una nueva sesión interactiva, por lo que el subcomando nunca se ejecutaba cuando la bandera venía primero, una configuración común cuando claude tiene un alias que incluye la bandera. Solo un --dangerously-skip-permissions o --allow-dangerously-skip-permissions inicial enruta a daemon de esta manera; cualquier otra bandera inicial aún inicia una sesión interactiva.

Banderas CLI

Personalice el comportamiento de Claude Code con estas banderas de línea de comandos. claude --help no enumera todas las banderas, por lo que la ausencia de una bandera en --help no significa que no esté disponible.

Bandera Descripción Ejemplo
--add-dir Agregar directorios de trabajo adicionales para que Claude lea y edite archivos. Otorga acceso a archivos; la mayoría de la configuración de .claude/ no se descubre desde estos directorios. Valida que cada ruta exista como directorio. Para persistir estos directorios entre sesiones, establezca permissions.additionalDirectories en configuración claude --add-dir ../apps ../lib
--advisor <model> Habilitar la herramienta advisor del lado del servidor para esta sesión con un alias de modelo: opus, sonnet o fable (v2.1.170+), o un ID de modelo completo. Tiene prioridad sobre la configuración advisorModel para la sesión claude --advisor opus
--agent Especificar un agente para la sesión actual (anula la configuración agent) claude --agent my-custom-agent
--agents Definir subagents personalizados dinámicamente a través de JSON. Utiliza los mismos nombres de campo que el frontmatter de subagent, más un campo prompt para las instrucciones del agente claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Agregar bypassPermissions al ciclo de modo Shift+Tab sin comenzar en él. Permite comenzar en un modo diferente como plan y cambiar a bypassPermissions más tarde. Consulte modos de permiso claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Herramientas que se ejecutan sin solicitar permiso. Consulte sintaxis de regla de permiso para coincidencia de patrones. Para restringir qué herramientas están disponibles, use --tools en su lugar "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Agregar texto personalizado al final del indicador del sistema de cada subagent, incluidos subagents anidados. Solo se aplica en modo no interactivo con -p. Requiere Claude Code v2.1.205 o posterior claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-system-prompt Agregar texto personalizado al final del indicador del sistema predeterminado claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Cargar texto de indicación del sistema adicional desde un archivo y agregar al indicador predeterminado claude --append-system-prompt-file ./extra-rules.txt
--ax-screen-reader Renderizar salida compatible con lector de pantalla: texto plano sin bordes decorativos ni animaciones. Fuerza el renderizador clásico, por lo que la configuración tui no tiene efecto; las sesiones de fondo adjuntas aún se renderizan a pantalla completa. Tiene prioridad sobre CLAUDE_AX_SCREEN_READER y la configuración axScreenReader. Requiere Claude Code v2.1.181 o posterior claude --ax-screen-reader
--bare Modo mínimo: omitir el descubrimiento automático de hooks, skills, plugins, servidores MCP, memoria automática y CLAUDE.md para que las llamadas con script se inicien más rápido. Claude tiene acceso a herramientas Bash, lectura de archivos y edición de archivos. Establece CLAUDE_CODE_SIMPLE. Consulte bare mode claude --bare -p "query"
--betas Encabezados beta para incluir en solicitudes de API (solo usuarios con clave API) claude --betas interleaved-thinking
--bg, --background Iniciar la sesión como un agente de fondo y regresar inmediatamente. Imprime el ID de sesión y comandos de administración. Combine con --exec para ejecutar un comando de shell como un trabajo de fondo en lugar de una sesión de Claude, o con --agent para ejecutar un subagent específico. No se puede combinar con -p/--print; consulte la referencia de errores claude --bg "investigate the flaky test"
--channels (Vista previa de investigación) Servidores MCP cuyas notificaciones de channel Claude debe escuchar en esta sesión. Lista separada por espacios de entradas plugin:<name>@<marketplace>. Requiere autenticación de Claude.ai claude --channels plugin:my-notifier@my-marketplace
--chrome Habilitar integración del navegador Chrome para automatización web y pruebas claude --chrome
--cloud Crear una nueva sesión web en claude.ai con la descripción de tarea proporcionada claude --cloud "Fix the login bug"
--continue, -c Cargar la conversación más reciente en el directorio actual. Incluye sesiones que agregaron este directorio con /add-dir claude --continue
--dangerously-load-development-channels Habilitar channels que no están en la lista de permitidos aprobada, para desarrollo local. Acepta entradas plugin:<name>@<marketplace> y server:<name>. Solicita confirmación claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Omitir indicadores de permiso. Equivalente a --permission-mode bypassPermissions. Consulte modos de permiso para ver qué hace y no hace esto. Para sesiones iniciadas con --bg, el modo persiste cuando el supervisor reinicia la sesión claude --dangerously-skip-permissions
--debug Habilitar modo de depuración con filtrado de categoría opcional (por ejemplo, "api,hooks" o "!statsig,!file") claude --debug "api,mcp"
--debug-file <path> Escribir registros de depuración en una ruta de archivo específica. Habilita implícitamente el modo de depuración. Tiene prioridad sobre CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--disable-slash-commands Deshabilitar todas las skills y comandos para esta sesión claude --disable-slash-commands
--disallowedTools, --disallowed-tools Reglas de denegación. Un nombre de herramienta simple elimina esa herramienta del contexto del modelo: "Edit" elimina Edit, "*" elimina todas las herramientas, y "mcp__*" elimina todas las herramientas MCP. Una regla con alcance como Bash(rm *) deja la herramienta disponible y deniega solo las llamadas coincidentes "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Establecer el nivel de esfuerzo para la sesión actual. Opciones: low, medium, high, xhigh, max, o ultracode. Los niveles disponibles dependen del modelo. ultracode inicia la sesión en esfuerzo xhigh con ultracode activado, y requiere Claude Code v2.1.203 o posterior. Anula la configuración effortLevel para esta sesión y no persiste claude --effort high
--enable-auto-mode Eliminado en v2.1.111. Auto mode ahora está en el ciclo Shift+Tab de forma predeterminada; use --permission-mode auto para comenzar en él claude --permission-mode auto
--exclude-dynamic-system-prompt-sections Mover secciones por máquina del indicador del sistema (directorio de trabajo, información del entorno, rutas de memoria, estado de git) al primer mensaje del usuario. Mejora la reutilización de caché de indicación en diferentes usuarios y máquinas que ejecutan la misma tarea. Solo se aplica con el indicador del sistema predeterminado; se ignora cuando se establece --system-prompt o --system-prompt-file. Use con -p para cargas de trabajo con script y múltiples usuarios claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Ejecutar un comando de shell como un trabajo de fondo respaldado por PTY en lugar de iniciar una sesión de Claude. Use con --bg para lanzar desde el shell claude --bg --exec 'pytest -x'
--fallback-model Habilitar fallback automático a los modelos especificados cuando el modelo principal está sobrecargado o no está disponible, por ejemplo un modelo retirado. Acepta una lista separada por comas probada en orden. Consulte Cadenas de modelo de fallback. Para persistir una cadena entre sesiones, use la configuración fallbackModel, que esta bandera anula claude --fallback-model sonnet,haiku
--fork-session Al reanudar, crear un nuevo ID de sesión en lugar de reutilizar el original (usar con --resume o --continue) claude --resume abc123 --fork-session
--from-pr Reanudar sesiones vinculadas a una solicitud de extracción específica. Acepta un número de PR, una URL de PR de GitHub o GitHub Enterprise, una URL de solicitud de fusión de GitLab o una URL de solicitud de extracción de Bitbucket. Las sesiones se vinculan automáticamente cuando Claude crea la solicitud de extracción claude --from-pr 123
--ide Conectarse automáticamente al IDE al iniciar si exactamente un IDE válido está disponible claude --ide
--init Ejecutar Setup hooks con el matcher init antes de la sesión (solo modo impresión) claude -p --init "query"
--init-only Ejecutar hooks de Setup y SessionStart, luego salir sin iniciar una conversación claude --init-only
--include-hook-events Incluir eventos del ciclo de vida del hook de cada evento de hook en el flujo de salida. Los eventos de hook SessionStart y Setup siempre se incluyen y no necesitan esta bandera. Requiere --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--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 --verbose --include-partial-messages "query"
--input-format Especificar formato de entrada para modo impresión (opciones: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Obtener salida JSON validada que coincida con un JSON Schema después de que el agente complete su flujo de trabajo (solo modo impresión). Consulte salidas estructuradas. Claude Code sale con un error en un esquema inválido y acepta la palabra clave format como anotación sin validación del lado del cliente. Antes de v2.1.205, un esquema inválido producía salida no estructurada sin error, y esquemas que usaban format se trataban como inválidos claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Ejecutar Setup hooks con el matcher maintenance antes de la sesión (solo modo impresión) claude -p --maintenance "query"
--max-budget-usd Cantidad máxima en dólares a gastar en llamadas API antes de detener (solo modo impresión) claude -p --max-budget-usd 5.00 "query"
--max-turns Limitar el número de turnos de agente (solo modo impresión). Sale con un error cuando se alcanza el límite. Sin límite por defecto. Con --input-format stream-json, un mensaje enviado mientras Claude está trabajando permanece en cola y se ejecuta como su propio turno, con su propio límite, cuando el límite termina el actual. Antes de v2.1.205, Claude Code descartaba ese mensaje claude -p --max-turns 3 "query"
--mcp-config Cargar servidores MCP desde archivos JSON o cadenas (separados por espacios) claude --mcp-config ./mcp.json
--model Establece el modelo para la sesión actual con un alias para el modelo más reciente (sonnet, opus, haiku o fable) o el nombre completo de un modelo. Anula la configuración model y ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Establecer un nombre para mostrar para la sesión, que se muestra en /resume y en el título de la terminal. Puede reanudar una sesión nombrada con claude --resume <name>.

/rename cambia el nombre durante la sesión y también lo muestra en la barra de indicación		 claude -n "my-feature-work"
--no-chrome Deshabilitar integración del navegador Chrome para esta sesión claude --no-chrome
--no-session-persistence Deshabilitar la persistencia de sesión para que las sesiones no se guarden en disco y no se puedan reanudar. Solo modo impresión. La variable de entorno CLAUDE_CODE_SKIP_PROMPT_HISTORY hace lo mismo en cualquier modo claude -p --no-session-persistence "query"
--output-format Especificar formato de salida para modo impresión (opciones: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Comenzar en un modo de permiso especificado. Acepta default, acceptEdits, plan, auto, dontAsk, bypassPermissions o manual como alias para default. El alias manual selecciona el modo que la interfaz de usuario etiqueta como Manual y requiere Claude Code v2.1.200 o posterior; claude --help lo enumera en lugar de default, y ambos valores funcionan. Anula defaultMode de archivos de configuración claude --permission-mode plan
--permission-prompt-tool Especificar una herramienta MCP para manejar indicadores de permiso en modo no interactivo. Claude Code espera a que el servidor MCP de esa herramienta se conecte antes de ejecutar el primer turno, hasta el tiempo de espera de inicio MCP_TIMEOUT de 30 segundos. Antes de v2.1.206, un servidor que se inicia lentamente podría hacer que la ejecución salga con un error de que la herramienta MCP no se encontró.

La herramienta de indicación no puede aprobar una herramienta MCP marcada como requiriendo interacción del usuario: Claude Code convierte un resultado allow para una en una denegación. Esta restricción requiere Claude Code v2.1.199 o posterior		 claude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dir Cargar un plugin desde un directorio o archivo .zip solo para esta sesión. Cada bandera toma una ruta. Repita la bandera para múltiples plugins: --plugin-dir A --plugin-dir B.zip claude --plugin-dir ./my-plugin
--plugin-url Obtener un archivo .zip de plugin desde una URL solo para esta sesión. Repita la bandera para múltiples plugins, o pase URLs separadas por espacios en un valor único entre comillas claude --plugin-url https://example.com/plugin.zip
--print, -p Imprimir respuesta sin modo interactivo (consulte documentación de Agent SDK para detalles de uso programático) claude -p "query"
--prompt-suggestions Emitir un mensaje prompt_suggestion después de cada turno con un siguiente indicador de usuario predicho. Requiere --print, --output-format stream-json y --verbose. Consulte Sugerencias de indicación claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--remote Alias obsoleto para --cloud claude --remote "Fix the login bug"
--remote-control, --rc Iniciar una sesión interactiva con Remote Control habilitado para que también pueda controlarlo desde claude.ai o la aplicación Claude. Opcionalmente pase un nombre para la sesión claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Prefijo para nombres de sesión de Remote Control generados automáticamente cuando no se establece un nombre explícito. Por defecto es el nombre de host de su máquina, produciendo nombres como myhost-graceful-unicorn. Establezca CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para el mismo efecto claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Re-emitir mensajes de usuario desde stdin de vuelta en stdout para reconocimiento. Requiere --input-format stream-json y --output-format stream-json claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--resume, -r Reanudar una sesión específica por ID o nombre, o mostrar un selector interactivo para elegir una sesión. El selector y la búsqueda de nombre incluyen sesiones que agregaron este directorio con /add-dir; pasar un ID de sesión busca solo en el directorio del proyecto actual y sus git worktrees. A partir de v2.1.144, sesiones de fondo aparecen en el selector marcadas con bg claude --resume auth-refactor
--safe-mode Comenzar con todas las personalizaciones deshabilitadas para solucionar problemas de una configuración rota: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos y agentes personalizados, estilos de salida, flujos de trabajo, temas personalizados, atajos de teclado personalizados, comandos de línea de estado y sugerencia de archivos, servidores LSP y memoria automática no se cargan. La autenticación, selección de modelo, herramientas integradas y permisos funcionan normalmente, lo que difiere de --bare. La política de configuración administrada aún se aplica, incluidos hooks configurados por política, línea de estado y comandos de sugerencia de archivos; plugins administrados, skills administrados, CLAUDE.md administrado y servidores MCP configurados por política no. Útil para verificar si una personalización es lo que desencadena fallback automático de Fable 5. Establece CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Usar un ID de sesión específico para la conversación (debe ser un UUID válido) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Lista separada por comas de fuentes de configuración a cargar (user, project, local) claude --setting-sources user,project
--settings Ruta a un archivo JSON de configuración o una cadena JSON en línea. Los valores que establezca aquí anulan las mismas claves en sus archivos settings.json para esta sesión. Las claves que omita mantienen sus valores basados en archivos. Consulte precedencia de configuración claude --settings ./settings.json
--strict-mcp-config Usar solo servidores MCP de --mcp-config, ignorando todas las demás configuraciones de MCP claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Reemplazar todo el indicador del sistema con texto personalizado claude --system-prompt "You are a Python expert"
--system-prompt-file Cargar indicación del sistema desde un archivo, reemplazando el indicador predeterminado claude --system-prompt-file ./custom-prompt.txt
--teleport Reanudar una sesión web en su terminal local claude --teleport
--teammate-mode Establecer cómo se muestran los compañeros de equipo de agente: in-process (predeterminado), auto, tmux o iterm2 (agregado en v2.1.186). El predeterminado cambió de auto en v2.1.179. Anula la configuración teammateMode para esta sesión. Consulte Elegir un modo de visualización claude --teammate-mode auto
--tmux Crear una sesión tmux para el worktree. Requiere --worktree. Utiliza paneles nativos de iTerm2 cuando están disponibles; pase --tmux=classic para tmux tradicional claude -w feature-auth --tmux
--tools Restringir qué herramientas integradas puede usar Claude. Use "" para deshabilitar todas, "default" para todas, o nombres de herramientas como "Bash,Edit,Read". Las herramientas MCP no se ven afectadas; para denegar también esas, use --disallowedTools "mcp__*", o pase --strict-mcp-config sin --mcp-config para que no se carguen servidores MCP claude --tools "Bash,Edit,Read"
--verbose Habilitar registro detallado, muestra salida completa turno por turno. Anula la configuración viewMode para esta sesión claude --verbose
--version, -v Mostrar el número de versión claude -v
--worktree, -w Iniciar Claude en un git worktree aislado en <repo>/.claude/worktrees/<name>. Si no se proporciona un nombre, se genera automáticamente. Pase #<number> o una URL de solicitud de extracción de GitHub para obtener ese PR de origin y ramificar el worktree desde él claude -w feature-auth

Banderas de indicación del sistema

Claude Code proporciona cuatro banderas para personalizar el indicador del sistema. Las cuatro funcionan tanto en modo interactivo como no interactivo.

Bandera Comportamiento Ejemplo
--system-prompt Reemplaza todo el indicador predeterminado claude --system-prompt "You are a Python expert"
--system-prompt-file Reemplaza con contenido del archivo claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Agrega al indicador predeterminado claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Agrega contenido del archivo al indicador predeterminado claude --append-system-prompt-file ./style-rules.txt

--system-prompt y --system-prompt-file son mutuamente excluyentes. Las banderas de adición se pueden combinar con cualquiera de las banderas de reemplazo.

Elija según si la identidad predeterminada de Claude Code aún se ajusta a su tarea. Use una bandera de adición cuando Claude deba seguir siendo un asistente de codificación que también sigue sus reglas adicionales: instrucciones por invocación, formato de salida o contexto de dominio para un script -p. Agregar preserva la orientación de herramientas predeterminada, instrucciones de seguridad y convenciones de codificación, por lo que solo proporciona lo que difiere. Use una bandera de reemplazo cuando la superficie, identidad o modelo de permiso difiera del de Claude Code, como un agente no codificador en una canalización que ningún humano observa. Reemplazar elimina todo el indicador predeterminado, incluida la orientación de herramientas e instrucciones de seguridad, por lo que usted es responsable de lo que su tarea aún necesita.

Estas banderas se aplican solo a la invocación actual. Para personas persistentes que puede cambiar y compartir en un proyecto, use estilos de salida. Para convenciones de proyecto que Claude siempre debe seguir, use CLAUDE.md. La guía de Agent SDK sobre indicaciones del sistema cubre la misma decisión con más profundidad.

Ver también