Zum Inhalt springen
3.6Fortgeschritten7 min

Claude Agent SDK: Anthropic-native Agenten bauen

Blck Alpaca·
Definition

Das Claude Agent SDK ist Anthropics offizielles Framework, um produktionsreife KI-Agenten auf Basis der Claude-Modelle zu bauen. Es liefert ein fertiges Agent-Harness mit Tool-Use, nativer MCP-Integration, Subagents, Session- und Kontext-Management sowie integriertem Permission- und Sandbox-System. Hervorgegangen aus dem Claude Code SDK (umbenannt am 29. September 2025).

Auf einen Blick

  • Das Claude Agent SDK ging am 29.09.2025 aus dem Claude Code SDK hervor und liefert dasselbe erprobte Toolset wie Claude Code (Read/Write/Edit, Bash, Web, File).
  • Kernfeatures sind Subagents, Sessions, Hooks, integriertes Permission-Management und Sandbox sowie native MCP-Integration über in-process MCP-Server.
  • Das SDK ist an Claude-Modelle gebunden (Provider-Lock); EU-Datenresidenz läuft über AWS Bedrock, Google Vertex oder Azure AI Foundry statt über den US-Anthropic-Endpoint.
  • Stand 2026 ist die API noch v0.x (TS 0.2.x / Python 0.1.34, Feb 2026) mit Breaking Changes; Code unter Apache 2.0, Nutzung unter Anthropic Commercial Terms.
  • Best fit: Coding-Agenten, Research-Agenten und Long-Running-Tasks in Anthropic-zentrischen Stacks; A2A wird nicht offiziell nativ unterstützt.

Das Claude Agent SDK ist Anthropics offizielles Framework, um produktionsreife KI-Agenten direkt auf den Claude-Modellen zu bauen. Statt die Tool-Schleife eines Agenten manuell zu programmieren, liefert das SDK ein fertiges Agent-Harness: automatische Tool-Loops, native MCP-Integration, Subagents, Session- und Kontext-Management sowie ein integriertes Permission- und Sandbox-System. Es ging am 29. September 2025 aus dem Claude Code SDK hervor und nutzt dasselbe Toolset, das auch hinter Claude Code steckt.

Drei Schnellantworten

  • Was es ist: Ein Anthropic-natives SDK (Python und TypeScript), das Claude managed Tool-Loops, Sessions, Sandboxing und Subagents bereitstellt, also alles, was man sonst um einen rohen LLM-API-Call selbst bauen muss.
  • Wann es passt: Coding-Agenten, Research-Agenten und langlaufende, mehrstufige Tasks in einem Stack, der bewusst auf Claude-Modelle setzt.
  • Was man beachten muss: Provider-Lock auf Claude, API noch v0.x mit Breaking Changes (Stand 2026), Code unter Apache 2.0, Nutzung aber unter Anthropic Commercial Terms.

Vom Claude Code SDK zum Claude Agent SDK

Das Framework hieß ursprünglich Claude Code SDK und war das technische Fundament des Coding-Agenten Claude Code. Mit der Umbenennung am 29. September 2025 positioniert Anthropic es bewusst breiter: nicht nur für Coding, sondern als generelles Harness für Agenten mit Tool-Use. Der Kerngedanke bleibt das sogenannte „Dogfooding": Entwickler bekommen exakt dasselbe Toolset und dieselbe Loop-Mechanik, die Anthropic intern für Claude Code einsetzt, also Read, Write, Edit, Bash, File- und Web-Tools.

Das ist der entscheidende Unterschied zum reinen Anthropic Client SDK. Beim Client SDK schreibt man die Agenten-Schleife selbst: Modell aufrufen, Tool-Call entgegennehmen, Tool ausführen, Ergebnis zurückspielen, erneut aufrufen. Das Agent SDK übernimmt genau diese Orchestrierung und ergänzt sie um Produktions-Bausteine. Anthropic selbst warnt in „Building Effective Agents" (Dezember 2024) davor, bei nichttrivialer Tool-Nutzung solche Loops von Hand zu bauen, empfiehlt aber gleichzeitig das Prinzip „simplest solution first": Wer nur einen einzelnen API-Call braucht, braucht kein Framework.

Die zentralen Bausteine

Tool-Use und das Claude-Code-Toolset. Das SDK bringt die erprobten Werkzeuge File, Bash, Web sowie Read/Write/Edit mit. Damit kann ein Agent Dateien lesen und schreiben, Shell-Befehle ausführen und Web-Inhalte abrufen, ohne dass man diese Tools selbst definieren und absichern muss.

