Claude Code Subagenten: Spezialisierte KI-Helfer nutzen

Stell dir vor, du hast ein kleines Team von Spezialisten an deiner Seite: Eine Person kümmert sich nur um Code-Reviews, eine andere schreibt Tests, eine dritte durchforstet die Doku. Genau dieses Gefühl bekommst du mit Claude Code Subagenten. Ein Subagent (oder englisch „Subagent“) ist wie ein spezialisierter Mitarbeiter, dem du eine klar umrissene Teilaufgabe gibst – und der sie erledigt, ohne dass du selbst jeden Schritt begleiten musst. In diesem Artikel zeige ich dir als Solopreneur oder Entwickler, was Claude Code Subagenten eigentlich sind, wozu sie taugen und wie du dir deine eigenen kleinen Helfer baust. Keine Sorge: Es bleibt praxisnah, und Fachbegriffe erkläre ich unterwegs.

Was sind Subagenten in Claude Code?

Subagenten sind eigenständige Helfer innerhalb von Claude Code. Das Besondere: Jeder Subagent arbeitet mit einem eigenen Kontextfenster. Das Kontextfenster ist quasi der „Arbeitsspeicher“ oder das Kurzzeitgedächtnis der KI – also alles, was sie in einem Gespräch gerade im Blick hat. Wenn du selbst mit Claude Code chattest, läuft das im Hauptkontext. Ein Subagent bekommt dagegen seinen eigenen, frischen Arbeitsspeicher.

Warum ist das nützlich? Weil der Subagent eine abgegrenzte Aufgabe übernimmt, ohne deinen Hauptchat vollzumüllen. Stell dir vor, du lässt jemanden 30 Dateien durchsuchen. Wenn das alles in deinem Hauptgespräch landen würde, wäre der „Schreibtisch“ schnell überladen. Der Subagent erledigt die Wühlarbeit in seinem eigenen Raum und gibt dir am Ende nur das saubere Ergebnis zurück.

Ein Subagent hat dabei eine klare Rolle, eine eigene Beschreibung seiner Aufgabe und kann auf bestimmte Werkzeuge (Tools) beschränkt werden. So entsteht ein echter Spezialist statt eines Alleskönners, der alles ein bisschen kann.

Wozu sind Claude Code Subagenten gut?

Der größte Gewinn liegt in drei Punkten, die zusammen deinen Arbeitsalltag spürbar entspannen:

• Aufgaben parallelisieren: Du kannst mehrere Subagenten gleichzeitig loslaufen lassen. Während einer die Tests schreibt, prüft ein anderer die Sicherheit. Das spart Zeit, vor allem bei größeren Projekten.
• Hauptkontext sauber halten: Weil jeder Subagent sein eigenes Kontextfenster hat, bleibt dein Hauptgespräch übersichtlich. Du verlierst nicht den Faden, nur weil im Hintergrund 500 Zeilen Log analysiert wurden.
• Echte Spezialisten: Du definierst dir Helfer für wiederkehrende Aufgaben – einen Code-Reviewer, der deinen Code kritisch prüft, einen Test-Schreiber, der zuverlässig Tests erstellt, oder einen Recherche-Agenten für die Dokumentation. Jeder bekommt genau die Anweisungen, die er für seinen Job braucht.

Gerade als Solopreneur ohne großes Team fühlst du dich damit, als hättest du plötzlich ein paar fleißige Kollegen, die dir Routinearbeit abnehmen.

Wie verwaltest und erstellst du Subagenten?

Der einfachste Einstieg ist der Slash-Command /agents. Slash-Commands sind Befehle, die du direkt in Claude Code mit einem Schrägstrich eintippst. Wenn du /agents eingibst, öffnet sich eine Übersicht, in der du bestehende Subagenten ansehen, bearbeiten oder neue per geführtem Dialog anlegen kannst. Für den Anfang ist das der bequemste Weg.

Unter der Haube ist jeder Subagent einfach eine Markdown-Datei (eine simple Textdatei mit leichter Formatierung). Sie liegt im Ordner .claude/agents/ deines Projekts. Oben in der Datei steht ein kleiner Info-Block – das sogenannte Frontmatter. Das ist nur ein abgegrenzter Bereich am Dateianfang (zwischen zwei Linien aus drei Bindestrichen), in dem die Eckdaten des Subagenten stehen: sein Name, eine Beschreibung, welche Tools er nutzen darf und welches Modell er verwenden soll. Danach folgt der eigentliche Text – die Anweisung, wie sich der Helfer verhalten soll.

So sieht eine einfache Subagent-Definition aus:

---
name: code-reviewer
description: Prüft geänderten Code kritisch auf Bugs, Lesbarkeit und Sicherheit. Proaktiv nach Code-Änderungen einsetzen.
tools: Read, Grep, Glob, Bash
model: sonnet
---

Du bist ein erfahrener Code-Reviewer.

