Plan Mode in Claude Code, der unsichtbare Sicherheitsgurt, wann Du ihn brauchst und wie Du ihn drin lässt

Plan Mode ist eine der vier Permission-Modi in Claude Code, und er ist der einzige der Dich vor dem schützt was Du eigentlich willst. Du bittest um eine Anderung, Claude antwortet mit einem Plan, kein Tool läuft. Erst wenn Du absegnest, geht es los. Klingt langweilig. Ist aber der Unterschied zwischen "ich prüfe was er gleich tun wird" und "warum sind jetzt 14 Files verändert die ich nicht angefasst habe".

Ich erklär Dir hier wann ich Plan Mode an habe, wann ich ihn weg lasse, und wie Du Shift+Tab in den Reflex bekommst statt es jedes Mal in der Toolbar zu suchen.

Schritt 1, die vier Modi verstehen

Claude Code hat vier Permission-Modi die Du mit Shift+Tab durchcyclen kannst. Default fragt vor jedem Tool. acceptEdits lässt Edits ohne Rueckfrage durch. Plan macht keinen Tool-Call sondern gibt Dir einen Plan. bypassPermissions lässt alles durch ohne zu fragen, auch Bash.

Die offizielle Doku auf code.claude.com/docs/en/interactive-mode beschreibt das so: "Cycle through default, acceptEdits, plan, and any modes". Mehr Modi gibt es nicht ausser Custom Modes die ein Plugin definiert. Du kannst Dir merken: links nervig vorsichtig, rechts gefaehrlich schnell, Plan ist die Mitte mit Lesebrille.

Schritt 2, Shift+Tab in den Reflex bringen

Der Mode steht unten in der Toolbar als kleines Label. Du erkennst Plan Mode an "plan" oder einem Stift-Icon je nach Version. Druck Shift+Tab vier Mal hintereinander, dann hast Du ihn ein Mal komplett durchgecycled. Mach das jetzt einmal aktiv damit Deine Finger es kennen, sonst wirst Du es im Ernstfall vergessen.

Auf manchen Setups ist Shift+Tab vom Terminal gekapert (tmux, iTerm Profile). Falls Du nichts wechselt: Alt+M ist die offizielle Alternative. Steht in der gleichen Doku-Page.

Schritt 3, die Standard-Faelle wo Plan Mode an muss

Refactoring ueber mehrere Files. Migration von einer Library zur anderen. Schema-Aenderungen an Prisma oder einer DB-Migration. Loeschen oder Verschieben von mehr als drei Files. Wenn Du nicht weisst wie viele Files betroffen sind. Wenn das Projekt nicht deins ist sondern Kunde.

Faustregel: alles was Du nicht in 30 Sekunden zurückdrehen kannst, geht durch Plan zuerst. Git Stash und git Reset reichen oft nicht weil Claude auch Files anlegt die Du dann manuell finden musst.

Schritt 4, die Faelle wo Plan Mode nervt

Du tippst eine Zeile, willst eine Variable umbenennen, oder Du baust gerade Tests. Plan Mode generiert Dir einen Vier-Absatz-Plan für eine 3-Zeilen-Anderung und Du verlierst die Lust. Hier ist Default oder acceptEdits richtig.

Mein persoenlicher Schalter: solange ich in einem Branch bin wo ich gerade kreativ explorieren will, default. Sobald die Anderung "ernst" wird oder ich aufstehe und Kaffee hole, einmal Shift+Tab nach Plan, dann kann Claude weiterdenken ohne dass ich die Kontrolle verliere.

Schritt 5, der Plan ist Verhandlungsbasis, kein Vertrag

Wenn Claude Dir einen Plan ausgibt, lies ihn nicht ueber. Aender den Plan bevor Du absegnest. Sag "Schritt 3 brauchen wir nicht, mach stattdessen X" oder "in Schritt 4 fass die config nicht an, die ist schon richtig". Claude regeneriert den Plan, Du segnest ab.

