Der kleine Helfer

Was es ist und warum es zählt

Ein Subagent ist ein Helfer, den Claude für eine bestimmte Aufgabe startet. Er hat einen ganz eigenen Kontext: Er öffnet Dateien, sucht, liest, und am Ende bekommst du nur die Zusammenfassung zurück. Alles, was er unterwegs gelesen hat, bleibt bei ihm und landet nicht in deiner Unterhaltung.

Warum das zählt: Die Hauptunterhaltung hat nur begrenzt Platz. Wenn Claude fünfzig Dateien öffnet, um herauszufinden, wo der Login steckt, füllt dieser ganze Text den Chat, und nach einer Weile verliert Claude leichter den Faden. Mit einem Subagent übernimmt der Helfer die Suche, und bei dir kommt eine Antwort von wenigen Zeilen an.

„Klein“ heißt hier, dass er nur eine Aufgabe erledigt, nicht, dass er weniger kann: Ein Subagent nutzt meistens dasselbe Modell wie die Hauptunterhaltung. In normalen Sitzungen arbeitet er meistens im Hintergrund, und du redest in der Zwischenzeit weiter mit Claude.

Claude Code hat schon ein paar fertige dabei. Den, den ich am meisten nutze, heißt Explore: Er sucht und versteht Code und kann nur lesen, das heißt, er kann keine Dateien schreiben oder ändern. Dann gibt es die, die du selbst anlegst, dazu weiter unten mehr.

1. Suchen, ohne den Chat vollzumachen

Das ist der einfachste Fall. Ich muss herausfinden, wo etwas im Projekt steckt, und will nicht jede Datei sehen, die Claude dafür öffnet.

Nutze einen Explore-Subagent, um herauszufinden, wo der Login verarbeitet wird. Sag mir nur die Dateien und die Zeilen.

Der zweite Satz zählt genauso viel wie der erste. „Sag mir nur die Dateien und die Zeilen“ sagt dem Helfer, was er zurückbringen soll. Wenn du das weglässt, bekommst du eine lange Zusammenfassung, die den Chat trotzdem füllt.

Denk daran: Explore sieht eure Unterhaltung nicht und startet auch ohne die CLAUDE.md-Datei des Projekts, damit er schnell bleibt. Schreib also in den Satz, was er braucht: was du suchst, in welchem Teil der App und was du zurückhaben willst.

2. Drei Aufgaben auf einmal

Wenn ich mehrere Aufgaben habe, die nicht voneinander abhängen, starte ich sie parallel. Jeder Helfer hat seinen eigenen Kontext und seine eigene Aufgabe, und am Ende fasst Claude die Ergebnisse zusammen.

Starte drei Subagents parallel: Einer sucht, wo der Login verarbeitet wird, einer liest die Logs des letzten Fehlers und sagt mir die Ursache, einer schreibt die Tests für die Preisseite. Wenn sie fertig sind, fass mir alle drei zusammen.

Das klappt, weil sich die drei Aufgaben nicht überschneiden: Um die Logs zu lesen, muss man den Login nicht finden, und keine der beiden berührt die Tests der Preisseite. Wenn die zweite Aufgabe das Ergebnis der ersten braucht, ist sie nicht parallel: Mach sie danach.

3. Ctrl+B und /tasks

Wenn eine Aufgabe lange dauert und dich blockiert, etwa ein Befehl, der seit Minuten läuft, drück Ctrl+B: Sie wandert in den Hintergrund, und du schreibst weiter. Ctrl+B funktioniert bei Befehlen und bei Helfern. Wenn du tmux nutzt, drück es zweimal.

Um zu sehen, wer gerade arbeitet, schreib:

/tasks

Es zeigt dir die Hintergrundarbeit der Sitzung: die laufenden Befehle und die Subagents, auch die gerade fertig gewordenen. Von dort kannst du die Arbeit eines Helfers öffnen und nachlesen, was er gemacht hat, oder ihn stoppen, wenn er in die falsche Richtung läuft.

4. Ein fester Helfer

Wenn du eine Aufgabe oft wiederholst, lohnt sich ein fester Helfer. Das ist eine Datei im Ordner .claude/agents des Projekts: Oben stehen der Name, eine Beschreibung, wann er eingesetzt wird, und die Werkzeuge, die er nutzen darf, darunter die Anweisungen in normalen Worten. Du musst sie nicht von Hand schreiben: Du bittest Claude darum.

