Unteragenten: ein Werkzeug zum Hinzufügen und Verwalten von KI-Unteragenten für Claude Code

Sub-Agenten ist ein Befehlszeilenschnittstellen-Tool (CLI), das die Entwicklungsumgebung Claude Code von Anthropic erweitern soll. Es ermöglicht Entwicklern das einfache Hinzufügen, Verwalten und Erstellen von KI-"Unteragenten", die für bestimmte Programmieraufgaben zuständig sind. Bei diesen Unteragenten handelt es sich um vorkonfigurierte KI-Assistenten, die jeweils für einen bestimmten Bereich zuständig sind, z. B. Code-Review, Testen, Debugging, Dokumentation oder API-Entwicklung. Das Kernkonzept des Tools ist "Expert Blending", d. h. der Einsatz mehrerer hochspezialisierter Agenten, die zusammenarbeiten, anstatt sich auf eine generische KI zu verlassen, die alles erledigt. Dies hat den Vorteil, dass jeder Agent in einem isolierten Kontext mit eigenen Systemaufforderungen und spezialisierten Werkzeugen arbeitet, was die Genauigkeit und Effizienz der Aufgaben verbessert und die "Halluzinationen" reduziert, die auftreten können, wenn eine Allzweck-KI an komplexen Aufgaben arbeitet. Unteragenten sollen Entwicklungsabläufe vereinfachen und automatisieren, indem sie sofort einsatzbereite professionelle Agenten bereitstellen und die Flexibilität bieten, benutzerdefinierte Agenten zu erstellen.

Funktionsliste

• Spezialisierte AI-AgentenBietet eine Reihe vorgefertigter Agenten, von denen jeder ein Experte in einem bestimmten Entwicklungsbereich ist.
• Null-Konfiguration verwendenVorgefertigte Agenten sind sofort einsatzbereit und müssen nicht zusätzlich konfiguriert werden.
• Höhe kann individuell angepasst werdenErmöglicht es Entwicklern, benutzerdefinierte Agenten zu erstellen, die ihre spezifischen Workflow-Anforderungen erfüllen.
• Intelligentes KontextmanagementJeder Agent läuft in einem isolierten Kontext, um Interferenzen zwischen verschiedenen Aufgaben zu vermeiden.
• Integration mit Context-Forge: Kann nahtlos integriert werden mitcontext-forgeProjekte und ihre PRP-Dokumente (Project Relationship Planning) werden zusammen verwendet.
• BefehlszeilenschnittstelleInstallation, Initialisierung, Listenansicht, Aktivierung/Deaktivierung und Entfernung von Agenten können mit einfachen Befehlen durchgeführt werden.
• Unabhängige Durchsetzung von VollmachtenUnterstützung für die Ausführung von Agenten unabhängig von der Claude-Code-Umgebung, wodurch Automatisierung und Skripterstellung erleichtert werden.
• Web-DashboardBietet eine Webschnittstelle für die Echtzeit-Überwachung und -Verwaltung des Agentenstatus, des Aufgabenverlaufs und der Leistungsmetriken.
• HakensystemWorkflow-Automatisierung: Ermöglicht die Definition von Aktionen, die bei bestimmten Ereignissen automatisch ausgelöst werden (z. B. Bearbeitung von Dokumenten, Abschluss von Aufgaben).
• Zwei InstallationsbereicheUnterstützung für benutzerweite (für alle Projekte verfügbar) und projektweite (nur für das aktuelle Projekt verfügbar) Agenteninstallationen.

Hilfe verwenden

Sub-Agenten ist ein leistungsfähiges Kommandozeilen-Tool, mit dem Sie Claude Code um eine Reihe von spezialisierten KI-Sub-Agenten erweitern können. Im Folgenden erfahren Sie, wie Sie dieses Tool installieren und verwenden und wie Sie seine Hauptfunktionen nutzen können.

Einbauverfahren

Sie können Unteragenten auf verschiedene Weise installieren, wobei die Verwendung von NPM am empfehlenswertesten ist.

1. die NPM-Installation (empfohlen)
Öffnen Sie Ihr Terminal und führen Sie den folgenden Befehl für die globale Installation aus:

npm install -g @webdevtoday/claude-agents

2. die Installation des Garns
Wenn Sie es vorziehen, Yarn zu verwenden, können Sie den folgenden Befehl benutzen:

yarn global add @webdevtoday/claude-agents```
**3. 从源码安装**
你也可以直接从GitHub克隆源码进行安装，这适用于希望进行二次开发的用户：
```bash
git clone https://github.com/webdevtodayjason/sub-agents.git
cd sub-agents
npm install
npm link

