Mehrere Claude-Code-Agenten parallel: was funktioniert, was nicht
Damit mehrere Claude-Code-Agenten gleichzeitig arbeiten können, geben Sie jedem seinen eigenen Git-Worktree und Branch. Ab drei oder vier Agenten sind die eigentlichen Probleme Dateikonflikte, Review und Kosten: Es braucht ein Ticket pro Agent, einen Dateiumfang und ein Review vor dem Merge.
Warum parallelisieren, und was ab dem zweiten Agenten kaputtgeht
Ein menschliches Entwicklungsteam arbeitet an einem aktiven Projekt fast nie mit nur einer einzigen Person gleichzeitig: Mehrere Personen arbeiten parallel an unterschiedlichen Teilen desselben Repositories, mit einem System aus Branches, Review und Integration, das dafür seit Jahren eingespielt ist. Dieselbe Logik gilt für Claude-Code-Agenten: Grundsätzlich spricht nichts dagegen, mehrere Agenten gleichzeitig am selben Projekt arbeiten zu lassen, solange jeder in seinem eigenen Bereich bleibt, genauso wie man von einer menschlichen Entwicklerin oder einem menschlichen Entwickler erwarten würde, nicht ohne vorherige Abstimmung das Modul einer Kollegin oder eines Kollegen anzufassen.
Nur einen Claude-Code-Agenten gleichzeitig arbeiten zu lassen, hat eine simple Grenze: Die Gesamtzeit bleibt die Summe der Zeit jeder einzelnen Aufgabe, selbst wenn mehrere Aufgaben absolut nichts miteinander zu tun haben. Einen Artikel in sechs Sprachen zu übersetzen, einen serverseitigen Fehler zu beheben, während man zugleich eine Dokumentationsseite ausbaut, oder drei unabhängige Tickets desselben Arbeitsblatts voranzutreiben, sind Fälle, in denen nichts dazu zwingt, auf das Ende eines Agenten zu warten, bevor der nächste gestartet wird. Mehrere Claude-Code-Agenten zu parallelisieren, sei es durch Sub-Agenten in derselben Session, durch koordinierte Agent Teams oder durch unabhängige Sessions in getrennten Worktrees, verspricht, diese Gesamtzeit auf die Dauer der längsten Aufgabe zu reduzieren statt auf die Summe aller Aufgaben.
Das Starten mehrerer Agenten parallel ist fast nie das Problem: Jedes Terminal kann innerhalb weniger Sekunden mehrere Claude-Code-Sessions öffnen. Die Probleme beginnen, sobald zwei Agenten, und sei es nur kurz, einen gemeinsamen Zustand berühren, ob es sich um eine Datei, einen Branch, einen lokalen Serverport oder ein andernorts bereits ausgelastetes Review-Budget handelt. Vier Symptome tauchen immer wieder auf, ungefähr in dieser Reihenfolge, je mehr Agenten hinzukommen.
Das erste Symptom ist der Dateikonflikt: Zwei Agenten, die gleichzeitig dieselbe Datei im selben Arbeitsverzeichnis ändern, überschreiben fast immer einen Teil der Arbeit des jeweils anderen, vor allem wenn keiner von beiden vor dem Commit den neuesten Stand erneut liest. Das Risiko wächst weiter, wenn beide Agenten dasselbe Git-Arbeitsverzeichnis teilen, denn dann sieht jeder im selben Moment die noch nicht committeten Änderungen des anderen, lange bevor einer von beiden sie validieren konnte.
Das zweite Symptom ist der verlorene Kontext: Ein Agent, der eine Aufgabe wieder aufnimmt, nachdem ein anderer Agent eine benachbarte Datei geändert hat, arbeitet manchmal an einer Version des Codes, die bereits nicht mehr existiert, weil sein eigener Gesprächskontext nie über die Änderung informiert wurde. Diese Verschiebung erzeugt nicht immer sofort einen sichtbaren Fehler; oft entsteht Code, der kompiliert, der lokal korrekt wirkt, der aber einer Entscheidung widerspricht, die in der Zwischenzeit ein benachbarter Agent an derselben Datei oder an einer davon abhängigen Datei getroffen hat.
Das dritte Symptom ist das überlastete Review: Jeder zusätzliche Agent erzeugt einen zusätzlichen Diff, der gelesen werden muss, und Review lässt sich nicht so leicht parallelisieren wie das Schreiben, weil es menschliche Aufmerksamkeit oder eine automatisierte Prüfung erfordert, deren Kapazität ziemlich fest bleibt. Laut einer von The Register im Dezember 2025 aufgegriffenen Studie von CodeRabbit enthalten Pull Requests, die gemeinsam mit KI geschrieben wurden, 1,7-mal so viele Probleme wie Pull Requests ohne KI-Unterstützung: Die Zahl der Agenten zu erhöhen, ohne die Review-Kapazität mitwachsen zu lassen, bedeutet, eine Schuld anzuhäufen, die erst bei der Integration sichtbar wird.
Das vierte Symptom sind die Kosten, die schneller steigen als die Zahl der Agenten statt im gleichen Tempo: Jeder Agent baut bei jeder Session einen Teil seines eigenen Kontexts neu auf, jeder nachträglich gelöste Konflikt verbraucht erneut Tokens zum erneuten Lesen und Korrigieren, und eine schlecht abgestimmte Koordination zwischen Agenten fügt Hin-und-her-Schleifen hinzu, die mit einem einzigen Agenten nicht entstehen würden. Die Dokumentation von Claude Code zum Kostenmanagement empfiehlt aus genau diesem Grund, den Umfang jeder Session vor dem Start festzulegen, statt sie im Verlauf des Gesprächs wachsen zu lassen.
Diese vier Symptome sind kein Argument gegen die Parallelisierung selbst: Sie zeigen lediglich, dass der Koordinationsaufwand jenseits eines einzelnen Agenten nicht verschwindet, sondern sich vom Schreiben des Codes hin zur Festlegung von Umfang, Kriterien und Review verlagert. Der folgende Abschnitt beschreibt Schritt für Schritt, wie sich dieser Rahmen setzen lässt, bevor der zweite Agent startet, statt erst nachdem der erste Konflikt aufgetreten ist.

