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
---
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
---
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 zum
Ctrl+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
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 Sie
Shift+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
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
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
- 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
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
- Fokussiert bleiben: Jeder Subagent sollte eine klare, einzige Verantwortung haben
- Werkzeuge beschränken: Beschränke den Werkzeugzugriff für Subagenten basierend auf den Aufgabenanforderungen
- Passendes Modell wählen: Verwende Haiku für einfache Aufgaben, Sonnet oder Opus für komplexe Aufgaben
- Hintergrundausführung verwenden: Verwende Hintergrund-Subagenten für lang laufende Aufgaben, um zu vermeiden, dass die Hauptunterhaltung blockiert wird
- Subagent fortsetzen: Wenn du die Arbeit fortsetzen musst, bitte Claude, den Subagenten fortzusetzen
Bewährte Methoden für Agent Teams
- Teammitgliedern genügend Kontext geben: Füge aufgabenspezifische Details in die generierten Prompts ein
- Wähle eine angemessene Teamgröße: Die meisten Workflows beginnen mit 3-5 Teammitgliedern
- Aufgaben richtig dimensionieren: 5-6 Aufgaben pro Teammitglied halten die Produktivität hoch
- Auf Fertigstellung der Teammitglieder warten: Weise die Leitung an, mit dem Fortfahren zu warten, bis die Teammitglieder fertig sind
- Mit Recherche und Überprüfung beginnen: Beginne mit Aufgaben, die kein Schreiben von Code erfordern
- Dateikonflikte vermeiden: Teile die Arbeit so auf, dass jedes Teammitglied einen anderen Satz Dateien verantwortet
- Überwachen und Anleiten: Prüfe den Fortschritt und lenke Ansätze um, die nicht funktionieren
Best Practices für Git Worktree
- Ein Worktree pro Aufgabe: Vermeide es, im selben Worktree an mehreren nicht zusammenhängenden Aufgaben zu arbeiten
- tmux-Verwaltung verwenden: Wenn du mehrere Claude-Sitzungen gleichzeitig ausführst, nutze tmux zum einfachen Wechseln
- 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.