Pianificare attività ricorrenti in Claude Code Desktop

Configura attività pianificate in Claude Code Desktop per eseguire Claude automaticamente su base ricorrente per revisioni del codice giornaliere, audit delle dipendenze o briefing mattutini.

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 Scheduled tasks dell'app Desktop elenca sia le attività pianificate locali sia le attività pianificate cloud, precedentemente chiamate routine:

• 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
• Attività cloud: viene eseguita anche quando il tuo computer è spento e può anche avviarsi su chiamate API o eventi GitHub

Questa pagina copre le attività pianificate locali; per le attività pianificate cloud e le loro opzioni di attivazione, consulta Automatizzare il lavoro con le attività pianificate.

[!NOTE]

Se la tua app mostra la funzionalità con il suo nome precedente, fai clic su Routines ovunque questa pagina indichi Scheduled e su New routine dove indica New task.

Confronta le opzioni di pianificazione

Claude Code offre tre modi per pianificare lavori ricorrenti o una tantum:

[!TIP]

Utilizzate attività cloud per lavori che devono essere eseguiti in modo affidabile senza la vostra macchina. Utilizzate attività Desktop quando avete bisogno di accesso ai file e agli strumenti locali. Utilizzate /loop per il polling rapido durante una sessione.

[!NOTE]

Per impostazione predefinita, le attività pianificate locali vengono eseguite rispetto a qualsiasi stato si trovi la tua directory di lavoro, incluse le modifiche non sottoposte a commit. Per dare invece a ogni esecuzione il suo proprio worktree Git isolato, seleziona Worktree nel modulo Edit dell'attività dopo averla creata. La casella di controllo è disponibile quando la cartella dell'attività è un repository Git.

Crea un'attività pianificata

Le attività pianificate locali richiedono Claude Desktop 1.1.5368 o versioni successive.

1. Apri la pagina Scheduled tasks

Nella scheda Code, fai clic su Scheduled nella barra laterale o nel menu More della barra laterale. Se la barra laterale mostra Routines invece di Scheduled, fai clic su Routines, poi su New routine, e prosegui con Modulo a pagina intera.

2. Avvia una nuova attività

Fai clic su New task per aprire la finestra di dialogo New scheduled task. Prima di continuare, verifica la presenza di queste schermate:

• Se si apre un menu con Create with Claude e Set up manually, seleziona Set up manually per aprire la finestra di dialogo.
• Se Only on this computer si trova in cima alla finestra di dialogo, vai a Finestra di dialogo con Only on this computer in cima prima di inserire qualsiasi cosa.
• Se si apre un menu con Local e Cloud, oppure si apre una pagina intera al posto della finestra di dialogo, vai a Modulo a pagina intera.

3. Dai un nome all'attività

Inserisci un nome nel campo Name. Desktop lo converte in kebab-case minuscolo e lo utilizza come nome della cartella dell'attività su disco, quindi il nome deve essere univoco tra le tue attività.

4. Scrivi le istruzioni

Nella casella sotto il nome, inserisci cosa Claude dovrebbe fare quando l'attività viene eseguita.

5. Attiva Only on this computer

Per ora salta la scheda Trigger ed espandi Advanced settings sotto di essa. Nella scheda General, attiva Only on this computer. Con questa opzione attiva, l'attività viene eseguita sulla tua macchina in una cartella locale.

Se l'interruttore non è disponibile, rimuovi il repository o il trigger di evento GitHub o API, perché questi rendono l'attività un'attività pianificata cloud.

6. Scegli la cartella locale

Nella riga Local folder, seleziona una cartella. Create rimane non disponibile finché non ne scegli una.

7. Imposta la pianificazione

Tornando alla scheda Trigger, seleziona un preset di pianificazione.

8. Scegli la modalità di permesso e il modello

Nella barra degli strumenti della casella delle istruzioni, seleziona una modalità di permesso e un modello. Se li lasci invariati, le esecuzioni utilizzano le tue impostazioni di Claude Code e il modello predefinito.

