# Was ist ein Subagent?

URL: https://agentvera.dev/de/glossary/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.

- **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.

---

**Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/