Le Routines di Claude Code: cosa gira nel cloud, cosa resta sulla tua macchina e come scegliere

Claude Code ha ormai tre modi per eseguire un prompt senza che tu lo digiti, e i loro nomi si sovrappongono abbastanza da confondere chiunque: le Routines, le attività pianificate dell'app desktop e /loop. L'app desktop crea perfino le prime due dalla stessa pagina. Differiscono sull'unica cosa che conta quando automatizzi un lavoro: dove gira l'agente, e quindi cosa può vedere.

Questa guida passa in rassegna i tre con i limiti scritti nella documentazione (verificata il 4 ottobre 2026, le Routines sono in research preview e Anthropic avverte che comportamento, limiti e API possono cambiare). Poi spiega cosa facciamo noi: sette agenti partono ogni sera dalla nostra parte, e nessuno di loro è una routine. Le ragioni sono precise, e possono valere per te oppure no.

Cos'è una routine

Una routine è una configurazione salvata di Claude Code: un prompt, uno o più repository GitHub e un insieme di connettori, impacchettati una volta ed eseguiti in automatico. Gira su un'infrastruttura cloud gestita da Anthropic, o sull'ambiente self-hosted della tua organizzazione quando viene indirizzata lì. Il tuo portatile può restare chiuso.

Ogni esecuzione è una cloud session completa. Ne derivano quattro conseguenze, ed è questo che va ricordato:

• Un clone nuovo ogni volta. Ogni repository viene clonato all'inizio dell'esecuzione, dal branch di default. Claude pusha il suo lavoro su un branch con il prefisso claude/, a meno che il tuo prompt non dica altro. Niente di quello che non è committato sulla tua macchina esiste per la routine.
• Nessuna richiesta di permesso. Non c'è un selettore della modalità dei permessi. La sessione esegue comandi shell, usa le skill committate nel repository e chiama tutti gli strumenti di tutti i connettori inclusi, scritture comprese, senza fermarsi a chiedere.
• Connettori, non i tuoi server MCP locali. Tutti i connettori del tuo account claude.ai sono inclusi di default, e la documentazione ti dice di togliere quelli che non servono alla routine. I server aggiunti in locale con claude mcp add vivono sulla tua macchina e non sono nell'elenco. Un .mcp.json committato è l'altra porta d'ingresso.
• Agisce a tuo nome. Le Routines appartengono al tuo account personale. I commit e le pull request portano il tuo utente GitHub, e i messaggi Slack e i ticket Linear usano i tuoi account collegati.

Le Routines sono disponibili sui piani Pro, Max, Team ed Enterprise. Le crei su claude.ai/code/routines, dall'app desktop (scheda Code, Routines, New routine, Cloud) o dalla CLI.

I tre trigger

Una routine può avere un solo trigger o più trigger insieme.

Pianificato. Ogni ora, ogni giorno, nei giorni feriali o ogni settimana, nel tuo fuso orario locale, oppure un'esecuzione singola a una data futura. L'intervallo minimo è di un'ora. Un dettaglio della documentazione che vale la pena conoscere: un'esecuzione pianificata esattamente allo scoccare dell'ora può partire con diversi minuti di ritardo, quindi scegli le 9:07 invece delle 9:00 quando l'orario conta.

API. Ogni routine ha il suo endpoint e il suo token bearer, generato sul web (la CLI non può creare né revocare token). Una POST avvia una sessione e ne restituisce l'URL:

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

Il campo text non arriva alla routine come un'istruzione. Arriva avvolto in un blocco che lo etichetta come dato non attendibile, quindi il prompt salvato deve dire esplicitamente di usarlo («analizza l'alert descritto nel blocco routine-fire-payload»), altrimenti il testo resta contesto inerte. È il comportamento di default giusto: chiunque abbia il token può inviare testo.

GitHub. Eventi di pull request e di release, con filtri su autore, titolo, corpo, branch base, branch di origine, label, stato di bozza e stato di merge. La Claude GitHub App deve essere installata sul repository. Ogni evento avvia la propria sessione, e gli eventi oltre il tetto orario vengono scartati.

Dalla CLI: /schedule

/schedule crea una routine pianificata tramite una conversazione, e /routines ne è un 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

È con /schedule update che si imposta un'espressione cron personalizzata. Aggiungere un trigger GitHub dalla CLI richiede Claude Code v2.1.225 o successivo; i trigger API si creano solo sul web.

