Claude Code: Parallele Aufgaben

Claude Code bietet mehrere Mechanismen für die parallele Ausführung von Aufgaben, mit denen Sie mehrere Arbeitselemente gleichzeitig bearbeiten und die Entwicklungseffizienz erheblich verbessern können. Dieses Kapitel stellt drei Hauptansätze zur Parallelisierung vor: Subagents, Agent Teams und Git Worktree, um Ihnen zu helfen, die am besten geeignete Methode für verschiedene Anwendungsszenarien auszuwählen.


Überblick über parallele Aufgaben

Wenn Sie mit komplexen Aufgaben konfrontiert sind, kann eine einzelne Claude-Instanz unzureichend sein – der Kontext wird zu lang, Antworten werden langsamer und Aufgaben verzahnen sich. Claude Code bietet einen dreistufigen Parallelisierungsmechanismus, um unterschiedliche Komplexitäts- und Kollaborationsanforderungen zu erfüllen:

Mechanismus Geeignete Szenarien Zusammenarbeitsmethode Komplexität
Subagenten Fokussierte Aufgaben, bei denen nur die Ergebnisse zählen Einseitige Berichterstattung (Ergebnisse werden an den Hauptagenten zurückgegeben) Niedrig
Agent Teams Komplexe Arbeit, die Diskussion und Zusammenarbeit erfordert Mehrdirektionale Kommunikation (Teammitglieder senden sich gegenseitig direkt Nachrichten) Mittel
Git Worktree Mehrere Aufgaben, die isolierte Codeumgebungen erfordern Vollständig unabhängig (jeweils mit eigenem Arbeitsverzeichnis) Mittel

Auswahlvorschläge:

  • Für unabhängige Teilaufgaben, die einfach parallel verarbeitet werden müssen → verwendeSubagents
  • Für mehrere Agenten, die Arbeit besprechen und koordinieren müssen → verwendeAgent Teams
  • Für mehrere Aufgaben, die auf verschiedenen Branches desselben Repositorys ausgeführt werden müssen → verwendeGit Worktree

Subagenten

Was sind Subagenten?

Ein Subagent ist eine unabhängig laufende Claude-Instanz mit eigenem Kontext und Aufgabenfokus. Der Haupt-Claude kann mehrere Subagenten erstellen, von denen jeder für eine bestimmte Teilaufgabe verantwortlich ist:

┌─────────────────────────────────────────────────────────┐
│                    主 Claude                            │
│                    (协调者)                              │
└─────────────────────────────────────────────────────────┘
                        │
                        ▼
        ┌───────────────┼───────────────┐
        ▼               ▼               ▼
┌──────────┐    ┌──────────┐    ┌──────────┐
│ Agent A  │    │ Agent B  │    │ Agent C  │
│ 代码审查  │    │ 测试生成  │    │ 文档编写  │
└──────────┘    └──────────┘    └──────────┘
        │               │               │
        └───────────────┴───────────────┘
                        │
                        ▼
                 返回结果给主代理

Bis zu 49 Subagenten können parallel ausgeführt werden, was die meisten Anforderungen an die Parallelverarbeitung vollständig erfüllt.

Integrierte Subagenten

Claude Code enthält die folgenden integrierten Subagenten:

Agent Modell Werkzeuge Zweck
Explore Haiku (schnell, niedrige Latenz) Schreibgeschützte Werkzeuge Dateierkennung, Codesuche, Codebasis-Erkundung
Plan Erbt Hauptkonversation Schreibgeschützte Werkzeuge Codebasis-Recherche im Planungsmodus
General-purpose Erbt Hauptkonversation Alle Werkzeuge Komplexe Recherche, mehrstufige Vorgänge, Code-Modifikation
statusline-setup Sonnet — Führen Sie/statuslineStatuszeile konfigurieren
Claude Code Guide Haiku — Fragen zu den Funktionen von Claude Code beantworten

Erstellen eines Subagenten

Methode 1: Verwenden Sie den Befehl /agents

Führen Sie/agentsBefehl, und folgen Sie den Eingabeaufforderungen, um einen neuen Subagenten zu erstellen:

/agents

Wählen SieNeuen Agenten erstellen, wählen Sie dann einen Speicherort, beschreiben Sie die Funktionalität und lassen Sie Claude die Konfiguration generieren.

Methode 2: Subagenten-Datei manuell erstellen

