SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 272 additions and 289 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

Automatizzare il lavoro con le attività pianificate

Metti Claude Code in modalità automatica. Crea attività pianificate, in precedenza chiamate routine, che vengono eseguite nel cloud secondo una pianificazione, tramite chiamate API o in risposta agli eventi di GitHub.

[!NOTE]

Le attività pianificate sono in anteprima di ricerca. Il comportamento, i limiti e la superficie dell'API potrebbero cambiare.

Un'attività pianificata cloud, in precedenza chiamata routine, è una configurazione salvata di Claude Code: un prompt, uno o più repository e un set di connettori, confezionati una volta ed eseguiti automaticamente. Le attività pianificate vengono eseguite su infrastruttura cloud gestita da Anthropic, oppure sull'ambiente self-hosted della tua organizzazione quando indirizzate lì, quindi continuano a funzionare quando il tuo laptop è chiuso.

Ogni attività pianificata può avere uno o più trigger collegati:

  • Pianificazione: esegui su una cadenza ricorrente come oraria, notturna o settimanale, oppure una volta a un momento futuro specifico
  • API: attiva su richiesta inviando un POST HTTP all'endpoint dedicato dell'attività con un token bearer
  • GitHub: esegui automaticamente in risposta agli eventi del repository come pull request o release

Una singola attività pianificata può combinare trigger. Ad esempio, un'attività di revisione delle PR può essere eseguita ogni notte, essere attivata da uno script di deploy e anche reagire a ogni nuova PR.

Un'attività pianificata non ha bisogno di una pianificazione:

  • Un'attività con solo un trigger API viene eseguita quando chiami il suo endpoint.
  • Un'attività con solo un trigger GitHub viene eseguita quando si verifica un evento del repository corrispondente.

Le attività pianificate sono disponibili sui piani Pro, Max, Team ed Enterprise. Creale e gestiscile su claude.ai/code/routines, oppure dalla CLI con /schedule. Il nome precedente, routine, compare ancora nell'indirizzo web, nella CLI e nell'API.

[!NOTE]

Altre due funzionalità pianificano il lavoro sulla tua macchina anziché nel cloud: le attività pianificate di Desktop e /loop. Per scegliere tra tutte e tre, consulta Confrontare le opzioni di pianificazione.

Gli Owner di Team ed Enterprise possono disattivare le attività pianificate per tutti i membri con l'interruttore Scheduled tasks (Was Routines) in Organization settings > Capabilities > Remote sessions. Quando l'interruttore è disattivato, le attività pianificate esistenti smettono di essere eseguite e i membri non possono crearne di nuove.

Esempi di casi d'uso

Ogni esempio abbina un tipo di trigger al tipo di lavoro per cui le attività pianificate sono adatte: non presidiato, ripetibile e legato a un risultato chiaro.

  • Manutenzione del backlog: un trigger di pianificazione viene eseguito ogni sera feriale nel tuo repository, con il tuo issue tracker aggiunto come connettore. L'attività pianificata legge le issue aperte dall'ultima esecuzione, applica etichette e assegna i responsabili in base all'area di codice a cui fanno riferimento. Poi pubblica un riepilogo su Slack, così il team inizia la giornata con una coda già ordinata.
  • Triage degli avvisi: il tuo strumento di monitoraggio chiama l'endpoint API dell'attività pianificata quando viene superata una soglia di errore, passando il corpo dell'avviso come text. Il prompt dell'attività dice a Claude di analizzare l'avviso contenuto nel payload di attivazione, quindi Claude recupera lo stack trace e lo correla con i commit recenti nel repository. Poi apre una pull request in bozza con una correzione proposta e un collegamento all'avviso. Chi è di reperibilità esamina la PR invece di partire da un terminale vuoto.
  • Code review personalizzata: un trigger GitHub viene eseguito su pull_request.opened. L'attività pianificata applica la checklist di revisione del tuo team e lascia commenti inline su problemi di sicurezza, prestazioni e stile. Aggiunge anche un commento di riepilogo in modo che i revisori umani possano concentrarsi sulla progettazione invece che sui controlli meccanici.
  • Verifica del deploy: la tua pipeline CD chiama l'endpoint API dell'attività pianificata dopo ogni deploy in produzione. L'attività esegue smoke test sulla nuova build, analizza i log degli errori alla ricerca di regressioni e pubblica un go o no-go nel canale di rilascio prima che la finestra di deploy si chiuda.
  • Disallineamento della documentazione: un trigger di pianificazione viene eseguito settimanalmente. L'attività pianificata analizza le PR unite dall'ultima esecuzione, segnala la documentazione che fa riferimento ad API modificate e apre PR di aggiornamento nel repository della documentazione, che un editor potrà rivedere.
  • Porting di librerie: un trigger GitHub viene eseguito su pull_request.closed, filtrato per le PR unite in un repository SDK. L'attività pianificata porta la modifica in un SDK parallelo in un altro linguaggio e apre una PR corrispondente, mantenendo le due librerie allineate senza che una persona debba reimplementare ogni modifica.

Creare un'attività pianificata