Native MCP-Integration. Das Model Context Protocol (MCP) ist im Claude Agent SDK nativ verankert; MCP-Server können sogar in-process betrieben werden. MCP standardisiert den Zugriff auf externe Tools, Datenquellen und APIs. Seit der Übergabe an die Linux Foundation Agentic AI Foundation (AAIF) am 9. Dezember 2025 ist das Protokoll vendor-neutral; laut Anthropic erreichte es im April 2026 über 110 Millionen monatliche SDK-Downloads und mehr als 10.000 aktive Server. Für Agenturen heißt das: einmal als MCP-Server gebaute Integrationen sind auch außerhalb des Anthropic-Ökosystems wiederverwendbar.

Subagents und Sessions. Statt eines klassischen Graph-Modells (wie bei LangGraph) setzt das SDK auf Subagents und Sessions für Multi-Step- und arbeitsteilige Abläufe. Ein Hauptagent kann spezialisierte Subagents für Teilaufgaben spawnen; Sessions halten den Kontext über mehrere Schritte. Eine native A2A-Unterstützung (Agent-to-Agent-Protokoll) gibt es offiziell nicht, was das SDK von Microsoft Agent Framework, CrewAI oder Pydantic AI abgrenzt.

Kontext- und Permission-Management plus Sandbox. Das SDK verwaltet den Kontext über die Session und enthält ein integriertes Permission-System sowie Sandboxing. In der Production-Readiness-Bewertung der Research gehört das SDK damit zur Spitzengruppe bei Security/Sandbox. Permissions steuern, welche Aktionen ein Agent ausführen darf, etwa welche Dateien geschrieben oder welche Befehle ausgeführt werden dürfen, ein wichtiger Hebel für Human-in-the-Loop und Audit-Anforderungen.

Observability über Hooks. Anders als LangGraph (LangSmith) oder Pydantic AI (Logfire) hat das SDK keine reife First-Party-Observability-Plattform. Es arbeitet Hooks-basiert und integriert mit der Anthropic Console. Wer reines SDK-Self-Hosting betreibt, muss eigenes strukturiertes Logging für Traceability und EU-AI-Act-relevante Nachweise ergänzen.

Einordnung im Anthropic-Ökosystem

Die Stärke des SDK liegt in der engen Kopplung an die Claude-Modelle und an MCP. Im Layer-Modell der Frameworks sitzt es zusammen mit dem OpenAI Agents SDK auf der Agent-Runtime/Harness-Ebene, also eine Schicht über den reinen Provider-SDKs und mit anderem Charakter als die Framework-Schicht (LangGraph, CrewAI, Pydantic AI). Diese Nähe ist Vorteil und Einschränkung zugleich: Optimierung und Toolset sind auf Claude zugeschnitten, dafür gibt es keinen Model-Swap auf GPT, Gemini oder lokale Modelle.

Dimension

Claude Agent SDK (Stand 2026)

Vendor

Anthropic (US)

Sprachen

Python, TypeScript

Letzte Version

TS 0.2.x / Python 0.1.34 (Februar 2026), API v0.x

Lizenz

Apache 2.0 (Code); Nutzung unter Anthropic Commercial Terms

MCP

nativ (in-process MCP-Server)

A2A

nicht offiziell nativ

Multi-Agent

Subagents + Sessions (kein Graph-Modell)

Security/Sandbox

integriert (Permissions, Sandbox)

Observability

Hooks-basiert, Anthropic Console

Hosting

Anthropic-Endpoint (US), AWS Bedrock, Google Vertex, Azure AI Foundry; SDK lokal lauffähig

Produktionsanwender

Stripe (Claude Code), Anthropic intern, Apple Xcode 26.3

Zur Verbreitung: Das TypeScript-Paket verzeichnete laut Sekundärquellen rund 1,85 Millionen NPM-Wochendownloads (Februar 2026). Mit Apple Xcode 26.3 hat ein prominenter Hersteller das SDK nativ integriert. Diese Zahlen sind als Momentaufnahme zu verstehen und vor jeder Veröffentlichung neu zu prüfen.

DACH-Perspektive: Souveränität und Lizenz

Für DACH-B2B-Entscheider sind zwei Punkte zentral. Erstens die Datenresidenz: Der direkte Anthropic-Endpoint liegt in den USA. Für strikte EU-/DSGVO-Anforderungen führt der Weg über AWS Bedrock (EU-Region), Google Vertex oder Azure AI Foundry. Das SDK selbst ist OSS und lokal lauffähig, der Modell-Endpoint ist es nicht, daher die Einordnung „mittlere Souveränität" gegenüber vollständig self-hostbaren Frameworks wie n8n (DE-Vendor), LangGraph oder Pydantic AI.

Zweitens die Lizenz: Der SDK-Code steht unter Apache 2.0, die Nutzung der Claude-Modelle jedoch unter den Anthropic Commercial Terms, nicht unter einem reinen Open-Source-Mindset. Diese Trennung gehört sauber in jede Vendor-Evaluation und Procurement-Prüfung.

Konkretes Beispiel

