Respuesta corta: el modo plan es un modo de permisos de Claude Code en el que el modelo explora tu código y propone un enfoque sin tocar tus archivos. La documentación de Anthropic lo describe con precisión: en modo plan Claude lee archivos y ejecuta comandos de shell de solo lectura para explorar, pero no edita tus archivos fuente, y donde el modo auto está disponible también se ejecutan los comandos aprobados por el clasificador. Aparece como Plan en la CLI y en la extensión de VS Code. Se activa pulsando Shift+Tab para recorrer los modos de permisos, o arrancando la sesión con claude --permission-mode plan. No cuesta nada extra: es un modo, no una función de pago.
Qué incluye
El modo plan convive con los demás modos de permisos de Claude Code, y conviene conocer las diferencias porque determinan cuánta supervisión te va a exigir cada uno.
Anthropic documenta los modos así. default, etiquetado como Manual en la CLI, en las extensiones de VS Code y JetBrains y en la aplicación de escritorio, pide permiso la primera vez que se usa cada herramienta. acceptEdits acepta automáticamente ediciones de archivos y comandos habituales del sistema de archivos como mkdir, touch, mv y cp para rutas dentro del directorio de trabajo o de additionalDirectories. plan explora sin editar. auto aprueba llamadas a herramientas de forma automática, con comprobaciones de seguridad en segundo plano que verifican que las acciones encajan con lo que pediste. dontAsk deniega herramientas automáticamente salvo que estén aprobadas de antemano. bypassPermissions se salta las peticiones de permiso excepto en acciones que ningún modo aprueba solo.
Lo que obtienes concretamente en modo plan es acceso completo de lectura y ningún acceso de escritura. Claude puede abrir archivos, seguir las importaciones, ejecutar comandos de shell de solo lectura para entender el proyecto y construir una imagen fiel de cómo funciona algo antes de proponer un cambio. Lo que no puede hacer es editar tu código.
Esa restricción es todo el valor. El fallo más caro en programación con agentes no es una respuesta equivocada, sino veinte ediciones seguras en la dirección equivocada que después tienes que deshacer.
Cómo activar el modo plan
Tres caminos, según cómo trabajes.
- Recorrer los modos con Shift+Tab. Anthropic documenta que esta tecla recorre default, acceptEdits, plan y, cuando están disponibles, bypassPermissions y después auto. Desde auto, la primera pulsación vuelve a default. En Windows, Alt+M hace lo mismo cuando el entorno de Node o Bun no habilita el modo de entrada VT.
- Arrancar la sesión ya en modo plan. Pasa el flag:
claude --permission-mode plan. La referencia de la CLI señala que esto permite empezar en otro modo como plan y cambiar a bypassPermissions más tarde. - Fijarlo como valor por defecto en sesiones delegadas. La misma referencia documenta pasar
--permission-modejunto a--model,--efforto--agentpara fijar valores por defecto en sesiones delegadas, útil cuando lanzas trabajo en segundo plano.
Comprueba el indicador de modo antes de describir una tarea. El error más común con el modo plan es dar por hecho que estás en él cuando no lo estás.
El patrón investigar, planificar, implementar
El patrón que más partido saca a este modo tiene tres etapas distintas, y la disciplina consiste en mantenerlas separadas.
Investigar. En modo plan, pide a Claude que investigue en lugar de que arregle. “Explica cómo funciona la autenticación en este código, dónde se renuevan los tokens y qué ocurre cuando la renovación falla.” Estás comprando un modelo mental fiel, y puedes contrastarlo con lo que ya sabes, que es tu forma de comprobar si el resto se sostendrá.
Planificar. Todavía en modo plan, pide un enfoque: qué archivos cambian, en qué orden, cuáles son los riesgos, qué habría que probar. Pide que escriba ese plan en un archivo Markdown para que sobreviva a la sesión y otra persona pueda revisarlo. Un buen plan nombra los archivos, fija la secuencia y dice con claridad sobre qué no está seguro.
Implementar. Cambia de modo y ejecuta contra el plan acordado. Como el plan está escrito, puedes comprobar cada paso contra él en vez de revisar un diff grande sin punto de referencia.
La documentación de flujos habituales cubre también delegar la investigación a subagentes, algo que encaja de forma natural aquí: explorar es justo el tipo de trabajo que merece un contexto aparte.
Qué contiene de verdad un buen plan
La mayoría de los planes decepcionantes lo son porque la petición estaba poco especificada. Un plan contra el que merece la pena implementar tiene cinco cosas, y pedirlas de forma explícita cambia bastante el resultado.
Nombra archivos. “Actualiza el middleware de autenticación” no es un plan; “modifica src/auth/middleware.ts y src/auth/refresh.ts, añade un test en tests/auth/refresh.test.ts” sí lo es.
Fija una secuencia con un motivo. Hacer la migración antes del cambio de código, o al revés, suele ser una decisión con consecuencias, y un plan que no explica el orden es un plan que no lo ha pensado.
Identifica qué se puede romper. Qué llamadas dependen del comportamiento actual, qué pasa con las peticiones en vuelo durante un despliegue, si el cambio es retrocompatible.
Dice sobre qué no está seguro. Esta es la sección más valiosa y la que hay que pedir expresamente. Un modelo que enumera tres supuestos que no ha podido verificar en el código te está dando exactamente la lista que debes comprobar tú.
Define la comprobación. Cómo sabrás que el cambio funcionó, expresado como un test o un comportamiento observable y no como “debería funcionar”.
Pide esas cinco cosas y el plan pasa a ser un documento que puedes entregar a un compañero, no un párrafo de intenciones.
Valor y comparación entre modos
| Modo | Escribe archivos | Mejor para | Riesgo principal |
|---|---|---|---|
| default (Manual) | Solo tras pedir permiso | Trabajo cuidadoso sobre código ajeno | Fatiga de avisos y aprobación refleja |
| plan | No | Entender, diseñar, revisar un enfoque | Olvidarte de salir de él |
| acceptEdits | Sí, automáticamente | Cambios mecánicos bien acotados | Ediciones que no has revisado |
| auto | Sí, con comprobaciones de seguridad | Trabajo repetitivo de confianza | Exceso de confianza en cambios con consecuencias |
| bypassPermissions | Sí, sin avisos | Entornos aislados y desechables | Todo |
La comparación que más importa es plan frente a acceptEdits, porque son los dos entre los que se alterna de verdad. Usa plan cuando todavía no sabes cuál es el cambio correcto. Usa acceptEdits cuando ya lo sabes y el trabajo es mecánico.
También hay un argumento de coste. Las sesiones largas con agentes consumen contexto, y el contexto es lo que consume tu cuota de uso. Una sesión que edita veinte minutos en la dirección equivocada y luego revierte cuesta mucho más que una que dedica cinco minutos a leer y después ejecuta limpiamente. La documentación de costes de Claude Code explica cómo funciona el uso en la terminal, y el indicador de contexto en vivo es la cifra que conviene vigilar.
Planes, facturación y qué verificar
El modo plan no es en sí una capa de pago, y el acceso a Claude Code va ligado a tu suscripción. La documentación de soporte de Anthropic explica que los suscriptores Pro y Max autentican Claude Code con las mismas credenciales que usan para Claude, así que una suscripción cubre ambas cosas.
Cosas que conviene confirmar en el sitio oficial antes de depender de ellas:
- Qué planes incluyen Claude Code y con qué nivel de uso. La página de precios lista Free, Pro, Max 5x y Max 20x, y describe Max como 5 o 20 veces más uso que Pro.
- Tu ciclo de facturación y si aplica el mensual o el anual.
- Si tienes una variable de entorno
ANTHROPIC_API_KEYconfigurada en tu máquina. Anthropic señala que, si la tienes, Claude Code usa esa clave para autenticarse en lugar de tu suscripción, lo que significa que se te factura por token en vez de consumir tu plan. - Cualquier política a nivel de organización si estás en un plan Team o Enterprise, ya que los modos de permisos pueden restringirse de forma centralizada.
Advertencias sobre precios
Los precios, los nombres de los planes y las cuotas de uso cambian, y nada de esta página debe tomarse como una tarifa vigente. Verifica los precios actuales en el sitio oficial antes de comprometerte.
Dos advertencias más conviene decirlas claramente. Primero, la disponibilidad de cada modo varía: la documentación de Anthropic indica que bypassPermissions y auto aparecen en el ciclo solo “cuando están disponibles”, lo que depende de tu versión y de la configuración de tu organización. Segundo, algunas etiquetas y alias dependen de la versión, y la etiqueta Manual está documentada a partir de una versión concreta de Claude Code. Si tu indicador no coincide con lo que lees aquí, actualiza antes de dar por hecho que algo está roto.
Resolución de problemas del modo plan
- Claude editó archivos igualmente. No estabas en modo plan. Comprueba el indicador y recuerda que Shift+Tab recorre en lugar de alternar, así que una pulsación de más te lleva más allá.
- El plan es vago. Los planes vagos siguen a peticiones vagas. Pide archivos nombrados, una secuencia ordenada y una lista explícita de dudas.
- Sigue pidiendo permiso para ejecutar comandos. El modo plan permite comandos de shell de solo lectura. Un comando que no considere de solo lectura seguirá pidiendo permiso, y eso es el modo funcionando bien.
- El plan desapareció al terminar la sesión. Pídelo como archivo Markdown dentro del repositorio. Un plan que vive en el historial de la terminal es un plan que vas a perder.
- Shift+Tab no hace nada en Windows. Anthropic documenta Alt+M como alternativa cuando el entorno de Node o Bun no habilita el modo de entrada VT.
Producto, curso, app y plataforma en la práctica
Hay tres caminos para llegar a manejar bien esto, y sirven a perfiles distintos. La documentación del producto es autorizada y escueta, lo que funciona bien si ya sabes qué buscas. Experimentar en tu propio repositorio te enseña tus fallos concretos, aunque despacio. Un curso estructurado te da la secuencia y el vocabulario, que es la ruta más rápida para quien todavía no ha formado hábitos.
Los equipos que más sacan de este modo tratan el plan como el entregable de la primera sesión, no como el preámbulo del trabajo de verdad. Un plan escrito puede ser revisado por un compañero, discutido y corregido antes de que cambie una sola línea, y ese es un sitio mucho más barato para detener una mala idea que una pull request.
Hacerlo bien es más una habilidad de dirigir estas herramientas que una función de ellas: saber cuánto contexto aportar, cómo pedir un plan comprobable en lugar de plausible, y dónde la seguridad del modelo supera lo que realmente sabe de tu sistema. Aprenderlo en una secuencia estructurada es más rápido que descubrirlo sesión a sesión, y se transfiere a cualquier herramienta con agentes en vez de a un solo producto. Si quieres una ruta estructurada, explora las lecciones de Coursiv y consulta los detalles de plan vigentes en el sitio oficial.
Preguntas frecuentes
¿Puede Claude modificar archivos en modo plan?
¿Cómo activo el modo plan?
claude --permission-mode plan. En Windows, Alt+M recorre los modos en entornos que no habilitan el modo de entrada VT.¿El modo plan cuesta más?
¿El modo plan ahorra uso?
Tu siguiente paso
En tu próxima tarea que no sea trivial, empieza en modo plan y pide el enfoque como archivo Markdown antes de editar nada. Léelo con atención, corrige las dos cosas que ha entendido mal de tu sistema y solo entonces cambia de modo e implementa contra él. Casi todo el mundo que lo prueba una vez deja de trabajar de otra manera, porque el plan convierte un diff enorme e irrevisable en una secuencia de pasos que ya habías aceptado.