Headless-Modus & das Agent SDK
Claude Code ist nicht nur interaktiv. Du kannst es headless (nicht-interaktiv, skriptbar) ausführen, und du kannst deine eigenen Agenten auf demselben zugrunde liegenden Harness mit dem Agent SDK bauen.
Headless-Modus
Führe eine einzelne Eingabeaufforderung nicht-interaktiv aus und erfasse die Ausgabe — perfekt für Skripte, Pre-Commit-Hooks und CI:
claude -p "Review the staged diff and list any bugs as a Markdown checklist"
Leite Eingabe hinein, hol ein Ergebnis heraus. Kombiniere es mit auf eine sichere, nicht-interaktive Haltung gesetzten Berechtigungen, damit es nie auf eine Freigabe wartend hängen bleibt — und sperre es ab, damit ein automatisierter Lauf keine Geheimnisse anfassen kann (siehe Autonome Läufe absichern).
Ein klassischer Anwendungsfall: ein CI-Job, der Claude jeden Pull Request prüfen lässt — siehe den PR-Review-Walkthrough.
Das Agent SDK
Das Claude Agent SDK (Python und TypeScript) lässt dich produktive Agenten auf derselben Schleife bauen, die Claude Code antreibt — Tool-Nutzung, Datei-/Shell-Zugriff, Berechtigungen, Kontextverwaltung — aber verdrahtet in deine Anwendung.
Greife danach, wenn du einem einzelnen API-Aufruf oder einer selbstgebauten Schleife entwachsen bist und eine vollausgestattete Agenten-Laufzeit willst. Für das Spektrum der Optionen — einzelner Aufruf → Workflow → eigener Agent → managed — siehe Agenten auf der API bauen.
Headless/SDK vs. interaktiv
| Modus | Wofür |
|---|---|
| Interaktives Claude Code | Tägliche Entwicklung mit einem Menschen in der Schleife |
Headless (claude -p) | Skripte, Pre-Commit, CI-Einzelläufe |
| Agent SDK | Produktive Agenten, eingebettet in deine Software |