Subagenten-Dateien verwenden YAML-Frontmatter für die Konfiguration, gefolgt vom System-Prompt in Markdown:

Beispiel

---
name
: code-reviewer
description
: Überprüft Code auf Qualität und Best Practices
tools
: Read, Glob, Grep
model
: sonnet
---

Du bist ein Code-Reviewer. Wenn du aufgerufen wirst, analysiere den Code und gib
spezifisches, umsetzbares Feedback zu Qualität, Sicherheit und Best Practices.

Subagent-Konfigurationsfelder

Feld Erforderlich Beschreibung
name Ja Eindeutiger Bezeichner mit Kleinbuchstaben und Bindestrichen
description Ja Beschreibt, wann Claude an diesen Subagenten delegieren soll
tools nein Liste der Tools, die der Subagent verwenden kann
disallowedTools nein Tools, die verweigert werden sollen
model nein Zu verwendendes Modell: sonnet, opus, haiku oder inherit
permissionMode nein Berechtigungsmodus: default, acceptEdits, auto, dontAsk, bypassPermissions, plan
maxTurns nein Maximale Agent-Turns, bevor der Subagent stoppt
skills nein Beim Start geladene Skills
mcpServers nein Für diesen Subagent verfügbare MCP-Server
memory nein Bereich des persistenten Speichers: user, project oder local
background nein Ob immer als Hintergrundaufgabe ausgeführt werden soll
isolation nein Auf worktree setzen, um in einem temporären git worktree ausgeführt zu werden

Steuerung der Subagent-Fähigkeiten

Tool-Einschränkungen

Beispiel

# Nur bestimmte Tools erlauben
---
name
: safe-researcher
description
: Forschungsagent mit eingeschränkten Fähigkeiten
tools
: Read, Grep, Glob, Bash
---

# Bestimmte Tools ausschließen
---
name
: no-writes
description
: Erbt jedes Tool außer Dateischreibvorgänge
disallowedTools
: Write, Edit
---

Modellauswahl

Beispiel

# Haiku verwenden (schnell, günstig)
---
name
: quick-searcher
description
: Schnelle Dateisuche
model
: haiku
---

# Opus verwenden (leistungsstark, teuer)
---
name
: deep-analyst
description
: Tiefgehende Codeanalyse
model
: opus
---

# Das Modell der Hauptkonversation erben
---
name
: general-purpose
model
: inherit
---

Subagenten aufrufen

Methode 1: Natürliche Sprache

Use the test-runner subagent to fix failing tests

Methode 2: @-Erwähnung

@"code-reviewer (agent)" look at the auth changes

Methode 3: Start über die Kommandozeile

claude --agent code-reviewer

Vordergrund- und Hintergrundausführung

  • Vordergrund-Subagent: Blockiert die Hauptkonversation bis zum Abschluss
  • Hintergrund-Subagent: Läuft parallel, drücke zumCtrl+Bswitch

Agent Teams

Was sind Agent-Teams

Agent Teams ermöglicht es Ihnen, mehrere zusammenarbeitende Claude-Code-Instanzen zu koordinieren. Stellen Sie sich vor, Sie führen gleichzeitig 4 Claude-Sitzungen (A, B, C, D) aus, wobei eine als Teamleiter fungiert und für die Koordination der Arbeit, die Zuweisung von Aufgaben und die Integration der Ergebnisse verantwortlich ist. Die anderen drei Mitglieder arbeiten jeweils unabhängig mit ihren eigenen Kontextfenstern, können aber auch direkt miteinander kommunizieren.

Subagenten vs. Agent Teams

Eigenschaften Subagenten Agent Teams
Kontext Eigenes Kontextfenster; Ergebnisse werden an den Aufrufer zurückgegeben Eigenes Kontextfenster; völlig unabhängig
Kommunikation Meldet Ergebnisse nur an den Hauptagenten Nachrichten direkt zwischen Teammitgliedern austauschen
Koordination Der Hauptagent verwaltet die gesamte Arbeit Gemeinsame Aufgabenliste, unterstützt Selbstkoordination
Am besten geeignet für Fokussierte Aufgaben, bei denen nur die Ergebnisse beachtet werden müssen Komplexe Arbeit, die Diskussion und Zusammenarbeit erfordert
Token-Kosten Niedriger: Ergebnisse werden zurück in den Hauptkontext zusammengefasst Höher: Jedes Teammitglied ist eine unabhängige Claude-Instanz

