Was ist Claude Agent SDK?
Mit dem Claude Agent SDK kann ein Python- oder TypeScript-Programm dieselbe Agentenschleife, dieselben Tools und dasselbe Kontextmanagement nutzen, die Claude Code antreiben. Früher hieß es Claude Code SDK. Die Bibliothek startet ein mitgeliefertes Claude-Code-Binary und tauscht Nachrichten mit ihm aus, sodass ein darauf gebauter Agent ab Werk Dateien lesen, schreiben und bearbeiten, Shell-Befehle ausführen und im Web suchen kann.
query() führt eine einmalige Aufgabe als asynchronen Stream aus; ClaudeSDKClient hält eine zweiseitige Sitzung und ergänzt eigene Tools, geschrieben als normale Python-Funktionen und bereitgestellt als In-Process-MCP-Server, sowie Hooks, die deinen Code an Punkten im Lebenszyklus des Agenten ausführen. Subagenten, Sitzungen zum Fortsetzen oder Abzweigen, Berechtigungsmodi, Skills, Plugins und Projektgedächtnis aus .claude/-Ordnern werden aus Claude Code übernommen.
Das Python-Paket braucht Python 3.10 oder neuer. Version 0.2.178 erschien am 4. November 2026 mit mitgeliefertem Claude Code 2.1.318; das TypeScript-Paket heißt @anthropic-ai/claude-agent-sdk.
Lohnt sich Claude Agent SDK?
Der Wert des Agent SDK liegt darin, dass die schweren Teile schon geschrieben sind. Dateibearbeitung, Shell-Zugriff, Kontextkomprimierung, Subagenten und Berechtigungsabfragen kommen aus Claude Code, das Anthropic alle paar Tage aktualisiert, und so ergibt ein zehnzeiliger query()-Aufruf einen Agenten, der einen Fehler in einem echten Repository beheben kann. Konkurrierende Frameworks wie das OpenAI Agents SDK oder LangGraph liefern Bausteine zum Zusammensetzen; dieses liefert eine fertige Umgebung, die man einschränken muss.
Diese Umkehrung prägt das Sicherheitsmodell. Standardmäßig hat Claude das volle Claude-Code-Werkzeugset, einschließlich Bash und Write. allowed_tools genehmigt nur die aufgeführten Tools automatisch; es entfernt die übrigen nicht, die an den Berechtigungsmodus und deinen can_use_tool-Callback weitergehen. Zum Entfernen eines Tools braucht es disallowed_tools. Wer das SDK in einen Dienst einbaut, sollte den Berechtigungsleitfaden vor dem Quickstart lesen und den Prozess in einem Container laufen lassen, wenn die Eingaben nicht vertrauenswürdig sind.
Das Open-Source-Etikett braucht eine Fußnote. Der Python-Wrapper steht unter MIT-Lizenz, aber die Arbeit erledigt das mitgelieferte Claude-Code-Binary, und laut Doku unterliegt die Nutzung des SDK Anthropics Commercial Terms. Das TypeScript-Repository ist mit allen Rechten vorbehalten gekennzeichnet. Die Agentenschleife lässt sich nicht forken, nur konfigurieren.
Der Release-Takt folgt Claude Code: 25 Python-Releases zwischen dem 15. September und dem 4. November 2026, von 0.2.153 bis 0.2.178, noch unter 1.0. Das Repository hat etwa 8.440 Sterne und 616 offene Issues und Pull Requests. Die Doku untersagt Drittanbieterprodukten ohne Genehmigung, claude.ai-Anmeldung oder Planlimits anzubieten, ein darauf gebautes Produkt rechnet also über API-Schlüssel ab; auf dem eigenen Rechner eines Entwicklers verbraucht die angemeldete Nutzung dessen Claude-Plan. Ein für den 15. Juni 2026 angekündigtes monatliches SDK-Guthaben wurde am selben Tag ausgesetzt.
Wo es sich lohnt
Ein Plattformingenieur in einem Unternehmen mit 100 Entwicklern
Einen internen Bot betreiben, der fehlgeschlagene CI-Jobs sortiert und Patches vorschlägt
query() aus dem CI-Runner aufrufen, mit cwd auf dem Checkout, disallowed_tools für alles außerhalb des Repos und einem PreToolUse-Hook, der Netzwerkbefehle blockiert; die Nutzung läuft über einen API-Schlüssel der Console mit eigenem Ausgabenlimit.
Ein Start-up, das einem Dokumentenmanagement-Produkt einen Agenten hinzufügt
Kunden einen Agenten bitten lassen, ihre Dateien neu zu ordnen und zusammenzufassen
Die eigenen Produktaktionen mit dem @tool-Decorator und create_sdk_mcp_server als Tools bereitstellen, damit sie im Prozess laufen; jede Kundensitzung läuft im eigenen Container, und abgerechnet wird über API-Schlüssel, weil claude.ai-Anmeldung nicht erlaubt ist.
Eine Einzelentwicklerin, die Routinearbeit auf ihrem Laptop automatisiert
Wiederkehrende Refactorings skripten, ohne eine Agentenschleife zu schreiben
Ein kurzes Python-Skript mit ClaudeSDKClient und dem Modus acceptEdits erledigt die Änderungen; mit ihrem persönlichen Claude-Plan angemeldet, verbraucht es dessen Limits statt eine eigene Rechnung zu erzeugen.
Bevor du dich festlegst
- Einrichtung
- pip install claude-agent-sdk unter Python 3.10+ (oder npm install @anthropic-ai/claude-agent-sdk), einen API-Schlüssel setzen, und der Fehlerbehebungs-Agent aus dem Quickstart läuft in Minuten; eine separate Claude-Code-Installation ist nicht nötig.
- Integrationen
- MCP-Server, In-Process-Tools, Hooks, Subagenten, Skills und Plugins aus .claude/-Ordnern; Claude API, Amazon Bedrock, Google Cloud und Microsoft Foundry für den Modellzugang.
- Daten und Datenschutz
- Läuft lokal mit den Rechten seines Prozesses und schickt Prompts und Dateiinhalte zu den API- oder Planbedingungen des Kontos an Claude; das Standard-Werkzeugset kann überall lesen, schreiben und ausführen, wo der Prozess es kann.
- Kosten im großen Maßstab
- Das SDK ist kostenlos; die Kosten sind Claude-Tokens zu API-Preisen, und Agentenschleifen mit vielen Tool-Aufrufen vervielfachen die Tokens pro Aufgabe. Die Pläne Max, Ultra und Team enthalten monatliche API-Guthaben, nutzbar mit einem verknüpften Console-Schlüssel.
- Grenzen
- Nur Claude-Modelle; API vor 1.0 mit häufigen Releases; Markenregeln verbieten, ein Produkt Claude Code zu nennen; die Agentenschleife selbst lässt sich nicht ändern.
Was gut ist
- Datei-, Shell- und Web-Tools von Claude Code ab Werk
- Eigene Tools als In-Process-MCP-Server, ohne separaten Prozess
- Hooks, Subagenten, Sitzungen und Plugins übernommen
- Derselbe Motor über die API, Bedrock, Google Cloud und Foundry
- Häufige Releases im Takt von Claude Code
Was nicht
- Kern-Binary ist geschlossen und unterliegt Anthropics Commercial Terms
- Standardmäßig alle Tools verfügbar; allowed_tools schränkt nicht ein
- Nur Claude-Modelle
- Vor 1.0, mit Releases alle paar Tage
- Produkte dürfen ihren Nutzern keine claude.ai-Anmeldung anbieten
Am besten für
Entwickler, die einen Coding- oder Dateiagenten auf Claude-Code-Niveau in ihrem eigenen Produkt wollen und auf Claude festgelegt sind.
Alternativen zu Claude Agent SDK
Claude Agent SDK: häufige Fragen
- Lohnt sich Claude Agent SDK?
- Schneller kommt man nicht zu einem Agenten, der schon Dateien bearbeiten und Befehle ausführen kann, sofern man Claude Code als geschlossenen Motor darin akzeptiert. Wir bewerten es mit 4.2 von 5.
- Was kostet Claude Agent SDK?
- Python-Wrapper kostenlos unter MIT-Lizenz; das mitgelieferte Claude-Code-Binary und das TypeScript-Paket unterliegen Anthropics Commercial Terms. Du zahlst für die Nutzung der Claude API oder verbrauchst die Limits deines eigenen Claude-Plans.
- Welche Nachteile hat Claude Agent SDK?
- Kern-Binary ist geschlossen und unterliegt Anthropics Commercial Terms; Standardmäßig alle Tools verfügbar; allowed_tools schränkt nicht ein; Nur Claude-Modelle; Vor 1.0, mit Releases alle paar Tage; Produkte dürfen ihren Nutzern keine claude.ai-Anmeldung anbieten.
- Für wen eignet sich Claude Agent SDK?
- Entwickler, die einen Coding- oder Dateiagenten auf Claude-Code-Niveau in ihrem eigenen Produkt wollen und auf Claude festgelegt sind.
- Was kostet Claude Agent SDK für ein Team oder im Produktivbetrieb?
- Das SDK ist kostenlos; die Kosten sind Claude-Tokens zu API-Preisen, und Agentenschleifen mit vielen Tool-Aufrufen vervielfachen die Tokens pro Aufgabe. Die Pläne Max, Ultra und Team enthalten monatliche API-Guthaben, nutzbar mit einem verknüpften Console-Schlüssel.
- Ist Claude Agent SDK sicher für Firmendaten?
- Läuft lokal mit den Rechten seines Prozesses und schickt Prompts und Dateiinhalte zu den API- oder Planbedingungen des Kontos an Claude; das Standard-Werkzeugset kann überall lesen, schreiben und ausführen, wo der Prozess es kann.
- Was sind die besten Alternativen zu Claude Agent SDK?
- Die nächsten Alternativen, die wir getestet haben, sind OpenAI Agents SDK, Pydantic AI, LangGraph und Google Agent Development Kit (ADK).
Antworten geprüft am 6. Nov. 2026.
Du entwickelst Claude Agent SDK? Zeig diese Bewertung auf deiner Website
