Vai al contenuto principale
Claude Code sul web è in anteprima di ricerca per gli utenti Pro, Max e Team, e per gli utenti Enterprise con posti premium o posti Chat + Claude Code.
Claude Code sul web esegue attività su infrastruttura cloud gestita da Anthropic su claude.ai/code. Le sessioni persistono anche se chiudi il browser e puoi monitorarle dall’app mobile Claude.
Nuovo a Claude Code sul web? Inizia con Guida introduttiva per connettere il tuo account GitHub e inviare il tuo primo compito.
Questa pagina copre:

Opzioni di autenticazione GitHub

Le sessioni cloud hanno bisogno di accesso ai tuoi repository GitHub per clonare il codice e inviare i rami. Puoi concedere l’accesso in due modi:
Con entrambi i metodi, una sessione cloud può accedere a qualsiasi repository che l’account GitHub connesso può vedere, non solo ai repository su cui è installata l’app Claude GitHub. L’installazione dell’app abilita i webhook PR per Auto-fix; non è un controllo di accesso a livello di sessione. Per limitare quali repository il tuo team può raggiungere dalle sessioni cloud, limita l’accesso su GitHub stesso, ad esempio limitando l’appartenenza al team o al repository per gli account GitHub connessi.
Entrambi i metodi funzionano. /schedule verifica entrambe le forme di accesso e ti chiede di eseguire /web-setup se nessuna è configurata. Vedi Connetti dal tuo terminale per la procedura dettagliata di /web-setup. L’app GitHub è richiesta per Auto-fix, che utilizza l’app per ricevere webhook PR. Se ti connetti con /web-setup e successivamente desideri Auto-fix, installa l’app su quei repository. Gli amministratori di Team e Enterprise possono disabilitare /web-setup con l’interruttore Quick web setup su claude.ai/admin-settings/claude-code.
Le organizzazioni con Zero Data Retention abilitato non possono utilizzare /web-setup o altre funzionalità di sessione cloud.

L’ambiente cloud

Ogni sessione viene eseguita in una VM gestita da Anthropic appena creata con il tuo repository clonato. Questa sezione copre cosa è disponibile quando una sessione inizia e come personalizzarlo.

Cosa è disponibile nelle sessioni cloud

Le sessioni cloud iniziano da un clone appena creato del tuo repository. Qualsiasi cosa sottoposta a commit nel repository è disponibile. Qualsiasi cosa che hai installato o configurato solo sulla tua macchina non lo è; la politica della tua organizzazione arriva separatamente attraverso impostazioni gestite dal server. Per rendere la tua configurazione disponibile nelle sessioni cloud, eseguine il commit nel repository; la politica dell’organizzazione arriva separatamente attraverso impostazioni gestite dal server. Un archivio di segreti dedicato non è ancora disponibile. Sia le variabili di ambiente che gli script di configurazione sono archiviati nella configurazione dell’ambiente, visibili a chiunque possa modificare quell’ambiente. Se hai bisogno di segreti in una sessione cloud, aggiungili come variabili di ambiente con quella visibilità in mente.

Strumenti installati

Le sessioni cloud vengono fornite con runtime di linguaggio comuni, strumenti di compilazione e database preinstallati. La tabella seguente riassume cosa è incluso per categoria. ¹ Bun è installato ma ha problemi di compatibilità proxy noti per il recupero dei pacchetti. Per le versioni esatte, chiedi a Claude di eseguire check-tools in una sessione cloud. Questo comando esiste solo nelle sessioni cloud.

Lavora con i problemi e le pull request di GitHub

Le sessioni cloud includono strumenti GitHub integrati che consentono a Claude di leggere i problemi, elencare le pull request, recuperare i diff e pubblicare commenti senza alcuna configurazione. Questi strumenti si autenticano tramite il proxy GitHub utilizzando il metodo che hai configurato in Opzioni di autenticazione GitHub, quindi il tuo token non entra mai nel contenitore. Puoi impostare GH_TOKEN o GITHUB_TOKEN tu stesso nelle impostazioni dell’ambiente, oppure lasciare entrambi non impostati e lasciare che il proxy GitHub si autentichi per te:
  • Se imposti un token, viene passato al contenitore invariato, quindi gh e i tuoi script lo usano direttamente.
  • Se non imposti nessuno dei due, il contenitore imposta entrambe le variabili sulla stringa segnaposto proxy-injected e il proxy sostituisce le tue credenziali reali sulle richieste GitHub in uscita. gh funziona senza un token tuo, ma uno script che legge GITHUB_TOKEN direttamente ottiene il segnaposto, non un token utilizzabile.
Per verificare quale caso si applica alla tua sessione, chiedi a Claude di eseguire echo $GH_TOKEN. La CLI gh non è preinstallata. Se hai bisogno di un comando gh che gli strumenti integrati non coprono, come gh release o gh workflow run, installalo e autenticalo tu stesso:
1

Installa gh nel tuo script di configurazione

Aggiungi apt update && apt install -y gh al tuo script di configurazione.
2

Fornisci un token se il proxy non sta gestendo l'autenticazione

