Permisos y modos de permiso en Claude Code: qué puede hacer sin preguntarte
Claude Code puede pedir tu aprobación antes de editar archivos o ejecutar comandos, o trabajar con más autonomía. Te explico los modos de permiso, cómo cambiarlos y cómo escribir reglas de permitir, preguntar y denegar.
- Javi Mata
- 9 min de lectura
Tabla de contenido
- Qué es un modo de permiso
- Cómo cambiar de modo
- acceptEdits: revisar después, no aprobar cada edición
- plan: piensa antes de tocar
- auto: menos avisos, con un revisor
- dontAsk: para CI
- bypassPermissions: solo en entornos aislados
- Rutas protegidas: lo que no se aprueba solo
- Reglas de permisos: permitir, preguntar, denegar
- Reglas, hooks y CLAUDE.md: quién manda
- Mi recomendación
- Conclusión
- Fuentes
Una de las primeras cosas que notas al usar Claude Code es que te pregunta antes de hacer ciertas cosas: editar un archivo, ejecutar un comando, consultar una URL. Esos avisos son parte de un sistema de permisos que puedes ajustar, y entenderlo te ahorra dos problemas opuestos: aprobar cien avisos seguidos sin leerlos, o darle a Claude más libertad de la que querías.
Si todavía no lo usas, empieza por la guía de inicio.
Qué es un modo de permiso
Un modo de permiso define qué acciones puede hacer Claude en una sesión sin preguntarte antes. En el modo Manual, Claude Code se detiene y te consulta antes de la mayoría de las acciones que editan archivos, ejecutan comandos de shell o acceden a la red. En el modo auto, un segundo modelo (el clasificador) revisa las acciones en lugar de ti.
Estos son los modos, con lo que cada uno permite sin preguntar:
| Modo | Qué corre sin preguntar | Ideal para |
|---|---|---|
default | Solo lecturas | Revisar cada acción tú mismo, trabajo sensible |
acceptEdits | Lecturas, edición de archivos y comandos comunes del sistema de archivos (mkdir, touch, mv, cp, etc.) | Iterar sobre código que vas a revisar |
plan | Lecturas, más comandos aprobados por el clasificador si el modo auto está disponible | Explorar un proyecto antes de cambiarlo |
auto | Todo, con verificaciones de seguridad en segundo plano | Tareas largas, evitar la fatiga de avisos |
dontAsk | Lecturas y herramientas preaprobadas; lo que pediría permiso se deniega | CI y scripts bloqueados |
bypassPermissions | Todo | Solo contenedores y máquinas virtuales aislados |
El modo que revisa cada acción se llama Manual en la CLI, en las extensiones de VS Code y JetBrains y en la app de escritorio; su valor de configuración es default. Desde Claude Code v2.1.200 puedes escribir manual como alias.
Cómo cambiar de modo
En la CLI, pulsa Shift+Tab para recorrer los modos. La barra de estado muestra el modo activo: ⏸ manual mode on, ⏵⏵ accept edits on, ⏸ plan mode on, ⏵⏵ auto mode on, ⏵⏵ don't ask on o ⏵⏵ bypass permissions on. No todos están en el ciclo: dontAsk nunca aparece (se activa con --permission-mode dontAsk), y bypassPermissions solo aparece si arrancaste con una opción que lo habilita.
Para arrancar en un modo concreto, usa el flag:
claude --permission-mode plan
Para fijar el modo inicial de tus sesiones, usa permissions.defaultMode en un archivo de configuración. Por ejemplo, en ~/.claude/settings.json:
{
"permissions": {
"defaultMode": "default"
}
}
La siguiente sesión mostrará ⏸ manual mode on en la barra de estado. Ojo: la documentación advierte que si pones "auto" o "bypassPermissions" en .claude/settings.json o .claude/settings.local.json del proyecto, esos valores no tienen efecto. Y en VS Code, el modo inicial se controla con la opción claudeCode.initialPermissionMode.
acceptEdits: revisar después, no aprobar cada edición
Este modo permite que Claude cree y edite archivos en tu directorio de trabajo sin preguntar. Además de las ediciones, aprueba automáticamente comandos comunes del sistema de archivos: mkdir, touch, rm, rmdir, mv, cp y sed, solo para rutas dentro de tu directorio de trabajo o de additionalDirectories. Cualquier otro comando de Bash sigue pidiendo permiso, salvo los de solo lectura integrados.
Es útil cuando prefieres revisar los cambios en tu editor o con git diff en lugar de aprobar cada edición. Se activa con Shift+Tab una vez desde Manual, o directamente:
claude --permission-mode acceptEdits
plan: piensa antes de tocar
En modo plan, Claude investiga y propone cambios sin hacerlos: lee archivos, ejecuta comandos para explorar y escribe un plan, pero no edita tu código fuente. Se entra con Shift+Tab, con /plan al inicio de un prompt, o al arrancar:
claude --permission-mode plan
Cuando el plan está listo, Claude te lo presenta y puedes elegir cómo seguir. Entre las opciones están Yes, manually approve edits (aprobar y revisar cada edición) y No, keep planning (seguir en modo plan e indicarle qué cambiar). También puedes pulsar Ctrl+G para abrir el plan en tu editor de texto y modificarlo antes de que Claude continúe.
auto: menos avisos, con un revisor
En el modo auto, un modelo clasificador separado revisa las acciones antes de ejecutarlas, y bloquea lo que exceda lo que pediste, apunte a infraestructura desconocida o parezca motivado por contenido hostil que Claude leyó. Las reglas ask explícitas siguen forzando un aviso.
La propia documentación es clara con esto: reduce los avisos, pero no garantiza seguridad. Úsalo en tareas cuya dirección general te da confianza, no como reemplazo de la revisión en operaciones sensibles.
Su disponibilidad depende de tu plan, del modelo y del proveedor, y cambia según la versión de Claude Code (por ejemplo, la documentación indica que con v2.1.283 o posterior es el modo inicial integrado en sesiones interactivas de terminal y VS Code). Como esos detalles cambian, consulta la página oficial de modos antes de depender de ello.
dontAsk: para CI
En este modo, Claude Code deniega automáticamente toda llamada que normalmente te pediría permiso. Sigue ejecutando lo que no necesita aprobación en Manual (por ejemplo, lecturas dentro de tus directorios de trabajo y comandos de Bash de solo lectura) y lo que coincide con tus reglas permissions.allow. Es para pipelines de CI o entornos restringidos donde defines de antemano qué puede hacer Claude. Ejemplo de la documentación:
claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"
bypassPermissions: solo en entornos aislados
Este modo desactiva los avisos de permisos y las comprobaciones de seguridad, incluso las escrituras en rutas protegidas. La documentación es tajante: úsalo únicamente en entornos aislados como contenedores, máquinas virtuales o dev containers, donde Claude no pueda dañar tu equipo. Además, no ofrece protección contra prompt injection ni acciones no deseadas.
No puedes entrar a bypassPermissions desde una sesión que no lo tenía habilitado; se activa al iniciar, por ejemplo con claude --permission-mode bypassPermissions (el flag --dangerously-skip-permissions es equivalente). En Linux y macOS, Claude Code se niega a arrancar en este modo como root o con sudo.
Rutas protegidas: lo que no se aprueba solo
Las escrituras a un conjunto pequeño de rutas nunca se aprueban automáticamente (salvo en bypassPermissions). Evita que se corrompa el estado del repositorio o la configuración de Claude. Entre los directorios protegidos están .git, .vscode, .idea, .husky y .claude, y entre los archivos, .gitconfig, .bashrc, .zshrc, .npmrc, .mcp.json y .claude.json (la lista completa está en la documentación). Los modos default y acceptEdits te preguntan; dontAsk las deniega. Las reglas allow de tus archivos de configuración no preaprueban escrituras a estas rutas.
Reglas de permisos: permitir, preguntar, denegar
Los modos fijan la base; encima puedes poner reglas. Con /permissions ves todas las reglas y el archivo settings.json de donde viene cada una.
- Allow deja que Claude use la herramienta sin aprobación manual.
- Ask pide confirmación cada vez.
- Deny impide usar la herramienta.
Se evalúan en este orden: deny, luego ask, luego allow, y la primera coincidencia decide. La especificidad no cambia el orden: una regla deny amplia como Bash(aws *) bloquea también lo que coincidiría con un allow más específico. Un allow no puede hacer una excepción a un deny.
Las reglas tienen el formato Herramienta o Herramienta(especificador). Ejemplo de la documentación:
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(git commit *)"
],
"deny": [
"Bash(git push *)"
]
}
}
Con esto, Claude Code ejecuta scripts de npm y commits sin preguntar, y rechaza los comandos que empiezan con git push. Un git push escrito de otra forma, como git -C . push, no coincide con la regla. Un detalle importante de sintaxis: pon el * después del subcomando (Bash(git log *) permite solo git log; Bash(git *) permite todos los comandos de git).
Para bloquear la lectura de archivos, añade una regla Read de denegar sobre su ruta, como Read(./.env) o Read(./secrets/**). Ojo con la letra pequeña: estas reglas se aplican a las herramientas de archivos integradas y a comandos como cat o sed que Claude Code reconoce en Bash, pero no a scripts que leen archivos por su cuenta (por ejemplo, uno de Python o Node). Para un bloqueo a nivel de sistema operativo, la documentación recomienda activar el sandbox.
Reglas, hooks y CLAUDE.md: quién manda
Las reglas de permisos las aplica Claude Code, no el modelo. Escribir en tu CLAUDE.md “nunca leas el .env” orienta lo que Claude intenta hacer, pero no cambia lo que Claude Code permite. Para conceder o revocar acceso de verdad, usa /permissions, reglas, un modo de permiso o un hook PreToolUse.
Los hooks encajan aquí: un PreToolUse se ejecuta antes del aviso de permiso y puede denegar, forzar un aviso o saltarlo. Pero un hook no puede saltarse tus reglas: si hay un deny que coincide, se bloquea aunque el hook devuelva allow. Si quieres bloquear ediciones a archivos concretos con un script, mira el artículo sobre hooks en Claude Code.
Las reglas también siguen la precedencia de configuraciones: si una regla deniega algo en cualquier nivel, ningún otro nivel puede permitirlo. Un deny de la configuración administrada no se puede anular con --allowedTools.
Mi recomendación
Mi recomendación, como punto de partida:
- Trabajo diario en un proyecto que conoces:
acceptEditsy revisar congit diff. - Proyecto nuevo o ajeno: empieza en
plan, lee el plan y luego aprueba las ediciones a mano. - Reglas
allowpara lo repetitivo (Bash(npm run *)) ydenypara lo que nunca debe pasar (Read(./.env)). - Deja
bypassPermissionspara contenedores desechables. Nunca en tu equipo de trabajo.
Y revisa los avisos: un permiso concedido por costumbre es peor que uno bien pensado.
Conclusión
El sistema de permisos de Claude Code es una escala entre control y autonomía: los modos fijan cuánto pregunta, y las reglas afinan casos concretos. Con acceptEdits o plan para el día a día, un par de reglas y un poco de criterio, trabajas rápido sin ceder el control.
Fuentes
Etiquetas:
Compartir: