ANLEITUNG
Claude Code Plan Mode und Subagents: erst planen, dann bauen
Im Plan Mode schaut sich Claude Code dein Projekt an und schreibt einen Plan, ändert aber keine einzige Datei, bis du den Plan freigibst. Subagents sind spezialisierte Helfer, die eine Aufgabe in ihrem eigenen Kontext erledigen und nur das Ergebnis zurückgeben. Beides zusammen ist der Unterschied zwischen „Claude macht irgendwas“ und „Claude macht, was du willst“. Hier steht, wie beides funktioniert.
Von Robin FarajStand
Das Wichtigste in Kürze
- Plan Mode starten
- Shift+Tab drücken, bis unten „plan mode on“ steht. Oder eine einzelne Nachricht mit /plan beginnen.
- Was im Plan Mode passiert
- Claude liest Dateien und erkundet das Projekt, schreibt einen Plan und ändert nichts, bis du zustimmst.
- Was Subagents sind
- Helfer mit eigenem Kontextfenster, eigenen Werkzeugen und eigener Anleitung. Sie geben nur eine Zusammenfassung zurück.
- Wo Subagents liegen
- Als Markdown-Dateien in .claude/agents/ im Projekt oder in ~/.claude/agents/ für alle Projekte.
Was ist der Plan Mode in Claude Code?
Der Plan Mode ist einer der Berechtigungsmodi von Claude Code. Claude darf darin Dateien lesen und Befehle ausführen, um das Projekt zu verstehen, aber keinen Code ändern. Am Ende legt er dir einen Plan vor: welche Dateien er anfassen will, was er ändert und warum.
Das lohnt sich vor allem bei größeren Änderungen. Wenn Claude direkt loslegt, triffst du seine Entscheidungen erst, wenn sie schon im Code stehen. Im Plan Mode siehst du sie vorher und kannst sagen: nein, die Anmeldung bitte über Supabase, nicht selbst gebaut.
So startest du den Plan Mode
- Shift+Tab
- Wechselt durch die Modi: default, dann acceptEdits, dann plan. Unten in der Statusleiste steht dann „plan mode on“. Nochmal Shift+Tab verlässt den Plan Mode ohne Freigabe.
- /plan
- Vor eine einzelne Nachricht, nur für diese eine Aufgabe.
- Beim Start
- Mit claude --permission-mode plan im Terminal.
Plan freigeben oder ändern
Wenn der Plan fertig ist, fragt Claude, wie es weitergeht: freigeben und automatisch umsetzen, freigeben und jede Änderung einzeln bestätigen, oder weiter planen. Mit Ctrl+G öffnest du den Plan in deinem Editor und kannst ihn selbst umschreiben, bevor Claude anfängt.
Mein Rat für Einsteiger: bei den ersten Projekten „jede Änderung einzeln bestätigen“ wählen. Das ist langsamer, aber du siehst, was Claude tut, und lernst dabei mehr als in jedem Tutorial.
Plan Mode als Standard
Wenn du willst, dass jede Sitzung im Plan Mode startet, trägst du ihn in den Einstellungen deines Projekts ein:
// .claude/settings.json
// Jede neue Sitzung in diesem Projekt startet im Plan Mode.
{
"permissions": {
"defaultMode": "plan"
}
}Was sind Subagents?
Ein Subagent ist ein spezialisierter Helfer, an den Claude eine Aufgabe abgibt. Er arbeitet in einem eigenen Kontextfenster, mit eigener Anleitung und nur mit den Werkzeugen, die du ihm erlaubst. Wenn er fertig ist, bekommt deine Hauptsitzung nur seine Zusammenfassung zurück, nicht die hundert Dateien, die er dafür gelesen hat.
Das hat zwei Vorteile. Deine Hauptsitzung bleibt übersichtlich, weil Suchergebnisse und Logs nicht in ihrem Kontext landen. Und du kannst Aufgaben einschränken, zum Beispiel einen Prüfer, der nur lesen und nichts ändern darf. Laut Doku kannst du Subagents auch auf ein günstigeres Modell wie Haiku legen, um Kosten zu sparen.
Die eingebauten Subagents
Claude Code bringt drei mit und nutzt sie selbstständig, wenn es passt:
- Explore
- Schnell und nur lesend, zum Durchsuchen und Verstehen eines Projekts.
- Plan
- Sammelt im Plan Mode den Kontext, bevor Claude dir den Plan vorlegt. Hier hängen Plan Mode und Subagents zusammen.
- general-purpose
- Für aufwendigere Aufgaben, die Erkunden und Umsetzen brauchen.
Eigenen Subagent anlegen
Ein Subagent ist eine Markdown-Datei mit ein paar Angaben oben und einer Anleitung darunter. Leg sie unter .claude/agents/ in deinem Projekt an, dann gilt sie für alle, die am Projekt arbeiten. Oder bitte Claude, sie dir zu schreiben. Hier ein Beispiel für einen Prüfer, der nach den typischen Fehlern von KI-gebauten Apps sucht:
---
name: app-reviewer
description: Prüft Änderungen an der App auf Fehler, Sicherheitslücken und vergessene Randfälle. Nach jeder größeren Änderung einsetzen.
tools: Read, Glob, Grep
model: sonnet
---
Du prüfst Code einer React-Native-App. Achte besonders auf:
- API-Schlüssel oder Passwörter im Code der App
- Logins oder Bezahlungen, die nur so tun als ob
- Daten, die nur auf dem Handy gespeichert werden
Antworte mit einer kurzen Liste: Problem, Datei, Vorschlag.So rufst du einen Subagent auf
- Automatisch
- Claude vergleicht deine Anfrage mit der description jedes Subagents. Steht dort „nach jeder größeren Änderung einsetzen“, nutzt er ihn von selbst häufiger.
- Per Name
- Zum Beispiel: „Lass den app-reviewer über die letzte Änderung schauen.“
- Mit @
- Tipp @ und wähl den Subagent aus. Dann läuft er garantiert.
Kostet der Plan Mode mehr?
Kaum. Claude liest im Plan Mode Dateien, die er sonst auch lesen würde, nur eben vor dem Schreiben statt währenddessen. Oft spart es sogar, weil weniger falsche Änderungen später wieder rückgängig gemacht werden müssen. Was dein Abo hergibt, steht unter Claude Abo im Vergleich.
Was ist der Unterschied zwischen Subagents und Skills?
Ein Skill ist eine Anleitung, die Claude in deiner aktuellen Sitzung lädt, wenn eine Aufgabe dazu passt. Ein Subagent ist ein eigener Helfer mit eigenem Kontext, der eine Aufgabe abarbeitet und nur das Ergebnis zurückgibt. Kurz gesagt: Ein Skill bringt Claude etwas bei, ein Subagent erledigt etwas für ihn.
Der Kurs dazu, auf Deutsch
Wenn du es lieber gezeigt bekommst, als es zu lesen: einmal komplett von der Idee bis zur App auf deinem Handy, als Videokurs auf Deutsch und ohne Vorkenntnisse.
Weitere Anleitungen auf Deutsch
Zum Weiterlesen (englisch)
Wenn du mit einer Vorlage starten willst
NativeExpress kostet einmal 229 Dollar. Du bekommst den kompletten Code und jede künftige Version. Den Support mache ich selbst, per Discord oder E-Mail, gern auch auf Deutsch.