Was ist ein Subagent?
Ein Subagent ist ein Hilfsagent, den ein Haupt-Coding-Agent startet, um eine bestimmte Aufgabe abzugeben. Er hat ein eigenes Kontextfenster, eigene Anweisungen und eigene Tool-Berechtigungen und liefert am Ende nur eine Zusammenfassung zurück, sodass sich die Hauptunterhaltung nicht mit Details füllt.
So funktioniert es
Der Hauptagent übergibt einem Subagenten einen Job, etwa die Codebasis zu durchsuchen, Tests auszuführen und Fehlschläge zusammenzufassen oder eine Änderung zu prüfen. Der Subagent startet mit sauberem Kontext; die Dateien, die er liest, und die Befehlsausgaben, die er sieht, bleiben in seinem eigenen Fenster, und der Hauptagent erhält nur das Ergebnis. Mehrere Subagenten können gleichzeitig laufen.
Subagenten in Claude Code definieren
In Claude Code sind Subagenten Markdown-Dateien mit YAML-Frontmatter. Projekt-Subagenten liegen in .claude/agents/ und persönliche in ~/.claude/agents/; verwalten kannst du sie auch mit dem Befehl /agents.
- name und description: wie der Subagent heißt und wann er zu nutzen ist. Der Hauptagent entscheidet anhand dieser Beschreibung.
- tools: welche Tools er verwenden darf, zum Beispiel nur lesende Tools für einen Reviewer.
- model: optional ein anderes Modell für den Subagenten.
- Der Rumpf der Datei ist der System-Prompt des Subagenten.
Wann Subagenten helfen
Subagenten zahlen sich am meisten aus, wenn du die Hauptunterhaltung sauber halten willst.
- Recherche, die viele Dateien liest: Die Details bleiben im Subagenten, und der Hauptkontext bleibt klein.
- Spezialisierte Rollen: Security-Review, Tests schreiben, Dokumentation.
- Parallele Erkundung: Mehrere Subagenten durchsuchen gleichzeitig verschiedene Module.
Grenzen
Ein Subagent sieht den Verlauf der Hauptunterhaltung nicht, daher muss seine Aufgabe für sich allein verständlich sein. Weil jeder Subagent seinen Kontext von Grund auf aufbaut, kann der Gesamtverbrauch an Tokens steigen. Subagenten arbeiten meist im selben Ordner wie der Hauptagent, daher können parallele Subagenten, die Dateien bearbeiten, einander in die Quere kommen.
Subagenten in AgentVera
AgentVera macht die Subagenten sichtbar, die Claude Code startet. Die Ansicht „Subagents“ im Projekt-Rundgang und im Fenster der Code-Karte listet die Subagenten auf, die ein Claude-Code-Agent gestartet hat.
- Für jeden: Typ, ob er im Hintergrund lief, Status, Anzahl der Tools und Dauer, dazu eine Zeitleiste seiner Schritte.
- Es liest lokale Transkripte und funktioniert vorerst mit lokalen Claude-Code-Agenten.
- Die Aufgabenlinie, die Team-Ansicht und das Parallel Team nutzen statt Subagenten eigene, sichtbare Agenten: Jeder hat sein eigenes Pane und seine eigene Unterhaltung, und du kannst direkt mit ihm sprechen.
- Projekt-Tour und Code-MapLerne ein Projekt per Tour kennen, sieh Modulabhängigkeiten und die Dateien, die am häufigsten kaputtgehen.
- Task LineReihe Aufgaben ein und lass jede nacheinander Analysis-, Plan-, Build- und Review-Agents durchlaufen.
- Team-AnsichtMach aus deinen offenen Agenten ein Team mit Manager, Rollen und Berichtswegen und sieh ihm live bei der Arbeit zu.
FAQ
Wie unterscheidet sich ein Subagent von einer eigenen Agenten-Session?
Der Hauptagent startet einen Subagenten und erhält dessen Ergebnis zurück; du siehst meist nur die Zusammenfassung. Eine eigene Session läuft für sich, und du sprichst direkt mit ihr.
Sparen Subagenten Tokens?
Sie halten den Kontext der Hauptunterhaltung klein, was bei langen Sessions hilft. Aber auch das Lesen des Subagenten kostet Tokens, sodass der Gesamtverbrauch steigen kann.
Kann ein Subagent Dateien bearbeiten?
Das hängt von den Tools ab, die seine Definition erlaubt. Ein Subagent mit nur Read, Grep und Glob kann Code lesen, aber nicht ändern.
Wohin gehören Subagent-Dateien?
Dateien, die dein Team teilen soll, kommen nach .claude/agents/ im Projekt; solche, die nur du nutzt, nach ~/.claude/agents/. Dateien im Projektordner erreichen dein Team über Git.