SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 85 additions and 47 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
Prompt di autorizzazione No (esecuzione autonoma) Configurabile per attività Eredita dalla sessione
Pianificazione personalizzabile Via /schedule nella CLI Sì Sì
Intervallo minimo 1 ora 1 minuto 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 e la scheda Trigger offre i preset elencati in Opzioni di pianificazione.

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.

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. Custom accetta un'espressione cron. Per gli altri 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. Il modulo Edit dell'attività offre anche Manual.

  • 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

Per intervalli che il selettore non offre, come ogni 15 minuti, il primo di ogni mese o un'esecuzione singola a un'ora futura specifica, chiedi a Claude in qualsiasi sessione Desktop di impostare la pianificazione. Usa il linguaggio naturale; ad esempio, "pianifica un'attività per eseguire tutti i test ogni 6 ore."

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.

Quando un'attività locale si attiva, una nuova sessione appare sotto una sezione Scheduled nella barra laterale. Aprila per vedere cosa ha fatto Claude, rivedere le modifiche o 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 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à manuale 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à.

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à 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.md dell'attività e i dati associati da ~/.claude/scheduled-tasks/.

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