· 8 Min. · Entwicklerleitfäden

Claude Code-Planungsmodus: So nutzen Sie ihn und wann er Zeit und Tokens spart

Claude Code-Planungsmodus: So nutzen Sie ihn und wann er Zeit und Tokens spart

Der Planungsmodus von Claude Code ermöglicht es Ihnen, einen Ansatz zu prüfen, bevor die Umsetzung beginnt. Dieser Leitfaden erklärt, wie Sie den Planungsmodus von Claude Code aktivieren und verlassen, ihn als Standard festlegen und entscheiden, wann Planung durch weniger unnötige Suchen und Überarbeitungsrunden Zeit und Tokens sparen kann.

Was der Planungsmodus von Claude Code bewirkt

Der Planungsmodus trennt das Vorschlagen einer Änderung von ihrer Umsetzung. Claude untersucht die Aufgabe, schlägt einen Ansatz vor und wartet auf Ihre Freigabe, damit Sie den Plan prüfen und anpassen können, bevor es weitergeht.

Das Die Nutzer-FAQ zu Claude Codevom 7. August 2026 beschreibt plan als schreibgeschützte Planung, die auf eine Freigabe wartet. Das ist hilfreich, wenn Sie prüfen möchten, ob Claude eine Aufgabe richtig verstanden hat, bevor Sie die Umsetzung erlauben.

Nur lesend bedeutet nicht ohne Tools. Claude kann während der Planung Dateien lesen und Tools mit reinem Lesezugriff verwenden. Die bis August 14, 2026 verfügbare Versionshistorie enthält eine Fehlerbehebung für Tool-Aufrufe mit reinem Lesezugriff in Sitzungen, die im Planungsmodus starten. Es wäre daher irreführend zu behaupten, dass die Planung sämtliche Befehle oder jede Untersuchung des Repositorys verhindert.

Planungsmodus und andere Berechtigungsmodi

Die Planung bestimmt, ob Claude Arbeit vorschlägt oder sie ausführt. Der für die Implementierung verwendete Berechtigungsmodus bestimmt, welche Aktionen eine Genehmigung erfordern.

Modus Dokumentiertes Verhalten Was zu beachten ist
plan Planung mit reinem Lesezugriff; wartet auf Genehmigung Verwenden Sie diesen Modus, um den Ansatz vor der Implementierung zu prüfen.
Manuell Fragt vor riskanten Änderungen oder Befehlen nach Rechnen Sie während der Implementierung mit Genehmigungsanfragen für diese Aktionen.
acceptEdits Akzeptiert Dateiänderungen automatisch; Befehle können weiterhin eine Genehmigung erfordern Dateiänderungen und Berechtigungen für Befehle sind voneinander getrennt.
auto Genehmigt Aktionen automatisch mit einer Sicherheitsprüfung im Hintergrund Die Verfügbarkeit hängt von den unterstützten Modellen und den Einstellungen der Organisation ab.

Zum Veröffentlichungsdatum lautet der angezeigte Name des früheren default Berechtigungsmodus Manuell. Version 2.1.200 führte diese Änderung des Anzeigenamens ein und akzeptierte manual neben default in den entsprechenden Konfigurations- und Befehlszeileneinstellungen.

So aktivieren und verlassen Sie den Planungsmodus

Es gibt drei praktische Möglichkeiten zur Aktivierung: Wechseln Sie während einer Sitzung durch die Berechtigungsmodi, verwenden Sie /planoder starten Sie Claude Code mit dem Flag für den Planungsmodus.

Während einer Sitzung Umschalt+Tab verwenden

Drücken Sie Umschalt+Tab zum Wechseln durch die Berechtigungsmodi, bis der Planungsmodus ausgewählt ist. Ausgehend vom üblichen Anfangszustand, der in Anthropics Leitfaden vom April 15 beschrieben wird, aktiviert das erste Drücken acceptEdits und das zweite den Planungsmodus.

Verstehen Sie „zweimal drücken“ als Beschreibung dieses Anfangszustands, nicht als allgemeingültige Regel. Ihre Sitzung kann sich bereits in einem anderen Modus befinden. Prüfen Sie daher beim Wechseln, welcher Modus ausgewählt ist.

Um den Planungsmodus zu verlassen, wechseln Sie mit Umschalt+Tab zu dem Berechtigungsmodus, den Sie für die Implementierung verwenden möchten. Prüfen Sie zuerst den Plan und führen Sie dann die vereinbarten Arbeiten in diesem Modus aus.

