SpyBara
Go Premium

cli-reference.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

This page contains 4 additions and 2 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

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 auto-mode reset Restaurar la configuración predeterminada de auto mode eliminando la sección autoMode de su archivo de configuración de usuario. Solicita confirmación antes de escribir; pase -y/--yes para omitir la solicitud. Las reglas de configuración administrada o la bandera --settings aún se aplican. Requiere Claude Code v2.1.212 o posterior. Consulte Inspeccionar los valores predeterminados y su configuración efectiva claude auto-mode reset --yes
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 import [source] Iniciar una sesión interactiva que ejecuta /import para traer configuración de otros agentes de codificación a Claude Code. Acepta las mismas opciones --dry-run y --yes que el comando. No disponible en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o Claude Platform en AWS. También no disponible cuando desactiva obtención de banderas de características. Requiere Claude Code v2.1.213 o posterior claude import codex --dry-run
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. Después de detener el servidor, puede recuperar las sesiones que estaba sirviendo. Consulte Reanudar sesiones después de detener el 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. Cuando la eliminación se rechaza sobre el árbol de trabajo de la sesión y un segundo claude rm puede resolverlo, el rechazo imprime la bandera exacta y el valor a pasar: --discard-unpushed <commit>@<worktree-id> descarta un árbol de trabajo que tiene commits sin enviar junto con esos commits, y --force-remove-worktree <worktree-id> elimina un directorio de árbol de trabajo que git o el hook WorktreeRemove no pudieron eliminar. --discard-unpushed requiere Claude Code v2.1.260 o posterior, y --force-remove-worktree requiere v2.1.268 o posterior. La transcripción de la conversación permanece en su máquina local, disponible a través de claude --resume claude rm 7c5dcf5d
claude self-hosted-runner Iniciar un proceso de ejecutor que registra esta máquina o contenedor con un entorno autohospedado y aloja sesiones en la nube de Claude Code en su infraestructura. Ejecute claude self-hosted-runner setup para un recorrido guiado del operador, claude self-hosted-runner doctor para diagnosticar un ejecutor implementado y claude self-hosted-runner orchestrator para generar ejecutores bajo demanda. Requiere Claude Code v2.1.224 o posterior claude self-hosted-runner setup
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 45 minutos. Use --post en un destino de solicitud de extracción github.com para publicar los hallazgos terminados en la PR como un comentario simple desde su cuenta de GitHub. --no-post es el predeterminado. --post y --no-post requieren Claude Code v2.1.227 o posterior. Consulte Publicar hallazgos en la solicitud de extracción 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

