Plan Mode de Claude Code
El modo que convierte a Claude en un arquitecto — investiga tu código, lee tus archivos y diseña un plan antes de tocar una sola línea.
Qué vas a aprender
- Qué es Plan Mode y por qué existe — la analogía más simple para entenderlo.
- Cómo activarlo — tres formas distintas según tu flujo de trabajo.
- Qué puede y qué no puede hacer — sus límites claros para que no te sorprendas.
- Cuándo usarlo — los 4 escenarios donde Plan Mode brilla.
- Un ejemplo práctico paso a paso — para que lo veas en acción.
01 concepto
¿Qué es Plan Mode?
Plan Mode es el modo arquitecto de Claude Code. Cuando lo activas, Claude puede leer archivos, buscar código, explorar tu proyecto y pensar — pero no puede editar, crear ni borrar nada.
Piénsalo así: si vas a remodelar tu casa, no empiezas tirando paredes. Primero llamas a un arquitecto que recorre cada cuarto, revisa la estructura, toma medidas y dibuja un plano antes de que nadie toque un martillo.
Plan Mode es ese arquitecto. Claude camina por tu código, entiende cómo funciona todo y te entrega un plan claro de qué hacer. Solo cuando tú apruebas el plan, cambias a modo normal y Claude ejecuta.
¿Por qué esto importa?
Sin Plan Mode, Claude empieza a editar archivos de inmediato. A veces eso está bien — para bugs pequeños o cambios simples. Pero para tareas grandes, quieres que Claude primero entienda el panorama completo antes de tocar tu código. Plan Mode te da esa garantía.
02 activación
Cómo activar Plan Mode
Hay tres formas de activar Plan Mode, dependiendo de cómo trabajes:
Opción 1 — Shift+Tab (dentro de la sesión)
Shift+Tab para alternar entre Plan Mode y Auto ModeOpción 2 — Iniciar en Plan Mode desde la terminal
claude --permission-mode planOpción 3 — One-shot con -p (sin sesión interactiva)
claude -p "analiza la arquitectura de este proyecto y sugiere mejoras"La más fácil: Shift+Tab
Si ya estás en una sesión de Claude Code, solo presiona Shift+Tab para cambiar a Plan Mode. Presiona de nuevo para volver a Auto Mode. Así de simple.
03 capacidades
¿Qué puede y qué no puede hacer?
Puede
- Leer cualquier archivo de tu proyecto
- Buscar código, funciones, patrones
- Explorar la estructura de carpetas
- Investigar en la web (docs, APIs, referencias)
- Pensar y diseñar un plan detallado
No puede
- Editar archivos existentes
- Crear archivos nuevos
- Borrar archivos o carpetas
- Ejecutar comandos que modifiquen estado
- Hacer commits o pushes a git
En resumen: Plan Mode es solo lectura. Claude puede ver todo pero no puede cambiar nada. Esto te da la confianza de dejarlo investigar libremente sin riesgo de que modifique algo por accidente.
04 casos de uso
Cuándo usar Plan Mode
Features que tocan muchos archivos
Cuando una feature nueva afecta 5, 10 o 20 archivos, quieres un mapa completo antes de empezar. Plan Mode investiga todas las dependencias y te dice exactamente qué archivos tocar y en qué orden.
Refactoring complejo
Renombrar un sistema, cambiar la arquitectura de datos o migrar de una librería a otra. Plan Mode identifica todos los puntos de impacto antes de que muevas una sola línea.
Explorar código desconocido
Acabas de entrar a un proyecto nuevo o a un módulo que no conoces. Plan Mode te da un tour guiado — lee los archivos, entiende las conexiones y te explica cómo funciona todo.
Antes de cambios grandes o riesgosos
Cambios en la base de datos, en la autenticación, o en la lógica de pagos. Plan Mode te asegura que entiendes todas las consecuencias antes de ejecutar.
05 mejores prácticas
Mejores prácticas
Sé específico con tu objetivo
No digas "analiza mi proyecto". Di "necesito agregar autenticación con Clerk — investiga qué archivos tengo que tocar y en qué orden".
Deja que Claude termine de investigar
No lo interrumpas a media exploración. Plan Mode es más útil cuando Claude puede ver el panorama completo antes de darte su plan.
Revisa el plan antes de ejecutar
Lee el plan que Claude te entrega. Si algo no tiene sentido o falta algo, pídele que lo ajuste — todavía estás en modo seguro.
Combínalo con Auto Mode
El flujo ideal: Plan Mode para investigar → revisar el plan → Shift+Tab a Auto Mode → Claude ejecuta el plan que diseñó.
El flujo ideal
1. Activa Plan Mode (Shift+Tab) → 2. Describe lo que necesitas → 3. Claude investiga y te entrega un plan → 4. Revisas y ajustas → 5. Cambias a Auto Mode (Shift+Tab) → 6. Claude ejecuta el plan.
Este ciclo de planear-revisar-ejecutar es la forma más segura y efectiva de trabajar con Claude Code en tareas complejas.
06 ejemplo
Ejemplo práctico
Imagina que quieres agregar un sistema de notificaciones por email a tu app. En vez de decirle a Claude "agrégame notificaciones" y que empiece a crear archivos por todos lados, usas Plan Mode:
Paso 1 — Activas Plan Mode
Activar Plan Mode
Shift+Tab (o claude --permission-mode plan)Paso 2 — Le describes tu objetivo
Prompt de planificación
Le pides a Claude que investigue antes de actuar.
Necesito agregar notificaciones por email a mi app. Investiga mi proyecto y dime: 1. Qué sistema de email me conviene (Resend, SendGrid, etc.) según mi stack actual 2. Qué archivos necesito crear y cuáles modificar 3. El orden exacto de implementación 4. Si hay algo en mi código actual que deba cambiar primero No hagas cambios todavía — solo dame el plan.
Paso 3 — Claude investiga
Claude lee tu package.json, explora tu estructura de carpetas, revisa tus rutas API, tu configuración de entorno y cualquier código relacionado con usuarios. Todo sin modificar nada.
Paso 4 — Recibes un plan claro
Claude te entrega un plan paso a paso: qué librería usar, qué archivos crear, qué archivos modificar, en qué orden y por qué. Tú revisas, ajustas lo que necesites y cuando estés listo...
Paso 5 — Ejecutas
Cambiar a Auto Mode
Shift+Tab → Claude ejecuta el plan que diseñóAhora Claude tiene contexto completo de tu proyecto y un plan aprobado. La ejecución es más rápida, más precisa y con menos errores que si hubiera empezado a codear de inmediato.
La regla de oro
Si la tarea toca más de 3 archivos o no estás seguro de cómo implementarla, empieza en Plan Mode. Los 30 segundos que inviertes en planear te ahorran minutos de revertir cambios incorrectos.