# Mehrere Claude Code Agenten parallel ausführen URL: https://agentvera.dev/de/blog/run-multiple-claude-code-agents/ · Veröffentlicht: 2026-10-08 Mehrere Claude Code Agenten parallel ausführen: mit Terminals, tmux, Git-Worktrees oder Desktop-App, und Merge-Konflikte, Limits und hohen Token-Verbrauch vermeiden. **Kurz gesagt:** - Mehrere Claude-Code-Agenten laufen in getrennten Terminals, tmux, Git-Worktrees, der Desktop-App von Claude Code oder AgentVera; tmux bringt Übersicht, aber keine Isolation. - Alle Sitzungen eines Kontos teilen sich das 5-Stunden- und das Wochenlimit, vier Agenten erreichen das Limit also etwa viermal schneller. - Worktrees verhindern keine Merge-Konflikte: Merge einen Branch nach dem anderen, lass geteilte Dateien bei einem Agenten und fang mit zwei Agenten an. 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: ```bash # 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: ```bash 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: ```bash 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](/de/blog/git-worktree-parallel-agents/). ## 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](/de/blog/best-tools-parallel-ai-coding-agents/). ## Option 5: AgentVera [AgentVera](/de/agents/claude-code/) ö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](/de/features/flows/) senden die Antwort eines Agenten über eine Vorlage an einen anderen | | Das Limit geht mitten in der Aufgabe aus | Der [Kontenwechsel](/de/features/account-switching/) 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](/de/features/token-savings/) | ### Schritt für Schritt 1. **Füge den Projektordner hinzu.** Wähle ihn auf dem Projektbildschirm aus. Ein Git-Repository wird empfohlen. 2. **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`. 3. **Ö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: ```text 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. ``` 4. **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. 5. **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. 6. **Prüfe und merge.** Das automatische Code-Review prüft jeden abgeschlossenen Turn. Das [Git-Panel](/de/features/git-and-github/) 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](/de/blog/claude-code-usage-limits/). ### 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](/de/blog/claude-code-token-usage/). ### 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](/de/download/) und öffne deine ersten zwei Claude-Code-Agenten. Die allgemeine Methode steht in [parallele Coding-Agenten](/de/blog/parallel-coding-agents/). ## Häufige Fragen **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. --- **Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/