Zum Hauptinhalt springen

Plan-Modus

Einsteiger
What you'll learn
  • Erklären, was der Plan-Modus blockiert — und was Claude trotzdem ausführen darf
  • Den Plan-Modus auf drei verschiedene Arten betreten und verlassen
  • Die Schleife aus Untersuchen, Vorschlagen, Freigeben und Ausführen durchgehen
  • Plan-Modus und Berechtigungen auseinanderhalten und gemeinsam einsetzen

Die Grundidee​

Stell dir vor, du gibst einem Handwerker erst deinen Hausschlüssel — oder bittest ihn zuerst, einmal durchs Haus zu gehen und aufzuschreiben, was er ändern würde. Der Plan-Modus ist dieser Rundgang.

Der Plan-Modus weist Claude an, zu recherchieren und Änderungen vorzuschlagen, ohne sie vorzunehmen: Claude liest Dateien, führt Shell-Befehle zur Erkundung aus und schreibt einen Plan — bearbeitet aber deinen Quellcode nicht. Änderungen bleiben gesperrt, bis du den Plan freigibst.

Pro tip
  • Plan-Modus heißt: Claude UNTERSUCHT, ÄNDERT aber deinen Quellcode nicht — er erstellt einen Plan und wartet auf dein Okay.

Er ist nicht strikt schreibgeschützt​

Zum Erkunden braucht es manchmal einen Befehl, daher geht es im Plan-Modus um nicht bearbeiten, nicht um nicht ausführen. Was mit einem Shell-Befehl während der Planung passiert, hängt von der Sitzung ab — es gilt der erste zutreffende Fall:

Guided walkthrough1 of 3
  1. Die Sperren des Plan-Modus werden NICHT erzwungen. Claude wird weiterhin angewiesen, ohne Bearbeitung zu planen, aber eine Änderung oder ein Befehl, die es während der Planung versucht, läuft ohne Nachfrage. Überall sonst behält der Plan-Modus seine Sperren — bei headless -p-Läufen, im Agent SDK und im Chat-Panel der VS-Code-Erweiterung.
Watch out
  • Wenn du mit --allow-dangerously-skip-permissions gestartet hast, ist der Plan-Modus eine starke Anweisung statt einer harten Leitplanke. Behandle ihn als Planungskonvention, nicht als Sandbox.

Warum er der sicherste Einstieg ist​

Bei allem, was groß, riskant oder unbekannt ist, willst du sehen, was Claude vorhat, bevor es dein Repo anfasst. Der Plan-Modus trennt Denken von Tun:

Der Gewinn: Du erkennst falsche Annahmen, bevor sie zu falschem Code werden.

Wann du ihn nutzt​

Pro tip
  • IMMER bei großen oder dateiübergreifenden Änderungen, Migrationen oder Refactorings
  • Wenn du in einer Codebasis arbeitest, die du noch nicht ganz kennst
  • Wenn du einen prüfbaren Plan willst, den du mit Kolleg:innen teilen kannst

Bei winzigen, offensichtlichen Änderungen kannst du ihn überspringen — im Zweifel aber erst planen.

So läuft es in der Praxis​

Folge der Schleife. Jeder Schritt verdient den nächsten — Claude wechselt erst zum Bearbeiten, nachdem du freigegeben hast.

Guided walkthrough1 of 4
  1. Drücke Shift+Tab, um durch die Berechtigungsmodi zu schalten, bis die Statusleiste 'plan mode on' zeigt, oder stelle einem einzelnen Prompt /plan voran. Um direkt dort zu starten, starte mit claude --permission-mode plan. Beschreibe dann, was du erreichen willst.

Um den Plan-Modus zu verlassen, ohne einen Plan freizugeben, drücke erneut Shift+Tab. Um ihn für die Terminal-Sitzungen eines Projekts zum Standard zu machen, setze defaultMode in .claude/settings.json auf plan — siehe Einstellungen.

Probier es selbst aus​

Kopiere das in eine echte Planungssitzung und sieh zu, wie die Schleife abläuft:

Eine Planungssitzung starten

I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.
Kombiniere ihn mit CLAUDE.md

Eine gute CLAUDE.md macht Pläne präziser — Claude plant bereits mit deinen Konventionen und Leitplanken im Kopf.

Plan-Modus vs. Berechtigungen​

Ein Klassiker der Verwechslung. Sie lösen unterschiedliche Probleme und arbeiten zusammen:

  • Plan-Modus = „untersuchen und vorschlagen, noch nicht bearbeiten." (Diese Seite.)
  • Berechtigungen = sobald gehandelt wird: welche Aktionen ohne Nachfrage erlaubt sind.

Denk daran als ob jetzt gehandelt wird (Plan-Modus) im Gegensatz zu welche Aktionen beim Handeln erlaubt sind (Berechtigungen).

Drücke Enter oder die Leertaste, um die Karte umzudrehen. Nutze die Pfeiltasten links und rechts, um zwischen den Karten zu wechseln.Begriff angezeigt.
1 / 5
Key takeaways
  • Der Plan-Modus ist Recherchieren und Vorschlagen: Claude liest und führt Erkundungsbefehle aus, bearbeitet aber deinen Quellcode erst, wenn du den Plan freigibst
  • Er ist nicht strikt schreibgeschützt — Befehle während der Planung werden vom Classifier geprüft, per Nachfrage bestätigt oder (mit verfügbaren Bypass-Berechtigungen in einem interaktiven Terminal) komplett freigegeben
  • Betreten mit Shift+Tab, einem /plan-Präfix oder --permission-mode plan; mit der Freigabe wechselt die Sitzung in den Modus, den die gewählte Option nennt
  • Standardmäßig bei großer, riskanter oder unbekannter Arbeit nutzen; nur winzige, offensichtliche Änderungen überspringen
  • Der Plan-Modus regelt, OB jetzt gehandelt wird; Berechtigungen regeln, WELCHE Aktionen beim Handeln erlaubt sind

Teste dich selbst

0/4
  1. Was kann Claude Code im Plan-Modus tun?
  2. Wann solltest du zum Plan-Modus greifen?
  3. Wie lautet die richtige Reihenfolge der Plan-Modus-Schleife?
  4. Wie unterscheiden sich Plan-Modus und Berechtigungen?

Weiter​