Schritt-für-Schritt-Methode, um die Kontrolle zu behalten
Fünf Praktiken decken den größten Teil der oben beschriebenen Symptome ab. Keine ist an ein bestimmtes Werkzeug gebunden: Sie gelten ebenso für Sub-Agenten in derselben Session wie für unabhängige Sessions, die in getrennten Worktrees gestartet werden. Sie werden in dieser Reihenfolge angewendet, weil jede ein Risiko verringert, das die nächste nicht mehr vollständig auffangen kann, sobald es eingetreten ist.
Die erste Praxis ist ein Git-Worktree und ein Branch pro Agent. Der Befehl git worktree add erstellt ein getrenntes Arbeitsverzeichnis mit eigenem Dateizustand, während derselbe Git-Verlauf wie im Hauptrepository geteilt wird: Zwei Agenten, die in zwei verschiedenen Worktrees arbeiten, können allein schon durch diesen Aufbau nicht mehr die nicht committeten Dateien des jeweils anderen sehen oder überschreiben, selbst wenn sie im selben Moment am selben Repository arbeiten. Die Dokumentation von Claude Code zu gängigen Arbeitsabläufen beschreibt genau dieses Schema, um mehrere Sessions parallel laufen zu lassen, ohne dass sie sich gegenseitig in die Quere kommen, wobei jede Session auf ihrem eigenen Branch bleibt, bis ein ausdrücklicher Merge die Arbeit mit der der anderen zusammenführt. Ein Agent, der seine Aufgabe beendet, hinterlässt einen review-bereiten Branch, den die Integration annehmen oder ablehnen kann, ohne je das Arbeitsverzeichnis der noch laufenden Agenten berührt zu haben.
Die zweite Praxis ist ein pro Aufgabe festgelegter Dateiumfang, bevor der Agent zu schreiben beginnt. Ein Ticket, das genau festlegt, welche Dateien oder Ordner ein Agent ändern darf, nimmt einen Großteil des Konfliktrisikos, bevor es überhaupt entsteht, denn zwei Agenten, deren Umfänge sich nicht überschneiden, können per Definition nicht an derselben Datei schreiben. Dieser Umfang muss enger bleiben als das, was die allgemeine Rollenbeschreibung des Agenten erlauben würde, denn es ist das laufende Ticket, nicht die Rolle des Agenten, das bestimmt, was eine konkrete Aufgabe tatsächlich braucht. Ein zu weiter Umfang, selbst mit guten Absichten, gibt den Agenten letztlich dieselbe Angriffsfläche wie einem einzigen Agenten ganz ohne Aufteilung, nur auf mehrere Sessions verteilt statt in einer einzigen gebündelt.
Die dritte Praxis besteht darin, die Abnahmekriterien zu schreiben, bevor der Agent gestartet wird, nicht erst nachdem man seine Lieferung gelesen hat. Ein im Voraus geschriebenes Kriterium, etwa „der Build-Befehl läuft durch“ oder „alle fünf Übersetzungen übernehmen dieselben Abschnitte“, gibt dem Agenten ein überprüfbares Ziel und seinem Reviewer einen objektiven Test statt eines allgemeinen Eindrucks von der Qualität des Ergebnisses. Ohne vorab festgelegtes Kriterium gleitet das Review in eine Einzelfallbewertung ab, die von einem Agenten zum anderen und von einer Aufgabe zur anderen schnell uneinheitlich wird. Dasselbe Kriterium dient zugleich als Haltepunkt: Ein Agent, der es nicht erfüllen kann, meldet eine Blockade vor dem Review, statt ein ungefähres Ergebnis zu liefern in der Hoffnung, dass es unbemerkt bleibt.
Die vierte Praxis ist ein Review vor jeder Integration, niemals danach. Ein Diff, der vor dem Merge gelesen wird, lässt sich noch korrigieren, ohne die Arbeit anderer Agenten zu beeinträchtigen; ein Diff, der zuerst gemergt und erst danach gelesen wird, zwingt dazu, einen bereits geteilten Verlauf rückgängig zu machen, mit dem Risiko, dabei auch gültige Arbeit zu entfernen, die ein benachbarter Agent in der Zwischenzeit an einer davon abhängigen Datei geleistet hat. Das Review muss sich auf den tatsächlichen Diff beziehen, nicht nur auf die Zusammenfassung, die der Agent von seiner eigenen Arbeit liefert, gerade weil eine optimistische Zusammenfassung ein noch nicht erfülltes Abnahmekriterium nicht immer offenlegt. Diese Disziplin kostet bei jeder Lieferung etwas Zeit, aber immer weniger, als nach einem Merge zu entwirren, welcher der beiden Agenten welchen Teil derselben Datei produziert hat.
Die fünfte Praxis besteht darin, die Zahl gleichzeitiger Sessions auf das zu begrenzen, was das Review tatsächlich bewältigen kann. Die Dokumentation von Claude Code zu Sub-Agenten und Agent Teams empfiehlt, mit drei bis fünf Teammitgliedern zu beginnen, bevor man weitergeht, und erinnert daran, dass zwei Agenten an derselben Datei fast immer zu einem Überschreiben statt zu einem sauberen Merge führen. Diese Zahl ist keine technische Grenze des Protokolls; sie ist eine praktische Grenze dessen, was ein Reviewer, ob Mensch oder automatisiertes System, vor der Integration ernsthaft prüfen kann. Diese Zahl später zu erhöhen bleibt möglich, sobald Dateiumfang, Abnahmekriterien und Review vor dem Merge bei einer kleinen Zahl von Agenten bereits eingespielt sind.
Tabelle der Fallstricke und Gegenmaßnahmen
Die folgende Tabelle fasst die häufigsten Fallstricke zusammen, die jenseits von zwei Agenten zu beobachten sind, mit ihrem konkreten Symptom und der Gegenmaßnahme, die ihn vermeidet; jede Gegenmaßnahme verweist direkt auf eine der fünf Praktiken aus dem vorigen Abschnitt.
| Fallstrick | Symptom | Gegenmaßnahme |
|---|---|---|
| Zwei Agenten an derselben Datei | Ein Teil der Arbeit wird vor dem Commit oder beim Merge überschrieben | Ein Worktree und ein Branch pro Agent |
| Unklarer Aufgabenumfang | Zwei Agenten ändern überlappende Dateien, ohne es zu wissen | Ein im Ticket vor dem Start festgelegter Dateiumfang |
| Fehlendes Abnahmekriterium | Die Lieferung wirkt fertig, beantwortet aber nicht die eigentliche Anfrage | Vor dem Start des Agenten geschriebene Abnahmekriterien |
| Merge vor dem Review | Ein nachträglich entdeckter Fehler zwingt dazu, einen geteilten Verlauf rückgängig zu machen | Ein Review des tatsächlichen Diffs vor jeder Integration |
| Zu viele gleichzeitige Sessions | Das Review ist überlastet, und Code-Schulden häufen sich unbemerkt an | Eine Zahl gleichzeitiger Sessions, begrenzt auf das, was das Review bewältigt |
| Zwischen Agenten nicht geteilter Kontext | Ein Agent arbeitet an einer Version des Codes, die ein anderer bereits geändert hat | Ein Ticket pro Agent mit eigenem Umfang, geprüft vor dem Merge |
Wie Atipol dabei vorgeht
In Atipol arbeitet jeder Agent in seinem eigenen Git-Worktree, auf seinem eigenen Branch: Zwei Agenten ändern nie dieselben Dateien im selben Moment, durch den Aufbau selbst statt durch individuelle Disziplin. Jedes Ticket reserviert einen Dateiumfang, bevor der Agent zu schreiben beginnt, und zwei laufende Tickets können nicht denselben Umfang reservieren: Das Überschreibungsrisiko zwischen zwei Agenten wird vor dem ersten Commit beseitigt statt erst beim Merge. Diese Reservierung wird in dem Moment geprüft, in dem das Ticket an einen Agenten übergeben wird, nicht nachträglich bei einem Review am Wochenende, was verhindert, dass eine Überschneidung erst entdeckt wird, nachdem beide Agenten bereits in dieselben Zeilen geschrieben haben.
Jedes Ticket verlangt Abnahmekriterien, die vor dem Start des Agenten geschrieben werden, damit eine Aufgabe nicht endet, ohne dass genau bekannt ist, was zutreffen musste, um sie als erledigt zu betrachten. Der Agent Lead des Projekts prüft jede Lieferung, bevor sie integriert wird, und diese Integration spielt die Kontrollen des Projekts erneut durch, statt sich allein auf das vorangegangene Review zu verlassen. Dieses Review bezieht sich auf den tatsächlichen Diff, den der Agent erzeugt hat, und die anschließende Integration begnügt sich nicht mit der Einschätzung des Reviewers: Sie spielt selbst die Kontrollen des Projekts erneut durch, damit ein Versäumnis im Review nicht zu einem stillen Fehler im Hauptbranch wird.
Die Zahl gleichzeitiger Sessions wird auf Projektebene festgelegt, damit die Review-Last und die Kosten in Tokens unter der Kontrolle des Teams bleiben, statt allein mit der Zahl der Agenten zu wachsen, die sich starten ließen. Diese Einstellung bleibt in der Hand des Teams, das das Projekt trägt, nicht ein Parameter, der ein für alle Mal von der Plattform selbst festgelegt wird. Atipol ist nicht auf Claude Code beschränkt: Derselbe Rahmen aus Tickets, Dateiumfang und Review vor der Integration gilt auch für andere Entwicklungsagenten.

