--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 |
--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 | 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-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 |
--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 | 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 --agent para ejecutar un subagent específico | 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 |
--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 | 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 | Herramientas que se eliminan del contexto del modelo y no se pueden usar | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort | Establecer el nivel de esfuerzo para la sesión actual. Opciones: low, medium, high, xhigh, max; los niveles disponibles dependen del modelo. 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" |
--fallback-model | Habilitar fallback automático al modelo especificado cuando el modelo predeterminado está sobrecargado (solo modo impresión) | claude -p --fallback-model sonnet "query" |
--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 todos los eventos del ciclo de vida del hook en el flujo de salida. Requiere --output-format stream-json | claude -p --output-format stream-json --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 --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 -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 | 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 u opus) o el nombre completo de un modelo. Anula la configuración model y ANTHROPIC_MODEL | claude --model claude-sonnet-4-6 |
--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 o bypassPermissions. 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 -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" |
--remote | Crear una nueva sesión web en claude.ai con la descripción de tarea proporcionada | 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 --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. Incluye sesiones que agregaron este directorio con /add-dir | claude --resume auth-refactor |
--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: auto (predeterminado), in-process o tmux. Anula la configuración teammateMode para esta sesión. Consulte Elegir un modo de visualización | claude --teammate-mode in-process |
--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" | 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 |
