Claude Code Plan Mode: qué es, cómo usarlo y cuándo activarlo
Plan Mode permite que Claude Code investigue un proyecto, lea archivos, explore dependencias y diseñe una solución antes de modificar el código fuente. Es especialmente útil para refactorizaciones, nuevas funcionalidades, bugs complejos y cualquier cambio cuyo impacto todavía no tengas completamente claro.
¿Qué es Plan Mode en Claude Code?
Plan Mode es un modo de permisos
de Claude Code diseñado para investigar
y preparar cambios antes de implementarlos.
Claude puede leer archivos,
buscar código y ejecutar operaciones
de exploración, pero normalmente
mantiene bloqueadas las ediciones
del código fuente hasta que apruebas
el plan. Puedes activarlo con
Shift + Tab,
iniciar directamente con
claude --permission-mode plan
o anteponer /plan
a una solicitud concreta.
Planificar antes de programar reduce errores
Permitir que Claude empiece a escribir inmediatamente puede resolver bien el problema equivocado.
Entender primero
Claude puede localizar archivos, dependencias y patrones existentes antes de decidir.
Medir impacto
Permite identificar cuántos componentes podrían verse afectados por el cambio.
Diseñar la solución
Claude propone una estrategia antes de escribir el código.
Revisar antes
Tú puedes corregir el enfoque antes de invertir tiempo implementándolo.
Reducir cambios innecesarios
Ayuda a evitar refactors, archivos o dependencias que no eran necesarios.
Definir verificación
El plan puede incluir cómo comprobar que la implementación realmente funciona.
Explore → Plan → Implement → Verify
Anthropic recomienda separar investigación, planificación e implementación cuando la tarea no es trivial.
Investiga
Comprende arquitectura, archivos, dependencias, restricciones y comportamiento actual.
Diseña
Define qué cambiar, por qué, en qué orden y cómo verificarlo.
Programa
Aprueba el plan, permite los cambios y valida el resultado con tests o build.
Qué puede hacer Claude durante Plan Mode
Plan Mode no significa que Claude se quede sin herramientas.
Leer archivos
Puede inspeccionar el código dentro del área de trabajo.
Buscar código
Puede localizar funciones, clases, referencias y patrones.
Explorar con comandos
Puede utilizar comandos de shell permitidos para investigar.
Consultar historial
Puede investigar commits, diffs y evolución del código.
Relacionar componentes
Puede analizar cómo interactúan diferentes partes del sistema.
Crear una estrategia
Finalmente entrega un plan para que lo revises antes de implementar.
Plan Mode bloquea las ediciones del código fuente
Esa es precisamente la característica que diferencia este modo.
Claude investiga sin aplicar todavía la solución
Durante el flujo normal de Plan Mode, Claude puede explorar el proyecto y preparar un plan, pero las ediciones permanecen bloqueadas hasta que tú apruebas continuar.
No equivale simplemente a escribir “no modifiques nada” en el prompt. Claude Code aplica restricciones a las herramientas disponibles durante la fase de planificación.
Cómo activar Claude Code Plan Mode
Puedes entrar a Plan Mode de varias maneras dependiendo de tu flujo.
Iniciar directamente en Plan Mode
claude --permission-mode planLa sesión comenzará directamente preparada para investigar sin realizar ediciones hasta la aprobación.
Activar Plan Mode durante una sesión
No necesitas cerrar Claude Code para cambiar de modo.
Cambiar el modo de permisos
Pulsa
Shift + Tab
hasta que
la barra de estado
muestre:
⏸ plan mode on
En determinados entornos
de Windows,
Alt + M
puede utilizarse
como alternativa
para recorrer
los modos de permisos.
Utilizar /plan sin cambiar toda la sesión
También puedes activar Plan Mode únicamente para una solicitud.
Prefijar un prompt
/plan Investiga cómo agregar autenticación con Google
a este proyecto sin modificar código todavía.
Puedes seguir
trabajando normalmente
y utilizar
/plan
únicamente
cuando una tarea
requiere investigación previa.
Plan Mode dentro de los modos de Claude Code
| Modo | Qué permite | Ideal para |
|---|---|---|
| Manual | Lectura; pregunta antes de muchas acciones | Revisar cada acción |
| Accept Edits | Lectura + ediciones dentro del workspace | Iteración rápida |
| Plan | Exploración sin editar código fuente | Diseñar antes de cambiar |
| Auto | Mayor autonomía con controles en segundo plano | Tareas largas |
| Don’t Ask | Solo herramientas preaprobadas | CI y automatización restringida |
| Bypass Permissions | Omite la mayoría de prompts | Entornos aislados |
Cuándo conviene usar Plan Mode
Proyecto desconocido: todavía no sabes dónde está implementada la funcionalidad.
Cambio en varios archivos: necesitas entender dependencias antes de modificar.
Refactor importante: quieres conservar comportamiento mientras cambia la estructura interna.
Nueva funcionalidad: hay varias formas razonables de implementarla.
Bug complejo: todavía no conoces la causa real del problema.
Migración: necesitas identificar todos los puntos que dependen de una tecnología.
Seguridad: el cambio afecta autenticación, permisos o datos sensibles.
Arquitectura: una decisión incorrecta podría extenderse por gran parte del proyecto.
Cuándo no necesitas Plan Mode
Planificar también tiene un coste de tiempo y contexto.
Corregir un typo
Si el cambio es completamente evidente, planificar aporta poco valor.
Cambiar una línea
Una modificación claramente aislada puede realizarse directamente.
Añadir un log
Si conoces exactamente la ubicación y el resultado esperado, el plan puede ser excesivo.
Si puedes describir el diff completo en una sola frase y sabes exactamente dónde aplicarlo, probablemente puedes saltarte Plan Mode.
Cómo pedir una buena investigación en Plan Mode
No pidas simplemente “haz un plan”. Primero define qué debe investigar.
Investiga cómo funciona actualmente
la autenticación de este proyecto.
Analiza:
- login
- registro
- sesiones
- recuperación de contraseña
- middleware de autenticación
- modelos de usuario
- tests relacionados
- variables de entorno
No propongas todavía la implementación.
Primero explícame el flujo actual
y los archivos involucrados.Después de investigar, pide el plan
Quiero agregar inicio de sesión con Google.
Basándote en la arquitectura que investigaste,
crea un plan detallado.
Incluye:
1. archivos que deben cambiar
2. archivos nuevos
3. cambios de base de datos si son necesarios
4. flujo de autenticación
5. manejo de errores
6. seguridad
7. tests
8. riesgos
9. cómo verificar la implementación
Todavía no implementes nada.Qué debería contener un buen plan
Objetivo: qué comportamiento debe cambiar.
Archivos: cuáles serán modificados o creados.
Orden: qué debe hacerse primero y qué depende de ello.
Patrones existentes: qué implementación actual debe seguirse.
Riesgos: compatibilidad, seguridad y regresiones posibles.
Testing: qué pruebas deben añadirse o ejecutarse.
Validación: cómo sabremos que el resultado funciona.
Editar directamente el plan con Ctrl + G
No tienes que aceptar el plan exactamente como Claude lo escribió.
Abrir el plan en tu editor
Cuando Claude
presenta un plan,
puedes pulsar
Ctrl + G
para abrirlo
en tu editor
de texto
y modificarlo
directamente.
Puedes eliminar pasos, cambiar nombres, añadir restricciones o reorganizar la estrategia antes de implementar.
Qué ocurre cuando Claude termina el plan
Claude Code no comienza necesariamente a modificar archivos inmediatamente.
Comenzar implementación
Puedes aceptar el plan y cambiar a un modo que permita editar.
Aprobar ediciones individualmente
Puedes permitir la implementación manteniendo revisión sobre los cambios.
Seguir planificando
Puedes mantener Plan Mode y explicar qué debe cambiar en la propuesta.
No aceptes un plan incompleto
Plan Mode es especialmente valioso porque puedes corregir la estrategia antes de modificar el repositorio.
No implementes todavía.
Modifica el plan:
- no quiero añadir una tabla nueva
- reutiliza la tabla users existente
- mantén compatibilidad con login tradicional
- añade rollback
- incluye tests para usuarios ya registrados
- evita nuevas dependencias si es posible
Devuélveme el plan corregido.Cómo salir de Plan Mode
Existen dos caminos: aprobar el plan o cambiar manualmente de modo.
Cambiar sin aprobar el plan
Puedes pulsar
nuevamente
Shift + Tab
para abandonar
Plan Mode
sin aprobar
la propuesta actual.
Cuando aceptas un plan, Claude Code abandona Plan Mode y pasa al modo de permisos correspondiente a la opción que seleccionaste.
Prompt para implementar después del plan
Implementa el plan aprobado.
Sigue exactamente el alcance definido.
Durante la implementación:
- reutiliza los patrones existentes
- evita refactors no relacionados
- añade los tests descritos
- ejecuta la suite relevante
- ejecuta lint
- corrige los fallos introducidos
Al terminar:
1. resume los archivos modificados
2. muestra los tests ejecutados
3. indica cualquier riesgo pendienteEl plan debería incluir cómo demostrar que funciona
Un buen plan no termina en “modificar estos archivos”.
Pruebas automatizadas
Define qué tests existentes o nuevos deben ejecutarse.
Compilación
Comprueba que el proyecto siga construyéndose correctamente.
Prueba funcional
Describe cómo verificar el comportamiento desde la aplicación.
Combinar Plan Mode con subagentes
Los proyectos grandes pueden necesitar investigar muchas áreas antes de crear un buen plan.
Delegar exploraciones grandes
Puedes pedir que un subagente investigue una parte concreta y devuelva únicamente sus conclusiones.
Usa un subagente para investigar
cómo funciona el módulo de pagos.
Necesito conocer:
- flujo completo
- archivos relevantes
- integraciones externas
- tablas utilizadas
- tests existentes
- riesgos
No modifiques código.Plan Mode también consume contexto
Investigar cientos de archivos directamente en la conversación principal puede llenar la ventana de contexto.
Pide investigar primero áreas concretas.
Utiliza subagentes para exploraciones muy amplias.
Da referencias de archivos cuando conozcas el punto de partida.
Evita pedir “lee todo el repositorio” sin una razón.
Hacer que Claude Code siempre inicie en Plan Mode
Puedes establecer Plan Mode como modo inicial para sesiones de terminal.
Configurar el proyecto
{
"permissions": {
"defaultMode": "plan"
}
}
Puedes guardar
esta configuración
en
.claude/settings.json
para que las sesiones
iniciadas desde terminal
en ese proyecto
comiencen en Plan Mode.
Usar Plan Mode por defecto en todos tus proyectos
Configuración de usuario
{
"permissions": {
"defaultMode": "plan"
}
}Si trabajas habitualmente con cambios pequeños, probablemente sea mejor activar Plan Mode únicamente cuando lo necesites.
Plan Mode en Visual Studio Code
La extensión oficial dispone de su propio selector de modos.
Selecciona Plan en el cuadro de conversación
Pulsa el indicador de modo situado junto al área de prompt y selecciona Plan.
La extensión
de VS Code
no utiliza
el
.claude/settings.json
del proyecto
para decidir
el modo inicial
de una nueva conversación.
Iniciar nuevas conversaciones de VS Code en Plan Mode
Configurar Plan como modo inicial
{
"claudeCode.initialPermissionMode": "plan"
}Esta opción controla las conversaciones iniciadas directamente desde la extensión.
Ejemplo de Plan Mode para WordPress
Plan Mode resulta especialmente útil cuando un plugin o theme ya tiene lógica funcionando en producción.
Quiero añadir inicio de sesión con Google
a este plugin de WordPress.
Antes de modificar nada:
1. analiza la estructura completa del plugin
2. identifica cómo se crean usuarios actualmente
3. revisa los hooks de autenticación
4. revisa roles y capabilities
5. revisa WooCommerce My Account
6. identifica tablas o user meta utilizados
7. revisa nonces y seguridad
8. comprueba cómo evitar usuarios duplicados
Después crea un plan de implementación.
Restricciones:
- no modificar WordPress core
- no romper login tradicional
- reutilizar usuarios existentes por email
- mantener compatibilidad con WooCommerce
- minimizar dependencias nuevas
- utilizar APIs de WordPress siempre que sea posible
No implementes todavía.Usar Plan Mode para investigar un bug
Tenemos este problema:
Los usuarios dejan de poder iniciar sesión
después de que expira su sesión.
Investiga el problema.
Necesito:
- flujo completo de login
- manejo de sesiones
- refresh tokens
- middleware involucrado
- posibles causas
- tests existentes
- forma de reproducir el bug
No corrijas nada todavía.
Cuando encuentres la causa,
crea un plan mínimo para corregirla
sin realizar refactors no relacionados.Plan Mode antes de una refactorización
Define qué comportamiento no puede cambiar
Una refactorización debería cambiar la implementación interna, no el resultado visible para usuarios o consumidores de la API.
Analiza cómo dividir UserService
en componentes más pequeños.
Restricciones:
- no cambiar APIs públicas
- mantener comportamiento actual
- no cambiar schema de base de datos
- mantener compatibilidad hacia atrás
- conservar todos los tests actuales
Primero identifica responsabilidades
y dependencias.
Después crea un plan incremental
que pueda implementarse y probarse
en pasos pequeños.Plan Mode no sustituye otros controles de seguridad
Es una herramienta de supervisión y planificación, pero forma parte de un sistema más amplio.
| Necesidad | Herramienta |
|---|---|
| Investigar sin editar | Plan Mode |
| Bloquear comandos | Permissions |
| Limitar filesystem/red | Sandbox |
| Ejecutar validaciones automáticas | Hooks |
| Reglas de programación | CLAUDE.md |
Errores al utilizar Plan Mode
Planificar sin investigar: el plan termina basado en supuestos y no en el codebase real.
Aceptar el primer plan: revisa alcance, riesgos y archivos afectados.
No definir restricciones: Claude puede proponer una arquitectura técnicamente correcta pero incompatible con tus necesidades.
Plan demasiado amplio: divide cambios grandes en etapas verificables.
No incluir testing: el plan debe explicar cómo comprobar la solución.
Plan Mode para todo: tareas triviales no necesitan una fase formal de planificación.
Flujo recomendado con Plan Mode
Activa Plan Mode
Utiliza Shift + Tab, /plan o el flag de terminal.
Describe el objetivo
Explica qué necesitas lograr, no solo qué archivo cambiar.
Investiga
Deja que Claude entienda el sistema actual.
Define restricciones
Compatibilidad, arquitectura, seguridad y alcance.
Revisa el plan
Corrige cualquier decisión antes de aprobar.
Implementa
Aprueba solo cuando el enfoque sea correcto.
Verifica
Tests, lint, build y revisión del diff.
Documentación oficial de Plan Mode
Los modos y permisos de Claude Code continúan evolucionando, por lo que conviene revisar la documentación oficial para funciones avanzadas.
Permission Modes
Plan Mode, Manual, Auto, Accept Edits y otros modos.
Ver modos oficiales →Best Practices
Flujo Explore, Plan, Implement y Verify.
Ver buenas prácticas →Common Workflows
Planificación, debugging, testing y trabajo con codebases.
Ver workflows →Guías relacionadas
Continúa con Skills, subagentes, MCP, Hooks y automatización avanzada.
FAQ sobre Claude Code Plan Mode
Respuestas sobre activación, permisos, planificación, VS Code e implementación.
Plan Mode es un modo de permisos que permite a Claude investigar un proyecto y proponer cambios antes de editar el código fuente.
En la CLI
puedes pulsar
Shift + Tab
hasta ver
plan mode on,
utilizar
/plan
para una solicitud
o iniciar con
claude --permission-mode plan.
Durante el flujo normal de Plan Mode, Claude investiga y prepara el plan sin editar el código fuente. Las ediciones permanecen bloqueadas hasta que apruebas continuar.
Sí. Puede ejecutar comandos utilizados para investigar el proyecto. Los comandos están sujetos al sistema de permisos y controles activos en la sesión.
Cuando Claude presenta
un plan,
puedes pulsar
Ctrl + G
para abrirlo
en tu editor
y modificarlo
antes de continuar.
Puedes aprobar
el plan
y comenzar
la implementación,
o pulsar
Shift + Tab
para cambiar
manualmente
de modo.
Resulta especialmente útil cuando no conoces completamente el codebase, el cambio afecta varios archivos, existen varias soluciones posibles o necesitas evaluar riesgos antes de implementar.
No. Para cambios simples y evidentes, como corregir un typo o modificar una línea aislada, la planificación puede añadir más trabajo del necesario.
Sí. La extensión oficial de Claude Code para VS Code dispone de un selector de modo donde puedes elegir Plan.
Sí.
Para sesiones
de terminal
puedes establecer
permissions.defaultMode
como
plan.
En VS Code
puedes utilizar
claudeCode.initialPermissionMode.
Crea capacidades reutilizables con Claude Code Skills
Ya sabes cómo hacer que Claude investigue y diseñe una solución antes de modificar código. El siguiente paso es aprender a convertir procedimientos repetitivos en Skills reutilizables que Claude pueda cargar cuando los necesite.
Claude Code Skills →