Häufige Fragen
Braucht man für jeden Claude-Code-Agenten einen Worktree?
Sobald zwei Agenten gleichzeitig dasselbe Repository berühren, ja: Ein Worktree und ein Branch pro Agent beseitigen das Risiko von Dateikonflikten an der Wurzel, statt es nachträglich zu verwalten.
Wie viele Agenten lassen sich parallel starten?
So viele, wie es tatsächlich unabhängige Aufgaben gibt. Die konkrete Grenze ist nicht die Zahl der Sessions, die sich öffnen lassen, sondern die verfügbare Review-Kapazität und das Budget, um sie zu prüfen.
Was tun, wenn zwei Agenten dieselbe Datei anfassen müssen?
Sie bei genau dieser Datei nacheinander statt parallel arbeiten lassen, oder die Aufgabe so aufteilen, dass jeder Agent vor dem Start einen eigenen Dateiumfang erhält.
Ersetzt ein Sub-Agent einen separaten Worktree?
Nein: Ein Sub-Agent bleibt in derselben Session und demselben Kontext, für eine kurze Nebenaufgabe. Ein separater Worktree dient der langen, unabhängigen Arbeit auf eigenem Branch.
Wie verhindert man, dass das Review zum Engpass wird?
Indem man die Zahl gleichzeitiger Sessions auf das begrenzt, was ein Reviewer ernsthaft prüfen kann, und die Abnahmekriterien vor dem Start statt nach der Lieferung schreibt.
Wie verhindert Atipol, dass zwei Agenten denselben Umfang reservieren?
Jedes Ticket reserviert einen Dateiumfang, bevor der Agent zu schreiben beginnt, und zwei laufende Tickets können nicht denselben Umfang reservieren: Der Konflikt wird vor dem ersten Commit ausgeschlossen.
Quellen
- Claude Code, Common workflows (Git-Worktrees)
- Claude Code, Subagenten
- Git, git-worktree
- Claude Code, Manage costs
- The Register, CodeRabbit, 17.12.2025
Um diese Methode mit einem vollständigen Governance-Rahmenwerk zu verbinden, lesen Sie unseren Leitfaden zur Governance von KI-Agenten.
Was diese parallelen Agenten in der Praxis kosten, lesen Sie in unserem Artikel zu den Kosten von KI-Agenten.
Die öffentliche Demo zeigt eine fiktive Organisation im laufenden Betrieb, ohne Konto. Der kostenlose Tarif umfasst ein Projekt, drei Agenten und einen Agent Lead.
