≡En resumen
- En plan mode Claude explora y propone, pero no modifica tu código hasta que apruebas el plan.
- Se entra con Shift+Tab, anteponiendo /plan a un prompt o arrancando con --permission-mode plan.
- Al aprobar eliges cómo seguir: en modo automático o aceptando ediciones, o revisando cada edición a mano.
- Es especialmente útil en tareas grandes, código que no conoces o cambios con riesgo, donde un mal enfoque cuesta caro.
- El alias de modelo opusplan usa Opus mientras planificas y Sonnet para ejecutar.
01 ¿Qué es el plan mode de Claude Code?
Plan mode es uno de los modos de permisos de Claude Code. Le dice a Claude que investigue y proponga cambios sin hacerlos: lee archivos, ejecuta comandos para entender el proyecto y escribe un plan, pero no edita tu código fuente. Las ediciones siguen bloqueadas hasta que apruebas el plan.
Es el equivalente a pedirle a un desarrollador sénior que, antes de tocar nada, te explique qué va a cambiar, en qué archivos y en qué orden. Separar el "qué y cómo" del "hazlo" reduce mucho las sesiones en las que el agente se lanza en la dirección equivocada y hay que deshacer media hora de trabajo.
02 Cómo activar el plan mode
-
1
Con el teclado
Pulsa Shift+Tab hasta que la barra de estado muestre plan mode on. Volver a pulsarlo te saca del modo sin aprobar ningún plan.
-
2
Con un comando
Escribe /plan seguido de la tarea, por ejemplo /plan corrige el error de autenticación, y Claude empieza a planificar.
-
3
Al arrancar
Lanza claude --permission-mode plan para empezar la sesión directamente en modo plan.
-
4
Por defecto en un proyecto
Pon defaultMode con el valor plan en el apartado permissions de .claude/settings.json para que las sesiones de terminal del proyecto empiecen así.
-
5
En otras interfaces
En VS Code y en la app de escritorio, elige Plan en el selector de modo junto al cuadro de prompt.
03 Qué puede y qué no puede hacer Claude en plan mode
| Acción | En plan mode |
|---|---|
| Leer archivos y buscar en el código | Sí, sin pedir permiso |
| Comandos de solo lectura (listar, ver diffs, buscar) | Sí |
| Otros comandos de shell | Los revisa el clasificador del modo automático si está disponible; si no, te piden permiso |
| Editar o crear archivos de tu código | No, hasta que apruebas el plan |
| Lanzar subagentes de exploración | Sí, para investigar partes del proyecto en paralelo |
| Hacerte preguntas para aclarar requisitos | Sí, antes de cerrar el plan |
En proyectos grandes, Claude suele repartir la exploración entre subagentes que leen distintas zonas del código y le devuelven un resumen. Así el plan se basa en lo que hay de verdad en el repositorio y no en suposiciones, y el contexto de la conversación principal no se llena de archivos leídos.
04 Revisar y aprobar el plan
Cuando el plan está listo, Claude lo presenta y te pregunta cómo seguir. Antes de decidir puedes pulsar Ctrl+G para abrir el plan en tu editor de texto y modificarlo directamente: quitar pasos, cambiar el orden o añadir restricciones.
Sí, y usar el modo automático
Aprueba y sigue en modo automático, con un clasificador que revisa las acciones en segundo plano. Si ese modo no está disponible, la opción es aceptar ediciones automáticamente.
Sí, aprobando ediciones a mano
Aprueba el plan pero revisa cada edición antes de que se aplique. Útil en código sensible o cuando quieres seguir el cambio paso a paso.
No, seguir planificando
Te quedas en plan mode y le explicas a Claude qué cambiar del plan.
05 Cuándo usar plan mode (y cuándo no)
- ✓Tareas que tocan varios archivos o capas: un endpoint nuevo con su servicio, su migración y sus tests.
- ✓Código que no conoces o que hace tiempo que no tocas.
- ✓Refactorizaciones y migraciones de versión donde un enfoque equivocado multiplica el trabajo.
- ✓Cambios con riesgo: pagos, autenticación, datos de clientes o despliegues.
- ✓Cuando quieres que otra persona del equipo revise el enfoque antes de escribir código.
- ✓Cuando vas a dejar trabajar a Claude un buen rato sin supervisión.
06 Errores comunes al usar plan mode
Aprobar sin leer
El plan es el momento más barato para corregir el rumbo. Si lo apruebas sin revisarlo, pierdes justo la ventaja que te da el modo.
Pedir un plan demasiado vago
"Mejora el rendimiento" produce un plan genérico. Indica qué página, qué métrica y qué límite tienes, y el plan será concreto.
No dar restricciones
Si hay librerías que no se pueden usar, archivos intocables o plazos, dilo antes de planificar; Claude no puede adivinarlo leyendo el código.
Planes gigantes
Un plan con veinte pasos que tocan media aplicación es difícil de revisar. Divide el trabajo en fases y planifica cada una por separado.
Olvidar los tests
Pide que el plan incluya cómo se va a comprobar cada cambio: tests nuevos, comandos a ejecutar o pasos de verificación manual.
Un buen hábito es pedirle a Claude, antes de aprobar, que enumere los riesgos del plan y lo que no ha podido comprobar. Esa lista suele destapar dudas de negocio que conviene resolver con el equipo, como qué pasa con los datos existentes o si un cambio afecta a otros clientes, antes de escribir una sola línea de código.
07 Modelo, esfuerzo y plan mode
Planificar es la parte de la tarea donde más compensa razonar a fondo. El alias de modelo opusplan aprovecha esa idea: usa Opus mientras estás en plan mode y cambia automáticamente a Sonnet al ejecutar, de modo que pagas el modelo más capaz solo en la fase que más lo necesita. También puedes subir el esfuerzo de razonamiento mientras planificas y bajarlo para ejecutar un plan ya cerrado.
| Situación | Configuración que suele funcionar |
|---|---|
| Tarea compleja con presupuesto ajustado | Modelo opusplan |
| Arquitectura nueva o decisión difícil | Plan mode con esfuerzo high o xhigh |
| Ejecución de un plan muy detallado | Esfuerzo medium tras aprobar |
| Exploración rápida de un repositorio | Plan mode con el esfuerzo por defecto del modelo |
08 Ejemplo práctico de flujo con plan mode
1. Escribes /plan añade suscripciones mensuales con Stripe al panel de clientes.
2. Claude revisa modelos, rutas, controladores y tests, y te pregunta si los precios se guardan en base de datos o en Stripe.
3. Presenta el plan: migración, servicio de pagos, webhook, vistas, tests y variables de entorno nuevas.
4. Con Ctrl+G quitas la parte de cupones, que irá en otra fase.
5. Apruebas revisando cada edición, porque toca pagos.
Es el tipo de flujo que seguimos en nuestro desarrollo de software SaaS: decidir primero, programar después.
Plan mode es una de las prácticas que más diferencia el uso amateur de Claude Code del profesional. Si quieres aplicarla a un proyecto de desarrollo web a medida o ver otras herramientas que la complementan, revisa nuestra selección de herramientas para trabajar con Claude.
Preguntas frecuentes sobre Plan mode (modo plan)
Es un modo de permisos en el que Claude investiga el código y redacta un plan de cambios sin editar tus archivos. Las ediciones quedan bloqueadas hasta que apruebas el plan.
Pulsa Shift+Tab hasta ver plan mode on, empieza tu mensaje con /plan o arranca Claude Code con claude --permission-mode plan.
Sí, para explorar. Los comandos de solo lectura se ejecutan directamente; el resto los revisa el clasificador del modo automático si está disponible o te piden permiso.
Sí. Pulsa Ctrl+G para abrirlo en tu editor y cambiarlo, o elige seguir planificando y explícale a Claude qué quieres distinto.
Vuelve a pulsar Shift+Tab para cambiar a otro modo de permisos. El plan no se aplica.
Es un alias de modelo de Claude Code que usa Opus mientras estás en plan mode y cambia automáticamente a Sonnet cuando Claude pasa a ejecutar el plan.
No necesariamente. Explorar el código consume tokens, pero suele ahorrar en el total porque evita implementar un enfoque equivocado y tener que deshacerlo.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