Wird geladen

Claude Code parallelisieren

Lektion 613 Min.
Wird geladen

Mehrere Instanzen von Claude Code parallel laufen zu lassen, ist einer der größten Produktivitätsgewinne, die du erzielen kannst. Da Claude leichtgewichtig ist, kannst du problemlos mehrere Kopien starten, jeder eine andere Aufgabe zuweisen und sie gleichzeitig arbeiten lassen. Das verschafft dir effektiv ein Team virtueller Softwareentwickler, die an deinem Projekt arbeiten.

Die Herausforderung: Dateikonflikte

Das Hauptproblem bei parallelen Instanzen besteht darin, dass sie versuchen könnten, dieselben Dateien gleichzeitig zu ändern. Das kann zu widersprüchlichem oder ungültigem Code führen, da jede Instanz nicht weiß, was die anderen gerade tun.

Drei Claude-Code-Instanzen arbeiten an einem Projekt: „Add logging“, „Support .pptx files“, „Investigate failing test“.

Die Lösung besteht darin, jeder Claude-Instanz einen eigenen, separaten Arbeitsbereich zu geben. Jede Instanz arbeitet mit ihrer eigenen Kopie deines Projekts, nimmt Änderungen isoliert vor und führt diese Änderungen anschließend wieder mit deinem Hauptprojekt zusammen.

Vier Claude-Code-Instanzen, jede mit ihrer eigenen Kopie deines Projekts, für Aufgaben wie „Define a resource“ und „Add logging“.

Git Worktrees

Git Worktrees eignen sich perfekt für diesen Workflow. Wenn dein Projekt bereits mit Git verwaltet wird, kannst du Worktrees sofort nutzen. Sie sind wie eine Erweiterung der Branching-Funktionalität von Git, mit der du vollständige Kopien deines Projekts in separaten Verzeichnissen auf deinem Rechner erstellen kannst.

Branch feature_a in Ordner Eins und feature_b in Ordner Zwei, jeweils mit derselben main.py, tools/document.py und tools/math.py.

Jedes Worktree entspricht einem separaten Branch. Du kannst einen Ordner für Feature A und einen anderen für Feature B haben, jeder mit einer vollständigen Kopie deiner Codebasis. Dann führst du in jedem Worktree separate Claude-Code-Instanzen aus, die vollständig isoliert arbeiten.

Diagramm der feature_a- und feature_b-Worktree-Branches, jeweils mit einem Commit, die wieder in den Main-Branch zusammengeführt werden.

Sobald jede Claude-Instanz ihr Feature fertiggestellt hat, committest du die Arbeit und führst sie wieder in deinen Main-Branch zusammen, genau wie beim Zusammenführen eines normalen Git-Branches.

Prompt, um ein Worktree namens feature_a im .trees-Ordner zu erstellen, abzubrechen, falls es bereits existiert, .venv zu verlinken und VS Code zu starten.

Automatisierung der Worktree-Erstellung

Das klingt vielleicht kompliziert zu verwalten, aber du kannst den gesamten Workflow an Claude Code selbst delegieren. Du kannst einen Prompt schreiben, der Claude bittet:

  1. Ein neues Git-Worktree in einem bestimmten Ordner zu erstellen
  2. Abhängigkeiten zu verlinken, die nicht von Git verfolgt werden
  3. Eine neue VS-Code-Instanz in diesem Verzeichnis zu starten

Prompt, um ein Worktree namens feature_a in .trees zu erstellen: abbrechen, falls es bereits existiert, .venv verlinken, VS Code mit „code“ starten.

Benutzerdefinierte Befehle

Anstatt lange Prompts jedes Mal zu kopieren und einzufügen, kannst du in Claude Code benutzerdefinierte Slash-Befehle erstellen. Füge eine .md-Datei zu .claude/commands hinzu, um einen benutzerdefinierten Befehl zu erstellen.

Ein zweites VS-Code-Fenster namens feature_a, in dem Claude Code in der Worktree-Kopie der Projektdateien läuft.

Der benutzerdefinierte Befehl kann auf $ARGUMENTS verweisen, das durch die Argumente ersetzt wird, die du deinem Befehl übergibst. Zum Beispiel:

  • /project:create_worktree feature_a erstellt ein Worktree namens „feature_a“
  • /project:create_worktree develop erstellt ein Worktree namens „develop“

Parallele Entwicklung in der Praxis

So sieht der vollständige Workflow in der Praxis aus. Du kannst mehrere Worktrees für verschiedene Features erstellen:

Vier VS-Code-Fenster mit denselben Projektdateien, beschriftet mit „Document tests“, „Add Logging“, „Add notes tool“, „Add math tool“.

Jede Claude-Instanz arbeitet an ihrer zugewiesenen Aufgabe:

  • Dokumenttests aktualisieren
  • Logging hinzufügen
  • Werkzeuge zur Notizverwaltung hinzufügen
  • Ein Subtraktionswerkzeug hinzufügen

Prompt, um das $ARGUMENTS-Worktree in .trees/$ARGUMENTS zusammenzuführen, unter Verwendung von Befehlen wie „git status“, um Merge-Konflikte aufzulisten.

Änderungen zusammenführen

Wenn die Features fertig sind, kannst du auch den Merge-Prozess automatisieren. Erstelle einen weiteren benutzerdefinierten Befehl, der Claude anweist:

  1. In das Worktree-Verzeichnis zu wechseln
  2. Den letzten Commit zu untersuchen
  3. Zurück ins Root-Verzeichnis zu wechseln
  4. Den Worktree-Branch zusammenzuführen
  5. Eventuelle Merge-Konflikte automatisch zu beheben

VS Code mit create_worktree.md und merge_worktree.md in .claude/commands, und Claude Code, das im Terminal läuft.

Claude kann Merge-Konflikte sogar automatisch auflösen, basierend auf seinem Verständnis der in jedem Branch vorgenommenen Änderungen.

Ergebnisse

Dieser Ansatz skaliert auf so viele parallele Instanzen, wie du verwalten kannst. Anstatt Features nacheinander zu bearbeiten, kannst du mehrere Claude-Instanzen haben, die gleichzeitig an verschiedenen Teilen deines Projekts arbeiten. Es ist, als hättest du dein eigenes Team von Entwicklern, von denen jeder in seiner eigenen isolierten Umgebung arbeitet, bevor die Arbeit zusammengeführt wird.

Die Produktivitätsgewinne sind erheblich – im Grunde multiplizierst du deine Entwicklungskapazität mit der Anzahl der parallelen Instanzen, die du ausführst.