Una sessione cloud è una sessione Claude Code che viene eseguita su infrastruttura cloud anziché sulla tua macchina, lavorando con il codice dai tuoi repository GitHub. Puoi avviarne una da Claude Code sul web su claude.ai/code, da Claude Mobile, da Claude Desktop, o dal tuo terminale con claude --cloud. Questo articolo spiega come funzionano le sessioni cloud, quando usarle al posto di una sessione locale nel tuo terminale o IDE, e quali flussi di lavoro abilitano.
Cosa offrono le sessioni cloud
Le sessioni cloud ti permettono di delegare a Claude attività che vengono eseguite senza la tua supervisione attiva. Selezioni un repository GitHub, descrivi cosa vuoi che venga fatto, e Claude lavora sull'attività nel cloud. Una volta che Claude Code ha iniziato a lavorare su un'attività, puoi lasciare completamente la pagina; Claude continuerà il suo lavoro. Al termine, Claude creerà automaticamente una pull request con le modifiche per te da revisionare.
Questa funzione funziona con repository che potresti non avere sulla tua macchina locale. Puoi avviare attività su qualsiasi repository GitHub a cui hai accesso senza doverlo clonare localmente o configurare un ambiente di sviluppo. Questo la rende utile per progetti a cui contribuisci occasionalmente o per esplorare basi di codice che stai ancora imparando.
Le sessioni cloud abilitano flussi di lavoro di sviluppo asincroni. In una sessione locale nel tuo terminale o editor, in genere lavori in modo sincrono: fai una richiesta, aspetti che Claude risponda, rivedi le modifiche, poi fai un'altra richiesta. Il lavoro sincrono come questo ti dà un controllo granulare ma richiede la tua attenzione durante tutto il processo. Una sessione cloud funziona diversamente: puoi assegnare un'attività più grande, lasciare che Claude lavori indipendentemente, e tornare più tardi per revisionare il lavoro completato.
Puoi anche eseguire più attività in parallelo. Poiché ogni attività viene eseguita nel suo ambiente isolato, puoi avere Claude che lavora su diversi problemi o repository contemporaneamente. Ogni attività procede indipendentemente e crea la sua pull request al completamento. Più di un'attività può lavorare sullo stesso repository contemporaneamente.
Come funziona
Quando avvii una sessione cloud, Claude Code crea una macchina virtuale isolata per il tuo lavoro. Il tuo repository GitHub viene clonato in questo ambiente, che viene preconfigurato con strumenti di sviluppo comuni e ecosistemi di linguaggio.
Claude prepara l'ambiente eseguendo i comandi di configurazione che hai definito nella configurazione del tuo repository. Questo include l'installazione delle dipendenze, la configurazione dei database, o l'esecuzione di altri passaggi di inizializzazione di cui il tuo progetto ha bisogno. Se la tua attività richiede accesso alla rete, magari per installare pacchetti o recuperare dati, puoi configurare il livello di accesso a Internet che l'ambiente ha.
Una volta che l'ambiente è pronto, Claude inizia a lavorare sulla tua attività. Claude legge il tuo codice, apporta modifiche, scrive test, ed esegue comandi per verificare il lavoro. Puoi monitorare i progressi e fornire indicazioni tramite l'interfaccia web se necessario.
Quando Claude completa l'attività, esegue il push delle modifiche a un nuovo ramo nel tuo repository GitHub. Ricevi una notifica e puoi revisionare le modifiche, quindi creare una pull request direttamente dall'interfaccia. La pull request include tutto il lavoro di Claude, pronto per la tua revisione e per eventuali modifiche aggiuntive che desideri apportare.
Ogni attività viene eseguita in completo isolamento. La macchina virtuale esiste solo per quella specifica attività e include controlli di sicurezza come accesso alla rete limitato e gestione delle credenziali protetta. La tua autenticazione GitHub viene gestita tramite un proxy sicuro, quindi le credenziali non esistono mai direttamente nell'ambiente in cui Claude sta lavorando.
Quando usare sessioni cloud vs. sessioni locali
Alcune attività sono adatte a essere eseguite in modo asincrono nel cloud, mentre altre sono meglio eseguite localmente nel tuo terminale o IDE.
Usa sessioni cloud per:
Attività ben definite con requisiti chiari: Quando puoi descrivere esattamente cosa deve essere fatto e non ti aspetti di dover guidare Claude a metà dell'attività, una sessione cloud ti permette di avviare il lavoro e tornare quando è completo.
Lavoro in background su backlog di bug: Puoi assegnare a Claude più problemi dal tuo backlog e lasciarli eseguire in parallelo. Ogni attività procede indipendentemente, permettendoti di affrontare diversi fix contemporaneamente senza monitorare ognuno individualmente.
Repository che non hai localmente: Se hai bisogno di apportare modifiche a un repository che non hai clonato o che non vuoi configurare sulla tua macchina, una sessione cloud gestisce la configurazione dell'ambiente per te.
Attività che vuoi mettere in coda: Quando hai un elenco di modifiche da apportare ma non vuoi lavorarci adesso, puoi avviarle nel cloud e revisionare i risultati più tardi. Questo ti permette di raggruppare lavoro simile o delegare attività durante i momenti in cui sei concentrato su qualcos'altro.
Usa sessioni locali nel tuo terminale o IDE per:
Attività che richiedono frequenti correzioni di rotta: Quando non sei sicuro esattamente quale sia l'approccio giusto o ti aspetti di dover reindirizzare Claude in base a quello che vedi, lavorare nel tuo terminale ti dà un feedback immediato. Puoi regolare la direzione mentre Claude lavora anziché aspettare un risultato completo.
Lavoro esplorativo con requisiti poco chiari: Se stai capendo come risolvere un problema o investigando diversi approcci, il terminale ti permette di affinare la tua richiesta mentre impari. Lo scambio bidirezionale aiuta a chiarire i requisiti che non erano ovvi all'inizio.
Sviluppo locale con modifiche non committate: Quando stai sviluppando attivamente e hai lavoro non committato nel tuo repository locale, usare Claude Code nel tuo terminale mantiene tutto in un unico posto. Puoi iterare rapidamente sulle modifiche senza doverle committare o pushare se non sono ancora pronte.
Attività che richiedono feedback immediato: Se hai bisogno di vedere i risultati rapidamente e vuoi iterare velocemente, il terminale fornisce una latenza inferiore. Puoi guardare Claude lavorare in tempo reale e fermarti o reindirizzare se qualcosa va storto all'inizio del processo.
Esempi di casi d'uso
Modifiche backend con sviluppo guidato dai test
Lascia che Claude scriva test che definiscono il comportamento atteso, quindi implementa il codice per far passare quei test. Questo funziona particolarmente bene per le modifiche backend dove il comportamento può essere validato attraverso test automatizzati.
Prompt di esempio:
Add rate limiting to the /api/search endpoint.
The rate limiter should:
- Allow 100 requests per minute per API key
- Return 429 status when limit exceeded
- Reset limits after 60 seconds
- Track different API keys independently
Use a TDD approach: write comprehensive tests first, then implement the rate limiting logic to pass them.
Quando usare questo approccio: Questo funziona bene in una sessione cloud perché i test danno a Claude criteri di validazione chiari verso cui lavorare. Non hai bisogno di monitorare i progressi di Claude poiché i test cattureranno i problemi e guideranno l'iterazione verso una soluzione funzionante. La natura autonoma dell'attività, dove Claude scrive test e poi li fa passare, non richiede il tuo input una volta avviata.
Cosa rende questo efficace: Claude può iterare sull'implementazione senza la tua supervisione, usando i fallimenti dei test per identificare e correggere i problemi. L'attività dura più a lungo di un semplice cambio di codice, ma puoi lasciarla completare in background. Quando rivedi la pull request, sia i test che l'implementazione sono pronti, e hai fiducia che la soluzione funziona perché i test passano.
Aggiornamenti della documentazione
Genera o aggiorna documentazione tecnica come file README, documentazione API, commenti al codice, o guide utente.
Prompt di esempio:
Update CHANGELOG.md with all changes since the v2.3.0 release:
- Review commits on main branch since that tag.
- Categorize changes into "Added, "Changed, "Fixed", and "Removed" sections.
- Include the commit hash for each entry.
Quando usare questo approccio: Gli aggiornamenti del changelog sono ben adatti a una sessione cloud perché Claude può revisionare la cronologia dei commit indipendentemente e formattare le voci senza indicazioni. L'attività è noiosa da fare manualmente ma abbastanza semplice che Claude può completarla senza domande su quali commit includere o come categorizzarli.
Cosa rende questo efficace: Puoi delegare l'intero aggiornamento del changelog e revisionare il risultato al completamento. Claude legge i commit, estrae i cambiamenti significativi, e segue il tuo formato changelog esistente.
Refactoring con ambito chiaro
Ristruttura il codice per migliorare l'organizzazione o la leggibilità quando puoi definire confini chiari per il cambiamento. Questo include l'estrazione di codice, la divisione di file grandi, o l'organizzazione della struttura del modulo.
Prompt di esempio:
The UserService class in /src/services/user.go has 800 lines long.
Split it into three focused services:
- UserAuthService (login/logout/sessions)
- UserProfileService (profile CRUD operations)
- UserPreferencesService (settings/preferences)
Ensure all tests still pass.
Quando usare questo approccio: Il refactoring con vincoli chiari funziona bene in una sessione cloud perché puoi impostare confini chiari per Claude da seguire. Le suite di test possono fornire validazione, permettendo a Claude di verificare che il refactor non abbia rotto alcuna funzionalità esistente.
Cosa rende questo efficace: L'attività richiede tempo, ma non ha bisogno del tuo input attivo una volta che la struttura è definita. Puoi avviare il refactor e revisionare il risultato organizzato più tardi, anziché monitorare Claude mentre lavora attraverso l'attività. L'ambito chiaro significa che Claude è improbabile che abbia bisogno di indicazioni a metà dell'attività.
Suggerimenti per un uso efficace
Considera di aggiungere una suite di test al tuo repository in modo che Claude possa più facilmente verificare di aver completato con successo un'attività
Specifica i criteri di successo anziché obiettivi vaghi come "migliorare" o "correggere"
Definisci cosa dovrebbe cambiare e cosa dovrebbe rimanere uguale nel tuo prompt
Delimita le attività con confini chiari in modo che Claude non abbia bisogno di indicazioni a metà dell'attività
Se stai pensando "Avrò bisogno di vedere come va prima", considera di usare il tuo terminale
Usa "Apri in CLI" se realizzi a metà dell'attività che hai bisogno di fornire indicazioni