Geplante Tasks und Headless
Sobald du Claude vertraust, eine Aufgabe zu erledigen, ist der nächste Schritt, sie nicht mehr manuell auszuführen. Wenn es derselbe Prompt bei einem wiederkehrenden Auslöser ist, solltest du nicht jedes Mal selbst dasitzen und ihn anstoßen müssen. Diese Lektion behandelt zwei Möglichkeiten, diese Arbeit abzugeben: geplante Cloud-Tasks (früher Routinen genannt), bei denen du nichts baust, und den Headless-Modus, bei dem du die volle Kontrolle über deine eigenen Skripte hast.
Stell es dir als Spektrum vor. Am einen Ende hast du geplante Cloud-Tasks, die auf Anthropics verwalteter Infrastruktur laufen. Am anderen Ende hast du den Headless-Modus und das Agent SDK, die Claude Code aus deinem eigenen Code heraus ausführen. Fangen wir mit dem Ende an, an dem du am wenigsten bauen musst.
Geplante Tasks: ein gespeicherter Prompt, der in der Cloud ausgeführt wird
Ein geplanter Cloud-Task ist der direkteste Weg, wiederkehrende Arbeit zu automatisieren. Es gibt kein Skript und keinen Server. Er bündelt drei Dinge: einen Prompt, das Repository, mit dem er arbeitet, und alle benötigten Konnektoren. Dann führt er dieses Bündel in der Cloud aus, wann immer es ausgelöst wird.
Der entscheidende Punkt ist, dass die Infrastruktur Anthropic gehört. Es gibt keine eigene Maschine, die über Nacht laufen muss, und keine Workflow-Datei, die du pflegen musst. Du beschreibst den Job einmal, und er läuft einfach.
Ein geplanter Task braucht keinen Zeitplan. Er kann durch verschiedene Arten von Auslösern ausgelöst werden:
- Einen Cron-Zeitplan, zum Beispiel jeden Morgen um 9 Uhr.
- Einen HTTP-POST an seinen API-Endpunkt, sodass dein eigener Code ihn anstoßen kann.
- Ein GitHub-Ereignis, wie das Eintreffen eines neuen Pull Requests.
Alles, was derselbe Prompt bei einem wiederkehrenden Auslöser ist, eignet sich gut dafür. Ein morgendliches Dependency-Audit. Ein PR-Triager, der ausgelöst wird, wenn ein neuer Pull Request eintrifft. Ein täglicher Scan deiner Sentry-Tickets, um herauszufinden, was am dringendsten ist.
Hier ist das Gedankenmodell dafür, was ein geplanter Task zusammenbindet: ein Prompt, das Repo, Konnektoren und ein Auslöser.
Zwei Wege, einen zu erstellen
Du kannst einen geplanten Task im Web unter claude.ai/code/routines erstellen. Du gibst ihm einen Namen, schreibst die Anweisungen, die beschreiben, was Claude in jeder Sitzung tun soll, wählst ein Repository aus und legst einen Auslöser fest.
Du kannst auch einen erstellen, ohne dein Terminal in Claude Code zu verlassen. Führe einfach den Befehl /schedule aus und beschreibe in normaler Sprache, was du möchtest, zum Beispiel:
/schedule daily dependency audit at 9amGleiche Idee, egal welcher Einstiegspunkt. Wähle, was zu deinem Ablauf passt.
Drei Dinge, die du wissen solltest, bevor du dich auf geplante Cloud-Tasks verlässt
Bevor du dich bei etwas Wichtigem auf geplante Cloud-Tasks verlässt, behalte diese drei Einschränkungen im Kopf.
- Geplante Cloud-Tasks sind eine Research Preview. Verhalten und Limits werden sich weiter verändern, also wundere dich nicht, wenn sich Dinge ändern.
- Ein wiederkehrender Zeitplan läuft höchstens stündlich. Wenn du etwas Häufigeres brauchst, ist ein geplanter Cloud-Task nicht das richtige Werkzeug.
- Läufe starten von einem frischen Klon deines Standard-Branches und pushen zu einem
claude/-Branch, sofern dein Prompt nicht einen anderen Branch nennt. Wenn ein GitHub-Pull-Request-Ereignis den Lauf auslöst, startet das Repository des Pull Requests stattdessen vom Head-Commit des Pull Requests, sofern es das erste Repository im geplanten Task ist. Um zu steuern, zu welchen Branches ein Lauf pushen darf, verwende Branch-Protection-Regeln oder Rulesets auf GitHub. GitHub wendet sie auf den von dir verbundenen GitHub-Zugang an, sodass eine Regel, die dein Zugang umgehen kann, den Push nicht blockiert.
Headless-Modus: wenn du deine eigene Umgebung brauchst
Geplante Cloud-Tasks sind großartig, wenn die Arbeit auf Anthropics Infrastruktur laufen kann. Aber manchmal braucht der Job deine Umgebung oder Logik, die um den Lauf herum gewickelt ist. Dann wechselst du in den Headless-Modus, den die Dokumentation jetzt als nicht-interaktiven Modus bezeichnet.
Der Kern des Headless-Modus ist die -p-Flag (kurz für --print). Sie führt Claude Code als Einmalbefehl ohne interaktive Oberfläche aus. Sie liest die Standardeingabe und schreibt die Standardausgabe, sodass sie sich wie jedes andere Shell-Tool verketten lässt:
claude -p "summarize the changes in this diff"Eine Sache, die man wissen sollte: Für sich genommen lädt -p denselben Kontext wie eine interaktive Sitzung, einschließlich Hooks, Skills, Plugins, MCP-Servern und der CLAUDE.md-Datei. Um das alles zu überspringen, füge --bare hinzu, das unten behandelt wird.
Strukturierte Ausgabe zurückbekommen
Da der Headless-Modus sich wie jedes Shell-Tool verketten lässt, möchtest du oft strukturierte Daten statt Fließtext zurück. Du kannst ein JSON-Schema mit dem JSON-Ausgabeformat kombinieren, und Claude wird seine Ausgabe an dein Schema anpassen.
Das Objekt, das deinem Schema entspricht, landet im Feld structured_output der JSON-Antwort. Du kannst es also mit einem jq-Befehl herausziehen und in eine Datenbank oder ein anderes Skript leiten:
claude -p "Extract the exported function names from src/core/style.js" \
--output-format json \
--json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}' \
| jq '.structured_output.functions'Das ergibt ein sauberes Array, das du an alles Folgende weitergeben kannst.
Mehrstufige Automatisierung mit Sitzungen
Für Arbeit, die über mehrere Schritte hinweg geschieht, musst du nicht alles in einen Befehl quetschen. Erfasse die Sitzungs-ID aus der JSON-Ausgabe und setze sie später fort:
claude --resume "$(jq -r .session_id /tmp/plan.json)"Ein Skript stößt die Arbeit an. Ein anderes setzt sie später mit vollem Kontext fort. Das ist praktisch, wenn der erste Durchlauf einen Plan erstellt und ein zweiter Durchlauf ihn umsetzt.
Konsistente Läufe für CI
Wenn CI auf jeder Maschine dasselbe Setup braucht, gibt es einen Modus, der dafür gebaut ist.
Die Flag --bare überspringt die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern und der CLAUDE.md-Datei. Du bekommst Claude mit den Tools Bash, Datei lesen und Datei bearbeiten, plus allem, was du mit einer Flag wie --settings oder --mcp-config übergibst. So startet jede Maschine vom selben Setup aus, und der Start ist schneller. Der Bare-Modus verwendet nicht deinen Abonnement-Login, also setze zuerst ANTHROPIC_API_KEY.
Das Agent SDK: Claude Code in deiner eigenen App
Der letzte Schritt auf dem Spektrum ist das Agent SDK. Das gibt dir eine Bibliothek, die Claude Code in deine eigenen TypeScript- oder Python-Anwendungen einbettet.
Beide Sprachen stellen eine query-Funktion und dieselben Grundbausteine wie die CLI bereit. Du übergibst einen Prompt plus Optionen, wie zum Beispiel:
allowedTools, um zu steuern, was Claude tun kann,- einen System-Prompt,
- und einen Berechtigungsmodus.
Dann iterierst du über die Nachrichten, die Claude zurückstreamt, und behandelst sie, wie es deine App braucht. Es ist dieselbe Engine wie die CLI, nur aus deinem Produkt heraus aufrufbar.
Welches solltest du wählen?
Hier ist der schnelle Entscheidungsleitfaden:
- Geplante Cloud-Tasks sind die Standardwahl für wiederkehrende Arbeit. Sie laufen auf Anthropics Infrastruktur, ohne dass du etwas hosten musst.
- Headless-Modus mit
-pist für den Fall, dass der Job deine Pipeline braucht und du Daten durch ein Skript leiten möchtest. --bareist für den Fall, dass CI auf jeder Maschine dasselbe Setup braucht.- Das Agent SDK ist für den Fall, dass die Arbeit in dein eigenes Produkt gehört.
Beginne mit geplanten Cloud-Tasks. Gehe das Spektrum nur dann weiter hinunter, wenn der Job die zusätzliche Kontrolle braucht.