Grundlagen für Agenten

Problem: Bei einem echten Projekt braucht man meist mehr als nur eine Person, die sich darum kümmert. Ein zusätzliches Paar Augen für die Sicherheit. Ein weiteres für die Performance. Jemand, der die Dokumentation auf dem neuesten Stand hält. All diese Rollen in einem einzigen Chat zu übernehmen, kostet viel Konzentration und Zeit.

Schnelle Lösung: Übertrage eine parallele Aufgabe an einen Sub-Agenten. Er läuft eigenständig und gibt seine Ergebnisse dann an deine Hauptsitzung zurück.

Verständnis: Claude Code bietet dir verschiedene Möglichkeiten, ein agentenähnliches Verhalten zu erzielen, von integrierten Unteragenten bis hin zu deinen eigenen Slash-Befehlen. Jeder davon bewährt sich bei unterschiedlichen Aufgaben. Mach dich erst mit den Grundlagen vertraut, bevor du dich an die ausgefeilteren Muster wagst.

Hier sind die fünf Wege, die Claude Code bietet, nebeneinander:

Jeder Weg hat seine Vor- und Nachteile. Sub-Agenten punkten bei paralleler Arbeit. „.claude/agents/“-Definitionen geben Sub-Agenten einen einprägsamen Namen. Slash-Befehle glänzen durch Wiederverwendbarkeit.

Nutze diese Seite, um zu entscheiden, welche Primitive du tatsächlich benötigst. Wenn du bereits weißt, dass du mehrere Agenten willst und die offene Frage die Form der Koordination ist, lies Agentenmuster. Wenn du mehrere Claude-Sitzungen benötigst, die als Gleichrangige zusammenarbeiten, anstatt als Subagenten, die einem Leiter unterstehen, springe zu Claude-Code-Agententeams.

Eine einfache Entscheidungsleiter

Wenn du dir unsicher bist, welchen Weg du einschlagen sollst, fang nicht mit dem ausgefallensten an. Gehe diese Leiter ab:

1. Handelt es sich nur um eine einmalige Perspektivverschiebung?

Verwende Perspektiv-Prompts.

1. Ist dies ein wiederholbarer Workflow, den du bei Bedarf auslösen möchtest?

Verwende einen Slash-Befehl.

1. Ist dies ein dauerhafter Spezialist, zu dem Claude automatisch weiterleiten können sollte?

Verwende „.claude/agents/“.

1. Benötigst du gerade parallele Arbeit oder einen isolierten Kontext?

Verwende einen Sub-Agenten über das Task-Tool.

1. Soll die Regel für jede Sitzung im Repo gelten?

Füge sie in „CLAUDE.md“ ein.

Diese Reihenfolge ist wichtig, da sie dich vor übertriebenem Aufbau bewahrt. Die meisten Teams sollten sich ihren Weg von Prompts über Befehle zu persistenten Agenten erarbeiten, anstatt direkt zu einer riesigen Spezialistenflotte zu springen.

Das Task-Tool

Innerhalb deiner Sitzung startet das Task-Tool kleine Claude-Code-Instanzen. Jeder Sub-Agent erhält ein neues Kontextfenster, läuft unabhängig und sendet die Ergebnisse zurück an den Orchestrator.

Warum Sub-Agenten wichtig sind:

• Ein isolierter Kontext verhindert, dass die Arbeit an einer Aufgabe in die nächste übergreift
• Parallele Ausführungen verkürzen die Gesamtlaufzeit bei der Analyse mehrerer Dateien
• Ein Sub-Agent, der ausfällt, bringt deine Hauptsitzung nicht mit sich zu Fall
• Im Hintergrundmodus kannst du weiterarbeiten, während sie laufen (drücke „Ctrl+B“)

Neu : Von Claude gestartete Sub-Agents können jetzt im Hintergrund laufen. Drücke „Ctrl+B “, und der Hauptagent bleibt für andere Chats frei. Die Ergebnisse werden sofort angezeigt, sobald sie fertig sind. Eine vollständige Anleitung findest du im Leitfaden zu asynchronen Workflows.

Für komplexere Orchestrierungsmuster siehe Agent-Muster.

Benutzerdefinierte Sub-Agent-Definitionen

Sub-Agents können auch auf der Festplatte gespeichert werden. Lege eine Markdown-Datei in einem speziellen Verzeichnis unter agents/ ab, füge oben einen Frontmatter-Eintrag „YAML“ ein, und schon hast du eine benutzerdefinierte Sub-Agent-Definition. Dies sind keine Slash-Befehle. Slash-Befehle sind Eingabeaufforderungen, die du manuell aufrufst. Eine Agent-Definition richtet einen persistenten Sub-Agenten ein, den Claudes Orchestrator selbstständig aufgreift, wenn die Aufgabe passt.

Zwei Bereiche für Agentendefinitionen:

• Projekt-Agenten (.claude/agents/) – Spezifisch für dein Repository, über Git mit deinem Team teilbar
• Benutzer-Agenten (~/.claude/agents/) – In allen deinen Projekten verfügbar, persönlich auf deinem Rechner

Ein in .claude/agents/ deklarierter Sub-Agent liest die CLAUDE.md-Datei deines Projekts genauso wie die Hauptsitzung. Codierungsstandards, Konventionen und Projektregeln werden ohne zusätzliche Konfiguration übernommen.

Steuerung des Sub-Agent-Modells: Lege CLAUDE_CODE_SUBAGENT_MODEL in deiner Umgebung so fest, dass Sub-Agents auf ein bestimmtes Modell verweisen. Nützlich für Kosteneinsparungen (ein schlankeres Modell für Sub-Agents) oder für Aufgaben, die von einer leistungsstärkeren Schlussfolgerung profitieren.