9. Crea l'attività

Fai clic su Create. Se non hai ancora considerato attendibile la cartella, Desktop ti chiede di considerarla attendibile a questo punto. Si apre la pagina dei dettagli dell'attività.

Nella pagina dei dettagli, fai clic sull'icona a forma di matita per aprire il modulo Edit. Lì puoi modificare la Description che Desktop ha compilato a partire dalle tue istruzioni, selezionare Worktree o impostare la pianificazione su Manual o Custom.

Puoi anche creare un'attività descrivendo quello che vuoi in qualsiasi sessione. Ad esempio, "configura una revisione del codice giornaliera che viene eseguita ogni mattina alle 9" crea un'attività ricorrente. Una richiesta come "ricordami alle 15 domani di controllare il deploy" crea un'attività una tantum che si disabilita dopo che si attiva.

Finestra di dialogo con Only on this computer in cima

Se Only on this computer si trova in cima alla finestra di dialogo New scheduled task quando si apre, attivalo prima di inserire qualsiasi cosa. Quando lo attivi, un modulo vuoto separato per un'attività locale sostituisce il modulo.

Poi compila i campi del modulo locale:

• Name: inserisci un nome, come nei passaggi per creare un'attività pianificata.
• Description: inserisci una descrizione. Create rimane non disponibile finché non lo fai.
• La casella delle istruzioni: inserisci cosa Claude dovrebbe fare quando l'attività viene eseguita. Seleziona la modalità di permesso e il modello dai menu nella casella.
• Working folder: seleziona la cartella in cui viene eseguita l'attività. Create rimane non disponibile finché non ne selezioni una.
• Trigger: seleziona una pianificazione. Per i preset, consulta Opzioni di pianificazione.

Fai clic su Create. Si apre la pagina dei dettagli dell'attività.

Modulo a pagina intera

Se si apre un menu con Local e Cloud, seleziona Local. Si apre una pagina intitolata New local routine o New local scheduled task. Compila i suoi campi:

• Name: inserisci un nome univoco tra le tue attività.
• Description: inseriscine una.
• Instructions: inserisci cosa Claude dovrebbe fare quando l'attività viene eseguita. Nella stessa casella, seleziona la modalità di permesso, il modello e la cartella in cui viene eseguita l'attività.
• Schedule: seleziona una delle opzioni di pianificazione.

Se Create non è disponibile, passaci sopra con il puntatore per vedere cosa manca ancora nel modulo. Fai clic su Create e si apre la pagina dei dettagli dell'attività.

Opzioni di pianificazione

Quando attivi Only on this computer in Advanced settings, la scheda Trigger offre Hourly, Daily, Weekdays e Weekly. Per ottenere Manual o Custom per un'attività di questo tipo, apri il suo modulo Edit dopo averla creata. Quel modulo, la finestra di dialogo con Only on this computer in alto e il modulo a pagina intera offrono queste sei opzioni:

• Hourly: viene eseguita ogni ora
• Daily: viene eseguita ogni giorno all'ora locale che scegli
• Weekdays: come Daily ma salta sabato e domenica
• Weekly: mostra un selettore di ora e un selettore di giorno
• Manual: nessuna pianificazione, viene eseguita solo quando fai clic su Run now. Utile per salvare un prompt che attivi su richiesta
• Custom: viene eseguita secondo un'espressione cron che inserisci e che viene valutata nella tua ora locale, come 0 9 * * * per le 9:00 di ogni giorno. Scrivi i giorni della settimana e i mesi come numeri, poiché i loro nomi non sono accettati. La domenica è 0, non 7. Il modulo rifiuta un'espressione che viene eseguita più spesso di una volta all'ora.

Puoi anche chiedere a Claude in qualsiasi sessione Desktop di impostare la pianificazione. Claude non è vincolato al limite di una volta all'ora e può impostare un'esecuzione singola a un'ora futura. Ad esempio, chiedi "esegui la suite di test ogni 30 minuti" oppure "lunedì prossimo alle 9, riassumi le pull request unite da venerdì."

