Planificación de Proyectos con Claude Code: Plan Mode & ak plan (2026)

¿Por qué planificar antes de dejar que Claude Code escriba código?

El error más común con Claude Code es escribir un prompt y dejar que se ponga a codear de inmediato. Se siente rápido, pero el riesgo es real: la IA a menudo "resuelve el problema equivocado" - hace exactamente lo que cree que quieres, no lo que de verdad necesitas. Para cuando miras el diff, ya cambiaron una docena de archivos, y te quedas atrapada entre arreglarlo a mano o tirarlo todo y empezar de nuevo.

Planificar primero soluciona justo eso. Cuando obligas a Claude a plantear un plan antes de tocar cualquier código, puedes previsualizar el alcance del cambio, atrapar malentendidos mientras aún son baratos y mantener el trabajo dentro de sus límites. De regalo: ahorra tokens, porque editar una línea de un plan es mucho más barato que dejar que la IA escriba lo incorrecto y lo reescriba.

Hay un beneficio que casi nadie menciona: el plan es donde tú y la IA acuerdan la "definición de terminado". Cuando el plan detalla qué archivos van a cambiar y cómo verificarlos, tienes una referencia para contrastar el diff final - en lugar de leer el código y preguntarte "¿de verdad hizo lo que quise?". Dicho de otro modo, planificar convierte la revisión de una adivinanza en una comparación con checklist.

Cuándo SÍ deberías planificar: el cambio toca muchos archivos; no estás segura de cómo abordarlo; o trabajas en una base de código desconocida cuyo flujo aún no dominas. Cuándo saltártelo por velocidad: corregir un error de tipeo, cambiar una constante, ajustar una sola línea - si puedes describir el diff en exactamente una frase, planificar es solo sobrecarga extra. Si eres totalmente nueva en la herramienta, lee primero qué es Claude Code y cómo funciona y luego vuelve a las secciones de abajo.

Qué es el plan mode en Claude Code & cómo activarlo

El plan mode es un modo de permiso en Claude Code: cuando está activado, Claude solo lee archivos y propone un plan, sin escribir ningún cambio en disco hasta que apruebas. Piénsalo como un freno de seguridad que te deja ver qué pretende hacer la IA antes de permitírselo.

Hay tres formas de activarlo:

1. Pulsa Shift+Tab para ir alternando entre los modos: default → acceptEdits → plan. Sigue pulsando hasta quedarte en plan.
2. Arranca directamente en plan mode desde la terminal:

   claude --permission-mode plan

3. Confírmalo en la barra de estado - cuando el plan mode está activo, la barra de estado muestra ⏸ plan mode on.

Un truco poco conocido: en cuanto Claude produzca un plan, pulsa Ctrl+G para abrir ese plan en un editor de texto y editarlo a mano antes de ejecutarlo - agrega restricciones, quita pasos innecesarios o apunta a archivos concretos. Editar un plan siempre es más barato que editar código que ya se escribió.

El comportamiento de los atajos de arriba sigue la documentación oficial de Anthropic (best practices y common workflows, consultada el 2026-08-09). Como el plan mode evoluciona rápido, vuelve a comprobar los atajos en la versión de Claude Code que estés usando.

El bucle de planificación en 4 pasos: Explore → Plan → Implement → Commit

Este es el bucle que recomienda Anthropic, y es el más fácil de recordar. Cada paso tiene su propio objetivo - no los mezcles.

Explore (en plan mode)

Antes de discutir cualquier solución, deja que Claude lea y entienda el código existente. En plan mode solo lee, nunca edita, así que puedes dejarlo hurgar a sus anchas:

Read src/payments/ and src/orders/ to understand how the system handles payments today. No proposals yet - just summarize the flow.

Para proyectos grandes, pásale la investigación a un subagent para mantener limpio el contexto de la sesión principal - el subagent lee y devuelve un resumen, mientras que tu ventana de contexto principal no se llena de miles de líneas. El objetivo de este paso no es la solución; es lograr que Claude describa, con sus propias palabras, cómo funciona el sistema hoy. Si el resumen está mal, sabes de inmediato que no entendió el problema.

Plan

Una vez que Claude entienda el código, pídele un plan concreto:

I want to add discount codes to orders. Which files need to change? How does the flow work? Write a detailed plan before coding.

