Workbranch › Guías

Cómo usar el modo plan en Claude Code

Dejar que Claude Code edite archivos directamente es rápido, hasta que se va por mal camino en diez archivos. El modo plan hace que primero investigue y te enseñe un plan, y en la mayoría de configuraciones no puede editar tus archivos hasta que lo apruebes. Así lo activas, revisas el plan y decides cuándo merece la pena.

Actualizado 30 de octubre de 2026

Las teclas y los nombres de las opciones de abajo se comprobaron con la documentación de Claude Code de Anthropic en octubre de 2026. El texto de las opciones puede cambiar entre versiones.

Qué hace el modo plan

El modo plan es uno de los modos de permisos de Claude Code. En él, Claude puede leer tus archivos y ejecutar comandos de shell para entender el código, y después escribe un plan para el cambio. Las ediciones de tu código quedan bloqueadas hasta que apruebes ese plan. Revisas el enfoque una vez, al principio, en lugar de juzgar edición tras edición.

Activa el modo plan

Hay cuatro formas, según la frecuencia con la que lo quieras.

• En plena sesión: pulsa Shift+Tab para recorrer los modos hasta que la barra de estado diga ⏸ plan mode on. Si vuelves a pulsarlo, sales del modo plan sin aprobar nada.
• Junto con una tarea: empieza el mensaje con /plan, por ejemplo /plan add rate limiting to the login endpoint.
• Al iniciar: ejecuta claude --permission-mode plan.
• Como modo por defecto del proyecto: en el .claude/settings.json del proyecto, define "defaultMode": "plan" dentro de "permissions". En la extensión de VS Code, define en cambio claudeCode.initialPermissionMode como plan en tu configuración de usuario, porque VS Code no lee el ajuste del proyecto para el modo inicial.

Revisa y aprueba el plan

1. Con el modo plan activo, describe la tarea y cómo sería un buen resultado. Menciona los archivos o las restricciones que ya conozcas.
2. Deja que Claude explore. Lee código y puede ejecutar comandos; según tu configuración, algunos comandos te piden aprobación.
3. Lee el plan que presenta. Comprueba qué archivos quiere cambiar, el orden de los pasos y cómo va a probar el resultado.
4. Para cambiar el plan tú mismo, pulsa Ctrl+G. El plan se abre en tu editor de texto predeterminado; guárdalo y Claude trabajará con tu versión.
5. Elige una opción:
   • Yes, and use auto mode (Sí, y usar el modo automático; aparece como Yes, auto-accept edits cuando el modo automático no está disponible): apruebas y dejas que Claude haga las ediciones sin preguntar cada vez.
   • Yes, manually approve edits (Sí, aprobar las ediciones manualmente): apruebas, pero revisas cada edición.
   • No, keep planning (No, seguir planificando): sigues en modo plan y le dices a Claude qué cambiar.

Al aprobar sales del modo plan y pasas al modo que elegiste, y Claude se pone a trabajar. Además, la sesión recibe un título generado si no le has puesto nombre. Si el ajuste showClearContextOnPlanAccept está activado, aparece una primera opción adicional que aprueba el plan y borra la conversación de planificación.

Cuándo usar el modo plan

• Cambios en varios archivos, como una refactorización o una función nueva, donde un enfoque equivocado cuesta mucho deshacer.
• Código que aún no conoces. Anthropic recomienda el modo plan para explorar una base de código antes de cambiarla.
• Trabajo en el que quieres opinar sobre el enfoque: ajusta el plan con Ctrl+G antes de que se toque ningún archivo.
• Normalmente no hace falta para arreglos pequeños y obvios, como una errata, donde revisar un plan lleva más tiempo que la propia edición.

Poner tus comandos de pruebas y tus convenciones en un archivo CLAUDE.md le da al plan mejor material con el que trabajar.

Conviene saber

• Claude Code viene con los planes Pro y Max, dentro de la misma suscripción que las apps de Claude; para los miembros de Team y Enterprise hay un artículo de ayuda aparte.
• Cómo se gestionan los comandos de shell mientras planifica depende de la sesión: si el modo automático está disponible, un clasificador los revisa por defecto; si no, los comandos que no pertenecen al conjunto de solo lectura integrado preguntan antes.
• Los archivos de plan se guardan en ~/.claude/plans/, salvo que plansDirectory apunte a otro sitio.
• Una excepción al bloqueo de ediciones: en una sesión interactiva de terminal donde está disponible el modo de omitir permisos (bypass permissions), a Claude se le sigue indicando que solo planifique, pero Claude Code no lo impone, así que una edición que intente mientras planifica puede ejecutarse sin preguntar. En las ejecuciones con -p, el Agent SDK y el panel de chat de VS Code, el bloqueo se aplica siempre.

Si no funciona

• Shift+Tab no llega al modo plan. Sigue pulsando: recorre todos los modos. Mira en la barra de estado si aparece ⏸ plan mode on.
• Claude empezó a editar después del plan. Es lo esperado cuando eliges una opción Yes. Elige No, keep planning si aún no estás listo.
• El modo por defecto del proyecto no se aplica en VS Code. Usa el ajuste de usuario claudeCode.initialPermissionMode.
• Ctrl+G abre un programa que no esperabas. El plan se abre en el editor de texto que tengas como predeterminado, así que cambia ese ajuste si quieres otro.

Guarda los puntos abiertos del plan

Un plan suele dejar decisiones y tareas de seguimiento que duran más que la sesión. Con el plugin de Workbranch para Claude Code, ejecuta /workbranch:save y Claude archiva las tareas, decisiones y preguntas abiertas de la sesión en un proyecto de Workbranch. Workbranch tiene una prueba gratuita de 3 días en app.workbranch.ai.

Fuentes

• Permission modes (Claude Code Docs, consultado el 30 de octubre de 2026)
• Common workflows (Claude Code Docs, consultado el 30 de octubre de 2026)
• Commands (Claude Code Docs, consultado el 30 de octubre de 2026)
• Use Claude Code with your Pro or Max plan (Centro de ayuda de Claude, consultado el 30 de octubre de 2026)

Preguntas frecuentes