Eigene Agenten mit dem Claude Agent SDK bauen

Das Claude Agent SDK gibt dir Claude Codes Agent-Loop als Bibliothek – für eigene Programme statt der fertigen CLI.

Was das SDK ist

Das Claude Agent SDK ist eine Bibliothek für Python und TypeScript. Sie gibt dir denselben Agent-Loop, dieselben eingebauten Tools und dasselbe Kontext-Management, die auch Claude Code antreiben – aber programmierbar in deinem eigenen Code statt im Terminal.

Der Agent-Loop ist geschenkt

Normalerweise musst du bei einem LLM selbst eine Schleife bauen: Anfrage schicken, prüfen ob das Modell ein Tool nutzen will, das Tool ausführen, Ergebnis zurückschicken, wiederholen. Mit dem SDK übernimmt Claude das: Du rufst query() mit einem Prompt auf, und die Antwort kommt als Strom von Nachrichten – Gedanken, Tool-Aufrufe, Tool-Ergebnisse – bis die Aufgabe fertig ist.

Tools definieren

Eingebaute Tools wie Read, Write, Edit, Bash, Glob, Grep und WebSearch funktionieren sofort, ohne dass du sie selbst implementierst. Über allowed_tools legst du fest, was der Agent nutzen darf; über permission_mode steuerst du, wie viel Freigabe nötig ist. Zusätzlich lassen sich eigene MCP-Server anbinden, wenn der Agent externe Systeme braucht.

SDK oder fertiges CLI?

Für interaktive Entwicklung und einmalige Aufgaben reicht die Claude-Code-CLI. Für CI/CD-Pipelines, eigene Anwendungen und Produktions-Automatisierung ist das SDK gedacht – dieselben Fähigkeiten, aber eingebettet in dein eigenes Programm statt im Terminal.

BEISPIEL

Prompt in eigenem Code: `query(prompt="Lies README.md und fasse die drei wichtigsten Punkte zusammen", options=ClaudeAgentOptions(allowed_tools=["Read"]))` – der Agent liest die Datei selbst und antwortet als Stream von Nachrichten.

🛠️ ÜBUNG — MACH DAS BEI DIR

Baue mit dem Claude Agent SDK (Python oder TypeScript) einen kleinen Agenten, der eine Datei mit absichtlichen Bugs liest und repariert.

Installiere das SDK (pip install claude-agent-sdk oder npm install @anthropic-ai/claude-agent-sdk) und setze deinen ANTHROPIC_API_KEY.
Schreibe eine kleine Datei mit einem offensichtlichen Bug (z. B. Division durch Null) und rufe query() mit allowed_tools=["Read","Edit"] auf.
Lies den Nachrichten-Stream mit und beobachte, wie der Agent liest, denkt und die Datei ändert – ohne dass du die Tool-Schleife selbst programmiert hast.

✅ SELBST-CHECK

☐ Hast du irgendwo selbst eine Schleife für Tool-Aufrufe geschrieben – oder hat das SDK das übernommen?
☐ Was passiert, wenn du permission_mode auf "plan" statt "acceptEdits" setzt?
☐ Wann würdest du für dieselbe Aufgabe die Claude-Code-CLI statt des SDK nehmen?

KURZ-QUIZ

Was übernimmt das Claude Agent SDK automatisch, das du bei einer selbstgebauten Lösung über die reine API sonst selbst programmieren müsstest?