Der Plan Mode von Claude Code ist der einfachste Weg, einen Agenten davon abzuhalten, in die falsche Richtung loszulaufen. Statt sofort Dateien zu bearbeiten, erkundet Claude deinen Code, fragt nach, was es wissen muss, und schreibt einen Plan. Du liest ihn, widersprichst, und erst wenn er passt, lässt du bauen. Dieser Leitfaden zeigt, wie der Plan Mode heute funktioniert, wie du ihn aktivierst, wann er sich lohnt und wie du ihn mit Subagenten und CLAUDE.md kombinierst.
Alles hier wurde im Oktober 2026 mit Anthropics Doku zu den Berechtigungsmodi und den Common Workflows abgeglichen.
Was ist der Plan Mode von Claude Code?
Der Plan Mode ist einer der Berechtigungsmodi von Claude Code. In ihm kann Claude:
- Dateien lesen und die Codebasis durchsuchen,
- zum Erkunden Shell-Befehle ausführen, etwa Dateien auflisten oder die Git-Historie lesen,
- dir Rückfragen stellen,
- einen Plan schreiben.
Was es nicht tut: deinen Quellcode bearbeiten. Der Plan ist ein Vorschlag, keine Änderung. Solange der Plan Mode aktiv ist, zeigt die Statusleiste ⏸ plan mode on.
Es geht darum, Denken und Tun zu trennen. Im Standardmodus fängt Claude nach einem kurzen Blick oft direkt mit dem Bearbeiten an. Bei kleinen Aufgaben ist genau das richtig. Bei einer großen Änderung erfährst du von einer falschen Annahme dagegen erst, wenn schon zehn Dateien angefasst sind.
So aktivierst du den Plan Mode
Je nachdem, wie lange du drinbleiben willst, gibt es drei Wege.
Shift+Tab: die laufende Session umschalten
Mit Shift+Tab wechselst du reihum durch die Berechtigungsmodi. Die Reihenfolge:
- Standard (Claude fragt vor Bearbeitungen und Befehlen)
- Accept Edits
- Plan Mode
- Bypass Permissions, nur wenn du die Session damit gestartet hast
- Auto Mode, nur wenn er dir zur Verfügung steht
Danach geht es zurück zum Standard. Hör auf, sobald die Statusleiste den Plan Mode zeigt. Ein weiteres Shift+Tab verlässt den Plan Mode, ohne etwas freizugeben.
/plan: einen einzelnen Prompt planen
Stell /plan vor einen Prompt, um nur diese Anfrage zu planen:
/plan migriere den Session-Store von Redis auf PostgresPraktisch, wenn du meist im Standardmodus arbeitest und nur für gelegentliche große Aufgaben einen Plan willst.
Eine Session im Plan Mode starten
claude --permission-mode planSoll jede Session im Plan Mode starten, legst du ihn in .claude/settings.json als Standard fest:
{
"permissions": {
"defaultMode": "plan"
}
}In der VS-Code-Extension setzt du claudeCode.initialPermissionMode auf "plan".
Der Plan Mode im Vergleich zu den anderen Modi
| Modus | Liest und erkundet | Bearbeitet Dateien | Führt Befehle aus |
|---|---|---|---|
| Standard | Ja | Nach Rückfrage | Nach Rückfrage |
| Accept Edits | Ja | Ohne Rückfrage | Nach Rückfrage |
| Plan Mode | Ja | Nein, erst nach Freigabe des Plans | Zum Erkunden; geprüft oder vorher gefragt |
| Auto Mode | Ja | Ja, mit Sicherheitsprüfungen | Ja, mit Sicherheitsprüfungen |
Der Plan Mode ist der einzige Modus, in dem Bearbeitungen auf einen ganzen Plan warten statt auf eine einzelne Änderung. Für das riskantere Ende der Skala siehe Berechtigungen in Claude Code überspringen.
Shift+Tab, die Berechtigungsmodi und die übrigen Tastenkürzel findest du gesammelt im Cheat Sheet der Claude-Code-Befehle.
Was passiert, wenn der Plan fertig ist
Wenn Claude mit dem Planen fertig ist, zeigt es den Plan und fragt, wie es weitergehen soll. Die Optionen:
- Yes, and use auto mode: freigeben und Claude mit den Sicherheitsprüfungen des Auto Mode arbeiten lassen. Ist der Auto Mode nicht verfügbar, heißt die Option stattdessen „Yes, auto-accept edits“.
- Yes, manually approve edits: freigeben, aber jede Bearbeitung einzeln prüfen.
- No, keep planning: Feedback geben und einen überarbeiteten Plan bekommen.
Wenn du die Einstellung showClearContextOnPlanAccept aktivierst, kommt eine zusätzliche erste Option dazu: Sie gibt den Plan frei und leert die Planungsunterhaltung, sodass der Bau mit einem sauberen Kontext startet, in dem nur der Plan steht.
Die Freigabe beendet den Plan Mode. Ein paar weitere Details:
- Ctrl+G öffnet den Plan in deinem Editor, damit du ihn vor der Freigabe direkt bearbeiten kannst.
- Pläne werden als Dateien gespeichert, standardmäßig in
~/.claude/plans/oder in einem Ordner, den du mitplansDirectoryfestlegst. - Wenn du einen Plan annimmst, bekommt die Session einen generierten Titel, was sie später leichter auffindbar macht.
Shell-Befehle während der Planung
Erkunden heißt oft, Befehle auszuführen. Ist der Auto Mode verfügbar und useAutoModeDuringPlan aktiv, was standardmäßig der Fall ist, prüft ein Klassifikator diese Befehle wie im Auto Mode. Andernfalls fragt alles außerhalb einer Reihe von reinen Lesebefehlen vorher nach deiner Zustimmung. So oder so: Der Plan Mode ist keine Sandbox für beliebige Befehle, sondern ein Modus, in dem Claude deinen Code nicht bearbeitet.
Wann sich der Plan Mode lohnt
Der Plan Mode lohnt sich, wenn ein falscher erster Schritt teuer ist.
| Plan Mode nutzen | Weglassen |
|---|---|
| Änderungen über mehrere Dateien oder Module | Einzeiler und Tippfehler |
| Eine Codebasis oder ein Bereich, den du nicht gut kennst | Code, den du gerade selbst geschrieben hast |
| Refactorings und Migrationen | Eine Variable umbenennen |
| Features, bei denen der Ansatz nicht offensichtlich ist | Aufgaben, bei denen du jeden Schritt schon kennst |
| Alles, was Daten, Auth oder Abrechnung berührt | Formatierung und Lint-Fixes |
| Wenn du vor dem Code-Review einen prüfbaren Plan willst | Schnelle Experimente, die du wegwirfst |
Eine gute Faustregel: Würdest du die Änderung selbst erst auf Papier skizzieren, dann lass dir von Claude zuerst einen Plan geben.
Auch beim Einarbeiten in eine Codebasis hilft der Plan Mode. Frag im Plan Mode „Wie läuft die Authentifizierung vom Login-Formular bis zum Session-Store?“, und Claude erkundet und erklärt, ohne Gefahr, etwas anzufassen.
Ein Plan-then-Execute-Workflow
Anthropics eigene Empfehlung ist eine Schleife aus vier Schritten: erkunden, planen, umsetzen, committen. In der Praxis sieht das so aus.
1. Erkunden
Wechsle in den Plan Mode und lenk Claude auf den Bereich:
Lies src/billing und die Tests unter tests/billing.
Erklär, wie Rechnungen erzeugt werden und wo Steuern angewendet werden.
Schlag noch keine Änderungen vor.Korrigiere jetzt alles, was falsch verstanden wurde. Missverständnisse sind in dieser Phase am billigsten.
2. Planen
Fordere den Plan mit den Randbedingungen an, auf die es ankommt:
Plane, wie wir Steuersätze pro Land hinzufügen.
Die öffentliche API bleibt unverändert, füge eine Migration hinzu und liste die Tests auf, die du ergänzen würdest.Ein guter Plan nennt die Dateien, die er ändert, die Reihenfolge, die Risiken und wie er das Ergebnis prüft.
3. Widersprechen
Gib nicht reflexartig den ersten Entwurf frei. Wähl „No, keep planning“ und sag, was sich ändern soll: „Mach die Migration in einem eigenen Schritt“, „Fass den PDF-Renderer nicht an“. Oder drück Ctrl+G und bearbeite den Plan selbst.
4. Umsetzen
Gib frei. Wenn du dem Plan vertraust, lässt „Yes, and use auto mode“ Claude den Plan abarbeiten, ohne bei jeder Bearbeitung anzuhalten. Ist die Änderung riskant, wähl die manuelle Freigabe.
5. Prüfen und committen
Bitte Claude, die im Plan genannten Tests auszuführen. Läuft etwas schief, stoppt Escape Claude, und /rewind (oder zweimal Escape) bringt dich zu einem früheren Checkpoint zurück. Sobald alles grün ist, commitest du.
Bei einer größeren Änderung speicherst du die Plandatei und startest den Bau in einer frischen Session. Der Plan wird zum Prompt, und der Bau beginnt mit einem Kontext voller Entscheidungen statt voller Erkundung.
Ein stärkeres Modell fürs Planen
Der Modell-Alias opusplan nutzt Opus, solange du im Plan Mode bist, und wechselt für die Umsetzung zu Sonnet. Du bekommst Denken auf Opus-Niveau für die Entscheidungen und die geringeren Kosten von Sonnet fürs Tippen. Stell es mit /model opusplan ein. Im Abo streckt das außerdem deine Nutzungslimits.
Plan Mode und Subagenten
Der Plan Mode harmoniert gut mit Subagenten, und Claude Code nutzt sie dafür bereits.
- Der eingebaute Plan-Subagent: Im Plan Mode kann Claude Recherche an einen Plan-Subagenten abgeben. Er hat nur lesende Tools, nutzt dasselbe Modell wie die Hauptunterhaltung und gräbt in seinem eigenen Kontext, sodass in der Hauptunterhaltung nur die Ergebnisse ankommen. Er startet ohne deine CLAUDE.md und ohne den Git-Status-Snapshot und läuft einmal; fortsetzen lässt er sich nicht.
- Der Explore-Subagent: ein weiterer eingebauter Subagent mit reinem Lesezugriff, ausgelegt auf schnelles Suchen und Lesen in der Codebasis.
- Subagenten bleiben im Plan Mode: Ist die Hauptunterhaltung im Plan Mode, bleiben auch die Subagenten, die sie startet, im Plan Mode. Von einem Helfer kommt also keine überraschende Bearbeitung.
Weil die Recherche in getrennten Kontexten läuft, bleibt die Hauptunterhaltung kleiner. Das hält den Plan fokussiert und lässt im Kontextfenster mehr Platz für den Bau.
Du kannst parallele Recherche auch direkt anfordern: „Untersuch im Plan Mode mit Subagenten die API-Schicht, die Datenbankschicht und das Frontend getrennt und gib mir dann einen einzigen Plan.“ Ein Hinweis aus Anthropics Kostendoku: Agent-Teams mit Teammitgliedern im Plan Mode verbrauchen etwa siebenmal so viele Tokens wie eine normale Session. Heb dir das für Änderungen auf, die es rechtfertigen.
Plan Mode und CLAUDE.md
Der Plan Mode ist nur so gut wie der Kontext, mit dem Claude startet. Hier kommt die CLAUDE.md ins Spiel. Ein paar Zeilen darin machen Pläne spürbar besser:
## Planung
- Pläne listen die zu ändernden Dateien in Reihenfolge und die neuen Tests auf.
- Datenbankänderungen bekommen immer einen eigenen Migrationsschritt.
- Öffentliche API-Signaturen werden nie ohne ausdrücklichen Hinweis geändert.
- Zur Prüfung `pnpm test` und `pnpm lint` ausführen.Zwei Details solltest du im Kopf behalten:
- Der eingebaute Plan-Subagent sieht die CLAUDE.md nicht. Projektweite Regeln gehören für die Hauptunterhaltung trotzdem dorthin; alles Kritische schreibst du zusätzlich in den Prompt, wenn du Recherche anforderst.
- Halte die CLAUDE.md kurz. Sie wird bei jedem Turn mitgeschickt, eine lange kostet also in jedem Modus Tokens. Lange Abläufe gehören in Skills.
Wenn dein Team immer erst plant, mach den Plan Mode in der gemeinsamen .claude/settings.json zum Standard und beschreib in der CLAUDE.md, wie ein guter Plan aussieht. So bekommen alle dasselbe Verhalten, ohne daran denken zu müssen.
Typische Fehler
- Freigeben, ohne zu lesen. Ein ungelesener Plan ist nur ein langsamerer Standardmodus.
- Winzige Aufgaben planen. Bei einem Tippfehler bringt der Plan Mode nur eine zusätzliche Runde.
- Zu vage Pläne. „Refactore das Auth-Modul“ ist kein Plan. Verlange Dateien, Reihenfolge und Prüfschritte.
- Nach dem Planen nie leeren. Erkundung füllt den Kontext. Gib bei großen Bauvorhaben mit der Option frei, die den Kontext leert, oder starte aus der Plandatei eine neue Session.
- Den Plan Mode für eine Sandbox halten. Er verhindert Quellcode-Bearbeitungen, macht das Terminal aber nicht zum sicheren Spielplatz. Prüf Befehle so, wie du es überall tun würdest.
Planen in AgentVera
AgentVera ist eine Desktop-App für macOS, Windows und Linux, die Claude Code und andere CLI-Agenten pro Projekt nebeneinander laufen lässt. Jeder Bereich ist das echte Claude-Code-Terminal, Shift+Tab, /plan und die Freigabeoptionen funktionieren also genau wie sonst auch. AgentVera ergänzt Struktur drumherum:
- Task Line: Eine Aufgabe durchläuft Analyse, Plan, Bau und Review. Jede Stufe schreibt ihr Ergebnis in eine Datei wie
02-plan.md, und die nächste Stufe setzt dort an. Der Plan reist so mit der Aufgabe, statt in einer einzelnen Unterhaltung zu stecken. - Flows: Verkette Schritte wie Recherche, Plan und Bau, damit dieselbe Plan-then-Execute-Schleife jedes Mal gleich abläuft.
- Auto-Freigabe: Ist ein Plan freigegeben, gehen sichere Lesezugriffe und Tests ohne Rückfrage durch, während Dinge wie
git pushoderrmweiter fragen. - Checkpoints und Replay: Die letzten 60 Turns pro Agent bleiben erhalten, sodass du zurückkannst, wenn sich der Bau vom Plan entfernt.
Checkpoints gehören zum Free-Tarif. Task Line und Auto-Freigabe gehören zu Pro und Team. Wenn du neu darin bist, mehrere Agenten zu betreiben, fang mit Claude Code nutzen an und lade AgentVera herunter.
Fazit
Der Plan Mode lässt Claude erkunden und vorschlagen, bevor es bearbeitet. Aktiviere ihn mit Shift+Tab, /plan oder --permission-mode plan, lies den Plan wirklich, widersprich mit „No, keep planning“ oder Ctrl+G und gib erst dann frei. Nutze ihn für Änderungen über mehrere Dateien, unbekannten Code und alles Riskante; bei kleinen Fixes lass ihn weg. Kombiniere ihn mit einer kurzen, konkreten CLAUDE.md, überlass das Graben den Subagenten mit reinem Lesezugriff und probier opusplan, um mit Opus zu planen und mit Sonnet zu bauen.