Routines in Claude Code: Was in der Cloud läuft, was auf deiner Maschine bleibt und wie du wählst
Routines, die Anthropic inzwischen scheduled tasks (geplante Aufgaben) nennt, sind der Weg von Claude Code, einen gespeicherten Prompt ohne dich auszuführen: nach Zeitplan, auf einen API-Aufruf hin oder bei einem GitHub-Ereignis, als Cloud Session auf einem frischen Klon deines Repositorys. Sie sind in der Research Preview. Claude Code hat außerdem zwei lokale Wege, Arbeit zu planen, die geplanten Aufgaben der Desktop-App und /loop, und die drei verhalten sich nicht gleich: minimales Intervall, Zugriff auf deine lokalen Dateien, Berechtigungsabfragen, was passiert, wenn der Laptop schläft. Dieser Leitfaden stellt die drei mit den Grenzen aus der Dokumentation vor und erklärt dann, warum unsere eigenen sieben nächtlichen Agenten stattdessen auf einer lokalen Maschine laufen.
Claude Code hat inzwischen drei Wege, einen Prompt auszuführen, ohne dass du ihn tippst, und ihre Namen überschneiden sich so sehr, dass man leicht durcheinanderkommt: Routines, die geplanten Aufgaben der Desktop-App und /loop. Noch verwirrender wurde es, als Anthropic Routines umbenannt hat: Die Dokumentation nennt sie jetzt cloud scheduled tasks, „formerly routines“, sodass alle drei irgendeine Art von geplanter Aufgabe sind. Die Desktop-App legt die ersten beiden sogar auf derselben Seite an. Sie unterscheiden sich in dem einen Punkt, der zählt, wenn du Arbeit automatisierst: wo der Agent läuft und was er deshalb sehen kann.
Dieser Leitfaden geht die drei mit den Grenzen durch, die in der Dokumentation stehen (geprüft am 4. Oktober 2026, aktualisiert am 20. November 2026 nach der Umbenennung; die Funktion ist weiterhin in der Research Preview, und Anthropic weist darauf hin, dass sich Verhalten, Grenzen und die API noch ändern können). Wir bleiben im Folgenden beim Wort Routine, weil es am häufigsten gesucht wird und viele Bildschirme es noch zeigen. Dann erklärt er, was wir selbst tun: Bei uns starten jeden Abend sieben Agenten, und keiner davon ist eine Routine. Die Gründe sind konkret, und sie können auf dich zutreffen oder nicht.
Was eine Routine ist
Eine Routine, die Anthropic inzwischen cloud scheduled task (geplante Cloud-Aufgabe) nennt, ist eine gespeicherte Konfiguration von Claude Code: ein Prompt, ein oder mehrere GitHub-Repositorys und ein Satz Konnektoren, einmal zusammengepackt und automatisch ausgeführt. Sie läuft auf einer von Anthropic verwalteten Cloud-Infrastruktur oder in der selbst gehosteten Umgebung deiner Organisation, wenn sie dorthin geleitet wird. Dein Laptop kann zugeklappt sein.
Jeder Run ist eine vollständige Cloud Session. Daraus folgen vier Konsequenzen, und genau die solltest du dir merken:
- Jedes Mal ein frischer Klon. Jedes Repository wird zu Beginn eines Runs geklont, vom Standard-Branch. Claude pusht seine Arbeit auf einen Branch mit dem Präfix
claude/, sofern dein Prompt nichts anderes sagt. Nichts, was auf deiner Maschine nicht committet ist, existiert für die Routine. - Keine Berechtigungsabfragen. Es gibt keine Auswahl des Berechtigungsmodus. Die Sitzung führt Shell-Befehle aus, nutzt die im Repository committeten Skills und ruft jedes Werkzeug jedes eingebundenen Konnektors auf, schreibende eingeschlossen, ohne anzuhalten und nachzufragen.
- Konnektoren, nicht deine lokalen MCP-Server. Alle Konnektoren deines claude.ai-Kontos sind standardmäßig eingebunden, und die Dokumentation rät dir, die zu entfernen, die die Routine nicht braucht. Server, die du lokal mit
claude mcp addhinzugefügt hast, leben auf deiner Maschine und stehen nicht in der Liste. Eine committete.mcp.jsonist der andere Weg hinein. - Sie handelt in deinem Namen. Routines gehören zu deinem persönlichen Konto. Commits und Pull Requests tragen deinen GitHub-Benutzer, Slack-Nachrichten und Linear-Tickets laufen über deine verknüpften Konten.
Geplante Aufgaben sind in den Plänen Pro, Max, Ultra, Team und Enterprise verfügbar. Du legst sie unter claude.ai/code/routines an, in der Desktop-App (Tab Code, dann die Seite Scheduled tasks, Cloud) oder im CLI mit /schedule.
Wo der alte Name noch auftaucht
Die Umbenennung ist noch nicht überall abgeschlossen, und die Dokumentation listet die Stellen auf, die das Wort Routine behalten. Alle meinen dieselbe Funktion:
- Die App: In manchen Konten zeigen der Eintrag in der Seitenleiste und der Seitentitel noch Routines, und der Button heißt New routine.
- Die Webadresse: claude.ai/code/routines.
- Das CLI:
/routinesist weiterhin ein Alias von/schedule, und Claudes Antworten können von einer Routine sprechen, während es eine Aufgabe einrichtet. - Die API: Der Pfad des Endpunkts
/fire, sein Beta-Header und der Blockroutine-fire-payloadbehalten den alten Namen. - Die Organisationseinstellungen: Der Schalter heißt Scheduled tasks (Was Routines) oder einfach Routines.
Wenn also dein Bildschirm Routines sagt und die Dokumentation scheduled tasks, ist nichts falsch: Es ist eine Funktion mit zwei Namen.
Die drei Trigger
Eine geplante Cloud-Aufgabe kann einen Trigger tragen oder mehrere gleichzeitig.
Zeitplan. Stündlich, täglich, werktags oder wöchentlich, in deiner lokalen Zeit, oder ein einzelner Run zu einem künftigen Zeitpunkt. Das minimale Intervall ist eine Stunde. Ein Detail aus der Dokumentation, das du kennen solltest: Ein Run, der genau zur vollen Stunde geplant ist, kann mehrere Minuten zu spät starten, also nimm 9:07 statt 9:00, wenn die Uhrzeit zählt.
API. Jede Routine bekommt ihren eigenen Endpunkt und ihr eigenes Bearer-Token, das im Web erzeugt wird (das CLI kann Tokens weder erstellen noch widerrufen). Ein POST startet eine Sitzung und gibt ihre URL zurück:
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
-H "Authorization: Bearer sk-ant-oat01-xxxxx" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod."}'
Das Feld text erreicht die Routine nicht als Anweisung. Es kommt eingewickelt in einen Block an, der es als nicht vertrauenswürdige Daten kennzeichnet, also muss der gespeicherte Prompt ausdrücklich zustimmen („untersuche die Warnung, die im Block routine-fire-payload beschrieben ist“), sonst bleibt der Text wirkungsloser Kontext. Das ist die richtige Voreinstellung: Wer das Token besitzt, kann Text schicken.
GitHub. Pull-Request-, Release- und Issue-Ereignisse, mit Filtern auf Autor, Titel, Beschreibung, Basis-Branch, Head-Branch, Labels, Entwurfsstatus und Merge-Status. Die Claude GitHub App muss auf dem Repository installiert sein. Jedes Ereignis startet seine eigene Sitzung, und Ereignisse jenseits der stündlichen Obergrenze werden verworfen.
Aus dem CLI: /schedule
/schedule legt eine geplante Cloud-Aufgabe im Gespräch an, und /routines ist weiterhin ein Alias davon.
/schedule daily PR review at 9am
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
/schedule list
/schedule update
/schedule run
Mit /schedule update setzt du einen eigenen cron-Ausdruck. Einen GitHub-Trigger aus dem CLI hinzuzufügen braucht Claude Code v2.1.225 oder neuer; API-Trigger gibt es nur im Web.
Wenn /schedule mit „Unknown command“ antwortet, liegt es meistens an der Authentifizierung: Der Befehl verlangt eine Anmeldung mit einem claude.ai-Abo. Ein ANTHROPIC_API_KEY in deiner Shell, ein apiKeyHelper in settings.json oder eine Anmeldung über Bedrock oder Vertex blendet ihn aus.
Die Grenzen, die du kennen solltest, bevor du dich darauf verlässt
Geplante Aufgaben verbrauchen die Nutzung deines Abos wie jede interaktive Sitzung. Zusätzlich hat jeder Weg, einen Run zu starten, eine stündliche Obergrenze ohne Mehrnutzung:
| Aktion | Grenze | Gezählt für |
|---|---|---|
| Geplante Runs, einmalige Runs eingeschlossen | 100 pro Stunde | Dein Konto |
| Run now, API-Aufrufe, erneutes Scharfschalten eines einmaligen Runs | 30 pro Stunde | Jede geplante Aufgabe |
| API-Aufrufe | 100 pro Stunde | Dein Konto |
Drei weitere Punkte aus der Dokumentation, die in der Praxis wehtun. Eine fehlende oder abgelaufene GitHub-Verbindung lässt die Aufgabe ihre Runs bis zu 72 Stunden lang überspringen, danach schaltet sie sich selbst ab. Ein pausiertes Abo setzt Cloud-Aufgaben auf Halt. Und ein grüner Run heißt nicht, dass die Aufgabe geklappt hat: Er heißt, dass die Sitzung gestartet und ohne Infrastrukturfehler beendet wurde.
Die zwei lokalen Optionen
Die geplanten Aufgaben der Desktop-App sind die Wahl Local auf derselben Seite. Sie laufen auf deiner Maschine, mit deinen Dateien so, wie sie sind, nicht committete Änderungen eingeschlossen, es sei denn, du setzt das Häkchen bei der Worktree-Option. Jede Aufgabe hat ihren eigenen Berechtigungsmodus. Der Haken steckt in einem Satz der Dokumentation: Die Aufgaben laufen nur, solange die Desktop-App läuft und dein Computer wach ist. Ein Run, der in den Ruhezustand fällt, wird übersprungen, und beim Aufwachen startet die App genau einen Nachhol-Run für den letzten verpassten Zeitpunkt der vergangenen sieben Tage. Der Prompt liegt in ~/.claude/scheduled-tasks/<task-name>/SKILL.md.
/loop wiederholt einen Prompt innerhalb einer offenen CLI-Sitzung: /loop 5m check the deploy. Es erbt die Berechtigungen und MCP-Server der Sitzung, fasst bis zu 50 Aufgaben, und eine wiederkehrende Aufgabe läuft nach sieben Tagen ab. Schließt du das Terminal, hört es auf. Es ist dafür gemacht, einen Build oder einen Pull Request einen Nachmittag lang im Auge zu behalten, nicht für einen nächtlichen Job.
Nebeneinander, so wie die Dokumentation es darstellt:
| Geplante Cloud-Aufgabe (Routine) | Geplante Aufgabe der Desktop-App | /loop | |
|---|---|---|---|
| Läuft auf | Der Cloud von Anthropic | Deiner Maschine | Deiner Maschine |
| Maschine muss an sein | Nein | Ja | Ja |
| Offene Sitzung nötig | Nein | Nein | Ja |
| Lokale Dateien | Nein, frischer Klon | Ja | Ja |
| Berechtigungsabfragen | Keine | Pro Aufgabe | Erbt von der Sitzung |
| Minimales Intervall | 1 Stunde | 1 Minute, wenn Claude es festlegt, 1 Stunde in den Formularen | 1 Minute |
Wie du wählst
Drei Fragen entscheiden es.
Liegt die Arbeit vollständig im Repository und hinter Konnektoren? Issues labeln, jeden neuen Pull Request reviewen, die Doku mit den gemergten Änderungen abgleichen: Eine Routine ist das richtige Werkzeug. Nichts muss wach bleiben, und das Ergebnis kommt als Branch an.
Braucht die Arbeit etwas, das nur auf deiner Maschine existiert? Eine Datenbank hinter einem VPN, ein Browser, in dem du angemeldet bist, Dateien, die nicht committet sind, ein lokaler MCP-Server: Bleib lokal. Eine Routine würde von einem Klon starten, der nichts davon hat.
Muss sie öfter als stündlich laufen oder innerhalb einer Minute reagieren? Wieder lokal, oder der API-Trigger, wenn ein externes System ihn aufrufen kann.
Warum unsere sieben nächtlichen Agenten keine Routines sind
Wir lassen jeden Abend um 20:00 Uhr sieben geplante Agenten auf einem Mac mini laufen. Sie lesen die Commits des Tages, beheben Bugs, korrigieren diese Website, posten in sozialen Netzwerken und schicken einen Bericht per E-Mail. Der vollständige Aufbau und die Prompts stehen in einem eigenen Artikel. Als Routines (heute geplante Cloud-Aufgaben) erschienen, haben wir uns die naheliegende Frage gestellt: Warum eine Maschine eingeschaltet lassen?
Vier Gründe, alle mit der Dokumentation oben abgeglichen.
- Sie arbeiten in einem gemeinsamen, nicht committeten Arbeitsverzeichnis. Die Agenten pullen, lesen die Berichte der anderen aus der Nacht und committen unterwegs. Mehrere von ihnen arbeiten in derselben Stunde im selben Checkout. Ein frischer Klon pro Run würde die Übergabe zwischen zwei Schritten desselben Teams verlieren.
- Einer von ihnen veröffentlicht aus einem echten Browser. Der Social-Media-Agent postet aus einer Chrome-Sitzung, die in drei Netzwerken angemeldet ist. Diese Sitzung liegt auf der Maschine. Eine Cloud-VM hat keinen solchen Browser.
- Sie nutzen lokale MCP-Werkzeuge. Backlog, Projektgedächtnis, die Prompt-Bibliothek und die Dev-Befehle sind MCP-Server der App, die auf dieser Maschine läuft. Sie sind keine claude.ai-Konnektoren.
- Sie sind nicht alle Claude Code. Eine Routine führt Claude Code auf einem claude.ai-Abo aus. Unser Scheduler startet das CLI, das die Aufgabe nennt.
Also nutzen wir die Scheduled Tasks von AgentsRoom: Ein Trigger ist ein Prompt, ein Agent oder ein Team und eine Frequenz, gestartet auf einer Maschine, die wir auswählen. Es ist ein In-App-Scheduler, kein Server: Er löst aus, solange AgentsRoom auf dieser Maschine geöffnet ist, holt einen verpassten Run beim nächsten Start nach und kann den Aufwecktimer des Betriebssystems für den nächsten Run stellen. Das ist dieselbe Einschränkung wie bei den geplanten Aufgaben der Claude-Desktop-App, mit dem Unterschied, dass der Agent Codex, Antigravity oder jedes andere CLI sein kann und dass ein Trigger auch über einen Webhook auslösen kann oder wenn ein Ticket ausgeliefert wird.
Nichts davon macht geplante Cloud-Aufgaben zur falschen Wahl. Wäre unsere nächtliche Arbeit „jeden Pull Request mit unserer Checkliste reviewen“, würden wir sie als Routine mit einem GitHub-Trigger laufen lassen und den Mac mini ausschalten. Und wenn du statt eines wiederkehrenden Jobs eine Wegwerf-Maschine für eine einzelne Aufgabe brauchst, ist das wieder ein anderes Werkzeug, beschrieben in was „Claude remote agents“ bedeutet.
Häufige Fragen
Sind die Routines von Claude Code dasselbe wie geplante Aufgaben?
Es ist dieselbe Funktion unter neuem Namen: Anthropic nennt Routines inzwischen cloud scheduled tasks (geplante Cloud-Aufgaben), und der alte Name ist an manchen Stellen noch zu sehen. Eine geplante Cloud-Aufgabe läuft in der Cloud, als vollständige Cloud Session von Claude Code auf einem frischen Klon deines Repositorys, und sie kann nach Zeitplan, auf einen API-Aufruf hin oder bei einem GitHub-Ereignis starten. Eine geplante Aufgabe der Desktop-App läuft auf deiner eigenen Maschine mit deinen lokalen Dateien, nur solange die Claude-Desktop-App geöffnet und der Computer wach ist. /loop wiederholt einen Prompt innerhalb einer offenen CLI-Sitzung. Die Desktop-App legt die ersten beiden auf derselben Seite an, die je nach Konto Scheduled tasks oder Routines heißt: Du wählst Cloud oder Local.
Wie oft kann eine Routine von Claude Code laufen?
Das minimale Intervall eines Zeitplan-Triggers ist eine Stunde: Ein cron-Ausdruck, der häufiger auslöst, wird abgelehnt. Die Voreinstellungen sind stündlich, täglich, werktags und wöchentlich, und /schedule update setzt einen eigenen cron-Ausdruck. Unabhängig von der Nutzung deines Abos kann ein Konto 100 geplante Runs pro Stunde starten, und Run now sowie API-Aufrufe sind auf 30 pro Stunde für jede Aufgabe begrenzt. /loop geht bis auf eine Minute herunter, ebenso die geplanten Aufgaben der Desktop-App, wenn Claude den Zeitplan festlegt (eine Stunde über die Formulare).
Muss mein Computer für Routines eingeschaltet sein?
Nein. Eine Routine läuft auf einer von Anthropic verwalteten Cloud-Infrastruktur oder in einer selbst gehosteten Umgebung, wenn deine Organisation sie dorthin leitet, also läuft sie auch bei zugeklapptem Laptop weiter. Der Preis dafür: Sie sieht deine Maschine nicht. Sie startet von einem frischen Klon des Standard-Branches, mit den Konnektoren deines claude.ai-Kontos und dem Netzwerkzugriff ihrer Cloud-Umgebung. MCP-Server, die du lokal mit claude mcp add hinzugefügt hast, sind nicht verfügbar, es sei denn, du fügst sie als Konnektoren hinzu oder committest eine .mcp.json.
Kosten Routines extra?
In der Dokumentation gibt es keinen separaten Preis: Geplante Aufgaben verbrauchen die Nutzung des Abos genauso wie interaktive Sitzungen, in den Plänen Pro, Max, Ultra, Team und Enterprise. Erreicht eine Routine dein Nutzungslimit, werden weitere Runs abgelehnt, bis das Fenster zurückgesetzt wird, es sei denn, Nutzungsguthaben sind aktiviert: Dann laufen sie als nach Verbrauch abgerechnete Mehrnutzung weiter. Die stündlichen Obergrenzen für Runs kennen keine Mehrnutzung.
Kann eine Routine Codex, Antigravity oder ein anderes CLI ausführen?
Nein. Eine Routine ist eine gespeicherte Konfiguration von Claude Code, und /schedule verlangt eine Anmeldung mit einem claude.ai-Abo: Der Befehl ist ausgeblendet, wenn Claude Code mit einem API-Schlüssel oder über einen Cloud-Anbieter authentifiziert ist. Um ein anderes CLI zu planen, brauchst du einen Scheduler außerhalb von Claude Code: cron und den Headless-Modus des CLI, einen CI-Zeitplan oder ein Werkzeug, das Agenten für jedes CLI startet, und genau das tun die Scheduled Tasks von AgentsRoom.
Warum zeigt meine Routine Grün, obwohl sie nichts getan hat?
Weil der Status die Sitzung beschreibt, nicht die Aufgabe. Die Dokumentation sagt es klar: Ein grüner Status bedeutet, dass die Sitzung gestartet und ohne Infrastrukturfehler beendet wurde, nicht, dass die Aufgabe in deinem Prompt gelungen ist. Blockierte Netzwerkanfragen, fehlende Konnektor-Werkzeuge und Fehler auf Ebene der Aufgabe zeigen sich nur im Transkript. Öffne den Run oder frag das CLI: /schedule, gefolgt von einer Frage zur Routine, listet ihre letzten Runs auf und liest das Log, ab Claude Code v2.1.227.
AgentsRoom herunterladen
Führe alle deine KI-Agenten aus, in all deinen Projekten, aus einem einzigen Fenster.
Companion-App: Agenten auch unterwegs im Blick behalten
Nutze Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.
Bugs und Wünsche direkt in dein öffentliches Backlog schicken.
Weiterlesen
Claude Code und Codex CLI unter Windows installieren
Die genauen PowerShell-, CMD-, WinGet- und npm-Befehle, um Claude Code und Codex CLI unter Windows 10 und 11 zu installieren, wann sich WSL lohnt und wie du „claude wird nicht erkannt“ und die anderen Fehler behebst, die dir begegnen werden.
Zum ArtikelWie du einem KI-Coding-Agenten ein Secret gibst, ohne es in den Prompt zu schreiben
Ein Agent braucht einen Stripe-Key oder ein Datenbank-Passwort, um seinen Befehl auszuführen. Klebst du ihn in den Chat, landet er im Transkript auf deiner Platte, beim Modellanbieter und manchmal in einem Commit. Die Regel, bei der wir nach drei eigenen Fehlern gelandet sind: Ein Secret erreicht einen Agenten über eine Umgebungsvariable und über nichts anderes.
Zum ArtikelSieben KI-Agenten übernehmen unsere Nächte: geplante Agenten jenseits von Code, mit den Prompts
Ein Nutzer hat uns gefragt, wie wir KI-Agenten für etwas anderes als Code einsetzen. Seit dem 28. August starten jeden Abend sieben geplante Agenten auf einem Mac mini: ein diensthabender CEO, ein SEO-Team, ein Product Manager, ein Bugfixer, ein Social-Media-Team, ein Dokumentar und ein Berichterstatter, der eine Zusammenfassung von 25 Zeilen per E-Mail schickt. 33 Nächte, 31 Morgen-E-Mails, 51 behobene Bugs mit Commit-Link, 7 Blogartikel in 20 Sprachen. Was jeder macht, wie sie sich Arbeit übergeben, ohne miteinander zu reden, welches Modell welchen Job macht, die vier Regeln, die ihre Prompts lernen mussten, und die Prompts selbst, bereit zum Kopieren.
Zum Artikel