Crea un'attività pianificata dal web su claude.ai/code/routines, dall'app Desktop o dalla CLI. Tutte e tre le superfici scrivono nello stesso account cloud, quindi un'attività pianificata che crei in una appare immediatamente nelle altre. Nella scheda Code dell'app Desktop, fai clic su Scheduled nella barra laterale o nel menu More della barra laterale, poi su New task, e prosegui con Creare dal web.

Le attività pianificate vengono eseguite autonomamente come sessioni cloud complete di Claude Code. Non scegli una modalità di permesso. La sessione esegue comandi shell, utilizza le skill di cui è stato fatto il commit nel repository clonato e chiama qualsiasi connettore incluso, il tutto senza fermarsi per l'approvazione a parte alcune azioni sugli artefatti.

Ciò che un'attività pianificata può raggiungere è determinato da:

  • I repository che selezioni
  • L'accesso di rete e le variabili dell'ambiente
  • I connettori che includi

Limita ognuno di questi a ciò di cui l'attività ha bisogno.

Le attività pianificate appartengono al tuo account claude.ai individuale. Non sono condivise con i compagni di squadra e le loro esecuzioni vengono conteggiate nei limiti e nell'utilizzo del tuo account. Tutto ciò che un'attività pianificata fa attraverso la tua identità GitHub connessa o i connettori appare come fatto da te. I commit e le pull request riportano il tuo utente GitHub, e i messaggi Slack, i ticket Linear o altre azioni dei connettori utilizzano i tuoi account collegati per quei servizi.

Creare dal web

1. Apri la finestra di dialogo di creazione

Vai su claude.ai/code/routines e fai clic su New task. Se si apre prima un menu, seleziona Set up manually. Si apre la finestra di dialogo New scheduled task. L'altra opzione del menu, Create with Claude, ti permette invece di descrivere l'attività in una chat e lasciare che sia Claude a crearla.

Se Repositories ed Environment sono già visibili all'apertura della finestra di dialogo, consulta in cosa differisce quella finestra di dialogo. Altrimenti, questa finestra di dialogo crea anche attività pianificate per la chat di claude.ai. Per fare in modo che la tua sia quella che la finestra di dialogo chiama un'attività Claude Code, seleziona un repository oppure aggiungi un trigger di evento GitHub o API nei passaggi successivi. Questo tipo di attività esegue Claude Code in una sessione cloud.

2. Dai un nome all'attività e scrivi il prompt

Dai all'attività pianificata un nome descrittivo e scrivi il prompt che Claude esegue ogni volta. Il prompt è la parte più importante: l'attività viene eseguita autonomamente, quindi il prompt deve essere autosufficiente ed esplicito su cosa fare e su come si presenta il successo. Seleziona un modello nel selettore di modello dell'input del prompt. Claude lo utilizza a ogni esecuzione.

Quando un trigger si attiva, la sessione riceve il prompt salvato come compito assegnato e lo esegue, anziché trattarlo come contenuto non attendibile arrivato a metà conversazione. Il trigger attesta solo che il prompt è stato archiviato in anticipo da una sessione autorizzata sul tuo account. Il prompt attivato non è quindi un input utente in tempo reale e non può valere come approvazione o consenso per le azioni durante l'esecuzione. Il contenuto che la sessione recupera durante l'esecuzione mantiene la sua gestione normale.

3. Seleziona un trigger

Nella riga Trigger, scegli come inizia l'attività. Per combinare più trigger, fai clic su + alla fine della riga.

Schedule

Scegli una frequenza preimpostata per un'esecuzione ricorrente. Consulta Aggiungere un trigger di pianificazione per la gestione del fuso orario, gli avvii in ritardo, gli intervalli cron personalizzati e le esecuzioni una tantum.

GitHub event

Seleziona il repository, l'evento a cui reagire e i filtri facoltativi. Consulta Aggiungere un trigger GitHub per l'elenco completo degli eventi supportati e dei campi di filtro.

API

Seleziona API qui. Quando fai clic su Create, la finestra di dialogo API token mostra il token una sola volta, quindi copialo prima di chiudere la finestra di dialogo. Consulta Aggiungere un trigger API per copiare l'URL o generare un nuovo token.

4. Seleziona i repository

Espandi Advanced settings. In Repository, nella scheda General, seleziona uno o più repository GitHub in cui Claude possa lavorare.

Ogni repository viene clonato all'inizio di un'esecuzione. Claude crea branch con prefisso claude/ per le sue modifiche.

5. Seleziona un ambiente

Dopo aver selezionato un repository, sotto di esso compare Cloud environment. Scegli un ambiente cloud per l'attività. Gli ambienti controllano a cosa ha accesso la sessione cloud:

  • Network access: imposta il livello di accesso a Internet disponibile durante ogni esecuzione
  • Environment variables: fornisci valori che Claude può utilizzare durante ogni esecuzione. Sono visibili a chiunque utilizzi l'ambiente, quindi in un ambiente ospitato da Anthropic archivia invece le chiavi per le API che Claude chiama durante un'esecuzione come segreti di rete. Quella sezione elenca anche le richieste che non ricevono mai un segreto
  • Setup script: installa le dipendenze e gli strumenti di cui l'attività ha bisogno. Il risultato viene memorizzato nella cache, quindi lo script non viene rieseguito a ogni sessione

