4 4
5# Usa Claude Code sul web5# Usa Claude Code sul web
6 6
7> Configura ambienti cloud, script di configurazione, accesso alla rete e Docker nella sandbox di Anthropic. Sposta le sessioni tra web e terminale con `--cloud` e `--teleport`.7> Sposta le sessioni tra web e terminale con `--cloud` e `--teleport`, gestisci e condividi le sessioni, e correggi automaticamente le pull request dal cloud.
8 8
9<Note>9<Note>
10 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.10 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.
11</Note>11</Note>
12 12
13Claude Code sul web esegue attività su infrastruttura cloud gestita da Anthropic su [claude.ai/code](https://claude.ai/code). Le sessioni persistono anche se chiudi il browser e puoi monitorarle dall'app mobile Claude.13Claude Code sul web esegue attività su infrastruttura cloud gestita da Anthropic su [claude.ai/code](https://claude.ai/code), o sull'[ambiente self-hosted](/docs/it/self-hosted-environments) della tua organizzazione quando instradato lì. Le sessioni persistono anche se chiudi il browser e puoi monitorarle dall'app mobile Claude.
14 14
15<Tip>15<Tip>
16 Nuovo a Claude Code sul web? Inizia con [Guida introduttiva](/docs/it/web-quickstart) per connettere il tuo account GitHub e inviare il tuo primo compito.16 Nuovo a Claude Code sul web? Inizia con [Guida introduttiva](/docs/it/web-quickstart) per connettere il tuo account GitHub e inviare il tuo primo compito.
17</Tip>17</Tip>
18 18
19Questa pagina copre:19Questa pagina copre il prodotto web stesso:
20 20
21* [Ambienti cloud](#cloud-environments): dove vengono eseguite le sessioni e dove configurare questo
21* [Opzioni di autenticazione GitHub](#github-authentication-options): due modi per connettere GitHub22* [Opzioni di autenticazione GitHub](#github-authentication-options): due modi per connettere GitHub
22* [L'ambiente cloud](#the-cloud-environment): quale configurazione viene trasferita, quali strumenti sono installati e come configurare gli ambienti
23* [Script di configurazione](#setup-scripts) e gestione delle dipendenze
24* [Accesso alla rete](#network-access): livelli, proxy e l'elenco di consentiti predefinito
25* [Sposta attività tra web e terminale](#move-tasks-between-web-and-terminal) con `--cloud` e `--teleport`23* [Sposta attività tra web e terminale](#move-tasks-between-web-and-terminal) con `--cloud` e `--teleport`
26* [Lavora con le sessioni](#work-with-sessions): revisione, condivisione, archiviazione, eliminazione24* [Lavora con le sessioni](#work-with-sessions): modalità di autorizzazione, revisione, condivisione, archiviazione, eliminazione
27* [Correzione automatica delle pull request](#auto-fix-pull-requests): rispondi automaticamente ai fallimenti CI e ai commenti di revisione25* [Correzione automatica delle pull request](#auto-fix-pull-requests): rispondi automaticamente ai fallimenti CI e ai commenti di revisione
28* [Sicurezza e isolamento](#security-and-isolation): come le sessioni sono isolate26* [Sicurezza e isolamento](#security-and-isolation): come le sessioni sono isolate
29* [Limitazioni](#limitations): limiti di velocità e restrizioni della piattaforma27* [Limitazioni](#limitations): limiti di velocità e restrizioni della piattaforma
30 28
29<h2 id="cloud-environments">
30 Ambienti cloud
31</h2>
32
33Ogni sessione cloud viene eseguita in un [ambiente cloud](/docs/it/cloud-environments), la configurazione salvata che controlla l'accesso alla rete, le variabili di ambiente e gli script di configurazione. Se non hai ancora un ambiente, l'onboarding configura un ambiente **Default** con accesso alla rete [**Trusted**](/docs/it/cloud-environments#access-levels), creandolo per te o chiedendoti di crearlo. Vedi [L'ambiente Default](/docs/it/cloud-environments#the-default-environment) per sapere quale di questi accade sul tuo piano e come le sessioni scelgono un ambiente quando ne hai più di uno.
34
35Gli stessi ambienti si applicano ovunque tu avvii una sessione cloud: il web, il terminale, [Claude Tag](https://claude.com/docs/claude-tag/overview), [routine](/docs/it/routines) e le app mobile e Desktop. Le sessioni dei canali Claude Tag utilizzano solo ambienti a livello di organizzazione, sia [ambienti condivisi](/docs/it/cloud-environments#organization-shared-environments) che [ambienti self-hosted](/docs/it/self-hosted-environments).
36
37Vedi [Configura ambienti cloud](/docs/it/cloud-environments) per modificare cosa consente un ambiente, impostare variabili o aggiungere uno script di configurazione, e [Strumenti installati](/docs/it/cloud-environments#installed-tools) per quello che le sessioni includono senza alcuna configurazione.
38
31<h2 id="github-authentication-options">39<h2 id="github-authentication-options">
32 Opzioni di autenticazione GitHub40 Opzioni di autenticazione GitHub
33</h2>41</h2>
43 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](#auto-fix-pull-requests); 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.51 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](#auto-fix-pull-requests); 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.
44</Note>52</Note>
45 53
46Entrambi i metodi funzionano. [`/schedule`](/docs/it/routines) verifica entrambe le forme di accesso e ti chiede di eseguire `/web-setup` se nessuna è configurata. Vedi [Connetti dal tuo terminale](/docs/it/web-quickstart#connect-from-your-terminal) per la procedura dettagliata di `/web-setup`.54Entrambi i metodi funzionano. Per come `/schedule` verifica l'accesso prima di creare una routine, vedi [Repository e autorizzazioni di ramo](/docs/it/routines#repositories-and-branch-permissions). Vedi [Connetti dal tuo terminale](/docs/it/web-quickstart#connect-from-your-terminal) per la procedura dettagliata di `/web-setup`.
47
48L'app GitHub è richiesta per [Auto-fix](#auto-fix-pull-requests), 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.
49 55
50Gli amministratori di Team e Enterprise possono disabilitare `/web-setup` con l'interruttore Quick web setup su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).56La configurazione rapida del web è un'impostazione dell'organizzazione che consente ai membri di connettere GitHub con `/web-setup`, salta il prompt di installazione dell'app Claude GitHub durante l'onboarding del browser e fa sì che l'onboarding del browser crei l'[ambiente **Default**](/docs/it/cloud-environments#the-default-environment) per loro invece di mostrare il modulo dell'ambiente. Nei piani Team ed Enterprise è disabilitato per impostazione predefinita, il che nasconde `/web-setup`. Un [Proprietario](/docs/it/server-managed-settings#access-control) lo attiva con l'interruttore **Quick web setup** su [**Impostazioni di amministrazione > Claude Code**](https://claude.ai/admin-settings/claude-code).
51 57
52<Note>58<Note>
53 Le organizzazioni con [Zero Data Retention](/docs/it/zero-data-retention) abilitato non possono utilizzare `/web-setup` o altre funzionalità di sessione cloud.59 Le organizzazioni con [Zero Data Retention](/docs/it/zero-data-retention) abilitato non possono utilizzare `/web-setup` o altre funzionalità di sessione cloud.
54</Note>60</Note>
55 61
56<h2 id="the-cloud-environment">
57 L'ambiente cloud
58</h2>
59
60Ogni 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.
61
62<h3 id="what’s-available-in-cloud-sessions">
63 Cosa è disponibile nelle sessioni cloud
64</h3>
65
66Le 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](/docs/it/server-managed-settings).
67
68| | Disponibile nelle sessioni cloud | Perché |
69| :------------------------------------------------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
70| Il tuo `CLAUDE.md` del repository | Sì | Parte del clone |
71| I tuoi hook `.claude/settings.json` del repository | Sì | Parte del clone |
72| I tuoi server MCP `.mcp.json` del repository | Sì | Parte del clone |
73| Le tue `.claude/rules/` del repository | Sì | Parte del clone |
74| Le tue `.claude/skills/`, `.claude/agents/`, `.claude/commands/` del repository | Sì | Parte del clone |
75| Plugin dichiarati in `.claude/settings.json` | Sì | Installati all'inizio della sessione dal [marketplace](/docs/it/plugin-marketplaces) che hai dichiarato. Richiede accesso alla rete per raggiungere la fonte del marketplace |
76| Le impostazioni gestite dal server della tua organizzazione | Sì | Recuperate dai server di Anthropic quando la sessione inizia. Vedi [Copertura della superficie](/docs/it/model-config#surface-coverage) per come `availableModels` viene applicato nelle sessioni cloud. Le impostazioni distribuite al tuo dispositivo tramite MDM o file di impostazioni gestite non si applicano, perché la sessione viene eseguita su una VM gestita da Anthropic |
77| Il tuo `~/.claude/CLAUDE.md` utente | No | Vive sulla tua macchina, non nel repository |
78| Le tue `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utente | No | Vivono sulla tua macchina, non nel repository. Eseguine il commit nella directory `.claude/` del repository. Le skill che abiliti su claude.ai vengono caricate automaticamente nelle sessioni cloud |
79| Plugin abilitati solo nelle tue impostazioni utente | No | L'`enabledPlugins` con ambito utente vive in `~/.claude/settings.json`. Dichiarali invece in `.claude/settings.json` del repository |
80| Server MCP che hai aggiunto con `claude mcp add` | No | Quelli scrivono nella tua configurazione utente locale, non nel repository. Dichiara il server in [`.mcp.json`](/docs/it/mcp#project-scope) invece |
81| Token API statici e credenziali | No | Non esiste ancora un archivio di segreti dedicato. Vedi sotto |
82| Autenticazione interattiva come AWS SSO | No | Non supportato. SSO richiede un login basato su browser che non può essere eseguito in una sessione cloud |
83
84Per rendere la tua configurazione disponibile nelle sessioni cloud, eseguine il commit nel repository; la politica dell'organizzazione arriva separatamente attraverso [impostazioni gestite dal server](/docs/it/server-managed-settings).
85
86Un 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.
87
88<h3 id="installed-tools">
89 Strumenti installati
90</h3>
91
92Le sessioni cloud vengono fornite con runtime di linguaggio comuni, strumenti di compilazione e database preinstallati. La tabella seguente riassume cosa è incluso per categoria.
93
94| Categoria | Incluso |
95| :----------- | :--------------------------------------------------------------------------------- |
96| **Python** | Python 3.x con pip, poetry, uv, black, mypy, pytest, ruff |
97| **Node.js** | 20, 21 e 22 tramite nvm, con npm, yarn, pnpm, bun¹, eslint, prettier, chromedriver |
98| **Ruby** | 3.1, 3.2, 3.3 con gem, bundler, rbenv |
99| **PHP** | 8.4 con Composer |
100| **Java** | OpenJDK 21 con Maven e Gradle |
101| **Go** | ultima versione stabile con supporto dei moduli |
102| **Rust** | rustc e cargo |
103| **C/C++** | GCC, Clang, cmake, ninja, conan |
104| **Docker** | docker, dockerd, docker compose |
105| **Database** | PostgreSQL 16, Redis 7.0 |
106| **Utilità** | git, jq, yq, ripgrep, tmux, vim, nano |
107
108¹ Bun è installato ma ha [problemi di compatibilità proxy](#install-dependencies-with-a-sessionstart-hook) noti per il recupero dei pacchetti.
109
110Per le versioni esatte, chiedi a Claude di eseguire `check-tools` in una sessione cloud. Questo comando esiste solo nelle sessioni cloud.
111
112<h3 id="work-with-github-issues-and-pull-requests">
113 Lavora con i problemi e le pull request di GitHub
114</h3>
115
116Le 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](#github-proxy) utilizzando il metodo che hai configurato in [Opzioni di autenticazione GitHub](#github-authentication-options), quindi il tuo token non entra mai nel contenitore.
117
118Puoi impostare `GH_TOKEN` o `GITHUB_TOKEN` tu stesso nelle [impostazioni dell'ambiente](#configure-your-environment), oppure lasciare entrambi non impostati e lasciare che il [proxy GitHub](#github-proxy) si autentichi per te:
119
120* Se imposti un token, viene passato al contenitore invariato, quindi `gh` e i tuoi script lo usano direttamente.
121* 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.
122
123Per verificare quale caso si applica alla tua sessione, chiedi a Claude di eseguire `echo $GH_TOKEN`.
124
125La 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:
126
127<Steps>
128 <Step title="Installa gh nel tuo script di configurazione">
129 Aggiungi `apt update && apt install -y gh` al tuo [script di configurazione](#setup-scripts).
130 </Step>
131
132 <Step title="Fornisci un token se il proxy non sta gestendo l'autenticazione">
133 Se `echo $GH_TOKEN` stampa `proxy-injected`, il [proxy GitHub](#github-proxy) autentica `gh` per te e questo passaggio è non necessario. Altrimenti, aggiungi una variabile di ambiente `GH_TOKEN` alle tue [impostazioni dell'ambiente](#configure-your-environment) con un token di accesso personale GitHub. `gh` legge `GH_TOKEN` automaticamente, quindi non è necessario alcun passaggio `gh auth login`.
134 </Step>
135</Steps>
136
137<h3 id="link-output-back-to-the-session">
138 Collega l'output di nuovo alla sessione
139</h3>
140
141Ogni 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.
142
143A 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`](/docs/it/settings#attribution-settings) su `false` per omettere il trailer e il link nel corpo PR.
144
145Per 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:
146
147```bash theme={null}
148echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
149```
150
151<h3 id="run-tests-start-services-and-add-packages">
152 Esegui test, avvia servizi e aggiungi pacchetti
153</h3>
154
155Claude 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.
156
157PostgreSQL e Redis sono preinstallati ma non in esecuzione per impostazione predefinita. Chiedi a Claude di avviare ognuno durante la sessione:
158
159```bash theme={null}
160service postgresql start
161```
162
163```bash theme={null}
164service redis-server start
165```
166
167Docker è 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](#access-levels) del tuo ambiente e i [Trusted defaults](#default-allowed-domains) includono Docker Hub e altri registri comuni.
168
169Se le tue immagini sono grandi o lente da estrarre, aggiungi `docker compose pull` o `docker compose build` al tuo [script di configurazione](#setup-scripts). Le immagini estratte vengono salvate nell'[ambiente memorizzato nella cache](#environment-caching), 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.
170
171Per aggiungere pacchetti che non sono preinstallati, usa uno [script di configurazione](#setup-scripts). L'output dello script è [memorizzato nella cache](#environment-caching), 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.
172
173<h3 id="resource-limits">
174 Limiti di risorse
175</h3>
176
177Le sessioni cloud vengono eseguite con limiti di risorse approssimativi che possono cambiare nel tempo:
178
179* 4 vCPU
180* 16 GB di RAM
181* 30 GB di disco
182
183I 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](/docs/it/remote-control) per eseguire Claude Code sul tuo hardware.
184
185<h3 id="configure-your-environment">
186 Configura il tuo ambiente
187</h3>
188
189Gli ambienti controllano l'[accesso alla rete](#network-access), le variabili di ambiente e lo [script di configurazione](#setup-scripts) che viene eseguito prima che una sessione inizi. Vedi [Strumenti installati](#installed-tools) per cosa è disponibile senza alcuna configurazione. Puoi gestire gli ambienti dall'interfaccia web o dal terminale:
190
191| Azione | Come |
192| :------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
193| Aggiungi un ambiente | Seleziona l'ambiente attuale per aprire il selettore, quindi seleziona **Aggiungi ambiente**. La finestra di dialogo include nome, livello di accesso alla rete, variabili di ambiente e script di configurazione. |
194| Modifica un ambiente | Seleziona l'icona cloud che mostra il nome dell'ambiente attuale per aprire il selettore, passa il mouse su un ambiente e fai clic sull'icona delle impostazioni che appare a destra. |
195| Archivia un ambiente | Apri l'ambiente per la modifica e seleziona **Archivia**. Gli ambienti archiviati sono nascosti dal selettore ma le sessioni esistenti continuano a essere eseguite. |
196| Imposta l'ambiente predefinito per le sessioni cloud CLI | Esegui `/remote-env` nel tuo terminale. Se hai un singolo ambiente, questo comando mostra la tua configurazione attuale. `/remote-env` seleziona solo il predefinito; aggiungi, modifica e archivia gli ambienti dall'interfaccia web. |
197
198Le 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:
199
200```text theme={null}
201NODE_ENV=development
202LOG_LEVEL=debug
203DATABASE_URL=postgres://localhost:5432/myapp
204```
205
206<h3 id="organization-shared-environments">
207 Ambienti condivisi dall'organizzazione
208</h3>
209
210I 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.
211
212Gestisci gli ambienti condivisi dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings). Da lì puoi:
213
214* Creare, modificare e archiviare ambienti condivisi. Ognuno ha gli stessi campi di un ambiente personale: un nome, un [livello di accesso alla rete](#access-levels), [variabili di ambiente](#configure-your-environment) in formato `.env` e uno [script di configurazione](#setup-scripts).
215* Impostare l'ambiente predefinito per l'organizzazione.
216
217I 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.
218
219<h2 id="setup-scripts">
220 Script di configurazione
221</h2>
222
223Uno 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.
224
225Gli script vengono eseguiti come root su Ubuntu 24.04, quindi `apt install` e la maggior parte dei gestori di pacchetti di linguaggio funzionano.
226
227Per aggiungere uno script di configurazione, apri la finestra di dialogo delle impostazioni dell'ambiente e inserisci il tuo script nel campo **Setup script**.
228
229Questo esempio installa la CLI `gh`, che non è preinstallata:
230
231```bash theme={null}
232#!/bin/bash
233apt update && apt install -y gh
234```
235
236Se 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.
237
238Mantieni il tempo di esecuzione totale dello script sotto circa cinque minuti in modo che la [cache dell'ambiente](#environment-caching) 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](#setup-scripts-vs-sessionstart-hooks) che lo avvia in background.
239
240<Note>
241 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](#default-allowed-domains) inclusi npm, PyPI, RubyGems e crates.io. Gli script non riusciranno a installare pacchetti se il tuo ambiente usa l'accesso alla rete **None**.
242</Note>
243
244<h3 id="environment-caching">
245 Memorizzazione nella cache dell'ambiente
246</h3>
247
248Lo 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.
249
250La 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](#setup-scripts-vs-sessionstart-hooks).
251
252Lo 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.
253
254Non è necessario abilitare la memorizzazione nella cache o gestire gli snapshot tu stesso.
255
256<h3 id="setup-scripts-vs-sessionstart-hooks">
257 Script di configurazione vs. hook SessionStart
258</h3>
259
260Usa 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](/docs/it/hooks#sessionstart) per la configurazione del progetto che dovrebbe essere eseguita ovunque, cloud e locale, come `npm install`.
261
262Entrambi vengono eseguiti all'inizio di una sessione, ma appartengono a posti diversi:
263
264| | Script di configurazione | Hook SessionStart |
265| -------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
266| Allegato a | L'ambiente cloud | Il tuo repository |
267| Configurato in | Interfaccia utente dell'ambiente cloud | `.claude/settings.json` nel tuo repository |
268| Viene eseguito | Prima che Claude Code si avvii, quando non è disponibile alcun [ambiente memorizzato nella cache](#environment-caching) | Dopo che Claude Code si avvia, su ogni sessione incluse quelle riprese |
269| Ambito | Solo ambienti cloud | Sia locale che cloud |
270
271Gli 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](/docs/it/server-managed-settings) della tua organizzazione.
272
273<h3 id="install-dependencies-with-a-sessionstart-hook">
274 Installa le dipendenze con un hook SessionStart
275</h3>
276
277Per installare le dipendenze solo nelle sessioni cloud, aggiungi un hook SessionStart al `.claude/settings.json` del tuo repository:
278
279```json theme={null}
280{
281 "hooks": {
282 "SessionStart": [
283 {
284 "matcher": "startup|resume",
285 "hooks": [
286 {
287 "type": "command",
288 "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
289 }
290 ]
291 }
292 ]
293 }
294}
295```
296
297Crea 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:
298
299```bash theme={null}
300#!/bin/bash
301
302if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
303 exit 0
304fi
305
306npm install
307pip install -r requirements.txt
308exit 0
309```
310
311Gli hook SessionStart hanno alcune limitazioni nelle sessioni cloud:
312
313* **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.
314* **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](#default-allowed-domains) sotto **Trusted** copre npm, PyPI, RubyGems e crates.io.
315* **Compatibilità proxy**: tutto il traffico in uscita passa attraverso un [proxy di sicurezza](#security-proxy). Alcuni gestori di pacchetti non funzionano correttamente con questo proxy. Bun è un esempio noto.
316* **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](#environment-caching). Mantieni gli script di installazione veloci controllando se le dipendenze sono già presenti prima di reinstallarle.
317
318Per persistere le variabili di ambiente per i comandi Bash successivi, scrivi nel file in `$CLAUDE_ENV_FILE`. Vedi [Hook SessionStart](/docs/it/hooks#sessionstart) per i dettagli.
319
320La 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](#installed-tools) o esegui la tua immagine come contenitore insieme a Claude con `docker compose`.
321
322<h2 id="network-access">
323 Accesso alla rete
324</h2>
325
326L'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](#default-allowed-domains).
327
328Per modificare l'accesso alla rete di un ambiente, [aprilo per la modifica](#configure-your-environment) 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](/docs/it/routines#environments-and-network-access).
329
330<Note>
331 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](#security-and-isolation).
332</Note>
333
334<h3 id="access-levels">
335 Livelli di accesso
336</h3>
337
338Scegli un livello di accesso quando crei o modifichi un ambiente:
339
340| Livello | Connessioni in uscita |
341| :---------- | :------------------------------------------------------------------------------------------- |
342| **None** | Nessun accesso alla rete in uscita |
343| **Trusted** | [Domini consentiti](#default-allowed-domains) solo: registri di pacchetti, GitHub, SDK cloud |
344| **Full** | Qualsiasi dominio |
345| **Custom** | Il tuo elenco di consentiti, opzionalmente inclusi i predefiniti |
346
347Le operazioni GitHub usano un [proxy separato](#github-proxy) che è indipendente da questa impostazione.
348
349<h3 id="allow-specific-domains">
350 Consenti domini specifici
351</h3>
352
353Per 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:
354
355```text theme={null}
356api.example.com
357*.internal.example.com
358registry.example.com
359```
360
361Usa `*.` per la corrispondenza dei sottodomini con caratteri jolly. Seleziona **Also include default list of common package managers** per mantenere i [domini Trusted](#default-allowed-domains) insieme alle tue voci personalizzate, o lascialo deselezionato per consentire solo quello che elenchi.
362
363I 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](/docs/it/server-managed-settings) possono limitare le sessioni cloud ma non possono aggiungere domini consentiti.
364
365<h3 id="github-proxy">
366 Proxy GitHub
367</h3>
368
369Per 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:
370
371* 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
372* 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](#work-with-github-issues-and-pull-requests)
373
374Il 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.
375
376Il proxy limita le richieste API GitHub e di asset di rilascio ai repository collegati alla sessione, indipendentemente dal [livello di accesso alla rete](#access-levels) 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](#security-proxy) gestisce invece. Quel dominio è nell'elenco predefinito [Trusted](#default-allowed-domains), quindi i file rimangono raggiungibili a meno che il [livello di accesso](#access-levels) dell'ambiente non lo escluda.
377
378<h3 id="security-proxy">
379 Proxy di sicurezza
380</h3>
381
382Gli 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:
383
384* Protezione contro richieste dannose
385* Limitazione della velocità e prevenzione degli abusi
386* Filtro dei contenuti per una sicurezza migliorata
387* Un audit trail a livello DNS dei nomi host richiesti
388
389<h3 id="default-allowed-domains">
390 Domini consentiti predefiniti
391</h3>
392
393Quando 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`.
394
395<AccordionGroup>
396 <Accordion title="Servizi Anthropic">
397 * api.anthropic.com
398 * statsig.anthropic.com
399 * docs.claude.com
400 * platform.claude.com
401 * code.claude.com
402 * claude.ai
403 </Accordion>
404
405 <Accordion title="Controllo versione">
406 * github.com
407 * [www.github.com](http://www.github.com)
408 * api.github.com
409 * npm.pkg.github.com
410 * raw\.githubusercontent.com
411 * pkg-npm.githubusercontent.com
412 * objects.githubusercontent.com
413 * release-assets.githubusercontent.com
414 * codeload.github.com
415 * avatars.githubusercontent.com
416 * camo.githubusercontent.com
417 * gist.github.com
418 * gitlab.com
419 * [www.gitlab.com](http://www.gitlab.com)
420 * registry.gitlab.com
421 * bitbucket.org
422 * [www.bitbucket.org](http://www.bitbucket.org)
423 * api.bitbucket.org
424 </Accordion>
425
426 <Accordion title="Registri di container">
427 * registry-1.docker.io
428 * auth.docker.io
429 * index.docker.io
430 * hub.docker.com
431 * [www.docker.com](http://www.docker.com)
432 * production.cloudflare.docker.com
433 * download.docker.com
434 * gcr.io
435 * \*.gcr.io
436 * ghcr.io
437 * mcr.microsoft.com
438 * \*.data.mcr.microsoft.com
439 * public.ecr.aws
440 </Accordion>
441
442 <Accordion title="Piattaforme cloud">
443 * cloud.google.com
444 * accounts.google.com
445 * gcloud.google.com
446 * \*.googleapis.com
447 * storage.googleapis.com
448 * compute.googleapis.com
449 * container.googleapis.com
450 * azure.com
451 * portal.azure.com
452 * microsoft.com
453 * [www.microsoft.com](http://www.microsoft.com)
454 * \*.microsoftonline.com
455 * packages.microsoft.com
456 * dotnet.microsoft.com
457 * dot.net
458 * visualstudio.com
459 * dev.azure.com
460 * \*.amazonaws.com
461 * \*.api.aws
462 * oracle.com
463 * [www.oracle.com](http://www.oracle.com)
464 * java.com
465 * [www.java.com](http://www.java.com)
466 * java.net
467 * [www.java.net](http://www.java.net)
468 * download.oracle.com
469 * yum.oracle.com
470 </Accordion>
471
472 <Accordion title="Gestori di pacchetti JavaScript e Node">
473 * registry.npmjs.org
474 * [www.npmjs.com](http://www.npmjs.com)
475 * [www.npmjs.org](http://www.npmjs.org)
476 * npmjs.com
477 * npmjs.org
478 * yarnpkg.com
479 * registry.yarnpkg.com
480 </Accordion>
481
482 <Accordion title="Gestori di pacchetti Python">
483 * pypi.org
484 * [www.pypi.org](http://www.pypi.org)
485 * files.pythonhosted.org
486 * pythonhosted.org
487 * test.pypi.org
488 * pypi.python.org
489 * pypa.io
490 * [www.pypa.io](http://www.pypa.io)
491 </Accordion>
492
493 <Accordion title="Gestori di pacchetti Ruby">
494 * rubygems.org
495 * [www.rubygems.org](http://www.rubygems.org)
496 * api.rubygems.org
497 * index.rubygems.org
498 * ruby-lang.org
499 * [www.ruby-lang.org](http://www.ruby-lang.org)
500 * rubyforge.org
501 * [www.rubyforge.org](http://www.rubyforge.org)
502 * rubyonrails.org
503 * [www.rubyonrails.org](http://www.rubyonrails.org)
504 * rvm.io
505 * get.rvm.io
506 </Accordion>
507
508 <Accordion title="Gestori di pacchetti Rust">
509 * crates.io
510 * [www.crates.io](http://www.crates.io)
511 * index.crates.io
512 * static.crates.io
513 * rustup.rs
514 * static.rust-lang.org
515 * [www.rust-lang.org](http://www.rust-lang.org)
516 </Accordion>
517
518 <Accordion title="Gestori di pacchetti Go">
519 * proxy.golang.org
520 * sum.golang.org
521 * index.golang.org
522 * golang.org
523 * [www.golang.org](http://www.golang.org)
524 * goproxy.io
525 * pkg.go.dev
526 </Accordion>
527
528 <Accordion title="Gestori di pacchetti JVM">
529 * maven.org
530 * repo.maven.org
531 * central.maven.org
532 * repo1.maven.org
533 * repo.maven.apache.org
534 * jcenter.bintray.com
535 * gradle.org
536 * [www.gradle.org](http://www.gradle.org)
537 * services.gradle.org
538 * plugins.gradle.org
539 * kotlinlang.org
540 * [www.kotlinlang.org](http://www.kotlinlang.org)
541 * spring.io
542 * repo.spring.io
543 </Accordion>
544
545 <Accordion title="Altri gestori di pacchetti">
546 * packagist.org (PHP Composer)
547 * [www.packagist.org](http://www.packagist.org)
548 * repo.packagist.org
549 * nuget.org (.NET NuGet)
550 * [www.nuget.org](http://www.nuget.org)
551 * api.nuget.org
552 * pub.dev (Dart/Flutter)
553 * api.pub.dev
554 * hex.pm (Elixir/Erlang)
555 * [www.hex.pm](http://www.hex.pm)
556 * cpan.org (Perl CPAN)
557 * [www.cpan.org](http://www.cpan.org)
558 * metacpan.org
559 * [www.metacpan.org](http://www.metacpan.org)
560 * api.metacpan.org
561 * cocoapods.org (iOS/macOS)
562 * [www.cocoapods.org](http://www.cocoapods.org)
563 * cdn.cocoapods.org
564 * haskell.org
565 * [www.haskell.org](http://www.haskell.org)
566 * hackage.haskell.org
567 * swift.org
568 * [www.swift.org](http://www.swift.org)
569 </Accordion>
570
571 <Accordion title="Distribuzioni Linux">
572 * archive.ubuntu.com
573 * security.ubuntu.com
574 * ubuntu.com
575 * [www.ubuntu.com](http://www.ubuntu.com)
576 * \*.ubuntu.com
577 * ppa.launchpad.net
578 * launchpad.net
579 * [www.launchpad.net](http://www.launchpad.net)
580 * \*.nixos.org
581 </Accordion>
582
583 <Accordion title="Strumenti di sviluppo e piattaforme">
584 * dl.k8s.io (Kubernetes)
585 * pkgs.k8s.io
586 * k8s.io
587 * [www.k8s.io](http://www.k8s.io)
588 * releases.hashicorp.com (HashiCorp)
589 * apt.releases.hashicorp.com
590 * rpm.releases.hashicorp.com
591 * archive.releases.hashicorp.com
592 * hashicorp.com
593 * [www.hashicorp.com](http://www.hashicorp.com)
594 * repo.anaconda.com (Anaconda/Conda)
595 * conda.anaconda.org
596 * anaconda.org
597 * [www.anaconda.com](http://www.anaconda.com)
598 * anaconda.com
599 * continuum.io
600 * apache.org (Apache)
601 * [www.apache.org](http://www.apache.org)
602 * archive.apache.org
603 * downloads.apache.org
604 * eclipse.org (Eclipse)
605 * [www.eclipse.org](http://www.eclipse.org)
606 * download.eclipse.org
607 * nodejs.org (Node.js)
608 * [www.nodejs.org](http://www.nodejs.org)
609 * developer.apple.com
610 * developer.android.com
611 * pkg.stainless.com
612 * binaries.prisma.sh
613 </Accordion>
614
615 <Accordion title="Servizi cloud e monitoraggio">
616 * statsig.com
617 * [www.statsig.com](http://www.statsig.com)
618 * api.statsig.com
619 * sentry.io
620 * \*.sentry.io
621 * downloads.sentry-cdn.com
622 * http-intake.logs.datadoghq.com
623 * browser-intake-us5-datadoghq.com
624 * \*.datadoghq.com
625 * \*.datadoghq.eu
626 * api.honeycomb.io
627 </Accordion>
628
629 <Accordion title="Distribuzione di contenuti e mirror">
630 * sourceforge.net
631 * \*.sourceforge.net
632 * packagecloud.io
633 * \*.packagecloud.io
634 * fonts.googleapis.com
635 * fonts.gstatic.com
636 </Accordion>
637
638 <Accordion title="Schema e configurazione">
639 * json-schema.org
640 * [www.json-schema.org](http://www.json-schema.org)
641 * json.schemastore.org
642 * [www.schemastore.org](http://www.schemastore.org)
643 </Accordion>
644
645 <Accordion title="Model Context Protocol">
646 * \*.modelcontextprotocol.io
647 </Accordion>
648</AccordionGroup>
649
650<h2 id="move-tasks-between-web-and-terminal">62<h2 id="move-tasks-between-web-and-terminal">
651 Sposta attività tra web e terminale63 Sposta attività tra web e terminale
652</h2>64</h2>
654Questi flussi di lavoro richiedono la [Claude Code CLI](/docs/it/quickstart) 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.66Questi flussi di lavoro richiedono la [Claude Code CLI](/docs/it/quickstart) 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.
655 67
656<Note>68<Note>
657 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](/docs/it/desktop#continue-in-another-surface) fornisce un menu Continua in che può inviare una sessione locale al web.69 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` con una descrizione di compito crea una nuova sessione cloud per il tuo repository attuale; con `-p` e un ID di sessione o URL claude.ai/code invece [accoda un messaggio in quella sessione esistente](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli). L'[app Desktop](/docs/it/desktop#continue-in-another-surface) fornisce un menu Continua in che può inviare una sessione locale al web.
658</Note>70</Note>
659 71
660<h3 id="from-terminal-to-web">72<h3 id="from-terminal-to-web">
667claude --cloud "Fix the authentication bug in src/auth/login.ts"79claude --cloud "Fix the authentication bug in src/auth/login.ts"
668```80```
669 81
670Questo 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`.82Questo crea una nuova sessione cloud su claude.ai. La VM cloud clona il remoto GitHub della tua directory attuale al tuo ramo attuale, non il tuo checkout locale, quindi esegui il push prima se hai commit locali. `--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`.
671 83
672A 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](#setup-scripts), 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.84Mentre il contenitore cloud si avvia, 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](/docs/it/cloud-environments#setup-scripts). Accoda i messaggi che digiti durante il provisioning e li invia una volta che la sessione è pronta.
673 85
674<Note>86<Note>
675 `--cloud` crea sessioni cloud. `--remote-control` non è correlato: espone una sessione CLI locale per il monitoraggio dal web. Vedi [Remote Control](/docs/it/remote-control).87 `--cloud` crea sessioni cloud. `--remote-control` non è correlato: espone una sessione CLI locale per il monitoraggio dal web. Vedi [Remote Control](/docs/it/remote-control).
677 89
678Usa `/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.90Usa `/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.
679 91
92Se Claude pone una domanda e la sessione rimane inattiva, puoi comunque rispondere quando torni, fino a [scadenza dell'ambiente](#environment-expired), e la sessione continua dalla tua risposta.
93
680<h4 id="tips-for-cloud-tasks">94<h4 id="tips-for-cloud-tasks">
681 Suggerimenti per attività cloud95 Suggerimenti per attività cloud
682</h4>96</h4>
693claude --cloud "Execute the migration plan in docs/migration-plan.md"107claude --cloud "Execute the migration plan in docs/migration-plan.md"
694```108```
695 109
696Questo modello ti dà il controllo sulla strategia mentre consente a Claude di eseguire autonomamente nel cloud.
697
698**Pianifica nel cloud con ultraplan**: per elaborare e rivedere il piano stesso in una sessione web, usa [ultraplan](/docs/it/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.
699
700**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:110**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:
701 111
702```bash theme={null}112```bash theme={null}
713 123
714Quando 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.124Quando 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.
715 125
126Su macOS, Linux e WSL, Claude Code lascia fuori dall'upload le modifiche non sottoposte a commit ai file denominati come credenziali o chiavi e nomina i file che ha lasciato fuori. Questo copre i file `.env`, i file Terraform `*.tfvars` e i file di chiave come `id_rsa` e `*.pem`. La sessione inizia con la versione sottoposta a commit di ognuno, o senza il file se nessuno è sottoposto a commit. In un worktree collegato, submodulo o layout simile, Claude Code carica queste modifiche con il resto e nomina i file che carica.
127
716Questo fallback si attiva automaticamente quando l'accesso a GitHub non è disponibile. Per forzarlo anche quando GitHub è connesso, imposta `CCR_FORCE_BUNDLE=1`:128Questo fallback si attiva automaticamente quando l'accesso a GitHub non è disponibile. Per forzarlo anche quando GitHub è connesso, imposta `CCR_FORCE_BUNDLE=1`:
717 129
718```bash theme={null}130```bash theme={null}
726* I file non tracciati non sono inclusi; esegui `git add` sui file che desideri che la sessione cloud veda138* I file non tracciati non sono inclusi; esegui `git add` sui file che desideri che la sessione cloud veda
727* 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](#github-authentication-options) configurata139* 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](#github-authentication-options) configurata
728 140
141<h3 id="send-follow-ups-from-the-cli">
142 Invia follow-up dalla CLI
143</h3>
144
145Una volta che una sessione cloud è in esecuzione, ovunque venga eseguita, inviala un messaggio di follow-up dalla CLI `claude` su qualsiasi macchina dove sei connesso con `claude auth login`. La CLI si autentica con le credenziali del tuo account Anthropic e non invia alcuno stato di sessione locale, quindi il comando non ha bisogno di essere eseguito dalla macchina che ha avviato la sessione, ed è lo stesso in ogni shell, incluso PowerShell.
146
147Il comando pubblica un messaggio e esce:
148
149```bash theme={null}
150claude -p "your message" --cloud <session-id>
151```
152
153La CLI accoda il messaggio nella sessione e esce senza attendere una risposta. Usalo per guidare una sessione di lunga durata, accodare il passaggio successivo mentre quello attuale sta ancora finendo, o inviare follow-up da uno [script CI](/docs/it/self-hosted-environments-testing#run-the-test-loop). Puoi anche inviare il messaggio su stdin invece di passarlo come argomento: `echo "your message" | claude -p --cloud <session-id>`.
154
155Per `<session-id>`, passa l'ID nudo, come `session_...` o `cse_...`, o l'URL `claude.ai/code/<id>` della sessione, con o senza lo schema o la stringa di query. Trova l'ID nel tuo elenco di sessioni su claude.ai/code.
156
157<Note>
158 `--cloud` richiede un account Anthropic. Non è disponibile quando Claude Code è configurato per Amazon Bedrock, Google Cloud's Agent Platform o un altro provider di terze parti. Un [gateway LLM](/docs/it/llm-gateway) configurato solo tramite `ANTHROPIC_BASE_URL` non conta come provider di terze parti per questo controllo, ma devi comunque accedere con `claude auth login`. La politica `allow_remote_sessions` della tua organizzazione deve anche essere abilitata. Un Proprietario può attivarla nelle impostazioni di amministrazione di Claude Code su claude.ai/admin-settings/claude-code.
159</Note>
160
161<h4 id="output-and-errors">
162 Output e errori
163</h4>
164
165Al successo, il comando stampa l'ID della sessione e un link per visualizzare la sessione:
166
167```
168Sent to cloud session.
169Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
170View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0
171```
172
173Passa `--output-format json` per un risultato leggibile da macchina: `{ok, session_id, url}` al successo, o `{ok: false, session_id, error}` quando l'invio fallisce, ad esempio quando la sessione è mancante o archiviata. Gli errori di configurazione, come un provider non supportato o una politica organizzativa disabilitata, vengono stampati su stderr senza JSON. `--output-format stream-json` non è supportato con `--cloud <session-id>`.
174
175La CLI antepone gli errori con `Error: `. Un'entrega fallita è avvolta come `failed to send message to cloud session <id>: <reason>`.
176
177| Messaggio | Cosa significa |
178| --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
179| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code è configurato per un provider di terze parti. Il messaggio nomina il provider con l'etichetta che la tua configurazione utilizza, come `Amazon Bedrock` o `Google Vertex AI`. Rimuovi la configurazione di quel provider, ad esempio annullando l'impostazione di `CLAUDE_CODE_USE_BEDROCK`, e accedi con un account Anthropic (`claude auth login`). |
180| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | La politica organizzativa `allow_remote_sessions` è disattivata. |
181| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code non ha potuto recuperare la politica della tua organizzazione, quindi rifiuta l'invio piuttosto che assumere che le sessioni cloud siano consentite. Controlla la tua connessione di rete e riprova. |
182| `Attaching to an existing cloud session is not enabled for your account.` | Hai eseguito `--cloud <session-id>` senza `-p`. Invia il messaggio con `claude -p "your message" --cloud <session-id>`. |
183| `Session not found: <id>` | L'ID o l'URL non corrisponde a una sessione a cui puoi accedere. Controllalo rispetto all'URL claude.ai/code della sessione. |
184| `cloud session <id> is archived and cannot accept new messages` | La sessione è stata archiviata. Avvia una nuova sessione invece. |
185
729<h3 id="from-web-to-terminal">186<h3 id="from-web-to-terminal">
730 Dal web al terminale187 Dal web al terminale
731</h3>188</h3>
735* **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.192* **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.
736* **Usando `/teleport`**: all'interno di una sessione CLI esistente, esegui `/teleport` o `/tp` per aprire lo stesso selettore di sessione senza riavviare Claude Code.193* **Usando `/teleport`**: all'interno di una sessione CLI esistente, esegui `/teleport` o `/tp` per aprire lo stesso selettore di sessione senza riavviare Claude Code.
737* **Da `/tasks`**: esegui `/tasks` per vedere le tue sessioni in background, quindi premi `t` per teletrasportarti in una.194* **Da `/tasks`**: esegui `/tasks` per vedere le tue sessioni in background, quindi premi `t` per teletrasportarti in una.
738* **Dall'interfaccia web**: seleziona **Open in CLI** per copiare un comando che puoi incollare nel tuo terminale.195* **Dall'interfaccia web**: seleziona **Open in > Terminal** dal menu della sessione per copiare un comando che puoi incollare nel tuo terminale.
196* **Dall'interno della sessione cloud**: digita `/teleport` e Claude Code risponde con il comando esatto `claude --teleport <session-id>` per quella sessione, pronto per essere eseguito da un checkout del repository. Richiede Claude Code v2.1.223 o successivo nell'ambiente della sessione.
739 197
740Quando 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.198Quando 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. Il terminale ottiene la sua propria copia della sessione: il nuovo lavoro lì rimane locale e non appare nella sessione cloud su claude.ai o nell'app mobile Claude. Per continuare a guidare dal tuo telefono dopo il teletrasporto, avvia [`/remote-control`](/docs/it/remote-control) nella sessione locale.
741 199
742`--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.200`--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.
743 201
748Il 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.206Il 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.
749 207
750| Requisito | Dettagli |208| Requisito | Dettagli |
751| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |209| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
752| Stato git pulito | La tua directory di lavoro non deve avere modifiche non sottoposte a commit. Il teletrasporto ti chiede di archiviare le modifiche se necessario. |210| Stato git pulito | La tua directory di lavoro non deve avere modifiche non sottoposte a commit. Il teletrasporto ti chiede di archiviare le modifiche se necessario. |
753| Repository corretto | Devi eseguire `--teleport` da un checkout dello stesso repository, non da un fork. A partire dalla v2.1.199, Claude Code accetta un checkout anche quando non riesce a analizzare il remoto in un nome host, come un alias host SSH come `git@work:owner/repo.git` o una forma breve riscritta con `insteadOf`. Mostra un prompt di conferma per primo, e solo quando il proprietario del remoto e il nome del repository corrispondono al repository della sessione. |211| Repository corretto | Devi eseguire `--teleport` da un checkout dello stesso repository, non da un fork. Se lo esegui da un checkout di un repository diverso, Claude Code mostra un errore che nomina sia il repository della sessione che il tuo checkout. Se Claude Code non riesce ad analizzare il tuo remoto in un nome host, ad esempio un alias host SSH come `git@work:owner/repo.git`, ti chiede di confermare e accetta il checkout quando il proprietario del remoto e il nome del repository corrispondono al repository della sessione. |
754| Ramo disponibile | Il ramo dalla sessione cloud deve essere stato inviato al remoto. Il teletrasporto lo recupera e lo controlla automaticamente. |212| Ramo disponibile | Il ramo dalla sessione cloud deve essere stato inviato al remoto. Il teletrasporto lo recupera e lo controlla automaticamente. |
755| Stesso account | Devi essere autenticato allo stesso account claude.ai utilizzato nella sessione cloud. |213| Stesso account | Devi essere autenticato allo stesso account claude.ai utilizzato nella sessione cloud. |
756 214
758 `--teleport` non è disponibile216 `--teleport` non è disponibile
759</h4>217</h4>
760 218
761Il 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.219Il teletrasporto richiede l'autenticazione dell'abbonamento claude.ai. Se sei autenticato tramite chiave API, esegui `/login` per accedere con il tuo account claude.ai. Se il messaggio di errore nomina il tuo provider, le sessioni cloud non sono disponibili tramite provider di terze parti; vedi la [tabella degli errori](#output-and-errors). Se sei già connesso tramite claude.ai e `--teleport` non è ancora disponibile, la tua organizzazione potrebbe aver disabilitato le sessioni cloud.
762 220
763<h2 id="work-with-sessions">221<h2 id="work-with-sessions">
764 Lavora con le sessioni222 Lavorare con le sessioni
765</h2>223</h2>
766 224
767Le 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.225Le sessioni appaiono nella barra laterale su claude.ai/code. Da lì è possibile rivedere le modifiche, condividere con i colleghi, archiviare il lavoro completato o eliminare le sessioni in modo permanente.
768 226
769<h3 id="manage-context">227<h3 id="manage-context">
770 Gestisci il contesto228 Gestire il contesto
771</h3>229</h3>
772 230
773Le sessioni cloud supportano [comandi integrati](/docs/it/commands) 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:231Le sessioni cloud supportano [comandi integrati](/docs/it/commands) 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:
774 232
775* **`/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à](/docs/it/commands#all-commands) di ogni comando: `/effort` segnala `Not applied` mentre il [launch-default effort hold](/docs/it/model-config#adjust-effort-level) di un modello è in vigore, e `/fast` funziona solo in una sessione che è stata avviata con la modalità veloce attivata.233* **`/model`, `/effort`, `/fast`, `/color` e `/rename`**: passare 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à](/docs/it/commands#all-commands) di ciascun comando: `/effort` segnala `Not applied` mentre il [launch-default effort hold](/docs/it/model-config#adjust-effort-level) di un modello è in vigore, e `/fast` funziona solo in una sessione avviata con la modalità veloce attivata.
776* **`/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](#configure-your-environment) o esegui il commit dei [file di impostazioni](/docs/it/settings) nel repository.234* **`/config`**: sul web, apre la sezione Claude Code delle impostazioni invece di impostare un valore, e il testo dopo il comando, incluso `key=value`, viene ignorato. Per modificare le impostazioni di una sessione cloud, utilizzare [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables) o eseguire il commit dei [file di impostazioni](/docs/it/settings) nel repository.
777 235
778Per la gestione del contesto in particolare:236Per la gestione del contesto in particolare:
779 237
780| Comando | Funziona nelle sessioni cloud | Note |238| Comando | Funziona nelle sessioni cloud | Note |
781| :--------- | :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |239| :--------- | :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------- |
782| `/compact` | Sì | Riassume la conversazione per liberare il contesto. Accetta istruzioni di focus opzionali come `/compact keep the test output` |240| `/compact` | Sì | Riassume la conversazione per liberare contesto. Accetta istruzioni di focus opzionali come `/compact keep the test output` |
783| `/context` | Sì | Mostra cosa è attualmente nella finestra di contesto |241| `/context` | Sì | Mostra cosa è attualmente nella finestra di contesto |
784| `/clear` | No | Avvia una nuova sessione dalla barra laterale |242| `/clear` | No | Avviare una nuova sessione dalla barra laterale |
785 243
786L'auto-compattazione viene eseguita automaticamente quando la finestra di contesto si avvicina alla capacità. Per attivarla prima, imposta [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/it/env-vars) nelle tue [variabili di ambiente](#configure-your-environment). 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`](/docs/it/env-vars).244La compattazione automatica viene eseguita automaticamente quando la finestra di contesto si avvicina alla capacità. Claude Code sul web imposta [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/it/env-vars) nelle sessioni cloud stesso, quindi la compattazione si attiva a metà della [finestra di auto-compattazione](/docs/it/model-config#set-the-auto-compact-window) piuttosto che quando la finestra si riempie. Questo valore sostituisce uno che si aggiunge nelle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables), quindi aggiungere la variabile lì non cambia quando si attiva la compattazione.
787 245
788I [subagent](/docs/it/sub-agents) 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.246Per modificare la finestra di auto-compattazione, impostare [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars) nelle variabili di ambiente, oppure eseguire [`/autocompact`](/docs/it/commands#all-commands) con un conteggio di token in una sessione in cui la variabile non è impostata.
789 247
790I [team di agenti](/docs/it/agent-teams) sono disabilitati per impostazione predefinita ma possono essere abilitati aggiungendo `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` alle tue [variabili di ambiente](#configure-your-environment).248I [Subagenti](/docs/it/sub-agents) funzionano allo stesso modo di quelli locali. Claude può generarli con lo strumento Agent per delegare la ricerca o il lavoro parallelo a una finestra di contesto separata, mantenendo la conversazione principale più leggera. I subagenti definiti nella directory `.claude/agents/` del repository vengono rilevati automaticamente.
249
250I [team di agenti](/docs/it/agent-teams) sono disabilitati per impostazione predefinita ma possono essere abilitati aggiungendo `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` alle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables).
251
252<h3 id="permission-modes-in-cloud-sessions">
253 Modalità di autorizzazione nelle sessioni cloud
254</h3>
255
256Si sceglie la [modalità di autorizzazione](/docs/it/permission-modes) di una sessione cloud dal [menu a discesa della modalità](/docs/it/permission-modes#switch-permission-modes), sia quando si crea l'attività che mentre la sessione è in esecuzione. Quando si riapre una sessione il cui [ambiente ospitato da Anthropic è scaduto](#environment-expired), o si invia un messaggio a una sessione che un runner self-hosted [ha rilasciato mentre era inattivo](/docs/it/self-hosted-environments-reference#runner-cli-flags), Claude Code riprende la sessione nella modalità di autorizzazione in cui si trovava.
791 257
792<h3 id="review-changes">258<h3 id="review-changes">
793 Rivedi le modifiche259 Rivedere le modifiche
794</h3>260</h3>
795 261
796Ogni 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](/docs/it/web-quickstart#review-and-iterate) 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](#auto-fix-pull-requests).262Ogni sessione mostra un indicatore di diff con righe aggiunte e rimosse, come `+42 -18`. Selezionarlo per aprire la visualizzazione diff, lasciare commenti in linea su righe specifiche e inviarli a Claude con il messaggio successivo.
263
264Claude Code calcola questi diff, inclusi i diff per file mostrati mentre Claude modifica, dal contenuto grezzo del blob git, quindi i driver diff e i filtri `textconv` configurati nel repository non si applicano.
265
266Vedere [Rivedere e iterare](/docs/it/web-quickstart#review-and-iterate) per la procedura dettagliata completa inclusa la creazione di PR. Per fare in modo che Claude monitori automaticamente la PR per errori CI e commenti di revisione, vedere [Correzione automatica delle pull request](#auto-fix-pull-requests).
797 267
798<h3 id="share-sessions">268<h3 id="share-sessions">
799 Condividi sessioni269 Condividere sessioni
800</h3>270</h3>
801 271
802Per 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.272Per condividere una sessione, attivare/disattivare la sua visibilità in base ai tipi di account di seguito. Dopo di che, condividere il collegamento della sessione così com'è. I destinatari vedono lo stato più recente quando aprono il collegamento, ma la loro visualizzazione non si aggiorna in tempo reale.
803 273
804<h4 id="share-from-an-enterprise-or-team-account">274<h4 id="share-from-an-enterprise-or-team-account">
805 Condividi da un account Enterprise o Team275 Condividere da un account Enterprise o Team
806</h4>276</h4>
807 277
808Per 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](/docs/it/slack) vengono condivise automaticamente con visibilità Team.278Per gli account Enterprise e Team, le due opzioni di visibilità sono **Private** e **Team**. La visibilità Team rende la sessione visibile agli altri membri dell'organizzazione claude.ai. Le sessioni di [Claude in Slack](/docs/it/slack) vengono condivise automaticamente con visibilità Team.
809 279
810La 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.280La verifica dell'accesso al repository è abilitata per impostazione predefinita, in base all'account GitHub connesso all'account del destinatario. Il nome visualizzato dell'account è visibile a tutti i destinatari con accesso.
811 281
812<h4 id="share-from-a-max-or-pro-account">282<h4 id="share-from-a-max-or-pro-account">
813 Condividi da un account Max o Pro283 Condividere da un account Max o Pro
814</h4>284</h4>
815 285
816Per 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.286Per 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.
817 287
818Controlla 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.288Controllare la 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.
819 289
820Per 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.290Per richiedere ai destinatari di avere accesso al repository, o per nascondere il nome dalle sessioni condivise, andare a [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code).
821 291
822<h3 id="archive-sessions">292<h3 id="archive-sessions">
823 Archivia sessioni293 Archiviare sessioni
824</h3>294</h3>
825 295
826Puoi 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.296È possibile archiviare le sessioni per mantenere organizzato l'elenco delle sessioni. Le sessioni archiviate sono nascoste dall'elenco di sessioni predefinito ma possono essere visualizzate filtrando per sessioni archiviate.
827 297
828Per archiviare una sessione, passa il mouse sulla sessione nella barra laterale e seleziona l'icona di archiviazione.298Per archiviare una sessione, passare il mouse sulla sessione nella barra laterale e selezionare l'icona di archivio.
829 299
830<h3 id="delete-sessions">300<h3 id="delete-sessions">
831 Elimina sessioni301 Eliminare sessioni
832</h3>302</h3>
833 303
834L'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:304L'eliminazione di una sessione rimuove in modo permanente la sessione e i suoi dati. Questa azione non può essere annullata. È possibile eliminare una sessione in due modi:
835 305
836* **Dalla barra laterale**: filtra le sessioni archiviate, quindi passa il mouse sulla sessione che desideri eliminare e seleziona l'icona di eliminazione306* **Dalla barra laterale**: filtrare per sessioni archiviate, quindi passare il mouse sulla sessione che si desidera eliminare e selezionare l'icona di eliminazione
837* **Dal menu della sessione**: apri una sessione, seleziona il menu a discesa accanto al titolo della sessione e seleziona **Elimina**307* **Dal menu della sessione**: aprire una sessione, selezionare l'elenco a discesa accanto al titolo della sessione e selezionare **Delete**
838 308
839Ti verrà chiesto di confermare prima che una sessione venga eliminata.309Ti verrà chiesto di confermare prima che una sessione venga eliminata.
840 310
845Claude 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.315Claude 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.
846 316
847<Note>317<Note>
848 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](https://github.com/apps/claude) o quando richiesto durante la [configurazione](/docs/it/web-quickstart#connect-github-and-create-an-environment).318 Auto-fix richiede che l'app Claude GitHub sia installata nel tuo repository. Se non l'hai già fatto, installala dalla [pagina dell'app GitHub](https://github.com/apps/claude).
849</Note>319</Note>
850 320
851Ci sono alcuni modi per attivare auto-fix a seconda da dove proviene la PR e quale dispositivo state utilizzando:321Ci sono alcuni modi per attivare auto-fix a seconda da dove proviene la PR e quale dispositivo stai utilizzando:
852 322
853* **PR create in Claude Code sul web**: aprite la barra di stato CI e selezionate **Auto-fix**323* **PR create in Claude Code sul web**: apri la barra di stato CI e seleziona **Auto-fix**
854* **Dal vostro terminale**: eseguite [`/autofix-pr`](/docs/it/commands) mentre siete sul ramo della PR. Claude Code rileva la PR aperta con `gh`, genera una sessione web e attiva auto-fix in un passaggio324* **Dal tuo terminale**: esegui [`/autofix-pr`](/docs/it/commands) mentre sei sul ramo della PR. Claude Code rileva la PR aperta con `gh`, genera una sessione web e attiva auto-fix in un passaggio
855* **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"325* **Dall'app mobile**: dì a Claude di correggere automaticamente la PR, ad esempio "watch this PR and fix any CI failures or review comments"
856* **Qualsiasi PR esistente**: incollate l'URL della PR in una sessione e dite a Claude di correggerla automaticamente326* **Qualsiasi PR esistente**: incolla l'URL della PR in una sessione e dì a Claude di correggerla automaticamente
857 327
858Auto-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.328Auto-fix è un interruttore per PR. Per smettere di monitorare, apri la barra di stato CI nella sessione web e deseleziona l'interruttore **Auto-fix**, oppure dì a Claude di smettere di monitorare la PR.
859 329
860<h3 id="how-claude-responds-to-pr-activity">330<h3 id="how-claude-responds-to-pr-activity">
861 Come Claude risponde all'attività PR331 Come Claude risponde all'attività PR
864Quando 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:334Quando 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:
865 335
866* **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 sessione336* **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
867* **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 agire337* **Richieste ambigue**: se il commento di un revisore potrebbe essere interpretato in più modi o coinvolge qualcosa di architettonicamente significativo, Claude ti chiede prima di agire
868* **Eventi duplicati o senza azione**: se un evento è un duplicato o non richiede modifiche, Claude lo annota nella sessione e continua338* **Eventi duplicati o senza azione**: se un evento è un duplicato o non richiede modifiche, Claude lo annota nella sessione e continua
869 339
870GitHub 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.340GitHub 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, apri la sessione e chiedi a Claude di eseguire il rebase.
871 341
872Claude 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.342Claude potrebbe rispondere ai thread di commenti di revisione su GitHub come parte della loro risoluzione. Queste risposte vengono pubblicate utilizzando il tuo account GitHub, quindi appaiono sotto il tuo 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 te direttamente.
873 343
874<Warning>344<Warning>
875 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.345 Se il tuo repository utilizza automazione attivata da commenti come Atlantis, Terraform Cloud o GitHub Actions personalizzate che vengono eseguite su eventi `issue_comment`, tieni presente che Claude può rispondere per tuo conto, il che può attivare questi flussi di lavoro. Rivedi l'automazione del tuo repository prima di abilitare auto-fix e considera di disabilitare auto-fix per i repository in cui un commento PR può distribuire infrastruttura o eseguire operazioni privilegiate.
876</Warning>346</Warning>
877 347
878<h2 id="security-and-isolation">348<h2 id="security-and-isolation">
881 351
882Ogni sessione cloud è separata dalla tua macchina e dalle altre sessioni attraverso diversi livelli:352Ogni sessione cloud è separata dalla tua macchina e dalle altre sessioni attraverso diversi livelli:
883 353
884* **Macchine virtuali isolate**: ogni sessione viene eseguita in una VM isolata gestita da Anthropic354* **Macchine virtuali isolate**: ogni sessione viene eseguita in una VM isolata gestita da Anthropic. Le sessioni che la tua organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sulla tua infrastruttura, dove l'isolamento è responsabilità della tua distribuzione
885* **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.355* **Controlli di accesso alla rete**: negli ambienti ospitati da Anthropic, l'accesso alla rete è limitato per impostazione predefinita e può essere disabilitato. In un ambiente self-hosted, limiti l'uscita della sessione al tuo confine di rete. 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.
886* **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.356* **Protezione delle credenziali**: negli ambienti ospitati da Anthropic, le credenziali git e le chiavi di firma rimangono al di fuori della sandbox e un proxy autentica per conto della sessione con credenziali con ambito. In un ambiente self-hosted, la tua distribuzione fornisce credenziali git; vedi [Configura git](/docs/it/self-hosted-environments-deploy#configure-git)
887* **Analisi sicura**: il codice viene analizzato e modificato all'interno di VM isolate prima di creare PR357* **Credenziali API**: negli ambienti ospitati da Anthropic nei piani Pro e Max, le chiavi che [aggiungi a un ambiente cloud](/docs/it/cloud-environments#add-api-credentials) rimangono al di fuori della sandbox allo stesso modo, allegate alle richieste corrispondenti dopo che lasciano la sessione. Un ambiente self-hosted non ha credenziali API e i piani Team ed Enterprise non le hanno ancora
358* **Analisi sicura**: il codice viene analizzato e modificato all'interno dell'ambiente isolato della sessione prima di creare PR
888 359
889<h2 id="troubleshooting">360<h2 id="troubleshooting">
890 Risoluzione dei problemi361 Risoluzione dei problemi
896 Creazione della sessione non riuscita367 Creazione della sessione non riuscita
897</h3>368</h3>
898 369
899Se una nuova sessione non si avvia con `Session creation failed` o si blocca al provisioning, Claude Code non ha potuto allocare un ambiente cloud.370Se una nuova sessione non si avvia con `Session creation failed` o si blocca al provisioning, Claude Code non ha potuto allocare una VM per la sessione.
900 371
901* Controlla [status.claude.com](https://status.claude.com) per gli incidenti delle sessioni cloud372* Controlla [status.claude.com](https://status.claude.com) per gli incidenti delle sessioni cloud
902* Riprova dopo un minuto, poiché la capacità viene fornita su richiesta373* Riprova dopo un minuto, poiché la capacità viene fornita su richiesta
903* 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](#github-authentication-options).374* 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](#github-authentication-options).
904 375
376<h3 id="unable-to-get-organization-uuid">
377 Impossibile ottenere l'UUID dell'organizzazione
378</h3>
379
380`claude --cloud` e `claude --teleport` richiedono l'accesso con un account claude.ai. Se ti autentichi con una chiave API, o i dettagli dell'account archiviati sono obsoleti, questi comandi falliscono con `Unable to get organization UUID` o un messaggio che l'autenticazione con chiave API non è sufficiente. Con l'autenticazione con chiave API o i dettagli dell'account obsoleti, l'esecuzione di `claude --teleport` senza un ID di sessione mostra `Error loading Claude Code sessions` nel selettore di sessione invece di uno dei due messaggi, e la stessa correzione si applica.
381
382Esegui `/login` per accedere con il tuo account claude.ai, quindi riprova il comando. Se il messaggio nomina il tuo provider, vedi la [tabella degli errori](#output-and-errors): le sessioni cloud non sono disponibili tramite provider di terze parti.
383
905<h3 id="remote-control-session-expired-or-access-denied">384<h3 id="remote-control-session-expired-or-access-denied">
906 Sessione Remote Control scaduta o accesso negato385 Sessione Remote Control scaduta o accesso negato
907</h3>386</h3>
910 389
911* Esegui `/login` localmente per aggiornare le tue credenziali, quindi riconnettiti390* Esegui `/login` localmente per aggiornare le tue credenziali, quindi riconnettiti
912* Conferma che sei connesso allo stesso account che possiede la sessione391* Conferma che sei connesso allo stesso account che possiede la sessione
913* Se vedi `Remote Control may not be available for this organization`, un Owner non ha abilitato le sessioni cloud per la tua organizzazione392* Se vedi `Remote Control may not be available for this organization`, un Proprietario non ha abilitato le sessioni cloud per la tua organizzazione
914 393
915<h3 id="environment-expired">394<h3 id="environment-expired">
916 Ambiente scaduto395 Ambiente scaduto
917</h3>396</h3>
918 397
919Le 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.398Le sessioni cloud si fermano dopo un periodo di inattività e la VM della sessione viene recuperata. Sul web, la sessione è contrassegnata come scaduta nell'elenco delle sessioni.
920 399
921Riapri la sessione da [claude.ai/code](https://claude.ai/code) per fornire un ambiente fresco con la cronologia della conversazione ripristinata.400Riapri la sessione da [claude.ai/code](https://claude.ai/code) per fornire una VM fresca con la cronologia della conversazione ripristinata. Il lavoro in background che era ancora in esecuzione quando la VM è stata recuperata, come subagent e comandi shell, non viene ripristinato.
922 401
923<h2 id="limitations">402<h2 id="limitations">
924 Limitazioni403 Limitazioni
928 407
929* **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.408* **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.
930* **Autenticazione del repository**: puoi spostare le sessioni da web a locale solo quando sei autenticato allo stesso account409* **Autenticazione del repository**: puoi spostare le sessioni da web a locale solo quando sei autenticato allo stesso account
931* **Restrizioni della piattaforma**: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di [GitHub Enterprise Server](/docs/it/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](#send-local-repositories-without-github), ma la sessione non può eseguire il push dei risultati di nuovo al remoto410* **Restrizioni della piattaforma**: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di [GitHub Enterprise Server](/docs/it/github-enterprise-server) sono supportate per i piani Team ed Enterprise. GitLab, Bitbucket e altri repository non GitHub possono essere inviati alle sessioni cloud come [bundle locale](#send-local-repositories-without-github), ma la sessione non può eseguire il push dei risultati di nuovo al remoto
932* **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](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) abilitato, ogni sessione cloud fallisce con un errore di autenticazione. Lo stesso vale per [Code Review](/docs/it/code-review) e [Routines](/docs/it/routines). Contatta il [supporto Anthropic](https://support.claude.com/) per esentare i servizi ospitati da Anthropic dall'elenco IP consentiti della tua organizzazione.411* **Elenco IP consentiti dell'organizzazione**: le sessioni cloud chiamano l'API Anthropic dall'infrastruttura gestita da Anthropic, non dalla tua rete, mentre le sessioni in un [ambiente self-hosted](/docs/it/self-hosted-environments) la chiamano dalla tua rete. Se la tua organizzazione ha [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) abilitato, ogni sessione cloud ospitata da Anthropic fallisce con un errore di autenticazione. Lo stesso vale per [Code Review](/docs/it/code-review) e per [Routine](/docs/it/routines) che vengono eseguite su ambienti ospitati da Anthropic; una routine instradata a un ambiente self-hosted chiama l'API dalla tua rete. Contatta il [supporto Anthropic](https://support.claude.com/) per esentare i servizi ospitati da Anthropic dall'elenco IP consentiti della tua organizzazione.
933 412
934<h2 id="related-resources">413<h2 id="related-resources">
935 Risorse correlate414 Risorse correlate
936</h2>415</h2>
937 416
938* [Ultraplan](/docs/it/ultraplan): elabora un piano in una sessione cloud e revisionalo nel tuo browser417* [Ambienti cloud](/docs/it/cloud-environments): configura l'accesso alla rete, le variabili di ambiente e gli script di configurazione per le sessioni cloud
939* [Ultrareview](/docs/it/ultrareview): esegui una profonda revisione del codice multi-agente in una sandbox cloud418* [Ultrareview](/docs/it/ultrareview): esegui una profonda revisione del codice multi-agente in una sandbox cloud
940* [Routines](/docs/it/routines): automatizza il lavoro su una pianificazione, tramite chiamata API o in risposta agli eventi GitHub419* [Routine](/docs/it/routines): automatizza il lavoro su una pianificazione, tramite chiamata API o in risposta agli eventi GitHub
941* [Configurazione degli hook](/docs/it/hooks): esegui script agli eventi del ciclo di vita della sessione420* [Configurazione degli hook](/docs/it/hooks): esegui script agli eventi del ciclo di vita della sessione
942* [Riferimento delle impostazioni](/docs/it/settings): tutte le opzioni di configurazione421* [Tutte le impostazioni](/docs/it/settings-reference): tutte le opzioni di configurazione
943* [Sicurezza](/docs/it/security): garanzie di isolamento e gestione dei dati422* [Sicurezza](/docs/it/security): garanzie di isolamento e gestione dei dati
944* [Utilizzo dei dati](/docs/it/data-usage): cosa Anthropic conserva dalle sessioni cloud423* [Utilizzo dei dati](/docs/it/data-usage): cosa Anthropic conserva dalle sessioni cloud
945* [Claude Tag](https://claude.com/docs/claude-tag/overview): un @Claude gestito dall'organizzazione in Slack che viene eseguito nello stesso ambiente cloud424* [Claude Tag](https://claude.com/docs/claude-tag/overview): un @Claude gestito dall'organizzazione in Slack che viene eseguito sulla stessa infrastruttura cloud