Usa Claude Code sul web

Configura ambienti cloud, script di configurazione, accesso alla rete e Docker nella sandbox di Anthropic. Sposta le sessioni tra web e terminale con --remote e --teleport.

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.

Questa pagina copre:

• Opzioni di autenticazione GitHub: due modi per connettere GitHub
• L'ambiente cloud: quale configurazione viene trasferita, quali strumenti sono installati e come configurare gli ambienti
• Script di configurazione e gestione delle dipendenze
• Accesso alla rete: livelli, proxy e l'elenco di consentiti predefinito
• Sposta attività tra web e terminale con --remote e --teleport
• Lavora con le sessioni: revisione, condivisione, archiviazione, eliminazione
• Correzione automatica delle pull request: rispondi automaticamente ai fallimenti CI e ai commenti di revisione
• Sicurezza e isolamento: come le sessioni sono isolate
• Limitazioni: limiti di velocità e restrizioni della piattaforma

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:

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.

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

Per rendere la configurazione disponibile nelle sessioni cloud, eseguine il commit nel repository. 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.

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:

Collega gli artefatti di nuovo alla sessione

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.

Il valore della variabile utilizza un prefisso cse_, mentre il percorso dell'URL di trascrizione utilizza lo stesso ID con un prefisso session_. Sostituisci il prefisso quando costruisci il link. Il seguente comando stampa l'URL:

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

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 funzionano subito poiché sono preinstallati.

PostgreSQL e Redis sono preinstallati ma non in esecuzione per impostazione predefinita. Avvia ognuno durante la sessione:

service postgresql start

service redis-server start

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.

NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

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:

#!/bin/bash
apt update && apt install -y gh

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.

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, vengono eseguiti solo gli hook sottoposti a commit nel repository.

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:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

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:

#!/bin/bash

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

npm install
pip install -r requirements.txt
exit 0

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.

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:

api.example.com
*.internal.example.com
registry.example.com

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.

Proxy GitHub

Per motivi di sicurezza, tutte le operazioni GitHub passano attraverso un servizio proxy dedicato che gestisce in modo trasparente tutte le interazioni git. All'interno della sandbox, il client git si autentica utilizzando una credenziale con ambito personalizzato. Questo proxy:

• Gestisce l'autenticazione GitHub in modo sicuro: il client git utilizza una credenziale con ambito all'interno della sandbox, che il proxy verifica e traduce nel tuo token di autenticazione GitHub effettivo
• Limita le operazioni git push al ramo di lavoro attuale per motivi di sicurezza
• Abilita il clonaggio, il recupero e le operazioni PR mantenendo i confini di sicurezza

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

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.

Sposta attività tra web e terminale

Questi flussi di lavoro richiedono la CLI Claude Code 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.

Dal terminale al web

Avvia una sessione cloud dalla riga di comando con il flag --remote:

claude --remote "Fix the authentication bug in src/auth/login.ts"

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. --remote funziona con un singolo repository alla volta. L'attività viene eseguita nel cloud mentre continui a lavorare localmente.

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:

claude --permission-mode plan

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:

claude --remote "Execute the migration plan in docs/migration-plan.md"

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 --remote crea la sua propria sessione cloud che viene eseguita indipendentemente. Puoi avviare più attività e verranno tutte eseguite simultaneamente in sessioni separate:

claude --remote "Fix the flaky test in auth.spec.ts"
claude --remote "Update the API documentation"
claude --remote "Refactor the logger to use structured output"

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 --remote 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:

CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"

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, Bedrock, Vertex AI 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 aprono un selettore di terminale interattivo, come /model o /config, non sono disponibili.

Per la gestione del contesto in particolare:

L'auto-compattazione viene eseguita automaticamente quando la finestra di contesto si avvicina alla capacità, come nella CLI. 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 del ~95% predefinito. 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. 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. Le sessioni Claude in Slack vengono condivise automaticamente con visibilità Team.

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.

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

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.

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 has 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, il tuo amministratore non ha abilitato le sessioni remote per il tuo piano

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

Risorse correlate

• 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