Viene fornito un ambiente Default con accesso di rete Trusted, che consente solo l'allowlist predefinita di registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni attraverso la rete della sessione. I connettori che aggiungi all'attività raggiungono i loro servizi attraverso i server di Anthropic, quindi non richiedono modifiche all'allowlist.

Se la tua attività ha bisogno di raggiungere direttamente i tuoi servizi, o un dominio al di fuori di tale elenco, modifica l'accesso di rete dell'ambiente prima dell'esecuzione. Per utilizzare un ambiente separato, creane uno prima.

6. Rivedi i connettori

Passa alla scheda Connectors di Advanced settings. Tutti i tuoi connettori MCP connessi sono inclusi per impostazione predefinita. Rimuovi quelli di cui l'attività non ha bisogno: Claude può utilizzare ogni strumento di un connettore incluso, comprese le scritture, senza chiedere il permesso durante un'esecuzione.

7. Crea l'attività

Fai clic su Create. La finestra di dialogo si chiude e si apre la pagina di dettaglio della nuova attività. L'attività viene eseguita la prossima volta che uno dei suoi trigger corrisponde. Per avviare subito un'esecuzione, fai clic su Run now nella pagina di dettaglio.

Ogni esecuzione crea una nuova sessione insieme alle tue altre sessioni, dove puoi vedere cosa ha fatto Claude, rivedere le modifiche e creare una pull request.

Finestra di dialogo con Repositories ed Environment nella vista principale

Segui i passaggi per creare dal web e compila ogni campo nella vista principale della finestra di dialogo anziché in Advanced settings. Questa finestra di dialogo crea solo attività Claude Code.

Seleziona il repository prima di aggiungere un trigger di evento GitHub, perché quel trigger non è disponibile finché non viene selezionato un repository.

Creare dalla CLI

Esegui /schedule in qualsiasi sessione per creare un'attività pianificata in modo conversazionale. Puoi anche passare direttamente una descrizione, per un'attività ricorrente come /schedule daily PR review at 9am o una tantum come /schedule clean up feature flag in one week. Claude ripercorre le stesse informazioni che raccoglie la finestra di dialogo web, quindi salva l'attività nel tuo account. Il comando è disponibile anche con l'alias /routines.

Un avvio riuscito si presenta come una conversazione: Claude pone domande di approfondimento sulla pianificazione, i repository e il prompt prima di salvare. Se invece Claude risponde che devi autenticarti o che non riesce a connettersi al tuo account claude.ai remoto, nessuna attività pianificata è stata creata; consulta Risoluzione dei problemi.

Un'attività che crei con /schedule ha un trigger di pianificazione. Puoi aggiungere anche gli altri tipi di trigger:

  • Trigger API: modifica l'attività sul web su claude.ai/code/routines
  • Trigger GitHub: modifica l'attività sul web oppure chiedi a Claude nella CLI. Per aggiungerne uno dalla CLI serve Claude Code v2.1.225 o successivo

Un'attività pianificata senza trigger di pianificazione, come una avviata solo da chiamate API o eventi GitHub, non ha un'ora di esecuzione successiva. La CLI non ne mostra nessuna quando Claude la salva o l'aggiorna. Prima della v2.1.211, la CLI segnalava per queste attività un'ora di esecuzione successiva nell'anno 1.

Configurare i trigger

Un'attività pianificata inizia quando uno dei suoi trigger corrisponde. Aggiungi o rimuovi i trigger di un'attività in qualsiasi momento nella riga Trigger della finestra di dialogo di modifica dell'attività.

Quando un'attività ha due o più trigger, ognuno ha un'icona del cestino in quella finestra di dialogo. Per rimuovere un trigger di pianificazione o di evento GitHub, fai clic sulla sua icona del cestino, quindi su Save changes. Per rimuovere un trigger API, elimina invece il suo token.

Aggiungere un trigger di pianificazione

Un trigger di pianificazione esegue l'attività su una cadenza ricorrente, oppure una sola volta a un momento futuro specifico. Nella finestra di dialogo di creazione o modifica dell'attività sul web, scegli una frequenza preimpostata come oraria, giornaliera o settimanale:

  • Fuso orario: gli orari vengono inseriti nel tuo fuso orario locale e convertiti automaticamente, quindi l'attività viene eseguita a quell'ora locale indipendentemente da dove si trova l'infrastruttura cloud.
  • Esecuzioni allo scoccare dell'ora: se pianifichi un'esecuzione esattamente allo scoccare dell'ora, ad esempio alle 9:00, potrebbe iniziare con alcuni minuti di ritardo. Per iniziare vicino all'ora pianificata, scegli alcuni minuti dopo l'ora, ad esempio le 9:07.
  • Intervalli personalizzati: per un intervallo personalizzato come ogni due ore, scegli il preset più vicino nella finestra di dialogo, quindi esegui /schedule update nella CLI per impostare un'espressione cron specifica. L'intervallo minimo è un'ora; le espressioni che vengono eseguite più frequentemente vengono rifiutate.

Pianificare un'esecuzione una tantum