Direkt aktivieren mit /plan

Verwenden Sie innerhalb einer Sitzung:

/plan

Sie können die Aufgabe auch direkt angeben:

/plan fix the auth bug

Das Beschreibungsargument wurde in v2.1.72 am 10. März 2026 hinzugefügt. Es aktiviert den Planungsmodus und beginnt mit der Planung dieser Aufgabe, sodass Sie Modus und Aufgabe in einem einzigen Befehl angeben können.

Eine neue Sitzung im Planungsmodus starten

Um mit ausgewähltem Planungsmodus zu beginnen, führen Sie Folgendes aus:

claude --permission-mode plan

Das ist nützlich, wenn Sie bereits wissen, dass die Aufgabe vor der Implementierung eine Untersuchung und Prüfung erfordert. Informationen zur entsprechenden Befehlszeilennutzung finden Sie im CLI-Referenz für Claude Code.

Diese Aktivierungsmethoden führen zum selben Planungsablauf. Wählen Sie für eine laufende Unterhaltung das Tastenkürzel, /plan wenn Sie einen ausdrücklichen Befehl verwenden möchten, und das Startflag, wenn die Sitzung im Planungsmodus beginnen soll.

Einen implementierungsreifen Plan erstellen

Ein nützlicher Claude Code-Plan sollte die vorgeschlagene Änderung leicht beurteilbar machen. Geben Sie Claude genügend Kontext, um den relevanten Code zu identifizieren, und ausreichend Akzeptanzkriterien, um zu verstehen, was eine erfolgreiche Implementierung ausmacht.

Das Leitfaden zu Kontext und besseren Prompts empfiehlt, relevante Dateiverweise anzugeben und den Plan im Gespräch zu prüfen, bevor Sie den Modus wechseln und einen Schritt implementieren.

Bekannte Pfade und Akzeptanzkriterien angeben

Verweisen Sie auf Dateien mit @path/to/file wenn Sie bereits wissen, wo sich der relevante Code befindet. Laut dem Leitfaden ist es schneller und verbraucht weniger Tokens, diese Verweise anzugeben, als Claude die Dateien suchen zu lassen.

Ergänzen Sie diese Pfade um eine konkrete Definition des Erfolgs. Bei einem Authentifizierungsfehler könnten Sie beispielsweise das fehlerhafte Verhalten beschreiben, die relevanten Dateien benennen und angeben, welches Verhalten Sie nach der Fehlerbehebung erwarten. Dies ist ein Vorschlag zur Formulierung einer Aufgabe, keine Aussage über ein bestimmtes Repository.

Nützliche Angaben:

  • Das Verhalten, das geändert werden muss.
  • Relevante Dateien, die Ihnen bereits bekannt sind.
  • Vorgaben zum Umfang der Änderung.
  • Akzeptanzkriterien für die abgeschlossene Arbeit.

Ziel ist es, Unsicherheit vor der Implementierung zu verringern. Eine detaillierte Beschreibung des gewünschten Ergebnisses ist hilfreicher, als einen Plan anzufordern, ohne zu erklären, was die Änderung bewirken muss.

Den Plan vor der Genehmigung prüfen

Prüfen Sie, ob der vorgeschlagene Ansatz das gewünschte Verhalten abdeckt und innerhalb des vorgesehenen Umfangs bleibt. Prüfen Sie bei Arbeiten an mehreren Dateien, wie die Schritte zusammenpassen, bevor Sie die Änderungen freigeben.

Wenn der Plan auf einem Missverständnis beruht, korrigieren Sie es im Gespräch. Anthropic empfiehlt ausdrücklich, den Plan zu prüfen und anzupassen, bevor Sie den Modus wechseln und einen Schritt implementieren.

Die Genehmigung markiert den Übergang von der Prüfung des Ansatzes zur Implementierung. Der ausgewählte Berechtigungsmodus für die Implementierung bleibt relevant: Die Genehmigung eines Plans macht Manual, acceptEditsund auto nicht gleichwertig.

Wann Planung Zeit und Tokens spart

Der Planungsmodus von Claude Code ist besonders nützlich, wenn die frühzeitige Klärung von Unsicherheiten unnötige Implementierungsarbeit verhindern kann. Änderungen an mehreren Dateien eignen sich gut dafür, da eine falsche Annahme mehrere Teile der vorgeschlagenen Änderung betreffen kann.

