Claude Code headless: Claude ohne Chat in Skripten nutzen
Claude Code lässt sich mit einem einzelnen Befehl aufrufen, ohne Chat. Ideal für Skripte und Automationen.
Nicht jede Aufgabe braucht ein Gespräch. Ein Befehl rein, ein Ergebnis raus: So baust du Claude in Skripte und Automationen ein.
Worum es geht
Mit dem Schalter -p läuft Claude Code ohne Chat, nimmt eine Aufgabe entgegen, erledigt sie und gibt das Ergebnis aus. Das ist der Einstieg in das Agent SDK, das dieselben Werkzeuge und dieselbe Arbeitsschleife wie Claude Code bietet, als Kommandozeile für Skripte und CI oder als Paket für Python und TypeScript.
Nicht jede Aufgabe braucht ein Gespräch. Ein Befehl rein, ein Ergebnis raus.
Wofür du es nutzt
Kleine Skripte
Eine Datei rein, eine Zusammenfassung raus.
Automationen
Claude als Baustein in bestehenden Abläufen.
Fest erlaubte Werkzeuge
Mit --allowedTools legst du fest, was Claude dabei darf.
So richtest du es ein
Der schnellste Weg: Prompt kopieren, in Claude Code einfügen, Enter. Claude liest die Originalquelle und fragt nach deinem OK, bevor es etwas ändert.
Richte mir den Headless-Modus in Claude Code ein, nach der offiziellen Doku: https://code.claude.com/docs/en/headless Bau mir ein kleines Skript, das eine Textdatei mit Claude in drei Stichpunkten zusammenfasst.
Noch kein Claude Code? So installierst du es →
Oder Schritt für Schritt
- Beispiel aus der Doku:
claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash" - Prompt einfügen: Claude baut dir ein eigenes kleines Skript mit Kommentaren.
- Mit einer Datei aus deinem Ordner testen.
Gut zu wissen
- Nicht jede Option aus dem Chat-Modus funktioniert im Headless-Modus. Die Doku listet die Unterschiede.