Una pianificazione una tantum esegue l'attività una sola volta a un timestamp specifico. Ad esempio, usala per:

  • Ricordarti qualcosa più avanti nella settimana
  • Aprire una PR di pulizia dopo la fine di un rollout
  • Avviare un lavoro di follow-up dopo il rilascio di una modifica upstream

Dopo l'esecuzione, l'attività si disattiva da sola e l'interfaccia web la contrassegna come Completed. Per eseguirla di nuovo, apri la finestra di dialogo di modifica dell'attività sul web, che offre One-time per un'attività una tantum, e imposta un nuovo orario.

Crea un'esecuzione una tantum dalla CLI descrivendo l'ora in linguaggio naturale. Claude interpreta la frase rispetto all'ora attuale e conferma il timestamp assoluto prima di salvare.

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Ai timestamp una tantum si applica la stessa conversione dall'ora locale a UTC delle pianificazioni ricorrenti.

Le esecuzioni una tantum vengono conteggiate nello stesso limite orario delle altre esecuzioni pianificate. Consulta Utilizzo e limiti per i dettagli.

Aggiungere un trigger API

Un trigger API fornisce a un'attività pianificata un endpoint HTTP dedicato. Un POST all'endpoint con il token bearer dell'attività avvia una nuova sessione e restituisce un URL di sessione. Usalo per collegare Claude Code a sistemi di avviso, pipeline di deploy, strumenti interni o qualsiasi punto da cui tu possa effettuare una richiesta HTTP autenticata.

Aggiungi un trigger API sul web, mentre crei l'attività oppure in seguito con i passaggi sotto. Non puoi aggiungere un trigger API né gestirne il token dalla CLI.

1. Apri l'attività per la modifica

Vai su claude.ai/code/routines, fai clic sull'attività pianificata che vuoi attivare tramite API, quindi apri il menu accanto al suo nome e seleziona Edit. Si apre la finestra di dialogo Edit scheduled task.

2. Aggiungi un trigger API

Nella riga Trigger, fai clic su + e seleziona API dal menu che si apre. Compare un pannello con Fire URL e Token per questa attività.

3. Copia l'URL e genera un token

Copia il Fire URL. Fai clic su Generate token, quindi copia immediatamente il token dalla finestra di dialogo Token generated. Il token viene mostrato una sola volta e non può essere recuperato in seguito, quindi archivialo in un luogo sicuro, ad esempio nell'archivio dei segreti del tuo strumento di avviso.

Il trigger API diventa effettivo non appena generi il token. Non è necessario fare clic su Save changes, quindi chiudi la finestra di dialogo quando hai finito.

4. Chiama l'endpoint

Invia il token nell'intestazione Authorization: Bearer quando esegui il POST all'URL. Attivare un'attività pianificata mostra un esempio completo.

Ogni attività pianificata ha il proprio token, limitato all'attivazione di quella sola attività. Per disattivare l'accesso API o ruotare il token, apri di nuovo la finestra di dialogo Edit scheduled task dell'attività. Entrambi i controlli si trovano accanto al token nel pannello del trigger API e hanno effetto immediato:

  • Disattivare l'accesso API: fai clic su Delete token, l'icona del cestino accanto a Regenerate. Questo rimuove il trigger API
  • Ruotare il token: fai clic su Regenerate. Il token precedente smette di funzionare e la finestra di dialogo Token generated mostra quello nuovo una sola volta

Attivare un'attività pianificata

Invia una richiesta POST all'endpoint /fire con il token bearer nell'intestazione Authorization. Il corpo della richiesta accetta un campo text facoltativo per il contesto specifico dell'esecuzione, come il corpo di un avviso o un log di errore, passato all'attività insieme al suo prompt salvato. Il valore è testo libero e non viene analizzato: se invii JSON o un altro payload strutturato, l'attività lo riceve come stringa letterale.

Il valore text non raggiunge la routine come messaggio nudo. Arriva racchiuso in un blocco <routine-fire-payload> che lo etichetta come dati non attendibili e dice a Claude di non seguire le istruzioni al suo interno, a meno che il prompt della routine stessa non lo indichi. Lo stesso involucro si applica al testo fornito con Run now nell'interfaccia web.

Ciò significa che il prompt salvato di una routine deve acconsentire esplicitamente ad agire sul testo di attivazione: scrivi il prompt in modo che faccia riferimento esplicito al payload, ad esempio "Investigate the alert described in the routine-fire-payload block", altrimenti la routine tratta il testo come contesto inerte. Chiunque possieda il token bearer può inviare text, quindi l'involucro fa sì che il testo di attivazione proveniente da un token trapelato arrivi etichettato come dati non attendibili anziché come istruzioni dirette alla tua routine.

L'esempio seguente attiva un'attività pianificata da una shell. L'ID dell'attività e il token mostrati sono segnaposto: sostituiscili con l'URL e il token che hai copiato quando hai aggiunto il trigger API, altrimenti la richiesta non riesce con un errore di autenticazione 401:

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

Una richiesta riuscita restituisce un corpo JSON con l'ID e l'URL della nuova sessione:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

Apri l'URL della sessione in un browser per seguire l'esecuzione in tempo reale, rivedere le modifiche o continuare la conversazione manualmente.

