Routines in Claude Code: wat in de cloud draait, wat op je machine blijft en hoe je kiest

Claude Code heeft nu drie manieren om een prompt uit te voeren zonder dat jij hem typt, en hun namen overlappen genoeg om iedereen in verwarring te brengen: Routines, de geplande taken van de desktop-app, en /loop. De desktop-app maakt de eerste twee zelfs aan vanaf dezelfde pagina. Ze verschillen op het ene punt dat telt als je werk automatiseert: waar de agent draait, en dus wat hij kan zien.

Deze gids loopt de drie langs met de limieten die in de documentatie staan (gecontroleerd op 4 oktober 2026, Routines zijn in research preview en Anthropic waarschuwt dat het gedrag, de limieten en de API nog kunnen veranderen). Daarna legt hij uit wat we zelf doen: bij ons starten elke avond zeven agents, en geen van hen is een routine. De redenen zijn specifiek, en ze gelden misschien wel of niet voor jou.

Wat een routine is

Een routine is een opgeslagen configuratie van Claude Code: een prompt, een of meer GitHub-repository's en een set connectors, één keer samengesteld en automatisch uitgevoerd. Hij draait op cloudinfrastructuur die Anthropic beheert, of op de zelf gehoste omgeving van je organisatie als hij daarheen wordt gestuurd. Je laptop mag dicht zijn.

Elke run is een volledige cloud session. Daar volgen vier gevolgen uit, en dat zijn de gevolgen om te onthouden:

• Elke keer een verse kloon. Elke repository wordt aan het begin van een run gekloond, vanaf de standaardbranch. Claude pusht zijn werk naar een branch met het voorvoegsel claude/, tenzij je prompt iets anders zegt. Niets wat niet gecommit is op je machine bestaat voor de routine.
• Geen toestemmingsvragen. Er is geen keuzemenu voor de permissiemodus. De sessie voert shell-commando's uit, gebruikt de skills die in de repository zijn gecommit en roept elke tool van elke opgenomen connector aan, schrijfacties inbegrepen, zonder te stoppen om te vragen.
• Connectors, niet je lokale MCP-servers. Alle connectors van je claude.ai-account zijn standaard opgenomen, en de documentatie zegt dat je de connectors verwijdert die de routine niet nodig heeft. Servers die je lokaal hebt toegevoegd met claude mcp add leven op je machine en staan niet in de lijst. Een gecommitte .mcp.json is de andere weg naar binnen.
• Hij handelt namens jou. Routines horen bij je persoonlijke account. Commits en pull requests dragen je GitHub-gebruiker, Slack-berichten en Linear-tickets gaan via je gekoppelde accounts.

Routines zijn beschikbaar op de abonnementen Pro, Max, Team en Enterprise. Je maakt ze aan op claude.ai/code/routines, vanuit de desktop-app (tabblad Code, Routines, New routine, Cloud) of vanuit de CLI.

De drie triggers

Een routine kan één trigger dragen of meerdere tegelijk.

Schema. Elk uur, dagelijks, op werkdagen of wekelijks, in je lokale tijd, of één run op een tijdstip in de toekomst. Het minimuminterval is één uur. Een detail uit de documentatie dat de moeite waard is: een run die precies op het hele uur is gepland, kan enkele minuten te laat starten, dus kies 9:07 in plaats van 9:00 als het tijdstip ertoe doet.

API. Elke routine krijgt een eigen endpoint en een eigen bearer-token, aangemaakt op het web (de CLI kan geen tokens aanmaken of intrekken). Een POST start een sessie en geeft de URL ervan terug:

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."}'

Het veld text komt niet als instructie bij de routine aan. Het komt verpakt in een blok dat het markeert als onbetrouwbare data, dus de opgeslagen prompt moet er uitdrukkelijk voor kiezen (“onderzoek de melding die in het blok routine-fire-payload staat”), anders blijft de tekst inerte context. Dat is de juiste standaard: iedereen die het token heeft, kan tekst sturen.

GitHub. Pull request-gebeurtenissen en release-gebeurtenissen, met filters op auteur, titel, beschrijving, basisbranch, headbranch, labels, conceptstatus en merge-status. De Claude GitHub App moet op de repository geïnstalleerd zijn. Elke gebeurtenis start een eigen sessie, en gebeurtenissen boven de limiet per uur vallen weg.

Vanuit de CLI: /schedule

/schedule maakt via een gesprek een geplande routine aan, en /routines is een alias.

/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