Se echo $GH_TOKEN stampa proxy-injected, il proxy GitHub autentica gh per te e questo passaggio è non necessario. Altrimenti, aggiungi una variabile di ambiente GH_TOKEN alle tue impostazioni dell’ambiente con un token di accesso personale GitHub. gh legge GH_TOKEN automaticamente, quindi non è necessario alcun passaggio gh auth login.
Ogni sessione cloud ha un URL di trascrizione su claude.ai e la sessione può leggere il suo ID dalla variabile di ambiente CLAUDE_CODE_REMOTE_SESSION_ID. Usa questo per mettere un link tracciabile nei corpi PR, nei messaggi di commit, nei post Slack o nei report generati in modo che un revisore possa aprire l’esecuzione che li ha prodotti. A partire dalla v2.1.179, i commit che Claude crea in una sessione web includono un trailer git Claude-Session: <url> e i corpi PR includono l’URL della sessione su una riga propria. Da v2.1.182, imposta attribution.sessionUrl su false per omettere il trailer e il link nel corpo PR. Per includere il link della sessione in qualcosa di diverso da un commit o PR, come un messaggio Slack che Claude pubblica o un file di report che scrive, chiedi a Claude di eseguire il seguente comando e usa il suo output. Il comando converte il prefisso cse_ nel valore della variabile di ambiente al prefisso session_ che l’URL di trascrizione si aspetta:

Esegui test, avvia servizi e aggiungi pacchetti

Claude esegue i test come parte del lavoro su un compito. Chiedilo nel tuo prompt, come “correggi i test falliti in tests/” o “esegui pytest dopo ogni modifica.” I test runner come pytest, jest e cargo test sono preinstallati e funzionano senza configurazione aggiuntiva. PostgreSQL e Redis sono preinstallati ma non in esecuzione per impostazione predefinita. Chiedi a Claude di avviare ognuno durante la sessione:
Docker è disponibile per l’esecuzione di servizi containerizzati. Chiedi a Claude di eseguire docker compose up per avviare i servizi del tuo progetto. L’accesso alla rete per il pull delle immagini segue il livello di accesso del tuo ambiente e i Trusted defaults includono Docker Hub e altri registri comuni. Se le tue immagini sono grandi o lente da estrarre, aggiungi docker compose pull o docker compose build al tuo script di configurazione. Le immagini estratte vengono salvate nell’ambiente memorizzato nella cache, quindi ogni nuova sessione le ha su disco. La cache memorizza solo i file, non i processi in esecuzione, quindi Claude avvia comunque i contenitori ogni sessione. Per aggiungere pacchetti che non sono preinstallati, usa uno script di configurazione. L’output dello script è memorizzato nella cache, quindi i pacchetti che installi lì sono disponibili all’inizio di ogni sessione senza reinstallare ogni volta. Puoi anche chiedere a Claude di installare pacchetti durante la sessione, ma quelle installazioni non persistono tra le sessioni.

Limiti di risorse

Le sessioni cloud vengono eseguite con limiti di risorse approssimativi che possono cambiare nel tempo:
  • 4 vCPU
  • 16 GB di RAM
  • 30 GB di disco
I compiti che richiedono significativamente più memoria, come grandi lavori di compilazione o test ad alta intensità di memoria, potrebbero fallire o essere terminati. Per carichi di lavoro oltre questi limiti, usa Remote Control per eseguire Claude Code sul tuo hardware.

Configura il tuo ambiente

Gli ambienti controllano l’accesso alla rete, le variabili di ambiente e lo script di configurazione che viene eseguito prima che una sessione inizi. Vedi Strumenti installati per cosa è disponibile senza alcuna configurazione. Puoi gestire gli ambienti dall’interfaccia web o dal terminale: Le variabili di ambiente usano il formato .env con una coppia KEY=value per riga. Non racchiudere i valori tra virgolette, poiché le virgolette vengono archiviate come parte del valore. Questo esempio definisce tre variabili:

Ambienti condivisi dall’organizzazione

I proprietari e gli amministratori nei piani Team ed Enterprise possono creare ambienti cloud che vengono condivisi con ogni membro dell’organizzazione. Gli ambienti condivisi appaiono nel selettore dell’ambiente di ogni membro insieme ai loro ambienti personali, quindi un team può standardizzare su una configurazione invece di ricrearne una per ogni membro. Gestisci gli ambienti condivisi dalla pagina Cloud environments nelle impostazioni di amministrazione. Da lì puoi: I valori in un ambiente condiviso raggiungono le sessioni di ogni membro in quell’ambiente. Come gli ambienti personali, gli ambienti condivisi non hanno un archivio di segreti dedicato, quindi non includere segreti. Le organizzazioni nel programma di runner self-hosted gestiscono anche i loro pool di runner dalla stessa pagina.

Script di configurazione

Uno script di configurazione è uno script Bash che viene eseguito quando inizia una nuova sessione cloud, prima che Claude Code si avvii. Usa gli script di configurazione per installare dipendenze, configurare strumenti o recuperare qualsiasi cosa di cui la sessione ha bisogno che non sia preinstallata. Gli script vengono eseguiti come root su Ubuntu 24.04, quindi apt install e la maggior parte dei gestori di pacchetti di linguaggio funzionano. Per aggiungere uno script di configurazione, apri la finestra di dialogo delle impostazioni dell’ambiente e inserisci il tuo script nel campo Setup script. Questo esempio installa la CLI gh, che non è preinstallata:
Se lo script esce con un codice diverso da zero, la sessione non si avvia. Aggiungi || true ai comandi non critici per evitare di bloccare la sessione su un’installazione intermittente fallita. Mantieni il tempo di esecuzione totale dello script sotto circa cinque minuti in modo che la cache dell’ambiente possa essere costruita. Esegui installazioni indipendenti in parallelo con & e wait. Se un singolo download non rientra nel limite di cinque minuti, spostalo in un hook SessionStart che lo avvia in background.
Gli script di configurazione che installano pacchetti hanno bisogno di accesso alla rete per raggiungere i registri. L’accesso alla rete predefinito Trusted consente connessioni ai domini di pacchetti comuni inclusi npm, PyPI, RubyGems e crates.io. Gli script non riusciranno a installare pacchetti se il tuo ambiente usa l’accesso alla rete None.

