--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 | 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 |
--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 | 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, max (solo Opus 4.6). Con alcance de sesión y no persiste en la configuración | claude --effort high |
--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 un PR específico de GitHub. Acepta un número de PR o URL. Las sesiones se vinculan automáticamente cuando se crean a través de gh pr create | claude --from-pr 123 |
--ide | Conectarse automáticamente al IDE al iniciar si exactamente un IDE válido está disponible | claude --ide |
--init | Ejecutar hooks de inicialización e iniciar modo interactivo | claude --init |
--init-only | Ejecutar hooks de inicialización y salir (sin sesión interactiva) | 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 hooks de mantenimiento e iniciar modo interactivo | claude --maintenance |
--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 | 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) | 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 |
--enable-auto-mode | Desbloquear auto mode en el ciclo Shift+Tab. Requiere un plan de Team, Enterprise o API y Claude Sonnet 4.6 u Opus 4.6 | claude --enable-auto-mode |
--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 plugins desde un directorio solo para esta sesión. Cada bandera toma una ruta. Repita la bandera para múltiples directorios: --plugin-dir A --plugin-dir B | claude --plugin-dir ./my-plugins |
--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" |
--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 | 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 para cargar configuración adicional desde | 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. 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 | 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 | claude -w feature-auth |
