Plan Mode¶

Plan Mode lässt Claude erst einen strukturierten Plan erstellen, bevor Änderungen durchgeführt werden.

Konzept¶

Statt direkt loszulegen:

Analyse - Claude analysiert die Aufgabe
Plan erstellen - Strukturierter Schritt-für-Schritt Plan
Review - Du prüfst und kommentierst den Plan
Ausführung - Erst nach Approval wird ausgeführt

Aktivierung¶

Beim Start¶

claude --plan

Oder mit konkretem Task:

claude -p --plan "Refactor the authentication module"

Im laufenden Session¶

Mit Shift+Tab durch die Modi wechseln:

Normal Mode → Auto-Accept Mode → Plan Mode → Normal Mode

Anzeige im Terminal: - Normal: ⏵ - Auto-Accept: ⏵⏵ accept edits on - Plan Mode: ⏸ plan mode on

Per Slash-Command¶

/plan Implement user profile feature

Plan-Struktur¶

Ein typischer Plan sieht so aus:

## Plan: User Profile Feature

### Phase 1: Database
1. Create migration for user_profiles table
2. Add columns: bio, avatar_url, social_links

### Phase 2: API
3. Create GET /api/profile/:id endpoint
4. Create PUT /api/profile endpoint
5. Add validation middleware

### Phase 3: Frontend
6. Create ProfilePage component
7. Add profile edit form
8. Integrate with API

### Phase 4: Testing
9. Unit tests for API endpoints
10. Integration tests for profile flow

Estimated files: 12
Estimated time: 45 minutes

Plan Review¶

Inline-Kommentare (VS Code)¶

In VS Code öffnet sich der Plan als Markdown-Dokument. Du kannst:

Inline-Kommentare hinzufügen
Schritte streichen oder umformulieren
Prioritäten ändern

Terminal-Feedback¶

Looks good, but skip the social_links for now. 
Start with Phase 2, we already have the DB schema.

Claude passt den Plan an und fragt erneut nach Approval.

Wann Plan Mode nutzen?¶

Situation	Plan Mode?
Großes Refactoring	✅ Ja
Neue Feature-Entwicklung	✅ Ja
Architektur-Entscheidungen	✅ Ja
Kleiner Bugfix	❌ Overkill
Typo-Korrektur	❌ Nein
Explorative Analyse	❌ Nein

Headless Plan Mode¶

Für CI/CD oder Scripting:

claude -p --plan --output-format json "Analyze security vulnerabilities"

Output:

{
  "plan": {
    "steps": [...],
    "estimated_changes": 5,
    "risk_assessment": "low"
  }
}

Best Practices¶

Bei Unsicherheit - Wenn du nicht sicher bist was Claude tun wird → Plan Mode
Für Reviews - Plan Mode Output eignet sich gut für Team-Review vor Ausführung
Iterativ verfeinern - Gib Feedback, lass den Plan anpassen, dann erst ausführen
Kombinieren mit --dry-run - Plan erstellen, dann mit --dry-run simulieren

Konfiguration¶

Default Mode setzen¶

In ~/.claude/settings.json:

{
  "defaultPermissionMode": "plan"
}

Optionen: - normal - Standard, fragt bei jeder Änderung - auto-accept - Keine Bestätigung nötig - plan - Immer erst planen

VS Code Default¶

In VS Code Settings:

{
  "claudeCode.initialPermissionMode": "plan"
}

Plan Mode vs Normal Mode¶

Aspekt	Normal Mode	Plan Mode
Geschwindigkeit	Schneller	Langsamer
Kontrolle	Per-Action	Upfront
Überraschungen	Möglich	Minimal
Geeignet für	Kleine Tasks	Große Changes
Learning	Gut zum Lernen	Gut zum Überprüfen