Iniziare con Claude Code sul web
Esegui Claude Code nel cloud dal tuo browser o telefono. Connetti un repository GitHub, invia un'attività e rivedi la PR senza configurazione locale.
Claude Code sul web viene eseguito su un'infrastruttura cloud gestita da Anthropic invece che sulla tua macchina. Invia attività da claude.ai/code dal tuo browser o dall'app mobile Claude.
Avrai bisogno di un repository GitHub per iniziare. Claude lo clona in una macchina virtuale isolata, apporta modifiche e spinge un ramo per te da rivedere. Le sessioni persistono tra i dispositivi, quindi un'attività che inizi sul tuo laptop è pronta per essere rivista dal tuo telefono in seguito.
Claude Code sul web funziona bene per:
- Attività parallele: esegui diversi compiti indipendenti contemporaneamente, ognuno nella sua sessione e ramo, senza gestire più worktrees
- Repository che non hai localmente: Claude clona il repository da zero ogni sessione, quindi non hai bisogno che sia estratto
- Attività che non richiedono frequenti correzioni: invia un'attività ben definita, fai qualcos'altro e rivedi il risultato quando Claude ha finito
- Domande sul codice ed esplorazione: comprendi una base di codice o traccia come una funzione è implementata senza un checkout locale
Per il lavoro che necessita della tua configurazione locale, strumenti o ambiente, eseguire Claude Code localmente o utilizzare Remote Control è una scelta migliore.
Come vengono eseguite le sessioni
I passaggi seguenti descrivono le sessioni ospitate da Anthropic. In un ambiente self-hosted, il clone e tutto ciò che segue vengono eseguiti sui runner della tua organizzazione, dove i confini di rete, la configurazione e il comportamento di push sono configurati dall'operatore. Quando invii un'attività:
- Clone e preparazione: il tuo repository viene clonato in una VM gestita da Anthropic e il tuo script di configurazione viene eseguito se configurato.
- Configura la rete: l'accesso a Internet viene impostato in base al livello di accesso del tuo ambiente.
- Lavoro: Claude analizza il codice, apporta modifiche, esegue test e verifica il suo lavoro. Puoi guardare e guidare durante tutto il processo, oppure allontanarti e tornare quando ha finito.
- Spingere il ramo: quando Claude raggiunge un punto di arresto, spinge il suo ramo su GitHub. Rivedi il diff, lascia commenti inline, crea una PR o invia un altro messaggio per continuare.
La sessione non si chiude quando il ramo viene spinto. La creazione di PR e ulteriori modifiche avvengono tutte all'interno della stessa conversazione.
Confronta i modi per eseguire Claude Code
Claude Code si comporta allo stesso modo ovunque. Quello che cambia è dove viene eseguito il codice e se la tua configurazione locale è disponibile. L'app Desktop offre sia sessioni locali che cloud, quindi le risposte di seguito dipendono da quale scegli:
| Sul web | Remote Control | Terminal CLI | App Desktop | |
|---|---|---|---|---|
| Il codice viene eseguito su | VM cloud, gestita da Anthropic per impostazione predefinita | La tua macchina | La tua macchina | La tua macchina o VM cloud |
| Chatti da | claude.ai o app mobile | claude.ai o app mobile | Il tuo terminale | L'interfaccia utente Desktop |
| Utilizza la tua configurazione locale | No, solo repository | Sì | Sì | Sì per locale, no per cloud |
| Richiede GitHub | Sì, o raggruppa un repository locale tramite --cloud |
No | No | Solo per sessioni cloud |
| Continua a funzionare se ti disconnetti | Sì | Mentre il terminale rimane aperto | No | Dipende dal tipo di sessione |
| Modalità di autorizzazione | Accetta modifiche, Plan, Auto | Manuale, Accetta modifiche, Plan | Tutte le modalità | Dipende dal tipo di sessione |
| Accesso alla rete | Configurabile per ambiente | La rete della tua macchina | La rete della tua macchina | Dipende dal tipo di sessione |
Consulta la documentazione quickstart del terminale, app Desktop o Remote Control per configurarli.
Connetti GitHub
La connessione di GitHub è un passaggio una tantum. Se usi già la GitHub CLI, puoi farlo dal tuo terminale invece che dal browser.
Visit claude.ai/code
Vai a claude.ai/code e accedi con il tuo account claude.ai. Su macOS o Windows, la prima schermata offre l'app desktop Claude Code e altri modi per installare Claude Code. Per rimanere nel browser, fai clic su Continue on web in fondo alla pagina.
Sign in with GitHub
Dopo l'accesso, claude.ai/code ti chiede di connettere GitHub. Segui il prompt e claude.ai/code ti invia alla pagina di autorizzazione di GitHub. Approva la richiesta di autorizzazione e GitHub ti restituisce a claude.ai/code. Le sessioni cloud funzionano con i repository GitHub esistenti e possono raggiungere qualsiasi repository che il tuo account GitHub può vedere. Per avviare un nuovo progetto, crea prima un repository vuoto su GitHub.
Quando Quick web setup è disattivato, come lo è per impostazione predefinita nei piani Team ed Enterprise, claude.ai/code ti chiede quindi di installare l'app Claude GitHub sui tuoi repository a meno che non sia già installata. Installala se desideri Auto-fix, che consente a Claude di rispondere ai fallimenti CI e ai commenti di revisione sulle pull request in quei repository; altrimenti fai clic su Skip. In entrambi i casi, le sessioni possono raggiungere gli stessi repository.
Set up your Default environment
Un cloud environment è la configurazione salvata che controlla quale accesso di rete Claude ha durante le sessioni e cosa viene eseguito quando una sessione si avvia. Quello che accade dopo che connetti GitHub dipende dal tuo piano:
- Pro e Max: l'onboarding crea un ambiente denominato Default per te.
- Team ed Enterprise: l'onboarding mostra un modulo Create your first cloud environment. Lascia il nome precompilato e l'accesso alla rete invariati e fai clic su Create & finish per creare l'ambiente Default. Se un Owner ha attivato Quick web setup, l'onboarding crea Default per te invece.
Default utilizza Trusted network access: le sessioni raggiungono registri di pacchetti comuni e altri domini nella lista di autorizzazione, e nient'altro attraverso la rete della sessione. Vedi Installed tools per quello che è disponibile senza alcuna configurazione.
Per un primo progetto, l'ambiente Default funziona così com'è. Per modificare il suo accesso alla rete, aggiungere variabili di ambiente o eseguire uno script di configurazione prima dell'avvio delle sessioni, modificalo o crea ambienti aggiuntivi.
Connetti dal tuo terminale
Se usi già la GitHub CLI (gh), puoi configurare Claude Code sul web senza aprire un browser. Questo richiede la Claude Code CLI. Quando esegui /web-setup, Claude Code legge il tuo token gh locale, lo collega al tuo account claude.ai e crea l'ambiente cloud Default se non ne hai uno. Nei piani Team ed Enterprise, /web-setup è disponibile solo dopo che un Owner attiva Quick web setup.
Autentica con la GitHub CLI
Nel tuo shell, autentica la GitHub CLI se non l'hai già fatto:
gh auth login
Sign in to Claude
Nella Claude Code CLI, esegui /login per accedere con il tuo account claude.ai. Salta questo passaggio se sei già connesso con un account claude.ai. L'autenticazione con una chiave API non conta. Per verificare, esegui /status e conferma che la riga Login method mostra un account claude.ai.
Run /web-setup
Nella Claude Code CLI, esegui:
/web-setup
Questo sincronizza il tuo token gh al tuo account Claude. Se ha successo, Claude Code stampa Connected as <your-github-username> e apre claude.ai/code nel tuo browser. Se non hai ancora un ambiente cloud, /web-setup ne crea uno con accesso alla rete Trusted e nessuno script di configurazione. Puoi modificare l'ambiente o aggiungere variabili in seguito. Una volta completato /web-setup, puoi avviare sessioni cloud dal tuo terminale con --cloud o configurare attività ricorrenti con /schedule.
Avvia un'attività
Con GitHub connesso e un ambiente creato, sei pronto a inviare attività.
Seleziona un repository e un ramo
Da claude.ai/code o dalla scheda Code nell'app mobile Claude, fai clic sul selettore di repository sotto la casella di input e scegli un repository su cui Claude lavorerà. Ogni repository mostra un selettore di ramo. Cambialo per avviare Claude da un ramo di funzionalità invece di quello predefinito. Puoi aggiungere più repository per lavorare su di essi in una sessione.
Scegli una modalità di autorizzazione
Il menu a discesa della modalità accanto all'input mostra la modalità in cui verrà eseguita la sessione:
- Auto: un classificatore esamina le azioni di Claude invece di chiederti. Appare quando la tua organizzazione consente la modalità auto e il modello selezionato la supporta
- Accept edits: Claude apporta modifiche e spinge un ramo senza fermarsi per l'approvazione
- Plan: Claude propone un approccio e attende il tuo via libera prima di modificare i file
Le sessioni cloud non offrono autorizzazioni Manual o Bypass. Consulta l'elenco completo delle modalità di autorizzazione per scoprire cosa consente ciascuna.
Descrivi l'attività e invia
Digita una descrizione di quello che vuoi e premi Invio. Sii specifico:
- Nomina il file o la funzione: "Aggiungi un README con istruzioni di configurazione" o "Correggi il test di autenticazione non riuscito in
tests/test_auth.py" è meglio di "correggi i test" - Incolla l'output dell'errore se lo hai
- Descrivi il comportamento previsto, non solo il sintomo
Claude clona i repository, esegue il tuo script di configurazione se configurato e inizia a lavorare. Ogni attività ottiene la sua sessione e il suo ramo, quindi non hai bisogno di aspettare che una finisca prima di avviarne un'altra.
Precompila le sessioni
Puoi precompilare il prompt, i repository e l'ambiente per una nuova sessione aggiungendo parametri di query all'URL claude.ai/code. Usalo per creare integrazioni come un pulsante nel tuo tracker di problemi che apre Claude Code con la descrizione del problema come prompt.
| Parametro | Descrizione |
|---|---|
prompt |
Testo del prompt da precompilare nella casella di input. È accettato anche l'alias q. |
prompt_url |
URL da cui recuperare il testo del prompt, per i prompt troppo lunghi da incorporare in una stringa di query. L'URL deve consentire richieste cross-origin. Ignorato quando è impostato anche prompt. |
repositories |
Elenco separato da virgole di slug owner/repo da preselezionare. È accettato anche l'alias repo. |
environment |
Nome o ID dell'ambiente da preselezionare. |
Codifica URL ogni valore. L'esempio seguente apre il modulo con un prompt e un repository già selezionati:
https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp
Rivedi e itera
Quando Claude finisce, rivedi le modifiche, lascia feedback su righe specifiche e continua finché il diff non sembra giusto.
Apri la vista diff
Un indicatore diff mostra le righe aggiunte e rimosse durante la sessione, ad esempio +42 -18. Selezionalo per aprire la vista diff, con un elenco di file a sinistra e le modifiche a destra.
Lascia commenti inline
Seleziona qualsiasi riga nel diff, digita il tuo feedback e premi Invio. I commenti si accumulano fino a quando non invii il tuo prossimo messaggio, quindi vengono raggruppati con esso. Claude vede "a src/auth.ts:47, non catturare l'errore qui" insieme alla tua istruzione principale, quindi non devi descrivere dove si trova il problema.
Crea una pull request
Quando il diff sembra giusto, seleziona Crea PR nella parte superiore della vista diff. Puoi aprirla come una PR completa, una bozza, o saltare alla pagina di composizione di GitHub con un titolo e una descrizione generati.
Continua a iterare dopo la PR
La sessione rimane attiva dopo la creazione della PR. Incolla l'output di errore CI o i commenti dei revisori nella chat e chiedi a Claude di affrontarli. Per fare in modo che Claude monitori la PR automaticamente, consulta Auto-fix pull requests.
Risolvi i problemi di configurazione
Nessun repository appare dopo la connessione a GitHub
Una sessione cloud può utilizzare qualsiasi repository che l'account GitHub connesso può vedere, indipendentemente da quali repository l'app Claude GitHub è installata. Se un repository è mancante, verifica che l'account GitHub connesso abbia accesso ad esso su GitHub. Se vuoi anche Auto-fix per un repository, installa l'app su di esso: su github.com, apri Impostazioni → Applicazioni → Claude → Configura e verifica che il repository sia elencato sotto Accesso al repository. I repository privati hanno bisogno della stessa autorizzazione di quelli pubblici.
La pagina mostra solo un pulsante di accesso a GitHub
Le sessioni cloud richiedono un account GitHub connesso. Connettiti tramite il flusso del browser sopra, o esegui /web-setup dal tuo terminale se usi la GitHub CLI. Se preferisci non connettere GitHub affatto, consulta Remote Control per eseguire Claude Code sulla tua macchina e monitorarlo dal web.
"Non disponibile per l'organizzazione selezionata"
Le organizzazioni Enterprise potrebbero aver bisogno che un amministratore abiliti Claude Code sul web. Contatta il tuo team di account Anthropic.
`/web-setup` dice "Not signed in to Claude"
Se /web-setup risponde con "Not signed in to Claude. Run /login first.", la CLI non ha un accesso valido a claude.ai. Questo può accadere anche quando un accesso precedente è scaduto. Esegui /login, accedi con il tuo account claude.ai, quindi esegui /web-setup di nuovo.
`/web-setup` avverte che il tuo token non ha lo scope `workflow`
Se /web-setup dice che il tuo token GitHub CLI non ha lo scope workflow, puoi continuare, ma GitHub può rifiutare alcuni push effettuati con quel token, come i push che modificano i file del flusso di lavoro GitHub Actions. Per aggiungere lo scope, esegui gh auth refresh -s workflow nella tua shell, quindi esegui /web-setup di nuovo.
`/web-setup` mostra "No commands match" o "Unknown command"
/web-setup viene eseguito all'interno della Claude Code CLI, non nel tuo shell. Avvia claude prima, quindi digita /web-setup al prompt.
Se l'hai digitato all'interno di Claude Code e il menu dei comandi mostra No commands match "/web-setup", o l'invio restituisce Unknown command: /web-setup, il comando è nascosto perché un requisito non è soddisfatto. La causa è solitamente che sei autenticato con una chiave API o un provider di terze parti invece di un abbonamento claude.ai. Esegui /login per accedere con il tuo account claude.ai.
Nei piani Team e Enterprise, il comando è nascosto per impostazione predefinita: il Quick web setup toggle è disattivato fino a quando un amministratore non lo attiva. Mentre è disattivato, connetti GitHub dal browser invece. Il comando è anche nascosto quando un amministratore ha disabilitato Claude Code sul web per la tua organizzazione, o quando la tua organizzazione Enterprise ha Zero Data Retention abilitato, il che rende Claude Code sul web non disponibile.
"Could not create a cloud environment" o "No cloud environment available" quando si utilizza `--cloud`
Le funzioni di sessione remota creano automaticamente un ambiente cloud predefinito se non ne hai uno. Se vedi "Could not create a cloud environment", la creazione automatica non è riuscita. Se vedi "No cloud environment available", la tua CLI è precedente alla creazione automatica. In entrambi i casi, esegui /web-setup nella Claude Code CLI, o aggiungi un ambiente dal selettore di ambiente su claude.ai/code.
Lo script di configurazione non è riuscito
Lo script di configurazione è uscito con uno stato diverso da zero, il che blocca l'avvio della sessione. Le cause comuni sono:
- Un'installazione di pacchetto non è riuscita perché il registro non è nel tuo livello di accesso alla rete.
Trustedcopre la maggior parte dei gestori di pacchetti;Noneli blocca tutti. - Lo script fa riferimento a un file o un percorso che non esiste in un clone fresco.
- Un comando che funziona localmente ha bisogno di una diversa invocazione su Ubuntu.
Per eseguire il debug, aggiungi set -x nella parte superiore dello script per vedere quale comando non è riuscito. Per i comandi non critici, aggiungi || true in modo che non blocchino l'avvio della sessione.
Nuove sessioni si bloccano o scadono durante la configurazione
Se le nuove sessioni si fermano al passaggio dello script di configurazione o falliscono con un errore generico del contenitore prima che lo script finisca, lo script probabilmente sta superando il budget di tempo di circa cinque minuti per la costruzione della cache dell'ambiente. I passaggi pesanti come il pull di grandi immagini Docker, la sincronizzazione di alberi di dipendenze completi o il download di pesi del modello spesso spingono il totale oltre il limite, soprattutto quando vengono eseguiti uno dopo l'altro.
Per risolvere questo, riduci lo script in modo che finisca in modo affidabile in meno di cinque minuti:
- Esegui installazioni indipendenti in parallelo con
&e unwaitfinale invece di eseguirle in serie. - Sposta i download più grandi fuori dallo script di configurazione e in un hook SessionStart che li avvia in background, in modo che la sessione diventi utilizzabile mentre finiscono.
- Rimuovi i lunghi sleep di ripetizione dallo script di configurazione, poiché un ciclo di ripetizione bloccato conta nel budget.
La sessione continua a funzionare dopo la chiusura della scheda
Questo è intenzionale. Chiudere la scheda o navigare via non interrompe la sessione. Continua a funzionare in background fino a quando Claude non finisce l'attività corrente, quindi rimane inattiva. Dalla barra laterale, puoi archiviare una sessione per nasconderla dal tuo elenco, o eliminarla per rimuoverla permanentemente.
Passaggi successivi
Ora che puoi inviare e rivedere attività, queste pagine coprono cosa viene dopo: avviare sessioni cloud dal tuo terminale, pianificare lavori ricorrenti e dare a Claude istruzioni permanenti.
- Usa Claude Code sul web: il riferimento completo, incluso il teletrasporto di sessioni al tuo terminale, condivisione di sessioni e correzione automatica delle pull request
- Configura ambienti cloud: livelli di accesso alla rete, variabili di ambiente e script di configurazione per sessioni cloud
- Routines: automatizza il lavoro su una pianificazione, tramite chiamata API o in risposta agli eventi di GitHub
- CLAUDE.md: dai a Claude istruzioni e contesto persistenti che si caricano all'inizio di ogni sessione
- Installa l'app mobile Claude per iOS o Android per monitorare le sessioni dal tuo telefono. Dalla Claude Code CLI,
/mobilemostra un codice QR.