Subagenten

​

Was sind Subagenten?

• Hat einen spezifischen Zweck und Kompetenzbereich
• Verwendet sein eigenes Kontextfenster, das vom Hauptgespräch getrennt ist
• Kann mit spezifischen Tools konfiguriert werden, die er verwenden darf
• Enthält eine benutzerdefinierte Systemaufforderung, die sein Verhalten lenkt

​

Wichtigste Vorteile

​

Schnellstart

/agents

> Use the code-reviewer subagent to check my recent changes

​

Subagenten-Konfiguration

​

Dateispeicherorte

​

Plugin-Agenten

• Plugin-Agenten erscheinen in /agents neben Ihren benutzerdefinierten Agenten
• Können explizit aufgerufen werden: “Use the code-reviewer agent from the security-plugin”
• Können automatisch von Claude aufgerufen werden, wenn es angebracht ist
• Können über die /agents-Schnittstelle verwaltet werden (angezeigt, inspiziert)

​

CLI-basierte Konfiguration

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  }
}'

• Schnelles Testen von Subagenten-Konfigurationen
• Sitzungsspezifische Subagenten, die nicht gespeichert werden müssen
• Automatisierungsskripte, die benutzerdefinierte Subagenten benötigen
• Freigabe von Subagenten-Definitionen in Dokumentation oder Skripten

​

Dateiformat

---
name: your-sub-agent-name
description: Description of when this subagent should be invoked
tools: tool1, tool2, tool3  # Optional - inherits all tools if omitted
model: sonnet  # Optional - specify model alias or 'inherit'
---

Your subagent's system prompt goes here. This can be multiple paragraphs
and should clearly define the subagent's role, capabilities, and approach
to solving problems.

Include specific instructions, best practices, and any constraints
the subagent should follow.

​

Konfigurationsfelder

​

Modellauswahl

• Modellalias: Verwenden Sie einen der verfügbaren Aliase: sonnet, opus oder haiku
• 'inherit': Verwenden Sie das gleiche Modell wie das Hauptgespräch (nützlich für Konsistenz)
• Weggelassen: Falls nicht angegeben, wird das Standardmodell verwendet, das für Subagenten konfiguriert ist (sonnet)

​

Verfügbare Tools

• Lassen Sie das tools-Feld weg, um alle Tools aus dem Hauptthread zu erben (Standard), einschließlich MCP-Tools
• Geben Sie einzelne Tools als kommagetrennte Liste an, um eine granularere Kontrolle zu haben (kann manuell oder über /agents bearbeitet werden)

​

Verwalten von Subagenten

​

Verwendung des /agents-Befehls (Empfohlen)

/agents

• Alle verfügbaren Subagenten anzeigen können (integriert, Benutzer und Projekt)
• Neue Subagenten mit geführtem Setup erstellen können
• Vorhandene benutzerdefinierte Subagenten bearbeiten können, einschließlich ihres Tool-Zugriffs
• Benutzerdefinierte Subagenten löschen können
• Sehen können, welche Subagenten aktiv sind, wenn Duplikate vorhanden sind
• Tool-Berechtigungen einfach verwalten mit einer vollständigen Liste verfügbarer Tools

​

Direkte Dateiverwaltung

# Erstellen Sie einen Projekt-Subagenten
mkdir -p .claude/agents
echo '---
name: test-runner
description: Use proactively to run tests and fix failures
---

You are a test automation expert. When you see code changes, proactively run the appropriate tests. If tests fail, analyze the failures and fix them while preserving the original test intent.' > .claude/agents/test-runner.md

# Erstellen Sie einen Benutzer-Subagenten
mkdir -p ~/.claude/agents
# ... create subagent file

​

Effektive Verwendung von Subagenten

​

Automatische Delegation

• Der Aufgabenbeschreibung in Ihrer Anfrage
• Dem description-Feld in Subagenten-Konfigurationen
• Dem aktuellen Kontext und verfügbaren Tools

​

Explizite Aufrufe

> Use the test-runner subagent to fix failing tests
> Have the code-reviewer subagent look at my recent changes
> Ask the debugger subagent to investigate this error

​

Integrierte Subagenten

​

Plan-Subagent

• Modell: Verwendet Sonnet für fähigere Analyse
• Tools: Hat Zugriff auf Read-, Glob-, Grep- und Bash-Tools zur Codebase-Erkundung
• Zweck: Durchsucht Dateien, analysiert Codestruktur und sammelt Kontext
• Automatischer Aufruf: Claude verwendet diesen Agent automatisch im Plan-Modus, wenn er die Codebasis erforschen muss

User: [Im Plan-Modus] Help me refactor the authentication module

Claude: Let me research your authentication implementation first...
[Intern ruft Plan-Subagenten auf, um authentifizierungsbezogene Dateien zu erkunden]
[Plan-Subagent durchsucht Codebasis und gibt Ergebnisse zurück]
Claude: Based on my research, here's my proposed plan...

​

Beispiel-Subagenten

​

Code-Reviewer

---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
tools: Read, Grep, Glob, Bash
model: inherit
---

You are a senior code reviewer ensuring high standards of code quality and security.

When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

Review checklist:
- Code is simple and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Good test coverage
- Performance considerations addressed

Provide feedback organized by priority:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (consider improving)

Include specific examples of how to fix issues.

​

Debugger

---
name: debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
tools: Read, Edit, Bash, Grep, Glob
---

You are an expert debugger specializing in root cause analysis.

