Claude Code Plan Mode (2026): aktivieren, Pläne freigeben und wann er sich lohnt

Der Plan Mode ist ein Berechtigungsmodus von Claude Code, in dem Claude Ihren Code untersucht und einen Plan schreibt, Ihre Quelldateien aber erst bearbeitet, wenn Sie den Plan freigeben. Sie aktivieren ihn, indem Sie Shift+Tab drücken, bis die Statusleiste ⏸ plan mode on anzeigt, indem Sie einen Prompt mit dem plan-Befehl beginnen oder indem Sie Claude Code mit dem Berechtigungsmodus plan starten. Ist der Plan fertig, geben Sie ihn frei, planen weiter oder drücken Ctrl+G, um den Plan selbst zu bearbeiten, bevor Claude Code schreibt.

Abgeglichen mit der Claude-Code-Dokumentation von Anthropic am 17. Oktober 2026. Claude Code wird häufig aktualisiert, Bezeichnungen und Standardwerte können sich also zwischen Versionen ändern. Sieht etwas auf Ihrem Bildschirm anders aus, aktualisieren Sie zuerst Claude Code (siehe Claude Code aktualisieren).

Was der Plan Mode macht

Jede Claude-Code-Sitzung läuft in einem Berechtigungsmodus, der festlegt, was Claude ohne Rückfrage tun darf. Der Plan Mode ist für das Nachdenken vor dem Handeln gedacht: Claude liest Dateien, führt Shell-Befehle zur Erkundung aus und schreibt einen Plan, bearbeitet aber Ihren Quellcode nicht. Änderungen bleiben blockiert, bis Sie den Plan freigeben. Der Best-Practices-Guide von Anthropic beschreibt das als Trennung von Erkundung und Umsetzung, damit Claude nicht direkt Code schreibt, der das falsche Problem löst.

Wie Erkundungsbefehle behandelt werden, hängt von Ihrer Sitzung ab. Anthropic dokumentiert drei Fälle, und der erste zutreffende gilt:

• Auto Mode verfügbar und useAutoModeDuringPlan aktiv (Standard): Der Auto-Mode-Klassifikator, ein zweites Modell, prüft jeden Shell-Befehl, statt Sie zu fragen. Genehmigte Befehle laufen, abgelehnte werden blockiert. Löschvorgänge auf kritischen Pfaden landen trotzdem bei Ihnen.
• Auto Mode nicht verfügbar oder useAutoModeDuringPlan deaktiviert: Jeder Befehl außerhalb der integrierten Nur-Lese-Befehle von Claude Code fragt nach Ihrer Genehmigung.
• Interaktive Terminal-Sitzungen, in denen Bypass Permissions verfügbar ist (Sie haben mit einem der Skip-Permissions-Flags gestartet oder bypassPermissions als Standardmodus gesetzt): Die Sperren des Plan Mode werden nicht durchgesetzt. Claude wird zwar weiterhin angewiesen, ohne Änderungen zu planen, aber eine versuchte Änderung oder ein Befehl läuft ohne Rückfrage. Explizite Ask-Regeln und Löschvorgänge auf kritischen Pfaden fragen weiterhin nach.

Der Plan Mode behält seine Sperren überall dort, wo Claude Code ohne interaktives Terminal läuft: bei nicht interaktiven Läufen mit dem Print-Flag, in Agent-SDK-Sitzungen und in Unterhaltungen im Chat-Panel der VS-Code-Erweiterung. Im Agent SDK werden Dateiänderungen im Plan Mode nie automatisch genehmigt, selbst wenn eine Allow-Regel passt oder ein Hook allow zurückgibt; sie gehen stattdessen an Ihren canUseTool-Callback.

Ab Claude Code v2.1.283 ist Auto Mode der integrierte Startmodus für interaktive Terminal- und VS-Code-Sitzungen, die meisten erreichen den Plan Mode also, indem sie von Auto weiterschalten.

So aktivieren Sie den Plan Mode

Option 1: Shift+Tab während einer Sitzung