Come vengono eseguite le attività pianificate

Le attività pianificate locali 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.

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, attiva Keep computer awake in Settings > Desktop app o in Settings > This computer > System. Chiudere il coperchio del laptop lo mette comunque in modalità sospensione.

[!NOTE]

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 un'attività pianificata cloud.

Trovare la sessione di un'esecuzione

Per aprire la sessione avviata da un'esecuzione, vai alla pagina dei dettagli dell'attività e fai clic sulla riga di quell'esecuzione nell'elenco History.

L'elenco delle sessioni nella barra laterale può mostrare anche un gruppo Scheduled, con una riga per ogni attività. Per aprire la sessione dell'ultima esecuzione di un'attività, fai clic sulla riga dell'attività in quel gruppo. Per mostrare il gruppo, verifica quale layout hai:

• Layout attuale: apri il menu Group and sort, seleziona Show, poi seleziona Scheduled. Il gruppo è inizialmente compresso, quindi fai clic sulla sua intestazione per espanderlo. Show elenca Scheduled quando almeno una delle tue attività è Active, lo Status mostrato nella pagina dei dettagli di un'attività. Se non è elencato, usa l'elenco History, che funziona indipendentemente dal fatto che il gruppo sia visibile o meno.
• Layout precedente: il gruppo si trova nell'elenco delle sessioni senza bisogno di attivare nulla

Nella sessione di un'esecuzione, in qualunque modo tu vi sia arrivato, puoi vedere cosa ha fatto Claude, rivedere le modifiche e rispondere alle richieste di permesso. Claude può modificare file, eseguire comandi, creare commit e aprire pull request, come in una sessione che avvii tu stesso.

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 un riepilogo di ciò che è stato perso."

Autorizzazioni per le attività pianificate

Ogni attività ha la sua propria modalità di permesso, che imposti quando crei o modifichi l'attività. Le regole allow da ~/.claude/settings.json si applicano anche alle sessioni di attività pianificate. Quando un'esecuzione è bloccata su una richiesta di permesso, trova la sessione dell'esecuzione e rispondi lì alla richiesta.

Per evitare blocchi, fai clic su Run now dopo aver creato un'attività, fai attenzione alle richieste di permesso e seleziona "always allow" per ognuna. Le esecuzioni future saltano la maggior parte di queste richieste. Puoi rivedere e revocare queste approvazioni dalla pagina dei dettagli dell'attività. Se selezioni "always allow" per una modifica di file nella cartella dell'attività, solo quella sessione passa a Accept edits, quindi imposta la modalità di permesso dell'attività su Accept edits.

Gli strumenti MCP contrassegnati requiresUserInteraction richiedono un prompt ad ogni chiamata e non offrono un'opzione "always allow". Le esecuzioni che chiamano questi strumenti si bloccano ogni volta.

Gestisci le attività pianificate

Nella scheda Code, fai clic su Scheduled nella barra laterale, quindi fai clic su un'attività nell'elenco 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à. Le sessioni create dall'attività vengono archiviate, non eliminate. La cartella che contiene il file SKILL.md dell'attività rimane su disco in ~/.claude/scheduled-tasks/<task-name>/, oppure in scheduled-tasks/<task-name>/ sotto CLAUDE_CONFIG_DIR se hai impostato quella variabile. Per rimuovere quella cartella, eliminala manualmente.

Puoi anche elencare, creare, modificare e mettere in pausa le attività chiedendo a Claude in qualsiasi sessione Desktop. Ad esempio, "pausa la mia attività dependency-audit" o "mostrami le mie attività pianificate." Per eliminare un'attività, usa il pulsante Delete sulla sua pagina di dettaglio.

Per consentire a un'attività di modificare la propria pianificazione o il proprio prompt con lo strumento MCP update_scheduled_task, fai clic su Run now e approva la chiamata ogni volta.

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

• Attività pianificate nel cloud: esegui attività nel cloud 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 /loop nella 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