Zugriff von Sub-Agenten mit Berechtigungsregeln einschränken

Du kannst Claude mithilfe von Berechtigungsregeln für „Task(AgentName)“ mitteilen, welche Sub-Agenten er aufrufen darf. Füge sie in das Array „deny“ deiner „settings.json“ ein oder übergebe sie über die Befehlszeile mit „--disallowedTools“.

Dadurch wird verhindert, dass der Sub-Agent „Explore“ gestartet wird. Zu den integrierten Agentennamen gehören „Explore“, „Plan“ und „Verify“. Agenten können auch beim Start deaktiviert werden.

Greife darauf zurück in sensiblen Umgebungen, in denen du das Verhalten der Agenten stärker kontrollieren möchtest, oder wenn die autonome Erkundung zu viele Token verbraucht.

Benutzerdefinierte Slash-Befehle

Wiederverwendbare Slash-Befehle liegen als Markdown-Dateien unter .claude/commands/ vor. Führe /project:security-review src/auth/ aus, und dein Spezialist macht sich an die Arbeit.

Befehlsorte:

• .claude/commands/ - Projektspezifisch, über Git teilbar
• ~/.claude/commands/ - Persönlich, überall verfügbar

CLAUDE.md-Personas

Jede Interaktion in deinem Projekt läuft über das, was in CLAUDE.md steht. Die Datei bestimmt letztendlich, wie Claude standardmäßig auftritt. Konsistenz im Agent-Stil, ohne den Agenten jemals namentlich zu nennen.

Perspektiv-Prompts: Schneller Kontextwechsel

Für einen einmaligen Einblick bitte Claude, eine bestimmte Perspektive einzunehmen. Keine Einrichtung erforderlich. Sofortige spezialisierte Analyse.

Wann was verwenden

Verwende Sub-Agenten, wenn: Du parallele Abläufe wünschst oder isolierten Kontext über mehrere Aufgaben hinweg benötigst.

Verwende „.claude/agents/“, wenn: Du benannte Spezialagenten willst, die verfügbar bleiben, und Claudes Orchestrator sie selbstständig nach Aufgabentyp auswählt.

Verwende Slash-Befehle, wenn: derselbe Workflow immer wieder in verschiedenen Sitzungen auftaucht oder du ihn mit dem Team teilen möchtest.

Verwende CLAUDE.md, wenn: Das Verhalten überall und bei jeder Interaktion automatisch gelten soll.

Verwende „Perspective Prompting“, wenn: Du einen schnellen, einmaligen Blick aus einem anderen Blickwinkel haben möchtest.

Drei praktische Konfigurationen

1. Sicherheitsüberprüfung ohne dauerhaften Aufwand

Wenn du gelegentlich ein zweites Paar Augen für Authentifizierung, Berechtigungsprüfungen oder den Umgang mit Geheimnissen brauchst:

• behalte deine normale Sitzung bei
• Starte einen auf Sicherheit ausgerichteten Sub-Agenten
• lass ihn nur die Ergebnisse melden

Das ist besser als eine permanente Agentendefinition, wenn der Bedarf nur gelegentlich besteht.

2. Content-Workflow, den du jede Woche durchführst

Wenn du weiterhin Dokumente, Changelogs oder Blogbeiträge mit denselben Qualitätskriterien verfasst:

• verwende einen Slash-Befehl
• Lade dort die Stimme, den Workflow und die Checkliste
• zwinge diesen Inhaltskontext nicht in jede Coding-Session

Das ist der saubere, wiederverwendbare Mittelweg.

3. Fachspezialist, zu dem Claude dich ganz natürlich weiterleiten soll

Wenn dein Repo wiederkehrende Frontend-, Backend-, Datenbank- oder Sicherheitsaufgaben enthält:

• Definiere feste Spezialisten in „.claude/agents/“
• Halte die Domänenregeln nah am Agenten
• Lass den Orchestrator sie auswählen, wenn die Aufgabe passt

Hier zahlen sich persistente Agenten aus.

In der Praxis laufen gut entwickelte Claude-Code-Setups alle fünf gleichzeitig. Persistente Definitionen für Spezialistenrollen. Slash-Befehle für wiederkehrende Workflows. CLAUDE.md für projektweite Standards. Sub-Agenten für parallele Jobs. Das ClaudeFast Code Kit enthält 18 vorkonfigurierte Agenten (vom Sicherheitsprüfer bis zum Frontend-Spezialisten) sowie die bereits vorhandenen Slash-Befehle und Routing-Regeln, sodass du die Muster sehen kannst, bevor du deine eigenen erstellst.

Nächster Schritt: Wähle einen Workflow, den du oft ausführst, und wandle ihn in einen Slash-Befehl unter .claude/commands/ um. Von dort aus kannst du dich mit den Verteilungsstrategien befassen, die für die komplexere Orchestrierung erforderlich sind.

Entdecke weitere Agent-Konzepte:

• Best Practices für Sub-Agenten – Wann man parallele, sequenzielle oder Hintergrundausführung nutzen sollte
• Sub-Agent-Design – Architekturmuster für die Orchestrierung mehrerer Agenten
• Benutzerdefinierte Agenten – Erstelle spezialisierte Agenten mit Slash-Befehlen
• Agentenmuster – Bewährte Entwurfsmuster für Agentensysteme
• Menschenähnliche Agenten – Erstelle Agenten mit unterschiedlichen Persönlichkeiten