Nach Abschluss der Installationclaude-agentswird in Ihrem Terminal verfügbar sein.

Erste Schritte

Nach einer erfolgreichen Installation können Sie auf dieinitBefehl Quick Start.

Für neue Projekte:
Führen Sie im Stammverzeichnis Ihres Projekts den folgenden Befehl aus, um alle verfügbaren Agenten zu initialisieren:

claude-agents init

Sie können dann dielistum alle verfügbaren Proxys anzuzeigen:

claude-agents list

Für Projekte, die bereits Context-Forge verwenden:
Wenn Ihr Projekt bereits diecontext-forgeSie können eine spezielleinitum die Kompatibilität zu gewährleisten:

claude-agents init --respect-context-forge

Dieser Befehl platziert den Proxy-Befehl auf intelligente Weise in der.claude/commands/agents/um Konflikte mit Ihren bestehenden Befehlen zu vermeiden, und aktualisiert sicher dieCLAUDE.mdDokumentation.

Hauptfunktionen

1. die Verwaltung der Agentur
Unteragenten bieten einen vollständigen Satz von Befehlen zur Verwaltung des Lebenszyklus von Agenten.

• Installations-Agent: Sie können einen oder mehrere Agenten interaktiv installieren.

  claude-agents install
  

  Oder installieren Sie alle verfügbaren Agenten auf einmal:

  claude-agents install --all
  

• Ansicht AgentListet alle installierten Agenten auf.

  claude-agents list --installed
  

• Proxy aktivieren/deaktivierenSie können einen Agenten jederzeit aktivieren oder deaktivieren.

  claude-agents disable test-runner
  claude-agents enable test-runner
  

• Proxy entfernen: Entfernen Sie einen nicht mehr benötigten Agenten.

  claude-agents remove debugger
  ```    或者进行批量卸载并清理相关文件：
  ```bash
  claude-agents uninstall --all --clean
  

2. die Verwendung von Vollmachten im Claude Code
Es gibt im Wesentlichen zwei Möglichkeiten, wie Sie in Claude Code Proxys aufrufen können:

