Modos de permisos de Claude Code: los 6 modos y cuándo usar cada uno

El selector «Modo de permisos» que aparece junto al cuadro de la consulta en Claude Code —el que vas rotando con Shift+Tab— decide con qué frecuencia Claude se detiene a pedir permiso antes de editar un archivo o ejecutar un comando. Más confirmaciones significan más seguridad; menos confirmaciones permiten que Claude trabaje en tramos más largos e ininterrumpidos.

Esta guía explica qué son los modos de permisos, en qué se diferencian los 6 modos, cómo cambiar entre ellos, cómo funciona el modo automático y cómo usarlos de forma segura. Entenderás exactamente qué significa cada una de las cinco opciones del selector de la aplicación de escritorio: Manual / Aceptar ediciones / Plan / Auto / Omitir permisos (en español de Latinoamérica, Auto aparece como «Automático»; las versiones anteriores mostraban Solicitar permisos / Aceptar ediciones / Modo de planificación / Modo automático / Omitir permisos).

1. Qué son los modos de permisos

Cuando Claude quiere editar un archivo, ejecutar un comando de la terminal o hacer una solicitud de red, ¿cuántas veces debe detenerse a pedirte que apruebes la acción? Eso es justo lo que controlan los modos de permisos. En el más estricto, Manual (valor de configuración default), Claude se detiene antes de cada una de esas acciones y pregunta primero (fuente: la página oficial de Claude Code «Choose a permission mode»).

Los modos más estrictos revisan cada acción a medida que llega (más seguro, más avisos). Los modos más permisivos dejan que Claude trabaje en tramos largos e ininterrumpidos y te informe al terminar (más rápido, menos avisos). La clave está en elegir más supervisión para el trabajo sensible y menos interrupciones cuando confías en la dirección.

El modo con el que arranca una sesión depende de cómo uses Claude Code y de su versión. Desde la v2.1.283, las sesiones interactivas que inicias en una terminal o desde VS Code arrancan en Auto (modo automático) en cualquier plan y proveedor (incluidos los planes Enterprise, las claves de API de Claude Console y Amazon Bedrock; a 5 de octubre de 2026). Antes de la v2.1.283, solo los planes Pro, Max y Team arrancaban en Auto y todo lo demás arrancaba en Manual. claude -p, el Agent SDK y las sesiones en las que algún archivo de ajustes fija disableAutoMode en "disable" arrancan en Manual, igual que las que no cumplen los requisitos del modo automático (§4). La primera sesión justo después de instalar o actualizar puede arrancar en otro modo. Un flag de inicio o un defaultMode en tu archivo de ajustes tiene prioridad.

2. Los 6 modos (dontAsk no aparece en el selector)

El selector de la aplicación de escritorio muestra cinco (Manual / Aceptar ediciones / Plan / Auto / Omitir permisos); Auto y Omitir permisos solo aparecen cuando se cumplen sus condiciones. Si se suma dontAsk, que no aparece en el ciclo y se fija con un flag de arranque o en los ajustes, salen los seis modos de la documentación oficial. Cada uno se diferencia en qué se ejecuta sin preguntar.

Cómo se ve el menú de la aplicación de escritorio (a 5 de octubre de 2026)

En la pestaña Code de la aplicación de escritorio, al abrir el selector junto al botón de enviar, los modos aparecen en este orden. La descripción bajo cada nombre se reproduce tal como sale en pantalla, y Automático lleva la etiqueta «Recomendado» (lo comprobé en mi aplicación de Windows, a 5 de octubre de 2026; los nombres coinciden con los textos en español de claude.ai). La tabla usa el español de Latinoamérica (es-419); en el español de España (es-ES), el primer modo aparece como «Auto» y algunas descripciones cambian ligeramente.

• El modo elegido se recuerda por carpeta: la próxima sesión que inicies en esa carpeta usará el mismo modo, y tiene prioridad sobre el defaultMode de tu archivo de ajustes. Plan es la excepción: solo dura la sesión actual (documentación oficial: «Desktop application»).
• Omitir permisos solo aparece si lo permites en la configuración: en Pro y Max, activa «Permitir modo de omisión de permisos» en Configuración → Claude Code. En Team y Enterprise no hay ese interruptor y lo decide la política de la organización. No está disponible si ejecutas Claude Code como root.
• Automático solo aparece cuando cumples sus requisitos (§4). No hay un interruptor aparte en la configuración para activarlo o desactivarlo.
• dontAsk no se puede elegir en la aplicación de escritorio (solo en la CLI).
• En inglés, la antigua pestaña Code llamaba a los modos Ask permissions / Auto accept edits / Plan mode.

3. Cómo cambiar (Shift+Tab y más)

