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 erfüllen jeweils unterschiedliche Anforderungen. Verwenden Sie die Tabelle, um das Tool zu finden, das zu Ihrem Projekt passt.
| Wenn Sie... | Verwenden Sie | Warum |
|---|---|---|
| Einen Agenten erstellen, ohne die Tool-Schleife selbst zu implementieren | Agent SDK | Eine Python- oder TypeScript-Bibliothek, die die Agent-Schleife für Sie ausführt. |
| 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 API direkt aufrufen und die Tool-Schleife selbst implementieren | Client SDK | Direkter Zugriff auf die Anthropic API statt auf Claude Code. Sie implementieren die Tool-Schleife selbst. |
| Langfristig laufende oder asynchrone Agenten ausführen, ohne Ihre eigene Sandbox oder Session-Infrastruktur zu verwalten | Managed Agents | Gehostete REST API, ein separates Produkt vom Agent SDK. Anthropic führt den Agenten und die Sandbox aus. |
Das SDK ist nur als Bibliothek für Python und TypeScript verfügbar. Um die gleiche Agent-Schleife aus einer anderen Sprache 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