¿Le has pedido a Claude una sola función y ha tocado más archivos de los que esperabas? Plan Mode sirve para ver, antes de que cambie el código, qué archivos tocaría y por qué. Claude lee el proyecto, ordena el trabajo y propone un plan. Tú lo revisas y solo entonces dejas que implemente.

Por ejemplo: añadir una fecha de vencimiento a una lista de tareas. ¿Basta con cambiar la pantalla? A menudo hay que mirar también dónde se guarda la fecha y cómo se muestra. Con Plan Mode puedes ver el alcance que Claude está considerando antes de que edite nada.

Cuándo conviene usarlo

Ayuda cuando hay que cambiar varios archivos a la vez, o cuando el proyecto es nuevo para ti y hace falta entender la estructura. También cuando hay dos formas razonables de hacerlo y quieres compararlas antes.

Si el cambio está claro —una errata en el texto de un botón, por ejemplo—, pide la edición directamente. No hace falta planificar cada tarea.

1. Entra en Plan Mode

Desde el terminal, ve a la carpeta del proyecto y arranca Claude Code así:

claude --permission-mode plan

Si ya estás en una sesión, pulsa Shift+Tab hasta que la barra de estado muestre plan mode on. Esa línea indica que el modo de planificación está activo. También puedes empezar un mensaje con /plan.

2. Di el resultado que quieres y lo que no hay que tocar

El ejemplo de abajo supone que añades fechas de vencimiento a una app de tareas. Úsalo tal cual o adáptalo a tu trabajo.

Quiero añadir fechas de vencimiento a la lista de tareas.
No edites archivos todavía. Revisa el código actual y prepara un plan.

Resultado que busco:
- Cada tarea debe poder tener una fecha de vencimiento y verse en la lista.
- Las tareas antiguas sin fecha deben seguir mostrándose bien.

Esta vez no toques:
- Mantén el inicio de sesión y el diseño general de la lista.

Incluye en el plan:
1. Qué archivos cambiarías y por qué
2. El orden de implementación
3. Qué pruebas ejecutar y qué pantalla comprobar al terminar

Si hay que decidir el formato de la fecha, pregúntame antes de implementar.

Es el mismo pedido corto —«añade la fecha de vencimiento»— con el resultado y el alcance añadidos. La condición de que las tareas antiguas sin fecha sigan viéndose bien pide que el plan cubra no solo la función nueva, sino también cómo conservar el comportamiento actual. Di cómo debe quedar al terminar, no qué librería, patrón o disposición de archivos usar.

3. Lee el plan, corrige lo que falte y aprueba

Cuando Claude proponga el plan, comprueba tres cosas:

  • Alcance: ¿pretende cambiar el inicio de sesión o el diseño entero, que no tienen que ver con la fecha?
  • Casos que faltan: ¿trata las tareas sin fecha? ¿Hay forma de volver a mostrar una fecha guardada al reabrir la lista?
  • Cómo comprobarlo: ¿indica qué pruebas correr y qué pantalla mirar después de implementar?

Si falta algo, no apruebes todavía. Pide, por ejemplo: «incluye también cómo tratar las tareas antiguas que no tienen fecha». Para seguir ajustando el plan, en el aviso de aprobación elige No, keep planning. Esa opción te deja en Plan Mode para corregir el plan; no es otro atajo.

Con Ctrl+G abres el texto del plan en tu editor y lo editas ahí. No omite un paso: cambia el propio plan.

Si el plan te encaja, apruébalo para que empiece la implementación. Cuando termine, revisa los cambios reales y el resultado de las pruebas. Un plan bien hecho no garantiza que el código funcione. Después de salir o de aprobar, vuelve a entrar con Shift+Tab o empezando el siguiente mensaje con /plan.

Plan Mode puede ejecutar comandos mientras explora el código. No es una pantalla de notas: es el momento de revisar el alcance antes de tocar archivos.

Fuentes