[!WARNING]

L'endpoint /fire viene fornito con l'intestazione beta experimental-cc-routine-2026-04-01. Le forme di richiesta e risposta, i rate limit e la semantica dei token potrebbero cambiare mentre la funzionalità è in anteprima di ricerca. Le modifiche incompatibili vengono rilasciate dietro nuove versioni datate dell'intestazione beta, e le due versioni precedenti più recenti dell'intestazione continuano a funzionare in modo che i chiamanti abbiano il tempo di migrare.

Riferimento API

Per il riferimento API completo, incluse tutte le risposte di errore, le regole di convalida e i limiti dei campi, consulta Trigger a routine through the API nella documentazione di Claude Platform.

L'endpoint /fire è disponibile solo per gli utenti di claude.ai e non fa parte della superficie API di Claude Platform.

Aggiungere un trigger GitHub

Un trigger GitHub avvia automaticamente una nuova sessione quando si verifica un evento corrispondente su un repository connesso. Claude Code non riutilizza le sessioni tra un evento e l'altro, quindi due aggiornamenti di una PR producono due sessioni indipendenti.

[!NOTE]

Gli eventi webhook di GitHub sono soggetti a limiti orari per attività e per account. Gli eventi oltre il limite vengono scartati fino al ripristino della finestra.

L'app Claude GitHub deve essere installata sul repository a cui vuoi sottoscriverti, indipendentemente dalla superficie da cui configuri il trigger.

  • Configura i trigger GitHub dall'interfaccia web, che ti chiede di installare l'app se manca. Segui i passaggi sotto per configurarne uno sul web.
  • Dalla CLI, installa prima l'app dalla pagina della GitHub App, quindi chiedi a Claude di collegare un trigger GitHub a un'attività pianificata esistente, ad esempio /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. Il percorso CLI richiede Claude Code v2.1.225 o successivo. Quando Claude aggiunge il trigger, risponde con un link all'attività che il trigger attiva.

1. Apri l'attività per la modifica

Vai su claude.ai/code/routines, fai clic sull'attività pianificata, quindi apri il menu accanto al suo nome e seleziona Edit. Si apre la finestra di dialogo Edit scheduled task.

2. Aggiungi un trigger di evento GitHub

Nella riga Trigger, fai clic su + e seleziona GitHub event dal menu che si apre.

[!NOTE]

L'esecuzione di /web-setup nella CLI concede l'accesso al repository per la clonazione, ma non installa l'app Claude GitHub e non abilita la consegna dei webhook.

3. Configura il trigger

Cambia il repository se necessario, scegli un evento dall'elenco degli eventi supportati e, facoltativamente, aggiungi dei filtri. Quindi fai clic su Save changes in fondo alla finestra di dialogo per applicare il trigger.

Eventi supportati

I trigger GitHub possono sottoscriversi a una delle seguenti categorie di eventi. All'interno di ogni categoria puoi scegliere un'azione specifica, come pull_request.opened, oppure reagire a tutte le azioni della categoria.

Event Triggers when
Pull request Una PR viene aperta, chiusa, assegnata, etichettata, sincronizzata o altrimenti aggiornata
Release Una release viene creata, pubblicata, modificata o eliminata

Filtrare le pull request

Usa i filtri per restringere quali pull request avviano una nuova sessione. Tutte le condizioni di filtro devono corrispondere affinché l'attività pianificata si attivi. I campi di filtro disponibili sono:

Filter Matches
Author Nome utente GitHub dell'autore della PR
Title Testo del titolo della PR
Body Testo della descrizione della PR
Base branch Branch a cui è destinata la PR
Head branch Branch da cui proviene la PR
Labels Etichette applicate alla PR
Is draft Se la PR è in stato di bozza
Is merged Se la PR è stata unita

Ogni filtro abbina un campo a un operatore: equals, contains, starts with, is one of, is not one of o matches regex.

L'operatore matches regex verifica l'intero valore del campo, non una sottostringa al suo interno. Per trovare qualsiasi titolo contenente hotfix, scrivi .*hotfix.*. Senza i .* circostanti, il filtro corrisponde solo a un titolo che sia esattamente hotfix, senza nulla prima o dopo. Per una corrispondenza di sottostringa letterale senza sintassi regex, usa invece l'operatore contains.

Alcuni esempi di combinazioni di filtri:

  • Revisione del modulo di autenticazione: base branch main, head branch contains auth-provider. Invia qualsiasi PR che tocca l'autenticazione a un revisore dedicato.
  • Solo pronte per la revisione: is draft is false. Salta le bozze in modo che l'attività venga eseguita solo quando la PR è pronta per la revisione.
  • Backport condizionato da etichetta: labels include needs-backport. Attiva un'attività di porting su un altro branch solo quando un manutentore etichetta la PR.

Gestire le attività pianificate

Fai clic su un'attività pianificata nell'elenco per aprirne la pagina di dettaglio. La pagina di dettaglio mostra i repository, i connettori, il prompt, la pianificazione, i token API, i trigger GitHub dell'attività e un elenco delle esecuzioni passate.

Visualizzare e interagire con le esecuzioni