Memorizzazione nella cache dell’ambiente

Lo script di configurazione viene eseguito la prima volta che avvii una sessione in un ambiente. Dopo il completamento, Anthropic crea uno snapshot del file system e riutilizza quello snapshot come punto di partenza per le sessioni successive. Le nuove sessioni iniziano con le tue dipendenze, strumenti e immagini Docker già su disco e il passaggio dello script di configurazione viene saltato. Questo mantiene l’avvio veloce anche quando lo script installa grandi toolchain o estrae immagini di contenitori. La cache acquisisce i file, non i processi in esecuzione. Qualsiasi cosa che lo script di configurazione scrive su disco viene trasferita. I servizi o i contenitori che avvia non lo fanno, quindi avvia quelli per sessione chiedendo a Claude o con un hook SessionStart. Lo script di configurazione viene eseguito di nuovo per ricostruire la cache quando modifichi lo script di configurazione dell’ambiente o gli host di rete consentiti e quando la cache raggiunge la sua scadenza dopo circa sette giorni. Riprendere una sessione esistente non esegue mai di nuovo lo script di configurazione. Non è necessario abilitare la memorizzazione nella cache o gestire gli snapshot tu stesso.

Script di configurazione vs. hook SessionStart

Usa uno script di configurazione per installare cose di cui il cloud ha bisogno ma il tuo laptop ha già, come un runtime di linguaggio o uno strumento CLI. Usa un hook SessionStart per la configurazione del progetto che dovrebbe essere eseguita ovunque, cloud e locale, come npm install. Entrambi vengono eseguiti all’inizio di una sessione, ma appartengono a posti diversi: Gli hook SessionStart possono anche essere definiti nel tuo ~/.claude/settings.json a livello di utente localmente, ma le impostazioni a livello di utente non vengono trasferite alle sessioni cloud. Nel cloud, gli hook provengono dal repository e dalle impostazioni gestite dal server della tua organizzazione.

Installa le dipendenze con un hook SessionStart

Per installare le dipendenze solo nelle sessioni cloud, aggiungi un hook SessionStart al .claude/settings.json del tuo repository:
Crea lo script in scripts/install_pkgs.sh e rendilo eseguibile con chmod +x. La variabile di ambiente CLAUDE_CODE_REMOTE è impostata su true nelle sessioni cloud, quindi puoi usarla per saltare l’esecuzione locale:
Gli hook SessionStart hanno alcune limitazioni nelle sessioni cloud:
  • Nessun ambito solo cloud: gli hook vengono eseguiti sia nelle sessioni locali che cloud. Per saltare l’esecuzione locale, controlla la variabile di ambiente CLAUDE_CODE_REMOTE come mostrato sopra.
  • Richiede accesso alla rete: i comandi di installazione hanno bisogno di raggiungere i registri di pacchetti. Se il tuo ambiente usa l’accesso alla rete None, questi hook falliranno. L’elenco di consentiti predefinito sotto Trusted copre npm, PyPI, RubyGems e crates.io.
  • Compatibilità proxy: tutto il traffico in uscita passa attraverso un proxy di sicurezza. Alcuni gestori di pacchetti non funzionano correttamente con questo proxy. Bun è un esempio noto.
  • Aggiunge latenza di avvio: gli hook vengono eseguiti ogni volta che una sessione si avvia o riprende, a differenza degli script di configurazione che beneficiano della memorizzazione nella cache dell’ambiente. Mantieni gli script di installazione veloci controllando se le dipendenze sono già presenti prima di reinstallarle.
Per persistere le variabili di ambiente per i comandi Bash successivi, scrivi nel file in $CLAUDE_ENV_FILE. Vedi Hook SessionStart per i dettagli. La sostituzione dell’immagine di base con la tua immagine Docker non è ancora supportata. Usa uno script di configurazione per installare quello di cui hai bisogno sopra l’immagine fornita o esegui la tua immagine come contenitore insieme a Claude con docker compose.

Accesso alla rete

L’accesso alla rete controlla le connessioni in uscita dall’ambiente cloud. Ogni ambiente specifica un livello di accesso e puoi estenderlo con domini personalizzati consentiti. Il predefinito è Trusted, che consente i registri di pacchetti e altri domini consentiti. Per modificare l’accesso alla rete di un ambiente, aprilo per la modifica e usa il selettore Network access nella finestra di dialogo. Non esiste una pagina Ambienti separata. L’icona cloud appare ovunque tu avvii una sessione cloud o configuri una routine.
Il traffico del connettore MCP viene instradato attraverso i server di Anthropic, quindi i connettori che abiliti su una sessione o routine funzionano senza aggiungere i loro host ai Domini consentiti. I connettori sono configurati per sessione o per routine; rimuovi quelli che non hai bisogno di limitare quali strumenti Claude può raggiungere. Questo si basa sullo stesso canale legato ad Anthropic notato in Sicurezza e isolamento.