En la terminal (CLI), la forma más rápida es Shift+Tab. Durante una sesión, va rotando entre Manual → Aceptar ediciones → Plan; si estás en Auto, la primera pulsación te lleva a Manual (la barra de estado muestra el modo actual, p. ej. ⏸ manual mode on). En VS Code, haz clic en el indicador de modo en la parte inferior del cuadro de la consulta; en la aplicación de escritorio, usa el selector de modo junto al botón de enviar; en claude.ai, el desplegable junto al cuadro de la consulta.

Auto y Omitir permisos se unen al ciclo de forma condicional, después de Plan y en el orden Omitir permisos → Auto. Auto aparece cuando cumples sus requisitos y cambiar a él no pide ninguna confirmación. Omitir permisos solo está disponible si inicias con --permission-mode bypassPermissions, --dangerously-skip-permissions o --allow-dangerously-skip-permissions (que lo añade al ciclo sin activarlo), o si defaultMode vale bypassPermissions en los ajustes del usuario o en los ajustes administrados. dontAsk nunca aparece en el ciclo: configúralo con --permission-mode dontAsk o en los ajustes.

En Manual y en Aceptar ediciones, el aviso de permiso de un comando de Bash puede ofrecer «Yes, and switch to auto mode». Al elegirlo, se aprueba el comando y la sesión pasa a Auto (solo donde Auto está disponible).

# Establecer el modo al iniciar
claude --permission-mode plan
claude --permission-mode acceptEdits

# Omitir necesita su flag específico (solo en entornos aislados)
claude --dangerously-skip-permissions

Para iniciar siempre en el mismo modo, define uno predeterminado en tu archivo de ajustes.

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

* Los valores auto y bypassPermissions de defaultMode no surten efecto desde los ajustes del proyecto (.claude/settings.json, .claude/settings.local.json). Con auto ahí, la sesión arranca en el valor predeterminado integrado (tampoco se usa el defaultMode de tus ajustes de usuario); con bypassPermissions, arranca en Manual. Pon estos dos valores en los ajustes del usuario (~/.claude/settings.json) o en los ajustes administrados de tu organización. La extensión de VS Code ni siquiera lee los ajustes del proyecto para el modo inicial: usa su ajuste claudeCode.initialPermissionMode.

4. El modo automático en detalle

El modo automático elimina casi todos los avisos de confirmación, pero no es barra libre. Antes de cada acción, un modelo clasificador independiente la revisa y bloquea todo lo que se exceda más allá de lo que pediste, que afecte a infraestructura no reconocida o que parezca impulsado por contenido hostil que Claude haya leído.

Requisitos: vale para todos los planes. En Team y Enterprise está disponible de forma predeterminada, pero los administradores pueden desactivarlo para toda la organización poniendo permissions.disableAutoMode en "disable" en los ajustes administrados. En la API de Anthropic y en Claude Platform on AWS, el modelo debe ser Opus 4.6 o posterior, Sonnet 4.6 o posterior, o un modelo Fable; en Amazon Bedrock, Google Cloud, Microsoft Foundry y las sesiones iniciadas en un Claude apps gateway solo son compatibles Sonnet 5 o posterior, Opus 4.7 o posterior y los modelos Fable (Sonnet 4.5, Opus 4.5, Haiku, etc. no son compatibles en ningún proveedor). Si indica «no disponible», revisa primero estos requisitos y después si algún archivo de ajustes define disableAutoMode. Anthropic también puede haberlo desactivado desde el servidor; eso dura hasta que termina la sesión, así que inicia una nueva más tarde.

Los límites que indicas en la conversación (p. ej. «no hagas push», «no despliegues hasta que lo revise») también se tratan como una señal de bloqueo. Pero estos no se guardan como reglas: el clasificador los vuelve a leer de la transcripción cada vez, así que un límite puede perderse si la compactación del contexto elimina el mensaje. Para una garantía firme, añade una regla deny. Mientras que los modos fijan la base de con qué frecuencia pregunta Claude, las reglas de permisos de Claude Code (allow/ask/deny) ofrecen un control más fino, herramienta por herramienta. Si el clasificador bloquea 3 acciones seguidas o 20 en total, el modo automático se pausa y Claude Code vuelve a pedir permiso; al aprobar la acción solicitada, el modo automático se reanuda (estos umbrales no se pueden configurar).

