Modo plan en Claude Code: planifica antes de ejecutar
El modo plan de Claude Code hace que el modelo analice y proponga un plan sin tocar nada. Entras con Shift+Tab dos veces o con /plan. Es la diferencia entre dejar que el agente improvise sobre tu código y revisar qué va a hacer antes de que lo haga. En refactors grandes no es opcional: es lo que evita que un mal plan arrastre toda la ejecución.
Regla de oro: activa el modo plan siempre en refactors grandes y cambios que tocan varios archivos. No toca nada (solo analiza y propone) y consume aproximadamente la mitad del contexto que ir improvisando.
Los comandos de planificación de un vistazo
| Comando | Qué hace |
|---|---|
Shift+Tab (×2) |
Entra en modo planificación. |
/plan |
Inicia directamente en modo planificación. |
/spec-developer |
Genera el diseño técnico antes de codear. |
/tasks |
Gestiona la lista de tareas. |
AskUserQuestion |
El agente te pregunta para definir bien el objetivo. |
/start-session |
Arranca el trabajo con planificación. |
Por qué planificar primero
Con los modelos actuales, la calidad del resultado depende casi por completo del plan: si el plan es bueno, el código va a ser bueno. Un plan con contexto faltante manda al agente en la dirección equivocada, y cada corrección posterior consume tokens y degrada los pasos siguientes. Revisar el plan antes de ejecutar es la forma más barata de evitar ese zigzag.
El modo plan separa dos momentos que conviene no mezclar: decidir qué hacer (planificar, sin riesgo) y hacerlo (ejecutar, con el plan ya validado).
Cómo se usa
- Entra en modo plan:
Shift+Tabdos veces, o/plan. - Describe el objetivo: el agente explora el código y propone un plan. No edita nada todavía.
- Revisa y ajusta: si el plan tiene huecos, corrígelo en la conversación. Aquí es donde le das el contexto que falta.
- Aprueba y ejecuta: cuando el plan es sólido, sales del modo plan y el agente lo ejecuta.
Para diseños técnicos más formales, /spec-developer genera el diseño antes de codear, y /tasks te deja gestionar la lista de pasos.
Preguntas frecuentes
¿Qué es el modo plan en Claude Code?
Es un modo en el que Claude Code analiza tu petición y propone un plan sin ejecutar ni editar nada. Sirve para revisar qué va a hacer el agente antes de que lo haga. Se entra con Shift+Tab dos veces o con el comando /plan.
¿Cómo activo el modo plan?
Con Shift+Tab pulsado dos veces, o escribiendo /plan. También puedes arrancar la sesión planificando con /start-session.
¿Por qué usar el modo plan en Claude Code?
Porque la calidad del resultado depende del plan: un buen plan da buen código. Revisar el plan antes de ejecutar evita que el agente tome una dirección equivocada y gaste tokens corrigiéndose. Además, el modo plan consume aproximadamente la mitad del contexto que ir improvisando.
¿El modo plan modifica mi código?
No. El modo plan solo analiza y propone; no edita archivos ni corre comandos. Los cambios se aplican después, cuando sales del modo plan y apruebas la ejecución.
Recursos relacionados
- Cómo dominar Claude Code: la guía completa.
- Ingeniería de contexto: por qué un buen plan depende del contexto que le das.
- Comandos de contexto: gestionar el contexto durante la planificación.
Tu siguiente paso
El modo plan, los comandos de specs y decenas más están en la Cheat Sheet de Claude Code: una hoja imprimible, en español.
Descargar la Cheat Sheet gratis
Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).