Plan mode de Claude Code (2026): cómo activarlo, aprobar planes y cuándo usarlo

El plan mode (modo plan) es un modo de permisos de Claude Code en el que Claude investiga tu código y escribe un plan, pero no edita tus archivos fuente hasta que lo apruebas. Actívalo pulsando Shift+Tab hasta que la barra de estado muestre ⏸ plan mode on, empezando un prompt con el comando plan, o lanzando Claude Code con el modo de permisos configurado en plan. Cuando el plan está listo, lo apruebas, sigues planificando o pulsas Ctrl+G para editarlo tú antes de que Claude escriba código.

Comprobado con la documentación de Claude Code de Anthropic el 17 de octubre de 2026. Claude Code se actualiza a menudo, así que las etiquetas y los valores predeterminados pueden cambiar entre versiones. Si algo en tu pantalla se ve distinto, actualiza primero Claude Code (consulta cómo actualizar Claude Code).

Qué hace el plan mode

Cada sesión de Claude Code funciona en un modo de permisos que decide qué puede hacer Claude sin preguntarte. El plan mode es el pensado para pensar antes de actuar: Claude lee archivos, ejecuta comandos de shell para explorar y escribe un plan, pero no edita tu código fuente. Las ediciones siguen bloqueadas hasta que apruebas el plan. La guía de buenas prácticas de Anthropic lo plantea como separar la exploración de la ejecución, para que Claude no se lance directamente a escribir código que resuelve el problema equivocado.

Cómo se gestionan los comandos de exploración depende de tu sesión. Anthropic documenta tres casos, y se aplica el primero que coincida:

• Auto mode disponible y useAutoModeDuringPlan activado (el valor predeterminado): el clasificador del auto mode, un segundo modelo, revisa cada comando de shell en lugar de preguntarte. Los comandos aprobados se ejecutan y los rechazados se bloquean. Los borrados que afectan a rutas críticas siguen pasando por ti.
• Auto mode no disponible, o useAutoModeDuringPlan desactivado: cualquier comando fuera del conjunto de solo lectura integrado en Claude Code pide tu aprobación.
• Sesiones de terminal interactivas en las que bypass permissions está disponible (lanzaste con una de las opciones skip-permissions o configuraste bypassPermissions como modo predeterminado): los bloqueos del plan mode no se aplican. A Claude se le sigue indicando que planifique sin editar, pero una edición o un comando que intente se ejecuta sin preguntar. Las reglas ask explícitas y los borrados de rutas críticas siguen preguntando.

El plan mode mantiene sus bloqueos siempre que Claude Code se ejecuta sin una terminal interactiva: ejecuciones no interactivas con la opción print, sesiones del Agent SDK y conversaciones en el panel de chat de la extensión de VS Code. En el Agent SDK, las ediciones de archivos en plan mode nunca se aprueban automáticamente, aunque coincida una regla allow o un hook devuelva allow; van a tu callback canUseTool.

Con Claude Code v2.1.283 o posterior, el auto mode es el modo de inicio integrado para las sesiones de terminal interactivas y de VS Code, así que la mayoría llega al plan mode saliendo del auto mode con el ciclo de modos.

Cómo entrar en el plan mode

Opción 1: Shift+Tab durante una sesión

Pulsa Shift+Tab para recorrer los modos de permisos. Desde el auto mode, la primera pulsación pasa a Manual, y el ciclo sigue Manual, accept edits, plan. Los modos opcionales como bypass permissions y auto van después de plan. Sigue pulsando hasta que la barra de estado diga ⏸ plan mode on. Desde una sesión nueva que empieza en auto mode, son tres pulsaciones.

En Windows, si Shift+Tab no cambia de modo, usa Alt+M. Anthropic lo indica como alternativa cuando el runtime de Node o Bun no activa el modo de entrada VT.

Opción 2: el comando plan

Empieza un mensaje con el comando plan para pasar al plan mode desde el prompt. Si añades una descripción detrás, Claude entra en plan mode y empieza a planificar esa tarea al momento:

/plan fix the auth bug

Solo, sin descripción, el comando simplemente pasa la sesión al plan mode y espera tu siguiente mensaje:

/plan

Opción 3: iniciar una sesión en plan mode

claude --permission-mode plan

La misma opción de modo de permisos funciona en ejecuciones no interactivas, donde los bloqueos del plan mode siempre se mantienen. Por ejemplo, para obtener un plan escrito de un cambio sin dejar que Claude toque ningún archivo:

claude -p --permission-mode plan "Propose a plan to add rate limiting to the /login endpoint"

Opción 4: hacer del plan mode el predeterminado de un proyecto

Para que cada sesión de terminal de un proyecto empiece en plan mode, configura defaultMode como plan en el archivo .claude/settings.json del proyecto:

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

La extensión de VS Code no lee los archivos de configuración del proyecto para su modo inicial. Allí, configura claudeCode.initialPermissionMode como plan en tu configuración de usuario de VS Code, o elige Plan en el indicador de modo de la parte inferior del cuadro de prompt para una sola conversación.

{
  "claudeCode.initialPermissionMode": "plan"
}

Cómo aprobar, editar o salir de un plan

Cuando el plan está listo, Claude lo muestra y te pregunta cómo seguir:

• Pulsa Ctrl+G para abrir el plan propuesto en tu editor de texto predeterminado y cambiarlo directamente antes de que Claude continúe.
• Aprobar un plan sale del plan mode y pasa la sesión al modo que indica la opción, así que Claude empieza a editar.
• Aceptar un plan también da a la sesión un título generado a partir del plan, salvo que ya le hayas puesto nombre.
• Para salir del plan mode sin aprobar nada, vuelve a pulsar Shift+Tab.
• Para volver a planificar más tarde, vuelve con Shift+Tab o empieza tu siguiente prompt con el comando plan.

Limpiar el contexto de planificación al aprobar

Las sesiones de planificación largas pueden llenar buena parte de la ventana de contexto con lecturas de archivos. El ajuste showClearContextOnPlanAccept (desactivado por defecto) añade una primera opción al menú de aprobación, Yes, clear context and …, que aprueba el plan, limpia la conversación y empieza a implementar solo a partir del plan. La etiqueta también muestra cuánto contexto usó la planificación. Actívalo en tu archivo de configuración:

{
  "showClearContextOnPlanAccept": true
}

Es útil cuando el plan es lo bastante completo como para sostenerse solo. Si el plan depende de cosas que Claude aprendió pero no dejó por escrito, conserva el contexto, o edita el plan con Ctrl+G para añadir los detalles que faltan antes de limpiar.

Ejemplo práctico: planificar una funcionalidad

El flujo de trabajo que recomienda Anthropic tiene cuatro fases: explorar, planificar, implementar y hacer commit. Así se ve al añadir el inicio de sesión con Google a una app existente.

1. Explorar. Entra en plan mode y pide a Claude que lea el código relevante. No se edita nada.
2. Planificar. Pide un plan concreto: qué archivos cambian, en qué orden y cómo lo vas a probar.
3. Revisar. Lee el plan. Pulsa Ctrl+G para corregir algo directamente, o elige No, keep planning y di qué cambiar.
4. Implementar. Aprueba con la opción que encaje con lo de cerca que quieras vigilar y pide a Claude que lo implemente y ejecute las pruebas.
5. Commit. Pide a Claude que haga commit con un mensaje descriptivo y abra una pull request.

Prompts de ejemplo para las fases de exploración y planificación, escritos con el plan mode activado:

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

Después de aprobar, un prompt típico de implementación es:

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

Qué hace que un plan merezca aprobarse

• Nombra archivos. Un buen plan enumera los archivos que va a crear o cambiar, no solo la idea.
• Indica el orden de los cambios, por ejemplo primero la migración de la base de datos, después el modelo, luego la ruta de la API y por último la interfaz.
• Dice cómo va a verificar el trabajo: qué pruebas añadir o ejecutar y qué comando compila o pasa el linter al proyecto.
• Señala las dudas abiertas. Si Claude tuvo que suponer algo, como qué biblioteca de OAuth prefieres, respóndelo antes de aprobar en lugar de después de que se escriba el código.
• No se sale del alcance. Si el plan toca archivos que no esperabas, pregunta por qué antes de aprobar.