Die belegten Einsparmechanismen sind konkret: Missverständnisse erkennen, bevor daraus ein umfangreicher Diff entsteht, Überarbeitungsrunden durch eine frühzeitige Definition des Erfolgs reduzieren und unnötige Dateisuchen durch die Angabe bekannter Pfade vermeiden.

Planung verwenden, wenn der Umfang geprüft werden muss

Ziehen Sie den Planungsmodus in Betracht, wenn eine Aufgabe mehrere Dateien betrifft oder Sie den Ansatz bestätigen müssen, bevor Änderungen beginnen. Die Prüfung des Plans gibt Ihnen die Möglichkeit, den Umfang einzugrenzen, Annahmen zu korrigieren oder die Reihenfolge der Arbeiten zu ändern.

Überlegen Sie bei einer kleinen, klar spezifizierten Änderung, ob eine separate Planungsrunde eine wesentliche Unsicherheit klären würde. Wenn die betroffene Datei und das erforderliche Verhalten bereits klar sind, bringt ein ausführliches Planungsgespräch möglicherweise weniger Vorteile.

Dies ist eine Einschätzung des Arbeitsablaufs, kein Benchmark. Die Recherchegrundlage belegt keinen gemessenen Schwellenwert, ab dem Planung schneller wird.

Aussagen zum Tokenverbrauch präzise halten

Die Planung fügt vor der Implementierung einen Arbeitsschritt hinzu. Ihr potenzieller Nutzen liegt darin, Arbeit zu vermeiden, die andernfalls wiederholt oder verworfen würde.

Diese Unterscheidung ist bei der Bewertung des Tokenverbrauchs wichtig. Die Angabe eines bekannten Dateipfads ist als Möglichkeit dokumentiert, Tokens bei der Suche zu sparen. Die Prüfung eines Plans kann außerdem helfen, Missverständnisse und Überarbeitungsrunden zu reduzieren. Die verfügbaren Belege quantifizieren jedoch nicht die Nettoeinsparungen des Planungsmodus.

Es gibt keinen belegten offiziellen Benchmark aus der Zeit vor dem Stichtag, der eine feste prozentuale Reduzierung von Zeit oder Tokens stützt. Ebenso belegen die bereitgestellten Quellen weder einen separaten Preis noch ein eigenes Nutzungskontingent für den Planungsmodus.

Nutzen Sie die Planung, um die Qualität des nächsten Implementierungsschritts zu verbessern, und bewerten Sie Einsparungen anhand vermiedener Suchvorgänge und Überarbeitungen. Eine weiterführende Erörterung dieses Ziels finden Sie unter So reduzieren Sie den Tokenverbrauch von Claude.

Planungsmodus, opusplanund das Leeren des Kontexts

Berechtigungsmodus und Modellauswahl sind separate Entscheidungen. Die Aktivierung des Planungsmodus legt das Planungsverhalten fest; eine Opus-Planungskonfiguration bestimmt, welches Modell diese Arbeit übernimmt.

Was opusplan bedeutet

Version 1.0.77 führte Folgendes ein: Opus-Planungsmodus in /model, wobei Opus für die Planung und ansonsten Sonnet verwendet wird. Das Änderungsprotokoll zum Stichtag im August 14, 2026 dokumentiert außerdem den opusplan Alias.

Betrachten Sie opusplan nicht als Synonym für den plan Berechtigungsmodus. Das eine betrifft die Modellauswahl für Planung und andere Arbeiten, das andere die Planung mit reinem Lesezugriff und die Genehmigung.

Die genauen Modellversionen und daraus entstehende Einsparungen hängen von der Konfiguration ab. Die bereitgestellten Belege weisen für diese Konstellation keinen festen Einsparungsprozentsatz nach. Der Claude Code-Modellleitfaden bietet die Möglichkeit, die Modellauswahl unabhängig von den Berechtigungseinstellungen zu betrachten.

Sollten Sie den Kontext vor der Implementierung leeren?

Das Leeren des Kontexts ist optional. Version 2.1.81, veröffentlicht am 20. März 2026, blendete die Option „Kontext leeren“ bei der Plangenehmigung standardmäßig aus.

Um diese Option wieder einzublenden, verwenden Sie die Einstellung:

{
  "showClearContextOnPlanAccept": true
}

Das Release Notes zu v2.1.81 dokumentieren diese Änderung. Durch das Wiedereinblenden steht die Option bei der Plangenehmigung zur Verfügung; die Belege zeigen nicht, dass das Leeren des Kontexts immer Tokens spart oder die Implementierung verbessert.

Planung als Standard festlegen

