El modo plan de Claude Code es un modo de solo lectura en el que el agente explora tu base de código y escribe un plan de implementación paso a paso sin editar un solo archivo. Lo activas pulsando Shift+Tab hasta que la barra de estado muestre ⏸ plan mode on, anteponiendo /plan a un prompt, o iniciando con claude --permission-mode plan. Claude lee, busca y redacta el plan; nada se escribe en disco hasta que lo apruebas. Es la forma más barata de evitar que un agente de IA reescriba con total seguridad los diez archivos equivocados. Construimos este pipeline de contenidos sobre Claude Code, y el modo plan es lo primero a lo que recurrimos en cualquier cambio que abarque más de un archivo.
¿Qué es el modo plan de Claude Code?
El modo plan es uno de los modos de permiso de Claude Code: un estado de sesión que controla lo que el agente puede hacer sin pedirte permiso primero. En modo plan, Claude se limita a leer archivos, buscar en el repositorio, ejecutar comandos de shell de solo lectura y hacer preguntas de aclaración. En lugar de editar código, produce un plan, que en realidad no es más que un documento en markdown que describe los cambios que pretende hacer, los archivos que tocará y el orden en que trabajará. Lees ese plan como si fuera la descripción de un pull request, lo refinas y solo entonces dejas que Claude lo ejecute. La documentación oficial de Claude Code lo describe como «investigar y proponer cambios sin realizarlos». La clave es la separación: pensar es barato y reversible, editar no lo es, así que el modo plan obliga a que el pensamiento ocurra y reciba tu visto bueno antes de que se mueva una sola línea de código.
Cómo activar el modo plan
Hay tres formas de entrar, y cada una encaja en un momento distinto:
| Método | Qué hacer | Ideal para |
|---|---|---|
| Teclado | Pulsa Shift+Tab para alternar default → acceptEdits → plan | Cambiar a mitad de sesión cuando te das cuenta de que una tarea es mayor de lo que parecía |
| Prefijo de comando | Empieza un único prompt con /plan | Una consulta de planificación puntual sin cambiar el modo de la sesión |
| Flag de CLI | Inicia con claude --permission-mode plan | Empezar una sesión que sabes que necesitará un plan primero |
Cuando el modo plan está activo, la barra de estado muestra ⏸ plan mode on, así que siempre sabes que el agente está en territorio de solo lectura. Pulsa Shift+Tab de nuevo para salir del modo plan sin aprobar nada. El prefijo /plan es un comando de barra, así que se aplica solo al prompt que escribes delante de él, lo cual resulta cómodo cuando trabajas casi siempre en otro modo pero quieres una única respuesta planificada.
Qué puede y qué no puede hacer Claude en modo plan
En modo plan, Claude puede leer cualquier archivo, hacer grep y glob por todo el repositorio, ejecutar comandos de solo lectura para entender el código, hacerte preguntas y escribir el plan en sí. No puede editar tu código fuente, crear ni borrar archivos, hacer commits ni ejecutar comandos de shell destructivos. Esas ediciones permanecen bloqueadas hasta que apruebas el plan. Hay una salvedad que conviene conocer: en una sesión que se inició con permisos de bypass disponibles, los bloqueos del modo plan no se aplican, así que trata el modo plan como una barrera de protección, no como un sandbox estricto. También vale la pena ser honestos sobre su funcionamiento interno. Como Armin Ronacher documentó tras hacerle ingeniería inversa, la función es en gran medida un prompt estructurado más recordatorios de sistema que mantienen al agente en modo de solo lectura, y un archivo de plan en markdown que edita como cualquier otro. Esto no es una crítica sobre si funciona; es un recordatorio de que el modo plan es disciplina de comportamiento, útil precisamente por ser consistente.
El modo plan frente a los demás modos de permiso
El modo plan cobra el mayor sentido cuando ves dónde encaja dentro del conjunto completo de modos de permiso. Cada uno intercambia supervisión por velocidad:
| Modo | Ejecuta sin preguntar | Ideal para |
|---|---|---|
default (Manual) | Solo lecturas | Empezar, trabajo delicado |
acceptEdits | Lecturas, ediciones de archivos, comandos comunes del sistema de archivos | Iterar sobre código que estás revisando activamente |
plan | Lee y explora, sin ediciones hasta que apruebas | Entender un cambio antes de hacerlo |
auto | Acciones aprobadas por un clasificador, menos avisos | Tramos autónomos de confianza y más largos |
dontAsk | Solo herramientas preaprobadas | CI y scripts blindados |
bypassPermissions | Todo | Solo contenedores y VM aislados |
La distinción práctica que la gente busca es modo plan frente a modo edición. «Modo edición» suele referirse a acceptEdits, donde Claude escribe los cambios sobre la marcha. El modo plan es el extremo opuesto: no escribe nada hasta que has leído y aprobado el plano. default se sitúa entre ambos, pidiéndote confirmación para cada edición individual. Usa el modo plan para decidir qué hacer y luego aprueba pasando a un modo de edición para hacerlo de verdad.
Cómo revisar y aprobar un plan
Cuando el plan está listo, Claude lo presenta y te pregunta cómo proceder. Según la documentación de modos de permiso, tienes cuatro opciones:
- Yes, and use auto mode (o «Yes, auto-accept edits» cuando el modo auto no está disponible): aprueba y deja que Claude trabaje con un mínimo de avisos.
- Yes, manually approve edits: aprueba, pero revisa cada edición de forma individual a medida que ocurre.
- No, refine with Ultraplan on Claude Code on the web: entrega el plan a una sesión en la nube para refinarlo desde el navegador.
- No, keep planning: quédate en modo plan y dile a Claude qué cambiar.
Antes de decidir, pulsa Ctrl+G para abrir el plan propuesto en tu editor de texto predeterminado y editarlo directamente. Este es el hábito de mayor rendimiento de todo el flujo de trabajo: ajusta el alcance, elimina los pasos con los que no estés de acuerdo, añade una restricción que el agente haya pasado por alto. Aprobar un plan sale del modo plan, cambia la sesión al modo de edición que describa tu elección e incluso nombra la sesión a partir del contenido del plan. Para volver a planificar más tarde, alterna de nuevo con Shift+Tab o antepón /plan a tu siguiente prompt.
Cuándo usar el modo plan y cuándo omitirlo
Recurre al modo plan cuando el coste de un paso en falso sea alto: refactorizaciones que abarcan varios archivos, cambios en el esquema de la base de datos, una base de código que no conoces, código sensible en materia de seguridad, o cualquier cosa que toque más o menos tres archivos o más. En esos casos, el plan es donde detectas el malentendido, de forma barata, antes de que se convierta en un diff que tengas que deshacer. Se combina de forma natural con subagentes para exploraciones con mucha investigación y con git worktrees cuando quieres planificar una función mientras otra se ejecuta.
Omítelo para trabajo pequeño y bien entendido. Si ya conoces el cambio exacto de una sola línea, entrar en modo plan solo añade una ida y vuelta de revisión a una tarea que no la necesitaba. Algunos usuarios experimentados van más allá y sostienen que el modo plan es más liviano de lo que sugiere la interfaz, ya que pedirle a Claude un plan escrito en un mensaje normal te aporta casi el mismo valor con más control. Hay algo de verdad en ello. El contraargumento es la consistencia: el modo plan hace que «planificar primero» sea el camino por defecto en lugar de un hábito que tienes que recordar, y para un equipo o un pipeline automatizado, un valor por defecto fiable supera a una buena intención.
Haz del modo plan tu valor por defecto y úsalo en la automatización
Si quieres planificar primero siempre, configúralo como valor por defecto. Añade esto al .claude/settings.json de tu proyecto (o a ~/.claude/settings.json para todos los proyectos):
{
"permissions": {
"defaultMode": "plan"
}
}
El mismo flag --permission-mode plan funciona con -p para ejecuciones headless y no interactivas, que es la forma de construir una barrera de revisión «solo plan» en CI: haz que Claude genere un plan para un cambio y publícalo para que una persona lo lea antes de que se fusione nada. Para una planificación más pesada que bloquearía tu terminal, Ultraplan entrega la tarea a una sesión de Claude Code on the web que se ejecuta en modo plan, de modo que el plan se redacta en la nube mientras sigues trabajando en local. Iníciala con /ultraplan; es una función en fase de research preview, así que espera que evolucione.
Preguntas frecuentes
¿Cuál es la diferencia entre el modo plan y el modo edición?
El modo plan es de solo lectura: Claude redacta un plan de implementación y no edita nada hasta que lo apruebas. «Modo edición» generalmente se refiere a acceptEdits, donde Claude escribe cambios en tus archivos mientras trabaja. Usa el modo plan para acordar el enfoque y luego aprueba pasando a un modo de edición para aplicarlo.
¿Cuál es el atajo de teclado para el modo plan?
Pulsa Shift+Tab en la CLI para alternar entre default, acceptEdits y plan. Llegarás al modo plan cuando la barra de estado muestre ⏸ plan mode on. Pulsa Shift+Tab de nuevo para salir sin aprobar un plan.
¿El modo plan realmente impide que Claude edite archivos? Sí, en una sesión normal las ediciones y los comandos destructivos quedan bloqueados hasta que apruebas el plan. La excepción es una sesión iniciada con permisos de bypass disponibles, donde esos bloqueos no se aplican, así que el modo plan es una barrera de protección más que un sandbox estricto.
¿Puedo establecer el modo plan como valor por defecto?
Sí. Establece "defaultMode": "plan" bajo permissions en .claude/settings.json para un solo proyecto, o en ~/.claude/settings.json para aplicarlo en todas partes. Las nuevas sesiones arrancarán entonces en modo plan.
¿Qué es Ultraplan?
Ultraplan envía una tarea de planificación desde tu CLI local a una sesión de Claude Code on the web que se ejecuta en modo plan, de modo que el plan se redacta en la nube mientras tu terminal queda libre. Lo activas con /ultraplan o eligiéndolo al aprobar un plan. Actualmente es una research preview.
Sources
- Claude Code Docs — Choose a permission mode — referencia oficial del modo plan, la lista completa de modos, las opciones de aprobación y la configuración de
defaultMode - Claude Code Docs — Common workflows: Plan before editing — el ciclo de
Shift+Tab,claude --permission-mode plany el distintivo de estado⏸ plan mode on - Claude Code Docs — Ultraplan — sesiones de modo plan en la nube delegadas desde la CLI
- Armin Ronacher — What Actually Is Claude Code's Plan Mode? — cómo funciona el modo plan por dentro y sus límites
Waqas Ahmed Waseer
Waqas Ahmed Waseer es desarrollador y creador de automatizaciones con más de 8 años construyendo sistemas en producción que usan más de 100.000 personas. Crea SaaS multiinquilino a medida, automatización con IA (n8n, flujos LLM, bots de WhatsApp) e infraestructura de hosting (WHM/cPanel, CloudLinux), y es el creador de WaSphere, FlowMaticX y la marca de hosting WaseerHost. Más de 100 proyectos entregados para pymes, agencias y startups financiadas.