Drücken Sie Shift+Tab, um durch die Berechtigungsmodi zu schalten. Aus dem Auto Mode wechselt der erste Druck zu Manual, danach geht es weiter über Manual, Accept edits zu Plan. Optionale Modi wie Bypass Permissions und Auto folgen nach Plan. Drücken Sie so lange, bis die Statusleiste ⏸ plan mode on anzeigt. In einer neuen Sitzung, die im Auto Mode startet, sind das drei Tastendrücke.

Wenn Shift+Tab unter Windows den Modus nicht wechselt, verwenden Sie Alt+M. Anthropic nennt das als Alternative, wenn die Node- oder Bun-Laufzeit den VT-Eingabemodus nicht aktiviert.

Option 2: Der plan-Befehl

Beginnen Sie eine Nachricht mit dem plan-Befehl, um direkt aus dem Prompt in den Plan Mode zu wechseln. Mit einer Beschreibung dahinter wechselt Claude in den Plan Mode und beginnt sofort, diese Aufgabe zu planen:

/plan fix the auth bug

Allein, ohne Beschreibung, schaltet der Befehl die Sitzung nur in den Plan Mode und wartet auf Ihre nächste Nachricht:

/plan

Option 3: Eine Sitzung im Plan Mode starten

claude --permission-mode plan

Dasselbe Permission-Mode-Flag funktioniert bei nicht interaktiven Läufen, in denen die Sperren des Plan Mode immer gelten. Zum Beispiel, um einen schriftlichen Plan für eine Änderung zu erhalten, ohne dass Claude Dateien anfasst:

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

Option 4: Plan Mode als Standard für ein Projekt festlegen

Um jede Terminal-Sitzung in einem Projekt im Plan Mode zu starten, setzen Sie defaultMode in der .claude/settings.json des Projekts auf plan:

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

Die VS-Code-Erweiterung liest für ihren Startmodus nicht die Einstellungsdateien eines Projekts. Setzen Sie dort claudeCode.initialPermissionMode in Ihren VS-Code-Benutzereinstellungen auf plan, oder wählen Sie für eine einzelne Unterhaltung Plan in der Modusanzeige unten im Eingabefeld.

{
  "claudeCode.initialPermissionMode": "plan"
}

So geben Sie einen Plan frei, bearbeiten oder verlassen ihn

Ist der Plan fertig, zeigt Claude ihn an und fragt, wie es weitergehen soll:

• Drücken Sie Ctrl+G, um den vorgeschlagenen Plan in Ihrem Standard-Texteditor zu öffnen und direkt zu ändern, bevor Claude weitermacht.
• Die Freigabe eines Plans beendet den Plan Mode und schaltet die Sitzung in den Modus, den die Option nennt – Claude beginnt also mit den Änderungen.
• Mit der Freigabe erhält die Sitzung außerdem einen aus dem Plan generierten Titel, sofern Sie die Sitzung nicht schon benannt haben.
• Um den Plan Mode ohne Freigabe zu verlassen, drücken Sie erneut Shift+Tab.
• Um später wieder zu planen, schalten Sie mit Shift+Tab zurück oder beginnen Ihren nächsten Prompt mit dem plan-Befehl.

Den Planungskontext bei der Freigabe leeren

Lange Planungssitzungen können einen großen Teil des Kontextfensters mit gelesenen Dateien füllen. Die Einstellung showClearContextOnPlanAccept (standardmäßig aus) fügt dem Freigabemenü eine erste Option Yes, clear context and … hinzu, die den Plan freigibt, die Unterhaltung leert und die Umsetzung allein auf Basis des Plans beginnt. Die Beschriftung zeigt auch, wie viel Kontext die Planung verbraucht hat. Aktivieren Sie sie in Ihrer Einstellungsdatei:

{
  "showClearContextOnPlanAccept": true
}

Das ist nützlich, wenn der Plan vollständig genug ist, um für sich zu stehen. Hängt der Plan von Dingen ab, die Claude gelernt, aber nicht aufgeschrieben hat, behalten Sie den Kontext lieber, oder ergänzen Sie die fehlenden Details mit Ctrl+G im Plan, bevor Sie leeren.

