Plan mode en Claude Code: revisar antes de ejecutar

Hola, bienvenido. En la lección anterior preparamos el prompt de tarea para el modelo Task y lo dejamos sin lanzar, y en esta lección lo vamos a pasar por plan mode. Vamos a ver cómo entrar y salir de plan mode, qué puede hacer Claude mientras planifica, cómo revisar el plan que te propone, cómo corregirlo respondiendo con feedback o editándolo directamente con Ctrl+G, por qué conviene arreglar los comandos para Sail antes de aprobar nada y qué opciones tienes cuando decides aprobarlo.

¿Por qué no lanzar la tarea directamente? Porque, como avisa la documentación, dejar que Claude se ponga a programar sin más puede darte código que resuelve el problema equivocado. El error típico es dejar que empiece demasiado pronto: primero que lea, luego que proponga y después decides tú. Plan mode separa la exploración de la ejecución, y la documentación lo coloca dentro de un flujo de 4 fases que vamos a repetir mucho en el curso: explorar, planificar, implementar y hacer el commit. En esta lección nos quedamos en las 2 primeras, que son las que deciden si las otras 2 van bien.

Plan mode es útil, pero también añade trabajo: una vuelta más de lectura, un plan que revisar y una conversación antes de tocar nada. La documentación es bastante concreta sobre cuándo compensa. Planificar sirve sobre todo cuando no tienes claro el enfoque, cuando el cambio toca varios archivos o cuando no conoces el código que se va a modificar. Y para las tareas de alcance claro y cambio pequeño, como corregir una errata, añadir una línea de log o renombrar una variable, lo razonable es pedírselo a Claude directamente.

Hay una regla sencilla que te sirve para decidir: si puedes describir el diff en una frase, sáltate el plan. «Añade completed_at al $fillable de Task» cabe en una frase y no necesita plan. Nuestro modelo Task, en cambio, son 4 archivos que tienen que encajar entre sí, un modelo, una migración, una factory y un test, con decisiones de por medio como dónde va el test o cómo se escribe el scope. Es exactamente el tipo de tarea en el que un plan te ahorra vueltas.

Esto encaja con lo que vimos en la lección de modos de permiso, donde plan mode aparecía como el modo para las tareas con riesgo. Y fíjate en un detalle que lo hace aún más útil hoy: como la sesión arranca en auto mode, sin plan mode Claude editaría esos 4 archivos sin preguntarte nada. Plan mode te da un punto en el que parar antes de que se toque el proyecto, sin renunciar a auto mode para el resto del trabajo.