Einfach ausgedrückt:Ein Subagent ist wie ein Mitarbeiter, der dem Chef Bericht erstattet; Agent Teams ist eine Projektgruppe von Gleichgestellten, die gleichberechtigt zusammenarbeiten.。

Agent Teams aktivieren

Agent Teams ist standardmäßig deaktiviert. Sie müssen es hinzufügen insettings.json:

Beispiel

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Oder setzen Sie die Umgebungsvariable:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Voraussetzungen: Claude Code v2.1.32 oder höher

Ein Agent Team starten

Beschreiben Sie nach der Aktivierung die Aufgabe und die Teamstruktur in natürlicher Sprache:

Beispiel

Ich entwerfe ein CLI-Tool, das Entwicklern hilft, TODO-Kommentare zu verfolgen in
ihrer Codebasis. Erstelle ein Agent Team, um dies aus verschiedenen Blickwinkeln zu untersuchen: einer
Teammitglied für UX, eines für technische Architektur, eines als Advocatus Diaboli.

Steuerung eines Agententeams

Anzeigemodus

  • In-process: Alle Teammitglieder laufen im Hauptterminal, verwenden SieShift+Downzum Wechseln zwischen Teammitgliedern
  • Geteilte Panes: Jedes Teammitglied erhält ein eigenes tmux/iTerm2-Pane

Beispiel

{
  "teammateMode": "in-process"
}

Angeben der Anzahl von Teammitgliedern und Modellen

Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.

Aufgabenzuweisung

  • Der Lead kann Aufgaben explizit zuweisen
  • Teammitglieder können sich nicht zugewiesene, nicht blockierte Aufgaben selbst zuweisen
  • Aufgaben haben drei Zustände: ausstehend, in Bearbeitung und abgeschlossen

Interaktion mit Teammitgliedern

  • Prozessintern:Shift+DownDurchschalten → Nachricht eingeben →EnterAnsicht →EscapeUnterbrechen
  • Geteilter Bereich: Auf den Bereich eines Teammitglieds klicken, um direkt zu interagieren

Teammitglieder schließen

Ask the researcher teammate to shut down

Agent-Teams-Architektur

Komponenten Rollen
Teamleitung Die Hauptsitzung von Claude Code, die das Team erstellt, Teammitglieder startet und die Arbeit koordiniert
Teammitglieder Unabhängige Instanzen von Claude Code, die jeweils zugewiesene Aufgaben bearbeiten
Aufgabenliste Eine gemeinsame Liste von Arbeitselementen, die Teammitglieder übernehmen und abschließen
Mailbox Ein Nachrichtensystem für die Kommunikation zwischen Agenten

Speicherort:

  • Team-Konfiguration: ~/.claude/teams/{team-name}/config.json
  • Aufgabenliste: ~/.claude/tasks/{team-name}/

Git-Worktree-Unterstützung

Problemhintergrund

Wenn mehrere Agenten gleichzeitig arbeiten, können sie miteinander „kämpfen“. Stellen Sie sich folgendes Szenario vor: Sie bitten Agent A, das Datenbankmodul zu refaktorieren, und Agent B, einen Fehler auf der Anmeldeseite zu beheben. Die beiden Aufgaben scheinen nichts miteinander zu tun zu haben, aber beide arbeiten im selben Code-Repository und am selben Branch. Agent A ändertutils.py, und Agent B ändert ebenfallsutils.py. Einer speichert eine Version, der andere überschreibt sie mit einer anderen Version, was letztlich zu Konflikten, Fehlern und sogar Datenverlust führt.

Das ist kein KI-Problem; es ist eine Einschränkung der zugrunde liegenden Git-Repository-Struktur.

Was ist Git Worktree

Git Worktree ist eine Git-Funktion, mit der du mehrere unabhängige Arbeitsverzeichnisse an dasselbe Repository mounten kannst. Jedes Arbeitsverzeichnis hat seinen eigenen Branch, seinen eigenen HEAD und seinen eigenen Staging-Bereich, aber sie alle teilen dieselbe.gitDatenbank (Historie, Objektspeicher).

Analogie

Alltagsanalogie: "Dasselbe Unternehmen (Haupt-Repository) hat mehrere Büros (Worktrees),
jedes Büro hat ein anderes Team (Agent), das an einem anderen Projekt (Branch) arbeitet,
aber sie alle teilen die Datenbank (.git) und die Historie des Unternehmens."