Fai clic su qualsiasi esecuzione per aprirla come sessione completa. Da lì puoi vedere cosa ha fatto Claude, rivedere le modifiche, creare una pull request o continuare la conversazione. Ogni sessione di esecuzione funziona come qualsiasi altra sessione: usa il menu a discesa accanto al titolo della sessione per rinominarla, archiviarla o eliminarla.

[!NOTE]

Uno stato verde nell'elenco delle esecuzioni significa che la sessione è stata avviata e si è chiusa senza un errore infrastrutturale. Non significa che il lavoro descritto dal tuo prompt sia riuscito. Apri l'esecuzione per leggere la trascrizione e verificare cosa ha effettivamente fatto Claude. Le richieste di rete bloccate, gli strumenti dei connettori mancanti e gli errori nel lavoro stesso compaiono lì anziché nell'indicatore di stato.

Modificare e controllare le attività pianificate

Dalla pagina di dettaglio puoi:

  • Fare clic su Run now per avviare subito un'esecuzione senza attendere il prossimo orario pianificato.
  • Usare l'interruttore on/off in cima alla pagina per mettere in pausa o riprendere la pianificazione. Le attività in pausa mantengono la loro configurazione ma non vengono eseguite finché non le riattivi.
  • Aprire il menu accanto al nome dell'attività e selezionare Edit per modificare il nome, il prompt, i repository, l'ambiente, i connettori o uno qualsiasi dei trigger dell'attività. La finestra di dialogo Edit scheduled task si apre con lo stesso layout della finestra di dialogo di creazione. Per aggiungere un trigger, fai clic su + nella riga Trigger. Fai clic su Save changes per applicare le modifiche. Le azioni sui token API hanno effetto immediato, senza Save changes.
  • Aprire lo stesso menu e selezionare Delete per eliminare l'attività.

Gestire le attività pianificate dalla CLI

Esegui /schedule list per vedere le tue attività pianificate, /schedule update per modificarne una o /schedule run per avviarne una immediatamente.

Puoi anche chiedere informazioni sulla cronologia delle esecuzioni di un'attività pianificata, ad esempio /schedule why did my nightly review do nothing this morning?. Claude elenca le esecuzioni recenti dell'attività con il loro stato e un link per aprire ogni esecuzione sul web. Legge anche il log di un'esecuzione per spiegare cosa è successo, inclusi errori degli strumenti, permessi negati e il risultato finale. Richiede Claude Code v2.1.227 o successivo.

Repository e permessi sui branch

Le attività pianificate hanno bisogno dell'accesso a GitHub per clonare i repository. Quando crei un'attività pianificata dalla CLI con /schedule, Claude verifica se il tuo account ha accesso a GitHub per il repository da cui l'hai eseguito. Se non lo ha, Claude aggiunge una nota di configurazione che indica come concederlo.

[!NOTE]

Consulta Opzioni di autenticazione GitHub per i due modi di concedere l'accesso. Nei piani Team ed Enterprise, un Owner della tua organizzazione Claude deve attivare ciascun metodo prima che tu possa usarlo; consulta Connettere GitHub.

Se la tua connessione GitHub manca o è scaduta quando è prevista un'esecuzione, l'attività pianificata salta le esecuzioni finché non ti riconnetti, per un massimo di 72 ore. Riconnetti GitHub entro quella finestra e l'attività riprende da sola. Dopo 72 ore senza connessione, l'attività si disattiva e dovrai riattivarla dopo aver riconnesso GitHub.

Ogni repository che aggiungi viene clonato a ogni esecuzione. Claude parte dal branch predefinito del repository a meno che il tuo prompt non specifichi diversamente. Se un evento pull request di GitHub attiva l'esecuzione e il repository della pull request è il primo repository dell'attività, quel repository parte invece dal commit di testa della pull request.

Claude esegue il push del suo lavoro su un branch con prefisso claude/ a meno che il tuo prompt non gli indichi di eseguire il push su un altro branch. Per controllare su quali branch un'esecuzione può eseguire il push, usa le regole di protezione dei branch o i ruleset su GitHub. Per le esecuzioni sull'infrastruttura gestita da Anthropic, e per le esecuzioni self-hosted che eseguono il push tramite il proxy git di Anthropic, GitHub le applica all'accesso GitHub che hai connesso, quindi una regola che quell'accesso può aggirare non blocca il push di un'esecuzione. Un'esecuzione self-hosted che esegue il push con le credenziali git fornite dal tuo deploy viene invece verificata rispetto a quelle. Consulta Configurare git.

Connettori

Le attività pianificate possono utilizzare i tuoi connettori MCP connessi per leggere e scrivere su servizi esterni durante ogni esecuzione. Ad esempio, un'attività che smista le richieste di supporto potrebbe leggere da un canale Slack e creare issue in Linear.

I connettori sono le integrazioni di claude.ai sul tuo account. I server MCP che hai aggiunto localmente nella CLI con claude mcp add sono archiviati sulla tua macchina anziché sul tuo account claude.ai, quindi non compaiono nell'elenco dei connettori. Per usare uno di questi server in un'attività pianificata:

  • Come connettore: aggiungilo come connettore su claude.ai/customize/connectors
  • Nel repository: per un'attività pianificata con un solo repository, puoi invece dichiarare il server in un .mcp.json di cui è stato fatto il commit, così fa parte del repository clonato