Lee el plan con atención. Si algo no encaja, pulsa Ctrl+G para editarlo a mano, o responde para que Claude lo revise. No te apures en aprobar.

Implement

Aprueba el plan (o pulsa Shift+Tab para salir del plan mode) para que Claude empiece a codear. El punto clave: ancla el plan con criterios de verificación - indica exactamente qué debe hacer la IA para demostrar que terminó:

Execute the plan. When finished, run npm test and make sure every test passes. If any test fails, fix it until it is green.

Commit

Por último, cierra todo en un commit limpio y abre un PR:

Commit the changes with a clear descriptive message, then open a pull request with a summary of what changed.

Consulta también nuestro flujo de trabajo con Git & creación de PRs con Claude Code para estandarizar este paso.

Divide un proyecto grande en fases & un roadmap

El bucle de 4 pasos de arriba funciona bien para una funcionalidad autocontenida. Pero un proyecto que corre durante días o semanas rompe un plan plano: el contexto se adelgaza, Claude olvida decisiones anteriores y pierdes el control.

El enfoque más duradero: pídele a Claude que construya un roadmap de varias fases, donde cada fase detalle su objetivo, los archivos que va a tocar y sus criterios de "terminado". Guarda el roadmap en un archivo (por ejemplo PLAN.md o una carpeta plans/) para que no desaparezca cuando ejecutes /clear. Luego ejecuta cada fase en su propia sesión, con un contexto limpio - corre /clear entre fases para que cada una arranque ligera, cargando solo la porción del roadmap que necesita.

El principio para dividir las fases: cada fase debe sostenerse por sí sola y terminar en estado verde (los tests pasan, la app corre) para que puedas parar en cualquier punto sin dejar código a medias. El orden de las fases debe ir de los cimientos hacia afuera - construye primero el backend/la lógica y la interfaz después - para que cada fase posterior tenga terreno firme sobre el cual construir.

Ejemplo de roadmap para una funcionalidad de "Iniciar sesión con Google (OAuth)":

Para funcionalidades complejas, usa el patrón interview → SPEC.md → nueva sesión: dile a Claude que "me entreviste una pregunta a la vez sobre los requisitos y luego lo escriba en SPEC.md", y después abre una sesión nueva que lea el SPEC y lo ejecute con un contexto limpio. Esta es la esencia del desarrollo guiado por especificación (escribe primero el SPEC.md), y encaja con el flujo brainstorm → plan → cook → ship que muchos devs en activo ya usan.

Consejos para planes de mayor calidad

• Ancla con criterios de verificación. Un buen plan siempre incluye cómo comprobarlo: qué tests deben pasar, que el build corra, que el screenshot coincida. También puedes fijar una condición con /goal para que la IA se evalúe después de cada paso en vez de declarar "terminado" cuando no lo está. Dicho de otro modo, unos criterios de aceptación claros hacen que /goal sea seguro de ejecutar.
• Escribe un CLAUDE.md. Registra las convenciones de tu proyecto (estructura de carpetas, reglas de nombres, comandos de test) en un archivo CLAUDE.md para que todo plan se mantenga en el contexto correcto sin que tengas que repetirlo cada vez.
• Sé específica en los prompts. Señala los archivos exactos, nombra un patrón de ejemplo a seguir e indica qué queda fuera del alcance. Cuanto más específica seas, más cerca cae el plan.
• Usa un subagent para revisar el plan. Haz que un subagent con contexto nuevo le eche un vistazo al plan o al diff - una perspectiva "limpia" suele atrapar huecos para los que la sesión principal ya se volvió ciega.
• Usa /rewind. Si una dirección de planificación no está funcionando, rebobina y prueba otro enfoque en lugar de ir parchando por encima.

Una comparación rápida lado a lado para ver la diferencia:

Prompt débil: "Agrega inicio de sesión con Google a la app."

Prompt fuerte: "Lee src/auth/ y src/routes/. Quiero agregar inicio de sesión con Google (OAuth) siguiendo exactamente el patrón de sesión que ya existe en src/auth/session.ts. Fuera del alcance: sin refresh token por ahora. Escribe un plan: qué archivos cambian, cómo funciona el flujo de callback y los criterios de verificación (auth.spec.ts pasa)."

