Plan Mode en Claude Code, el cinturón invisible, cuándo lo necesitas y cómo dejarlo puesto

Plan Mode es uno de los cuatro modos de permiso en Claude Code, y es el único que te protege de lo que realmente quieres. Pides un cambio, Claude responde con un plan, no corre ninguna herramienta. Solo cuando das el visto bueno arranca. Suena aburrido. Pero es la diferencia entre "compruebo qué va a hacer ahora" y "por qué hay ahora 14 archivos cambiados que yo no toqué".

Aquí te explico cuándo tengo Plan Mode activado, cuándo lo dejo apagado, y cómo conviertes Shift+Tab en un reflejo en vez de buscarlo cada vez en la toolbar.

Paso 1, entender los cuatro modos

Claude Code tiene cuatro modos de permiso que puedes recorrer con Shift+Tab. Default pregunta antes de cada herramienta. acceptEdits deja pasar las ediciones sin preguntar. Plan no hace ninguna llamada a herramientas sino que te da un plan. bypassPermissions deja pasar todo sin preguntar, también Bash.

La documentación oficial en code.claude.com/docs/en/interactive-mode lo describe así: "Cycle through default, acceptEdits, plan, and any modes". No hay más modos salvo los custom modes que define un plugin. Te lo puedes acordar como: a la izquierda molesto y cauteloso, a la derecha peligrosamente rápido, Plan es el medio con gafas de lectura.

Paso 2, meter Shift+Tab en el reflejo

El modo aparece abajo en la toolbar como una pequeña etiqueta. Reconoces Plan Mode por "plan" o un icono de lápiz según la versión. Pulsa Shift+Tab cuatro veces seguidas, así lo has recorrido una vez por completo. Hazlo activamente ahora para que tus dedos lo conozcan, si no lo olvidarás cuando importe.

En algunos setups Shift+Tab está secuestrado por el terminal (tmux, perfiles de iTerm). Si no quieres cambiar nada: Alt+M es la alternativa oficial. Está en la misma página de la documentación.

Paso 3, los casos estándar donde Plan Mode tiene que estar activado

Refactoring a través de varios archivos. Migración de una library a otra. Cambios de esquema en Prisma o una migración de DB. Borrar o mover más de tres archivos. Cuando no sabes cuántos archivos están afectados. Cuando el proyecto no es tuyo sino de un cliente.

Regla aproximada: todo lo que no puedas deshacer en 30 segundos pasa por Plan primero. Git stash y git reset a menudo no bastan porque Claude también crea archivos que después tienes que encontrar a mano.

Paso 4, los casos donde Plan Mode molesta

Tecleas una línea, quieres renombrar una variable, o estás construyendo tests. Plan Mode te genera un plan de cuatro párrafos para un cambio de 3 líneas y pierdes las ganas. Aquí Default o acceptEdits es lo correcto.

Mi interruptor personal: mientras estoy en una rama donde quiero explorar de forma creativa, default. En cuanto el cambio se pone "serio" o me levanto a por un café, un Shift+Tab a Plan, así Claude puede seguir pensando sin que yo pierda el control.

Paso 5, el plan es base de negociación, no un contrato

Cuando Claude te da un plan, no lo pases por encima. Cambia el plan antes de dar el visto bueno. Di "no necesitamos el paso 3, haz X en su lugar" o "en el paso 4 no toques la config, ya está bien". Claude regenera el plan, tú das el visto bueno.

Esa es la palanca real de Plan Mode. Recibes una propuesta, la remodelas, y solo entonces fluye código. Quien solo aprueba el plan de un manotazo usa Plan Mode como un Default Mode lento.

Paso 6, Plan Mode en los sub-agents

Los sub-agents corren en su propia sesión y respetan su propio permiso. Si tu sub-agent no pone un mode en su definición de agente, no hereda automáticamente tu Plan Mode actual. Es decir: estás en Plan, arrancas un sub-agent, este entra con Default y hace ediciones.

La solución: en la definición del sub-agent mantén allowed_tools estrecho de forma explícita. Read, Grep, Glob para un agente de research. Edit solo si lo quieres a propósito. Plan Mode no te protege de tus propios sub-agents, esa es una defensa separada.

Paso 7, Plan Mode con MCP tools

Las MCP tools también corren por el sistema de permisos. En Plan Mode Claude describiría "voy a llamar a nex_entity_create con estos datos". Ves los argumentos antes de que surtan efecto. Con MCP servers que escriben en tu DB (Memory, CRM, APIs externas con créditos) eso vale oro.

Regla aproximada: las MCP tools de solo lectura (search, list, get) están bien en Default. Las MCP tools de escritura (create, update, delete, send) pasan por Plan primero, al menos la primera vez por servidor.

Paso 8, auto-plan al arrancar

Puedes arrancar Claude Code con un permiso inicial. En .claude/settings.json pones defaultMode o el equivalente (el nombre varía según la versión, lee tu settings.md). Con eso cada sesión nueva se abre directamente en Plan Mode y estás obligado a salir activamente.

Ventaja: ninguna oleada de ediciones accidental justo tras el arranque de la sesión cuando todavía no sabes dónde estás. Desventaja: con hacking creativo cuesta un segundo extra. Para proyectos de cliente y repos de producción: activado. Para tu repo de hobby: apagado.

Paso 9, Plan Mode más hooks

Los hooks también disparan en Plan Mode, pero solo SessionStart y comparables. PreToolUse no dispara porque no corre ninguna herramienta. Es decir: tu hook de "bloquear todos los comandos Bash peligrosos" es irrelevante en Plan Mode, porque de todos modos no pasa nada.

En cuanto das el visto bueno al plan y las herramientas ruedan, los hooks entran con normalidad. Plan Mode y hooks se complementan, entonces: Plan Mode para "¿quiero esto siquiera?", hooks para "si sí, entonces solo de forma segura".

Paso 10, el anti-patrón, Plan Mode como pseudo-rollback

Plan Mode no es undo. Si das el visto bueno a un plan y sale mal, ya no tienes una segunda ventana de Plan Mode donde puedas pulsar reset. Las herramientas ya pasaron.

Por eso: Plan Mode complementa branch-per-ask y git-rewind de las lecciones L1-09 y L1-10. Plan Mode comprueba si la idea es buena. Las ramas y los rewinds hacen el cambio recuperable. Quien usa uno sin el otro tiene una red de seguridad con agujeros grandes.

Qué viene después

Si te tomas en serio los modos de permiso, mira el recipe phase-1-foundation/1.4-settings-permissions, ahí pone cómo poner defaultMode de forma permanente. Para la red de seguridad de ramas lee la lección L1-09 (Ramas y revisiones) y el recipe 3.6 (Branch per ask). Ambos junto con Plan Mode es la higiene de operador que necesitas en cuanto Claude trabaja en repos ajenos.

Source

• Modos de permiso y ciclo Shift+Tab: https://code.claude.com/docs/en/interactive-mode
• Debug de MCP y campos de permiso en el input del hook: https://code.claude.com/docs/en/mcp