Met /schedule update stel je een eigen cron-expressie in. Een GitHub-trigger toevoegen vanuit de CLI vereist Claude Code v2.1.225 of nieuwer; API-triggers kun je alleen op het web aanmaken.

Als /schedule antwoordt met “Unknown command”, is de gebruikelijke oorzaak de authenticatie: het commando vereist een login met een claude.ai-abonnement. Een ANTHROPIC_API_KEY in je shell, een apiKeyHelper in settings.json, of een login via Bedrock of Vertex verbergt het.

De limieten die je moet kennen voordat je erop bouwt

Routines verbruiken het gebruik van je abonnement zoals elke interactieve sessie. Daarbovenop heeft elke manier om een run te starten een limiet per uur, zonder overschrijding:

Nog drie dingen uit de documentatie die in de praktijk pijn doen. Een ontbrekende of verlopen GitHub-verbinding laat de routine zijn runs tot 72 uur overslaan, waarna hij zichzelf uitschakelt. Een gepauzeerd abonnement zet Routines in de wacht. En een groene run betekent niet dat de taak gelukt is: het betekent dat de sessie is gestart en zonder infrastructuurfout is afgesloten.

De twee lokale opties

De geplande taken van de desktop-app zijn de keuze Local van dezelfde knop New routine. Ze draaien op je machine, met je bestanden zoals ze zijn, niet-gecommitte wijzigingen inbegrepen, tenzij je de worktree-optie aanvinkt. Elke taak heeft een eigen permissiemodus. Het addertje staat in één zin van de documentatie: taken draaien alleen zolang de desktop-app draait en je computer wakker is. Een run die tijdens de slaapstand valt, wordt overgeslagen, en bij het ontwaken start de app precies één inhaalrun voor het meest recente gemiste tijdstip van de afgelopen zeven dagen. De prompt staat in ~/.claude/scheduled-tasks/<task-name>/SKILL.md.

/loop herhaalt een prompt binnen één open CLI-sessie: /loop 5m check the deploy. Het erft de rechten en MCP-servers van de sessie, houdt tot 50 taken vast, en een terugkerende taak verloopt na zeven dagen. Sluit de terminal en het stopt. Het is bedoeld om een middag lang een build of een pull request in de gaten te houden, niet voor een nachtelijke klus.

Naast elkaar, zoals de documentatie het weergeeft:

Hoe je kiest

Drie vragen beslissen het.

Speelt het werk zich volledig af in de repository en achter connectors? Issues labelen, elke nieuwe pull request reviewen, de documentatie naast de gemergde wijzigingen leggen: een routine is het juiste gereedschap. Niets hoeft wakker te blijven, en het resultaat komt binnen als branch.

Heeft het werk iets nodig dat alleen op je machine bestaat? Een database achter een VPN, een browser waarin je bent ingelogd, bestanden die niet gecommit zijn, een lokale MCP-server: blijf lokaal. Een routine zou starten vanaf een kloon die daar niets van heeft.

Moet het vaker dan elk uur draaien, of binnen de minuut reageren? Ook dan lokaal, of de API-trigger als een extern systeem hem kan aanroepen.

Waarom onze zeven nachtelijke agents geen Routines zijn

We laten elke avond om 20:00 zeven geplande agents draaien op een Mac mini. Ze lezen de commits van de dag, lossen bugs op, corrigeren deze website, posten op sociale netwerken en mailen een rapport. De volledige opzet en de prompts staan in een apart artikel. Toen Routines verschenen, stelden we de voor de hand liggende vraag: waarom een machine aan laten staan?

Vier redenen, allemaal getoetst aan de documentatie hierboven.

1. Ze werken in een gedeelde, niet-gecommitte werkboom. De agents pullen, lezen elkaars rapporten van die nacht en committen gaandeweg. Een aantal van hen werkt in hetzelfde uur in dezelfde checkout. Een verse kloon per run zou de overdracht tussen twee stappen van hetzelfde team kwijtraken.
2. Een van hen publiceert vanuit een echte browser. De social-media-agent post vanuit een Chrome-sessie die op drie netwerken is ingelogd. Die sessie staat op de machine. Een cloud-VM heeft zo'n browser niet.
3. Ze gebruiken lokale MCP-tools. De backlog, het projectgeheugen, de promptbibliotheek en de dev-commando's zijn MCP-servers van de app die op die machine draait. Het zijn geen claude.ai-connectors.
4. Ze zijn niet allemaal Claude Code. Een routine draait Claude Code op een claude.ai-abonnement. Onze planner start de CLI die de taak noemt.

