Modos de permisos de Claude Code, explicados
Un modo de permisos decide cuánto puede hacer Claude Code antes de pararse a preguntarte. Elegir el adecuado para cada trabajo te libera tanto de las interrupciones constantes como de los sustos.
Los seis modos
- Manual (
default)Ejecuta las lecturas sin preguntar y pregunta por lo demás. Úsalo para revisar cada acción o en trabajo delicado. - Accept edits (
acceptEdits)Aprueba además las ediciones de archivos y comandos de archivos habituales comomkdir,mvycpdentro del directorio de trabajo. Bueno para ir iterando sobre código que revisas sobre la marcha. - Plan (
plan)Claude lee y explora, y luego escribe un plan. No edita tu código fuente hasta que apruebes el plan. - Auto (
auto)Ejecuta sin preguntar, con un modelo clasificador aparte que revisa cada acción antes de que se ejecute. Para tareas largas en las que los avisos constantes estorban. - Don't ask (
dontAsk)Permite solo las lecturas y las herramientas que aprobaste de antemano, y deniega todo lo demás. Pensado para CI y scripts muy cerrados. - Bypass permissions (
bypassPermissions)Ejecuta todo sin avisos. La documentación dice que se use solo en contenedores aislados y máquinas virtuales.
Las reglas deny bloquean en todos los modos, también en bypass. Las reglas allow no tienen efecto en el modo bypass.
En qué modo empieza una sesión nueva depende de tu versión, tu plan y tus ajustes. La documentación da el orden: primero la opción de la línea de comandos, luego permissions.defaultMode en un archivo de ajustes y por último el valor por defecto.
Cómo cambiar
- Shift+Tab recorre los modos en la terminal. Auto aparece en el ciclo cuando está disponible, y bypass solo si lo activaste al lanzar Claude Code. Don't ask no aparece nunca en el ciclo.
- Al lanzar:
claude --permission-mode plan. - Como valor por defecto: pon
permissions.defaultModeen un archivo de ajustes. El.claude/settings.jsono el.claude/settings.local.jsonde un proyecto ignoraautoybypassPermissions. - VS Code, la app de escritorio y la web tienen un selector de modo junto a la caja de texto.
El modo plan, paso a paso
- Pulsa Shift+Tab hasta estar en modo plan, o escribe
/plan, o lanza con--permission-mode plan. - Pide lo que quieres. Claude explora y escribe un plan.
- Pulsa
Ctrl+Gsi quieres editar antes el plan en tu editor. - Elige: aprobar y seguir con el modo auto, aprobar y revisar tú cada edición, o seguir planificando y dar tu opinión. Si el modo auto no está disponible, la primera opción dice «Yes, auto-accept edits».
Shift+Tab otra vez sale del modo plan sin aprobar nada. Si quieres que Claude te pregunte antes de construir, mira haz que Claude Code pregunte primero (en inglés).
Qué es el modo auto y qué no es
Un modelo clasificador aparte revisa las acciones antes de que se ejecuten. Por defecto bloquea cosas como pasar una descarga directamente a la terminal para ejecutarla, enviar datos sensibles fuera, despliegues a producción, force push y comandos como git reset --hard que tirarían a la basura trabajo sin guardar. Permite cosas como trabajar con archivos locales de tu proyecto e instalar las dependencias que tu proyecto declara. Si bloquea tres acciones seguidas, o 20 en total, se pausa y vuelve a preguntar.
Al entrar en el modo auto, descarta las reglas allow amplias que dejarían ejecutar cualquier código, como Bash(*). Las reglas estrechas como Bash(npm test) se mantienen. Que auto esté disponible depende de tu plan, proveedor, modelo y versión. La documentación deja claro que reduce los avisos y no garantiza la seguridad.
Bypass: lee esta parte dos veces
- Apaga los avisos y las comprobaciones de seguridad, también las de rutas protegidas, y no protege contra la inyección de instrucciones (texto dentro de una página o archivo que intenta dirigir a Claude).
- Úsalo solo en un contenedor aislado o una máquina virtual, a ser posible sin acceso a internet.
- Se activa al lanzar con
--permission-mode bypassPermissionso--dangerously-skip-permissions. Solo aparece en el ciclo de Shift+Tab si empezaste con una opción de bypass (o lo pusiste como valor por defecto en tus ajustes de usuario). - En Linux y macOS se niega a ejecutarse como root.
- Si necesitas una garantía firme, escribe reglas deny. Valen en todos los modos. Mira una lista de partida de reglas de permisos.
Lo que nunca se aprueba solo
Las escrituras en rutas protegidas no se aprueban automáticamente, salvo en el modo bypass. Entre los directorios protegidos están .git, .vscode, .idea y .claude. Entre los archivos protegidos están los de arranque de la terminal como .bashrc, además de .npmrc y .mcp.json. Una regla allow en un archivo de ajustes no aprueba de antemano una escritura ahí. Incluso en el modo bypass, una lista corta de acciones, como borrar con rm rutas críticas del sistema, sigue pidiendo confirmación o se rechaza.
Cuál elegir
- No sabes qué va a hacer un proyecto: Manual, o Plan primero.
- Editas código que estás mirando: Accept edits.
- Una tarea larga y bien definida en un proyecto de confianza: Auto, con reglas deny para lo que nunca debe pasar.
- Un script sin supervisión: Don't ask, con las herramientas necesarias permitidas. O un contenedor aislado si tienes que usar bypass.
Límites
- Los modos, los valores por defecto y los requisitos cambian entre versiones, y varios dependen de tu plan, proveedor y modelo. La página de modos de permisos es la que manda.
- Es información general sobre una herramienta, no una auditoría de seguridad.
Esta página sigue la documentación de modos de permisos de Anthropic tal como la leemos en octubre de 2026. No tenemos relación con Anthropic. La escribimos a partir de la documentación y no hemos probado todos los modos en todos los sistemas.
Mira también: Trabajar hacia un objetivo con /goal · Claude Code en JetBrains.
La skill gratis loop-stop da a las tareas largas un límite y una regla de parada. Si quieres una segunda mirada a tu CLAUDE.md y a tus ajustes, el Tune-Up Kit es una lista de comprobación para eso (la ficha está en inglés).