Nethür
Anmelden
macOS demnächst

Blog · 3. November 2026

So führst du mehrere Claude-Code-Agenten parallel aus

Ein Praxisguide für parallele Claude-Code-Sessions: warum ein einziger Checkout nicht mitspielt, wie git worktrees das lösen und wie du mehrere Agenten reviewbar hältst.

Nethür-Arbeitsbereich mit mehreren Agenten-Sessions, die nebeneinander laufen

Eine Claude-Code-Session ist innerhalb eines Checkouts single-threaded: Sie liest und schreibt die Dateien in dem Verzeichnis, in dem du sie gestartet hast. Um mehrere Claude-Code-Agenten parallel auszuführen, gib jedem einen eigenen git worktree — einen separaten Checkout auf einem eigenen Branch — und starte in jedem eine Claude-Code-Instanz. Verwaltete Tools wie Nethür übernehmen die Arbeit rund um Worktrees, Terminals und Reviews.

Eine Claude-Code-Session ist beeindruckend — bis zu dem Moment, in dem du drei Änderungen gleichzeitig brauchst. Der übliche Reflex: drei Terminal-Tabs im selben Repository öffnen. Das funktioniert ein paar Minuten, dann bearbeiten zwei Agenten dieselbe Datei, einer wechselt den Branch unter dem anderen weg, und dein Testlauf liest plötzlich einen Checkout, den es nicht mehr gibt.

Parallele Agenten sind kein Prompt-Problem. Sie sind ein Dateisystem-Problem. Claude Code arbeitet über ganz normale Dateien, deshalb brauchen zwei Sessions zwei Arbeitsverzeichnisse, die sich weder Branch noch Index teilen.

Warum Terminal-Tabs keine parallele Arbeit sind

Ein git-Repository hat pro Working Tree genau einen ausgecheckten Branch. Öffnest du zwei Claude-Code-Sessions in diesem Tree, teilen sie alles: dieselben Dateien, denselben Index, dieselben node_modules, denselben Port für den Dev-Server. Die Sessions wirken unabhängig, weil die Terminals unabhängig sind — der Code darunter ist es nicht.

  • Ein Agent führt git switch oder git rebase aus, während der andere weiter die alten Dateien bearbeitet.
  • Zwei Agenten schreiben dieselbe Datei; der letzte Speichervorgang gewinnt und die erste Änderung verschwindet aus dem Working Tree.
  • Ein Test-Watcher, Dev-Server oder eine Migration läuft gegen den Branch, der in dem Moment gerade ausgecheckt war.
  • Das Ergebnis zu reviewen ist Raterei, weil der Diff Arbeit aus allen Sessions gleichzeitig enthält.

Tabs sind weiterhin nützlich für reine Lese-Erkundung, Log-Tailing oder eine schnelle Frage. Sobald ein Agent Dateien bearbeiten und Tests ausführen soll, hört der Nutzen auf.

Drei praktische Wege zu parallelen Sessions

Es gibt drei Optionen, die sich lohnen. Sie unterscheiden sich darin, wie viel Isolation sie dir geben und wie viel Buchhaltung sie dir überlassen.

  1. Terminal-Tabs in einem Checkout — schnell gestartet, unsicher bei gleichzeitigen Änderungen.
  2. Manuelle git worktrees plus eine Claude-Code-Instanz pro Worktree — echte Isolation, aber du kümmerst dich um Pfade, Abhängigkeiten und Aufräumen.
  3. Ein Arbeitsbereich wie Nethür, der Worktrees anlegt und verfolgt, in jedem einen Agenten ausführt und Diffs und Sessions an einem Ort bündelt.

Option 1: git worktrees selbst anlegen

Ein git worktree ist ein zweiter Checkout desselben Repositorys, auf einem eigenen Branch, in einem eigenen Verzeichnis. Git teilt die Objektdatenbank, deshalb ist die Kopie günstig — aber Dateien und Index sind unabhängig.

git fetch origin
git worktree add ../shop-fix-login -b fix/login origin/main
git worktree add ../shop-fix-billing -b fix/billing origin/main

cd ../shop-fix-login && claude
# second terminal
cd ../shop-fix-billing && claude

Jetzt sieht jede Claude-Code-Instanz ein anderes Verzeichnis und einen anderen Branch. Du kannst den einen die Race Condition beim Login beheben lassen, während der andere die Abrechnung umschreibt, und keiner kann die Dateien des anderen überschreiben.

Der Haken ist alles, was ein neuer Checkout nicht hat. Abhängigkeiten fehlen, .env-Dateien fehlen, und beide Sessions versuchen womöglich, denselben Port zu belegen. Entweder installierst du in jedem Worktree neu oder du teilst die schweren, gitignorierten Verzeichnisse. Nethür beschreibt dasselbe Problem und seine eigenen Antworten im Worktree-Guide: geteilte Pfade, nethur.yaml-Einträge, .worktreeinclude und Setup-Hooks.

Option 2: die parallelen Funktionen von Claude Code selbst nutzen

Claude Code bekommt laufend neue Wege, mehr als einen Arbeitsstrang laufen zu lassen. Die Desktop-App kann parallele Sessions in isolierten git worktrees ausführen, und Subagenten sowie Agenten-Teams erlauben es einer Session, Teile einer Aufgabe zu delegieren. Wenn du komplett in Anthropics Produkt lebst und allein arbeitest, kann das reichen.

Diese Funktionen bleiben aber auf Claude beschränkt. Sie geben dir keinen Arbeitsbereich, in dem Claude Code, Codex und andere CLI-Agenten nebeneinander laufen, und sie geben Teammitgliedern keinen gemeinsamen Ort, an dem sie die Sessions der anderen sehen und übernehmen können. Wenn deine parallele Arbeit Agenten, Maschinen oder Personen überschreitet, brauchst du eine Ebene über dem Agenten.

Option 3: ein Arbeitsbereich, der die Worktrees für dich führt

Nethür ist um die Idee herum gebaut, dass eine Aufgabe einen Arbeitsbereich bekommt, keinen Tab. Jeder Worktree ist ein echter git worktree mit eigenem Branch, eigenen Dateien, Terminals, Editor-Tabs und Browser-Tabs. Das Anlegen ist ein kurzer Dialog, und die git-Arbeit passiert im Hintergrund.

  1. Installiere Nethür und füge das Repository hinzu. Für ein Team wählst du die Maschine, die die Arbeit hostet — dein Laptop, der Rechner eines Teammitglieds, ein VPS oder ein SSH-Ziel.
  2. Lege für jede parallele Aufgabe einen Worktree an. Benenne ihn nach der Aufgabe, wähle den Start-from-Ref (meist origin/main) und verknüpfe ein GitHub-, GitLab-, Linear- oder Jira-Item, falls es eines gibt.
  3. Öffne in jedem Worktree den Agenten-Picker und starte Claude Code. Nethür startet ihn mit diesem Worktree als Arbeitsverzeichnis, sodass sich die beiden Sessions nicht in die Quere kommen.
  4. Teile die Panes auf oder wechsle zwischen Worktrees, während die Agenten laufen. Die Sidebar zeigt, welche Sessions arbeiten, warten oder fertig sind.
  5. Reviewe jeden Diff gegen seinen eigenen Start-from-Ref. Behalte den Gewinner, committe und pushe, öffne den Pull Request aus diesem Worktree — und lösche dann die unterlegenen Worktrees samt ihrer Branches.

Der wichtige Unterschied ist nicht der Button, der einen Worktree anlegt. Es ist, dass Worktree, Agenten-Session, Diff und Aufräumen an derselben Aufgabe hängen bleiben. Das Rezept für parallele Agenten führt durch denselben Ablauf, mit Screenshots und einem Beispiel mit drei Agenten.

Welcher Ansatz zu deiner Arbeit passt

AnsatzDatei-IsolationEinrichtungReviewTeam
Tabs in einem CheckoutKeine — geteilte Dateien und BranchSofortGemischter Diff, manuelles EntwirrenKeine gemeinsame Sicht
Manuelle git worktreesVollständig — ein Branch pro Worktreegit-Befehle, Abhängigkeiten, Env-DateienEin Diff pro Verzeichnis, von HandPfade werden im Chat herumgereicht
Claude Code DesktopVollständig für Claude-SessionsInstallieren und anmeldenIntegriertes Review für ClaudeOberfläche für einzelne Nutzer
NethürVollständig — git worktree oder Ordner-ArbeitsbereichRepo hinzufügen, Worktree anlegenDiffs pro Worktree, Anmerkungen, PR-FlowGemeinsame Projekte, Chat, Übernahmen

