Mehrere KI-Agenten in einem Repository gleichzeitig ausführen (ohne Git-Konflikte)
Mehrere Agenten in einem Projekt laufen zu lassen braucht drei Dinge: eine Maschine, die sie beherbergt, ein Verzeichnis, das sie teilen, und eine Regel, die entscheidet, wer wo schreibt. Ohne die dritte löscht der zweite Agent die Arbeit des ersten, ohne dass etwas es meldet.
Schritt für Schritt
- Projekt anlegen. Eine Canvas startet ihre eigene Maschine und ein privates Repository. Dort lebt das geteilte Verzeichnis, und es ist dasselbe für alle Agenten, die Sie danach öffnen.
- Konten verbinden. Verbinden Sie das Abo oder den API-Schlüssel, den Sie bereits bei Anthropic, OpenAI oder einem anderen Anbieter bezahlen. Kein Token wird weiterverkauft, der Verbrauch bleibt auf Ihrem Konto.
- Ein Fenster pro Agent öffnen. Claude Code, Codex, Kimi und OpenCode öffnen sich jeweils in ihrem Fenster, mit einem echten Terminal. Zwei Fenster im Solo-Plan, fünf im Pro-Plan.
- Nach Datei aufteilen, nicht nach Aufgabe. Geben Sie jedem Agenten eine Ecke des Projekts statt einer Aufgabe, die alles durchquert. Zwei Agenten auf zwei Bereichen kommen parallel voran, zwei Agenten auf derselben Datei warten aufeinander.
- Das Board entscheiden lassen. Ein Agent beansprucht die Pfade, die er anfassen wird, bevor er schreibt, und der Server verweigert sie den anderen, bis er sie freigibt. Sie sehen, wer was hält und wer wartet.
Was Sie zur Hand haben sollten
Ein Repository, auch ein leeres, und ein Konto bei einem Modellanbieter. Der Rest kommt vom Projekt: die Maschine, das Verzeichnis und das Board, das die Dateien verteilt.
Eine Anweisungsdatei im Wurzelverzeichnis des Repositorys ändert das Ergebnis mehr als jede Einstellung. Die Agenten lesen sie beim Start, und sie erspart jedem die ersten fünf Fehler.
Die Aufteilung, die funktioniert
Die richtige Einheit ist nicht das Feature, es ist die Datei. Ein Agent an der API, einer an der Oberfläche, einer an den Tests: Sie kreuzen sich selten und warten fast nie aufeinander. Drei Agenten auf „die Bezahlseite" streiten sich die ganze Stunde um dieselben drei Dateien.
Was Sie währenddessen sehen
Die Terminals laufen in ihren Fenstern durch, und das Board zeigt, wer welchen Pfad hält. Ein blockierter Agent ist sichtbar, bevor er Schaden anrichtet, was den echten Unterschied zu einer unsichtbaren Warteschlange ausmacht. Der Mechanismus im Detail.
Direkte Antworten
Wie viele Agenten gleichzeitig sind sinnvoll?
So viele, wie das Projekt gerade unabhängige Baustellen hat, was meistens zwei oder drei sind und fünf bei einem großen Refactoring. Darüber hinaus verbringen die Agenten ihre Zeit mit Warten auf Dateien statt mit Schreiben.
Braucht man einen Git-Worktree pro Agent?
Das ist die Methode, die die meisten Anleitungen empfehlen, und sie funktioniert: Jeder Agent erhält seine eigene Arbeitskopie mit eigenem Index, also keine Kollision. Der Preis ist eine Zusammenführung pro Kopie und ein Konflikt, den man erst am Ende entdeckt. In einem geteilten Verzeichnis mit Reservierung gibt es nichts zusammenzuführen, weil es nie zwei lebende Versionen gab.
Braucht man einen Branch pro Agent?
Nein, und das ist der Punkt. Ein Branch pro Agent verschiebt den Konflikt zum Zusammenführen, an dem Punkt, an dem sich niemand mehr an die Überlegung erinnert. Ein geteiltes Verzeichnis mit Reservierung löst den Konflikt in dem Moment, in dem er entsteht.
Was passiert, wenn zwei Agenten dieselbe Datei wollen?
Der zweite wartet. Er sieht es auf dem Bildschirm, Sie auch, und Sie können ihm sofort etwas anderes zu tun geben, statt das Problem eine Stunde später zu entdecken.