Claude Code Plan Mode es un modo de permiso que indica a Claude que lea los archivos del proyecto y proponga un plan sin editar el código fuente. Tú revisas ese plan y entonces decides si implementarlo. Las ediciones siguen bloqueadas hasta que apruebes, excepto en las sesiones de terminal interactiva donde bypass permissions está disponible: ahí no se aplican los bloqueos de plan mode. El prompt de ejemplo de abajo pide los archivos, por qué cambia cada uno, el orden y las comprobaciones.

Por ejemplo: añadir una fecha de vencimiento a una lista de tareas. ¿Basta con cambiar la pantalla? Puede que también tengas que mirar 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 o más formas de implementar el trabajo 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 de Claude Code, pulsa Shift+Tab para recorrer los modos de permiso hasta que la barra de estado muestre plan mode on. Detente ahí: otra pulsación sale de plan mode sin aprobar un plan. Desde el prompt también puedes entrar en plan mode con /plan, seguido opcionalmente de una descripción, por ejemplo /plan fix the auth bug.

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.

Deja sin cambios 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.

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 cuando abras la tarea de nuevo?
  • 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, elige No, keep planning en la pantalla de aprobación. Pulsa Ctrl+G para abrir el plan propuesto en tu editor de texto predeterminado y editarlo antes de continuar.

Cuando el plan encaje, elige cómo debe empezar la implementación. Yes, manually approve edits aprueba el plan y revisa cada edición por separado. Yes, and use auto mode aprueba y empieza en auto mode. Si auto mode no está disponible, esa opción dice Yes, auto-accept edits. Si bypass permissions ya está activado, dice Yes, and switch to BYPASS PERMISSIONS (no further prompts) for this session. Aprobar sale de plan mode y cambia la sesión al modo de permiso que describe esa opción. Cuando termine, revisa los cambios reales y el resultado de las pruebas. Un plan bien hecho no garantiza que el código funcione.

Plan Mode puede seguir ejecutando comandos para inspeccionar el repositorio. Los comandos fuera del conjunto de solo lectura pueden pedir aprobación, o puede revisarlos el clasificador cuando auto mode está disponible durante la planificación. Claude no edita el código fuente mientras planifica. Las ediciones siguen bloqueadas hasta que apruebes, excepto en las sesiones de terminal interactiva con bypass permissions disponible, donde no se aplican los bloqueos de plan mode.

Fuentes