Agent SDK – Übersicht
Erstellen Sie produktive KI-Agenten mit Claude Code als Bibliothek
Ein Agent ist eine Anwendung, die eine Aufgabe durch Planung eigener Schritte und Aufrufen von Tools abschließt, die Dateien lesen, Befehle ausführen oder Code bearbeiten. Das Agent SDK bietet Ihnen die gleichen Tools, die Agent-Schleife und das Kontextmanagement, die Claude Code antreiben, programmierbar in Python und TypeScript.
Vergleichen Sie das Agent SDK mit anderen Claude-Tools
Das Agent SDK, die CLI, das Client SDK und Managed Agents unterscheiden sich darin, wer den Agenten ausführt, welche Funktionen bereits integriert sind und wie Sie darauf zugreifen. Finden Sie die Zeile, die Ihrer gewünschten Vorgehensweise entspricht.
| Sie möchten | Verwenden Sie | Was Sie erhalten |
|---|---|---|
| Claude Code's Agenten in Ihrer eigenen Python- oder TypeScript-Anwendung in einem von Ihnen betriebenen Prozess einbetten | Agent SDK | Eine Bibliothek, die die Claude Code-Binärdatei ausführt, mit Claude Code's Funktionen, wie z. B. integrierte Tools, Berechtigungen, Sitzungen und Hooks. |
| Interaktive Entwicklung durchführen oder einmalige Aufgaben von einem Terminal aus ausführen | Claude Code CLI | Die Terminal-Schnittstelle, entwickelt für tägliche interaktive Nutzung. |
| Die Claude API direkt aus Ihrem eigenen Code aufrufen | Client SDK | Direkter Zugriff auf die Claude API aus einer beliebigen Client SDK-Sprache. Sie schreiben die Tool-Schleife selbst, oder lassen Sie den Tool Runner des Client SDK diese steuern. |
| Den Agenten von Anthropic hosten lassen, konfiguriert über die Claude API | Managed Agents | Ein gehostetes Agent-Harness, das die Agent-Schleife ausführt, mit Sitzungen in einer von Anthropic verwalteten Cloud-Sandbox oder einer selbst gehosteten Sandbox auf Ihrer eigenen Infrastruktur. Verwenden Sie es über das SDK für Ihre Sprache, die ant CLI oder die REST API. |
Um die gleiche Agent-Schleife aus einer anderen Sprache als Python oder TypeScript zu steuern, führen Sie die CLI als Unterprozess aus mit dem Flag -p und --output-format json.
Funktionen
Diese Claude Code-Funktionen sind im SDK verfügbar:
| Funktion | Was es tut | Weitere Informationen |
|---|---|---|
| Integrierte Tools | Dateien lesen, schreiben, bearbeiten, Befehle ausführen und das Web durchsuchen | Tools-Referenz |
| Hooks | Benutzerdefinierten Code an wichtigen Punkten im Agent-Lebenszyklus ausführen | Hooks |
| Subagenten | Spezialisierte Agenten für fokussierte Teilaufgaben spawnen | Subagenten |
| MCP | Externe Tools und Datenquellen über das Model Context Protocol verbinden | MCP |
| Berechtigungen | Kontrollieren, welche Tools automatisch ausgeführt werden, welche Genehmigung benötigen | Berechtigungen |
| Sitzungen | Kontext über mehrere Austausche hinweg beibehalten, später fortsetzen oder verzweigen | Sitzungen |
| Skills, Befehle und Memory | Automatisch aus dem .claude/-Verzeichnis Ihres Projekts und aus ~/.claude/ laden, wie in Claude Code |
Skills, Befehle, Memory, Konfigurationsladung |
| Plugins | Skills, Agenten, Hooks und MCP-Server verpacken und nach lokalem Pfad laden | Plugins |
Erste Schritte
Folgen Sie der Schnellstartanleitung, um das SDK zu installieren, Ihren API-Schlüssel festzulegen und Ihren ersten Agent zu erstellen – einen, der Fehler in vorhandenem Code findet und behebt.
Änderungsprotokoll
Sehen Sie sich das vollständige Änderungsprotokoll für SDK-Updates, Fehlerbehebungen und neue Funktionen an:
- TypeScript SDK: CHANGELOG.md anzeigen
- Python SDK: CHANGELOG.md anzeigen
Fehler melden
Wenn Sie auf Fehler oder Probleme mit dem Agent SDK stoßen:
- TypeScript SDK: Probleme auf GitHub melden
- Python SDK: Probleme auf GitHub melden
Richtlinien für die Markennutzung
Für Partner, die das Claude Agent SDK integrieren, ist die Verwendung von Claude-Branding optional. Wenn Sie Claude in Ihrem Produkt referenzieren:
Erlaubt:
- „Claude Agent" (bevorzugt für Dropdown-Menüs)
- „Claude" (wenn bereits in einem Menü mit der Bezeichnung „Agents")
- „{YourAgentName} Powered by Claude" (wenn Sie einen vorhandenen Agentennamen haben)
Nicht erlaubt:
- „Claude Code" oder „Claude Code Agent"
- Claude Code-Branding ASCII-Art oder visuelle Elemente, die Claude Code nachahmen
Ihr Produkt sollte sein eigenes Branding beibehalten und nicht wie Claude Code oder ein anderes Anthropic-Produkt aussehen. Wenden Sie sich bei Fragen zur Markenkonformität an das Anthropic-Vertriebsteam.
Lizenz und Bedingungen
Die Verwendung des Claude Agent SDK unterliegt den Anthropic Commercial Terms of Service, auch wenn Sie es verwenden, um Produkte und Dienste bereitzustellen, die Sie Ihren eigenen Kunden und Endbenutzern zur Verfügung stellen, außer soweit eine bestimmte Komponente oder Abhängigkeit unter einer anderen Lizenz abgedeckt ist, wie in der LICENSE-Datei dieser Komponente angegeben.
Nächste Schritte
Diese Ressourcen behandeln tiefere technische Details und Beispielprojekte für die Entwicklung mit dem Agent SDK.
- Schnellstart: Erstellen Sie Ihren ersten Agenten, der Fehler findet und behebt
- Migrationsleitfaden: Migrieren Sie von den Claude Code SDK-Paketen zum Agent SDK
- Agent-Schleife: Wie Claude plant, Tools aufruft und entscheidet, wann eine Aufgabe abgeschlossen ist
- Beispielagenten: Demo-Apps für die lokale Entwicklung
- TypeScript SDK: Vollständige TypeScript-API-Referenz und Beispiele
- Python SDK: Vollständige Python-API-Referenz und Beispiele
- Agent-Harness-Design: Wie das Claude Code-Team dynamische Workflows verwendet, um viele Subagenten gleichzeitig zu orchestrieren