• Slash-BefehleJeder Agent ist mit einem Schrägstrich-Befehl für den schnellen Aufruf verbunden. Um z. B. den Agenten für die Codeüberprüfung aufzurufen, geben Sie einfach ein:

  /review
  ```    对于需要参数的代理，可以在命令后附带参数：
  

  /debug Anmeldeproblem

• Aufgabenwerkzeug: Sie können auch verwendenTaskWerkzeuge zur Ausführung komplexerer Anweisungen.

  Task("project-planner: analyze all PRPs and create sprint plan")
  

3. eigenständige Betriebsmittel
Dies ist eine sehr leistungsstarke Funktion, mit der Sie Agenten direkt in Automatisierungsskripten oder Workflows verwenden können, ohne Claude Code öffnen zu müssen.

# 使用内联任务运行
claude-agents run marketing-writer --task "Write launch announcement for v2.0"
# 从文件读取任务
claude-agents run api-developer --file api-spec.md
# 以交互模式运行
claude-agents run tdd-specialist --interactive```
**4. 创建自定义代理**
如果预设的代理不能满足你的需求，你可以轻松创建自己的代理。
运行以下命令，工具会通过交互式问答引导你完成创建过程：
```bash
claude-agents create

Sie werden aufgefordert, den Namen und die Beschreibung des Agenten sowie die erforderlichen Tools zu definieren. Dies macht es sehr einfach, sehr individuelle KI-Assistenten zu erstellen.

5. die Verwendung des Web-Dashboards
Zur intuitiveren Verwaltung und Überwachung Ihrer Agenten bietet Sub-agents ein Web-Dashboard.
Aktivieren Sie das Dashboard:

claude-agents dashboard

Sie können auch die Portnummer angeben:

claude-agents dashboard --port 8080

Im Dashboard können Sie den Echtzeitstatus, den Verlauf der Aufgabenausführung und die Leistungskennzahlen aller Ihrer Agenten einsehen und schnell Maßnahmen ergreifen.

Mit den oben genannten Schritten können Sie die Verwendung von Unteragenten zur Steigerung Ihrer Entwicklungsproduktivität erlernen. Dieses Tool verbessert die Qualität und Geschwindigkeit der Codegenerierung, -überprüfung und -tests erheblich, indem es große Entwicklungsaufgaben auf KI-Experten in verschiedenen Bereichen aufteilt.

Anwendungsszenario

1. Automatisierte Codeüberprüfung
   Entwickler können diecode-reviewerAgenten, die umfassende Qualitäts-, Sicherheits- und Leistungsanalysen von neu eingereichtem Code durchführen. Der Agent prüft automatisch, ob der Code den Best Practices entspricht, und schlägt spezifische Optimierungen vor, wodurch sich der Aufwand für die manuelle Überprüfung verringert.
2. Unterstützung bei der Fehlersuche und Fehlerbehebung
   Wenn ein komplexer Fehler aufgetreten ist, können Sie diedebuggerAgent. Stellen Sie ihm Fehlermeldungen oder Stack Traces zur Verfügung, und der Agent hilft bei der Analyse der Problemursache und versucht, Lösungen anzubieten, um die Behebung des Problems zu beschleunigen.
3. Schnelles Prototyping
   In der Anfangsphase eines Projekts können mehrere Agenten in Kombination verwendet werden, um schnell einen Prototyp einer Anwendung zu erstellen. Verwenden Sie zum Beispiel denproject-plannerPlanungsfunktionsbausteine.api-developerdie Generierung der Backend-Schnittstelle.frontend-developerDie Entwicklung von Front-End-Schnittstellen verkürzt die Zeit, die vom Konzept bis zum Prototyp benötigt wird, drastisch.
4. Erstellung und Aktualisierung der technischen Dokumentation
   Die Erstellung und Pflege von Dokumentationen kann eine zeitraubende Aufgabe sein.doc-writerim Gesang antwortenapi-documenterDer Agent kann automatisch README-Dateien, API-Dokumentation (z. B. OpenAPI-Spezifikationen) usw. auf der Grundlage von Code und Kommentaren generieren und aktualisieren und so sicherstellen, dass die Dokumentation mit dem Code synchronisiert ist.
5. Testgetriebene Entwicklung (TDD)
   tdd-specialistAgenten können Entwicklern helfen, testgetriebene Entwicklung zu betreiben. Bevor Sie funktionalen Code schreiben, können Sie den Agenten auf der Grundlage der Anforderungen Testfälle erstellen lassen, und dann kann der Entwickler auf der Grundlage dieser Tests Implementierungscode schreiben.

QA

1. Was ist der Unterschied zwischen Unteragenten und der direkten Verwendung von Claude Code?
   Unteragenten ersetzen den Claude Code nicht, sondern erweitern ihn. Es löst das Problem, dass eine einzige Allzweck-KI nicht in der Lage ist, in allen Bereichen zu brillieren, indem es das Konzept der "spezialisierten Sub-Agenten" einführt. Jeder Sub-Agent konzentriert sich auf eine bestimmte Aufgabe, z. B. Code-Review oder Debugging, in einer isolierten Umgebung, wodurch die Ergebnisse genauer werden und eine kontextuelle Verwechslung zwischen verschiedenen Aufgaben vermieden wird.
2. Muss ich für jedes Mittel einzeln bezahlen?
   Sub-agents selbst ist ein kostenloses Open-Source-Tool. Es stützt sich jedoch auf Claude Code, um seine Aufgaben zu erfüllen, so dass Sie weiterhin Zugang zu Anthropics Claude Code haben und entsprechend für dessen Nutzung bezahlen müssen. Die Verwendung mehrerer Unteragenten kann den Token-Verbrauch erhöhen.
3. Ist es kompliziert, benutzerdefinierte Proxys zu erstellen?
   Unkompliziert. Das Tool bietet ein interaktives Kommandozeilenwerkzeugclaude-agents createEs führt Sie durch den Erstellungsprozess, einschließlich der Definition des Namens des Agenten, seiner Funktionsbeschreibung und der erforderlichen Tools. Alles, was Sie tun müssen, ist, die Aufgaben des Agenten in natürlicher Sprache zu beschreiben, ohne komplexen Code schreiben zu müssen.
4. Können diese Mittel zusammenarbeiten?
   Ja. Das Tool ist so konzipiert, dass mehrere Agenten zusammenarbeiten können. Mit dem Hooks-System können Sie Automatisierungsregeln einrichten, die es einem Agenten ermöglichen, einen anderen Agenten auszulösen, wenn dieser eine Aufgabe erledigt hat. Wenn zum Beispiel die Codebearbeitung abgeschlossen ist, können Sie automatisch dentest-runnerAgent, um den Test durchzuführen.
5. Wenn ich einen Agenten global installiere, wirkt sich das auf alle meine Projekte aus?
   Ja. Agenten können in zwei verschiedenen Bereichen installiert werden: im Benutzerbereich (~/.claude/agents/) und Projektumfang (.claude/agents/). Agenten, die im Benutzerbereich installiert sind, sind in allen Ihren Projekten verfügbar. Wenn Sie den Agenten nur für bestimmte Projekte verwenden möchten, können Sie ihn mit der Option--projectum es in den Projektumfang aufzunehmen.