Ein Praxisbeispiel: ein Feature planen

Der von Anthropic empfohlene Workflow hat vier Phasen: erkunden, planen, umsetzen, committen. So sieht das aus, wenn Sie einer bestehenden App eine Google-Anmeldung hinzufügen.

1. Erkunden. Wechseln Sie in den Plan Mode und lassen Sie Claude den relevanten Code lesen. Nichts wird geändert.
2. Planen. Fordern Sie einen konkreten Plan an: welche Dateien sich ändern, in welcher Reihenfolge und wie Sie es testen.
3. Prüfen. Lesen Sie den Plan. Drücken Sie Ctrl+G, um etwas direkt zu korrigieren, oder wählen Sie No, keep planning und sagen Sie, was geändert werden soll.
4. Umsetzen. Geben Sie mit der Option frei, die dazu passt, wie genau Sie zusehen möchten, und lassen Sie Claude dann umsetzen und die Tests ausführen.
5. Committen. Lassen Sie Claude mit einer aussagekräftigen Nachricht committen und einen Pull Request öffnen.

Beispiel-Prompts für die Erkundungs- und Planungsphase, eingegeben bei aktivem Plan Mode:

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.

Nach der Freigabe lautet ein typischer Umsetzungs-Prompt:

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

Woran Sie einen freigabewürdigen Plan erkennen

• Er nennt Dateien. Ein guter Plan listet die Dateien, die er anlegt oder ändert, nicht nur die Idee.
• Er nennt die Reihenfolge der Änderungen, zum Beispiel zuerst die Datenbankmigration, dann das Modell, dann die API-Route, dann die Oberfläche.
• Er sagt, wie die Arbeit überprüft wird: welche Tests hinzugefügt oder ausgeführt werden und mit welchem Befehl das Projekt gebaut oder gelintet wird.
• Er benennt offene Fragen. Musste Claude bei etwas raten, etwa welche OAuth-Bibliothek Sie bevorzugen, beantworten Sie das vor der Freigabe statt nach dem Schreiben des Codes.
• Er bleibt im Rahmen. Fasst der Plan Dateien an, mit denen Sie nicht gerechnet haben, fragen Sie vor der Freigabe nach dem Grund.

Wann sich der Plan Mode lohnt (und wann nicht)

• Unbekannte Codebasen: Lassen Sie Claude Dateien und Datenfluss erfassen, bevor es etwas anfasst.
• Änderungen über mehrere Dateien und Refactorings: Prüfen Sie Reihenfolge und betroffene Dateien vorab.
• Riskante Bereiche wie Authentifizierung, Zahlungen, Datenbankmigrationen oder Deployment-Konfiguration, bei denen Sie jeden Schritt lesen möchten, bevor er ausgeführt wird.
• Wenn Sie beim Vorgehen unsicher sind: Lassen Sie Claude im Plan zwei oder drei Optionen vergleichen und wählen Sie eine, bevor es Code gibt.
• Nutzung sparen: Ein geprüfter Plan fängt einen falschen Ansatz ab, bevor Claude Tokens für das Bearbeiten und erneute Bearbeiten von Dateien ausgibt. Das zählt bei den Limits des Pro-Plans oder bei Token-basierter API-Abrechnung.

Anthropic weist darauf hin, dass der Plan Mode Aufwand erzeugt. Bei kleinen, klaren Aufgaben wie einem Tippfehler, einer zusätzlichen Log-Zeile oder dem Umbenennen einer Variable bitten Sie Claude, es direkt zu erledigen. Die Faustregel: Wenn Sie den Diff in einem Satz beschreiben können, lassen Sie den Plan weg.

Mit Opus planen, mit Sonnet bauen: die Modelleinstellung opusplan