Quando crei un'attività pianificata, tutti i connettori attualmente connessi vengono inclusi per impostazione predefinita. Rimuovi quelli non necessari per limitare gli strumenti a cui Claude ha accesso durante l'esecuzione. Puoi anche aggiungere connettori direttamente dalla finestra di dialogo di creazione o modifica dell'attività.

Per gestire o aggiungere connettori al di fuori di quella finestra di dialogo, visita claude.ai/customize/connectors oppure usa /schedule update nella CLI.

Quando un'esecuzione pubblica un artefatto senza chiedere

Quando la pianificazione di un'attività pianificata o Run now avvia un'esecuzione, Claude può pubblicare un nuovo artefatto senza chiedere. Il nuovo artefatto è visibile solo a te finché non lo condividi. Se la pubblicazione dichiara capacità di runtime per la pagina, come chiamate ai connettori o download di file, Claude chiede prima.

In queste esecuzioni, Claude ripubblica un artefatto esistente senza chiedere solo quando tutte queste condizioni sono soddisfatte:

  • Puoi modificare l'artefatto e questo appartiene alla tua organizzazione
  • Se la pubblicazione include più della sola pagina, ad esempio file di supporto, l'artefatto è di tua proprietà
  • L'artefatto non è condiviso pubblicamente
  • Se l'artefatto è condiviso con persone specifiche o con la tua organizzazione, chi lo visualizza non vede automaticamente ogni nuova versione
  • La pubblicazione non sovrascrive forzatamente una versione più recente
  • La pubblicazione non dichiara capacità di runtime per la pagina
  • La pagina esistente non contiene alcuna concessione che vada oltre la pagina stessa, come le chiamate ai connettori

In tutti gli altri casi, incluse le esecuzioni avviate da un trigger API o GitHub, Claude chiede prima.

Quando il compito di un'attività pianificata è mantenere aggiornata una pagina, forniscile un artefatto che hai già pubblicato.

Ambienti e accesso alla rete

Ogni attività pianificata utilizza un ambiente cloud che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione. L'attività eredita la policy di rete dell'ambiente a ogni esecuzione.

L'ambiente Default utilizza l'accesso alla rete Trusted, che consente solo l'allowlist predefinita attraverso la rete della sessione. Le richieste su quel percorso verso host al di fuori dell'allowlist non riescono con 403 e x-deny-reason: host_not_allowed. Il traffico dei connettori MCP viene instradato attraverso i server di Anthropic anziché su quel percorso, quindi i connettori che aggiungi all'attività funzionano senza aggiungere i loro host in Allowed domains. Rimuovi i connettori che non ti servono in Connettori.

Per consentire domini aggiuntivi su uno dei tuoi ambienti, segui questi passaggi. Un ambiente condiviso dall'organizzazione si apre qui in sola lettura, quindi è un Owner a modificarne l'accesso alla rete dalla pagina Cloud environments nelle impostazioni di amministrazione.

1. Apri l'attività per la modifica

Vai su claude.ai/code/routines, fai clic sull'attività pianificata, quindi apri il menu accanto al suo nome e seleziona Edit. Si apre la finestra di dialogo Edit scheduled task.

2. Apri il selettore dell'ambiente

Vai in Advanced settings > General > Cloud environment, espandendo prima Advanced settings se è compresso. Fai clic sull'icona cloud che mostra il nome del tuo ambiente, ad esempio Default.

3. Apri le impostazioni dell'ambiente

Passa il mouse sull'ambiente nell'elenco e fai clic sull'icona delle impostazioni che compare a destra.

4. Modifica il livello di accesso alla rete

Nella finestra di dialogo Edit cloud environment, imposta Network access su Custom e inserisci i tuoi domini in Allowed domains. Seleziona Also include default list of common package managers per mantenere l'allowlist predefinita insieme ai tuoi domini personalizzati. Seleziona invece Full per un accesso senza restrizioni.

5. Salva

Fai clic su Save changes nella finestra di dialogo Edit cloud environment, quindi chiudi la finestra di dialogo Edit scheduled task sottostante. La nuova policy si applica dalla prossima esecuzione.

Consulta Accesso alla rete per i dettagli sui livelli di accesso e sull'allowlist predefinita.

Utilizzo e limiti

Le attività pianificate consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive. Consulta il tuo consumo attuale su claude.ai/settings/usage.

Separatamente dall'utilizzo dell'abbonamento, ogni modo di avviare un'esecuzione ha un limite orario:

Azione Limite Conteggiato per Oltre il limite
Esecuzioni pianificate, incluse le esecuzioni una tantum 100 all'ora Il tuo account L'esecuzione attende fino al ripristino del limite
Run now, attivazioni API e reimpostazione di un'attività una tantum per eseguirla di nuovo 30 all'ora Ogni attività pianificata, un unico conteggio condiviso da tutte e tre L'azione non riesce fino al ripristino del limite
Run now e reimpostazione di un'attività una tantum per eseguirla di nuovo 100 all'ora Il tuo account Come sopra
Attivazioni API 100 all'ora Il tuo account, conteggiato separatamente da Run now Come sopra
Eventi GitHub Consulta Aggiungere un trigger GitHub

