Inicio / Fundamentos y bucle del agente

Permisos y modo plan

El modo de permiso decide qué acciones ejecuta Claude Code sin preguntar nada, y desde la versión 2.1.228, en sesión interactiva de terminal o VS Code, el modo que recibe una sesión nueva en las ofertas Pro, Max y Team ya no es el modo default sino el modo auto, que 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 nada, y cuáles se detienen ante una invitación de confirmación en pantalla. Verificado con la documentación oficial el 2 de septiembre de 2026, esta elección cuenta hoy con seis modos, y ya no los cuatro modos más antiguos que aún describían algunas notas de curso.

Seis modos, una red diferente cada vez

El modo default solo lee, cada edición de archivo y cada comando de shell esperan una respuesta. El modo acceptEdits edita los archivos y lanza los comandos de sistema de archivos habituales sin preguntar nada, pero se detiene ante todo lo demás. El modo plan se mantiene de solo lectura mientras produce un plan; cuando el modo auto está disponible y el ajuste useAutoModeDuringPlan, activo por defecto, lo permite, un clasificador separado aprueba ciertos comandos de shell durante la planificación misma, si no, cualquier comando fuera del núcleo de solo lectura espera una aprobación manual. El modo auto actúa ampliamente, edita archivos, lanza comandos, bajo la vigilancia en segundo plano de ese mismo clasificador, que funciona por defecto sobre un modelo de la familia Sonnet y bloquea de entrada algunas categorías precisas: descargar y luego ejecutar código, exfiltrar datos sensibles, desplegar en producción, borrar en masa en almacenamiento en la nube, o lanzar git reset --hard y terraform destroy. El modo dontAsk no va más allá de las herramientas ya aprobadas de antemano. El modo bypassPermissions suprime la red entera, ya nada se detiene.

El modo de arranque ha cambiado

Desde la versión 2.1.228 de Claude Code en macOS, Linux y WSL, y la versión 2.1.233 en Windows nativo, una sesión interactiva de terminal o VS Code abierta en las ofertas Pro, Max y Team arranca en modo auto en lugar de modo default, mostrado como Manual en la barra de estado. Este cambio no se aplica en todas partes: una versión anterior, la primera sesión tras una instalación o una actualización, la variable disableAutoMode activada, claude -p, el Agent SDK, o una ejecución en Bedrock, Vertex, Foundry o una pasarela vuelven siempre al modo default. Una tarea lanzada sin mirar el modo activo puede entonces ejecutarse más lejos de lo que un habituado al comportamiento anterior esperaría, con la vigilancia del clasificador como única red, en las condiciones donde el modo auto se aplica realmente. Este clasificador no está pensado para vigilar sin reaccionar jamás: tras una serie de rechazos seguidos, el modo auto se pone él mismo en pausa y vuelve a pedir una confirmación, la figura que acompaña esta lección cifra los dos umbrales que desencadenan esta pausa.

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

El atajo Mayús+Tabulador hace ciclar los modos disponibles con el teclado, sin salir de la conversación en curso: default, luego acceptEdits, luego plan, luego bypassPermissions si se ha activado, luego auto si está disponible, antes de volver a default. El indicador de línea de comandos --dangerously-skip-permissions equivale exactamente al modo bypassPermissions.

El modo plan, una esclusa antes de escribir

El modo plan sigue siendo la manera más segura de abordar una tarea cuyo alcance aún no se conoce: Claude lee, explora, propone una secuencia de acciones, y nada toca el disco antes de que un plan sea aprobado, salvo en una sesión donde el modo bypassPermissions está disponible, donde las ediciones no se quedan bloqueadas esperando esta aprobación. En una tarea que toca varios archivos a la vez, esta esclusa cuesta unos segundos de lectura y evita descubrir después que una hipótesis de partida era falsa. Si un plan aprobado se va de todos modos en mala dirección durante su ejecución, la tecla Esc interrumpe la vuelta en curso sin perder el trabajo ya hecho.