Claude Agent SDK Entwicklerleitfaden
Das Claude Code SDK wurde offiziell in Claude Agent SDK umbenannt und bietet eine umfassendere Erfahrung beim Aufbau von KI-Agenten. Dieser Leitfaden behandelt Python/TypeScript-Quickstarts, Kernkonzepte und Best Practices für Unternehmen.
Aktualisiert 2026-09-21
Was ist das Claude Agent SDK
Offizielle Umbenennung
Der offizielle Migrationsleitfaden hat die Dokumentation ebenfalls neu strukturiert; beide Namen beziehen sich auf dasselbe SDK (geprüft am 2026-09-21).
Warum die Umbenennung
Der offizielle Grund ist der Scope: Die Bibliothek dient dem Aufbau von KI-Agenten über reine Coding-Aufgaben hinaus (geprüft am 2026-09-21).
Einheitliche Toolschnittstelle
Teilt dasselbe Tool-System und denselben Agent-Loop wie Claude Code und ermöglicht so einen nahtlosen Wechsel zwischen lokaler und Cloud-Bereitstellung.
Produktionsreif
Integrierte Fehlerwiederholung, Sitzungsverwaltung, Streaming-Ausgabe und weitere Enterprise-Funktionen sind sofort einsatzbereit.
Mehrsprachige Unterstützung
Offizielle SDKs für Python und TypeScript mit symmetrischem API-Design und umfassender Dokumentation.
Kernkonzepte
Tools
Vom Agenten aufrufbare Funktionen, die mit Decoratoren deklariert werden und automatisch ein JSON Schema erzeugen, damit Claude sie versteht und aufruft.
Agent Loop
Claude denkt → wählt ein Tool → führt es aus → beobachtet das Ergebnis → denkt weiter, bis die Aufgabe abgeschlossen ist.
Speicher / Kontext
Einheitliche Verwaltung von Kurzzeitspeicher innerhalb der Sitzung (Verlauf) und Langzeitspeicher über Sitzungen hinweg (Persistenz in Dateien/Datenbank).
Berechtigungen
Feingranulare Berechtigungskontrolle: Zugriffsscope für Dateisystem, Netzwerk, Code-Ausführung und externe APIs lassen sich unabhängig konfigurieren.
Python-Quickstart
Bauen Sie Ihren ersten Claude-Agenten in drei Schritten – vollständig kompatibel mit dem QCode.cc-Proxy.
Schritt 1: SDK installieren
python3 -m venv .venv && source .venv/bin/activate
pip install claude-agent-sdkSchritt 2: Agent erstellen
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
options = ClaudeAgentOptions(
system_prompt="You are an expert Python developer",
permission_mode="acceptEdits",
)
async for message in query(
prompt="Create a Python web server", options=options
):
print(message)
asyncio.run(main())Schritt 3: Eigene Tools definieren
import asyncio
from typing import Any
from claude_agent_sdk import (
ClaudeAgentOptions, create_sdk_mcp_server, query, tool
)
@tool("get_weather", "Get current weather for a city", {"city": str})
async def get_weather(args: dict[str, Any]) -> dict[str, Any]:
return {
"content": [
{"type": "text",
"text": f"Weather in {args['city']}: 22 C, sunny"}
]
}
weather_server = create_sdk_mcp_server(
name="weather",
version="1.0.0",
tools=[get_weather],
)
options = ClaudeAgentOptions(
mcp_servers={"weather": weather_server},
allowed_tools=["mcp__weather__get_weather"],
)
async def main():
async for message in query(
prompt="What's the weather in Beijing and Shanghai?",
options=options,
):
print(message)
asyncio.run(main())TypeScript-Quickstart
Entwicklung von Claude-Agenten in Node.js / Bun mit vollständiger Typunterstützung.
Schritt 1: SDK installieren
npm install @anthropic-ai/claude-agent-sdkSchritt 2: Agent erstellen
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Create a Python web server",
options: { systemPrompt: "You are an expert Python developer" },
})) {
console.log(message);
}Schritt 3: Vollständiges Beispiel
import { tool, createSdkMcpServer, query } from "@anthropic-ai/claude-agent-sdk";
import { z } from "zod";
const getTemperature = tool(
"get_temperature",
"Get the current temperature at a location",
{
latitude: z.number().describe("Latitude coordinate"),
longitude: z.number().describe("Longitude coordinate")
},
async (args) => {
return {
content: [{ type: "text", text: `Temperature at ${args.latitude}` }]
};
}
);
const weatherServer = createSdkMcpServer({
name: "weather",
version: "1.0.0",
tools: [getTemperature]
});
for await (const message of query({
prompt: "What's the temperature in Beijing?",
options: {
mcpServers: { weather: weatherServer },
allowedTools: ["mcp__weather__get_temperature"]
}
})) {
console.log(message);
}Agent SDK vs. Managed Agents
| Aspekt |
Agent SDK
|
Managed Agents
|
|---|---|---|
| Laufzeitumgebung | Self-Hosted (lokal / eigener Server) | Cloud-Hosting durch Anthropic |
| Skalierung | Manuelle Instanzverwaltung | Automatische elastische Skalierung |
| Anwendungsfall | Prototyping, stark individualisierte Szenarien | Produktiver Einsatz von Agenten im Unternehmensumfeld |
Nutzung über QCode.cc
Richten Sie ANTHROPIC_BASE_URL auf den QCode.cc-Endpunkt, um das Agent SDK direkt aus China zu nutzen – ohne VPN. Was aufrufbar ist, erfahren Sie unter /models. Bei Managed Agents hostet Anthropic den Agenten selbst (offizielle Dokumentation, abgerufen am 2026-09-22); diesen Pfad haben wir hier nicht verifiziert und übernehmen diesbezüglich keine Zusicherung.
# Python SDK
ANTHROPIC_BASE_URL=https://api.qcode.cc
ANTHROPIC_API_KEY=your-qcode-api-key
# TypeScript SDK
ANTHROPIC_BASE_URL=https://api.qcode.cc
ANTHROPIC_API_KEY=your-qcode-api-key
# Point the endpoint at your own gateway: the SDK reads it from env
from claude_agent_sdk import ClaudeAgentOptions
options = ClaudeAgentOptions(
env={
"ANTHROPIC_BASE_URL": "https://api.qcode.cc",
},
)Alle Claude-Modelle (Fable 5 / Opus 4.8 / Sonnet 4.6 / Haiku 4.5) verfügbar
Vollständige Unterstützung für Tool-Aufrufe (Function Calling)
Unterstützung für Streaming-Ausgabe
Gleiches Format wie die offizielle Messages API – das Agent SDK benötigt lediglich ANTHROPIC_BASE_URL
Beginnen Sie noch heute mit dem Aufbau von KI-Agenten
Registrieren Sie sich bei QCode.cc für stabilen Claude-API-Zugriff aus China – mit Unterstützung aller Agent-SDK-Funktionen.