Daarom gebruiken we de Geplande Taken van AgentsRoom: een trigger is een prompt, een agent of een team, en een frequentie, gestart op een machine die we kiezen. Het is een planner in de app, geen server: hij gaat af zolang AgentsRoom op die machine open is, haalt een gemiste run in bij de volgende start, en kan de wektimer van het besturingssysteem klaarzetten voor de volgende run. Dat is dezelfde beperking als bij de geplande taken van de Claude-desktop-app, met het verschil dat de agent Codex, Antigravity of elke andere CLI kan zijn, en dat een trigger ook kan afgaan op een webhook of wanneer een ticket wordt opgeleverd.

Niets hiervan maakt Routines de verkeerde keuze. Als ons nachtwerk “elke pull request reviewen met onze checklist” was, zouden we het als routine met een GitHub-trigger draaien en de Mac mini uitzetten. En als je in plaats van een terugkerende klus een wegwerpmachine voor één taak nodig hebt, is dat weer een ander gereedschap, beschreven in wat “Claude remote agents” betekent.

Veelgestelde vragen

Zijn de Routines van Claude Code hetzelfde als geplande taken?

Niet helemaal. Een routine draait in de cloud, als volledige cloud session van Claude Code op een verse kloon van je repository, en kan starten volgens een schema, op een API-aanroep of bij een GitHub-gebeurtenis. Een geplande taak van de desktop-app draait op je eigen machine met je lokale bestanden, alleen zolang de Claude-desktop-app open is en de computer wakker. /loop herhaalt een prompt binnen één open CLI-sessie. De pagina Routines van de desktop-app maakt de eerste twee aan: New routine, daarna Cloud of Local.

Hoe vaak kan een routine van Claude Code draaien?

Het minimuminterval van een schematrigger is één uur: een cron-expressie die vaker afgaat, wordt geweigerd. De voorinstellingen zijn elk uur, dagelijks, op werkdagen en wekelijks, en /schedule update stelt een eigen cron-expressie in. Los van het gebruik van je abonnement kan een account 100 geplande runs per uur starten, en Run now en API-aanroepen zijn beperkt tot 30 per uur voor elke routine. De geplande taken van de desktop-app en /loop gaan tot één minuut omlaag.

Moet mijn computer aanstaan voor Routines?

Nee. Een routine draait op cloudinfrastructuur die Anthropic beheert, of op een zelf gehoste omgeving als je organisatie hem daarheen stuurt, dus hij blijft werken met de laptop dicht. De prijs is dat hij je machine niet ziet: hij start vanaf een verse kloon van de standaardbranch, met de connectors van je claude.ai-account en de netwerktoegang van zijn cloudomgeving. MCP-servers die je lokaal hebt toegevoegd met claude mcp add zijn niet beschikbaar, tenzij je ze toevoegt als connectors of een .mcp.json commit.

Kosten Routines extra?

De documentatie noemt geen aparte prijs: Routines verbruiken het gebruik van je abonnement op dezelfde manier als interactieve sessies, op de abonnementen Pro, Max, Team en Enterprise. Als een routine je gebruikslimiet bereikt, worden verdere runs geweigerd tot het venster reset, tenzij gebruikstegoed is ingeschakeld: dan gaan ze door als overschrijding die per verbruik wordt gefactureerd. De limieten op runs per uur kennen geen overschrijding.

Kan een routine Codex, Antigravity of een andere CLI draaien?

Nee. Een routine is een opgeslagen configuratie van Claude Code, en /schedule vereist een login met een claude.ai-abonnement: het commando is verborgen als Claude Code is aangemeld met een API-sleutel of via een cloudprovider. Om een andere CLI te plannen heb je een planner buiten Claude Code nodig: cron en de headless modus van de CLI, een CI-schema, of een tool die agents start voor elke CLI, en dat is precies wat de Geplande Taken van AgentsRoom doen.

Waarom staat mijn routine op groen terwijl hij niets heeft gedaan?

Omdat de status de sessie beschrijft, niet de taak. De documentatie zegt het ronduit: een groene status betekent dat de sessie is gestart en zonder infrastructuurfout is afgesloten, niet dat de taak in je prompt is gelukt. Geblokkeerde netwerkverzoeken, ontbrekende connectortools en fouten in de taak zelf zie je alleen in het transcript. Open de run, of vraag het aan de CLI: /schedule gevolgd door een vraag over de routine toont de recente runs en leest het log, vanaf Claude Code v2.1.227.