Livelli di accesso

Scegli un livello di accesso quando crei o modifichi un ambiente: Le operazioni GitHub usano un proxy separato che è indipendente da questa impostazione.

Consenti domini specifici

Per consentire domini che non sono nell’elenco Trusted, seleziona Custom nelle impostazioni di accesso alla rete dell’ambiente. Appare un campo Allowed domains. Inserisci un dominio per riga:
Usa *. per la corrispondenza dei sottodomini con caratteri jolly. Seleziona Also include default list of common package managers per mantenere i domini Trusted insieme alle tue voci personalizzate, o lascialo deselezionato per consentire solo quello che elenchi. I domini consentiti sono configurati per ambiente. Non esiste un elenco di consentiti a livello di organizzazione che i Proprietari possono inviare agli ambienti di tutti gli utenti; le impostazioni gestite dal server possono limitare le sessioni cloud ma non possono aggiungere domini consentiti.

Proxy GitHub

Per motivi di sicurezza, tutte le operazioni GitHub passano attraverso un servizio proxy dedicato che mantiene le tue credenziali GitHub reali al di fuori della sandbox. Il proxy autentica due tipi di traffico:
  • Interazioni Git: il client git all’interno della sandbox utilizza una credenziale con ambito personalizzato, che il proxy verifica e traduce nel tuo token di autenticazione GitHub effettivo
  • Richieste API GitHub: il proxy sostituisce le tue credenziali reali sulle richieste dagli strumenti GitHub integrati e da gh quando la tua sessione imposta il placeholder proxy-injected descritto in Lavora con i problemi e le richieste pull di GitHub
Il proxy limita anche le operazioni git push al ramo di lavoro attuale per motivi di sicurezza e abilita il clonaggio, il recupero e le operazioni PR mantenendo i confini di sicurezza. Il proxy limita le richieste API GitHub e di asset di rilascio ai repository collegati alla sessione, indipendentemente dal livello di accesso alla rete dell’ambiente. Gli script di configurazione che scaricano asset di rilascio da repository non collegati restituiscono un 403. I file sottoposti a commit da repository pubblici vengono recuperati tramite raw.githubusercontent.com, che il proxy di sicurezza gestisce invece. Quel dominio è nell’elenco predefinito Trusted, quindi i file rimangono raggiungibili a meno che il livello di accesso dell’ambiente non lo escluda.

Proxy di sicurezza

Gli ambienti vengono eseguiti dietro un proxy di rete HTTP/HTTPS per motivi di sicurezza e prevenzione degli abusi. Tutto il traffico Internet in uscita passa attraverso questo proxy, che fornisce:
  • Protezione contro richieste dannose
  • Limitazione della velocità e prevenzione degli abusi
  • Filtro dei contenuti per una sicurezza migliorata
  • Un audit trail a livello DNS dei nomi host richiesti

Domini consentiti predefiniti

Quando si utilizza l’accesso alla rete Trusted, i seguenti domini sono consentiti per impostazione predefinita. I domini contrassegnati con * indicano la corrispondenza dei sottodomini con caratteri jolly, quindi *.gcr.io consente qualsiasi sottodominio di gcr.io.
  • api.anthropic.com
  • statsig.anthropic.com
  • docs.claude.com
  • platform.claude.com
  • code.claude.com
  • claude.ai
  • github.com
  • www.github.com
  • api.github.com
  • npm.pkg.github.com
  • raw.githubusercontent.com
  • pkg-npm.githubusercontent.com
  • objects.githubusercontent.com
  • release-assets.githubusercontent.com
  • codeload.github.com
  • avatars.githubusercontent.com
  • camo.githubusercontent.com
  • gist.github.com
  • gitlab.com
  • www.gitlab.com
  • registry.gitlab.com
  • bitbucket.org
  • www.bitbucket.org
  • api.bitbucket.org
  • registry-1.docker.io
  • auth.docker.io
  • index.docker.io
  • hub.docker.com
  • www.docker.com
  • production.cloudflare.docker.com
  • download.docker.com
  • gcr.io
  • *.gcr.io
  • ghcr.io
  • mcr.microsoft.com
  • *.data.mcr.microsoft.com
  • public.ecr.aws
  • cloud.google.com
  • accounts.google.com
  • gcloud.google.com
  • *.googleapis.com
  • storage.googleapis.com
  • compute.googleapis.com
  • container.googleapis.com
  • azure.com
  • portal.azure.com
  • microsoft.com
  • www.microsoft.com
  • *.microsoftonline.com
  • packages.microsoft.com
  • dotnet.microsoft.com
  • dot.net
  • visualstudio.com
  • dev.azure.com
  • *.amazonaws.com
  • *.api.aws
  • oracle.com
  • www.oracle.com
  • java.com
  • www.java.com
  • java.net
  • www.java.net
  • download.oracle.com
  • yum.oracle.com
  • proxy.golang.org
  • sum.golang.org
  • index.golang.org
  • golang.org
  • www.golang.org
  • goproxy.io
  • pkg.go.dev
  • maven.org
  • repo.maven.org
  • central.maven.org
  • repo1.maven.org
  • repo.maven.apache.org
  • jcenter.bintray.com
  • gradle.org
  • www.gradle.org
  • services.gradle.org
  • plugins.gradle.org
  • kotlinlang.org
  • www.kotlinlang.org
  • spring.io
  • repo.spring.io
  • dl.k8s.io (Kubernetes)
  • pkgs.k8s.io
  • k8s.io
  • www.k8s.io
  • releases.hashicorp.com (HashiCorp)
  • apt.releases.hashicorp.com
  • rpm.releases.hashicorp.com
  • archive.releases.hashicorp.com
  • hashicorp.com
  • www.hashicorp.com
  • repo.anaconda.com (Anaconda/Conda)
  • conda.anaconda.org
  • anaconda.org
  • www.anaconda.com
  • anaconda.com
  • continuum.io
  • apache.org (Apache)
  • www.apache.org
  • archive.apache.org
  • downloads.apache.org
  • eclipse.org (Eclipse)
  • www.eclipse.org
  • download.eclipse.org
  • nodejs.org (Node.js)
  • www.nodejs.org
  • developer.apple.com
  • developer.android.com
  • pkg.stainless.com
  • binaries.prisma.sh
  • statsig.com
  • www.statsig.com
  • api.statsig.com
  • sentry.io
  • *.sentry.io
  • downloads.sentry-cdn.com
  • http-intake.logs.datadoghq.com
  • browser-intake-us5-datadoghq.com
  • *.datadoghq.com
  • *.datadoghq.eu
  • api.honeycomb.io
  • sourceforge.net
  • *.sourceforge.net
  • packagecloud.io
  • *.packagecloud.io
  • fonts.googleapis.com
  • fonts.gstatic.com
  • *.modelcontextprotocol.io

