Saltar al contenido principal

Plan Mode

Principiante
What you'll learn
  • Explicar qué bloquea el Plan Mode — y qué sigue permitiendo que Claude ejecute
  • Entrar y salir del Plan Mode de tres formas distintas
  • Recorrer el ciclo investigar-proponer-aprobar-ejecutar
  • Distinguir el Plan Mode 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 Plan Mode es ese recorrido.

El Plan Mode le indica a Claude que investigue y proponga cambios sin realizarlos: lee archivos, ejecuta comandos de shell para explorar y escribe un plan — pero no edita tu código fuente. Las ediciones quedan bloqueadas hasta que apruebes el plan.

Pro tip
  • El Plan Mode significa que Claude INVESTIGA pero no CAMBIA tu código fuente — produce un plan y espera tu señal.

No es estrictamente de solo lectura​

Explorar a veces requiere un comando, así que el Plan Mode trata de no editar, no de no ejecutar. Lo que ocurre con un comando de shell durante la planificación depende de la sesión — gana el primer caso que coincida:

Guided walkthrough1 of 3
  1. Los bloqueos del Plan Mode NO se aplican. Claude sigue recibiendo la instrucción de planificar sin editar, pero cualquier edición o comando que intente durante la planificación se ejecuta sin preguntar. El Plan Mode mantiene sus bloqueos en todos los demás contextos — ejecuciones headless con -p, el Agent SDK y el panel de chat de la extensión de VS Code.
Watch out
  • Si arrancaste con --allow-dangerously-skip-permissions, el Plan Mode es una instrucción firme más que una salvaguarda estricta. Trátalo como una convención de planificación, no como un sandbox.

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 Plan Mode separa el pensar del hacer:

La recompensa: detectas suposiciones equivocadas antes de que se conviertan en código equivocado.

Cuándo usarlo​

Pro tip
  • 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.

Guided walkthrough1 of 4
  1. Pulsa Shift+Tab para recorrer los modos de permiso hasta que la barra de estado muestre 'plan mode on', o prefija un único prompt con /plan. Para empezar ya ahí, arranca con claude --permission-mode plan. Luego describe lo que quieres lograr.

Para salir del Plan Mode sin aprobar un plan, pulsa Shift+Tab otra vez. Para convertirlo en el modo por defecto de las sesiones de terminal de un proyecto, pon defaultMode en plan dentro de .claude/settings.json — consulta Ajustes.

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.
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.

Plan Mode frente a Permisos​

Una confusión clásica. Resuelven problemas distintos y funcionan juntos:

  • Plan Mode = "investiga y propón, no edites todavía." (Esta página.)
  • Permisos = una vez actuando, qué acciones están permitidas sin preguntar.

Piénsalo como si actuar ahora (Plan Mode) frente a qué acciones están permitidas una vez actuando (Permisos).

Pulsa Intro o Espacio para girar la tarjeta. Usa las flechas izquierda y derecha para moverte entre las tarjetas.Término mostrado.
1 / 5
Key takeaways
  • El Plan Mode es investigar y proponer: Claude lee y ejecuta comandos exploratorios, pero no edita tu código fuente hasta que apruebes el plan
  • No es estrictamente de solo lectura — los comandos durante la planificación los revisa el clasificador, te los pregunta, o (con bypass permissions disponible en una terminal interactiva) quedan totalmente desbloqueados
  • Entra con Shift+Tab, con el prefijo /plan o con --permission-mode plan; aprobar cambia la sesión al modo que nombra esa opción de aprobación
  • Úsalo por defecto para trabajo grande, arriesgado o desconocido; sáltatelo solo para ediciones pequeñas y obvias
  • El Plan Mode gobierna SI actuar ahora; los Permisos gobiernan QUÉ acciones están permitidas una vez actuando

Ponte a prueba

0/4
  1. ¿Qué puede hacer Claude Code mientras está en Plan Mode?
  2. ¿Cuándo deberías recurrir al Plan Mode?
  3. ¿Cuál es el orden correcto del ciclo del Plan Mode?
  4. ¿En qué se diferencian el Plan Mode y los Permisos?

Siguiente​