Wie ich mehrere Claude Code-Agenten parallel ausführe
Drei Agenten. Ein Repo. Null Konflikte.
Dieser Satz hätte mir vor sechs Monaten absurd geklungen. Ich hatte Claude Code schon eine Weile auf persönlichen Projekten betrieben, und jedes Mal, wenn ich einen zweiten Agenten für ein anderes Feature starten wollte, stieß ich gegen dieselbe Wand — Git-Konflikte, schmutzige Arbeitsverzeichnisse, Agenten, die gegenseitig ihre Änderungen überschrieben.
Dann lieferte Anthropic eingebaute Git Work Tree-Unterstützung für Claude Code. Und ehrlich gesagt? Das veränderte grundlegend, wie ich Software mit KI-Agenten baue.
Dieses eine Feature verwandelte meinen Workflow von "ein Agent, der Dinge sequenziell erledigt" zu "drei Agenten, die gleichzeitig an drei verschiedenen Features arbeiten, jeder in seiner eigenen isolierten Sandbox, und sauber zusammengeführt werden, wenn sie fertig sind."
Aber hier ist, was niemand über Work Trees in Claude Code sagt: Das Standardverhalten hat einen subtilen Fallstrick, der deine Commits direkt zu main schicken kann, wenn du glaubst, sie gehen zu einem Feature-Branch. Ich entdeckte das um 1 Uhr morgens an einem Dienstag.
Warum dein Single-Agent-Workflow dich zurückhält
Du wartest. Du beendest zuerst die Auth-Middleware, commitest sie, dann das Schema, dann den Bugfix. Alles passiert sequenziell, weil Git dir nur erlaubt, einen Branch gleichzeitig in einem einzigen Arbeitsverzeichnis ausgecheckt zu haben.
Git Work Trees lösen das auf Infrastrukturebene.
Git Work Trees — das Feature, das du ignoriert hast
Ein Git Work Tree ist ein separates Arbeitsverzeichnis, das mit demselben Git-Repository verknüpft ist. Stell dir vor, du hast mehrere gleichzeitig ausgecheckte Versionen deines Repos — jede auf einem anderen Branch, jede mit ihrem eigenen Dateisystem.
Sie sind keine separaten Klone. Das ist der kritische Teil. Sie teilen dasselbe .git-Verzeichnis, was bedeutet, dass sie alle Branches, Commits und Objektspeicher teilen.
Der Work Tree-Fallstrick, der mich fast zu einem Produktions-Push trieb
Wenn Claude Code automatisch einen Work Tree erstellt, wird der Branch automatisch auf denselben wie das primäre Verzeichnis gesetzt, es sei denn, du gibst explizit einen neuen Branch an.
Die Lösung:
git worktree add .claude/worktrees/feature-auth -b feature/auth
git worktree add .claude/worktrees/fix-login -b fix/login-validation
git worktree add .claude/worktrees/update-tests -b chore/update-tests
Das -b-Flag erstellt einen neuen Branch und checkt ihn im Work Tree aus.
Das vollständige Setup: von Null zu drei parallelen Agenten
Schritt 1: Work Tree-Verzeichnis konfigurieren
mkdir -p .claude/worktrees
echo ".claude/worktrees/" >> .gitignore
Schritt 2: Work Trees für jede Aufgabe erstellen
git worktree add .claude/worktrees/feature-auth -b feature/auth
git worktree add .claude/worktrees/fix-login -b fix/login-validation
git worktree add .claude/worktrees/update-tests -b chore/update-tests
Schritt 3: Agenten parallel ausführen
Jeder Agent arbeitet vollständig unabhängig. Er kann Dateien lesen, Dateien schreiben, Tests ausführen, Commits erstellen — alles ohne zu wissen, dass die anderen Agenten existieren.
Schritt 4: Jeden Branch überprüfen und pushen
cd .claude/worktrees/feature-auth
git log --oneline -5
git diff HEAD~1
git push -u origin feature/auth
Schritt 5: Pull Requests erstellen
gh pr create --title "Add authentication middleware" --body "Implemented JWT auth..."
Schritt 6: Zusammenführen und aufräumen
git checkout main && git pull
git worktree remove .claude/worktrees/feature-auth
git worktree remove .claude/worktrees/fix-login
git worktree remove .claude/worktrees/update-tests
Sub-Agenten: die nächste Parallelisierungsebene
Work Trees lösen das Isolationsproblem. Sub-Agenten lösen das Orchestrierungsproblem.
Du startest einen "Orchestrator" Claude Code-Session — den Haupt-Agenten, der das große Bild versteht. Der Orchestrator analysiert die Aufgaben und bestimmt, welche parallel laufen können. Dann spawnt er Sub-Agenten, jeden einem spezifischen Work Tree mit einer spezifischen Aufgabe zugewiesen.
CLAUDE.md in jedem Work Tree
Du kannst work tree-spezifische Anweisungen hinzufügen:
# Work Tree: Feature Auth
## Aufgabe
JWT-Authentifizierung für die API implementieren
## Umfang
Nur an Auth-Middleware und Routes arbeiten. Nicht anfassen:
- Frontend-Komponenten
- Datenbankmigrationen (separater Agent aktiv)
- Tests (separater Agent aktiv)
Die Ergebnisse nach drei Monaten
- Zeit-bis-erstem-Commit pro Feature: Ca. 60% reduziert
- Git-Verlaufsqualität: Deutlich verbessert
- Code-Review-Zeit: 40% reduziert
- Eingeführte Bugs: Reduziert
Meine Herausforderung an dich
Das nächste Mal, wenn du mit Claude Code an einem Projekt sitzt, identifiziere zwei vollständig unabhängige Aufgaben. Erstelle zwei Work Trees. Führe beide gleichzeitig aus.
Dieser erste Moment — zu sehen, wie zwei Features parallel entstehen, während du deinen Kaffee trinkst — ist der Moment, in dem der Workflow klickt. Und sobald er klickt, gehst du nicht mehr zurück.