Se /schedule risponde «Unknown command», la causa abituale è l'autenticazione: il comando richiede l'accesso con un abbonamento claude.ai. Una ANTHROPIC_API_KEY nella tua shell, un apiKeyHelper in settings.json o un accesso tramite Bedrock o Vertex lo nascondono.

I limiti da conoscere prima di farci affidamento

Le Routines consumano l'utilizzo del tuo abbonamento come qualsiasi sessione interattiva. In più, ogni modo di avviare un'esecuzione ha un tetto orario senza possibilità di eccedenza:

Altre tre cose della documentazione che pesano nella pratica. Una connessione GitHub mancante o scaduta fa saltare le esecuzioni della routine per un massimo di 72 ore, poi la routine si disattiva da sola. Un abbonamento in pausa mette in attesa le Routines. E un'esecuzione verde non significa che il task abbia funzionato: significa che la sessione è partita e si è chiusa senza un errore di infrastruttura.

Le due opzioni locali

Le attività pianificate dell'app desktop sono la scelta Local dello stesso pulsante New routine. Girano sulla tua macchina, con i tuoi file così come sono, modifiche non committate comprese, a meno che tu non spunti l'opzione worktree. Ogni attività ha la sua modalità dei permessi. Il tranello sta in una frase della documentazione: le attività girano solo mentre l'app desktop è aperta e il computer non è in stop. Un'esecuzione che cade durante lo stop viene saltata, e al risveglio l'app avvia esattamente un'esecuzione di recupero per l'orario mancato più recente degli ultimi sette giorni. Il prompt vive in ~/.claude/scheduled-tasks/<task-name>/SKILL.md.

/loop ripete un prompt dentro una sessione CLI aperta: /loop 5m check the deploy. Eredita i permessi e i server MCP della sessione, gestisce fino a 50 task, e un task ricorrente scade dopo sette giorni. Chiudi il terminale e si ferma. È fatto per tenere d'occhio una build o una pull request per un pomeriggio, non per un lavoro notturno.

Fianco a fianco, come li presenta la documentazione:

Come scegliere

Tre domande decidono.

Il lavoro sta tutto nel repository e dietro dei connettori? Etichettare le issue, rivedere ogni nuova pull request, confrontare la documentazione con le modifiche mergiate: una routine è lo strumento giusto. Niente da tenere acceso, e il risultato arriva sotto forma di branch.

Il lavoro ha bisogno di qualcosa che esiste solo sulla tua macchina? Un database dietro una VPN, un browser in cui hai fatto l'accesso, file non committati, un server MCP locale: resta in locale. Una routine partirebbe da un clone che non ha niente di tutto questo.

Deve girare più spesso di una volta all'ora, o reagire entro il minuto? Di nuovo in locale, oppure con il trigger API se un sistema esterno può chiamarlo.

Perché i nostri sette agenti notturni non sono Routines

Facciamo girare sette agenti pianificati ogni sera alle 20:00 su un Mac mini. Leggono i commit del giorno, correggono bug, correggono questo sito, pubblicano sui social network e inviano un report via e-mail. Il setup completo e i prompt sono in un articolo a parte. Quando sono arrivate le Routines, ci siamo fatti la domanda ovvia: perché tenere accesa una macchina?

Quattro ragioni, tutte verificate sulla documentazione qui sopra.

1. Lavorano in un albero condiviso e non committato. Gli agenti fanno pull, leggono i report notturni degli altri e committano man mano. Diversi di loro toccano lo stesso checkout nella stessa ora. Un clone nuovo per ogni esecuzione perderebbe il passaggio di consegne tra due fasi dello stesso team.
2. Uno di loro pubblica da un browser vero. L'agente social pubblica da una sessione Chrome con l'accesso fatto su tre social network. Quella sessione sta sulla macchina. Una VM nel cloud non ha quel browser.
3. Usano strumenti MCP locali. Il backlog, la memoria di progetto, la libreria di prompt e i comandi di sviluppo sono server MCP dell'app che gira su quella macchina. Non sono connettori claude.ai.
4. Non sono tutti Claude Code. Una routine esegue Claude Code su un abbonamento claude.ai. Il nostro scheduler avvia la CLI indicata dall'attività.

