Routines in Claude Code: Was in der Cloud läuft, was auf deiner Maschine bleibt und wie du wählst

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. 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, Routines sind in der Research Preview, und Anthropic weist darauf hin, dass sich Verhalten, Grenzen und die API noch ändern können). 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 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 add hinzugefügt hast, leben auf deiner Maschine und stehen nicht in der Liste. Eine committete .mcp.json ist 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.

Routines sind in den Plänen Pro, Max, Team und Enterprise verfügbar. Du legst sie unter claude.ai/code/routines an, in der Desktop-App (Tab Code, Routines, New routine, Cloud) oder im CLI.

Die drei Trigger

Eine Routine 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-Ereignisse und Release-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 Routine im Gespräch an, und /routines ist 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

Routines verbrauchen die Nutzung deines Abos wie jede interaktive Sitzung. Zusätzlich hat jeder Weg, einen Run zu starten, eine stündliche Obergrenze ohne Mehrnutzung:

Drei weitere Punkte aus der Dokumentation, die in der Praxis wehtun. Eine fehlende oder abgelaufene GitHub-Verbindung lässt die Routine ihre Runs bis zu 72 Stunden lang überspringen, danach schaltet sie sich selbst ab. Ein pausiertes Abo setzt Routines 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 hinter demselben Button New routine. 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:

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 erschienen, haben wir uns die naheliegende Frage gestellt: Warum eine Maschine eingeschaltet lassen?

Vier Gründe, alle mit der Dokumentation oben abgeglichen.

1. 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.
2. 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.
3. 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.
4. 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 Routines 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?

Nicht ganz. Eine Routine 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 Seite Routines der Desktop-App legt die ersten beiden an: New routine, dann 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 Routine begrenzt. Die geplanten Aufgaben der Desktop-App und /loop gehen bis auf eine Minute herunter.

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: Routines verbrauchen die Nutzung des Abos genauso wie interaktive Sitzungen, in den Plänen Pro, Max, 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.