Git Worktree verwenden

Starten über die Kommandozeile

# 创建 feature-auth 分支的工作树
claude -w feature-auth

# 同时创建 tmux 会话
claude -w feature-auth --tmux

# 使用传统 tmux
claude -w feature-auth --tmux=classic

CLI-Parameter

Parameter Beschreibung Beispiel
--worktree, -w Claude in einem isolierten Git-Worktree starten claude -w feature-auth
--tmux Eine tmux-Sitzung für den Worktree erstellen claude -w feature-auth --tmux

Worktree-Erstellungsort:<repo>/.claude/worktrees/<name>

Desktop-Unterstützung

In der Claude-Desktop-App zum Code-Tab gehen und einfach den Worktree-Modus anhaken, um den Workspace-Modus zu aktivieren.

Subagent + Worktree-Isolation

Du kannst benutzerdefinierte Subagents immer in ihrem eigenen Worktree ausführen lassen:

Beispiel

---
name
: background-refactorer
description
: Hintergrund-Refactoring-Agent
isolation
: worktree
---

Anwendungsbeispiele

Beispiel 1: Paralleles Code-Review

Subagents verwenden

# Lasse mehrere Subagents gleichzeitig verschiedene Aspekte des Codes überprüfen
Verwende den security-reviewer-Subagent, um Sicherheitsprobleme zu prüfen
Verwende den performance-reviewer-Subagent, um die Auswirkungen auf die Performance zu analysieren
Verwende den test-coverage-Subagent, um die Testabdeckung zu validieren

Verwendung von Agent Teams

Erstelle ein Agent-Team, um PR #142 zu überprüfen. Erzeuge drei Reviewer:
- Einer konzentriert sich auf Sicherheitsauswirkungen
- Einer prüft die Auswirkungen auf die Performance
- Einer validiert die Testabdeckung
Lass sie jeweils überprüfen und die Ergebnisse melden.

Beispiel 2: Parallele Recherche

Research the authentication, database, and API modules in parallel using separate subagents

Beispiel 3: Untersuchung mit konkurrierenden Hypothesen

Beispiel

Benutzer berichten, dass sich die App nach einer Nachricht beendet, anstatt verbunden zu bleiben.
Erzeuge 5 Agent-Teammitglieder, um verschiedene Hypothesen zu untersuchen. Lass sie mit ... sprechen
einander, um zu versuchen, die Theorien des jeweils anderen zu widerlegen, wie in einer wissenschaftlichen
Debatte. Aktualisiere das Ergebnisdokument mit dem Konsens, der sich ergibt.

Beispiel 4: Multi-Branch-Entwicklung

# 终端 1:重构用户模块
claude -w feature/user-refactor

# 终端 2:修复登录 bug
claude -w bugfix/login-issue

# 终端 3:开发新功能
claude -w feature/new-dashboard

Beispiel 5: Verketten von Subagenten

Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them

Best Practices

Bewährte Methoden für Subagenten

  1. Fokussiert bleiben: Jeder Subagent sollte eine klare, einzige Verantwortung haben
  2. Werkzeuge beschränken: Beschränke den Werkzeugzugriff für Subagenten basierend auf den Aufgabenanforderungen
  3. Passendes Modell wählen: Verwende Haiku für einfache Aufgaben, Sonnet oder Opus für komplexe Aufgaben
  4. Hintergrundausführung verwenden: Verwende Hintergrund-Subagenten für lang laufende Aufgaben, um zu vermeiden, dass die Hauptunterhaltung blockiert wird
  5. Subagent fortsetzen: Wenn du die Arbeit fortsetzen musst, bitte Claude, den Subagenten fortzusetzen

Bewährte Methoden für Agent Teams

  1. Teammitgliedern genügend Kontext geben: Füge aufgabenspezifische Details in die generierten Prompts ein
  2. Wähle eine angemessene Teamgröße: Die meisten Workflows beginnen mit 3-5 Teammitgliedern
  3. Aufgaben richtig dimensionieren: 5-6 Aufgaben pro Teammitglied halten die Produktivität hoch
  4. Auf Fertigstellung der Teammitglieder warten: Weise die Leitung an, mit dem Fortfahren zu warten, bis die Teammitglieder fertig sind
  5. Mit Recherche und Überprüfung beginnen: Beginne mit Aufgaben, die kein Schreiben von Code erfordern
  6. Dateikonflikte vermeiden: Teile die Arbeit so auf, dass jedes Teammitglied einen anderen Satz Dateien verantwortet
  7. Überwachen und Anleiten: Prüfe den Fortschritt und lenke Ansätze um, die nicht funktionieren

