Startseite › Claude Code › Agent SDK
ÜberblickInstallationCLI-ReferenzPreise und LimitsAgent SDKSkills und PluginsGitHubWeb, Desktop und IDEModelleFehlerOpen Source?TutorialFür StudierendeQA-AutomatisierungVergleich mit CursorVergleich mit Codex und OpenCodeSubagentenHooksMCPÖkosystemVS CodeOpenRouterAnfragelimitsChinesischer Leitfaden
Zuletzt aktualisiert: 11. Oktober 2026

Das Claude Code SDK, jetzt Claude Agent SDK

Derselbe Agentenzyklus, der in Ihrem Terminal läuft, ist als Bibliothek verfügbar. Anthropic benannte das Claude Code SDK in Claude Agent SDK um, als deutlich wurde, dass damit weit mehr als nur Programmierwerkzeuge entwickelt wurden.

TLDR

  • Python: pip install claude-agent-sdk; TypeScript: npm install @anthropic-ai/claude-agent-sdk.
  • Sie erhalten den vollständigen Agenten — Dateiwerkzeuge, bash, Subagenten, MCP — programmgesteuert und mit Berechtigungs-Callbacks.
  • Das SDK liest ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY wie die CLI, sodass die Gateway-Abrechnung greift.

Zwei Möglichkeiten, Claude Code zu automatisieren

Der schlanke Weg ist der Print-Modus der CLI — claude -p aus jeder Sprache, mit JSON-Ausgabe. Der umfassende Weg führt über das Agent SDK, das die Schleife, den Werkzeugsatz, Hooks und Berechtigungen als Objekte bereitstellt, die Sie steuern.

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

Ausführung über das Gateway

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

Das SDK startet dieselbe Claude Code-Laufzeitumgebung, daher benötigt es lediglich die Umgebungsvariablen. Bei lange laufenden Agenten ist die Preisgestaltung des Gateways besonders wichtig: Eine autonome Schleife kann Hunderte Aufrufe pro Stunde ausführen, und ein Pauschaltarif macht aus einer Kostenschätzung einen festen Betrag.

Was das SDK zusätzlich zum Print-Modus bietet

  • Berechtigungs-Callbacks — genehmigen oder verweigern Sie jeden Werkzeugaufruf aus Ihrem eigenen Code heraus.
  • Eigene Werkzeuge über prozessinterne MCP-Server, damit der Agent Ihre Funktionen aufrufen kann.
  • Hooks für Werkzeugereignisse, den Sitzungslebenszyklus und Fehler.
  • Subagenten und strukturierte Ausgabe, ohne externe Shell-Aufrufe und das Parsen von Text.

Zuerst kostenlos ausprobieren

Neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code CLAUDECODE — genug für einen Abend mit Claude Code auf Sonnet — danach Guthaben zum 7.69231-Fachen des Nennwerts.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Konto mit dem Code CLAUDECODE erstellen

Häufig gestellte Fragen

Ist das Claude Code SDK dasselbe wie das Anthropic SDK?

Nein. Das Anthropic SDK ruft die Messages API direkt auf. Das Claude Agent SDK (ehemals Claude Code SDK) führt darauf aufbauend den gesamten Agenten aus — Werkzeuge, Dateien, bash und Subagenten.

Welche Sprachen unterstützt das Agent SDK?

Offiziell Python und TypeScript; jede andere Sprache kann den Print-Modus der CLI mit JSON-Ausgabe ansteuern.

Funktioniert das SDK mit einer eigenen Basis-URL?

Ja. Es übernimmt ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY aus der Umgebung, genau wie die CLI.

Claude Code über das Gateway nutzen

Dieselben Modelle, zwei Umgebungsvariablen, Guthaben zum 7.69231-Fachen des Nennwerts — oder ein unbegrenzter Pauschaltarif. Neue Konten: $5 kostenloses API-Guthaben mit dem Code CLAUDECODE.

API-Schlüssel erhalten Unbegrenzte Tarife ansehen

AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.

Weitere Leitfäden zu Claude Code

Claude Code: der vollständige LeitfadenSo installieren Sie Claude CodeClaude Code CLI-Dokumentation: Befehle und FlagsPreise und Limits von Claude Code erklärtSkills und Plugins für Claude CodeClaude Code in GitHub: die App, die Action und @claudeHat Claude Code eine Weboberfläche? Web, Desktop und IDE erklärtWelches Modell Claude Code verwendet und wie Sie es ändernFehler in Claude Code und wie Sie sie behebenIst Claude Code Open Source?Claude Code Tutorial: Ihre erste echte SitzungClaude für Studierende: Claude Code, die API und was Bildungsangebote Ihnen tatsächlich bietenSo nutzen Sie Claude Code für die QA-AutomatisierungClaude Code im Vergleich mit Cursor: welches Werkzeug wann — und wie Sie beide nutzenClaude Code vs. Codex vs. OpenCode: Terminal-Agenten im VergleichClaude Code-Subagenten: Funktionsweise, Definition und AgententeamsClaude Code-Hooks: deterministische Kontrolle über die Aktionen des AgentenClaude Code MCP: Server verbinden, Geltungsbereiche, Remote-MCP und PraxisbeispieleDas Claude Code-Ökosystem: Router, Frameworks, Plugins und die Listen, die sie erfassenClaude Code in VS Code: die Erweiterung, die Nutzung im Terminal und die FehlerOpenRouter in Claude Code verwenden (und wann Sie darauf verzichten sollten)Claude-Fehler zum Ratenlimit: Was „API error: rate limit reached“ bedeutet und wie Sie ihn behebenClaude Code verwenden: von der Installation bis zur täglichen Nutzung