Sposta attività tra web e terminale

Questi flussi di lavoro richiedono la Claude Code CLI connessa allo stesso account claude.ai. Puoi avviare nuove sessioni cloud dal tuo terminale o estrarre sessioni cloud nel tuo terminale per continuare localmente. Le sessioni cloud persistono anche se chiudi il tuo laptop e puoi monitorarle da qualsiasi luogo inclusa l’app mobile Claude.
Dalla CLI, l’handoff della sessione è unidirezionale: puoi estrarre sessioni cloud nel tuo terminale con --teleport, ma non puoi inviare una sessione terminale esistente al web. Il flag --cloud crea una nuova sessione cloud per il tuo repository attuale. L’app Desktop fornisce un menu Continua in che può inviare una sessione locale al web.

Dal terminale al web

Avvia una sessione cloud dalla riga di comando con il flag --cloud:
Questo crea una nuova sessione cloud su claude.ai. La sessione clona il remoto GitHub della tua directory attuale al tuo ramo attuale, quindi esegui il push prima se hai commit locali, poiché la VM clona da GitHub piuttosto che dalla tua macchina. --cloud funziona con un singolo repository alla volta. L’attività viene eseguita nel cloud mentre continui a lavorare localmente. L’ortografia più vecchia --remote funziona ancora come alias deprecato per --cloud. A partire dalla v2.1.195, la CLI mostra un elenco di controllo in tempo reale dei passaggi di configurazione, come la clonazione del repository e l’esecuzione dello script di configurazione, mentre il contenitore cloud si avvia. I messaggi che digiti mentre il contenitore è in fase di provisioning vengono messi in coda e inviati una volta che la sessione è pronta.
--cloud crea sessioni cloud. --remote-control non è correlato: espone una sessione CLI locale per il monitoraggio dal web. Vedi Remote Control.
Usa /tasks nella CLI Claude Code per controllare l’avanzamento, o apri la sessione su claude.ai o l’app mobile Claude per interagire direttamente. Da lì puoi guidare Claude, fornire feedback o rispondere a domande proprio come in qualsiasi altra conversazione.

Suggerimenti per attività cloud

Pianifica localmente, esegui da remoto: per attività complesse, avvia Claude in plan mode per collaborare sull’approccio, quindi invia il lavoro al cloud:
In plan mode, Claude legge i file, esegue comandi per esplorare e propone un piano senza modificare il codice sorgente. Una volta soddisfatto, salva il piano nel repository, esegui il commit e il push in modo che la VM cloud possa clonarlo. Quindi avvia una sessione cloud per l’esecuzione autonoma:
Questo modello ti dà il controllo sulla strategia mentre consente a Claude di eseguire autonomamente nel cloud. Pianifica nel cloud con ultraplan: per elaborare e rivedere il piano stesso in una sessione web, usa ultraplan. Claude genera il piano su Claude Code sul web mentre continui a lavorare, quindi commenti le sezioni nel tuo browser e scegli di eseguire da remoto o inviare il piano di nuovo al tuo terminale. Esegui attività in parallelo: ogni comando --cloud crea la sua propria sessione cloud che viene eseguita indipendentemente. Puoi avviare più attività e verranno tutte eseguite simultaneamente in sessioni separate:
Monitora tutte le sessioni con /tasks nella CLI Claude Code. Quando una sessione si completa, puoi creare una PR dall’interfaccia web o teletrasportare la sessione nel tuo terminale per continuare a lavorare.

Invia repository locali senza GitHub

