# Modo plan de Claude Code: planifica antes de construir

URL: https://agentvera.dev/es/blog/claude-code-plan-mode/ · Publicado: 2026-10-25

El modo plan de Claude Code explicado: cómo activarlo con Shift+Tab o /plan, cuándo usarlo, flujos de planificar y ejecutar, y cómo combinarlo con subagentes y CLAUDE.md.

**En resumen:**

- En plan mode, Claude Code lee archivos, explora el código y redacta un plan, pero no edita nada hasta que lo apruebas.
- Pulsa Shift+Tab hasta que la barra de estado muestre plan mode, antepón /plan a un prompt concreto o arranca con claude --permission-mode plan.
- Úsalo en cambios que tocan varios archivos o que todavía no te imaginas bien; sáltatelo en arreglos de una línea.

El modo plan de Claude Code es la forma más sencilla de evitar que un agente salga corriendo en la dirección equivocada. En lugar de editar archivos de inmediato, Claude explora tu código, pregunta lo que necesita saber y redacta un plan. Tú lo lees, pones pegas y solo cuando te convence le dejas construir. Esta guía explica cómo funciona hoy plan mode, cómo activarlo, cuándo compensa y cómo combinarlo con subagentes y CLAUDE.md.

Todo lo que sigue se ha comprobado en octubre de 2026 con la [documentación de modos de permisos](https://code.claude.com/docs/en/permission-modes "Modos de permisos de Claude Code") y la de [flujos de trabajo habituales](https://code.claude.com/docs/en/common-workflows "Flujos de trabajo habituales de Claude Code") de Anthropic.

## ¿Qué es el modo plan de Claude Code?

Plan mode es uno de los modos de permisos de Claude Code. En él, Claude puede:

- leer archivos y buscar en el código,
- ejecutar comandos de shell para explorar, como listar archivos o leer el historial de git,
- hacerte preguntas para aclarar dudas,
- redactar un plan.

Lo que no hace es editar tu código fuente. El plan es una propuesta, no un cambio. Mientras plan mode está activo, la barra de estado muestra `⏸ plan mode on`.

La idea es separar pensar de hacer. En el modo por defecto, Claude suele empezar a editar tras echar un vistazo rápido. En tareas pequeñas es justo lo que quieres. En un cambio grande significa que descubres una suposición equivocada cuando ya ha tocado diez archivos.

## Cómo entrar en plan mode

Hay tres formas, según cuánto tiempo quieras quedarte.

### Shift+Tab: cambia la sesión actual

Pulsa **Shift+Tab** para recorrer los modos de permisos. El orden es:

1. Por defecto (Claude pregunta antes de editar y de ejecutar comandos)
2. Aceptar ediciones
3. Plan mode
4. Saltar permisos, solo si arrancaste con esa opción habilitada
5. Modo auto, solo si lo tienes disponible

Después vuelve al modo por defecto. Para cuando la barra de estado muestre plan mode. Pulsa Shift+Tab otra vez para salir de plan mode sin aprobar nada.

### /plan: planifica un solo prompt

Escribe `/plan` delante de un prompt para planificar solo esa petición:

```
/plan migra el almacén de sesiones de Redis a Postgres
```

Es útil si trabajas casi siempre en el modo por defecto y solo quieres un plan para la tarea grande de turno.

### Inicia una sesión en plan mode

```bash
claude --permission-mode plan
```

Si quieres que todas las sesiones empiecen en plan mode, ponlo como predeterminado en `.claude/settings.json`:

```json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
```

En la extensión de VS Code, pon `claudeCode.initialPermissionMode` en `"plan"`.

### Plan mode frente a los demás modos

| Modo | Lee y explora | Edita archivos | Ejecuta comandos |
| --- | --- | --- | --- |
| Por defecto | Sí | Tras preguntarte | Tras preguntarte |
| Aceptar ediciones | Sí | Sin preguntar | Tras preguntarte |
| Plan mode | Sí | No, solo tras aprobar el plan | Para explorar; revisados o preguntando antes |
| Modo auto | Sí | Sí, con comprobaciones de seguridad | Sí, con comprobaciones de seguridad |

Plan mode es el único en el que las ediciones esperan a un plan completo, no a un cambio suelto. Para el extremo más arriesgado de la escala, mira [cómo saltarse los permisos en Claude Code](/es/blog/claude-code-skip-permissions/ "Saltarse los permisos en Claude Code").

Shift+Tab, los modos de permisos y el resto de atajos están recogidos en la [hoja de referencia de comandos de Claude Code](/es/blog/claude-code-commands-cheat-sheet/ "Hoja de referencia de comandos de Claude Code").

## Qué pasa cuando el plan está listo

Cuando Claude termina de planificar, muestra el plan y te pregunta cómo seguir. Las opciones son:

- **Yes, and use auto mode:** apruebas y Claude trabaja con las comprobaciones de seguridad del modo auto. Si el modo auto no está disponible, la opción aparece como “Yes, auto-accept edits”.
- **Yes, manually approve edits:** apruebas, pero revisas cada edición según llega.
- **No, keep planning:** mandas tus comentarios y recibes un plan revisado.

Si activas el ajuste `showClearContextOnPlanAccept`, aparece una primera opción adicional que aprueba el plan y limpia la conversación de planificación, de modo que la construcción arranca con un contexto limpio que solo contiene el plan.

Aprobar te saca de plan mode. Otras cosas que conviene saber:

- **Ctrl+G** abre el plan en tu editor para que puedas editarlo directamente antes de aprobarlo.
- Los planes se guardan como archivos, por defecto en `~/.claude/plans/` o en la carpeta que indiques con `plansDirectory`.
- Al aceptar un plan, la sesión recibe un título generado, lo que facilita encontrarla después.

### Comandos de shell durante la planificación

Explorar a menudo implica ejecutar comandos. Si el modo auto está disponible y `useAutoModeDuringPlan` está activado, como viene por defecto, un clasificador revisa esos comandos igual que en modo auto. Si no, todo lo que quede fuera de un conjunto de comandos de solo lectura te pide aprobación primero. En cualquier caso, plan mode no es un sandbox para comandos arbitrarios; es un modo en el que Claude no edita tu código.

## Cuándo usar plan mode

Plan mode compensa cuando un primer paso equivocado sale caro.

| Usa plan mode | Sáltatelo |
| --- | --- |
| Cambios que abarcan varios archivos o módulos | Arreglos de una línea y erratas |
| Un código o una zona que no conoces bien | Código que acabas de escribir |
| Refactorizaciones y migraciones | Renombrar una variable |
| Funcionalidades en las que el enfoque no es obvio | Tareas de las que ya conoces cada paso |
| Todo lo que toque datos, autenticación o facturación | Formato y arreglos del linter |
| Cuando quieres un plan revisable antes de la revisión de código | Experimentos rápidos que vas a tirar |

Una regla práctica: si antes de hacer el cambio tú mismo lo esbozarías en un papel, pídele a Claude un plan primero.

Plan mode también ayuda cuando estás aprendiendo un código. Pregunta en plan mode “¿cómo fluye la autenticación desde el formulario de login hasta el almacén de sesiones?” y Claude explora y te lo explica sin riesgo de tocar nada.

## Un flujo de planificar y ejecutar

El ciclo que recomienda la propia Anthropic tiene cuatro pasos: explorar, planificar, implementar y hacer commit. En la práctica queda así.

### 1. Explora

Entra en plan mode y dirige a Claude a la zona en cuestión:

```
Lee src/billing y los tests de tests/billing.
Explica cómo se generan las facturas y dónde se aplican los impuestos.
Todavía no propongas cambios.
```

Corrige ahora cualquier cosa que haya entendido mal. Los malentendidos son más baratos en esta fase.

### 2. Planifica

Pide el plan con las restricciones que importan:

```
Planifica cómo añadir tipos impositivos por país.
No cambies la API pública, añade una migración y enumera los tests que añadirías.
```

Un buen plan nombra los archivos que va a cambiar, el orden, los riesgos y cómo verificará el resultado.

### 3. Pon pegas

No apruebes el primer borrador por inercia. Elige “No, keep planning” y di qué cambiar: “Haz la migración en un paso aparte”, “No toques el generador de PDF”. O pulsa Ctrl+G y edita tú el plan.

### 4. Ejecuta

Aprueba. Si confías en el plan, “Yes, and use auto mode” deja que Claude lo recorra sin pararse en cada edición. Si el cambio es arriesgado, elige la aprobación manual.

### 5. Verifica y haz commit

Pide a Claude que ejecute los tests que enumeró en el plan. Si algo sale mal, Escape detiene a Claude, y `/rewind` (o pulsar Escape dos veces) te devuelve a un checkpoint anterior. Cuando todo pase, haz commit.

En un cambio más grande, guarda el archivo del plan y empieza la construcción en una sesión nueva. El plan se convierte en el prompt, y la construcción arranca con un contexto lleno de decisiones, no de exploración.

### Usa un modelo más potente para planificar

El alias de modelo `opusplan` usa Opus mientras estás en plan mode y cambia a Sonnet para la ejecución. Obtienes el razonamiento de Opus para las decisiones y el menor coste de Sonnet para escribir el código. Actívalo con `/model opusplan`. En una suscripción, eso también estira tus [límites de uso](/es/blog/claude-code-usage-limits/ "Límites de uso de Claude Code").

## Plan mode y subagentes

Plan mode funciona bien con los [subagentes](/es/blog/claude-code-subagents/ "Subagentes de Claude Code"), y Claude Code ya los usa para ello.

- **El subagente Plan integrado:** durante plan mode, Claude puede delegar la investigación en un subagente Plan. Tiene herramientas de solo lectura, usa el mismo modelo que la conversación principal y hace su trabajo de búsqueda en su propio contexto, así que a la conversación principal solo le llegan las conclusiones. Arranca sin tu CLAUDE.md y sin la instantánea del estado de git, y se ejecuta una sola vez; no se puede reanudar.
- **El subagente Explore:** otro integrado de solo lectura, pensado para buscar y leer el código con rapidez.
- **Los subagentes siguen en plan mode:** cuando la conversación principal está en plan mode, los subagentes que lanza también se quedan en plan mode. No te llevarás una edición sorpresa de un ayudante.

Como la investigación ocurre en contextos separados, la conversación principal se mantiene más pequeña. Eso mantiene el plan enfocado y deja más [ventana de contexto](/es/blog/claude-code-context-window/ "Ventana de contexto de Claude Code") libre para construir.

También puedes pedir investigación en paralelo directamente: “En plan mode, usa subagentes para revisar por separado la capa de API, la de base de datos y el frontend, y luego dame un único plan.” Una advertencia de la documentación de costes de Anthropic: los equipos de agentes con compañeros en plan mode usan aproximadamente siete veces los tokens de una sesión estándar, así que resérvalo para cambios que lo justifiquen.

## Plan mode y CLAUDE.md

Plan mode es tan bueno como el contexto con el que arranca Claude. Ahí entra [CLAUDE.md](/es/blog/claude-md-agents-md/ "CLAUDE.md y AGENTS.md"). Unas pocas líneas mejoran los planes de forma notable:

```markdown
## Planificación
- Los planes enumeran los archivos a cambiar, en orden, y los tests a añadir.
- Los cambios de base de datos siempre tienen su propio paso de migración.
- Nunca cambies firmas de la API pública sin señalarlo.
- Ejecuta `pnpm test` y `pnpm lint` para verificar.
```

Ten en cuenta dos detalles:

- El subagente Plan integrado no ve CLAUDE.md, así que pon ahí las reglas de todo el proyecto para la conversación principal e incluye en tu prompt lo que sea crítico cuando pidas investigación.
- Mantén CLAUDE.md corto. Se envía en cada turno, así que uno largo cuesta tokens en cualquier modo. Pasa los procedimientos largos a skills.

Si tu equipo siempre planifica antes de construir, pon plan mode como predeterminado en el `.claude/settings.json` compartido y describe en CLAUDE.md cómo es un buen plan. Así todo el mundo obtiene el mismo comportamiento sin tener que acordarse.

## Errores habituales

- **Aprobar sin leer.** Un plan que no has leído es solo un modo por defecto más lento.
- **Planificar tareas diminutas.** Para arreglar una errata, plan mode solo añade una vuelta más.
- **Planes demasiado vagos.** “Refactoriza el módulo de auth” no es un plan. Pide archivos, orden y pasos de verificación.
- **No limpiar nunca después de planificar.** La exploración llena el contexto. En construcciones grandes, aprueba con la opción que limpia el contexto o empieza una sesión nueva a partir del archivo del plan.
- **Dar por hecho que plan mode es un sandbox.** Impide las ediciones del código fuente; no convierte la terminal en un patio de juegos seguro. Revisa los comandos como lo harías en cualquier otro sitio.

## Planificar en AgentVera

AgentVera es una app de escritorio para macOS, Windows y Linux que ejecuta Claude Code y otros agentes de CLI uno junto a otro, por proyecto. Cada panel es la terminal real de Claude Code, así que Shift+Tab, `/plan` y las opciones de aprobación del plan funcionan exactamente igual que por separado. AgentVera añade estructura alrededor:

- **[Task line](/es/features/task-line/ "Task line"):** una tarea pasa por las etapas Analysis, Plan, Build y Review. Cada etapa escribe su resultado en un archivo, como `02-plan.md`, y la siguiente parte de él, de modo que el plan viaja con la tarea en lugar de vivir en una sola conversación.
- **[Flows](/es/features/flows/ "Flows"):** encadena pasos como investigar, planificar y construir, para que el mismo ciclo de planificar y ejecutar funcione igual cada vez.
- **[Aprobación automática](/es/features/auto-approval/ "Aprobación automática"):** una vez aprobado el plan, las lecturas y los tests seguros pasan sin preguntar, mientras que cosas como `git push` o `rm` siguen pidiendo confirmación.
- **[Checkpoints y replay](/es/features/checkpoints-and-replay/ "Checkpoints y replay"):** se conservan los últimos 60 turnos por agente, así que puedes volver atrás si la construcción se aleja del plan.

Los checkpoints están en el plan gratuito. La task line y la aprobación automática están en Pro y Team. Si es la primera vez que ejecutas varios agentes, empieza por [cómo usar Claude Code](/es/blog/how-to-use-claude-code/ "Cómo usar Claude Code") y [descarga AgentVera](/es/download/ "Descargar AgentVera").

## Conclusión

Plan mode hace que Claude explore y proponga antes de editar. Actívalo con Shift+Tab, `/plan` o `--permission-mode plan`, lee el plan con calma, pon pegas con “No, keep planning” o Ctrl+G y solo entonces apruébalo. Úsalo en cambios de varios archivos, en código que no conoces y en todo lo arriesgado; sáltatelo en los arreglos pequeños. Combínalo con un CLAUDE.md corto y concreto, deja la investigación a los subagentes de solo lectura y prueba `opusplan` para planificar con Opus y construir con Sonnet.

## Preguntas frecuentes

**¿Cómo activo el modo plan en Claude Code?** Pulsa Shift+Tab hasta que la barra de estado muestre “plan mode on”, escribe /plan delante de un prompt concreto o inicia la sesión con claude --permission-mode plan.

**¿Puede Claude modificar archivos en plan mode?** No. Puede leer archivos y ejecutar comandos para explorar, pero no edita tu código fuente hasta que apruebas el plan.

**¿Cómo salgo de plan mode?** Aprueba el plan, lo que cierra plan mode y arranca el trabajo, o pulsa Shift+Tab otra vez para salir sin aprobar.

**¿Puedo hacer que plan mode sea el modo por defecto?** Sí. Pon "defaultMode": "plan" dentro de permissions en .claude/settings.json y cada sesión nueva empezará en plan mode.

**¿Plan mode gasta más tokens?** Planificar cuesta algunos tokens al principio, pero en tareas grandes suele ahorrar más al evitar rehacer trabajo. Las recomendaciones de costes de Anthropic lo aconsejan para cambios complejos.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/