Vier Muster, die Parallelität gut nutzen

  • Dieselbe Aufgabe, drei Agenten. Gib Claude Code, Codex und einem weiteren CLI in drei Worktrees denselben Prompt. Vergleiche die Diffs, statt nacheinander neu zu versuchen; Uneinigkeit zeigt meist auf den schwierigen Teil.
  • Nach Oberfläche aufteilen. Ein Agent übernimmt die API-Änderung, einer die UI, einer schreibt die Tests. Verknüpfe dasselbe Issue mit jedem Worktree, damit der Kontext sichtbar bleibt.
  • Implementieren und reviewen. Ein Agent macht die Änderung, ein zweiter liest in einem separaten Worktree den Diff und sucht nach Regressionen. Du bleibst der Tie-Breaker.
  • Erkunden und ausliefern. Halte eine lang laufende Recherche-Session in einem Worktree und eine saubere Implementierungs-Session in einem anderen. Der Recherche-Agent macht den Branch, den du gleich mergen willst, nie schmutzig.

Stolperfallen, für die du planen solltest

  • Abhängigkeiten und lokale Secrets. Ein neuer Worktree ist ein sauberer Checkout. Teile node_modules und Caches, kopiere .env-Dateien mit .worktreeinclude oder führe nach dem Anlegen einen Setup-Hook aus.
  • Ports und Datenbanken. Zwei Dev-Server auf 3000 streiten sich. Gib jedem Worktree einen eigenen Port und, wenn möglich, eine eigene Datenbank oder ein eigenes Schema.
  • Generierte Dateien und Migrationen. Führe keine zwei Migrationen gegen dieselbe Datenbank aus, es sei denn, das Tooling ist dafür gebaut.
  • Token-Budget. Parallelität vervielfacht den Verbrauch. Starte mit zwei oder drei Sessions, behalte die Usage-Meter im Blick und stoppe die, die nur warten.
  • Aufräum-Schulden. Jeder Worktree ist ein Branch. Lösche die Verlierer, sobald du einen Gewinner gewählt hast, sonst füllt sich das Repository mit aufgegebenen Experimenten.

Parallele Arbeit wird mit Menschen schwieriger

In dem Moment, in dem zwei Entwickler Agenten im selben Projekt laufen lassen, wird aus dem Dateisystem-Problem ein Koordinationsproblem. Wessen Worktree liegt auf welchem Branch? Wer wartet auf ein Review? Kann jemand eine Session übernehmen, wenn der Autor offline geht?

Nethür löst das mit gemeinsamen Projekten und einem Team-Server: Alle verbinden sich mit demselben Arbeitsbereich, sehen die aktiven Sessions, @mentionen sich neben der Arbeit und können eine Session übernehmen, ohne ein Transkript zu kopieren. Jede Person meldet sich weiterhin mit ihrem eigenen Claude-Abo an; es gibt keinen gemeinsamen Key, der rotiert werden muss. Der Team-Guide deckt die Einrichtung ab.

Starte mit zwei Worktrees

Nimm dir eine Aufgabe, für die du normalerweise zwei Claude-Code-Läufe nacheinander bräuchtest. Lege zwei Worktrees vom selben Ref an, gib beiden Agenten denselben Prompt und vergleiche, was zurückkommt. Dieses eine Experiment sagt dir mehr über parallele Arbeit als jeder Benchmark: Du siehst den Isolationsgewinn, die Reibung bei Abhängigkeiten und die Review-Kosten in deinem eigenen Repository.

Wenn es funktioniert, behalte den Gewinner-Branch und lösche den anderen Worktree. Dann mach es noch einmal mit einer Aufgabe, die sich sauber in zwei Teile teilt. Parallele Agenten sind eine Gewohnheit, kein Schalter.

Setz die Anleitung in die Praxis um.

Lade Nethür herunter und starte deinen ersten parallelen Agenten in wenigen Minuten — oder richte einen Team-Arbeitsbereich auf einer Maschine ein, die dir schon gehört.