Sub-Agents¶

Claude Code kann komplexe Aufgaben an spezialisierte Sub-Agents delegieren. Diese arbeiten parallel oder sequentiell und berichten zurück an den Haupt-Agent.

Konzept¶

Sub-Agents sind eigenständige Claude-Instanzen mit:

Eigenem Context Window
Spezifischem Fokus auf eine Teilaufgabe
Reduziertem Tool-Set (nur was sie brauchen)
Günstigerem Model (typisch: Haiku)

Wann Sub-Agents nutzen?¶

Szenario	Beispiel
Parallele Recherche	"Analysiere 5 verschiedene Dateien gleichzeitig"
Code Review	"Prüfe Security, Performance und Style parallel"
Refactoring	"Aktualisiere alle API-Calls in separaten Agents"
Testing	"Schreibe Tests für jedes Modul unabhängig"

Konfiguration¶

Model für Sub-Agents¶

In ~/.claude/settings.json:

{
  "agentSettings": {
    "subAgentModel": "claude-haiku-4-20250514"
  }
}

Verfügbare Optionen:

claude-opus-4-20250514 - Für komplexe Sub-Tasks (teuer)
claude-sonnet-4-20250514 - Balanced (default)
claude-haiku-4-20250514 - Für einfache, schnelle Tasks (empfohlen)

Tool-Beschränkungen¶

Sub-Agents können auf bestimmte Tools limitiert werden:

{
  "agentSettings": {
    "allowedTools": ["Read", "Glob", "Grep"]
  }
}

Praktische Beispiele¶

Parallele Code-Analyse¶

Analysiere diese 3 Module parallel:
- src/auth/ → Security-Review
- src/api/ → API-Design-Review  
- src/db/ → Performance-Review

Fasse die Ergebnisse zusammen.

Claude spawnt 3 Sub-Agents, jeder analysiert seinen Bereich, Ergebnisse werden konsolidiert.

Bulk-Refactoring¶

Refactore alle Controller in src/controllers/:
- Ersetze callbacks durch async/await
- Nutze für jeden Controller einen eigenen Agent

Monitoring¶

Sub-Agent-Aktivität ist sichtbar in:

Terminal-Output (mit Prefix [SubAgent])
/status zeigt aktive Sub-Agents
Token-Usage wird separat getrackt

Best Practices¶

Haiku für Sub-Agents - 90% der Sub-Tasks brauchen kein Opus
Klare Scope-Definition - Je präziser der Auftrag, desto besser
Tool-Limits setzen - Sub-Agents brauchen selten alle Tools
Nicht übertreiben - 3-5 parallele Agents sind meist genug

Kosten-Implikation¶

Model	Input/1M	Output/1M	Typischer Sub-Task
Opus	$15	$75	~$0.50
Sonnet	$3	$15	~$0.10
Haiku	$0.25	$1.25	~$0.01

Bei 10 Sub-Agents pro Session spart Haiku vs Opus ~$4.90 pro Session.