Personaliza 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 Añade directorios de trabajo adicionales para que Claude lea y edite archivos. Otorga acceso a archivos; Claude Code no descubre la mayoría de la configuración de .claude/ desde estos directorios. Valida que cada ruta exista como un directorio. No puedes añadir la mayoría de rutas de red, como \\server\share. Para persistir estos directorios entre sesiones, establece permissions.additionalDirectories en la configuración claude --add-dir ../apps ../lib
--advisor <model> Habilita la herramienta advisor del lado del servidor para esta sesión con un alias de modelo, fable, opus, u sonnet, o un ID de modelo completo. Tiene prioridad sobre la configuración advisorModel para la sesión. fable requiere acceso a Fable claude --advisor opus
--agent Especifica un agente para la sesión actual (anula la configuración agent) claude --agent my-custom-agent
--agents Define subagentes personalizados dinámicamente a través de JSON. Acepta los campos enumerados para subagentes definidos por CLI. Claude Code valida el JSON al inicio y sale si hay un valor inválido; consulta Invalid --agents configuration para el mensaje y para las banderas y variable de entorno que omiten la validación. La validación requiere Claude Code v2.1.242 o posterior claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Añade bypassPermissions al ciclo de modo Shift+Tab sin comenzar en él. Te permite comenzar en un modo diferente como plan y cambiar a bypassPermissions más tarde. Consulta modos de permisos claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Herramientas que se ejecutan sin solicitar permiso. Consulta sintaxis de regla de permisos para coincidencia de patrones. Para restringir qué herramientas están disponibles, usa --tools en su lugar. Si nombras una de las herramientas de seguimiento de tareas aquí, Claude Code también opta por la sesión "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Añade texto personalizado al final del indicador del sistema de cada subagente, incluyendo subagentes anidados, excepto un subagente bifurcado, que reutiliza el indicador de la propia conversación. 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-subagent-system-prompt-file Carga texto de un archivo y lo añade a los indicadores del sistema de subagentes. Una alternativa a --append-subagent-system-prompt para texto demasiado largo para pasar en la línea de comandos. Las dos banderas no se pueden combinar. Solo se aplica en modo no interactivo con -p. Requiere Claude Code v2.1.261 o posterior claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Añade texto personalizado al final del indicador del sistema predeterminado claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Carga texto de indicador del sistema adicional de un archivo y lo añade al indicador predeterminado claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Establece la ventana auto-compact para esta sesión sin cambiar tu configuración guardada. Acepta los mismos valores que /autocompact; esa sección cubre las formas de valor y qué anula la bandera. Requiere Claude Code v2.1.221 o posterior claude --autocompact 500k
--ax-screen-reader Renderiza salida amigable para lectores 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 en segundo plano 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: omite el descubrimiento automático de hooks, skills, comandos personalizados, subagentes, plugins, servidores MCP, memoria automática y CLAUDE.md para que las llamadas con script se inicien más rápido. Los skills en un directorio que pases con --add-dir aún se cargan. Claude tiene acceso a herramientas Bash, lectura de archivos y edición de archivos. Establece CLAUDE_CODE_SIMPLE. Consulta modo bare claude --bare -p "query"
--betas Encabezados beta para incluir en solicitudes de API (solo usuarios de clave API) claude --betas interleaved-thinking
--bg, --background Inicia la sesión como un agente en segundo plano y regresa inmediatamente. Imprime el ID de sesión y comandos de gestión. Combina con --exec para ejecutar un comando de shell como un trabajo en segundo plano en lugar de una sesión de Claude, o con --agent para ejecutar un subagente específico. No se puede combinar con -p/--print; consulta la referencia de errores claude --bg "investigate the flaky test"
--channels (Vista previa de investigación) Servidores MCP cuyas notificaciones de canal Claude debe escuchar en esta sesión. Lista separada por espacios de entradas plugin:<name>@<marketplace>. Requiere autenticación de Anthropic a través de claude.ai o una clave API de Console claude --channels plugin:my-notifier@my-marketplace
--chrome Habilita la integración del navegador Chrome para automatización web y pruebas claude --chrome
--cloud Con una descripción de tarea, crea una nueva sesión en la nube. Con un ID de sesión (session_... o cse_...) o una URL de claude.ai/code, encola un mensaje en esa sesión existente en su lugar, con -p. Consulta enviar un mensaje de seguimiento. claude --cloud "Fix the login bug"
--continue, -c Carga la conversación más reciente en el directorio actual, incluyendo una sesión en segundo plano que ha terminado; abrir sesiones en segundo plano terminadas requiere Claude Code v2.1.257 o posterior. Omite sesiones creadas con claude -p o el Agent SDK, y sesiones cuyo primer indicador fue /loop. claude -p --continue incluye sesiones -p, SDK y /loop. Incluye sesiones que añadieron este directorio con /add-dir claude --continue
--dangerously-load-development-channels Habilita canales 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 Omite solicitudes de permiso. Equivalente a --permission-mode bypassPermissions. Consulta modos de permisos para ver qué esto hace y no omite. Para sesiones iniciadas con --bg, el modo persiste cuando el supervisor reinicia la sesión claude --dangerously-skip-permissions
--debug Habilita el modo de depuración con filtrado de categoría opcional, como --debug='mcp,startup' o --debug='!1p'. El filtro se vincula solo en la forma =; un filtro separado por espacios habilita el modo de depuración sin filtrado claude --debug='mcp,startup'
--debug-file <path> Escribe 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 Deshabilita todos los skills y comandos para esta sesión claude --disable-slash-commands
--disallowedTools, --disallowed-tools Reglas de negación. Un nombre de herramienta desnudo elimina las herramientas coincidentes del contexto de Claude: "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 niega solo llamadas que coincidan como se escriben. Una regla que nombra EndConversation no puede eliminarla mientras cualquier otra herramienta permanezca "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Establece el nivel de esfuerzo para la sesión actual. Opciones: low, medium, high, xhigh, max, o ultracode. Los niveles disponibles dependen del modelo. ultracode solicita esfuerzo xhigh con ultracode activado, y requiere Claude Code v2.1.203 o posterior. Anula la configuración modelSettings y effortLevel para esta sesión y no persiste claude --effort high
--enable-auto-mode Eliminado en v2.1.111. El modo automático ahora está en el ciclo Shift+Tab por defecto; usa --permission-mode auto para comenzar en él claude --permission-mode auto
--environment <environment-id> Crea una nueva sesión en la nube que se ejecuta en el entorno autohospedado con el ID dado. Los IDs de entorno comienzan con ccpool_. Consulta comportamiento de envío de --environment para el comportamiento de envío y las combinaciones de banderas que rechaza. Requiere Claude Code v2.1.224 o posterior claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Mueve secciones por máquina del indicador del sistema (directorio de trabajo, información del entorno, rutas de memoria, bandera de repositorio git) al primer mensaje del usuario. Mejora la reutilización de caché de indicadores entre 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. Usa con -p para cargas de trabajo con script y multiusuario claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Ejecuta un comando de shell como un trabajo en segundo plano respaldado por PTY en lugar de iniciar una sesión de Claude. Usa con --bg para lanzar desde el shell claude --bg --exec 'pytest -x'
--fallback-model Habilita la alternancia automática al modelo especificado cuando el modelo principal está sobrecargado o no disponible, por ejemplo un modelo retirado. Acepta una lista separada por comas probada en orden. Consulta Cadenas de modelo alternativo. Para persistir una cadena entre sesiones, usa la configuración fallbackModel, que esta bandera anula claude --fallback-model sonnet,haiku
--fork-session Al reanudar, crea un nuevo ID de sesión en lugar de reutilizar el original (usa con --resume o --continue) claude --resume abc123 --fork-session
--forward-subagent-text Emite bloques de texto y pensamiento de subagentes en el flujo de salida como mensajes assistant y user con parent_tool_use_id establecido, para que puedas reconstruir la transcripción de cada subagente. Sin esta bandera, Claude Code omite el texto y los bloques de pensamiento de un subagente que se ejecuta en el primer plano. Requiere --print y --output-format stream-json. Claude Code también reenvía mensajes de subagentes anidados, estableciendo parent_tool_use_id al ID de la llamada de herramienta Agent o Skill que generó cada uno; esto requiere Claude Code v2.1.219 o posterior, y mensajes de subagentes que una skill bifurcada genera, y de skills bifurcadas anidadas, requieren v2.1.275 o posterior. La variable de entorno CLAUDE_CODE_FORWARD_SUBAGENT_TEXT habilita el mismo comportamiento. Requiere Claude Code v2.1.211 o posterior claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Abre el selector de sesión filtrado a 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 Se conecta automáticamente al IDE al inicio si exactamente un IDE válido está disponible claude --ide
--init Ejecuta hooks de Setup con el matcher init antes de la sesión (solo modo print) claude -p --init "query"
--init-only Ejecuta hooks Setup y SessionStart, luego sale sin iniciar una conversación claude --init-only
--include-hook-events Incluye eventos del ciclo de vida del hook en el flujo de salida. Los eventos de hook SessionStart y Setup siempre se incluyen y no necesitan esta bandera. Algunos eventos de hook, como Notification, SessionEnd, PreCompact, y PostCompact, nunca producen un evento hook_started, incluso con esta bandera. Para esos eventos, Claude Code aún emite hook_progress mientras un hook de comando que se ejecuta durante más de un segundo produce salida, y emite hook_response solo cuando un hook que se ejecuta en segundo plano termina. Requiere --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Incluye 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 Especifica el formato de entrada para el modo print (opciones: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Obtén salida JSON validada que coincida con un JSON Schema después de que el agente complete su flujo de trabajo (solo modo print). Consulta 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 claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Ejecuta hooks de Setup con el matcher maintenance antes de la sesión (solo modo print) claude -p --maintenance "query"
--max-budget-usd Cantidad máxima en dólares a gastar en llamadas de API antes de detener (solo modo print). El gasto de subagentes cuenta hacia el límite. Cuando regresas a una conversación con --continue o --resume, los totales restaurados de ejecuciones anteriores no cuentan hacia él. Una vez que el gasto alcanza el límite, generar otro subagente falla con Budget limit reached, y Claude Code detiene los subagentes en segundo plano que aún se ejecutan; los comportamientos de cumplimiento del límite requieren Claude Code v2.1.217 o posterior claude -p --max-budget-usd 5.00 "query"
--max-turns Limita el número de turnos agentivos (solo modo print). Sale con un error cuando se alcanza el límite. Sin límite por defecto. Con --input-format stream-json, un mensaje aún en cola cuando el límite termina un turno permanece en cola e inicia un nuevo turno con su propio límite claude -p --max-turns 3 "query"
--mcp-config Carga servidores MCP desde archivos JSON o cadenas (separados por espacios). Cuando pasas esta bandera con -p, Claude Code espera a que los servidores aún pendientes se conecten antes de ejecutar el primer turno, hasta el tiempo de espera de inicio MCP_TIMEOUT, 30 segundos por defecto; un servidor con una lista de herramientas en caché omite la espera y se conecta en el primer uso. La espera requiere Claude Code v2.1.221 o posterior claude --mcp-config ./mcp.json
--model Establece el modelo para la sesión actual con un alias de modelo como 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 Establece un nombre para mostrar para la sesión, mostrado en /resume y el título de la terminal. Puedes reanudar una sesión nombrada con claude --resume <name>. En una sesión interactiva, si otra sesión activa en esta máquina ya usa el nombre, Claude Code aplica una variante del mismo.

/rename cambia el nombre a mitad de sesión y también lo muestra en la barra de indicador		 claude -n "my-feature-work"
--no-chrome Deshabilita la integración del navegador Chrome para esta sesión claude --no-chrome
--no-session-persistence Deshabilita la persistencia de sesión para que las sesiones no se guarden en disco y no se puedan reanudar. Solo modo print. La variable de entorno CLAUDE_CODE_SKIP_PROMPT_HISTORY hace lo mismo en cualquier modo claude -p --no-session-persistence "query"
--output-format Especifica el formato de salida para el modo print (opciones: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Comienza en un modo de permisos especificado. Acepta default, acceptEdits, plan, auto, dontAsk, bypassPermissions, o manual como alias para default. El alias manual selecciona el modo de permisos que la UI 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. Sin esta bandera o --dangerously-skip-permissions, una nueva sesión comienza en el modo de permisos descrito en qué modo de permisos comienza una sesión. Para -p, eso es default cuando nada está configurado claude --permission-mode plan
--permission-prompt-tool Especifica una herramienta MCP para manejar solicitudes 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, 30 segundos por defecto.

La herramienta de indicador no puede aprobar una herramienta MCP marcada como requiriendo interacción del usuario: Claude Code convierte un resultado allow para una en una negación. Esta restricción requiere Claude Code v2.1.199 o posterior		 claude -p --permission-prompt-tool mcp_auth_tool "query"
--permission-prompts Establece quién responde solicitudes de permiso en modo print. Con el host predeterminado, Claude Code las envía al host del Agent SDK o a la herramienta --permission-prompt-tool. Pasa none cuando nadie puede responder, y Claude Code las niega en su lugar. Consulta Desactivar solicitudes de permiso en ejecuciones desatendidas. Requiere Claude Code v2.1.259 o posterior claude -p --permission-prompts none "query"
--plugin-dir Carga un plugin desde un directorio o archivo .zip, o varios desde una carpeta de plugins, solo para esta sesión. Cada bandera toma una ruta. Repite la bandera para más rutas: --plugin-dir A --plugin-dir B.zip. Pasar una carpeta de plugins requiere Claude Code v2.1.265 o posterior claude --plugin-dir ./my-plugin
--plugin-url Obtén un archivo .zip de plugin desde una URL solo para esta sesión. Repite la bandera para múltiples plugins, o pasa URLs separadas por espacios en un valor entrecomillado único claude --plugin-url https://example.com/plugin.zip
--print, -p Imprime la respuesta sin modo interactivo (consulta la documentación del Agent SDK para detalles de uso programático) claude -p "query"
--prompt-suggestions Emite un mensaje prompt_suggestion con un indicador de usuario siguiente predicho después de cada turno que genera uno; conversaciones muy cortas pueden no producir ninguno. Requiere --print, --output-format stream-json, y --verbose. Consulta Sugerencias de indicador claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> Con --environment, basa el checkout de la nueva sesión en una ref nombrada en lugar de HEAD local claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Alias deprecado para --cloud, incluyendo la forma de sesión existente claude --remote "Fix the login bug"
--remote-control, --rc Inicia una sesión interactiva con Remote Control habilitado para que también puedas controlarla desde claude.ai o la aplicación Claude. Opcionalmente pasa 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 tu máquina, produciendo nombres como myhost-graceful-unicorn. Establece CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para el mismo efecto claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Re-emite mensajes del 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
--restricted Comienza en modo restringido. Úsalo cuando un arnés de evaluación ejecute claude en una máquina compartida y Claude Code no debe ejecutar comandos ni leer la configuración de usuario y proyecto de esa máquina. Claude Code elimina las herramientas integradas que ejecutan comandos o código, y WebFetch, a menos que las nombres individualmente en --tools, no a través del preset default. También confina las herramientas de archivo integradas a los directorios de trabajo, carga solo configuración gestionada y --settings, rechaza bypassPermissions, y rechaza crear sesiones en la nube. Requiere Claude Code v2.1.248 o posterior claude --restricted -p "query"
--resume, -r Reanuda una sesión específica por ID o nombre, o muestra un selector interactivo para elegir una sesión. En lugar de un ID, puedes pasar la ruta absoluta al archivo de transcripción .jsonl de una sesión. El selector y búsqueda de nombre incluyen sesiones que añadieron este directorio con /add-dir. Cuando pasas un ID de sesión, Claude Code busca en el directorio del proyecto actual y sus git worktrees, luego en todos los demás proyectos en esta máquina. Antes de v2.1.223, la búsqueda de ID cubría solo el directorio del proyecto actual y sus git worktrees. Las sesiones en segundo plano aparecen en el selector marcadas con bg claude --resume auth-refactor
--safe-mode Comienza 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 gestionada aún se aplica, incluyendo hooks configurados por política, línea de estado y comandos de sugerencia de archivos; plugins gestionados, skills gestionados, CLAUDE.md gestionado, y servidores MCP configurados por política no. Útil para verificar si una personalización es lo que desencadena alternancia automática de modelo. Establece CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Usa 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 estableces aquí anulan las mismas claves en tus archivos settings.json para esta sesión. Las claves que omites mantienen sus valores basados en archivos. El archivo debe ser un archivo regular no mayor de 2 MiB. Consulta precedencia de configuración claude --settings ./settings.json
--strict-mcp-config Solo usa servidores MCP de --mcp-config, ignorando todas las demás configuraciones de MCP. Consulta Control exclusivo con managed-mcp.json para ver qué hace la bandera bajo un archivo MCP gestionado claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Reemplaza el indicador del sistema completo con texto personalizado claude --system-prompt "You are a Python expert"
--system-prompt-file Carga el indicador del sistema desde un archivo, reemplazando el indicador predeterminado claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Pasa off para reconstruir el indicador del sistema en cada solicitud en lugar de reutilizar el indicador registrado en la primera solicitud de la conversación, por ejemplo mientras iteras en el texto --append-system-prompt entre ejecuciones de --continue. Requiere Claude Code v2.1.257 o posterior claude --system-prompt-snapshot off
--teleport Reanuda una sesión en la nube en tu terminal local claude --teleport
--teammate-mode Establece cómo los compañeros de equipo de agentes se muestran: in-process (predeterminado), auto, tmux, o iterm2 (añadido en v2.1.186). Anula la configuración teammateMode para esta sesión. Consulta Elige un modo de visualización claude --teammate-mode auto
--tmux Crea una sesión tmux para el worktree. Requiere --worktree. Usa paneles nativos de iTerm2 cuando estén disponibles; pasa --tmux=classic para tmux tradicional claude -w feature-auth --tmux
--tools Restringe qué herramientas integradas puede usar Claude. Usa "" para deshabilitar todas, "default" para el conjunto predeterminado, o nombres de herramientas como "Bash,Edit,Read". En macOS, Linux y WSL, el conjunto predeterminado deja fuera Glob y Grep, como se describe en Comportamiento de la herramienta Glob. Si nombras una de las herramientas de seguimiento de tareas aquí, Claude Code también opta por la sesión. La bandera no afecta herramientas MCP; para negar esas también, usa --disallowedTools "mcp__*". Una lista que omite EndConversation no la elimina; "" la elimina solo cuando no quedan herramientas MCP claude --tools "Bash,Edit,Read"
--verbose Habilita el registro detallado, muestra la salida completa turno por turno. Anula la configuración viewMode para esta sesión claude --verbose
--version, -v Imprime el número de versión claude -v
--worktree, -w Inicia Claude en un git worktree aislado en <repo>/.claude/worktrees/<name>. Si no das un nombre, Claude Code genera uno. Pasa #<number>, una URL de solicitud de extracción de GitHub, o una URL de solicitud de fusión de GitLab para obtener ese PR o MR de origin y ramificar el worktree desde él. Ramificar desde una solicitud de fusión de GitLab requiere Claude Code v2.1.233 o posterior claude -w feature-auth

Banderas de indicador del sistema

Claude Code proporciona cinco banderas para personalizar el indicador del sistema. Cuatro establecen su texto, y con --system-prompt-snapshot controlas si una conversación mantiene el texto con el que comenzó. Las cinco funcionan tanto en modos interactivos como no interactivos.

Bandera Comportamiento Ejemplo
--system-prompt Reemplaza el indicador predeterminado completo 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 Añade al indicador predeterminado claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Añade contenido del archivo al indicador predeterminado claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot Con off, reconstruye el indicador en cada solicitud. Con on, el predeterminado, reutiliza un indicador registrado donde se aplica el registro claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

--system-prompt y --system-prompt-file son mutuamente excluyentes. Las banderas de añadir se pueden combinar con cualquiera de las banderas de reemplazo.

Cuando el texto de reemplazo combina instrucciones que son iguales en cada ejecución con contexto que cambia por ejecución, añade una línea que contenga solo __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ entre las instrucciones y el contexto. Claude Code divide el indicador en la primera línea de este tipo y elimina esa línea, por lo que la parte anterior permanece en caché mientras la parte posterior cambia. Requiere Claude Code v2.1.275 o posterior. Cachea la parte estática de un indicador personalizado enumera las configuraciones donde se aplica la división.

Elige basándote en si la identidad predeterminada de Claude Code aún se ajusta a tu tarea. Usa una bandera de añadir cuando Claude debe permanecer como un asistente de codificación que también sigue tus reglas adicionales: instrucciones por invocación, formato de salida, o contexto de dominio para un script -p. Añadir preserva la orientación de herramientas predeterminada, instrucciones de seguridad y convenciones de codificación, por lo que solo suministras lo que difiere. Usa una bandera de reemplazo cuando la superficie, identidad, o modelo de permisos difiere del de Claude Code, como un agente no codificador en una canalización que ningún humano observa. Reemplazar elimina todo el indicador predeterminado, incluyendo orientación de herramientas e instrucciones de seguridad, por lo que asumes la responsabilidad de lo que tu tarea aún necesita.

Para personas persistentes que puedas cambiar entre ellas y compartir entre un proyecto, usa estilos de salida. Para convenciones de proyecto que Claude siempre debe seguir, usa CLAUDE.md. La guía del Agent SDK sobre indicadores del sistema cubre la misma decisión con más profundidad.

Banderas de indicador del sistema en conversaciones reanudadas

Por defecto, Claude Code construye el indicador del sistema una vez, en la primera solicitud de una conversación, con el texto de cualquier bandera de indicador del sistema aplicada, y lo registra en la sesión. Hasta que la conversación se compacte, cada solicitud posterior usa ese indicador registrado, incluyendo después de que regreses a la conversación con --resume o --continue. Si pasas texto de bandera de indicador del sistema diferente, o ninguno, en ese lanzamiento posterior, entra en efecto una vez que la conversación se compacta o cuando comienzas una nueva conversación.

Fuera de sesiones en la nube, si comienzas Claude Code en modo bare pasando --bare o estableciendo CLAUDE_CODE_SIMPLE=1, el registro permanece desactivado a menos que pases --system-prompt-snapshot on. Antes de v2.1.268, sesiones que no obtienen banderas de características, incluyendo sesiones en Amazon Bedrock, Google Cloud's Agent Platform, y Microsoft Foundry, reconstruían el indicador en cada solicitud y --system-prompt-snapshot no tenía efecto.

Para reconstruir el indicador en cada solicitud en su lugar, por ejemplo mientras iteras en su redacción entre ejecuciones de --continue, pasa --system-prompt-snapshot off. Antes de v2.1.265, pasar cualquiera de las banderas de indicador del sistema también desactivaba el registro a menos que pasaras --system-prompt-snapshot on.

Ver también