Kann ich zwei Claude-Code-Sitzungen im selben Ordner ausführen?

Ja, Claude Code startet, aber beide Sitzungen ändern dieselben Dateien und sehen die halbfertigen Änderungen der jeweils anderen. Gib jeder Sitzung ihren eigenen Git-Worktree oder zumindest eine strikte Ordnergrenze.

Teilen sich mehrere Claude-Code-Agenten ein Nutzungslimit?

Ja. Jede Sitzung, die im selben Konto angemeldet ist, verbraucht dasselbe 5-Stunden- und Wochenlimit, vier Agenten brauchen es also ungefähr viermal schneller auf.

Wie viele Claude-Code-Agenten kann ich gleichzeitig ausführen?

In Claude Code selbst gibt es keine feste Obergrenze. In der Praxis sind zwei bis vier das, was eine Person im Blick behalten kann; Limits und Review-Zeit sind die eigentliche Grenze.

Wie führe ich die Arbeit paralleler Claude-Code-Agenten zusammen?

Behandle jeden Worktree wie einen normalen Branch: Führe dort die Tests aus, pushe ihn und öffne einen Pull Request, oder merge ihn lokal. Merge einen Branch nach dem anderen und führe nach jedem die Tests erneut aus.

Mehrere Claude Code Agenten parallel ausführen

Eine Claude-Code-Sitzung arbeitet eine Aufgabe Schritt für Schritt ab. Während sie Dateien liest und Tests ausführt, wartest du. Wenn du mehrere Claude-Code-Agenten parallel laufen lässt, wird diese Wartezeit zu Arbeit: Ein Agent baut die API, ein zweiter schreibt die Tests, ein dritter behebt einen Bug, der mit beidem nichts zu tun hat.

Dieser Beitrag geht vom einfachsten Setup zum komfortabelsten: normale Terminals, tmux, Git-Worktrees, die eigenen parallelen Sitzungen von Claude Code und schließlich AgentVera. Jeder Schritt bringt etwas mit, das dem vorherigen fehlte. Am Ende steht eine Liste der Stolperfallen, über die man meist fällt: Merge-Konflikte, Limits und Tokens.

Kann man mehr als einen Claude-Code-Agenten gleichzeitig ausführen?

Ja. Claude Code ist ein CLI; jedes Mal, wenn du claude ausführst, startest du eine unabhängige Sitzung mit eigener Unterhaltung und eigenem Kontext. Nichts hindert dich daran, fünf zu starten. Schiefgehen kann nicht das Starten, sondern das Koordinieren: Zwei Sitzungen im selben Ordner bearbeiten bereitwillig dieselbe Datei, und alle Sitzungen, die in einem Konto angemeldet sind, teilen sich dessen Limits.

Die eigentliche Frage ist also, wie du sie voneinander trennst und wie du sie im Blick behältst.

Option 1: getrennte Terminalfenster

Das schnellste Setup ist ein Terminal-Tab pro Agent:

# tab 1
cd ~/code/acme-web && claude
# tab 2
cd ~/code/acme-web && claude

Das funktioniert für kleine, klar getrennte Aufgaben. Sag jedem Agenten in der ersten Nachricht, welche Ordner er anfassen darf („nur src/api/“, „nur tests/“).

Die Nachteile zeigen sich schnell: Du siehst nicht, welcher Tab auf eine Freigabe wartet, beide Sitzungen teilen sich eine Arbeitskopie, und wenn ein Agent git checkout ausführt, ist der andere plötzlich auf einem anderen Branch.

Option 2: tmux

tmux hält Sitzungen am Leben, wenn du das Terminal schließt, und zeigt mehrere Panes gleichzeitig:

tmux new-session -d -s agents -c ~/code/acme-web
tmux split-window -h -t agents -c ~/code/acme-web
tmux send-keys -t agents:0.0 'claude' Enter
tmux send-keys -t agents:0.1 'claude' Enter
tmux attach -t agents

Jetzt sind beide Agenten nebeneinander sichtbar und überstehen einen zugeklappten Laptop-Deckel (solange der Rechner an bleibt). tmux löst die Sichtbarkeit, nicht die Isolation: Beide Panes bearbeiten weiterhin denselben Ordner.

Option 3: ein Git-Worktree pro Agent

Git-Worktrees sind die Standardantwort auf „zwei Agenten, ein Repository“. Ein Worktree ist ein zweiter Arbeitsordner auf einem eigenen Branch, der dieselbe .git-Historie teilt:

cd ~/code/acme-web
git worktree add ../acme-web-api -b feat/api
git worktree add ../acme-web-tests -b feat/tests

cd ../acme-web-api && claude     # agent 1
cd ../acme-web-tests && claude   # agent 2

Jeder Agent hat jetzt seine eigenen Dateien und seinen eigenen Branch. Ein git checkout oder eine halbgeschriebene Datei des einen Agenten betrifft den anderen nicht. Ist ein Agent fertig, wird sein Branch wie jeder Feature-Branch gemergt.

Ein paar praktische Hinweise:

Installiere Abhängigkeiten pro Worktree. node_modules, Virtualenvs und Build-Ausgaben werden nicht geteilt. Führe in jedem neuen Ordner pnpm install (oder das Äquivalent) aus.
Kopiere lokale Konfiguration. .env-Dateien werden meist von Git ignoriert, tauchen also in einem neuen Worktree nicht auf.
Ports kollidieren. Zwei Dev-Server auf Port 3000 starten nicht; gib jedem Worktree einen eigenen Port.
Räum auf. git worktree remove ../acme-web-api, sobald der Branch gemergt ist, und git worktree prune für Ordner, die du von Hand gelöscht hast.

Die Details stehen in Git-Worktrees für parallele Agenten.

Option 4: die eigenen parallelen Sitzungen von Claude Code

Die Desktop-App von Anthropic für Claude Code kann parallele Claude-Sitzungen ausführen, jede in einem eigenen Worktree, ohne dass du die Git-Befehle tippst. Wenn du nur Claude nutzt und das offizielle Tool willst, ist das ein vernünftiger Halt. Es deckt Isolation und eine einfache Übersicht ab.

Was es nicht versucht: andere CLIs wie Codex oder Gemini CLI neben Claude auszuführen, die Ausgabe eines Agenten automatisch an einen anderen weiterzugeben oder einen Agenten auf ein anderes Konto zu verschieben, wenn ein Limit aufgebraucht ist. Hier kommt eine eigene Multi-Agenten-App ins Spiel. Einen Vergleich der Optionen findest du in die besten Tools, um mehrere KI-Coding-Agenten parallel auszuführen.

Option 5: AgentVera

AgentVera öffnet den Befehl claude auf deinem Rechner in echten Terminals und ordnet die Agenten pro Projekt in einem Raster an. Es nutzt die eigene Anmeldung von Claude Code, dein Pro- oder Max-Abo funktioniert also unverändert. So lassen sich die bisherigen Probleme den Funktionen zuordnen:

Problem	In AgentVera
Du siehst nicht, welcher Agent dich braucht	Raster von 1×1 bis 5×4; jedes Pane zeigt Status und aktuelle Kontextgröße; Agenten, die auf Freigabe warten, stehen in der Statusleiste
Agenten bearbeiten dieselben Dateien	Worktree-Panel: Erstelle einen Worktree aus einem Branch und starte einen Agenten direkt darin
Zwei Agenten ändern trotzdem dieselbe Datei	Eine Warnung bei Dateikonflikten: Bearbeiten zwei Agenten dieselbe Datei im selben Ordner, werden der Agent und du informiert; blockiert wird nichts
Ausgaben müssen von Hand kopiert werden	Flows senden die Antwort eines Agenten über eine Vorlage an einen anderen
Das Limit geht mitten in der Aufgabe aus	Der Kontenwechsel verschiebt den Agenten auf das nächste Claude-Konto und kopiert die Unterhaltung
Der Kontext wächst mit jedem Turn	Automatisches `/compact` bei einem selbst gesetzten Schwellenwert, dazu Kontextprofile

Schritt für Schritt

Füge den Projektordner hinzu. Wähle ihn auf dem Projektbildschirm aus. Ein Git-Repository wird empfohlen.
Lege Worktrees an. Öffne im rechten Panel die Worktree-Liste und erstelle pro Aufgabe einen aus einem neuen Branch, zum Beispiel feat/api und feat/tests.
Öffne die Agenten. Wähle unter „New agent“ Claude Code, den Worktree, und gib dem Agenten einen Namen, ein Modell, einen Effort und eine kurze Rolle:
```
Work only under src/api/. Don't change tests.
Run pnpm test api after each change.
Finish with a bullet list of what you changed.
```
Ordne das Raster an. Ein 2×2-Layout passt zu zwei Claude-Agenten, einem Codex-Reviewer und einem Terminal, in dem der Dev-Server läuft.
Verbinde sie bei Bedarf. Ein Flow kann die Abschlusszusammenfassung des API-Agenten an den Test-Agenten senden, wenn dessen Turn endet. Ein Turn-Limit verhindert, dass zwei Agenten sich in Schleifen aufschaukeln.
Prüfe und merge. Das automatische Code-Review prüft jeden abgeschlossenen Turn. Das Git-Panel zeigt die Änderungen jedes Worktrees und wie weit er vor main liegt; merge einen Branch nach dem anderen.

