Plan mode en Claude Code: cómo activarlo y cuándo usarlo (con prompt)

¿Por qué un arreglo de 50 € acaba en una obra de 5.000? Porque la IA construyó sin plan.

Piénsalo como una casa. Le dices a Claude «pinta la puerta» y lo hace al momento. Perfecto. Pero le dices «ponle un segundo piso» y se pone a construir a lo loco: paredes, vigas, una escalera… que luego no cabe. Toca tirarlo todo.

El problema no es Claude. Es que un cambio grande necesita un plan antes de mover un ladrillo. Para eso existe el plan mode de Claude Code.

Qué es plan mode

Es un modo en el que Claude revisa tu proyecto sin tocar nada. Lee los archivos, puede ejecutar comandos para explorar y te escribe un plan con los pasos. Tus archivos no cambian hasta que tú lo apruebas.

Cómo activarlo

En la terminal, con Claude Code abierto:

1. Pulsa Shift+Tab. Cada pulsación cambia de modo: normal, aceptar ediciones y plan.
2. Sigue pulsando hasta que la barra de abajo muestre ⏸ plan mode on.
3. Escribe tu petición como siempre.

Otras formas de entrar:

• Arrancar ya en plan mode: claude --permission-mode plan.
• Solo para un mensaje: escribe /plan delante. Por ejemplo: /plan añade un formulario de contacto.
• VS Code y app de escritorio: elige el modo en el selector que hay debajo de la caja de texto.

¿Te arrepientes? Pulsa Shift+Tab otra vez y sales del plan mode sin aprobar nada.

Cuándo usarlo (y cuándo no)

La regla cabe en una línea: cambio pequeño, pide. Cambio grande, primero el plan.

Si dudas, usa el plan. Leer un plan son dos minutos. Deshacer una obra a lo loco, una tarde.

Cómo revisar el plan (y quitar lo que sobra)

Cuando Claude termina, te enseña el plan y te pregunta qué hacer. Las opciones son:

• Yes, and use auto mode (o Yes, auto-accept edits si no tienes el modo automático): aprueba y Claude se pone a construir sin pedirte permiso en cada cambio.
• Yes, manually approve edits: aprueba, pero te enseña cada cambio para que digas sí o no.
• No, keep planning: sigue en plan mode y le dices qué cambiar.

Antes de aprobar, léelo con estas cuatro preguntas:

1. ¿Hace lo que pedí y nada más? Si ves un tobogán que no pediste (una pantalla extra, una librería nueva, «ya que estamos, rehago esto»), quítalo.
2. ¿Qué archivos toca? Si toca algo que no esperabas, pregunta por qué.
3. ¿Está en un orden lógico? Primero lo que sostiene la casa, luego lo demás.
4. ¿Dice cómo se comprueba? Si no lo dice, pídelo.

Para recortar, elige No, keep planning y escribe algo como: «Quita el paso 4 y no instales librerías nuevas». O pulsa Ctrl+G: el plan se abre en tu editor de texto y lo cambias tú directamente.

El prompt para que construya comprobando cada paso

Pega esto con plan mode activado, cambiando lo que va entre corchetes:

Quiero hacer este cambio: [describe el cambio grande, por ejemplo: añadir registro de usuarios con email]. Antes de proponer nada, lee el proyecto y el CLAUDE.md si existe, y dime en dos líneas cómo está hecho ahora lo que vamos a tocar. Después dame un plan con pasos numerados. Para cada paso: qué vas a hacer, qué archivos tocas y cómo comprobarás que funciona (un comando, una prueba o qué mirar en el navegador). Reglas: haz solo lo que te pido, sin extras; no instales librerías nuevas sin decírmelo; si algo no está claro, pregúntame en vez de suponer. Cuando apruebe el plan, construye un paso cada vez: termina el paso, compruébalo, dime si ha funcionado y solo entonces pasa al siguiente. Si una comprobación falla, para y explícame qué ha pasado antes de seguir.

¿Por qué funciona? Porque obliga a Claude a tres cosas que evitan la obra de 5.000 €: mirar antes de tocar, no meter extras y comprobar cada paso antes de apilar el siguiente encima.

Resumen

• Shift+Tab hasta ver ⏸ plan mode on.
• Cambio pequeño: pide. Cambio grande: primero el plan.
• Recorta antes de aprobar: «No, keep planning» o Ctrl+G.
• Aprueba y que construya comprobando cada paso.

Fuentes: modos de permisos y plan mode y flujos habituales de Claude Code, documentación oficial de Claude Code.