Modo Plan
- Explicar qué hace el Modo Plan y por qué es de solo lectura
- Decidir cuándo planificar primero y cuándo puedes saltártelo
- Recorrer el ciclo investigar-proponer-aprobar-ejecutar
- Distinguir el Modo Plan de los Permisos y usarlos juntos
La idea principal
Imagina darle a un contratista las llaves de tu casa frente a pedirle primero que la recorra y anote qué cambiaría. El Modo Plan es ese recorrido.
El Modo Plan pone a Claude Code en solo lectura: puede explorar tu base de código, ejecutar búsquedas y razonar, pero no editará archivos ni ejecutará comandos que cambien el estado. En su lugar, produce un plan y espera tu aprobación.
- Solo lectura significa que Claude PIENSA pero no ACTÚA: sin ediciones de archivos, sin comandos que cambien el estado, hasta que tú des la orden.
Por qué es la forma más segura de empezar
Para cualquier cosa grande, arriesgada o desconocida, quieres ver qué pretende hacer Claude antes de que toque tu repositorio. El Modo Plan separa el pensar del hacer:
La recompensa: detectas suposiciones equivocadas antes de que se conviertan en código equivocado.
Cuándo usarlo
- SIEMPRE para cambios grandes o multiarchivo, migraciones o refactorizaciones
- Cuando trabajas en una base de código que aún no conoces del todo
- Cuando quieres un plan revisable para compartir con un compañero de equipo
Para ediciones pequeñas y obvias puedes saltártelo, pero en caso de duda, planifica primero.
Cómo funciona en la práctica
Sigue el ciclo. Cada paso habilita el siguiente: Claude solo pasa a editar después de que apruebes.
- Cambia al modo de solo lectura y luego describe lo que quieres lograr.
- Lee los archivos relevantes y hace preguntas aclaratorias.
- Archivos a cambiar, el enfoque y cómo verificar el resultado.
- Solo después de la aprobación Claude pasa a hacer cambios.
Pruébalo tú mismo
Copia esto en una sesión de planificación real y observa cómo se desarrolla el ciclo:
Inicia una sesión de planificación
I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.
:::tip Combínalo con CLAUDE.md Un buen CLAUDE.md hace que los planes sean más precisos: Claude planifica teniendo ya en cuenta tus convenciones y salvaguardas. :::
Modo Plan frente a Permisos
Una confusión clásica. Resuelven problemas distintos y funcionan juntos:
- Modo Plan = "investiga y propón, no actúes todavía." (Esta página.)
- Permisos = una vez actuando, qué acciones están permitidas sin preguntar.
Piénsalo como si actuar ahora (Modo Plan) frente a qué acciones están permitidas una vez actuando (Permisos).
- El Modo Plan es de solo lectura: Claude explora y propone pero nunca edita ni ejecuta comandos que cambien el estado hasta que apruebes
- Úsalo por defecto para trabajo grande, arriesgado o desconocido; sáltatelo solo para ediciones pequeñas y obvias
- El ciclo es investigar, proponer, aprobar/refinar, ejecutar
- El Modo Plan gobierna SI actuar ahora; los Permisos gobiernan QUÉ acciones están permitidas una vez actuando
Ponte a prueba
0/4Siguiente
- Permisos y modos de permiso
- Gestión del contexto — mantén efectivas las sesiones largas
- Tutorial: Personaliza Claude Code para un repo real