Claude Agent SDK
Level 3 | 40 Minuten
Eigene autonome AI-Agents mit dem Agent SDK bauen und deployen
Lernziele
- Verstehen was das Claude Agent SDK ist und wie es sich von Claude Code unterscheidet
- Einen eigenen Agent mit dem SDK erstellen
- Subagents, Tools und MCP im SDK nutzen
- Agents in Produktion deployen
- IDE-Integrationen (Xcode, VS Code) verstehen
Was ist das Claude Agent SDK?
Das Claude Agent SDK ist die Programmier-Schnittstelle mit der du eigene autonome KI-Agents als eigenständige Programme bauen kannst — unabhängig von der Claude Code CLI. Stell dir vor, Claude Code ist ein fertiges Auto das du fährst. Das Agent SDK ist der Bausatz mit dem du dein eigenes Auto konstruierst. Mit dem SDK kannst du Agents bauen die in eigenen Anwendungen laufen: Eine Desktop-App die automatisch E-Mails beantwortet, ein Backend-Service der Kundenanfragen analysiert, ein CLI-Tool das deinen speziellen Workflow automatisiert, oder ein Slack-Bot der Code-Reviews durchführt. Der Unterschied zu Claude Code: Claude Code ist ein FERTIGES Tool das du konfigurierst und nutzt. Das Agent SDK ist ein FRAMEWORK mit dem du dein eigenes Tool baust. Claude Code nutzt intern das Agent SDK — du kannst damit also Dinge bauen die genauso mächtig sind wie Claude Code selbst, aber für deinen spezifischen Anwendungsfall maßgeschneidert. Das SDK ist verfügbar für TypeScript/JavaScript und Python. Es bietet: Model-Kommunikation (Messages an Claude senden und Antworten empfangen), Tool-Definition (eigene Funktionen die der Agent aufrufen kann), Subagent-Management (weitere Agents spawnen und koordinieren), MCP-Integration (bestehende MCP Server einbinden), und Context-Management (Kontext kontrollieren und optimieren). Typische Einsatzszenarien: Automatisierte CI/CD-Agents die über einfache Code-Reviews hinausgehen, interne Unternehmens-Tools die mit proprietären Daten arbeiten, Produkt-Features die KI-Funktionalität in eure App einbetten, und spezialisierte Entwickler-Tools für euer Team. Das SDK wird aktiv von Anthropic weiterentwickelt und ist bereits Production-ready. Große Unternehmen nutzen es für interne Tooling, und die Open-Source-Community baut immer mehr Projekte darauf auf.
CLAUDE CODE vs. AGENT SDK
━━━━━━━━━━━━━━━━━━━━━━━━
CLAUDE CODE (das Produkt):
├── Fertiges CLI-Tool
├── Interaktiv im Terminal
├── Eingebaute Tools (Read, Write, Bash, etc.)
├── MCP Server Support
├── Slash Commands, Skills, Hooks
└── Für Entwickler zum direkten Nutzen
AGENT SDK (die Engine):
├── Python/TypeScript Library
├── Programmatisch steuerbar
├── Eigene Tools definierbar
├── MCP Server integrierbar
├── Subagents und Delegation
├── Streaming Responses
├── Multi-Turn Conversations
└── Für Entwickler zum Bauen eigener Produkte
ANWENDUNGSFÄLLE FÜR DAS SDK:
→ Eigener Code Review Bot für dein Team
→ Automatisierte Bug-Triage in GitHub Issues
→ Custom Documentation Generator
→ CI/CD Agents die Features implementieren
→ Slack Bot der Code-Fragen beantwortet
→ IDE-Plugin mit eigener AI-LogikQuickstart: Erster Agent in 5 Minuten
Das Agent SDK ermöglicht es dir, eigene autonome AI-Agents als eigenständige Programme zu bauen. In 5 Minuten hast du deinen ersten Agent: Ein Programm das Claude's Intelligenz nutzt, eigene Tools hat und Aufgaben selbstständig erledigt — unabhängig von der Claude Code CLI. Schritt 1 — Projekt erstellen: 'npm init -y && npm install @anthropic-ai/agent-sdk'. Das installiert das SDK und seine Dependencies. Du brauchst Node.js 18+ und einen ANTHROPIC_API_KEY. Schritt 2 — Agent schreiben: Erstelle eine Datei agent.ts. Importiere den Agent aus dem SDK, definiere einen System-Prompt ('Du bist ein Code-Analyse-Agent'), und starte den Agent mit einer Aufgabe. 15 Zeilen Code reichen für einen funktionierenden Agent. Schritt 3 — Tools hinzufügen: Der Agent braucht Tools um mit der Welt zu interagieren. Definiere ein Tool als TypeScript-Funktion: Name, Beschreibung, Parameter-Schema und Handler-Funktion. Zum Beispiel ein 'read_file' Tool das eine Datei liest und den Inhalt zurückgibt. Schritt 4 — Ausführen: 'npx tsx agent.ts'. Der Agent startet, bekommt seine Aufgabe, nutzt seine Tools und gibt das Ergebnis aus. Du siehst jeden Schritt den der Agent macht. Der Unterschied zu Slash Commands und Skills: Diese erweitern Claude Code (das bestehende Tool). Das Agent SDK lässt dich ein EIGENES Tool bauen — mit eigener Logik, eigenen Tools und eigener Oberfläche. Du bist nicht mehr auf die Claude Code CLI beschränkt. Typische Einsatzszenarien: Ein Slack-Bot der Code-Fragen beantwortet. Ein CLI-Tool das automatisch Changelogs generiert. Ein Backend-Service der Kundenanfragen analysiert. Eine Desktop-App die lokale Dateien organisiert. Das SDK ist Production-ready und wird von Anthropic aktiv weiterentwickelt. Große Unternehmen nutzen es bereits für interne Tooling.
# Installation (Python):
pip install claude-agent-sdk
# Installation (TypeScript/Node):
npm install @anthropic-ai/agent-sdk# Minimaler Agent in Python
from claude_agent_sdk import Agent, Tool
# 1. Agent erstellen
agent = Agent(
model="claude-sonnet-4.5",
system_prompt="Du bist ein Code-Review Agent. "
"Analysiere Code auf Bugs und Best Practices.",
max_turns=10,
)
# 2. Agent ausführen
result = agent.run(
prompt="Reviewe diese Python-Datei: @src/main.py",
tools=["read", "write", "bash"],
working_directory="./my-project",
)
# 3. Ergebnis verarbeiten
print(result.output)
print(f"Kosten: " + str(result.cost.total_usd))
print(f"Turns: " + str(result.turns_used))// Minimaler Agent in TypeScript
import { Agent } from '@anthropic-ai/agent-sdk';
const agent = new Agent({
model: 'claude-sonnet-4.5',
systemPrompt: 'Du bist ein hilfreicher Coding-Agent. '
+ 'Du kannst Dateien lesen, bearbeiten und Befehle ausführen.',
maxTurns: 10,
});
const result = await agent.run({
prompt: 'Erstelle Unit Tests für src/utils.ts',
tools: ['read', 'write', 'bash'],
workingDirectory: './my-project',
});
console.log(result.output);
console.log('Kosten: