Le attività pianificate avviano una nuova sessione automaticamente a un’ora e una frequenza che scegli. Usale per lavori ricorrenti come revisioni del codice giornaliere, controlli degli aggiornamenti delle dipendenze o briefing mattutini che estraggono dati dal tuo calendario e dalla tua posta in arrivo. La pagina Routines dell’app Desktop ti consente di creare sia attività pianificate locali che routine remote. Un’attività locale viene eseguita sulla tua macchina con accesso diretto ai tuoi file e strumenti, ma si attiva solo mentre l’app è aperta e il tuo computer è sveglio. Una routine remota viene eseguita su infrastrutture cloud gestite da Anthropic anche quando il tuo computer è spento e può anche attivarsi su chiamate API o eventi GitHub. Questa pagina copre le attività pianificate locali; per le routine remote e le loro opzioni di attivazione, vedi Routines.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Confronta le opzioni di pianificazione
Claude Code offers three ways to schedule recurring or one-off work:| Cloud | Desktop | /loop | |
|---|---|---|---|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | Restored on --resume if unexpired |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | Config files and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via /schedule in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
Per impostazione predefinita, le attività pianificate vengono eseguite rispetto a qualsiasi stato si trovi la tua directory di lavoro, incluse le modifiche non sottoposte a commit. Abilita l’interruttore worktree quando crei l’attività per dare a ogni esecuzione il suo proprio worktree Git isolato, nello stesso modo in cui funzionano le sessioni parallele.
Crea un’attività pianificata
Fai clic su Routines nella barra laterale, quindi fai clic su New routine e scegli Local. Configura questi campi:| Campo | Descrizione |
|---|---|
| Name | Identificatore per l’attività. Convertito in kebab-case minuscolo e utilizzato come nome della cartella su disco. Deve essere univoco tra le tue attività. |
| Description | Breve riepilogo mostrato nell’elenco delle attività. |
| Instructions | Cosa Claude dovrebbe fare quando l’attività viene eseguita. Scrivi questo nello stesso modo in cui scriveresti qualsiasi messaggio nella casella del prompt. L’input delle istruzioni include selettori per la modalità di autorizzazione e il modello, e sotto di esso selezioni la cartella di lavoro e se eseguire in un worktree isolato. |
| Schedule | Con quale frequenza viene eseguita l’attività. Vedi opzioni di pianificazione di seguito. |
Opzioni di pianificazione
Scegli un preset dal controllo Schedule:- Manual: nessuna pianificazione, viene eseguita solo quando fai clic su Run now. Utile per salvare un prompt che attivi su richiesta
- Hourly: viene eseguita ogni ora
- Daily: mostra un selettore di ora, per impostazione predefinita alle 9:00 AM ora locale
- Weekdays: come Daily ma salta sabato e domenica
- Weekly: mostra un selettore di ora e un selettore di giorno
Come vengono eseguite le attività pianificate
Le attività pianificate vengono eseguite sulla tua macchina. Desktop controlla la pianificazione ogni minuto mentre l’app è aperta e avvia una sessione nuova quando un’attività è dovuta, indipendentemente da qualsiasi sessione manuale che hai aperta. Ogni attività riceve un piccolo ritardo di pochi minuti dopo l’ora pianificata per scaglionare il traffico API. Il ritardo è deterministico: la stessa attività inizia sempre allo stesso offset. Quando un’attività si attiva, ricevi una notifica desktop e una nuova sessione appare sotto una sezione Scheduled nella barra laterale. Aprila per vedere cosa ha fatto Claude, rivedere le modifiche o rispondere ai prompt di autorizzazione. La sessione funziona come qualsiasi altra: Claude può modificare file, eseguire comandi, creare commit e aprire pull request. Le attività vengono eseguite solo mentre l’app desktop è in esecuzione e il tuo computer è sveglio. Se il tuo computer dorme durante un’ora pianificata, l’esecuzione viene saltata. Per impedire il sonno inattivo, abilita Keep computer awake in Impostazioni sotto Desktop app → General. Chiudere il coperchio del laptop lo mette comunque in modalità sospensione. Per attività che devono essere eseguite anche quando il tuo computer è spento, o che dovrebbero attivarsi su una chiamata API o un evento GitHub, crea invece una routine remota.Esecuzioni mancate
Quando l’app si avvia o il tuo computer si riattiva, Desktop controlla se ogni attività ha perso esecuzioni negli ultimi sette giorni. Se lo ha fatto, Desktop avvia esattamente un’esecuzione di recupero per l’ora più recentemente mancata e scarta tutto ciò che è più vecchio. Un’attività giornaliera che ha perso sei giorni viene eseguita una volta al risveglio. Desktop mostra una notifica quando inizia un’esecuzione di recupero. Tieni questo in mente quando scrivi i prompt. Un’attività pianificata per le 9 potrebbe essere eseguita alle 23 se il tuo computer è stato in sospensione tutto il giorno. Se il timing è importante, aggiungi protezioni al prompt stesso, ad esempio: “Rivedi solo i commit di oggi. Se è dopo le 17, salta la revisione e pubblica solo un riepilogo di ciò che è stato perso.”Autorizzazioni per le attività pianificate
Ogni attività ha la sua propria modalità di autorizzazione, che imposti quando crei o modifichi l’attività. Le regole di autorizzazione da~/.claude/settings.json si applicano anche alle sessioni di attività pianificate. Se un’attività viene eseguita in modalità Ask e ha bisogno di eseguire uno strumento per il quale non ha autorizzazione, l’esecuzione si blocca fino a quando non la approvi. La sessione rimane aperta nella barra laterale in modo da poter rispondere in seguito.
Per evitare blocchi, fai clic su Run now dopo aver creato un’attività, guarda i prompt di autorizzazione e seleziona “always allow” per ognuno. Le esecuzioni future di quell’attività approvano automaticamente gli stessi strumenti senza chiedere. Puoi rivedere e revocare queste approvazioni dalla pagina dei dettagli dell’attività.
Gestisci le attività pianificate
Fai clic su un’attività nell’elenco Routines per aprire la sua pagina di dettaglio. Da qui puoi:- Run now: avvia l’attività immediatamente senza aspettare l’ora pianificata successiva
- Status: attiva/disattiva tra Active e Paused per mettere in pausa o riprendere le esecuzioni pianificate senza eliminare l’attività
- Edit: modifica le istruzioni, la pianificazione, la cartella o altre impostazioni
- Review history: vedi ogni esecuzione passata, incluse le esecuzioni saltate. Passa il mouse su una voce saltata per vedere il motivo: il tuo computer era in sospensione, l’esecuzione precedente era ancora in corso o altre attività pianificate erano già in esecuzione. Fai clic su Show more per caricare voci più vecchie.
- Review allowed permissions: vedi e revoca le approvazioni degli strumenti salvate per questa attività dal pannello Always allowed
- Delete: rimuovi l’attività e archivia tutte le sessioni che ha creato. Una casella di controllo Also delete files on disk appare nella finestra di dialogo di conferma; selezionala per rimuovere anche il file
SKILL.mddell’attività e i dati associati da~/.claude/scheduled-tasks/.
update_scheduled_task. Questo consente a un’attività di ripianificarsi in base a ciò che trova, ad esempio, ripianificando una revisione del codice per essere eseguita prima quando rileva che è stato creato un ramo di rilascio.
Per modificare il prompt di un’attività su disco, apri ~/.claude/scheduled-tasks/<task-name>/SKILL.md (o sotto CLAUDE_CONFIG_DIR se impostato). Il file utilizza frontmatter YAML per name e description, con il prompt come corpo. Le modifiche hanno effetto alla prossima esecuzione. La pianificazione, la cartella, il modello e lo stato abilitato non sono in questo file: modificali tramite il modulo Edit o chiedi a Claude.
Risorse correlate
- Routines: esegui attività su infrastrutture gestite da Anthropic su una pianificazione, tramite chiamata API o in risposta a eventi GitHub, anche quando il tuo computer è spento
- Run prompts on a schedule: pianificazione con ambito di sessione con
/loopnella CLI - Claude Code GitHub Actions: esegui Claude su una pianificazione in CI invece che sulla tua macchina
- Use Claude Code Desktop: la guida completa dell’app Desktop