Claude Code hat einen speziellen Modell-Alias, opusplan, der im Plan Mode Opus verwendet und automatisch zu Sonnet wechselt, sobald Sie freigeben und die Umsetzung beginnt. Die Idee: das stärkere Reasoning-Modell für Architekturentscheidungen und das schnellere, günstigere für das Schreiben von Code. So wechseln Sie in einer Sitzung:

/model opusplan

Oder starten Sie eine Sitzung damit:

claude --model opusplan

Die Planungsphase nutzt dasselbe Kontextfenster wie die Modelleinstellung opus, die Umsetzung dasselbe wie sonnet. Schließt die Modell-Allowlist Ihrer Organisation das neueste Opus aus, plant opusplan laut Anthropic mit dem neuesten Opus, das Ihnen erlaubt ist. Bei Pro- oder Max-Abos sollten Sie bedenken, dass die Nutzung von Opus und Sonnet auf unterschiedliche Limits angerechnet werden kann; die Plandetails finden Sie unter Claude-Code-Preise und Claude-Preise.

Wo Pläne gespeichert werden

Claude Code schreibt Plandateien standardmäßig nach ~/.claude/plans. Um Pläne in Ihrem Repository zu behalten, etwa damit sie in einem Pull Request geprüft werden können, setzen Sie plansDirectory auf einen Pfad relativ zum Projektstamm:

{
  "plansDirectory": "./plans"
}

Claude Code weicht auf ~/.claude/plans aus, wenn der Pfad außerhalb des Projektstamms aufgelöst wird (etwa ../plans) oder, unter macOS, Linux und WSL, wenn er einen Backslash enthält. Schreiben Sie Pfade mit Schrägstrichen, die auch unter Windows funktionieren.

Plan Mode in anderen Claude-Code-Apps

• VS Code: Klicken Sie auf die Modusanzeige unten im Eingabefeld und wählen Sie Plan. Die Auswahl gilt nur für diese Unterhaltung und wird nicht als nächster Startmodus gespeichert.
• JetBrains: Das Plugin führt Claude Code im IDE-Terminal aus, Shift+Tab und das Permission-Mode-Flag funktionieren also wie in der CLI.
• Desktop-App: Wählen Sie im Code-Tab Plan im Modusauswahlfeld neben der Senden-Schaltfläche. Andere Modi werden pro Ordner gespeichert, Plan gilt aber nur für die aktuelle Sitzung.
• Claude Code im Web und mobil: Cloud-Sitzungen bieten im Modus-Dropdown Accept edits, Plan und Auto. In der mobilen App tippen Sie im Eingabefeld auf + und dann auf Permission.
• Agent SDK: Setzen Sie den Berechtigungsmodus auf plan. Claude erkundet und plant; Änderungen gehen an Ihren canUseTool-Callback, und Claude kann Rückfragen stellen, bevor es den Plan fertigstellt.

Der alte ultraplan-Befehl, der eine Planungsaufgabe an eine Cloud-Sitzung schickte, wurde entfernt. Die Befehlsreferenz von Anthropic verweist jetzt stattdessen auf den Plan Mode.

Fehlerbehebung

Shift+Tab wechselt den Modus nicht

• Versuchen Sie unter Windows Alt+M. Manche Node- oder Bun-Laufzeiten aktivieren den VT-Eingabemodus nicht, sodass das Terminal Shift+Tab nie weitergibt.
• Beobachten Sie beim Drücken die Statusleiste: Möglicherweise schalten Sie am Plan Mode vorbei. Aus dem Auto Mode sind es drei Tastendrücke bis Plan.
• Ist eine Berechtigungsabfrage offen, wirkt Shift+Tab auf die Abfrage statt die Modi durchzuschalten. Beantworten oder schließen Sie die Abfrage zuerst.
• Ältere Versionen können sich anders verhalten. Aktualisieren Sie Claude Code und versuchen Sie es erneut.

Claude fragt ständig nach der Genehmigung von Erkundungsbefehlen