Wenn Sie einen Ansatz regelmäßig vor der Implementierung prüfen möchten, können Sie den Planungsmodus als Standard konfigurieren:

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

A Repository-Diskussion vom Juli 28, 2025 verortet diese Konfiguration in ~/.claude/settings.json.

Hier ist eine Einschränkung hinsichtlich der Quelle zu beachten: Das datierte Beispiel stammt aus einem Community-Kommentar in Anthropics offiziellem Repository. Die aktuelle offizielle Dokumentation der Berechtigungsmodi bestätigt die Konfiguration, ihr historisches Überarbeitungsdatum ist jedoch ungewiss.

Verwenden Sie das Startflag, wenn Sie die Planung für eine einzelne Sitzung aktivieren möchten. Ziehen Sie die Standardeinstellung in Betracht, wenn die vorherige Prüfung eines Plans zu Ihrem üblichen Arbeitsablauf gehört. In beiden Fällen können Sie den vorgeschlagenen Ansatz prüfen und anpassen und anschließend für die Implementierung den Modus wechseln.

Wichtige Erkenntnisse

  • Der Planungsmodus dient der schreibgeschützten Planung mit einem Freigabeschritt. Er kann Dateien prüfen und schreibgeschützte Tools verwenden, während er das Vorgehen vorbereitet.
  • Aktivieren Sie ihn mit Umschalt+Tab, /plan, oder claude --permission-mode plan; wie oft Sie die Tastenkombination drücken müssen, hängt vom Ausgangsmodus ab.
  • Geben Sie bekannte Dateipfade und Akzeptanzkriterien an, um Suchvorgänge und Überarbeitungsrunden zu reduzieren.
  • Die Planung ist besonders nützlich, um Änderungen über mehrere Dateien hinweg zu prüfen. Es gibt jedoch keinen belegten festen Prozentsatz für Zeit- oder Token-Einsparungen.
  • opusplan betrifft die Modellauswahl, während das Leeren des Kontexts eine optionale Einstellung bei der Planfreigabe ist.

FAQ

Wie aktiviere und verlasse ich den Planungsmodus mit Shift+Tab?

Drücken Sie Shift+Tab, um die Berechtigungsmodi durchzuschalten, bis der Planungsmodus ausgewählt ist. Um ihn zu verlassen, wechseln Sie zu dem Modus, den Sie für die Umsetzung verwenden möchten. Wie oft Sie drücken müssen, hängt vom aktuellen Modus der Sitzung ab.

Kann der Planungsmodus Dateien lesen oder Shell-Befehle ausführen?

Der Planungsmodus kann Dateien lesen und schreibgeschützte Tools verwenden, während er einen Plan vorbereitet. Die Aussage, dass er jeden Befehl blockiert, ist unzutreffend. Sein dokumentiertes Verhalten ist jedoch eine schreibgeschützte Planung, die vor der Umsetzung auf eine Freigabe wartet.

Wie starte ich jede Sitzung im Planungsmodus?

Setzen Sie permissions.defaultMode zu "plan" in ~/.claude/settings.json, wie in der datierten Repository-Diskussion gezeigt. Für eine einzelne Sitzung starten Sie Claude Code mit claude --permission-mode plan.

Spart der Planungsmodus Tokens?

Die Angabe bekannter Dateipfade spart Tokens bei der Suche, und das Festlegen von Akzeptanzkriterien kann Überarbeitungsrunden reduzieren. Die Planung selbst verursacht zusätzlichen Aufwand. Die Nettoeinsparungen hängen daher davon ab, welchen Aufwand sie vermeiden hilft. Die vorliegenden Belege weisen weder einen festen Prozentsatz noch einen offiziellen Vergleichswert für Nettoeinsparungen nach.

A

AI Prime Tech veröffentlicht diesen Blog. Die Artikel werden mit KI-Unterstützung verfasst; prüfen Sie versionsspezifische Angaben wie Modell-IDs, Preise und Limits anhand der offiziellen Dokumentation, bevor Sie sich darauf verlassen.

Günstigeren Zugang zur Claude API erhalten

Ein API-Schlüssel für Claude Opus 5.5, Sonnet 5, Haiku 4.5 und Fable 5.1 sowie GPT-6 Modelle. Nutzungsbasierte Abrechnung, kein Abonnement.

API-Schlüssel erhalten →
AI Prime Tech ist ein unabhängiges API-Gateway eines Drittanbieters. Claude™ und Anthropic® sind Marken von Anthropic, PBC. Eine Verbindung oder Unterstützung wird nicht impliziert.