Angenommen, eine Agentur baut einen Research-Agenten, der für jede Anfrage interne Markdown-Dokumente durchsucht, einen Wettbewerber-Steckbrief erstellt und das Ergebnis als Datei ablegt. Mit dem Client SDK müsste das Team die komplette Tool-Loop, Fehlerbehandlung und Kontext-Verwaltung selbst schreiben, in Drittanalysen für vergleichbare ReAct-Agenten grob 40 bis über 100 Zeilen Orchestrierungs-Code. Mit dem Claude Agent SDK reduziert sich das auf eine Konfiguration:

```python

Pseudocode, Claude Agent SDK (Stand 2026, API v0.x)

options = ClaudeAgentOptions(
model="claude-...", # an Claude-Modelle gebunden
allowed_tools=["Read", "Write", "Web"],
permission_mode="ask", # Human-in-the-Loop bei kritischen Aktionen
mcp_servers=[crm_mcp_server], # native MCP-Anbindung, z. B. CRM
setting_sources=[...], # nach Rename explizit zu setzen
)

Subagent fuer die reine Recherche, Hauptagent fasst zusammen

agent.run("Erstelle einen Wettbewerber-Steckbrief zu Firma X.")
```

Wichtig beim Umstieg von der alten Benennung: ClaudeCodeOptions heißt jetzt ClaudeAgentOptions, und setting_sources muss seit dem Rename explizit gesetzt werden. Die Tool-Loops, das Spawnen des Recherche-Subagents, das Session-Kontextmanagement und die Permission-Abfrage vor dem Schreiben der Datei übernimmt das SDK.

Für Agenturen und B2B

Das Claude Agent SDK ist die richtige Wahl, wenn die strategische Modell-Entscheidung ohnehin auf Claude fällt und der Schwerpunkt auf Coding-, Research- oder Long-Running-Agenten liegt. Es verkürzt die Time-to-Production durch ein erprobtes Harness und native MCP-Anbindung erheblich. Wer dagegen Modell-Agnostik, native A2A-Multi-Agent-Kommunikation, eine reife First-Party-Observability oder vollständige EU-Souveränität ohne US-Vendor braucht, sollte LangGraph, Pydantic AI oder n8n prüfen. Blck Alpaca evaluiert für DACH-Kund:innen Framework, Hosting-Pfad (Bedrock/Vertex/Azure-EU) und Lizenz-Implikationen gemeinsam, damit aus dem Prototyp ein DSGVO-konformer Produktionsbetrieb wird. Alle Versions-, Preis- und Verbreitungsangaben sind Stand 2026 und vor Projektstart neu zu verifizieren.

Häufig gestellte Fragen

Was ist der Unterschied zwischen dem Claude Agent SDK und dem Anthropic Client SDK?
Das Anthropic Client SDK erfordert, dass Entwickler die Tool-Schleife (Tool-Aufruf, Ergebnis zurückspielen, nächster Modell-Call) selbst implementieren. Das Claude Agent SDK übernimmt diese Tool-Loops automatisch und ergänzt Sessions, Subagents, Kontext-Management, Permissions und Sandboxing als fertiges Agent-Harness.
Unterstützt das Claude Agent SDK MCP nativ?
Ja. Das Claude Agent SDK bietet native MCP-Unterstützung und kann MCP-Server sogar in-process betreiben. Damit lassen sich externe Tools, Datenquellen und APIs standardisiert anbinden, ohne Custom-Adapter zu schreiben. MCP ist seit Dezember 2025 unter der Linux Foundation (AAIF) vendor-neutral.
Welche Programmiersprachen und Modelle unterstützt das SDK?
Das Claude Agent SDK gibt es für Python und TypeScript. Es ist an die Claude-Modelle von Anthropic gebunden. Der Zugriff läuft über den Anthropic-Endpoint (US) oder über AWS Bedrock, Google Vertex und Azure AI Foundry, was EU-Datenresidenz-Pfade für DACH-Deployments ermöglicht.
Ist das Claude Agent SDK produktionsreif (Stand 2026)?
Die Bibliothek wird produktiv eingesetzt (etwa Stripe in Claude Code, Anthropic intern, Apple Xcode 26.3), die API ist Stand Februar 2026 jedoch noch v0.x (TS 0.2.x, Python 0.1.34) mit möglichen Breaking Changes. Versionen pinnen und Changelogs beobachten ist Pflicht.
Für welche Use-Cases eignet sich das Claude Agent SDK am besten?
Es spielt seine Stärken bei Coding-Agenten, Research-Agenten und langlaufenden, mehrstufigen Aufgaben aus, also dort, wo das aus Claude Code stammende Toolset und Subagents Vorteile bringen. Ideal für Teams mit Anthropic-zentrischem Stack; für A2A-Multi-Agent-Szenarien sind native Alternativen besser.

Tiefer einsteigen?

Erhalte neue Analysen direkt ins Postfach – oder sieh dir an, wie wir dieses Wissen für Unternehmen umsetzen.