Si se bloquea una acción legítima (un falso positivo), abre /permissions, ve a la pestaña Recently blocked (Recently denied antes de la v2.1.314), selecciona la acción y pulsa r para que Claude pueda reintentarla. Si Claude necesita un destino durante toda la tarea, como un registro de paquetes o un dominio interno, añádelo a autoMode.environment; si quieres que un comando se ejecute sin revisión a partir de ahora, añade una regla allow; si es algo puntual, explica tu intención en el siguiente mensaje y deja que Claude lo reintente. Un mensaje con is temporarily unavailable (por ejemplo, con (timed out)) significa que el clasificador no pudo emitir un veredicto, lo cual es distinto de un rechazo evaluado. No aparece en Recently blocked, así que espera unos segundos y reinténtalo (si (timed out) se repite, revisa tu conexión); no hace falta cambiar la configuración. Los falsos positivos se pueden reportar con /feedback (documentación oficial: Configure auto mode y Error reference, a 29 de septiembre de 2026). A finales de septiembre de 2026 se abrieron varios issues en GitHub que describen trabajos detenidos por falsos positivos o tiempos de espera del clasificador (por ejemplo, #95996, #96077, #96662).

Si Claude Code se detiene con <model>'s safeguards flagged this message, no es cosa del clasificador del modo automático: son los clasificadores de seguridad del propio modelo, que reaccionan a la conversación y funcionan al margen de los modos de permisos (qué hacer en ese caso: safeguards flagged this message: qué significa y qué hacer).

5. Qué modo usar y cuándo, y seguridad

Elige según el equilibrio entre supervisión y autonomía. Referencia rápida:

* Los nombres y el comportamiento de los modos siguen la documentación oficial de Claude Code (Choose a permission mode); los nombres visibles en español siguen la aplicación de escritorio (a fecha del 5 de octubre de 2026; comprobados en pantalla y en los textos en español de claude.ai). Los requisitos y el comportamiento pueden cambiar: consulta la documentación oficial y tu aplicación para conocer lo más reciente.

Ojo: en las sesiones en la nube (claude.ai/code), los mismos nombres de modo se comportan de otra manera. En la nube, la edición de archivos está permitida en todos los modos, así que Aceptar ediciones equivale al modo normal y se detiene ante cada comando, como npm install o una compilación. Si quieres avanzar sin aprobaciones, elige Auto. Recogí un caso real con el que tropecé en Cómo configurar con seguridad las sesiones en la nube de Claude Code: una configuración que protege producción y 5 puntos en los que me atasqué.

6. Relación con el esfuerzo y confusiones habituales

Junto al cuadro de la consulta hay dos grandes selectores: «Modo de permisos» y «Esfuerzo». Cada uno cumple una función distinta.

También están conectados. Al aprobar un plan, eliges si seguir en Auto o aprobar cada edición a mano (donde Auto no está disponible, esa opción acepta las ediciones automáticamente). Y combinar «Ultracode», de los ajustes de esfuerzo (desde la v2.1.284 no es un escalón de esfuerzo, sino un interruptor que puedes activar en cualquier nivel), con Auto elimina por completo el aviso de ejecución del flujo de trabajo, incluso la primera vez, de modo que Claude puede ejecutarse de principio a fin (con Auto solo, el aviso aparece únicamente en el primer lanzamiento). También hay un ajuste que planifica con Opus solo mientras estás en el modo de planificación y deja a Sonnet la implementación aprobada (¿Qué es opusplan en Claude Code?).

La confusión habitual es «los avisos son molestos, así que usaré la omisión». Eso es arriesgado: la respuesta correcta es el modo automático (con comprobaciones en segundo plano). Otra: «Plan es seguro, así que vale todo». Plan solo significa «sin editar el código fuente»; sus comandos de exploración se siguen ejecutando. Donde Auto está disponible, los comandos que aprueba el clasificador se ejecutan sin aviso; en otros casos, todo lo que no sea un comando de solo lectura pide permiso. Y en una sesión de terminal iniciada con la omisión disponible, las ediciones y los comandos que Claude intente durante la planificación pasan sin ningún aviso.

Resumen

Tres ideas clave sobre los modos de permisos de Claude Code.

• Qué es: el ajuste que determina con qué frecuencia Claude pide permiso antes de editar o ejecutar comandos. Cambia con Shift+Tab o con el selector.
• Los modos: Manual (default) / Aceptar ediciones (acceptEdits) / Plan (plan) / Auto (auto) / Omitir permisos (bypass), más dontAsk, que se fija con un flag o en los ajustes (seis en total). La terminal y VS Code arrancan en Auto (en todos los planes desde la v2.1.283; antes, solo en Pro, Max y Team). Las rutas protegidas nunca se aprueban automáticamente fuera de la omisión.
• Cuál y cuándo: default para el trabajo sensible, acceptEdits para iterar, plan para entender primero, auto para tareas largas (con comprobaciones en segundo plano) y bypass solo en entornos aislados.

El modo de permisos gobierna la «seguridad» y el esfuerzo gobierna la «inteligencia»: domina ambos y Claude Code funcionará de forma segura y fluida. Combínalo con los hooks para añadir tus propias reglas de seguridad, y con el sandbox, que acota lo que los comandos pueden tocar a nivel del sistema operativo, para reducir las confirmaciones sin perder seguridad.

Preguntas frecuentes