Worktrees und parallele Entwicklung
An mehreren Features gleichzeitig arbeiten, ohne Konflikte
⏱ ca. ~5 Min
01 · Lesen
Was, wenn du an zwei Features gleichzeitig arbeiten könntest, ohne dass sie sich gegenseitig auf die Füße treten? Normalerweise hat dein Projekt einen Branch und einen Satz Dateien. Du steckst mittendrin in der Auth-Umsetzung, ein kritischer Bug kommt rein — du musst deine Arbeit stashen, den Branch wechseln und verlierst den Rhythmus.
Git-Worktrees lösen das. Ein Worktree ist ein separates Arbeitsverzeichnis, das die Git-Historie deines Hauptprojekts teilt. Jeder Worktree hat seinen eigenen Branch und seine eigenen Dateien. Claude Code hat eingebaute Worktree-Unterstützung — du startest isolierte Arbeitsbereiche mit einem einzigen Flag.
💡 Stell dir das so vorStell dir vor, dein Büro hat zwei Schreibtische statt einem. Jeder Schreibtisch hat seine eigene Kopie der Dokumente, an denen du arbeitest, aber beide sind mit demselben Aktenschrank verbunden (der Git-Historie). Du kannst an Schreibtisch 1 ein Feature bauen und an Schreibtisch 2 einen Bug fixen, ohne je Papier zwischen ihnen hin- und herzuschieben.
Kernpunkte
- Worktrees sind separate Arbeitsverzeichnisse, die dasselbe Git-Repo teilen
- Jeder Worktree hat seinen eigenen Branch und seine eigenen Dateien
- Kein Stashen, kein Branch-Wechseln, kein Rhythmusverlust
- Claude Code erstellt Worktrees automatisch mit --worktree
02 · Code-Beispiel
Erstelle einen Worktree mit dem --worktree-Flag. Jeder hat seinen eigenen Branch und sein eigenes Verzeichnis.
Einen Worktree erstellen
# Start a Claude session in an isolated worktree
claude --worktree feature-auth
# Start another session for a bug fix
claude --worktree bugfix-login
# Auto-generate a random worktree name
claude --worktree
Was im Hintergrund passiert
Worktree location: .claude/worktrees/feature-auth/
Branch created: worktree-feature-auth
Files: Full copy of your project
Git history: Shared with main repo
Jeder Worktree bekommt sein eigenes Verzeichnis unter .claude/worktrees/ und seinen eigenen Git-Branch. Zwei Claude-Sessions können gleichzeitig Dateien editieren, ohne sich in die Quere zu kommen. Wenn du fertig bist, werden Worktrees ohne Änderungen automatisch aufgeräumt.
03 · Lesen
Worktrees sind besonders stark für parallele Claude-Sessions. Hier ist ein typischer Ablauf:
1. Du baust ein Feature im Hauptverzeichnis 2. Ein Bug-Report kommt rein — claude --worktree bugfix-123 3. Die Bugfix-Session arbeitet unabhängig in ihrer eigenen Kopie 4. Bug gefixt, Bugfix-Branch zurück nach main mergen 5. Du machst mit deinem Feature weiter, ohne einen Takt zu verpassen
Du kannst Worktrees auch in Subagents nutzen. Wenn du isolation: worktree ins SKILL.md-Frontmatter eines Subagents schreibst, arbeitet er automatisch in seinem eigenen Worktree — ideal für Aufgaben, die Dateien editieren, dein Hauptverzeichnis aber nicht beeinflussen sollen.
Kernpunkte
- Mehrere Claude-Sessions parallel laufen lassen, jede in ihrem eigenen Worktree
- Worktree-Branch nach Abschluss zurückmergen
- Subagents können Worktrees mit isolation: worktree nutzen
- .claude/worktrees/ in die .gitignore aufnehmen
04 · Lesen
Für wirklich große Änderungen — Funktion über 100 Dateien hinweg umbenennen, eine API migrieren — bietet Claude Code den /batch-Befehl. Er zerlegt deine Aufgabe in unabhängige Einheiten, erzeugt für jede einen Subagent und lässt jeden in seinem eigenen Worktree arbeiten.
Jeder Subagent erstellt einen Draft Pull Request für seinen Anteil. Du reviewst, mergst die guten und iterierst bei den anderen. So gehen Profis mit großen Refactorings um — in unabhängige, reviewbare Einheiten zerlegt.
Kernpunkte
- /batch zerlegt große Aufgaben in unabhängige Einheiten
- Jede Einheit bekommt ihren eigenen Worktree und ihren eigenen Subagent
- Jede erstellt einen Draft-PR für das Review
- Ideal für großflächige Refactorings und Migrationen
05 · Quiz
Was passiert, wenn eine Claude-Worktree-Session ohne uncommittete Änderungen endet?
- Der Worktree wird automatisch aufgeräumt
- Der Worktree bleibt für immer, bis du ihn manuell löschst
- Claude bittet dich vorm Schließen um einen Commit
- Der Worktree wird in ein Backup-Verzeichnis verschoben
06 · Ziehen zum Sortieren
Bring die Schritte des parallelen Worktree-Workflows in die richtige Reihenfolge.
(Diese Sektion ist interaktiv — aktiviere JavaScript, um sie zu nutzen.)
Andere Lektionen aus diesem Kapitel
⚠ Das volle interaktive Erlebnis braucht JavaScript. Bitte aktiviere es und lade die Seite neu.
※ Diese Seite ist ein unabhängiges Bildungsprojekt — kein offizielles Anthropic-Produkt. Claude™ ist eine eingetragene Marke von Anthropic, PBC.