Quando esegui claude --cloud da un repository che non è connesso a GitHub, Claude Code raggruppa il tuo repository locale e lo carica direttamente nella sessione cloud. Il bundle include la tua cronologia completa del repository su tutti i rami, più eventuali modifiche non sottoposte a commit ai file tracciati. Questo fallback si attiva automaticamente quando l’accesso a GitHub non è disponibile. Per forzarlo anche quando GitHub è connesso, imposta CCR_FORCE_BUNDLE=1:
I repository raggruppati devono soddisfare questi limiti:
  • La directory deve essere un repository git con almeno un commit
  • Il repository raggruppato deve essere inferiore a 100 MB. I repository più grandi ricadono nel raggruppamento solo del ramo attuale, quindi in uno snapshot squashed singolo dell’albero di lavoro e falliscono solo se lo snapshot è ancora troppo grande
  • I file non tracciati non sono inclusi; esegui git add sui file che desideri che la sessione cloud veda
  • Le sessioni create da un bundle non possono eseguire il push di nuovo a un remoto a meno che tu non abbia anche autenticazione GitHub configurata

Dal web al terminale

Estrai una sessione cloud nel tuo terminale usando uno di questi:
  • Usando --teleport: dalla riga di comando, esegui claude --teleport per un selettore di sessione interattivo, o claude --teleport <session-id> per riprendere una sessione specifica direttamente. Se hai modifiche non sottoposte a commit, ti verrà chiesto di archiviarle prima.
  • Usando /teleport: all’interno di una sessione CLI esistente, esegui /teleport o /tp per aprire lo stesso selettore di sessione senza riavviare Claude Code.
  • Da /tasks: esegui /tasks per vedere le tue sessioni in background, quindi premi t per teletrasportarti in una.
  • Dall’interfaccia web: seleziona Open in CLI per copiare un comando che puoi incollare nel tuo terminale.
Quando teletrasporti una sessione, Claude verifica che sei nel repository corretto, recupera e controlla il ramo dalla sessione cloud e carica la cronologia completa della conversazione nel tuo terminale. --teleport è distinto da --resume. --resume riapre una conversazione dalla cronologia locale di questa macchina e non elenca le sessioni cloud; --teleport estrae una sessione cloud e il suo ramo.

Requisiti per il teletrasporto

Il teletrasporto verifica questi requisiti prima di riprendere una sessione. Se un requisito non è soddisfatto, vedrai un errore o ti verrà chiesto di risolvere il problema.

--teleport non è disponibile

Il teletrasporto richiede l’autenticazione dell’abbonamento claude.ai. Se sei autenticato tramite chiave API, Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry, esegui /login per accedere con il tuo account claude.ai. Se sei già connesso tramite claude.ai e --teleport non è ancora disponibile, la tua organizzazione potrebbe aver disabilitato le sessioni cloud.

Lavora con le sessioni

Le sessioni appaiono nella barra laterale su claude.ai/code. Da lì puoi rivedere le modifiche, condividere con i compagni di squadra, archiviare il lavoro completato o eliminare le sessioni in modo permanente.

Gestisci il contesto

Le sessioni cloud supportano comandi integrati che producono output di testo. I comandi che vengono eseguiti solo nell’interfaccia del terminale, come /plugin o /resume, non sono disponibili. I comandi che aprono un selettore o un pannello nel terminale si comportano diversamente nelle sessioni cloud:
  • /model, /effort, /fast, /color e /rename: passa il valore come argomento, ad esempio /model sonnet, invece di aprire il selettore del terminale o il cursore. Le forme di argomento richiedono Claude Code v2.1.205 o successivo nell’ambiente della sessione e seguono le note di disponibilità di ogni comando: /effort segnala Not applied mentre il launch-default effort hold di un modello è in vigore, e /fast funziona solo in una sessione che è stata avviata con la modalità veloce attivata.
  • /config: sul web, apre la sezione Claude Code delle tue impostazioni invece di impostare un valore, e il testo dopo il comando, incluso key=value, viene ignorato. Per modificare le impostazioni per una sessione cloud, usa variabili di ambiente o esegui il commit dei file di impostazioni nel repository.
Per la gestione del contesto in particolare: L’auto-compattazione viene eseguita automaticamente quando la finestra di contesto si avvicina alla capacità. Per attivarla prima, imposta CLAUDE_AUTOCOMPACT_PCT_OVERRIDE nelle tue variabili di ambiente. Ad esempio, CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70 compatta al 70% della capacità invece di attendere fino a quando la finestra non è quasi piena. Per modificare la dimensione della finestra effettiva per i calcoli di compattazione, usa CLAUDE_CODE_AUTO_COMPACT_WINDOW. I subagent funzionano allo stesso modo che fanno localmente. Claude può generarli con lo strumento Task per scaricare la ricerca o il lavoro parallelo in una finestra di contesto separata, mantenendo la conversazione principale più leggera. I subagent definiti in .claude/agents/ del tuo repository vengono raccolti automaticamente. I team di agenti sono disabilitati per impostazione predefinita ma possono essere abilitati aggiungendo CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 alle tue variabili di ambiente.

Rivedi le modifiche

Ogni sessione mostra un indicatore diff con righe aggiunte e rimosse, come +42 -18. Selezionalo per aprire la vista diff, lascia commenti in linea su righe specifiche e inviali a Claude con il tuo prossimo messaggio. Vedi Rivedi e itera per la procedura dettagliata completa inclusa la creazione di PR. Per fare in modo che Claude monitori la PR per i fallimenti CI e i commenti di revisione automaticamente, vedi Correzione automatica delle pull request.

