Agent SDK Übersicht

Das Claude Code SDK wurde in das Claude Agent SDK umbenannt. Wenn Sie vom alten SDK migrieren, siehe den Migrationsleitfaden.

Erstellen Sie KI-Agenten, die autonom Dateien lesen, Befehle ausführen, das Web durchsuchen, Code bearbeiten und vieles mehr. Das Agent SDK bietet Ihnen die gleichen Tools, den Agent-Loop und die Kontextverwaltung, die Claude Code antreiben, programmierbar in Python und TypeScript.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Das Agent SDK enthält integrierte Tools zum Lesen von Dateien, Ausführen von Befehlen und Bearbeiten von Code, sodass Ihr Agent sofort arbeiten kann, ohne dass Sie die Tool-Ausführung implementieren müssen. Tauchen Sie in den Schnellstart ein oder erkunden Sie echte Agenten, die mit dem SDK erstellt wurden:

Schnellstart

Erstellen Sie einen Bug-Fix-Agenten in Minuten

Beispielagenten

Funktionen

Alles, was Claude Code leistungsstark macht, ist im SDK verfügbar:

Claude Code Funktionen

Das SDK unterstützt auch die dateisystembasierte Konfiguration von Claude Code. Um diese Funktionen zu verwenden, setzen Sie setting_sources=["project"] (Python) oder settingSources: ['project'] (TypeScript) in Ihren Optionen.

Funktion	Beschreibung	Ort
Skills	Spezialisierte Funktionen, die in Markdown definiert sind	`.claude/skills/SKILL.md`
Slash-Befehle	Benutzerdefinierte Befehle für häufige Aufgaben	`.claude/commands/*.md`
Speicher	Projektkontext und Anweisungen	`CLAUDE.md` oder `.claude/CLAUDE.md`
Plugins	Erweitern Sie mit benutzerdefinierten Befehlen, Agenten und MCP-Servern	Programmgesteuert über `plugins`-Option

Erste Schritte

Bereit zum Bauen? Folgen Sie dem Schnellstart, um einen Agenten zu erstellen, der Bugs in Minuten findet und behebt.

Vergleichen Sie das Agent SDK mit anderen Claude-Tools

Die Claude-Plattform bietet mehrere Möglichkeiten, mit Claude zu bauen. So passt das Agent SDK ein:

Ä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

Branding-Richtlinien

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 Agent-Namen 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. Für Fragen zur Branding-Compliance kontaktieren Sie unser Vertriebsteam.

Lizenz und Bedingungen

Die Verwendung des Claude Agent SDK unterliegt den Geschäftsbedingungen von Anthropic, auch wenn Sie es verwenden, um Produkte und Dienstleistungen bereitzustellen, die Sie Ihren eigenen Kunden und Endbenutzern zur Verfügung stellen, außer insofern ein bestimmter Komponente oder Abhängigkeit unter einer anderen Lizenz abgedeckt ist, wie in der LICENSE-Datei dieser Komponente angegeben.

Nächste Schritte

Schnellstart

Erstellen Sie einen Agenten, der Bugs in Minuten findet und behebt

Beispielagenten

Installieren Sie Claude Code
Das SDK verwendet Claude Code als seine Laufzeit:
Siehe Claude Code Setup für Windows und andere Optionen.
Installieren Sie das SDK
Legen Sie Ihren API-Schlüssel fest
export ANTHROPIC_API_KEY=your-api-key
Holen Sie sich Ihren Schlüssel von der Konsole.
Das SDK unterstützt auch Authentifizierung über Drittanbieter-API-Anbieter:
- Amazon Bedrock: Setzen Sie die Umgebungsvariable CLAUDE_CODE_USE_BEDROCK=1 und konfigurieren Sie AWS-Anmeldedaten
- Google Vertex AI: Setzen Sie die Umgebungsvariable CLAUDE_CODE_USE_VERTEX=1 und konfigurieren Sie Google Cloud-Anmeldedaten
- Microsoft Foundry: Setzen Sie die Umgebungsvariable CLAUDE_CODE_USE_FOUNDRY=1 und konfigurieren Sie Azure-Anmeldedaten
Sofern nicht vorher genehmigt, erlauben wir Drittanbieter-Entwicklern nicht, Claude.ai-Anmeldung oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Verwenden Sie stattdessen die in diesem Dokument beschriebenen API-Schlüssel-Authentifizierungsmethoden.

Führen Sie Ihren ersten Agenten aus

Dieses Beispiel erstellt einen Agenten, der Dateien in Ihrem aktuellen Verzeichnis mit integrierten Tools auflistet.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        print(message)

asyncio.run(main())