Agent SDK

Agent SDK Übersicht

Erstellen Sie produktive KI-Agenten mit Claude Code als Bibliothek

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, die Agent-Schleife und das Kontextmanagement, 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 die Schnellstartanleitung ein oder erkunden Sie echte Agenten, die mit dem SDK erstellt wurden:

Schnellstart

Erstellen Sie einen Bug-Fix-Agenten in wenigen Minuten

Beispielagenten

E-Mail-Assistent, Forschungsagent und mehr

Erste Schritte

Installieren Sie das SDK
Legen Sie Ihren API-Schlüssel fest
Rufen Sie einen API-Schlüssel aus der Konsole ab und legen Sie ihn als Umgebungsvariable fest:
export ANTHROPIC_API_KEY=your-api-key
Das SDK unterstützt auch Authentifizierung über Drittanbieter-API-Provider:
- 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 Azure: Setzen Sie die Umgebungsvariable CLAUDE_CODE_USE_FOUNDRY=1 und konfigurieren Sie Azure-Anmeldedaten
Weitere Informationen finden Sie in den Einrichtungsleitfäden für Bedrock, Vertex AI oder Azure AI Foundry.
Sofern nicht vorher genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Anmeldungen oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Bitte 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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

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

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 Fähigkeiten, die in Markdown definiert sind	`.claude/skills/SKILL.md`
Schrägstrich-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 die `plugins`-Option

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:

Changelog

Sehen Sie sich das vollständige Changelog 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 Agentennamen 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. Bei Fragen zur Branding-Compliance kontaktieren Sie unser Vertriebsteam.

Lizenz und Bedingungen

Die Verwendung des Claude Agent SDK unterliegt den Anthropic Commercial Terms of Service, auch wenn Sie es verwenden, um Produkte und Dienste bereitzustellen, die Sie Ihren eigenen Kunden und Endbenutzern zur Verfügung stellen, außer soweit eine bestimmte 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 wenigen Minuten findet und behebt

Beispielagenten

E-Mail-Assistent, Forschungsagent und mehr

TypeScript SDK

Vollständige TypeScript-API-Referenz und Beispiele

Python SDK

Vollständige Python-API-Referenz und Beispiele

Was this page helpful?

Agent SDK

Agent SDK Übersicht

Erstellen Sie produktive KI-Agenten mit Claude Code als Bibliothek

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

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())

Schnellstart

Erstellen Sie einen Bug-Fix-Agenten in wenigen Minuten

Beispielagenten

E-Mail-Assistent, Forschungsagent und mehr

Erste Schritte

Installieren Sie das SDK
Legen Sie Ihren API-Schlüssel fest
Rufen Sie einen API-Schlüssel aus der Konsole ab und legen Sie ihn als Umgebungsvariable fest:
export ANTHROPIC_API_KEY=your-api-key
Das SDK unterstützt auch Authentifizierung über Drittanbieter-API-Provider:
- 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 Azure: Setzen Sie die Umgebungsvariable CLAUDE_CODE_USE_FOUNDRY=1 und konfigurieren Sie Azure-Anmeldedaten
Weitere Informationen finden Sie in den Einrichtungsleitfäden für Bedrock, Vertex AI oder Azure AI Foundry.
Sofern nicht vorher genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Anmeldungen oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Bitte 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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

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

Funktionen

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

Claude Code-Funktionen

Funktion	Beschreibung	Ort
Skills	Spezialisierte Fähigkeiten, die in Markdown definiert sind	`.claude/skills/SKILL.md`
Schrägstrich-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 die `plugins`-Option

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:

Changelog

Sehen Sie sich das vollständige Changelog 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 Agentennamen 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. Bei Fragen zur Branding-Compliance kontaktieren Sie unser Vertriebsteam.

Lizenz und Bedingungen

Nächste Schritte

Schnellstart

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

Beispielagenten

E-Mail-Assistent, Forschungsagent und mehr

TypeScript SDK

Vollständige TypeScript-API-Referenz und Beispiele

Python SDK

Vollständige Python-API-Referenz und Beispiele

Was this page helpful?