Plan mode de Claude Code: cómo funciona y cuándo usarlo

Plan mode frente a auto mode, accept edits y manual

El modo plan es uno de los modos de permisos de Claude Code. Cada uno cambia comodidad por supervisión; la tabla muestra qué puede hacer Claude sin preguntarte en cada uno.

Cómo usar el plan mode en Claude Code

1. Entra en el modo plan

   En la terminal, pulsa Shift+Tab para recorrer los modos hasta que la barra de estado muestre ⏸ plan mode on; desde Manual, el ciclo pasa por accept edits y luego por plan. O empieza un solo prompt con /plan. En VS Code, haz clic en el indicador de modo bajo el cuadro del prompt y elige Plan; en la app de escritorio, usa el selector de modo.

   # Inicia una sesión en plan mode
   claude --permission-mode plan
   
   # O, dentro de una sesión, planifica solo este prompt
   /plan añade límites de peticiones a la API pública

2. Describe el cambio y deja que Claude explore

   Pide lo que quieres construir o arreglar. Claude lee el código y ejecuta comandos para investigar, y después escribe un plan. Cuando el auto mode (modo automático) está disponible, un clasificador revisa esos comandos en lugar de preguntarte; si no, todo lo que vaya más allá de los comandos de solo lectura integrados pide confirmación antes.

3. Revisa y edita el plan

   Responde a las preguntas de Claude, ponle pegas o pulsa Ctrl+G para abrir el plan en tu editor de texto y cambiarlo tú. Los planes se guardan como archivos en ~/.claude/plans/, o en la carpeta que indique el ajuste plansDirectory.

4. Aprueba o sigue planificando

   Elige Yes, and use auto mode (sí, y usar el modo automático), o Yes, auto-accept edits cuando el auto mode no está disponible, para que Claude lo implemente; Yes, manually approve edits para revisar cada edición; o No, keep planning para seguir planificando. Al aprobar se sale del modo plan y la sesión toma el nombre del plan.

5. Sal sin aprobar

   Pulsa Shift+Tab otra vez para salir del modo plan sin plan. Para planificar el siguiente cambio, vuelve a recorrer los modos o empieza el prompt con /plan.

Fuente: documentación de Claude Code, Choose a permission mode

Haz que el plan mode sea el modo por defecto

Para una sesión, inicia con claude --permission-mode plan. Para todas las sesiones de terminal de un proyecto, pon defaultMode en plan en .claude/settings.json; para todos los proyectos de tu máquina, ponlo en ~/.claude/settings.json.

1. Añádelo a los ajustes

   Las conversaciones de VS Code no leen los ajustes del proyecto para el modo inicial: en su lugar, pon claudeCode.initialPermissionMode en plan en tus ajustes de usuario de VS Code.

   {
     "permissions": {
       "defaultMode": "plan"
     }
   }

Cuándo merece la pena el plan mode

• Cambios que tocan muchos archivos, o en los que la primera idea suele fallar: una migración, un refactor, una funcionalidad nueva entre front end y back end.
• Código que aún no conoces: deja que Claude lo recorra y te explique el enfoque antes de que cambie nada.
• Errores caros: esquemas de base de datos, autenticación, pagos, APIs públicas.
• Sáltatelo en arreglos de una línea y en tareas que describirías igual que el plan; ahí los modos manual o accept edits son más rápidos.
• Combínalo con un contexto limpio: con showClearContextOnPlanAccept activado, al aprobar también puedes borrar la conversación de planificación para que la implementación parta solo del plan.

Trampas habituales

• El modo plan bloquea las ediciones, no todo: con el auto mode disponible, los comandos de shell aprobados se ejecutan durante la planificación, así que un comando con efectos secundarios puede ejecutarse igualmente.
• En una sesión interactiva de terminal iniciada con bypass permissions disponible, los bloqueos del modo plan no se aplican; a Claude solo se le indica que no edite.
• Las ejecuciones headless (claude -p), las sesiones del Agent SDK y el panel de chat de VS Code mantienen los bloqueos del modo plan.
• Elegir Plan en VS Code solo afecta a esa conversación; las nuevas vuelven a tu modo inicial habitual.
• Las reglas de denegación siguen aplicándose en todos los modos, plan incluido. Consulta comandos de barra de Claude Code para /plan, /permissions y otros comandos.

El plan mode hace que Claude vaya con cuidado. Crewmark hace que siga trabajando.

El modo plan es la forma de seguir al mando de un cambio grande; aun así, la sesión espera a que tú empieces el siguiente. Crewmark convierte una sesión de Claude Code, Codex, DeepSeek Harness u OpenCode en un empleado de IA con un rol, un objetivo y un horario, y la despierta con un heartbeat para que tome la siguiente issue de un tablero.

1. Planes como comentarios en la issue

   Un empleado puede publicar su plan en la issue y esperar tu visto bueno antes de un cambio arriesgado, así que apruebas desde el tablero en lugar de desde la terminal.

2. Deja que el heartbeat inicie el trabajo

   Durante su horario laboral el empleado se despierta cada 15, 30 o 60 minutos en la misma conversación y toma la siguiente issue; mira cómo hacer proactivo a Claude Code.

3. Varios empleados, un repositorio

   Da a cada uno su propio worktree y su rol. Lee qué es un empleado de IA.

Preguntas frecuentes sobre el plan mode de Claude Code