When invoked:
1. Capture error message and stack trace
2. Identify reproduction steps
3. Isolate the failure location
4. Implement minimal fix
5. Verify solution works

Debugging process:
- Analyze error messages and logs
- Check recent code changes
- Form and test hypotheses
- Add strategic debug logging
- Inspect variable states

For each issue, provide:
- Root cause explanation
- Evidence supporting the diagnosis
- Specific code fix
- Testing approach
- Prevention recommendations

Focus on fixing the underlying issue, not just symptoms.

​

Data Scientist

---
name: data-scientist
description: Data analysis expert for SQL queries, BigQuery operations, and data insights. Use proactively for data analysis tasks and queries.
tools: Bash, Read, Write
model: sonnet
---

You are a data scientist specializing in SQL and BigQuery analysis.

When invoked:
1. Understand the data analysis requirement
2. Write efficient SQL queries
3. Use BigQuery command line tools (bq) when appropriate
4. Analyze and summarize results
5. Present findings clearly

Key practices:
- Write optimized SQL queries with proper filters
- Use appropriate aggregations and joins
- Include comments explaining complex logic
- Format results for readability
- Provide data-driven recommendations

For each analysis:
- Explain the query approach
- Document any assumptions
- Highlight key findings
- Suggest next steps based on data

Always ensure queries are efficient and cost-effective.

​

Best Practices

• Beginnen Sie mit von Claude generierten Agenten: Wir empfehlen dringend, Ihren anfänglichen Subagenten mit Claude zu generieren und dann darauf zu iterieren, um ihn zu Ihrem eigenen zu machen. Dieser Ansatz gibt Ihnen die besten Ergebnisse – eine solide Grundlage, die Sie an Ihre spezifischen Anforderungen anpassen können.
• Entwerfen Sie fokussierte Subagenten: Erstellen Sie Subagenten mit einzelnen, klaren Verantwortlichkeiten, anstatt zu versuchen, einen Subagenten alles tun zu lassen. Dies verbessert die Leistung und macht Subagenten vorhersehbarer.
• Schreiben Sie detaillierte Aufforderungen: Fügen Sie spezifische Anweisungen, Beispiele und Einschränkungen in Ihre Systemaufforderungen ein. Je mehr Anleitung Sie geben, desto besser wird der Subagent funktionieren.
• Begrenzen Sie den Tool-Zugriff: Gewähren Sie nur Tools, die für den Zweck des Subagenten notwendig sind. Dies verbessert die Sicherheit und hilft dem Subagenten, sich auf relevante Aktionen zu konzentrieren.
• Versionskontrolle: Überprüfen Sie Projekt-Subagenten in die Versionskontrolle, damit Ihr Team von ihnen profitieren und sie gemeinsam verbessern kann.

​

Erweiterte Verwendung

​

Verkettung von Subagenten

> First use the code-analyzer subagent to find performance issues, then use the optimizer subagent to fix them

​

Dynamische Subagenten-Auswahl

​

Wiederaufnehmbare Subagenten

• Jede Subagenten-Ausführung wird einer eindeutigen agentId zugewiesen
• Das Gespräch des Agenten wird in einer separaten Transkriptdatei gespeichert: agent-{agentId}.jsonl
• Sie können einen vorherigen Agent wiederaufnehmen, indem Sie seine agentId über den resume-Parameter bereitstellen
• Wenn wiederaufgenommen, setzt der Agent mit vollem Kontext aus seinem vorherigen Gespräch fort

> Use the code-analyzer agent to start reviewing the authentication module

[Agent schließt anfängliche Analyse ab und gibt agentId zurück: "abc123"]

> Resume agent abc123 and now analyze the authorization logic as well

[Agent setzt mit vollem Kontext aus dem vorherigen Gespräch fort]

• Langwierige Recherche: Teilen Sie große Codebase-Analysen in mehrere Sitzungen auf
• Iterative Verbesserung: Setzen Sie die Arbeit eines Subagenten fort, ohne den Kontext zu verlieren
• Mehrstufige Workflows: Lassen Sie einen Subagenten sequenziell an verwandten Aufgaben arbeiten, während der Kontext erhalten bleibt

• Agent-Transkripte werden in Ihrem Projektverzeichnis gespeichert
• Die Aufzeichnung ist während der Wiederaufnahme deaktiviert, um Nachrichten nicht zu duplizieren
• Sowohl synchrone als auch asynchrone Agenten können wiederaufgenommen werden
• Der resume-Parameter akzeptiert die Agent-ID aus einer vorherigen Ausführung

{
  "description": "Continue analysis",
  "prompt": "Now examine the error handling patterns",
  "subagent_type": "code-analyzer",
  "resume": "abc123"  // Agent ID from previous execution
}

​

Leistungsüberlegungen

• Kontexteffizienzen: Agenten helfen dabei, den Hauptkontext zu bewahren, was längere Gesamtsitzungen ermöglicht
• Latenz: Subagenten starten jedes Mal, wenn sie aufgerufen werden, mit einem sauberen Blatt und können Latenz hinzufügen, da sie den Kontext sammeln, den sie benötigen, um ihre Arbeit effektiv zu erledigen.

​

Verwandte Dokumentation

• Plugins - Erweitern Sie Claude Code mit benutzerdefinierten Agenten durch Plugins
• Slash-Befehle - Erfahren Sie mehr über andere integrierte Befehle
• Einstellungen - Konfigurieren Sie das Verhalten von Claude Code
• Hooks - Automatisieren Sie Workflows mit Event-Handlern