Cuándo usar el plan mode (y cuándo no)

• Bases de código que no conoces: deja que Claude trace el mapa de archivos y el flujo de datos antes de tocar nada.
• Cambios en varios archivos y refactorizaciones: revisa de antemano el orden de los cambios y los archivos afectados.
• Zonas de riesgo como la autenticación, los pagos, las migraciones de bases de datos o la configuración de despliegue, donde quieres leer cada paso antes de que se ejecute.
• Cuando no tienes claro el enfoque: pide a Claude que compare dos o tres opciones en el plan y elige una antes de que exista código.
• Ahorrar uso: un plan revisado detecta un enfoque equivocado antes de que Claude gaste tokens editando y reeditando archivos. Eso importa con los límites del plan Pro o con la facturación por token de la API.

Anthropic señala que el plan mode añade sobrecarga. Para tareas pequeñas y claras como corregir una errata, añadir una línea de log o renombrar una variable, pide a Claude que lo haga directamente. Su regla general: si puedes describir el diff en una frase, sáltate el plan.

Planifica con Opus, construye con Sonnet: el ajuste de modelo opusplan

Claude Code tiene un alias de modelo especial, opusplan, que usa Opus mientras estás en plan mode y cambia automáticamente a Sonnet cuando apruebas y empieza la ejecución. La idea es usar el modelo con mejor razonamiento para las decisiones de arquitectura y el más rápido y barato para escribir código. Cámbiate a él dentro de una sesión:

/model opusplan

O inicia una sesión con él:

claude --model opusplan

La fase de planificación usa la misma ventana de contexto que el ajuste de modelo opus, y la ejecución la misma que sonnet. Si la lista de modelos permitidos de tu organización excluye el Opus más reciente, Anthropic dice que opusplan planifica con el Opus más reciente que tengas permitido. En suscripciones Pro o Max, ten en cuenta que el uso de Opus y Sonnet puede contar contra límites distintos; consulta precios de Claude Code y precios de Claude para los detalles de los planes.

Dónde se guardan los planes

Claude Code guarda los archivos de plan en ~/.claude/plans por defecto. Para mantener los planes dentro de tu repositorio, por ejemplo para revisarlos en una pull request, configura plansDirectory con una ruta relativa a la raíz del proyecto:

{
  "plansDirectory": "./plans"
}

Claude Code vuelve a ~/.claude/plans si la ruta apunta fuera de la raíz del proyecto (como ../plans) o, en macOS, Linux y WSL, si contiene una barra invertida. Escribe las rutas con barras normales, que también funcionan en Windows.

El plan mode en otras apps de Claude Code

• VS Code: haz clic en el indicador de modo de la parte inferior del cuadro de prompt y elige Plan. Elegir Plan ahí solo se aplica a esa conversación; no se recuerda como tu próximo modo inicial.
• JetBrains: el plugin ejecuta Claude Code en la terminal del IDE, así que Shift+Tab y la opción de modo de permisos funcionan igual que en el CLI.
• App de escritorio: en la pestaña Code, elige Plan en el selector de modo junto al botón de enviar. Los demás modos se recuerdan por carpeta, pero Plan solo se aplica a la sesión actual.
• Claude Code en la web y en el móvil: las sesiones en la nube ofrecen Accept edits, Plan y Auto en el desplegable de modo. En la app móvil, toca el botón + del cuadro de prompt y luego Permission.
• Agent SDK: configura el modo de permisos como plan. Claude explora y planifica; las ediciones van a tu callback canUseTool, y Claude puede hacer preguntas aclaratorias antes de cerrar el plan.

El antiguo comando ultraplan, que enviaba una tarea de planificación a una sesión en la nube, se ha eliminado. La referencia de comandos de Anthropic remite ahora al plan mode.

