Agent SDK Übersicht

Installation

npm install @anthropic-ai/claude-agent-sdk

pip install claude-agent-sdk

SDK-Optionen

Das Claude Agent SDK ist in mehreren Formen verfügbar, um verschiedene Anwendungsfälle zu unterstützen:

• TypeScript SDK - Für Node.js und Web-Anwendungen
• Python SDK - Für Python-Anwendungen und Data Science
• Streaming vs. Single Mode - Verständnis von Eingabemodi und Best Practices

Warum das Claude Agent SDK verwenden?

Das Claude Agent SDK basiert auf dem Agent-Harness, der Claude Code antreibt, und bietet alle Bausteine, die Sie benötigen, um produktionsreife Agenten zu erstellen.

Nutzen Sie die Arbeiten, die wir bei Claude Code geleistet haben, einschließlich:

• Kontextmanagement: Automatische Komprimierung und Kontextverwaltung, um sicherzustellen, dass Ihr Agent nicht aus dem Kontext läuft.
• Umfassendes Tool-Ökosystem: Dateivorgänge, Code-Ausführung, Web-Suche und MCP-Erweiterbarkeit
• Erweiterte Berechtigungen: Feinkörnige Kontrolle über Agent-Fähigkeiten
• Produktionsessentials: Integrierte Fehlerbehandlung, Sitzungsverwaltung und Überwachung
• Optimierte Claude-Integration: Automatisches Prompt-Caching und Leistungsoptimierungen

Was können Sie mit dem SDK erstellen?

Hier sind einige Beispiele für Agent-Typen, die Sie erstellen können:

Coding-Agenten:

• SRE-Agenten, die Produktionsprobleme diagnostizieren und beheben
• Security-Review-Bots, die Code auf Sicherheitslücken prüfen
• Oncall-Engineering-Assistenten, die Vorfälle triagieren
• Code-Review-Agenten, die Stil und Best Practices durchsetzen

Business-Agenten:

• Rechtsassistenten, die Verträge und Compliance überprüfen
• Finanzberater, die Berichte und Prognosen analysieren
• Kundenservice-Agenten, die technische Probleme lösen
• Content-Creation-Assistenten für Marketing-Teams

Kernkonzepte

Authentifizierung

Für die grundlegende Authentifizierung rufen Sie einen Claude API-Schlüssel aus der Claude Console ab und setzen Sie die Umgebungsvariable ANTHROPIC_API_KEY.

Das SDK unterstützt auch die 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

Detaillierte Konfigurationsanweisungen für Drittanbieter finden Sie in der Dokumentation zu Amazon Bedrock und Google Vertex AI.

Vollständige Claude Code-Funktionsunterstützung

Das SDK bietet Zugriff auf alle Standardfunktionen, die in Claude Code verfügbar sind, und nutzt die gleiche dateiystembasierte Konfiguration:

• Subagenten: Starten Sie spezialisierte Agenten, die als Markdown-Dateien in ./.claude/agents/ gespeichert sind
• Agent-Fähigkeiten: Erweitern Sie Claude mit spezialisierten Fähigkeiten, die als SKILL.md-Dateien in ./.claude/skills/ gespeichert sind
• Hooks: Führen Sie benutzerdefinierte Befehle aus, die in ./.claude/settings.json konfiguriert sind und auf Tool-Ereignisse reagieren
• Slash-Befehle: Verwenden Sie benutzerdefinierte Befehle, die als Markdown-Dateien in ./.claude/commands/ definiert sind
• Speicher (CLAUDE.md): Verwalten Sie Projektkontexte durch CLAUDE.md- oder .claude/CLAUDE.md-Dateien in Ihrem Projektverzeichnis oder ~/.claude/CLAUDE.md für Anweisungen auf Benutzerebene. Um diese Dateien zu laden, müssen Sie explizit settingSources: ['project'] (TypeScript) oder setting_sources=["project"] (Python) in Ihren Optionen setzen. Siehe Systemanforderungen ändern für Details.

Diese Funktionen funktionieren identisch mit ihren Claude Code-Gegenstücken, indem sie von den gleichen Dateisystemstandorten lesen.

Systemaufforderungen

Systemaufforderungen definieren die Rolle, das Fachwissen und das Verhalten Ihres Agenten. Hier geben Sie an, welche Art von Agent Sie erstellen.

Tool-Berechtigungen

Kontrollieren Sie, welche Tools Ihr Agent mit feinkörnigen Berechtigungen verwenden kann:

• allowedTools - Erlauben Sie explizit bestimmte Tools
• disallowedTools - Blockieren Sie bestimmte Tools
• permissionMode - Legen Sie die Gesamtberechtigungsstrategie fest

Model Context Protocol (MCP)

Erweitern Sie Ihre Agenten mit benutzerdefinierten Tools und Integrationen über MCP-Server. Dies ermöglicht es Ihnen, sich mit Datenbanken, APIs und anderen externen Diensten zu verbinden.

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

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

Verwandte Ressourcen

• CLI-Referenz - Vollständige CLI-Dokumentation
• GitHub Actions-Integration - Automatisieren Sie Ihren GitHub-Workflow
• MCP-Dokumentation - Erweitern Sie Claude mit benutzerdefinierten Tools
• Häufige Workflows - Schritt-für-Schritt-Anleitungen
• Fehlerbehebung - Häufige Probleme und Lösungen