Wenn du aufgerufen wirst:
- Sieh dir die zuletzt geänderten Dateien an.
- Achte auf Bugs, unklare Benennungen und Sicherheitslücken.
- Gib konkrete, freundliche Verbesserungsvorschläge.

Halte dein Feedback kurz und priorisiere die wichtigsten Punkte zuerst.

Die Felder im Frontmatter bedeuten konkret: name ist der Aufrufname, description erklärt Claude, wann dieser Subagent sinnvoll ist (danach wählt Claude ihn oft automatisch aus), tools grenzt die erlaubten Werkzeuge ein, und model legt das KI-Modell fest. Hier hast du 2026 die Wahl zwischen Opus 4.8 (am stärksten, für knifflige Aufgaben), Sonnet 4.6 (ausgewogen, der Allrounder) und Haiku 4.5 (schnell und günstig für einfache Jobs). Lässt du tools oder model weg, erbt der Subagent einfach die Standardeinstellungen.

Tipp: Lege Subagenten, die nur für ein bestimmtes Projekt gelten, in dessen Ordner .claude/agents/ ab. Helfer, die du überall nutzen willst, kannst du global im Verzeichnis ~/.claude/agents/ in deinem Benutzerordner ablegen.

Subagenten vs. Skills vs. Plugins

Diese drei Begriffe werden gern verwechselt, machen aber unterschiedliche Dinge:

• Subagenten sind eigenständige Helfer mit eigenem Kontextfenster, die eine Teilaufgabe übernehmen. Denk an einen delegierten Mitarbeiter.
• Skills sind eher Wissens- und Fähigkeitspakete: Anleitungen und Ressourcen, die Claude bei einer bestimmten Art von Aufgabe heranzieht – ohne dafür einen separaten Kontext aufzumachen. Denk an ein Handbuch, das aufgeschlagen wird, wenn es gebraucht wird.
• Plugins sind Bündel, die mehrere Dinge zusammenpacken und verteilbar machen – etwa Slash-Commands, Subagenten oder Skills in einem installierbaren Paket. Denk an eine Toolbox, die du als Ganzes teilen kannst.

Faustregel: Du willst eine Aufgabe delegieren? Subagent. Du willst Claude eine Fähigkeit beibringen? Skill. Du willst mehreres bündeln und weitergeben? Plugin.

Best Practices für Subagenten

• Eine Aufgabe pro Subagent: Je klarer die Rolle, desto besser das Ergebnis. Ein Helfer, der reviewt und deployt und dokumentiert, wird mittelmäßig in allem.
• Schreib eine präzise description: Sie entscheidet, ob Claude den richtigen Subagenten automatisch erkennt. Formulierungen wie „proaktiv nach Code-Änderungen einsetzen“ helfen enorm.
• Werkzeuge bewusst einschränken: Ein Recherche-Agent braucht keinen Schreibzugriff. Weniger Tools bedeuten weniger Risiko und klareres Verhalten.
• Modell zur Aufgabe wählen: Für einfache, wiederholte Aufgaben reicht oft Haiku 4.5. Für anspruchsvolle Reviews lohnt sich Opus 4.8.
• Klein anfangen: Bau dir erst ein, zwei Subagenten, die echte Routine abnehmen. Lieber wenige, die du wirklich nutzt, als ein Dutzend Karteileichen.

FAQ zu Claude Code Subagenten

Brauche ich Programmierkenntnisse, um Subagenten zu nutzen?

Nein. Über den Slash-Command /agents wirst du Schritt für Schritt durch die Erstellung geführt. Du musst keine komplizierte Syntax auswendig lernen. Die Markdown-Datei im Hintergrund kannst du später anschauen, sobald du neugierig wirst.

Verbrauchen Subagenten mehr Tokens beziehungsweise Kosten?

Da jeder Subagent ein eigenes Kontextfenster nutzt, entsteht durchaus zusätzliche Arbeit für die KI. Gleichzeitig sparst du oft Tokens im Hauptchat, weil die Wühlarbeit ausgelagert wird. Wer kostenbewusst arbeitet, wählt für einfache Subagenten bewusst ein schlankes Modell wie Haiku 4.5.

Wann wird ein Subagent automatisch aufgerufen?

Claude entscheidet anhand der description im Frontmatter, ob ein Subagent zur aktuellen Aufgabe passt. Du kannst ihn aber auch jederzeit gezielt selbst anstoßen, indem du in deiner Anfrage explizit darum bittest.

Fazit

Claude Code Subagenten sind wie ein kleines Team aus Spezialisten, das dir Routinearbeit abnimmt – jeder mit eigener Rolle, eigenem Kontextfenster und klarem Auftrag. Du parallelisierst Aufgaben, hältst deinen Hauptchat sauber und baust dir nach und nach echte Helfer für Code-Reviews, Tests oder Recherche. Der Einstieg ist dank /agents erstaunlich niederschwellig: Fang mit einem einzigen Subagenten an, der dir wirklich Arbeit spart, und erweitere von dort. Du wirst schnell merken, wie viel entspannter sich Entwicklung anfühlt, wenn du delegieren kannst.