Claude Code: los permisos, explicados
Claude Code revisa las reglas deny, luego ask y luego allow, y un allow estrecho nunca vence a un deny amplio. Seis pruebas de Tech AI Wire muestran dónde se detienen las reglas.
Por Claire Whitmore
5 min de lectura
Traducido automáticamente del original en inglés, que Claire Whitmore verificó y editó. Prevalece la versión en inglés. Cómo trabajamos

Los permisos de Claude Code son las reglas que deciden qué puede hacer por su cuenta el agente de programación de Anthropic. También indican qué debe preguntar antes y qué no puede hacer nunca. Están en archivos de configuración JSON, como tres listas: allow, ask y deny. Un modo de permisos define qué ocurre con todo lo que no coincide con ninguna regla. Si los configuras mal, o te ahogas en solicitudes de confirmación o dejas que el agente ejecute comandos que nunca quisiste aprobar.
Cómo funcionan los permisos de Claude Code
Cada regla nombra una herramienta, con un patrón opcional entre paréntesis. Bash(npm run test *) coincide con cualquier comando de shell que empiece por npm run test. Read(./.env) coincide con un solo archivo. WebFetch(domain:example.com) coincide con un solo sitio web. Un nombre de herramienta solo, como Bash, coincide con cualquier uso de esa herramienta.
Lo que más importa es el orden. La página de permisos de Anthropic dice: "Las reglas se evalúan en este orden: deny, luego ask, luego allow. La primera coincidencia en ese orden determina el resultado, y la especificidad de una regla no cambia el orden". Así, un deny amplio como Bash(aws *) también bloquea aws s3 ls, aunque un allow más estrecho nombre exactamente ese comando. En palabras de la documentación, "una regla allow no puede abrir una excepción dentro de una regla deny".
No todas las guías coinciden. Una entrada de abril de 2026 en el blog de Vincent Qiao afirma que Claude Code "evalúa primero la regla más específica". La página oficial y la prueba de Tech AI Wire que sigue dicen lo contrario.
Las reglas vienen de varios archivos, y sus listas se combinan en lugar de reemplazarse. La página de configuración da el orden para los valores únicos, de mayor a menor prioridad: "configuración gestionada, línea de comandos, proyecto local, proyecto compartido, usuario". La configuración gestionada la fija un empleador y no se puede anular. El archivo de proyecto compartido, .claude/settings.json, está pensado para subirse a Git. El archivo local, .claude/settings.local.json, es para una sola persona y queda fuera de Git. Y un deny en cualquier archivo gana, ya que "las reglas deny de cualquier ámbito se evalúan antes que las reglas allow".
Los seis modos de permisos
Un modo es la opción de respaldo para las llamadas que no coinciden con ninguna regla. Claude Code 2.1.325 acepta seis en su opción --permission-mode. Esta tabla resume cada uno a partir de la documentación de Anthropic.
| Modo | Qué se ejecuta sin preguntar | Ideal para |
|---|---|---|
default (se muestra como Manual) | Lecturas; cualquier otra herramienta pregunta en su primer uso | Repositorios desconocidos |
acceptEdits | Lecturas, ediciones de archivos y mkdir, touch, mv, cp en la carpeta de trabajo | Sesiones con muchas ediciones que supervisas |
plan | Lecturas y comandos de shell de solo lectura; sin ediciones en los archivos fuente | Planificar antes de hacer cambios |
auto | Todo, con una comprobación en segundo plano de las acciones de shell y de red | Tareas largas en las que confías |
dontAsk | Solo herramientas aprobadas de antemano; todo lo que pediría confirmación se rechaza | Scripts y CI |
bypassPermissions | Todo excepto las acciones que ningún modo aprueba automáticamente | Solo contenedores y máquinas virtuales aislados |
Las reglas deny siguen bloqueando en todos los modos, incluido bypassPermissions, según la página de modos de permisos.
Prueba de Tech AI Wire: seis reglas, seis resultados
La prueba se hizo el 18 de noviembre de 2026, en macOS 26.6 con Claude Code 2.1.325, en una carpeta de Git vacía. Cada ejecución usó claude -p con --permission-mode dontAsk, de modo que una llamada que habría pedido confirmación se rechazaba. La opción --settings aportaba las reglas, y --setting-sources local dejaba fuera la configuración propia de la máquina. Se pidió al modelo Haiku que ejecutara un comando, y se revisó la salida JSON en busca de permission_denials.
| Prueba | Reglas | Comando | Resultado |
|---|---|---|---|
| A | allow Bash(echo hello) | echo hello | Se ejecutó |
| B | allow Bash(echo hello), deny Bash(echo *) | echo hello | Rechazado |
| C | allow Bash(echo hello), ask Bash(echo *) | echo hello | Rechazado |
| D | sin reglas | echo hello | Se ejecutó |
| E | allow Bash(cat *), deny Read(./secret.txt) | cat secret.txt | Rechazado |
| F | allow Bash(python3 *), deny Read(./secret.txt) | python3 -c "print(open('secret.txt').read())" | Se ejecutó y mostró el archivo |
Las pruebas B y C confirman el orden: el deny y el ask más amplios vencen ambos al allow exacto. La prueba D se ejecutó sin ninguna regla, porque echo está en el conjunto integrado de comandos de solo lectura de Claude Code. La prueba E muestra que un deny de Read también cubre cat. La documentación dice lo mismo de head, tail, sed y tee.
La prueba F es el hueco. La documentación advierte que los deny de archivos no alcanzan a "un script de Python o Node que abre archivos por sí mismo". Aquí, un script de Python de una línea leyó el archivo "denegado" y lo mostró.
Qué cambió y cuándo
Los permisos han cambiado a menudo en 2026. La versión 2.1.257 hizo que bypassPermissions dejara de tener efecto en la configuración de proyecto o local, según la página de configuración. Desde la 2.1.283, auto es el modo predeterminado de las sesiones interactivas de terminal y de VS Code. Desde la 2.1.302, claude -p ejecutado sin un modo definido arranca en Manual.
Tech AI Wire ha cubierto la configuración que rodea a estas reglas. Claude Code empezó en agosto a añadir por defecto un enlace de sesión a los commits. Empezó a leer AGENTS.md como alternativa en la versión 2.1.277. La guía de Tech AI Wire sobre los plugins de Claude Code trata las extensiones, que añaden herramientas que necesitan sus propias reglas. La forma mcp__<server>__<tool> nombra una herramienta de un servidor MCP, una fuente de herramientas parecida a un plugin.
Qué significa para los desarrolladores
Escribe reglas deny para lo que nunca debe ocurrir, y mantenlas amplias: Bash(git push *) en lugar de un solo nombre de rama. Un deny amplio no se puede deshacer con un allow estrecho, así que no puedes crear excepciones dentro de él. Usa ask para las acciones que quieras revisar, ya que un ask también vence a un allow que coincida.
No trates un deny de Read como protección para un secreto. La prueba F muestra que cualquier script que el agente pueda ejecutar puede abrir el archivo igualmente. La documentación dice que una regla de Bash "no es una frontera de seguridad alrededor del programa". Para límites reales, añade el sandbox, que restringe a qué pueden llegar los comandos de shell a nivel del sistema operativo. Mejor aún, mantén los secretos fuera de la carpeta del proyecto.
Sube tu configuración a Git como .claude/settings.json para que todo el equipo tenga los mismos deny. Guarda las aprobaciones personales en settings.local.json. Para los trabajos de CI, usa dontAsk con una lista allow explícita, para que un comando inesperado falle en lugar de quedarse colgado en una solicitud de confirmación. Reserva bypassPermissions para contenedores desechables.
Fuentes
- Configure permissions - Claude Code Docs
- Claude Code settings - Claude Code Docs
- Choose a permission mode - Claude Code Docs
- Claude Code Permission Rules & settings.json Guide - AI Arte
- Claude Code settings.json Permissions: Control Exactly What AI Can Do - Vincent's Blog
Artículos relacionados

Una extensión de Claude Code en Cursor plantó puertas traseras SSH
Las compilaciones manipuladas 2.1.312 y 2.1.313 de la extensión de Claude Code estuvieron unas 11 horas en el marketplace de Cursor el 29 de octubre. Añadían una clave SSH y un túnel inverso.

Android Studio Rabbit 2 abre el IDE a más de 40 agentes
Android Studio Rabbit 2 ya es estable y admite más de 40 agentes de código externos, entre ellos Claude y Codex. Android CLI ahora se instala como plugin para ambos.

Perplexity libera como código abierto SPACE, su sandbox para agentes de IA
Perplexity publicó el 15 de octubre bajo Apache 2.0 SPACE, el sandbox de Firecracker que usa su agente Computer. Sus propias pruebas registraron 0 fugas en 108 intentos.