Leg mir in .claude/agents einen Subagent an, der den Code prüft, ohne etwas zu ändern, und nenn ihn code-reviewer.

Das Ergebnis sieht ungefähr so aus:

---
name: code-reviewer
description: Prüft den Code und meldet Probleme. Ändert keine Datei.
tools: Read, Grep, Glob
---

Du bist ein Code-Reviewer. Lies die Änderungen, die ich dir nenne, und such nach Bugs, nicht behandelten Fällen und unklaren Stellen. Sag mir bei jedem Problem die Datei, die Zeile und wie du es beheben würdest. Ändere nichts.

Die entscheidende Zeile ist tools: Das sind die Werkzeuge, die der Helfer nutzen darf. Ein Reviewer braucht nur die zum Lesen und Suchen, also Read, Grep und Glob. Write und Edit dürfen nicht drinstehen, und Bash auch nicht, denn auch über das Terminal lassen sich Dateien ändern. Wenn du dir nicht sicher bist, frag nach:

Öffne die Datei des Subagents code-reviewer und sag mir, welche Werkzeuge er nutzen darf. Wenn etwas dabei ist, womit er Dateien ändern kann, nimm es raus.

Dann setzt du ihn so ein, wenn du ein Stück Arbeit fertig hast:

Lass die letzten Änderungen vom Subagent code-reviewer prüfen.

Du kannst in der Datei auch eine Zeile model ergänzen, um das Modell zu wählen: haiku für einfache, schnelle Aufgaben, sonnet oder opus für anspruchsvollere, inherit für dasselbe wie in der Unterhaltung.

Eine Datei in .claude/agents gilt für dieses Projekt. Legst du sie in ~/.claude/agents, hast du sie in all deinen Projekten. Es gibt auch den Befehl /agents, aber am einfachsten ist es immer noch, Claude zu fragen oder die Datei zu öffnen.

5. Wann ich sie nicht starte

• Kleine Aufgaben: einen Text, eine Farbe, eine Zeile ändern. Ein Helfer fängt bei null an und muss erst das Projekt verstehen: Das dauert länger, als es direkt zu machen.
• Aufgaben, die dieselben Dateien berühren: Zwei Helfer an derselben Datei kommen sich in die Quere. Lass sie nacheinander laufen oder jeden in seiner eigenen Kopie des Projekts, den Worktrees. Bei einem festen Helfer reicht die Zeile isolation: worktree in seiner Datei.
• Wenn ich jeden Schritt mitverfolgen will: Der Helfer bringt dir das Ergebnis erst am Ende. Wenn ich ihn bei jedem Schritt korrigieren muss, bleibe ich in der Hauptunterhaltung.
• Wenn alles gebraucht wird, was wir besprochen haben: Ein Helfer wie Explore startet mit leerem Kontext und sieht unseren Chat nicht. Er muss von vorn eingewiesen werden, also erklär es gut im Satz.

Eine Regel

Jeder Helfer verbraucht eigene Tokens, und die zählen gegen dieselben Nutzungslimits wie die Hauptunterhaltung. Drei Helfer mit je einer klaren Aufgabe: ja. Zehn, die man „einfach so“ startet: nein.

Häufige Fehler

• Einen Helfer für eine Änderung in einer Zeile starten: Mach sie direkt, das geht schneller.
• Einen vagen Satz schreiben wie „schau dir den Login an“: Sag, was gesucht wird, wo, und was du zurückhaben willst.
• Davon ausgehen, dass der Helfer weiß, was ihr besprochen habt: Er sieht den Chat nicht, also schreib ihm den Kontext in den Satz.
• Zwei Helfer gleichzeitig an dieselben Dateien setzen: Lass sie nacheinander arbeiten oder jeden in seinem eigenen Worktree.
• Einem „Nur-Lesen“-Reviewer vertrauen, ohne die Zeile tools anzuschauen: Öffne die Datei und prüf, dass Write, Edit und Bash nicht drinstehen.
• Viele „einfach so“ starten: Jeder verbraucht eigene Tokens, also starte nur die mit einer klaren Aufgabe.

Checkliste

• Die Aufgabe ist groß genug für einen Helfer
• Der Satz sagt, was gesucht und was zurückgebracht wird
• Der nötige Kontext steht im Satz
• Die parallelen Aufgaben berühren nicht dieselben Dateien
• Ich weiß, dass /tasks mir zeigt, wer gerade arbeitet
• Der feste Reviewer hat nur Werkzeuge zum Lesen

Häufige Fragen