Condividi sessioni

Per condividere una sessione, attiva/disattiva la sua visibilità in base ai tipi di account di seguito. Dopo di che, condividi il link della sessione così com’è. I destinatari vedono lo stato più recente quando aprono il link, ma la loro vista non si aggiorna in tempo reale.

Condividi da un account Enterprise o Team

Per gli account Enterprise e Team, le due opzioni di visibilità sono Private e Team. La visibilità Team rende la sessione visibile agli altri membri della tua organizzazione claude.ai. Le sessioni Claude in Slack vengono condivise automaticamente con visibilità Team. La verifica dell’accesso al repository è abilitata per impostazione predefinita, in base all’account GitHub connesso all’account del destinatario. Il nome visualizzato del tuo account è visibile a tutti i destinatari con accesso.

Condividi da un account Max o Pro

Per gli account Max e Pro, le due opzioni di visibilità sono Private e Public. La visibilità Public rende la sessione visibile a qualsiasi utente connesso a claude.ai. Controlla la tua sessione per contenuti sensibili prima di condividere. Le sessioni possono contenere codice e credenziali da repository GitHub privati. La verifica dell’accesso al repository non è abilitata per impostazione predefinita. Per richiedere ai destinatari di avere accesso al repository o per nascondere il tuo nome dalle sessioni condivise, vai a Impostazioni > Claude Code > Impostazioni di condivisione.

Archivia sessioni

Puoi archiviare le sessioni per mantenere organizzato il tuo elenco di sessioni. Le sessioni archiviate sono nascoste dall’elenco di sessioni predefinito ma possono essere visualizzate filtrando le sessioni archiviate. Per archiviare una sessione, passa il mouse sulla sessione nella barra laterale e seleziona l’icona di archiviazione.

Elimina sessioni

L’eliminazione di una sessione rimuove permanentemente la sessione e i suoi dati. Questa azione non può essere annullata. Puoi eliminare una sessione in due modi:
  • Dalla barra laterale: filtra le sessioni archiviate, quindi passa il mouse sulla sessione che desideri eliminare e seleziona l’icona di eliminazione
  • Dal menu della sessione: apri una sessione, seleziona il menu a discesa accanto al titolo della sessione e seleziona Elimina
Ti verrà chiesto di confermare prima che una sessione venga eliminata.

Correzione automatica delle pull request

Claude può monitorare una pull request e rispondere automaticamente ai fallimenti CI e ai commenti di revisione. Claude si iscrive all’attività GitHub sulla PR e, quando un controllo fallisce o un revisore lascia un commento, Claude indaga e invia una correzione se una è chiara.
Auto-fix richiede che l’app Claude GitHub sia installata nel vostro repository. Se non l’avete già fatto, installatela dalla pagina dell’app GitHub o quando richiesto durante la configurazione.
Ci sono alcuni modi per attivare auto-fix a seconda da dove proviene la PR e quale dispositivo state utilizzando:
  • PR create in Claude Code sul web: aprite la barra di stato CI e selezionate Auto-fix
  • Dal vostro terminale: eseguite /autofix-pr mentre siete sul ramo della PR. Claude Code rileva la PR aperta con gh, genera una sessione web e attiva auto-fix in un passaggio
  • Dall’app mobile: dite a Claude di correggere automaticamente la PR, ad esempio “guarda questa PR e correggi eventuali fallimenti CI o commenti di revisione”
  • Qualsiasi PR esistente: incollate l’URL della PR in una sessione e dite a Claude di correggerla automaticamente
Auto-fix è un interruttore per PR. Per smettere di monitorare, aprite la barra di stato CI nella sessione web e deselezionate l’interruttore Auto-fix, oppure dite a Claude di smettere di monitorare la PR.

Come Claude risponde all’attività PR

Quando auto-fix è attivo, Claude riceve eventi GitHub per la PR inclusi nuovi commenti di revisione e fallimenti di controllo CI. Per ogni evento, Claude indaga e decide come procedere:
  • Correzioni chiare: se Claude è sicuro di una correzione e non entra in conflitto con le istruzioni precedenti, Claude apporta la modifica, la invia e spiega cosa è stato fatto nella sessione
  • Richieste ambigue: se il commento di un revisore potrebbe essere interpretato in più modi o coinvolge qualcosa di architettonicamente significativo, Claude vi chiede prima di agire
  • Eventi duplicati o senza azione: se un evento è un duplicato o non richiede modifiche, Claude lo annota nella sessione e continua
GitHub non emette un webhook quando il ramo base avanza e crea un conflitto di merge, quindi auto-fix non può reagire ai conflitti da solo. Per risolvere un conflitto, aprite la sessione e chiedete a Claude di eseguire il rebase. Claude potrebbe rispondere ai thread di commenti di revisione su GitHub come parte della loro risoluzione. Queste risposte vengono pubblicate utilizzando il vostro account GitHub, quindi appaiono sotto il vostro nome utente, ma ogni risposta è etichettata come proveniente da Claude Code in modo che i revisori sappiano che è stata scritta dall’agente e non da voi direttamente.
Se il vostro repository utilizza automazione attivata da commenti come Atlantis, Terraform Cloud o GitHub Actions personalizzate che vengono eseguite su eventi issue_comment, tenete presente che Claude può rispondere per vostro conto, il che può attivare questi flussi di lavoro. Rivedete l’automazione del vostro repository prima di abilitare auto-fix e considerate di disabilitare auto-fix per i repository in cui un commento PR può distribuire infrastruttura o eseguire operazioni privilegiate.

