SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 19 additions and 19 deletions.

2026
Sat 3 23:57 Tue 6 23:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Tue 27 22:59

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.

Confronta le opzioni di pianificazione

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

Cloud Desktop /loop
Esecuzione su Cloud, gestito da Anthropic per impostazione predefinita La vostra macchina La vostra macchina
Richiede macchina accesa No Sì Sì
Richiede sessione aperta No No Sì
Persistente tra i riavvii Sì Sì Ripristinato su --resume, con eccezioni
Accesso ai file locali No (clone fresco) Sì Sì
MCP servers Connettori configurati per attività File di configurazione e connettori Eredita dalla sessione
Richieste di permesso Modalità auto per impostazione predefinita Configurabile per attività Eredita dalla sessione
Pianificazione personalizzabile Sì Sì Sì
Intervallo minimo 1 ora 1 minuto quando lo imposta Claude, 1 ora nei moduli 1 minuto

[!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.

2. Avvia una nuova attività

Fai clic su New task. Se si apre un menu con Create with Claude e Set up manually, seleziona Set up manually. Si apre la finestra di dialogo New scheduled task. 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.

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à.

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 e la finestra di dialogo con Only on this computer in alto 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 > 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. Se un'attività viene eseguita in modalità manuale e ha bisogno di eseguire uno strumento per il quale non ha il permesso, l'esecuzione si blocca fino a quando non la approvi. Per approvarla, trova la sessione dell'esecuzione e rispondi lì alla richiesta di permesso.

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à.

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.

Un'attività pianificata può anche modificare la sua propria pianificazione o prompt da una sessione in esecuzione utilizzando lo strumento MCP 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