Das Raster, die Worktrees und das Code-Review gibt es im kostenlosen Plan. Flows und Kontenwechsel sind in Pro enthalten.

Stolperfallen und wie du sie vermeidest

Merge-Konflikte

Worktrees verhindern, dass Agenten sich bei der Arbeit gegenseitig überschreiben; Konflikte beim Mergen verhindern sie nicht. Zwei Agenten, die beide src/routes.ts auf verschiedenen Branches bearbeiten, geraten am Ende trotzdem in Konflikt.

Teile Aufgaben nach Ordner oder Modul auf, nicht nur nach Branch.
Lass geteilte Dateien (Routentabellen, Schemas, Lockfiles) bei einem Agenten.
Merge zuerst den kleineren Branch, rebase dann den anderen Worktree auf main und lass dessen Agenten den Konflikt lösen: git rebase main im Worktree, dann den Agenten bitten, aufzulösen und die Tests erneut auszuführen.

Nutzungslimits

Alle Sitzungen eines Kontos teilen sich dasselbe 5-Stunden- und Wochenlimit. Vier Agenten bekommen nicht das Vierfache an Kontingent; sie erreichen das Limit viermal schneller. Prüfe in Claude Code regelmäßig /usage und plane aufwendige parallele Sitzungen früh in einem Limit-Fenster. Wenn du rechtmäßig mehr als ein Konto hast (etwa privat und beruflich) und die Bedingungen des Anbieters es erlauben, hält der Kontenwechsel eine Aufgabe am Laufen, wenn eines ausgeht. Mehr dazu in Nutzungslimits von Claude Code.

Token-Verbrauch

Jeder Agent trägt seinen eigenen Kontext: System-Prompt, Tool-Definitionen, CLAUDE.md, MCP-Server und jede Datei, die er gelesen hat. Diese Grundlast wird bei jedem Turn neu gelesen, pro Agent.

Gib Agenten enge, konkrete Aufgaben, damit sie weniger Dateien lesen.
Führe /compact aus, bevor eine lange Unterhaltung teuer wird, oder lass es bei einem Schwellenwert automatisch laufen.
Schalte MCP-Server ab, die ein Agent nicht braucht.
Gib zwischen Agenten die Zusammenfassung weiter, nicht das ganze Transkript.

Gemessene Zahlen findest du in Token-Verbrauch von Claude Code senken.

Freigaben, die blockieren

Ein Agent, der auf eine Berechtigung wartet, bleibt stehen, während die anderen weiterlaufen. Bei fünf Panes übersieht man leicht einen. Behalte entweder den Status im Auge, nutze Benachrichtigungen oder erlaube sichere Aktionen (Dateien lesen, Tests ausführen) in den Berechtigungseinstellungen von Claude Code, damit Agenten seltener fragen.

Zu viele Agenten, zu früh

Der Engpass wandert von den Agenten zu dir. Vier Branches zu prüfen dauert länger als einen. Fang mit zwei Agenten für klar getrennte Aufgaben an und nimm einen dritten dazu, sobald das läuft.

Eine knappe Checkliste

Ein Worktree pro Agent, der geteilten Code berühren könnte
Abhängigkeiten installiert und .env in jeden Worktree kopiert
Die Rolle jedes Agenten nennt seine Ordner und sein Ziel
Getrennte Ports für Dev-Server
Ein Plan fürs Mergen: welcher Branch zuerst, wer löst Konflikte
Ein Auge auf /usage und die Kontextgröße

Zum Schluss

Mehrere Claude-Code-Agenten parallel auszuführen ist vor allem eine Frage von Isolation und Aufmerksamkeit. Worktrees geben jedem Agenten eigene Dateien; tmux oder ein Raster lässt dich alle sehen; kurze Rollen und ein Merge-Plan halten das Ergebnis prüfbar. Normale Terminals und Worktrees reichen für den Anfang. Wenn du ein Raster, Flows zwischen Agenten und Hilfe bei Limits willst, lade AgentVera kostenlos herunter und öffne deine ersten zwei Claude-Code-Agenten. Die allgemeine Methode steht in parallele Coding-Agenten.