Inicio / Fundamentos y bucle del agente

Permisos y modo plan

El modo de permiso decide qué acciones ejecuta Claude Code sin preguntar: desde septiembre de 2026, una sesión interactiva de terminal o VS Code sin modo configurado arranca en modo auto, en todos los planes, y ya no en modo default, y el modo auto actúa ampliamente bajo la vigilancia en segundo plano de un segundo modelo.

El modo de permiso decide qué acciones ejecuta Claude Code sin preguntar, y cuáles se detienen ante una invitación de confirmación. Desde septiembre de 2026, una sesión interactiva de terminal o VS Code arranca en modo auto cuando no hay ningún modo configurado, en todos los planes. El modo de partida ya no es, pues, el que pregunta antes de cada acción.

Seis modos, una red diferente cada vez

El modo default, mostrado como manual mode on en la barra de estado, solo lee: cada edición y cada comando de shell esperan una respuesta. El modo acceptEdits edita los archivos y lanza los comandos habituales de sistema de archivos, pero se detiene ante el resto. El modo plan se mantiene de solo lectura mientras produce un plan. El modo auto actúa ampliamente bajo la vigilancia en segundo plano de un clasificador, un segundo modelo que bloquea de entrada algunas categorías: descargar y luego ejecutar código, exfiltrar datos sensibles, desplegar en producción, borrar en masa en almacenamiento en la nube, lanzar git reset --hard o terraform destroy. El modo dontAsk no va más allá de las herramientas aprobadas de antemano. El modo bypassPermissions suprime la red entera.

Cuando la sesión no arranca en auto

El ajuste disableAutoMode, un modelo no admitido, una organización con configuración HIPAA o un corte en el servidor devuelven la sesión al modo manual. claude -p y el Agent SDK también arrancan en default desde octubre de 2026: una llamada que necesita aprobación se rechaza allí mientras una regla de autorización o un hook no la conceda. Una tarea lanzada sin mirar el modo activo puede, pues, ejecutarse más lejos de lo previsto, con el clasificador como única red. Este clasificador reacciona: tras una serie de rechazos seguidos, el modo auto se pone en pausa y vuelve a pedir confirmación, y la figura cifra los dos umbrales.

claude --permission-mode plan
# lanza la sesión directamente en modo plan,
# de solo lectura mientras el plan no esté aprobado

Mayús+Tabulador hace ciclar los modos disponibles sin salir de la conversación: default, acceptEdits, plan, bypassPermissions si está activado, auto si está disponible, y vuelta a default. El indicador --dangerously-skip-permissions equivale al modo bypassPermissions.

Ajustar lo que el modo auto deja pasar

Antes de una lectura fuera de los directorios de trabajo, el modo auto plantea una invitación: la respuesta «Yes, but ask again next time» autoriza esa lectura sin abrir la puerta a las siguientes. El comando /auto-mode-setup lee el proyecto y las sesiones recientes para enseñar al modo auto su entorno, lo que reduce los rechazos inútiles sin pasar a bypass. En cuanto a las reglas, mcp__a ya solo cubre un servidor llamado a, no a__b ni a_: escribe mcp__servidor__* para un servidor entero. Una regla de Bash con :* en medio del patrón, ignorada hasta ahora en los archivos de ajustes, se aplica ya allí: relee las tuyas.

El modo plan, una esclusa antes de escribir

Claude lee, explora, propone una secuencia de acciones, y nada toca el disco antes de la aprobación del plan, salvo en un terminal interactivo donde el modo bypassPermissions está disponible: las ediciones allí ya no esperan la aprobación. Fuera de ese caso, el modo plan sigue siendo de verdad de solo lectura, incluso frente a un hook PreToolUse que autorizara una escritura. Si un plan aprobado se va en mala dirección, la tecla Esc interrumpe la vuelta en curso sin perder el trabajo ya hecho.