Sicurezza e isolamento

Ogni sessione cloud è separata dalla tua macchina e dalle altre sessioni attraverso diversi livelli:
  • Macchine virtuali isolate: ogni sessione viene eseguita in una VM isolata gestita da Anthropic
  • Controlli di accesso alla rete: l’accesso alla rete è limitato per impostazione predefinita e può essere disabilitato. Quando viene eseguito con l’accesso alla rete disabilitato, Claude Code può comunque comunicare con l’API Anthropic, che potrebbe consentire ai dati di uscire dalla VM.
  • Protezione delle credenziali: le credenziali sensibili come le credenziali git o le chiavi di firma non sono mai all’interno della sandbox con Claude Code. L’autenticazione viene gestita tramite un proxy sicuro utilizzando credenziali con ambito.
  • Analisi sicura: il codice viene analizzato e modificato all’interno di VM isolate prima di creare PR

Risoluzione dei problemi

Per gli errori API di runtime che appaiono nella conversazione come API Error: 500, 529 Overloaded, 429 o Prompt is too long, vedi il riferimento degli errori. Questi errori e le loro correzioni sono condivisi con la CLI e l’app Desktop. Le sezioni seguenti coprono i problemi specifici delle sessioni cloud.

Creazione della sessione non riuscita

Se una nuova sessione non si avvia con Session creation failed o si blocca al provisioning, Claude Code non ha potuto allocare un ambiente cloud.
  • Controlla status.claude.com per gli incidenti delle sessioni cloud
  • Riprova dopo un minuto, poiché la capacità viene fornita su richiesta
  • Conferma che il tuo repository sia raggiungibile. L’account GitHub che si connette deve avere accesso al repository su GitHub, tramite l’autorizzazione dell’app GitHub di Claude o un token gh sincronizzato tramite /web-setup. L’installazione dell’app sul repository non è richiesta. Vedi Opzioni di autenticazione GitHub.

Sessione Remote Control scaduta o accesso negato

--teleport si connette attraverso la stessa infrastruttura della sessione Remote Control che le sessioni cloud utilizzano, quindi gli errori di autenticazione e scadenza della sessione si presentano con la terminologia Remote Control. Potresti vedere Remote Control session expired o Access denied. Il token di connessione è di breve durata e limitato al tuo account.
  • Esegui /login localmente per aggiornare le tue credenziali, quindi riconnettiti
  • Conferma che sei connesso allo stesso account che possiede la sessione
  • Se vedi Remote Control may not be available for this organization, un Owner non ha abilitato le sessioni cloud per la tua organizzazione

Ambiente scaduto

Le sessioni cloud si fermano dopo un periodo di inattività e l’ambiente sottostante viene recuperato. Da un terminale locale, questo si presenta come Could not resume session ... its environment has expired. Creating a fresh session instead. Sul web, la sessione è contrassegnata come scaduta nell’elenco delle sessioni. Riapri la sessione da claude.ai/code per fornire un ambiente fresco con la cronologia della conversazione ripristinata.

Limitazioni

Prima di fare affidamento sulle sessioni cloud per un flusso di lavoro, tieni conto di questi vincoli:
  • Limiti di velocità: Claude Code sul web condivide i limiti di velocità con tutti gli altri utilizzi di Claude e Claude Code all’interno del tuo account. L’esecuzione di più attività in parallelo consuma più limiti di velocità proporzionalmente. Non esiste alcun addebito di calcolo separato per la VM cloud.
  • Autenticazione del repository: puoi spostare le sessioni da web a locale solo quando sei autenticato allo stesso account
  • Restrizioni della piattaforma: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di GitHub Enterprise Server sono supportate per i piani Team e Enterprise. GitLab, Bitbucket e altri repository non GitHub possono essere inviati alle sessioni cloud come bundle locale, ma la sessione non può eseguire il push dei risultati di nuovo al remoto
  • Elenco IP consentiti dell’organizzazione: le sessioni cloud chiamano l’API Anthropic dall’infrastruttura gestita da Anthropic, non dalla tua rete. Se la tua organizzazione ha IP allowlisting abilitato, ogni sessione cloud fallisce con un errore di autenticazione. Lo stesso vale per Code Review e Routines. Contatta il supporto Anthropic per esentare i servizi ospitati da Anthropic dall’elenco IP consentiti della tua organizzazione.
  • Ultraplan: elabora un piano in una sessione cloud e revisionalo nel tuo browser
  • Ultrareview: esegui una profonda revisione del codice multi-agente in una sandbox cloud
  • Routines: automatizza il lavoro su una pianificazione, tramite chiamata API o in risposta agli eventi GitHub
  • Configurazione degli hook: esegui script agli eventi del ciclo di vita della sessione
  • Riferimento delle impostazioni: tutte le opzioni di configurazione
  • Sicurezza: garanzie di isolamento e gestione dei dati
  • Utilizzo dei dati: cosa Anthropic conserva dalle sessioni cloud
  • Claude Tag: un @Claude gestito dall’organizzazione in Slack che viene eseguito nello stesso ambiente cloud