Einen Subagenten erstellen

Einen Subagenten erstellen

Der einfachste Weg, einen Subagenten zu erstellen, besteht darin, Claude zu bitten, ihn für dich zu schreiben. Beschreibe den Subagenten, den du möchtest, und wo er gespeichert werden soll, und Claude schreibt die Datei. Das Video und die ersten drei Screenshots in dieser Lektion zeigen den /agents-Assistenten, der in Claude Code v2.1.198 entfernt wurde. Die Subagenten-Datei und ihre Felder sind unverändert, sodass du weiterhin einen Geltungsbereich, Tools, ein Modell und eine Farbe auswählst. Gib diese Auswahl in deiner Anfrage an.

Wähle zunächst den Geltungsbereich deines Subagenten. Eine Datei in .claude/agents/ ist projektbezogen, und eine Datei in ~/.claude/agents/ ist benutzerbezogen:

• Projektbezogen -- nur im aktuellen Projekt verfügbar
• Benutzerbezogen -- über alle Projekte auf deinem Rechner hinweg geteilt

Als Nächstes kannst du wählen, wie du ihn erstellst. Du kannst die Konfiguration manuell schreiben, aber der empfohlene Ansatz ist, Claude sie für dich generieren zu lassen. Beschreibe einfach, was der Subagent tun soll, und Claude erstellt basierend auf deiner Eingabe einen Namen, eine Beschreibung und einen System-Prompt.



Tools anpassen

Während der Erstellung hast du die Möglichkeit, anzupassen, auf welche Tools der Subagent zugreifen kann. Zu den Tool-Kategorien gehören:

• Nur-Lese-Tools
• Bearbeitungs-Tools
• Ausführungs-Tools
• MCP-Tools
• Sonstige Tools



Überlege, was dein Subagent tatsächlich benötigt. Ein Code-Reviewer braucht wahrscheinlich keine Bearbeitungs-Tools -- er sollte Code lesen und analysieren, nicht ihn ändern. Du möchtest jedoch vielleicht Ausführungs-Tools aktiviert lassen, damit er ausstehende Änderungen leichter erkennen kann.

Modell und Farbe auswählen

Nach der Konfiguration der Tools wählst du aus, welches Claude-Modell den Subagenten antreibt. Deine Optionen umfassen:

• Haiku -- am besten für schnelle, leichtgewichtige Aufgaben
• Sonnet -- ein guter Mittelweg zwischen Geschwindigkeit und Tiefe
• Opus -- am besten für komplexe Analysen
• Inherit -- verwendet das Modell, das in deiner Hauptkonversation läuft

Zum Schluss wählst du eine Farbe aus. Diese wird in der Benutzeroberfläche angezeigt, damit du schnell erkennen kannst, welcher Subagent aktiv ist. Es ist eine kleine Feinheit, aber sie hilft, wenn mehrere Subagenten gleichzeitig laufen.



Die Konfigurationsdatei

Sobald die Erstellung abgeschlossen ist, wird die Konfigurationsdatei des Subagenten im Ordner für den von dir gewählten Geltungsbereich gespeichert (bei einem projektbezogenen Subagenten typischerweise .claude/agents/your-agent-name.md). So sieht eine typische Subagenten-Konfiguration aus:

---
name: code-quality-reviewer
description: Use this agent when you need to review recently written or modified code for quality, security, and best practice compliance.
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch
model: sonnet
color: purple
---

You are an expert code reviewer specializing in quality assurance, security best practices, and
adherence to project standards. Your role is to thoroughly examine recently written or modified code
and identify issues that could impact reliability, security, maintainability, or performance.

Lass uns jedes Feld aufschlüsseln:

• name -- Ein eindeutiger Bezeichner für den Subagenten. So referenzierst du ihn, entweder indem du Claude direkt fragst oder indem du @agent-code-quality-reviewer in deiner Nachricht eingibst.
• description -- Steuert, wann Claude entscheidet, den Subagenten zu verwenden. Dies muss eine einzige Zeile sein (verwende maskierte Zeilenumbruchzeichen \n, wenn du Umbrüche benötigst). Du kannst hier Beispielkonversationen einfügen, um Claude zu helfen zu verstehen, wann eine Delegation angemessen ist.
• tools -- Listet auf, auf welche Tools der Subagent zugreifen kann. Claude füllt dies basierend auf deiner Anfrage aus, aber du kannst die Liste hier jederzeit bearbeiten.
• model -- Gibt an, welches Claude-Modell verwendet werden soll: ein Alias (sonnet, opus, haiku oder fable), eine vollständige Modell-ID wie claude-sonnet-5, oder inherit.
• color -- Die UI-Farbe zur Identifizierung des Subagenten.

System-Prompts

Der Hauptteil der Markdown-Datei (alles unterhalb des YAML-Frontmatters) ist der System-Prompt. Hier gibst du dem Subagenten seine Anweisungen: worauf er sich konzentrieren soll, wie er Dinge analysieren soll und wie er Ergebnisse an den Hauptagenten zurückmelden soll.

Ein gut geschriebener System-Prompt macht den Unterschied zwischen einem nützlichen Subagenten und einem, der am Ziel vorbeigeht. Sei konkret darüber, wonach der Subagent suchen soll und wie er seine Ausgabe strukturieren soll.

Claude deinen Subagenten automatisch verwenden lassen

Wenn du möchtest, dass Claude Aufgaben an den Subagenten delegiert, ohne dass du explizit danach fragst, füge das Wort „proactively" in das Beschreibungsfeld ein. Zum Beispiel:

description: Proactively suggest running this agent after major code changes...

Du kannst der Beschreibung auch Beispielkonversationen hinzufügen, um Claude zu helfen, bestimmte Szenarien zu verstehen, in denen der Subagent verwendet werden sollte. Je konkreter deine Beispiele sind, desto besser wird Claude darin, zu wissen, wann delegiert werden soll.

Deinen Subagenten testen

Nachdem du deinen Subagenten erstellt hast, teste ihn, indem du einige Codeänderungen vornimmst und Claude bittest, sie zu überprüfen. Wenn der Ordner agents beim Start deiner Sitzung noch nicht existierte, starte Claude Code zuerst neu, um den neuen Subagenten zu laden.



Wenn der Subagent nicht verwendet wird, obwohl du es erwartest, gehe zurück und überprüfe die Beschreibung. Das Hinzufügen spezifischerer Beispiele und Auslöseszenarien hilft Claude zu verstehen, wann Arbeit an deinen Subagenten delegiert werden soll.