Quindi usiamo le attività pianificate di AgentsRoom: un trigger è un prompt, un agente o un team, e una frequenza, avviato su una macchina che scegliamo noi. È uno scheduler dentro l'app, non un server: parte mentre AgentsRoom è aperto su quella macchina, recupera un'esecuzione mancata all'avvio successivo e può programmare il risveglio del sistema operativo per l'esecuzione seguente. È lo stesso vincolo delle attività pianificate dell'app desktop di Claude, con la differenza che l'agente può essere Codex, Antigravity o qualsiasi altra CLI, e che un trigger può partire anche su un webhook o quando un ticket viene consegnato.

Niente di tutto questo rende le Routines la scelta sbagliata. Se il nostro lavoro notturno fosse «rivedere ogni pull request con la nostra checklist», lo faremmo girare come routine con un trigger GitHub e spegneremmo il Mac mini. E quando ti serve una macchina usa e getta per un singolo task invece di un lavoro ricorrente, è ancora un altro strumento, descritto in cosa significa «Claude remote agents».

Domande frequenti

Le Routines di Claude Code sono la stessa cosa delle attività pianificate?

Non proprio. Una routine gira nel cloud, come cloud session completa di Claude Code su un clone nuovo del tuo repository, e può partire secondo una pianificazione, su una chiamata API o su un evento GitHub. Un'attività pianificata dell'app desktop gira sulla tua macchina con i tuoi file locali, solo finché l'app desktop di Claude è aperta e il computer non è in stop. /loop ripete un prompt dentro una sessione CLI aperta. La pagina Routines dell'app desktop crea le prime due: New routine, poi Cloud o Local.

Ogni quanto può girare una routine di Claude Code?

L'intervallo minimo di un trigger pianificato è di un'ora: un'espressione cron che parte più spesso viene rifiutata. Le impostazioni predefinite sono ogni ora, ogni giorno, nei giorni feriali e ogni settimana, e /schedule update imposta un'espressione cron personalizzata. Indipendentemente dall'utilizzo del tuo abbonamento, un account può avviare 100 esecuzioni pianificate all'ora, e Run now e le chiamate API hanno un tetto di 30 all'ora per ogni routine. Le attività pianificate dell'app desktop e /loop scendono fino a un minuto.

Le Routines hanno bisogno che il mio computer sia acceso?

No. Una routine gira su un'infrastruttura cloud gestita da Anthropic, o su un ambiente self-hosted quando la tua organizzazione la indirizza lì, quindi continua a funzionare a portatile chiuso. Il prezzo è che non vede la tua macchina: parte da un clone nuovo del branch di default, con i connettori del tuo account claude.ai e l'accesso alla rete del suo ambiente cloud. I server MCP che hai aggiunto in locale con claude mcp add non sono disponibili, a meno che tu non li aggiunga come connettori o non committi un .mcp.json.

Le Routines costano di più?

La documentazione non indica un prezzo a parte: le Routines consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive, sui piani Pro, Max, Team ed Enterprise. Quando una routine raggiunge il tuo limite di utilizzo, le esecuzioni successive vengono rifiutate finché la finestra non si azzera, a meno che i crediti di utilizzo non siano attivi, nel qual caso proseguono in eccedenza a consumo. I tetti orari di esecuzioni non prevedono eccedenza.

Una routine può eseguire Codex, Antigravity o un'altra CLI?

No. Una routine è una configurazione salvata di Claude Code, e /schedule richiede l'accesso con un abbonamento claude.ai: il comando è nascosto quando Claude Code è autenticato con una chiave API o tramite un provider cloud. Per pianificare un'altra CLI ti serve uno scheduler fuori da Claude Code: cron e la modalità headless della CLI, una pianificazione di CI, o uno strumento che avvia agenti per qualsiasi CLI, che è quello che fanno le attività pianificate di AgentsRoom.

Perché la mia routine risulta verde se non ha fatto niente?

Perché lo stato descrive la sessione, non il task. La documentazione lo dice chiaramente: uno stato verde significa che la sessione è partita e si è chiusa senza un errore di infrastruttura, non che il task del tuo prompt sia riuscito. Le richieste di rete bloccate, gli strumenti di connettore mancanti e i fallimenti del task stesso si vedono solo nella trascrizione. Apri l'esecuzione, oppure chiedi alla CLI: /schedule seguito da una domanda sulla routine elenca le sue ultime esecuzioni e legge il log, a partire da Claude Code v2.1.227.