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 que generó cada uno; esto requiere Claude Code v2.1.219 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. 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.
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
- Extensión de Chrome - Automatización de navegador y pruebas web
- Modo interactivo - Atajos de teclado, modos de entrada y características interactivas
- Guía de inicio rápido - Introducción a Claude Code
- Flujos de trabajo comunes - Flujos de trabajo avanzados y patrones
- Configuración - Opciones de configuración
- Documentación de Agent SDK - Uso programático e integraciones