Los flags cambian cómo arranca y funciona claude. Se pasan en la línea de comandos, y varios se pueden fijar de forma permanente en settings.json (ver Configuración). Cuando un flag sólo sirve en modo interactivo o sólo en modo print, se indica en su tabla.
Sesión
| Flag | Para qué sirve | Ejemplo |
|---|
--continue, -c | Carga la conversación más reciente del directorio actual | claude -c |
--resume, -r | Retoma una sesión por ID o nombre, o abre el selector interactivo | claude -r billing-refactor |
--fork-session | Al retomar, crea un ID de sesión nuevo (con --resume/--continue) | claude -r mi-sesion --fork-session |
--from-pr <n|url> | Retoma las sesiones asociadas a un PR de GitHub | claude --from-pr 123 |
--session-id <uuid> | Usa un ID de sesión concreto (tiene que ser un UUID válido) | claude --session-id 9f1c... |
--no-session-persistence | No guarda la sesión en disco (sólo en modo print) | claude -p "..." --no-session-persistence |
--add-dir <dirs...> | Añade directorios de trabajo adicionales (comprueba que cada ruta exista) | claude --add-dir ../shared-lib |
--worktree, -w [nombre] | Arranca en un worktree de git aislado, en <repo>/.claude/worktrees/<nombre> | claude -w experimento |
--teleport | Retoma en tu terminal local una sesión que empezó en la web | claude --teleport |
--remote "<tarea>" | Crea una sesión web nueva en claude.ai con la tarea indicada | claude --remote "triar los issues abiertos" |
Modelos
| Flag | Para qué sirve | Ejemplo |
|---|
--model <modelo> | Alias del modelo (sonnet, opus) o su nombre completo | claude --model claude-sonnet-4-6 |
--fallback-model <modelo> | Modelo de reserva automático cuando el principal está saturado (sólo en modo print) | claude -p "..." --fallback-model sonnet |
--betas <headers> | Cabeceras beta para las peticiones a la API (sólo con API key) | claude --betas "feature-x" |
Permisos
| Flag | Para qué sirve | Ejemplo |
|---|
--permission-mode <modo> | Arranca en el modo de permisos indicado (por ejemplo plan) | claude --permission-mode plan |
--allowedTools <lista> | Herramientas que se ejecutan sin preguntar (sintaxis de reglas de permisos) | claude --allowedTools "Bash(git log *)" "Read" |
--disallowedTools <lista> | Herramientas que se eliminan por completo del contexto del modelo | claude --disallowedTools "Task(Explore)" |
--tools <lista> | Limita qué herramientas integradas puede usar Claude; "" las desactiva todas, "default" = todas | claude --tools "Bash,Edit,Read" |
--permission-prompt-tool <herramienta> | Herramienta MCP que atiende las confirmaciones de permisos en modo no interactivo | claude -p ... --permission-prompt-tool mcp__auth__approve |
--allow-dangerously-skip-permissions | Deja disponible el bypass de permisos sin activarlo; se puede combinar con --permission-mode | claude --allow-dangerously-skip-permissions |
--dangerously-skip-permissions | Se salta todas las confirmaciones de permisos — lee el aviso en Permisos | claude --dangerously-skip-permissions |
Contexto
| Flag | Para qué sirve | Ejemplo |
|---|
--system-prompt <texto> | Sustituye el system prompt entero (interactivo y print) | claude --system-prompt "Eres un revisor estricto" |
--system-prompt-file <ruta> | Sustituye el system prompt tomándolo de un archivo (sólo print) | claude -p ... --system-prompt-file prompt.txt |
--append-system-prompt <texto> | Añade texto al system prompt por defecto (interactivo y print) | claude --append-system-prompt "Prefiere pnpm" |
--append-system-prompt-file <ruta> | Añade al system prompt el texto de un archivo (sólo print) | claude -p ... --append-system-prompt-file extra.txt |
--agent <nombre> | Ejecuta la sesión como el agente indicado (sobrescribe el ajuste agent); corre como hilo principal y puede lanzar subagentes | claude --agent code-reviewer |
--agents <json> | Define subagentes personalizados sobre la marcha, en JSON | claude --agents '{"reviewer":{"description":"...","prompt":"..."}}' |
--settings <ruta-o-json> | Carga ajustes adicionales desde un archivo o una cadena JSON | claude --settings ./ci-settings.json |
--setting-sources <lista> | Orígenes de ajustes a cargar, separados por comas (user, project, local) | claude --setting-sources user,project |
--disable-slash-commands | Desactiva todas las skills y los comandos slash durante la sesión | claude --disable-slash-commands |
--system-prompt y --system-prompt-file son mutuamente excluyentes; las variantes de append sí se pueden combinar con un flag de sustitución.
Salida
| Flag | Para qué sirve | Ejemplo |
|---|
--print, -p | Imprime la respuesta sin entrar en modo interactivo | claude -p "resume README.md" |
--output-format <fmt> | Formato de salida en modo print: text, json, stream-json | claude -p "..." --output-format json |
--input-format <fmt> | Formato de entrada en modo print: text, stream-json | claude -p --input-format stream-json |
--json-schema <schema> | Salida JSON validada contra un JSON Schema (sólo print); el resultado llega en structured_output | claude -p "..." --json-schema '{"type":"object",...}' |
--include-partial-messages | Incluye los eventos parciales del streaming (requiere --print --output-format stream-json) | claude -p ... --output-format stream-json --include-partial-messages |
--verbose | Salida completa turno a turno (en los dos modos) | claude --verbose |
Depuración
| Flag | Para qué sirve | Ejemplo |
|---|
--debug [categorías] | Modo depuración, filtrable por categoría | claude --debug "api,mcp" |
--version, -v | Imprime el número de versión | claude --version |
Automatización
| Flag | Para qué sirve | Ejemplo |
|---|
--max-turns <n> | Limita los turnos agénticos (sólo print); da error al llegar al límite | claude -p "arregla los tests" --max-turns 10 |
--max-budget-usd <n> | Dólares máximos a gastar en llamadas a la API antes de parar (sólo print) | claude -p "..." --max-budget-usd 2 |
--init / --init-only | Ejecuta los hooks de inicialización y entra en modo interactivo / y sale | claude --init-only |
--maintenance | Ejecuta los hooks de mantenimiento y sale | claude --maintenance |
--teammate-mode <modo> | Cómo se muestran los compañeros de equipo de agentes: auto (por defecto), in-process, tmux | claude --teammate-mode tmux |
Integraciones
| Flag | Para qué sirve | Ejemplo |
|---|
--mcp-config <archivos-o-json> | Carga servidores MCP desde archivos o cadenas JSON | claude --mcp-config ./mcp.json |
--strict-mcp-config | Usa sólo los servidores MCP de --mcp-config e ignora el resto de la configuración MCP | claude --mcp-config ./mcp.json --strict-mcp-config |
--ide | Se conecta automáticamente a un IDE al arrancar si hay exactamente uno válido disponible | claude --ide |
--chrome / --no-chrome | Activa o desactiva la integración con el navegador Chrome | claude --no-chrome |
--plugin-dir <dir> | Carga plugins desde directorios sólo para esta sesión (se puede repetir) | claude --plugin-dir ./mi-plugin |
Última verificación: 2026-09-07
Fuentes oficiales:
Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.