Primero piensa, luego toca

Qué es y por qué importa

Cuando pides un cambio, Claude Code normalmente arranca enseguida: abre los archivos, escribe, cambia. Si te ha entendido bien, perfecto. Si no, te das cuenta al final, cuando ya ha tocado cinco archivos y tienes que averiguar qué ha hecho y cómo volver atrás.

El plan mode separa los dos momentos. Primero Claude lee los archivos, razona y te escribe lo que quiere hacer. Después, solo cuando lo apruebas, lo hace. En medio estás tú, con un plan que leer en lugar de un trabajo que deshacer.

Por qué importa: un plan lo corriges en un minuto, un cambio equivocado en varios archivos no. Y leyendo los planes también aprendes cómo está hecha tu app, archivo por archivo, que para quien no viene del desarrollo vale mucho. La guía oficial de Claude Code recomienda justo este orden: primero explora, luego planifica, luego escribe el código.

1. Cómo se activa

Hay varios caminos. En el terminal uso casi siempre el primero.

• En el terminal, con la sesión abierta: pulsa Shift+Tab. Los modos van en círculo, así que a veces hay que pulsarlo varias veces, hasta que debajo del cuadro aparece «⏸ plan mode on». Para salir sin aprobar nada, Shift+Tab otra vez.
• Sobre la marcha, con una petición: escribe /plan delante del mensaje. Claude entra en plan mode y empieza enseguida con esa petición.
• Desde el principio: arranca la sesión con el comando de abajo.
• En la app de escritorio: en la pestaña Code, abre el selector de modos junto al botón de enviar y elige Plan. Ahí solo vale para la sesión en curso.
• Siempre, en un proyecto: en el archivo .claude/settings.json del proyecto pones plan como modo de inicio, como en el archivo de abajo.

claude --permission-mode plan

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Si el settings.json ya existe, añade solo la parte permissions y no borres el resto. Vale para las sesiones que abres en el terminal en esa carpeta.

Qué hace Claude en plan mode

Lee los archivos, puede lanzar comandos para explorar el proyecto, razona y te escribe el plan. No modifica tus archivos hasta que lo apruebas. Si un comando no es de solo lectura, puede pedirte permiso antes de lanzarlo: lee qué quiere hacer antes de decir que sí.

2. La frase para planes cortos

Un plan largo no lo lee nadie. Si Claude te escribe dos páginas, acabas aprobando sin leer, y entonces el plan no sirve. Por eso, en plan mode, después de mi petición pego siempre esta frase:

Antes de tocar nada, hazme un plan corto: máximo 5 puntos, una línea cada uno. Para cada punto: qué archivo y qué cambias. Luego escribe qué NO vas a tocar. Al final dime cómo compruebo que funciona: un comando que lanzar o qué pruebo yo en la app. Si durante el trabajo necesitas un archivo que no está en el plan, para y pregúntamelo.

Cada parte tiene un motivo:

• «Máximo 5 puntos, una línea cada uno»: lo lees en medio minuto. Si el trabajo no cabe, normalmente son dos trabajos: sepáralos.
• «Qué archivo y qué cambias»: ves enseguida dónde va a meter las manos. No hace falta entender el código, basta con reconocer los nombres de los archivos.
• «Qué NO vas a tocar»: es el límite. Si ahí falta algo que te importa, como el login, te das cuenta antes.
• «Cómo compruebo que funciona»: un comando o una prueba en la app. Sin eso, la única señal de que el trabajo está terminado es que Claude te dice «hecho».
• «Para y pregúntamelo»: el plan se convierte también en un límite. Si a mitad del trabajo descubre que necesita otro archivo, te lo pregunta en lugar de ampliar por su cuenta.

Si para tus peticiones usas la plantilla de tres líneas (qué tiene que pasar, qué no debe cambiar, cómo lo comprobamos), funcionan bien juntas: la plantilla dice qué quieres, esta frase dice cómo tiene que ser el plan.

Un límite que conviene saber: la frase es una instrucción, no un bloqueo. Normalmente Claude la respeta, pero cuando sales del plan mode nada le impide de verdad abrir otro archivo. Por eso en las partes delicadas elijo aprobar los cambios uno a uno, como explico más abajo.

3. Leer el plan y decir adelante

Cuando llega el plan, lo leo buscando tres cosas:

• Un archivo que no pinta nada: si cambias un botón y en el plan aparece el archivo de los pagos, pregunta por qué.
• Un paso que cambia «toda la app»: «actualizo todos los componentes», «reorganizo las carpetas». Normalmente no lo has pedido tú.
• Una comprobación que falta: si al final no pone cómo lo verificas, haz que te lo escriba.

Corrige eso y luego le dices adelante.

Las opciones cuando el plan está listo

Claude te enseña el plan y te pregunta cómo seguir. Las opciones están en inglés:

• «Yes, and use auto mode»: apruebas y arranca en auto mode, es decir, trabaja sin pedirte permiso en cada paso, con controles automáticos en segundo plano sobre las acciones arriesgadas. Si el auto mode no está disponible en tu sesión, en su lugar verás «Yes, auto-accept edits».
• «Yes, manually approve edits»: apruebas y confirmas tú cada cambio, uno a uno. Es la que elijo cuando el plan toca el login, la base de datos o los pagos.
• «No, keep planning»: te quedas en el plan y le escribes qué cambiar.

Con «No, keep planning» uso frases cortas, como:

Quita el punto [número]: [archivo] no se toca. Reescribe el plan, siempre con un máximo de 5 puntos.

Si prefieres corregirlo a mano, pulsa Ctrl+G: el plan se abre en tu editor de texto y lo cambias directamente, antes de que Claude arranque. Cuando apruebas, Claude sale del plan mode y empieza a trabajar. Para planificar lo siguiente, vuelves a entrar con Shift+Tab o con /plan.

4. Cuándo no hace falta

Una errata, un texto, un color en un solo archivo, una pregunta: pídelo y ya. La guía oficial también lo dice: el plan cuesta tiempo, y si sabes describir el cambio en una frase puedes saltártelo.

Úsalo siempre que toques más de un archivo, la base de datos, el login o los pagos, o cuando no sepas por dónde empezar.

Errores comunes

• Aprobar sin leer: si el plan es demasiado largo para leerlo, pídelo corto con la frase, si no no te protege de nada.
• Decir adelante a un plan sin comprobación final: antes de aprobar, haz que te escriba cómo verificas que funciona.
• Usarlo para cada coma: para una errata o un color pide directamente y guarda el plan para los trabajos en varios archivos.
• Creer que la frase bloquea de verdad a Claude: es una instrucción, así que en las partes delicadas elige «Yes, manually approve edits» y mira cada cambio.
• Creer que sigues en plan mode después de aprobar: al aprobar sales de él, así que para el siguiente trabajo vuelves a entrar con Shift+Tab o /plan.

Lista de comprobación

• Debajo del cuadro veo «⏸ plan mode on»
• He pegado la frase para el plan corto
• El plan tiene como máximo 5 puntos, con los archivos
• Pone qué no va a tocar
• Hay una comprobación final que sé hacer
• En las partes delicadas apruebo los cambios a mano

Preguntas frecuentes