ak plan - una skill de planificación lista para usar (AgentKit)

Una nota rápida para evitar confusiones: el AgentKit de aquí es un kit para Claude Code (agentkit.best, usando la CLI ak), que es completamente distinto de "OpenAI AgentKit".

Si te descubres "pidiendo un plan por prompt" cada vez que empiezas una funcionalidad, hay una skill que empaqueta ese proceso por ti: ak-plan. En lugar de escribir el prompt tú misma, llamas a la skill y genera un plan de varias fases con un roadmap en un marco consistente, con soporte para --html (un artifact autocontenido que puedes ver/compartir) y --wiki (publicar en AgentWiki). Esta skill vive en el Engineer Kit - un paquete de $99 (el sitio no indica cuota recurrente) con más de 60 skills y más de 30 workflows. Si quieres probarla ahora mismo, puedes activar la CLI ak (20% de descuento por el enlace) e instalar el kit desde ahí.

Siendo honesta: para la mayor parte del trabajo, el plan mode nativo ya alcanza, y es gratis - no necesitas un kit para planificar bien. El ak plan vale la pena cuando necesitas planes estandarizados, repetibles y documentados (artifact/wiki) para todo un equipo, no como requisito para empezar.

Errores comunes al planificar con IA

• Planificar algo demasiado pequeño. Encender el plan mode para cambiar una línea solo hace perder tiempo. Si puedes describir el diff en una frase, déjalo correr.
• Un plan largo sin ancla de verificación. Un plan de una docena de pasos suena impresionante, pero sin criterios de comprobación la IA fácilmente "parece terminada" mientras nada corre en realidad. Adjunta siempre condiciones de test/build/claras.
• Amontonar muchas tareas en una sesión. Hacer tres funcionalidades sin relación en la misma ventana de contexto confunde a la IA. Corre /clear entre tareas para mantener el contexto ligero.
• Confiar en el plan y saltarte el diff. Un plan correcto no garantiza código correcto. Igual tienes que leer el diff real antes de hacer commit.

Preguntas frecuentes (FAQ)

¿El plan mode cuesta más?

No. El plan mode es un modo integrado en Claude Code, no un complemento de pago. Lo usas dentro de tu plan actual (por ejemplo, Pro a $20/mes o Max 5x a $100/mes).

¿Qué tecla activa el plan mode?

Pulsa Shift+Tab para alternar default → acceptEdits → plan y párate en plan. O arranca con claude --permission-mode plan. La barra de estado mostrará ⏸ plan mode on.

¿El plan mode edita archivos por su cuenta?

No. En plan mode, Claude solo lee archivos y propone un plan; no escribe cambios en disco hasta que apruebas. Esa es la función de seguridad central del modo.

¿En qué se diferencia el plan mode del extended thinking (think/ultrathink)?

Son cosas distintas. El plan mode es un modo de permiso - controla si la IA tiene permitido editar archivos. El extended thinking (think/ultrathink) aumenta la profundidad de razonamiento del modelo. Puedes usar ambos juntos: activa el plan mode por seguridad y pide un razonamiento más profundo cuando el problema sea complejo.

¿Es obligatorio el ak plan, y en qué se diferencia del plan mode nativo?

No es obligatorio. El plan mode nativo alcanza para la mayoría de los casos y es gratis. El ak plan es una skill lista para usar (en el Engineer Kit de AgentKit) que genera planes estandarizados de varias fases con artifacts --html/--wiki - práctico cuando necesitas repetir el proceso y tener documentación para un equipo.

¿Cómo debería dividir un proyecto grande?

Pídele a Claude que construya un roadmap de varias fases (cada fase con objetivo, archivos tocados y criterios de terminado), guárdalo en PLAN.md, luego ejecuta cada fase en su propia sesión y corre /clear entre fases para mantener el contexto limpio.

Conclusión + próximos pasos

En resumen: no dejes que Claude Code codee de una - ve de Explore → Plan → Implement → Commit, activa el plan mode con Shift+Tab para previsualizar antes de aprobar, y divide los proyectos grandes en fases con un contexto limpio. Después, lee el flujo brainstorm → plan → cook → ship para un marco de trabajo completo, y el desarrollo guiado por especificación cuando necesites un plan riguroso para una funcionalidad grande.