Nessuno di questi limiti orari prevede eccedenze.

Quando un'attività pianificata raggiunge il limite di utilizzo del tuo abbonamento, le organizzazioni con i crediti di utilizzo attivati possono continuare a eseguire attività pianificate con eccedenza a consumo. Senza crediti di utilizzo, le esecuzioni aggiuntive vengono rifiutate fino al ripristino della finestra di utilizzo. Attiva i crediti di utilizzo su claude.ai/settings/usage. Nei piani Team ed Enterprise, un amministratore li attiva per l'organizzazione su claude.ai/admin-settings/usage.

Mentre il tuo abbonamento è in pausa, le tue attività pianificate vengono sospese e non vengono eseguite. Quando l'abbonamento torna attivo, riattivale.

Dove compare ancora il nome routine

In precedenza le attività pianificate si chiamavano routine, e i seguenti punti mantengono il nome precedente. Ognuno si riferisce alla stessa funzionalità:

  • Indirizzo web: claude.ai/code/routines
  • CLI: l'alias /routines per /schedule, la descrizione del comando e le risposte di Claude mentre configura un'attività
  • API: il percorso dell'endpoint /fire, la sua intestazione beta, il type della risposta, il tag <routine-fire-payload> e la pagina di riferimento Trigger a routine through the API
  • Impostazioni dell'organizzazione: l'interruttore Scheduled tasks (Was Routines)

Risoluzione dei problemi

/schedule restituisce "Unknown command"

La CLI nasconde /schedule quando uno dei suoi requisiti non è soddisfatto: il menu dei comandi mostra No commands match "/schedule" mentre digiti. L'invio restituisce Unknown command: /schedule, tranne nei casi sottostanti che indicano una risposta diversa.

La causa è solitamente una delle seguenti:

  • Sei autenticato con una chiave API Console, un profilo Anthropic o una credenziale di federazione, oppure un provider cloud come Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. /schedule richiede un accesso con abbonamento claude.ai. Con una chiave API Console o un profilo, e con il recupero dei feature flag abilitato, l'invio di /schedule mostra invece /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access. Con un accesso tramite provider cloud, vedi comunque Unknown command: /schedule. Se ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN è impostato nella tua shell, oppure apiKeyHelper è impostato in settings.json, rimuovilo prima, poiché questi hanno la precedenza su un accesso claude.ai. Anche un profilo o una credenziale di federazione ha la precedenza, quindi disattiva anche quello
  • Hai effettuato completamente il logout, senza chiave API o altra credenziale. Con il recupero dei feature flag abilitato, l'invio di /schedule mostra /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. Prima della v2.1.268, una sessione senza accesso mostrava lo stesso messaggio Claude for Enterprise di una chiave API Console
  • Ti trovi all'interno di una sessione cloud, dove l'invio di /schedule risponde che il comando non è disponibile in quell'ambiente. Gestisci invece le attività pianificate dall'interfaccia web
  • La policy della tua organizzazione disabilita le sessioni cloud, che sono necessarie per le attività pianificate. In questo caso, l'invio di /schedule risponde invece Cloud sessions are disabled by your organization's policy. Prima della v2.1.268, restituiva Unknown command: /schedule
  • Un Owner ha disattivato le attività pianificate per la tua organizzazione Team o Enterprise. Prima della v2.1.227, in questo caso il comando compariva comunque e claude.ai rifiutava l'attività quando Claude tentava di crearla o eseguirla

A meno che la policy della tua organizzazione non disabiliti le attività pianificate o le sessioni cloud, puoi creare e gestire le attività pianificate su claude.ai/code/routines indipendentemente da come è configurata la CLI.

"Routines are disabled by your organization's policy"

Probabilmente un Owner della tua organizzazione Team o Enterprise ha disattivato l'interruttore Scheduled tasks (Was Routines) in Organization settings > Capabilities > Remote sessions. Su Claude Code v2.1.227 o successivo, lo stesso interruttore nasconde anche /schedule nella CLI. Si tratta di un'impostazione dell'organizzazione lato server, quindi non può essere sovrascritta dalla tua configurazione locale. Chiedi a un Owner di riattivare le attività pianificate per la tua organizzazione.

Risorse correlate

  • /loop e pianificazione all'interno della sessione: pianifica attività locali all'interno di una sessione CLI aperta
  • Attività pianificate di Desktop: attività pianificate locali che vengono eseguite sulla tua macchina con accesso ai file locali
  • Ambienti cloud: configura l'accesso alla rete, le variabili d'ambiente e gli script di configurazione per le sessioni cloud
  • Progetti: lavoro continuativo che Claude coordina tra sessioni cloud parallele; le attività pianificate create da un progetto compaiono nella sua scheda Scheduled tasks
  • Connettori MCP: connetti servizi esterni come Slack, Linear e Google Drive
  • GitHub Actions: esegui Claude nella tua pipeline CI in risposta agli eventi del repository