Zum Inhalt springen

Subagents & Delegation

Stell dir vor, du sitzt an deinem Schreibtisch und arbeitest an einem komplexen Feature. Plötzlich brauchst du eine Information: Wie ist die Authentifizierung in diesem Projekt aufgebaut? Du könntest selbst durch hunderte Dateien suchen -- oder du schickst einen Kollegen los, der das für dich recherchiert und dir in zwei Sätzen das Ergebnis mitteilt.

Genau so funktionieren Subagents in Claude Code. Ein Subagent ist ein spezialisierter Assistent mit eigenem Schreibtisch -- eigenem Kontext, eigenen Tools und einer klar definierten Aufgabe. Er arbeitet isoliert, damit dein Hauptkontext sauber bleibt, und liefert am Ende nur das Ergebnis zurück.

Warum Subagents?

Das Context Window ist die wertvollste Ressource in Claude Code. Jede Datei, die gelesen wird, jede Suche, jedes Tool-Ergebnis -- alles belegt Platz. Subagents lösen dieses Problem elegant:

  • Isolierter Kontext: Der Subagent liest 50 Dateien, aber nur die Zusammenfassung kommt in deinen Hauptkontext
  • Spezialisierung: Jeder Subagent kann eigene Tools, ein eigenes Modell und spezifische Anweisungen haben
  • Parallelität: Mehrere Subagents können gleichzeitig an verschiedenen Aufgaben arbeiten
  • Kosteneffizienz: Einfache Aufgaben laufen auf günstigeren Modellen wie Haiku

iAnalogie: Das Büro-Team

Dein Hauptagent ist der Projektleiter. Er delegiert Aufgaben an Spezialisten (Subagents), die jeweils an ihrem eigenen Schreibtisch arbeiten. Der Projektleiter bekommt nur die fertigen Ergebnisse -- nicht die ganzen Notizen und Zwischenschritte. So bleibt sein Schreibtisch aufgeräumt.

Built-in vs. Custom Agents

Claude Code bringt drei eingebaute Subagents mit, die automatisch verfügbar sind:

  1. Explore -- ein schneller, schlanker Agent für Codebase-Recherche
  2. Plan -- ein planender Agent für komplexe Aufgabenzerlegung
  3. General-purpose -- ein vollwertiger Agent für anspruchsvolle Teilaufgaben

Darüber hinaus kannst du Custom Agents erstellen: spezialisierte Agenten mit eigenem System-Prompt, eingeschränkten Tools und dediziertem Modell. Sie werden als Markdown-Dateien in .claude/agents/ definiert und sind sofort einsetzbar.

Was dich erwartet

  • Agent-Typen & Konfiguration -- Die drei Built-in Agents und wie du eigene Custom Agents erstellst
  • Kontextmanagement & Worktrees -- Wie Subagents isoliert arbeiten, Git Worktrees nutzen und im Hintergrund laufen
  • Delegationsstrategien -- Wann du welchen Agent-Typ einsetzt und wie du Kosten optimierst

*Lernziel

Nach diesem Modul kannst du Subagents gezielt einsetzen, Custom Agents für wiederkehrende Aufgaben konfigurieren und die richtige Delegationsstrategie für verschiedene Szenarien wählen.

Reflektieren

Subagents sind der Schlüssel zu effizienter Arbeit mit Claude Code bei größeren Projekten. Sie halten deinen Kontext sauber, ermöglichen paralleles Arbeiten und senken die Kosten. Im nächsten Abschnitt schauen wir uns die verschiedenen Agent-Typen im Detail an.