So lässt du mehrere Claude-Code-Agenten gleichzeitig laufen

Vier Wege, Claude-Code-Agenten parallel laufen zu lassen

Subagents: parallele Helfer in einer Session

Ein Subagent hat sein eigenes Kontextfenster, seinen eigenen System-Prompt und seine eigenen Tools. Er sieht deine Unterhaltung nicht, und nur seine Zusammenfassung kommt zurück, was den Kontext der Haupt-Session klein hält. Claude Code bringt eingebaute mit, etwa Explore (nur lesend) und Plan, und du kannst eigene hinzufügen.

1. Einen Subagent definieren

   Leg eine Markdown-Datei in .claude/agents/ (mit dem Projekt geteilt) oder ~/.claude/agents/ (nur für dich) an. Nur name und description sind Pflicht; tools begrenzt, was er nutzen darf, und model wählt das Modell.

   ---
   name: code-reviewer
   description: Reviews code for quality and best practices
   tools: Read, Glob, Grep
   model: sonnet
   ---
   
   You are a code reviewer. When invoked, analyze the code and give
   specific, actionable feedback on quality, security and best practices.

2. Lass Claude mehrere gleichzeitig ausführen

   Bitte darum, die Arbeit parallel zu erledigen, z. B. „prüf die Module auth, billing und search parallel“. Subagents, die Claude startet, laufen standardmäßig im Hintergrund, bis zu 20 gleichzeitig, und berichten zurück, wenn sie fertig sind. Tippe /tasks, um sie zu sehen.

3. Gib Subagents, die Dateien bearbeiten, einen eigenen Worktree

   Füge isolation: worktree zum Frontmatter des Subagents hinzu oder bitte Claude, für seine Agenten Worktrees zu nutzen. Jeder bearbeitet dann eine temporäre Kopie des Repos, die entfernt wird, wenn er nichts geändert hat.

Parallele Claude-Code-Sessions in git worktrees ausführen

1. Den Worktree-Ordner ignorieren

   Claude Code legt Worktrees in .claude/worktrees/ im Root des Repos an. Das Repo braucht mindestens einen Commit.

   echo ".claude/worktrees/" >> .gitignore

2. Eine Session pro Aufgabe starten

   Führe in jedem Terminal claude --worktree (oder -w) mit einem anderen Namen aus. Jede Session bekommt ihren eigenen Ordner und einen Branch namens worktree-<name>, basierend auf dem Standard-Branch.

   # Terminal 1
   claude --worktree feature-auth
   
   # Terminal 2
   claude --worktree bugfix-login

3. Benötigte ungetrackte Dateien kopieren

   Ein neuer Worktree enthält nur getrackte Dateien. Liste Dateien wie .env in einer .worktreeinclude-Datei auf (gitignore-Syntax), und Claude Code kopiert sie hinein.

   .env
   .env.local

4. Mergen und aufräumen

   Wenn eine Session endet, wird ein Worktree ohne Änderungen samt Branch entfernt; bei einem mit Änderungen wirst du gefragt, ob du ihn behalten willst. Merge die Branches wie jeden anderen. Headless-Läufe mit -p fragen nicht nach, die entfernst du also mit git worktree remove.

5. Oder nutze die Desktop-App

   Drück Cmd+N (unter Windows Ctrl+N) für eine neue Session und schalte vor dem Start Worktree ein; standardmäßig ist es aus. Sessions können in der geteilten Ansicht nebeneinander liegen.

Quelle: Dokumentation von Anthropic zu Worktrees (Englisch)

Hintergrund-Sessions mit --bg und Agent View

claude --bg "<prompt>" startet eine Session im Hintergrund und kehrt sofort zurück, du kannst also mehrere hintereinander starten. Jede wechselt in ihren eigenen Worktree, bevor sie etwas bearbeitet. claude agents listet sie auf; mit claude logs <id>, claude attach <id> und claude stop <id> verwaltest du eine einzelne.

Sie laufen weiter, nachdem du das Terminal geschlossen hast, aber nicht, nachdem der Computer heruntergefahren ist. Agent View ist eine Research Preview. Mehr zu unbeaufsichtigten Läufen findest du unter Claude Code als Hintergrund-Agent ausführen.

Agent teams: Agenten, die miteinander sprechen

Agent teams sind experimentell und standardmäßig aus. Schalte sie mit CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in deiner Shell oder im env-Block der settings.json ein und bitte Claude dann, für eine Aufgabe „drei Teammates zu starten“. Teammates teilen sich eine Aufgabenliste und schicken sich gegenseitig Nachrichten; sie erscheinen im Terminal oder, mit tmux oder iTerm2, in geteilten Bereichen.

• Nur interaktive Sessions: -p und das Agent SDK starten keine Teammates.
• Ein Team pro Session, keine verschachtelten Teams, und In-Process-Teammates werden von /resume nicht wiederhergestellt.
• Teammates teilen sich einen Checkout, gib also jedem andere Dateien.
• Sie kosten deutlich mehr: Laut der Dokumentation von Anthropic verbraucht ein Team etwa 7-mal so viele Tokens wie eine einzelne Session, wenn die Teammates im Plan-Modus laufen.

So verhinderst du, dass parallele Agenten sich gegenseitig überschreiben

• Wenn zwei Agenten dieselben Dateien anfassen könnten, gib jedem einen eigenen Worktree. Eine Session in einem Worktree kann den Haupt-Checkout nicht bearbeiten, und ihre Subagents auch nicht.
• Teil die Arbeit in einem agent team nach Dateien auf: Zwei Teammates, die dieselbe Datei bearbeiten, überschreiben sich gegenseitig.
• Jeder Subagent und jede Session zehrt von denselben Nutzungslimits, mehrere gleichzeitig vervielfachen also den Verbrauch. Nutze model: haiku für einfache Subagents.
• Agenten, die dieselben Tests oder denselben Dev-Server ausführen, können sich bei Ports in die Quere kommen; gib jedem einen eigenen Port.

Mach aus parallelen Agenten ein Team mit festen Aufgaben

Worktrees und agent teams teilen eine Aufgabe auf, die du beobachtest. Crewmark betreibt mehrere Claude-Code- oder Codex-Sessions als Mitarbeiter mit eigenen Rollen, Zielen und Arbeitszeiten und gibt ihnen Arbeit auf einem Board.

1. Ein Mitarbeiter pro Rolle

   Ein SEO-Spezialist, ein Softwareentwickler und ein UI-Designer leben jeweils in ihrer eigenen Unterhaltung, mit eigenen Anweisungen und eigenem Ziel.

2. Ein Board für alle

   Weise Issues dem Mitarbeiter zu, der passt. Jeder wacht im Takt seines Heartbeats auf, nimmt sein nächstes Issue und kommentiert unterwegs, sodass du siehst, wer gerade was tut.

3. Sie fragen dich, nicht einander

   Braucht ein Mitarbeiter ein Review oder eine Berechtigung, schreibt er dir und macht weiter. Lies, was ein KI-Mitarbeiter ist.

FAQ zu mehreren Claude-Code-Agenten