Das bedeutet, dass der Auto-Mode-Klassifikator die Befehle nicht für Sie prüft: Entweder ist Auto Mode für Ihr Konto, Modell oder Ihre Organisation nicht verfügbar, oder useAutoModeDuringPlan ist auf false gesetzt. Laut Einstellungsreferenz von Anthropic kann ein Repository diese Einstellung nicht für Sie abschalten; sie liegt in Benutzer-, lokalen oder verwalteten Einstellungen. Sie können die Befehle genehmigen, Allow-Regeln für vertrauenswürdige Befehle hinzufügen oder die Verfügbarkeit von Auto Mode auf der Seite zu Berechtigungsmodi von Anthropic prüfen.

Claude hat im Plan Mode Dateien geändert

In interaktiven Terminal-Sitzungen, in denen Bypass Permissions verfügbar ist, werden die Sperren des Plan Mode nicht durchgesetzt. Wenn Sie mit einem Skip-Permissions-Flag gestartet oder bypassPermissions als Standardmodus gesetzt haben, starten Sie eine neue Sitzung ohne diese Option, wenn Sie eine garantiert rein lesende Planungsphase wollen. Außerdem darf der Plan Mode seine eigenen Plandateien schreiben, eine neue Datei in Ihrem Planverzeichnis ist also zu erwarten.

Meine Projekteinstellung startet VS Code nicht im Plan Mode

Das ist so vorgesehen: Die Erweiterung liest für ihren Startmodus nie die .claude/settings.json eines Projekts. Nutzen Sie die oben gezeigte VS-Code-Einstellung claudeCode.initialPermissionMode oder wählen Sie Plan in der Modusanzeige.

Der Plan ist zu vage oder zu lang

• Wählen Sie No, keep planning und fordern Sie Details an: „Liste jede Datei auf, die du änderst, und die Tests, die du hinzufügst“.
• Grenzen Sie die Aufgabe ein. Ein Plan pro Feature funktioniert besser als ein Plan für eine ganze Roadmap.
• Verweisen Sie Claude mit @-Dateireferenzen auf den richtigen Code, damit es keinen Kontext mit der Erkundung irrelevanter Ordner verbraucht.
• Bitten Sie Claude bei großen Codebasen, für die Recherche einen Subagent zu nutzen, damit nur die Ergebnisse in Ihrem Hauptkontext landen.

Ich habe versehentlich freigegeben

Drücken Sie Esc, um Claude mitten im Zug zu stoppen; die bisher erledigte Arbeit bleibt erhalten. Drücken Sie dann bei leerem Prompt zweimal Esc, um das Rewind-Menü zu öffnen und Code und Unterhaltung von einem früheren Punkt wiederherzustellen, oder verwerfen Sie Änderungen mit git. Drücken Sie Shift+Tab, um in den Plan Mode zurückzukehren, bevor Sie weitermachen.

Kosten und welche Pläne ihn enthalten

Der Plan Mode ist eine integrierte Funktion von Claude Code, kein kostenpflichtiges Add-on, und überall verfügbar, wo Sie Claude Code nutzen können: in Pro-, Max-, Team- und Enterprise-Abos oder mit Claude-API-Abrechnung. Planen verbraucht trotzdem Tokens, weil Claude Dateien liest und darüber nachdenkt, aber ein kurzer Plan ist meist günstiger, als eine falsche Umsetzung wegzuwerfen. Bei Enterprise-Plänen und API-abgerechneten Konten zählen laut Anthropic auch die Prüfungen des Auto-Mode-Klassifikators zur Token-Nutzung. Aktuelle Preise finden Sie unter Claude-Code-Preise und Claude-API-Preise, und was ohne Bezahlung möglich ist, unter Ist Claude kostenlos?.

Studierende und Open-Source-Maintainer können sich für vergünstigten oder kostenlosen Zugang qualifizieren: siehe Claude-Studentenrabatt und Claude for Open Source. Wenn Sie Claude Code noch nicht eingerichtet haben, beginnen Sie mit Claude Code installieren, und wenn Sie statt eines Abos einen API-Key nutzen, lesen Sie so bekommen Sie einen Anthropic-API-Key.