Erstellen eines Subagenten

Claude Code wird mit integrierten Subagenten geliefert, aber Sie können auch Ihre eigenen erstellen. Benutzerdefinierte Subagenten spezialisieren sich auf spezifische Aufgaben – wie Code-Überprüfung, Schreiben von Tests oder Überprüfung von Dokumentation. Sie werden als Markdown-Dateien mit YAML-Frontmatter definiert, die Claude mitteilen, wann der Subagent verwendet werden soll und wie er sich verhalten sollte.

Der einfachste Weg, einen Subagenten zu erstellen, ist der /agents Schrägstrich-Befehl. Dies öffnet die Hauptschnittstelle zur Verwaltung Ihrer Subagenten. Wählen Sie dort Create new agent aus.

Sie werden zunächst aufgefordert, den Umfang Ihres Subagenten zu wählen:

Project-level \-- nur im aktuellen Projekt verfügbar
User-level \-- auf allen Projekten auf Ihrem Computer freigegeben

Als Nächstes können Sie wählen, wie Sie ihn erstellen möchten. Sie können die Konfiguration manuell schreiben, aber der empfohlene Ansatz ist, Claude sie für Sie generieren zu lassen. Beschreiben Sie einfach, was der Subagent tun soll, und Claude erstellt einen Namen, eine Beschreibung und einen System-Prompt basierend auf Ihrer Eingabe.

Anpassen von Tools

Während der Erstellung haben Sie die Möglichkeit, anzupassen, auf welche Tools der Subagent zugreifen kann. Die Tool-Kategorien umfassen:

Read-only tools
Edit tools
Execution tools
MCP tools
Other tools

Überlegen Sie, welche Tools Ihr Subagent tatsächlich benötigt. Ein Code-Reviewer benötigt wahrscheinlich keine Edit tools – er sollte Code lesen und analysieren, nicht ändern. Sie könnten jedoch Execution tools aktiviert lassen, damit er ausstehende Änderungen leichter identifizieren kann.

Auswahl eines Modells und einer Farbe

Nach der Konfiguration der Tools wählen Sie aus, welches Claude-Modell den Subagenten antreibt. Ihre Optionen sind:

Haiku \-- am besten für schnelle, leichte Aufgaben
Sonnet \-- ein guter Mittelweg zwischen Geschwindigkeit und Tiefe
Opus \-- am besten für komplexe Analysen
Inherit \-- verwendet das Modell, das Ihre Hauptkonversation ausführt

Abschließend wählen Sie eine Farbe. Diese wird in der Benutzeroberfläche angezeigt, damit Sie schnell erkennen können, welcher Subagent aktiv ist. Es ist eine kleine Geste, aber sie hilft, wenn Sie mehrere Subagenten ausführen.

Die Konfigurationsdatei

Nach Abschluss der Erstellung wird die Subagenten-Konfigurationsdatei in Ihrem Projekt gespeichert (normalerweise unter . claude/agents/your-agent-name. md). Hier ist ein typisches Aussehen einer Subagenten-Konfiguration:

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

Lassen Sie uns jedes Feld aufschlüsseln:

name \-- Ein eindeutiger Bezeichner für den Subagenten. So referenzieren Sie ihn, entweder indem Sie Claude direkt fragen oder @agent code-quality-reviewer in Ihrer Nachricht eingeben.
description \-- Steuert, wann Claude entscheidet, den Subagenten zu verwenden. Dies muss eine einzelne Zeile sein (verwenden Sie Escape-Zeilenumbruchzeichen \n, wenn Sie Umbrüche benötigen). Sie können hier Beispielkonversationen einfügen, um Claude zu helfen, zu verstehen, wann eine Delegierung angemessen ist.
tools \-- Listet auf, auf welche Tools der Subagent zugreifen kann. Dies entspricht dem, was Sie während der Generierung ausgewählt haben, aber Sie können die Liste hier jederzeit bearbeiten.
model \-- Gibt an, welches Claude-Modell verwendet werden soll: sonnet, opus, haiku oder inherit.
color \-- Die UI-Farbe zur Identifizierung des Subagenten.

System-Prompts

Der Text der Markdown-Datei (alles unter dem YAML-Frontmatter) ist der System-Prompt. Hier geben Sie dem Subagenten seine Anweisungen: worauf er sich konzentrieren sollte, wie er Dinge analysieren sollte und wie er Ergebnisse an den Hauptagenten zurückberichten sollte.

Ein gut geschriebener System-Prompt ist der Unterschied zwischen einem nützlichen Subagenten und einem, der den Punkt verfehlt. Seien Sie spezifisch darüber, worauf der Subagent achten sollte und wie er seine Ausgabe strukturieren sollte.

Claude dazu bringen, Ihren Subagenten automatisch zu verwenden

Wenn Sie möchten, dass Claude Aufgaben an den Subagenten delegiert, ohne dass Sie explizit danach fragen, fügen Sie das Wort "proactively" in das Beschreibungsfeld ein. Zum Beispiel:

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

Sie können auch Beispielkonversationen zur Beschreibung hinzufügen, um Claude zu helfen, spezifische Szenarien zu verstehen, in denen der Subagent verwendet werden sollte. Je konkreter Ihre Beispiele sind, desto besser versteht Claude, wann Arbeit an Ihren Subagenten delegiert werden sollte.

Testen Ihres Subagenten

Nach dem Erstellen Ihres Subagenten testen Sie ihn, indem Sie einige Code-Änderungen vornehmen und Claude bitten, diese zu überprüfen.

Wenn der Subagent nicht verwendet wird, wenn Sie es erwarten, gehen Sie zurück und überprüfen Sie die Beschreibung. Das Hinzufügen spezifischerer Beispiele und Trigger-Szenarien hilft Claude zu verstehen, wann Arbeit an Ihren Subagenten delegiert werden sollte.