Best Practices für Git Worktree

  1. Ein Worktree pro Aufgabe: Vermeide es, im selben Worktree an mehreren nicht zusammenhängenden Aufgaben zu arbeiten
  2. tmux-Verwaltung verwenden: Wenn du mehrere Claude-Sitzungen gleichzeitig ausführst, nutze tmux zum einfachen Wechseln
  3. Nicht benötigte Worktrees bereinigen: Lösche Worktrees zeitnah nach Abschluss der Aufgabe

Fehlerbehebung

FAQ zu Agent-Teams

Problem Lösung
Teammitglied erscheint nicht Prüfen, ob die Aufgabe komplex genug ist und ob tmux installiert ist
Zu viele Berechtigungsaufforderungen Häufige Vorgänge in den Berechtigungseinstellungen vorab genehmigen
Teammitglied stoppt nach einem Fehler Ausgabe prüfen und zusätzliche Anweisungen geben oder ein Ersatz-Teammitglied starten
Leitung beendet frühzeitig Die Leitung anweisen, fortzufahren oder zu warten, bis die Teammitglieder fertig sind
Verwaiste tmux-Sitzungen Verwenden Sietmux lsundtmux kill-session -t <session-name>Aufräumen

Praktische Subagent-Beispiele

Code-Reviewer

Beispiel

---
name
: code-reviewer
description
: Erfahrener Code-Review-Spezialist. Überprüft Code proaktiv auf Qualität, Sicherheit und Wartbarkeit.
tools
: Read, Grep, Glob, Bash
model
: inherit
---

Sie sind ein Senior-Code-Reviewer, der hohe Standards für Codequalität und Sicherheit gewährleistet.

Bei Aufruf
:
1. Führen Sie git diff aus, um die letzten Änderungen zu sehen
2. Konzentrieren Sie sich auf geänderte Dateien
3. Beginnen Sie sofort mit der Überprüfung

Checkliste für die Überprüfung
:
- Der Code ist klar und lesbar
- Funktionen und Variablen sind gut benannt
- Kein duplizierter Code
- Ordnungsgemäße Fehlerbehandlung
- Keine offengelegten Geheimnisse oder API-Schlüssel
- Eingabevalidierung implementiert
- Gute Testabdeckung
- Performance-Aspekte berücksichtigt

Gib Feedback nach Priorität geordnet
:
- Kritische Probleme (müssen behoben werden)
- Warnungen (sollten behoben werden)
- Vorschläge (Verbesserungen in Betracht ziehen)

Debugger

Beispiel

---
name
: debugger
description
: Debugging-Spezialist für Fehler, Testfehler und unerwartetes Verhalten.
tools
: Read, Edit, Bash, Grep, Glob
---

Du bist ein erfahrener Debugger, der auf Ursachenanalyse spezialisiert ist.

Bei Aufruf
:
1. Fehlermeldung und Stacktrace erfassen
2. Reproduktionsschritte identifizieren
3. Fehlerstelle isolieren
4. Minimalen Fix implementieren
5. Überprüfen, ob die Lösung funktioniert

Debugging-Prozess
:
- Fehlermeldungen und Logs analysieren
- Kürzliche Codeänderungen prüfen
- Hypothesen bilden und testen
- Strategisches Debug-Logging hinzufügen
- Variablenzustände untersuchen

Schreibgeschütztes Datenbankabfrage-Tool

Beispiel

---
name
: db-reader
description
: Führe schreibgeschützte Datenbankabfragen aus. Verwende dies beim Analysieren von Daten oder Erstellen von Berichten.
tools
: Bash
hooks
:
  PreToolUse
:
    - matcher
: "Bash"
      hooks
:
        - type
: command
          command
: "./scripts/validate-readonly-query.sh"
---

Du bist ein Datenbankanalyst mit schreibgeschütztem Zugriff. Führe SELECT-Abfragen aus, um Fragen zu den Daten zu beantworten.
Andere Erweiterungen