Das ist der eigentliche Hebel von Plan Mode. Du bekommst einen Vorschlag, formst ihn um, und erst dann fliesst Code. Wer den Plan nur durchwinkt benutzt Plan Mode wie eine langsame Default-Mode.

Schritt 6, Plan Mode in Sub-Agents

Sub-Agents laufen in einer eigenen Session und respektieren ihre eigene Permission. Wenn Dein Sub-Agent in seiner agent-Definition keinen mode setzt, erbt er nicht automatisch Dein aktuelles Plan-Mode. Heisst: Du bist im Plan, Du startest einen Sub-Agent, der greift mit Default zu und macht Edits.

Die Loesung: in der Sub-Agent-Definition explizit allowed_tools eng halten. Read, Grep, Glob für einen Research-Agent. Edit nur wenn absichtlich gewollt. Plan Mode schützt Dich nicht vor Deinen eigenen Sub-Agents, das ist eine separate Defense.

Schritt 7, Plan Mode bei MCP Tools

MCP Tools laufen ebenfalls durch das Permission-System. Im Plan Mode wuerde Claude beschreiben "ich rufe gleich nex_entity_create auf mit diesen Daten". Du siehst die Argumente bevor sie wirken. Bei MCP-Servern die in Deine DB schreiben (Memory, CRM, externe APIs mit Credits) ist das Gold wert.

Faustregel: Read-only MCP Tools (search, list, get) sind im Default ok. Write-MCP-Tools (create, update, delete, send) gehen durch Plan zuerst, mindestens beim ersten Mal pro Server.

Schritt 8, Auto-Plan beim Start

Du kannst Claude Code mit einer initialen Permission starten. In .claude/settings.json setzt Du defaultMode oder das Equivalent (Bezeichnung variiert pro Version, lies Deine settings.md). Damit oeffnet sich jede neue Session direkt im Plan Mode und Du bist gezwungen aktiv rauszuwechseln.

Vorteil: Keine versehentliche Edit-Welle gleich nach Session-Start wenn Du noch nicht weisst wo Du bist. Nachteil: bei kreativem Hacken kostet es eine Sekunde extra. Für Kunden-Projekte und Production-Repos: an. Für Dein Hobby-Repo: aus.

Schritt 9, Plan Mode plus Hooks

Hooks feuern auch im Plan Mode, aber nur SessionStart und vergleichbare. PreToolUse feuert nicht weil kein Tool läuft. Heisst: Dein "alle gefaehrlichen Bash-Commands blockieren" Hook ist im Plan Mode irrelevant, weil sowieso nichts passiert.

Sobald Du den Plan absegnest und Tools rollen, greifen die Hooks normal. Plan Mode und Hooks ergaenzen sich also: Plan Mode für "will ich das uberhaupt", Hooks für "wenn ja, dann nur sicher".

Schritt 10, das Anti-Pattern, Plan Mode als Pseudo-Rollback

Plan Mode ist kein Undo. Wenn Du einen Plan absegnest und es geht schief, hast Du kein zweites Plan-Mode-Fenster mehr in dem Du auf Reset klicken kannst. Die Tools sind durch.

Deshalb: Plan Mode ergaenzt branch-per-ask und git-rewind aus den Lessons L1-09 und L1-10. Plan Mode prüft ob die Idee gut ist. Branches und Rewinds machen die Anderung rueckholbar. Wer das eine ohne das andere benutzt hat ein Sicherheitsnetz mit grossen Loechern.

Was als naechstes

Wenn Du Permission-Modi ernst nimmst, schau Dir das Recipe phase-1-foundation/1.4-settings-permissions an, dort steht wie Du defaultMode dauerhaft setzt. Für das Branch-Sicherheitsnetz lies Lesson L1-09 (Branches und Reviews) und Recipe 3.6 (Branch per Ask). Beides zusammen mit Plan Mode ist die Operator-Hygiene die Du brauchst sobald Claude in fremden Repos arbeitet.

Source

• Permission-Modi und Shift+Tab Cycle: https://code.claude.com/docs/en/interactive-mode
• MCP Debug und Permission-Felder im Hook-Input: https://code.claude.com/docs/en/mcp