Solución de problemas

Shift+Tab no cambia el modo

• En Windows, prueba Alt+M. Algunos runtimes de Node o Bun no activan el modo de entrada VT, así que la terminal nunca transmite Shift+Tab.
• Mira la barra de estado mientras pulsas: puede que te estés pasando del plan mode. Desde el auto mode son tres pulsaciones para llegar a plan.
• Si hay un aviso de permisos abierto, Shift+Tab actúa sobre el aviso en lugar de cambiar de modo. Responde o cierra primero el aviso.
• Las versiones antiguas pueden comportarse distinto. Actualiza Claude Code y vuelve a intentarlo.

Claude no deja de pedirme que apruebe comandos de exploración

Eso significa que el clasificador del auto mode no está revisando los comandos por ti: o el auto mode no está disponible para tu cuenta, modelo u organización, o useAutoModeDuringPlan está en false. La referencia de configuración de Anthropic indica que un repositorio no puede desactivarte este ajuste; está en la configuración de usuario, local o gestionada. Puedes aprobar los comandos, añadir reglas allow para los que te fíes o comprobar la disponibilidad del auto mode en la página de modos de permisos de Anthropic.

Claude editó archivos mientras estaba en plan mode

En sesiones de terminal interactivas en las que bypass permissions está disponible, los bloqueos del plan mode no se aplican. Si empezaste con una opción skip-permissions o configuraste bypassPermissions como modo predeterminado, inicia una sesión nueva sin ella cuando quieras una fase de planificación de solo lectura garantizada. Los propios archivos de plan del plan mode también pueden escribirse, así que es normal que aparezca un archivo nuevo en tu directorio de planes.

La configuración de mi proyecto no inicia VS Code en plan mode

Es lo esperado: la extensión nunca lee el .claude/settings.json de un proyecto para su modo inicial. Usa el ajuste de VS Code claudeCode.initialPermissionMode que se muestra arriba, o elige Plan en el indicador de modo.

El plan es demasiado vago o demasiado largo

• Elige No, keep planning y pide detalles: "enumera todos los archivos que vas a cambiar y las pruebas que vas a añadir".
• Acota la tarea. Un plan por funcionalidad funciona mejor que un plan para toda una hoja de ruta.
• Dirige a Claude al código correcto con referencias de archivo con @ para que no gaste contexto explorando carpetas que no tienen nada que ver.
• En bases de código grandes, pide a Claude que use un subagente para investigar, de modo que solo los hallazgos lleguen a tu contexto principal.

Aprobé por error

Pulsa Esc para detener a Claude a mitad de turno; conserva el trabajo hecho hasta ese momento. Después pulsa Esc dos veces con el prompt vacío para abrir el menú de rebobinado y restaurar el código y la conversación a un punto anterior, o usa git para descartar los cambios. Pulsa Shift+Tab para volver al plan mode antes de continuar.

Costes y qué planes lo incluyen

El plan mode es una función integrada de Claude Code, no un complemento de pago, así que está disponible dondequiera que puedas usar Claude Code: suscripciones Pro, Max, Team y Enterprise, o facturación de la API de Claude. Planificar sigue usando tokens, porque Claude lee archivos y razona sobre ellos, pero un plan corto suele salir más barato que tirar una implementación equivocada. En los planes Enterprise y las cuentas facturadas por API, Anthropic señala que las comprobaciones del clasificador del auto mode también cuentan para el uso de tokens. Consulta precios de Claude Code y precios de la API de Claude para ver los precios actuales, o ¿Claude es gratis? para ver qué puedes hacer sin pagar.

Los estudiantes y los mantenedores de código abierto pueden optar a acceso con descuento o gratuito: consulta el descuento de Claude para estudiantes y Claude for Open Source. Si todavía no has configurado Claude Code, empieza por cómo instalar Claude Code, y si vas a usar una clave de API en lugar de una suscripción, consulta cómo conseguir una clave de API de Anthropic.