Claude

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

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:

ModoQué corre sin preguntarIdeal para
defaultSolo lecturasRevisar cada acción tú mismo, trabajo sensible
acceptEditsLecturas, edición de archivos y comandos comunes del sistema de archivos (mkdir, touch, mv, cp, etc.)Iterar sobre código que vas a revisar
planLecturas, más comandos aprobados por el clasificador si el modo auto está disponibleExplorar un proyecto antes de cambiarlo
autoTodo, con verificaciones de seguridad en segundo planoTareas largas, evitar la fatiga de avisos
dontAskLecturas y herramientas preaprobadas; lo que pediría permiso se deniegaCI y scripts bloqueados
bypassPermissionsTodoSolo 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:

  1. Trabajo diario en un proyecto que conoces: acceptEdits y revisar con git diff.
  2. Proyecto nuevo o ajeno: empieza en plan, lee el plan y luego aprueba las ediciones a mano.
  3. Reglas allow para lo repetitivo (Bash(npm run *)) y deny para lo que nunca debe pasar (Read(./.env)).
  4. Deja bypassPermissions para 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