44 Avvia una sessione44 Avvia una sessione
45</h2>45</h2>
46 46
47Prima di inviare il tuo primo messaggio, configura quattro cose nell'area del prompt:47Prima di inviare il tuo primo messaggio, scegli l'ambiente, la cartella del progetto, la modalità di permesso e il modello nella riga sotto la casella del prompt:
48 48
49* **Ambiente**: scegli dove Claude viene eseguito. Seleziona **Local** per la tua macchina, **Cloud** per una [sessione cloud](#cloud-sessions) che continua dopo aver chiuso l'app, una [**connessione SSH**](#ssh-sessions) per una macchina remota che gestisci, o su Windows una [**distribuzione WSL**](/docs/it/desktop-wsl). Un'attività in una sessione SSH può [continuare mentre Desktop è disconnesso](#keep-a-task-running-while-desktop-is-disconnected), ma con un account Claude può interrompersi quando il suo accesso scade. Vedi [configurazione dell'ambiente](#environment-configuration).49* **Ambiente**: usa il selettore dell'ambiente, il primo controllo della riga, per scegliere dove Claude viene eseguito. Vedi [configurazione dell'ambiente](#environment-configuration).
50* **Cartella del progetto**: seleziona la cartella o il repository su cui Claude lavora. Per le sessioni cloud, puoi aggiungere [più repository](#run-long-running-tasks-in-the-cloud).50 * Se una nuova sessione non ha il selettore dell'ambiente sotto la casella del prompt, segui i [passaggi del layout precedente](#check-which-layout-you-have).
51* **Modello**: scegli un [modello](/docs/it/model-config#available-models) dal menu a discesa accanto al pulsante di invio. Puoi cambiare questo durante la sessione.51* **Cartella del progetto**: fai clic sul controllo della cartella del progetto, accanto al selettore dell'ambiente, per scegliere la cartella su cui Claude lavora.
52* **Modalità di autorizzazione**: scegli quanta autonomia ha Claude dal [selettore di modalità](#choose-a-permission-mode). Puoi cambiare questo durante la sessione.52 * **Sessione cloud**: seleziona dei [repository](#run-long-running-tasks-in-the-cloud) invece di una cartella
53 * **[Ambiente locale o SSH salvato](#create-a-saved-environment)**: l'ambiente contiene già le sue cartelle, quindi la riga non mostra alcun controllo della cartella del progetto. Per cambiare le cartelle, [modifica l'ambiente](#use-edit-or-remove-a-saved-environment).
54* **Modalità di permesso**: usa il [selettore di modalità](#choose-a-permission-mode) per scegliere quanta autonomia ha Claude. Puoi cambiare la modalità di permesso durante la sessione.
55* **Modello**: scegli un [modello](/docs/it/model-config#available-models) dal selettore del modello verso l'estremità destra della riga. Puoi cambiare il modello durante la sessione.
53 56
54Digita il tuo compito e premi **Invio** per iniziare. Ogni sessione traccia il suo proprio contesto e le modifiche in modo indipendente.57Digita il tuo compito e premi **Invio** per iniziare. Ogni sessione traccia il suo proprio contesto e le modifiche in modo indipendente.
55 58
65 68
66Digita quello che vuoi che Claude faccia e premi **Invio** per inviare. Claude legge i file del tuo progetto, apporta modifiche ed esegue comandi in base alla tua [modalità di permesso](#choose-a-permission-mode). Puoi interrompere Claude in qualsiasi momento: fai clic sul pulsante di arresto per interrompere immediatamente, oppure digita una correzione e premi **Invio** per inviarla senza interrompere l'azione in corso. Claude legge la correzione non appena l'azione corrente si completa e si adatta prima del suo passo successivo.69Digita quello che vuoi che Claude faccia e premi **Invio** per inviare. Claude legge i file del tuo progetto, apporta modifiche ed esegue comandi in base alla tua [modalità di permesso](#choose-a-permission-mode). Puoi interrompere Claude in qualsiasi momento: fai clic sul pulsante di arresto per interrompere immediatamente, oppure digita una correzione e premi **Invio** per inviarla senza interrompere l'azione in corso. Claude legge la correzione non appena l'azione corrente si completa e si adatta prima del suo passo successivo.
67 70
68Il pulsante **+** accanto alla casella del prompt ti dà accesso agli allegati di file, [skill](#use-skills), [connettori](#connect-external-tools) e [plugin](#install-plugins).71Fai clic sul pulsante **+** accanto alla casella del prompt per allegati di file, [skill](#use-skills), [connettori](#connect-external-tools) e [plugin](#install-plugins).
69 72
70<h3 id="accept-a-suggested-prompt">73<h3 id="accept-a-suggested-prompt">
71 Accetta un prompt suggerito74 Accetta un prompt suggerito
82 Aggiungi file e contesto ai prompt85 Aggiungi file e contesto ai prompt
83</h3>86</h3>
84 87
85La casella del prompt supporta due modi per portare contesto esterno:88Per dare un file a Claude, menzionalo con @ o allegalo nella casella del prompt:
86 89
87* **@mention file**: digita `@` seguito da un nome di file per aggiungere un file al contesto della conversazione. Claude può quindi leggere e fare riferimento a quel file. @mention non è disponibile nelle sessioni cloud o WSL.90* **@mention file**: digita `@` seguito da un nome di file per aggiungere un file al contesto della conversazione.
88* **Allega file**: allega immagini, PDF e altri file al tuo prompt usando il pulsante di allegato, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.91 * **In una sessione cloud**: `@` può elencare i file solo dopo che hai inviato il tuo primo messaggio. Se `@` non ne elenca nessuno, invia il tuo primo messaggio senza il file, poi menziona il file con @ nel messaggio successivo.
92* **Allega file**: allega immagini, PDF e altri file al tuo prompt dal pulsante **+** accanto alla casella del prompt, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.
93 * **In una [sessione WSL](/docs/it/desktop-wsl)**: se il menu **+** mostra **Add image** invece di **Add files or photos**, puoi allegare solo immagini. Per dare a Claude qualsiasi altro file dalla cartella della sessione, menzionalo con @.
89 94
90<h3 id="choose-a-permission-mode">95<h3 id="choose-a-permission-mode">
91 Scegli una modalità di permesso96 Scegli una modalità di permesso
92</h3>97</h3>
93 98
94Le modalità di permesso controllano quanta autonomia ha Claude durante una sessione: se chiede prima di modificare file, eseguire comandi o entrambi. Puoi cambiare modalità di permesso in qualsiasi momento usando il selettore di modalità accanto al pulsante di invio. Per approvare ogni modifica tu stesso, passa a Manual.99Le modalità di permesso controllano quanta autonomia ha Claude durante una sessione: se chiede prima di modificare file, eseguire comandi o entrambi. Puoi cambiare modalità di permesso in qualsiasi momento usando il selettore di modalità nella riga sotto la casella del prompt. Per approvare ogni modifica tu stesso, passa a Manual.
95 100
96Per impostare una modalità predefinita per le nuove sessioni locali, aggiungi `permissions.defaultMode` al tuo [file di impostazioni](/docs/it/settings#where-settings-live). L'app desktop legge gli stessi file di impostazioni della CLI. Una modalità che scegli nel selettore viene ricordata per cartella e ha la precedenza su `defaultMode` per quella cartella, tranne Plan, che si applica solo alla sessione corrente.101Per impostare una modalità predefinita per le nuove sessioni locali, aggiungi `permissions.defaultMode` al tuo [file di impostazioni](/docs/it/settings#where-settings-live). L'app desktop legge gli stessi file di impostazioni della CLI. Una modalità che scegli nel selettore viene ricordata per cartella e ha la precedenza su `defaultMode` per quella cartella, tranne Plan, che si applica solo alla sessione corrente.
97 102
129 134
130Claude può avviare un server di sviluppo e aprirlo nel riquadro Browser per verificare le sue modifiche. Questo funziona per app web frontend così come per server backend: Claude può testare endpoint API, visualizzare log del server e iterare su problemi che trova. Nella maggior parte dei casi, Claude avvia il server automaticamente dopo aver modificato i file del progetto. Puoi anche chiedere a Claude di visualizzare un'anteprima in qualsiasi momento. Per impostazione predefinita, Claude [verifica automaticamente](#auto-verify-changes) le modifiche dopo ogni modifica.135Claude può avviare un server di sviluppo e aprirlo nel riquadro Browser per verificare le sue modifiche. Questo funziona per app web frontend così come per server backend: Claude può testare endpoint API, visualizzare log del server e iterare su problemi che trova. Nella maggior parte dei casi, Claude avvia il server automaticamente dopo aver modificato i file del progetto. Puoi anche chiedere a Claude di visualizzare un'anteprima in qualsiasi momento. Per impostazione predefinita, Claude [verifica automaticamente](#auto-verify-changes) le modifiche dopo ogni modifica.
131 136
132Il riquadro Browser può anche aprire file HTML statici, PDF, immagini e video dal tuo progetto. Fai clic su un percorso HTML, PDF, immagine o video nella chat per aprirlo lì.137In una sessione locale, fai clic su un percorso HTML, PDF o video nella chat per aprirlo nel riquadro Browser.
133 138
134<Note>139<Note>
135 In una [sessione SSH](#ssh-sessions), Claude non può aprire la tua app nel riquadro Browser, perché lì non ha a disposizione gli strumenti del riquadro. Per vedere l'app tu stesso, [inoltra la sua porta al tuo computer](#reach-a-port-on-the-remote-machine).140 In una [sessione SSH](#ssh-sessions), Claude non può aprire la tua app nel riquadro Browser, perché lì non ha a disposizione gli strumenti del riquadro. Per vedere l'app tu stesso, [inoltra la sua porta al tuo computer](#reach-a-port-on-the-remote-machine).
136</Note>141</Note>
137 142
143Se il riquadro Browser non è aperto dopo che Claude avvia un server in una sessione locale, fai clic su **Open** nella scheda del server nella chat.
144
138Dal riquadro Browser, puoi:145Dal riquadro Browser, puoi:
139 146
140* Interagire con la tua app in esecuzione direttamente nel riquadro Browser147* Interagire con la tua app in esecuzione direttamente nel riquadro Browser
185 Rivedi le modifiche con la visualizzazione diff192 Rivedi le modifiche con la visualizzazione diff
186</h3>193</h3>
187 194
188Dopo che Claude apporta modifiche al tuo codice, la visualizzazione diff ti consente di rivedere le modifiche file per file prima di creare una pull request.195Dopo che Claude apporta modifiche al tuo codice, la visualizzazione diff ti consente di rivedere le modifiche file per file prima di creare una pull request. Per aprire la visualizzazione diff, fai clic sui conteggi delle righe, come `+12 -1`, nella scheda **Changes** del [pannello dei dettagli della sessione](#see-session-details). Puoi anche fare clic su **Changes** nella barra del titolo della sessione.
189
190Quando Claude modifica i file, appare un indicatore di statistiche diff che mostra il numero di righe aggiunte e rimosse, come `+12 -1`. Fai clic su questo indicatore per aprire il visualizzatore diff, che visualizza un elenco di file a sinistra e le modifiche per ogni file a destra.
191 196
192Per commentare righe specifiche, fai clic su qualsiasi riga nel diff per aprire una casella di commento. Digita il tuo feedback e premi **Invio** per aggiungere il commento. Dopo aver aggiunto commenti a più righe, invia tutti i commenti contemporaneamente:197Per commentare righe specifiche, fai clic su qualsiasi riga nel diff per aprire una casella di commento. Digita il tuo feedback e premi **Invio** per aggiungere il commento. Dopo aver aggiunto commenti a più righe, invia tutti i commenti contemporaneamente:
193 198
213 Monitora lo stato della pull request218 Monitora lo stato della pull request
214</h3>219</h3>
215 220
216Dopo aver aperto una pull request, una barra di stato CI appare nella sessione. Claude Code utilizza GitHub CLI per eseguire il polling dei risultati dei controlli e visualizzare i guasti.221Per far correggere a Claude i controlli non riusciti, o per far eseguire a GitHub il merge della pull request, attiva **Auto-fix** o **Merge when ready**. Dopo aver aperto una pull request, questa appare nella scheda **Changes** del [pannello dei dettagli della sessione](#see-session-details) con lo stato dei suoi controlli CI. Apri il menu **⋮** accanto al suo titolo:
217 222
218* **Auto-fix CI & address comments**: quando abilitato, Claude tenta automaticamente di correggere i controlli CI non riusciti leggendo l'output del fallimento e iterando. In una sessione locale, Claude gestisce anche i nuovi commenti di revisione lasciati da qualcuno diverso da te, quando l'autore è il proprietario del repository, un membro dell'organizzazione, un collaboratore o una GitHub App.223* **Auto-fix**: in una sessione locale, Claude gestisce anche i nuovi commenti di revisione lasciati da qualcuno diverso da te. L'autore del commento deve essere il proprietario del repository, un membro dell'organizzazione, un collaboratore o una GitHub App.
219* **Auto-merge when ready**: quando abilitato, Claude esegue il merge della PR una volta che tutti i controlli passano. Il metodo di merge è squash. Abilita prima l'auto-merge nelle [impostazioni del tuo repository GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository); senza di esso, Claude non può eseguire il merge della PR.224* **Merge when ready**: attiva l'auto-merge di GitHub per la PR. In una sessione locale, Desktop richiede uno squash merge a meno che il branch di base non utilizzi una merge queue.
225 * **Nelle sessioni SSH e WSL**: **Merge when ready** è disabilitato, quindi attiva l'auto-merge per la pull request su GitHub
226 * **Se il repository non consente l'auto-merge**: **Merge when ready** non si attiva, quindi abilita prima l'auto-merge nelle [impostazioni del tuo repository GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)
227* **[Layout precedente](#check-which-layout-you-have)**: una volta che la sessione ha una pull request, fai clic su **CI** nella sua barra di stato.
220 228
221Per attivarli, fai clic su **CI** nella barra di stato. Per archiviare la sessione automaticamente una volta che la PR viene sottoposta a merge o chiusa, attiva [auto-archive](#work-in-parallel-with-sessions) in **Impostazioni > Claude Code**.229Per archiviare la sessione automaticamente una volta che la PR viene sottoposta a merge o chiusa, attiva [auto-archive](#archive-a-session) in **Impostazioni > Claude Code**.
222 230
223<Note>231<Note>
224 Il monitoraggio delle PR richiede che [GitHub CLI (`gh`)](https://cli.github.com/) sia installato e autenticato sulla tua macchina. Se `gh` non è installato, Desktop ti chiede di installarlo la prima volta che tenti di creare una PR.232 Il monitoraggio delle PR richiede che [GitHub CLI (`gh`)](https://cli.github.com/) sia installato e autenticato sulla tua macchina. Se `gh` non è installato, Desktop ti chiede di installarlo la prima volta che tenti di creare una PR.
235Per lavorare su più schermi, estrai un pannello come il diff o il terminale in una finestra propria e riancoralo quando hai finito. Claude continua a lavorare nella finestra principale.243Per lavorare su più schermi, estrai un pannello come il diff o il terminale in una finestra propria e riancoralo quando hai finito. Claude continua a lavorare nella finestra principale.
236 244
237<Note>245<Note>
238 Il layout del pannello, il terminale, l'editor di file e le modalità di visualizzazione in questa sezione richiedono Claude Desktop v1.2581.0 o successivo. Apri **Claude → Check for Updates** su macOS o **Help → Check for Updates** su Windows per aggiornare.246 Il layout del pannello, il terminale, l'editor di file e le modalità di visualizzazione in questa sezione richiedono Claude Desktop v1.2581.0 o successivo. Apri **Claude > Check for Updates…** su macOS o **Help > Check for Updates…** su Windows per aggiornare.
239</Note>247</Note>
240 248
249<h3 id="see-session-details">
250 Visualizza i dettagli della sessione
251</h3>
252
253Il pannello dei dettagli della sessione è un insieme di schede accanto alla chat che mostrano dove viene eseguita la sessione, cosa ha modificato e cosa sta eseguendo. Il pannello appare dopo che avvii una sessione, purché la chat sia abbastanza larga da contenerlo.
254
255<h4 id="hide-or-show-the-session-details-panel">
256 Nascondi o mostra il pannello dei dettagli della sessione
257</h4>
258
259Per nascondere o mostrare il pannello, fai clic su **Hide session rail** o **Show session rail** nella barra del titolo della sessione, oppure nel menu **⋮** della barra quando la finestra è stretta. Se ancora non vedi il pannello, [verifica quale layout della scheda Code hai](#check-which-layout-you-have).
260
241<h3 id="run-commands-in-the-terminal">261<h3 id="run-commands-in-the-terminal">
242 Esegui comandi nel terminale262 Esegui comandi nel terminale
243</h3>263</h3>
244 264
245Il terminale integrato ti consente di eseguire comandi insieme alla tua sessione senza passare a un'altra app. Fai clic su **Terminal** nella barra del titolo della sessione o premi **Ctrl+\`** su macOS o Windows. Il terminale si apre nella directory di lavoro della tua sessione e condivide lo stesso ambiente di Claude, quindi comandi come `npm test` o `git status` vedono gli stessi file che Claude sta modificando. Per aprire una seconda scheda del terminale, fai clic su **+** nell'header del pannello del terminale o fai clic con il pulsante destro su una cartella nella chat per scegliere **Open in terminal**.265Il terminale integrato ti consente di eseguire comandi insieme alla tua sessione senza passare a un'altra app. Fai clic su **Terminal** nella barra del titolo della sessione o premi **Ctrl+\`** su macOS o Windows. Il terminale si apre nella directory di lavoro della tua sessione e condivide lo stesso ambiente di Claude, quindi comandi come `npm test` o `git status` vedono gli stessi file che Claude sta modificando. Per aprire una seconda scheda del terminale, fai clic su **+** nell'header del pannello del terminale o fai clic con il pulsante destro su una cartella nella chat per scegliere **Open in terminal**.
246 266
247Il terminale è disponibile nelle sessioni locali e [SSH](#ssh-sessions), con una limitazione sulle [macchine remote Windows](#windows-remote-machines).267Se una sessione WSL non ha un terminale, consulta [Se il terminale o i connettori non sono disponibili](/docs/it/desktop-wsl#check-for-the-terminal-and-connectors). Il terminale è disponibile nelle sessioni locali e [SSH](#ssh-sessions), con una limitazione sulle [macchine remote Windows](#windows-remote-machines).
248 268
249<h3 id="open-and-edit-files">269<h3 id="open-and-edit-files">
250 Apri e modifica file270 Apri e modifica file
251</h3>271</h3>
252 272
253Fai clic su un percorso di file nella chat o nel visualizzatore diff per aprirlo nel pannello file. I percorsi HTML, PDF, immagine e video si aprono nel [pannello Browser](#preview-your-app) invece. Fai modifiche spot e fai clic su **Save** per scriverle di nuovo. Se il file è cambiato su disco da quando l'hai aperto, il pannello ti avverte e ti consente di sovrascrivere o scartare. Fai clic su **Discard** per ripristinare le tue modifiche, o fai clic sul percorso nell'header del pannello per copiare il percorso assoluto.273Per aprire un file menzionato da Claude, fai clic sul suo percorso nella chat.
254 274
255Il pannello file è disponibile nelle sessioni locali e SSH. Per le sessioni cloud, chiedi a Claude di apportare la modifica.275Per modificare tu stesso un file, usa il [pannello file](#arrange-your-workspace):
276
277* **Sessioni locali**: puoi modificare i file all'interno della directory di lavoro della sessione, tranne alcuni di sola visualizzazione come `.mcp.json` e `.claude/settings.json`. Per modificarne uno, [aprilo in un'altra app](#open-files-in-other-apps).
278* **Sessioni cloud, SSH e WSL**: il pannello file è di sola visualizzazione, quindi chiedi a Claude di apportare le modifiche.
279
280<h4 id="save-edits-in-the-file-pane">
281 Salva le modifiche nel pannello file
282</h4>
283
284Per impostazione predefinita, le modifiche nel pannello file vengono salvate automaticamente, quindi il pannello non mostra alcun pulsante **Save**. Per salvare tu stesso le modifiche, deseleziona **Auto save** nel menu **⋮** del pannello. Con **Auto save** disattivato, fai clic su **Save** dopo aver modificato un file per scrivere le modifiche, o su **Cancel** per annullarle.
285
286Se il pannello avverte che il file è cambiato su disco, fai clic su **Override** per sovrascrivere la versione su disco con le tue modifiche, o su **Discard** per scartare le tue modifiche.
256 287
257<h3 id="open-files-in-other-apps">288<h3 id="open-files-in-other-apps">
258 Apri file in altre app289 Apri file in altre app
283 Scorciatoie da tastiera314 Scorciatoie da tastiera
284</h3>315</h3>
285 316
286Premi **Cmd+/** su macOS o **Ctrl+/** su Windows per vedere tutte le scorciatoie disponibili nella scheda Code. Su Windows, usa **Ctrl** al posto di **Cmd** per le scorciatoie di seguito. Il ciclo della sessione, l'interruttore del terminale e l'interruttore della modalità di visualizzazione usano **Ctrl** su ogni piattaforma.317Premi **Cmd+/** su macOS o **Ctrl+/** su Windows per vedere tutte le scorciatoie disponibili nella scheda Code. La tabella in questa sezione mostra i tasti di macOS. Su Windows e Linux, sostituisci questi tasti:
318
319* **Cmd+Option**: premi **Alt**
320* **Cmd**: premi **Ctrl**
321
322Il ciclo della sessione, l'interruttore del terminale e l'interruttore della modalità di visualizzazione usano **Ctrl** su ogni piattaforma.
287 323
288| Scorciatoia | Azione |324| Scorciatoia | Azione |
289| - | - |325| - | - |
290| `Cmd` `/` | Mostra scorciatoie da tastiera |326| `Cmd` `/` | Mostra scorciatoie da tastiera |
291| `Cmd` `N` | Nuova sessione |327| `Cmd` `N` | Nuova sessione |
328| `Cmd` `Option` `1`–`9` | Nella schermata di nuova sessione del [layout attuale](#check-which-layout-you-have), seleziona un ambiente |
329| `Cmd` `Option` `0` | Nella schermata di nuova sessione del layout attuale, apri la [finestra di dialogo **New environment**](#create-a-saved-environment) |
292| `Cmd` `W` | Chiudi sessione |330| `Cmd` `W` | Chiudi sessione |
293| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Sessione successiva o precedente |331| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Sessione successiva o precedente |
294| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Sessione successiva o precedente |332| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Sessione successiva o precedente |
404 Lavora in parallelo con le sessioni442 Lavora in parallelo con le sessioni
405</h3>443</h3>
406 444
407Fai clic su **+ New session** nella barra laterale, o premi **Cmd+N** su macOS o **Ctrl+N** su Windows, per lavorare su più compiti in parallelo. Premi **Ctrl+Tab** e **Ctrl+Shift+Tab** per scorrere le sessioni nella barra laterale. Per i repository Git, seleziona l'opzione **worktree** accanto al nome del branch per dare alla sessione la sua copia isolata del tuo progetto usando [Git worktrees](/docs/it/worktrees).445Fai clic su **+ New** nella barra laterale, o premi **Cmd+N** su macOS o **Ctrl+N** su Windows, per lavorare su più compiti in parallelo. Premi **Ctrl+Tab** e **Ctrl+Shift+Tab** per scorrere le sessioni nella barra laterale.
408 446
409Per visualizzare due sessioni contemporaneamente, tieni premuto **Cmd** su macOS o **Ctrl** su Windows e fai clic su una sessione nella barra laterale. La sessione si apre in un secondo riquadro accanto a quello che hai già aperto. Mentre la divisione è attiva, facendo clic su un'altra sessione della barra laterale si sostituisce il riquadro che ha il focus. Premi **Cmd+\\** su macOS o **Ctrl+\\** su Windows per chiudere il riquadro con focus e tornare a una singola sessione.447Per visualizzare due sessioni contemporaneamente, tieni premuto **Cmd** su macOS o **Ctrl** su Windows e fai clic su una sessione nella barra laterale. La sessione si apre in un secondo riquadro accanto a quello che hai già aperto. Mentre la divisione è attiva, facendo clic su un'altra sessione della barra laterale si sostituisce il riquadro che ha il focus. Premi **Cmd+\\** su macOS o **Ctrl+\\** su Windows per chiudere il riquadro con focus e tornare a una singola sessione.
410 448
411I worktree sono archiviati in `<project-root>/.claude/worktrees/` per impostazione predefinita. Puoi cambiare questo percorso in una directory personalizzata:449<h4 id="run-a-session-in-its-own-worktree">
450 Esegui una sessione nel suo worktree
451</h4>
452
453In un progetto che è un repository Git, attiva **Worktree** prima di avviare una sessione per eseguirla nel suo [worktree Git](/docs/it/worktrees), una copia isolata del progetto. Per impostazione predefinita, **Worktree** è disattivato e Claude lavora direttamente nella cartella del progetto. Fai clic sul controllo della cartella del progetto nella [riga sotto la casella del prompt](#start-a-session) e attiva **Worktree**.
454
455* **Con un [ambiente salvato](#create-a-saved-environment)**: imposta **Worktree** quando crei o modifichi l'ambiente
456* **[Layout precedente](#check-which-layout-you-have)**: seleziona la casella di controllo **worktree** accanto al nome del branch, sopra la casella del prompt
457
458I worktree sono archiviati in `<project-root>/.claude/worktrees/` per impostazione predefinita. Per archiviarli invece in una directory personalizzata:
412 459
413* **Sessioni locali**: imposta **Worktree location** in **Settings > Claude Code**460* **Sessioni locali**: imposta **Worktree location** in **Settings > Claude Code**
414* **Sessioni SSH**: imposta **Worktree folder** sulla [connessione SSH](#choose-where-ssh-session-worktrees-go)461* **Sessioni SSH**: imposta **Worktree folder** sulla [connessione SSH](#choose-where-ssh-session-worktrees-go)
415 462
416Puoi anche impostare un **Branch prefix** in **Settings > Claude Code**. Desktop lo antepone a ogni nome di branch worktree, il che è utile per mantenere organizzati i branch creati da Claude.463Puoi anche impostare un **Branch prefix** in **Settings > Claude Code**. Desktop lo antepone a ogni nome di branch worktree, il che è utile per mantenere organizzati i branch creati da Claude.
417 464
418Per rimuovere un worktree quando hai finito, passa il mouse sulla sessione nella barra laterale e fai clic sull'icona di archivio. Per avere sessioni che si archiviano automaticamente quando viene eseguito il merge della loro pull request o quando questa viene chiusa, attiva **Auto-archive after PR merge or close** in **Settings > Claude Code**. Auto-archive si applica solo alle sessioni locali che hanno finito di funzionare.
419
420Per includere file gitignored come `.env` nei nuovi worktree, crea un [file `.worktreeinclude`](/docs/it/worktrees#copy-gitignored-files-into-worktrees) nella radice del tuo progetto. Vedi [Cosa condividono i worktree con il checkout principale](/docs/it/worktrees#what-worktrees-share-with-the-main-checkout) per sapere da dove una sessione worktree legge le impostazioni di progetto, gli hook e le skill.465Per includere file gitignored come `.env` nei nuovi worktree, crea un [file `.worktreeinclude`](/docs/it/worktrees#copy-gitignored-files-into-worktrees) nella radice del tuo progetto. Vedi [Cosa condividono i worktree con il checkout principale](/docs/it/worktrees#what-worktrees-share-with-the-main-checkout) per sapere da dove una sessione worktree legge le impostazioni di progetto, gli hook e le skill.
421 466
422<Note>467<Note>
423 L'isolamento della sessione richiede [Git](https://git-scm.com/downloads). La maggior parte dei Mac include Git per impostazione predefinita. Esegui `git --version` in Terminal per verificare; se stampa un numero di versione, Git è installato. Se riscontri errori Git, chiedi a Claude nella scheda [Cowork](https://claude.com/product/cowork) di aiutarti a risolvere i problemi della tua configurazione.468 L'isolamento della sessione richiede [Git](https://git-scm.com/downloads). La maggior parte dei Mac include Git per impostazione predefinita. Esegui `git --version` in Terminal per verificare; se stampa un numero di versione, Git è installato. Se riscontri errori Git, chiedi a Claude nella scheda [Cowork](https://claude.com/product/cowork) di aiutarti a risolvere i problemi della tua configurazione.
424</Note>469</Note>
425 470
426Usa i controlli in cima alla barra laterale per filtrare le sessioni per stato, progetto o ambiente, e per raggruppare le sessioni per progetto. Per rinominare una sessione, fai clic sul titolo della sessione nella barra degli strumenti in cima alla sessione attiva.471<h3 id="add-folders-to-a-session">
472 Aggiungi cartelle a una sessione
473</h3>
474
475Aggiungi le cartelle prima che la sessione si avvii o mentre è in esecuzione:
476
477* **Prima che si avvii una sessione locale**: aggiungi le cartelle in **Folders** quando [crei un ambiente salvato](#create-a-saved-environment) o ne modifichi uno, quindi [avvia la sessione da quell'ambiente salvato](#use-edit-or-remove-a-saved-environment).
478* **Mentre è in esecuzione una sessione locale o [SSH](#ssh-sessions)**: fai clic su **+** accanto alla casella del prompt e seleziona **Add folder**. Claude lavora direttamente in quella cartella, senza alcun [worktree](#run-a-session-in-its-own-worktree).
479
480<h3 id="archive-a-session">
481 Archivia una sessione
482</h3>
483
484Prima di archiviare una sessione il cui worktree contiene modifiche senza commit, consulta [Conserva le modifiche senza commit quando una sessione viene archiviata](#keep-uncommitted-changes-when-a-session-is-archived). Per archiviare una sessione, passa il mouse sopra di essa nella barra laterale, apri il suo menu e seleziona **Archive**. La sessione viene spostata nelle tue [sessioni archiviate](#organize-and-find-sessions).
485
486Per fare in modo che le sessioni si archivino da sole quando viene eseguito il merge della loro pull request o quando questa viene chiusa, attiva **Auto-archive after PR merge or close** in **Settings > Claude Code**. Le sessioni cloud e le sessioni ancora in esecuzione non si archiviano da sole.
487
488<h4 id="keep-uncommitted-changes-when-a-session-is-archived">
489 Conserva le modifiche senza commit quando una sessione viene archiviata
490</h4>
491
492Puoi perdere le modifiche senza commit nel worktree di una sessione quando la sessione viene archiviata, quindi prima esegui il commit di ciò che vuoi conservare:
493
494* **Se Desktop ti chiede delle modifiche**: seleziona **Archive anyway** per scartarle, oppure annulla ed esegui il loro commit
495* **Se le uniche modifiche sono file non tracciati**: esegui il commit di quelli che vuoi conservare prima che venga eseguito il merge di una pull request aperta da Claude nella sessione, perché a quel punto Desktop può eliminarli senza chiedere
496* **In qualsiasi altro caso**: il worktree resta su disco con le sue modifiche. Per una sessione locale, Desktop li rimuove entrambi circa 30 giorni dopo l'archiviazione della sessione o dopo l'ultima volta che la apri, a seconda di quale data sia successiva. Per conservare le modifiche, apri la sessione dalla [scheda **Archived**](#organize-and-find-sessions) e seleziona **Unarchive**
497
498<h3 id="organize-and-find-sessions">
499 Organizza e trova le sessioni
500</h3>
501
502Raggruppi, ordini e trovi le sessioni da un'icona nell'elenco delle sessioni della barra laterale:
503
504* **Layout attuale**: passa il mouse su un'intestazione nell'elenco delle sessioni per mostrare l'icona **Group and sort**, quindi fai clic su di essa. Per trovare le sessioni archiviate, seleziona **View all**, l'ultima riga del menu, quindi apri la scheda **Archived**.
505* **[Layout precedente](#check-which-layout-you-have)**: l'icona **Filter** è visibile senza passare il mouse. Fai clic su di essa per organizzare l'elenco con **Group by** o **Sort by**. Per mostrare le sessioni archiviate, seleziona **Status**, quindi **Archived**.
506
507Per rinominare una sessione, aprila e fai clic sul titolo della sessione nella barra del titolo.
508
509<h3 id="check-and-free-up-context">
510 Controlla e libera il contesto
511</h3>
427 512
428Per controllare l'utilizzo del contesto, vedi [Controlla l'utilizzo](#check-usage). Quando il contesto si riempie, Claude riassume automaticamente la conversazione e continua a lavorare. Puoi anche digitare `/compact` per attivare la compattazione prima e liberare spazio di contesto. Vedi [la finestra di contesto](/docs/it/how-claude-code-works#the-context-window) per i dettagli su come funziona la compattazione.513Per controllare l'utilizzo del contesto, vedi [Controlla l'utilizzo](#check-usage). Quando il contesto si riempie, Claude riassume automaticamente la conversazione e continua a lavorare. Puoi anche digitare `/compact` per attivare la compattazione prima e liberare spazio di contesto. Vedi [la finestra di contesto](/docs/it/how-claude-code-works#the-context-window) per i dettagli su come funziona la compattazione.
429 514
515<h3 id="get-notified-when-a-session-finishes">
516 Ricevi una notifica quando una sessione termina
517</h3>
518
430L'app desktop invia una notifica del sistema operativo quando una sessione Code termina un'attività e non stai visualizzando quella sessione. Per le sessioni che appartengono a un [progetto](/docs/it/claude-projects#see-what-needs-you-in-overview), ricevi invece le notifiche del progetto.519L'app desktop invia una notifica del sistema operativo quando una sessione Code termina un'attività e non stai visualizzando quella sessione. Per le sessioni che appartengono a un [progetto](/docs/it/claude-projects#see-what-needs-you-in-overview), ricevi invece le notifiche del progetto.
431 520
432<h3 id="ask-a-side-question-without-derailing-the-session">521<h3 id="ask-a-side-question-without-derailing-the-session">
451 Lavora tra le sessioni540 Lavora tra le sessioni
452</h3>541</h3>
453 542
454Claude può elencare le tue altre sessioni della scheda Code, leggere cosa ognuna ha fatto, e inviare messaggi tra di loro. Chiedi in linguaggio naturale: "quale sessione ha toccato il refactor dell'autenticazione?", "cosa ha concluso la sessione API?", o "dì alla sessione dei pagamenti che lo schema è cambiato". Puoi anche chiedere a Claude di rinominare o archiviare una sessione. Claude archivia una sessione nello stesso modo in cui lo fa l'icona di archivio della barra laterale, quindi chiedigli di pulire le sessioni delle cui PR è stato eseguito il merge.543Claude può elencare le tue altre sessioni della scheda Code, leggere cosa ognuna ha fatto, e inviare messaggi tra di loro. Chiedi in linguaggio naturale: "quale sessione ha toccato il refactor dell'autenticazione?", "cosa ha concluso la sessione API?", o "dì alla sessione dei pagamenti che lo schema è cambiato".
544
545Puoi anche chiedere a Claude di rinominare o archiviare una sessione. Ad esempio, chiedigli di archiviare le sessioni delle cui PR è stato eseguito il merge.
455 546
456Attraverso questa superficie, Claude vede solo le sessioni che l'app desktop esegue da sola: locale, [SSH](#ssh-sessions), e sessioni [WSL](/docs/it/desktop-wsl) nella scheda Code. Claude non vede le sessioni cloud, o le sessioni che hai avviato dal CLI del terminale o dall'estensione VS Code, anche nei worktree dello stesso progetto, quindi con nove worktree del terminale aperti e due sessioni desktop, Claude che risponde in una di esse segnala l'altra sessione desktop. Claude non elenca mai la sessione da cui stai chiedendo. Per impostazione predefinita vede le 20 sessioni più recentemente attive e salta le sessioni archiviate a meno che non le chiedi. [La messaggistica tra sessioni](/docs/it/cross-session-messaging) consente separatamente a Claude di inviare messaggi alle [tue altre sessioni Claude Code](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach), incluse le sessioni del terminale.547Attraverso questa superficie, Claude vede solo le sessioni che l'app desktop esegue da sola: locale, [SSH](#ssh-sessions), e sessioni [WSL](/docs/it/desktop-wsl) nella scheda Code. Claude non vede le sessioni cloud, o le sessioni che hai avviato dal CLI del terminale o dall'estensione VS Code, anche nei worktree dello stesso progetto, quindi con nove worktree del terminale aperti e due sessioni desktop, Claude che risponde in una di esse segnala l'altra sessione desktop. Claude non elenca mai la sessione da cui stai chiedendo. Per impostazione predefinita vede le 20 sessioni più recentemente attive e salta le sessioni archiviate a meno che non le chiedi. [La messaggistica tra sessioni](/docs/it/cross-session-messaging) consente separatamente a Claude di inviare messaggi alle [tue altre sessioni Claude Code](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach), incluse le sessioni del terminale.
457 548
470 Esegui attività a lunga esecuzione nel cloud561 Esegui attività a lunga esecuzione nel cloud
471</h3>562</h3>
472 563
473Per grandi refactor, suite di test, migrazioni o altre attività a lunga esecuzione, seleziona **Cloud** invece di **Local** quando avvii una sessione. Le sessioni cloud vengono eseguite sull'infrastruttura gestita da Anthropic per impostazione predefinita e continuano anche se chiudi l'app o spegni il computer. Torna indietro in qualsiasi momento per vedere i progressi o indirizzare Claude in una direzione diversa. Puoi anche monitorare le sessioni cloud da [claude.ai/code](https://claude.ai/code) o dall'[app mobile Claude](/docs/it/mobile).564Per grandi refactor, suite di test, migrazioni o altre attività a lunga esecuzione, seleziona un ambiente in **Cloud** nel [selettore dell'ambiente](#start-a-session) quando avvii una sessione. Le sessioni cloud vengono eseguite sull'infrastruttura gestita da Anthropic per impostazione predefinita e continuano anche se chiudi l'app o spegni il computer. Torna indietro in qualsiasi momento per vedere i progressi o indirizzare Claude in una direzione diversa. Puoi anche monitorare le sessioni cloud da [claude.ai/code](https://claude.ai/code) o dall'[app mobile Claude](/docs/it/mobile).
565
566Le sessioni cloud supportano anche più repository. Scegli i repository:
474 567
475Le sessioni cloud supportano anche più repository. Dopo aver selezionato un ambiente cloud, fai clic sul pulsante **+** accanto al repository selezionato per aggiungere repository aggiuntivi alla sessione. Ogni repo ottiene il suo selettore di branch. Questo è utile per compiti che si estendono su più codebase, come l'aggiornamento di una libreria condivisa e dei suoi consumatori.568* **Layout attuale**: nella riga sotto la casella del prompt, una volta selezionato un ambiente cloud.
569* **[Layout precedente](#check-which-layout-you-have)**: sopra la casella del prompt. Per aggiungere un altro repository, fai clic su **+** accanto a quello selezionato.
476 570
477Vedi [Usa Claude Code nel cloud](/docs/it/claude-code-on-the-web) per ulteriori informazioni su come funzionano le sessioni cloud. Quando un corpo di lavoro ha bisogno di molte sessioni cloud, seleziona **Projects** nella barra laterale per creare un [progetto](/docs/it/claude-projects), dove Claude avvia e traccia le sessioni per te da una conversazione.571Vedi [Usa Claude Code nel cloud](/docs/it/claude-code-on-the-web) per ulteriori informazioni su come funzionano le sessioni cloud. Quando un corpo di lavoro ha bisogno di molte sessioni cloud, seleziona **Projects** nella barra laterale per creare un [progetto](/docs/it/claude-projects), dove Claude avvia e traccia le sessioni per te da una conversazione.
478 572
500* **Lo attivi per quella sessione**: con l'interruttore **Remote Control** della sessione, oppure digitando `/remote-control` nella sua casella del prompt.594* **Lo attivi per quella sessione**: con l'interruttore **Remote Control** della sessione, oppure digitando `/remote-control` nella sua casella del prompt.
501* **Si connette all'avvio**: le nuove sessioni si connettono automaticamente mentre **Connect new sessions to Remote Control** è attivo in **Settings > Claude Code**. Se non hai mai modificato quell'impostazione, Desktop segue [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) nelle tue impostazioni utente o nelle impostazioni gestite, quindi il valore predefinito della tua organizzazione.595* **Si connette all'avvio**: le nuove sessioni si connettono automaticamente mentre **Connect new sessions to Remote Control** è attivo in **Settings > Claude Code**. Se non hai mai modificato quell'impostazione, Desktop segue [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) nelle tue impostazioni utente o nelle impostazioni gestite, quindi il valore predefinito della tua organizzazione.
502 596
503Per vedere se una sessione è connessa, guarda l'icona del laptop prima del titolo della sessione nella barra degli strumenti. L'icona è evidenziata mentre la sessione è connessa o in fase di connessione. Fai clic su di essa per aprire l'interruttore **Remote Control** della sessione.597Per vedere se una sessione è connessa, controlla l'interruttore **Remote Control** nella scheda **Environment** del suo [pannello dei dettagli della sessione](#see-session-details).
504 598
505Per tenere le sessioni lontane dagli altri tuoi dispositivi, disattiva Remote Control al livello che ti serve:599Per tenere le sessioni lontane dagli altri tuoi dispositivi, disattiva Remote Control al livello che ti serve:
506 600
538 Connetti strumenti esterni632 Connetti strumenti esterni
539</h3>633</h3>
540 634
541Per le sessioni locali e [SSH](#ssh-sessions), fai clic sul pulsante **+** accanto alla casella del prompt e seleziona **Connectors** per aggiungere integrazioni come Google Calendar, Slack, GitHub, Linear, Notion e altri. Puoi aggiungere connettori prima o durante una sessione. Il pulsante **+** non è disponibile nelle sessioni cloud o WSL, ma le [routine](/docs/it/routines) configurano i connettori al momento della creazione della routine.635I connettori sono [server MCP](/docs/it/mcp) con un flusso di configurazione grafico.
636
637Fai clic su **+** accanto alla casella del prompt, prima o durante la sessione, per aggiungere connettori in una sessione locale o [SSH](#ssh-sessions) con un account Claude. Seleziona **Add connectors** per aprire la directory dei connettori. Se il menu mostra invece **Connectors**, selezionalo, poi seleziona **Browse connectors**.
638
639<Note>
640 Questi casi sono trattati in altre pagine:
542 641
543Per gestire o disconnettere i connettori, vai a Impostazioni → Connectors nell'app desktop, o seleziona **Manage connectors** dal menu Connectors nella casella del prompt.642 * **Connectors è disattivato in una sessione WSL**: vedi [Se il terminale o i connettori non sono disponibili](/docs/it/desktop-wsl#check-for-the-terminal-and-connectors)
643 * **Sessioni cloud**: vedi [Come i connettori raggiungono Claude Code](/docs/it/mcp#how-connectors-reach-claude-code)
644</Note>
544 645
545Una volta connesso, Claude può leggere il tuo calendario, inviare messaggi, creare problemi e interagire direttamente con i tuoi strumenti. Puoi chiedere a Claude quali connettori sono configurati nella tua sessione.646Una volta connesso, Claude può leggere il tuo calendario, inviare messaggi, creare problemi e interagire direttamente con i tuoi strumenti. Puoi chiedere a Claude quali connettori sono configurati nella tua sessione. Per gestire o disconnettere i connettori, vai a **Settings > Connectors** nell'app desktop.
546 647
547I connettori sono [MCP servers](/docs/it/mcp) con un flusso di configurazione grafico. Usali per l'integrazione rapida con i servizi supportati. Per le integrazioni non elencate in Connectors, aggiungi MCP servers manualmente tramite [file di impostazioni](/docs/it/mcp#installing-mcp-servers). Puoi anche [creare connettori personalizzati](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).648Per le integrazioni non elencate in Connectors, aggiungi server MCP manualmente tramite [file di impostazioni](/docs/it/mcp#installing-mcp-servers). Puoi anche [creare connettori personalizzati](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).
548 649
549<h3 id="use-skills">650<h3 id="use-skills">
550 Usa skills651 Usa skills
564 665
565[Plugins](/docs/it/plugins/overview) sono pacchetti riutilizzabili che aggiungono skills, agent, hooks, MCP servers e configurazioni LSP a Claude Code. Puoi installare plugin dall'app desktop senza usare il terminale.666[Plugins](/docs/it/plugins/overview) sono pacchetti riutilizzabili che aggiungono skills, agent, hooks, MCP servers e configurazioni LSP a Claude Code. Puoi installare plugin dall'app desktop senza usare il terminale.
566 667
567Per le sessioni locali e [SSH](#ssh-sessions), fai clic sul pulsante **+** accanto alla casella del prompt e seleziona **Plugins** per vedere i tuoi plugin installati e i loro skills. Per aggiungere un plugin, seleziona **Add plugin** dal sottomenu per aprire il browser dei plugin, che mostra i plugin disponibili dai tuoi [marketplace](/docs/it/plugins/overview) configurati incluso il marketplace ufficiale di Anthropic. Seleziona **Manage plugins** per abilitare, disabilitare o disinstallare plugin.668In una sessione locale o in una [sessione SSH](#ssh-sessions), fai clic su **+** accanto alla casella del prompt e seleziona **Add plugins** per aprire il browser dei plugin. Se il menu mostra invece **Plugins**, selezionalo, poi seleziona **Browse plugins**, oppure **Manage plugins** per abilitare, disabilitare o disinstallare plugin.
568 669
569Puoi limitare i plugin al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI, tranne quelli che l'app desktop [trattiene sotto `disableSideloadFlags`](/docs/it/settings-reference#disablesideloadflags).670Puoi limitare i plugin al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI, tranne quelli che l'app desktop [trattiene sotto `disableSideloadFlags`](/docs/it/settings-reference#disablesideloadflags).
570 671
632| `runtimeArgs` | string\[] | Argomenti passati a `runtimeExecutable`, come `["run", "dev"]` |733| `runtimeArgs` | string\[] | Argomenti passati a `runtimeExecutable`, come `["run", "dev"]` |
633| `port` | number | La porta su cui il tuo server ascolta. Predefinito a 3000 |734| `port` | number | La porta su cui il tuo server ascolta. Predefinito a 3000 |
634| `cwd` | string | Directory di lavoro relativa alla radice del tuo progetto. Predefinito alla radice del progetto. Usa `${workspaceFolder}` per fare riferimento alla radice del progetto esplicitamente |735| `cwd` | string | Directory di lavoro relativa alla radice del tuo progetto. Predefinito alla radice del progetto. Usa `${workspaceFolder}` per fare riferimento alla radice del progetto esplicitamente |
635| `env` | object | Variabili di ambiente aggiuntive come coppie chiave-valore, come `{ "NODE_ENV": "development" }`. Non mettere segreti qui poiché questo file viene eseguito il commit nel tuo repo. Per passare segreti al tuo server di sviluppo, impostali nell'[editor di ambiente locale](#local-sessions) invece. |736| `env` | object | Variabili d'ambiente aggiuntive come coppie chiave-valore, come `{ "NODE_ENV": "development" }`. Non mettere segreti qui poiché questo file viene eseguito il commit nel tuo repo. Per i segreti, vedi [Imposta le variabili d'ambiente per i server di sviluppo](#set-environment-variables-for-dev-servers). |
636| `autoPort` | boolean | Come gestire i conflitti di porta. Vedi [Conflitti di porta](#port-conflicts) |737| `autoPort` | boolean | Come gestire i conflitti di porta. Vedi [Conflitti di porta](#port-conflicts) |
637| `program` | string | Uno script da eseguire con `node`. Vedi [quando usare `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |738| `program` | string | Uno script da eseguire con `node`. Vedi [quando usare `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |
638| `args` | string\[] | Argomenti passati a `program`. Usato solo quando `program` è impostato |739| `args` | string\[] | Argomenti passati a `program`. Usato solo quando `program` è impostato |
795* **SSH**: viene eseguito su una macchina remota a cui ti connetti tramite SSH, come i tuoi stessi server, VM cloud o dev container. Un'attività in esecuzione può [proseguire mentre Desktop è disconnesso](#keep-a-task-running-while-desktop-is-disconnected), ma con un account Claude può interrompersi quando il suo accesso scade.896* **SSH**: viene eseguito su una macchina remota a cui ti connetti tramite SSH, come i tuoi stessi server, VM cloud o dev container. Un'attività in esecuzione può [proseguire mentre Desktop è disconnesso](#keep-a-task-running-while-desktop-is-disconnected), ma con un account Claude può interrompersi quando il suo accesso scade.
796* **WSL** (Windows): viene eseguito all'interno di una [distribuzione WSL 2](/docs/it/desktop-wsl) sulla tua macchina, utilizzando la sua toolchain Linux e i percorsi nativi897* **WSL** (Windows): viene eseguito all'interno di una [distribuzione WSL 2](/docs/it/desktop-wsl) sulla tua macchina, utilizzando la sua toolchain Linux e i percorsi nativi
797 898
899<h3 id="create-a-saved-environment">
900 Creare un ambiente salvato
901</h3>
902
903Un ambiente salvato è una voce nel [selettore di ambiente](#start-a-session) che registra dove viene eseguito Claude, così puoi avviare lì le sessioni successive. Un ambiente locale o SSH contiene anche le cartelle in cui Claude lavora. Gli ambienti locali e SSH salvati [richiedono Claude Desktop v2.37337.0 o successiva](#check-which-layout-you-have).
904
905<Steps>
906 <Step title="Apri la finestra di dialogo New environment">
907 Apri il selettore di ambiente sotto la casella del prompt e seleziona **New environment** in fondo al suo menu.
908 </Step>
909
910 <Step title="Scegli dove viene eseguito Claude">
911 Seleziona la scheda **Local**, **SSH** o [**Cloud**](#cloud-sessions) e compila il modulo in quella scheda. Nella scheda **SSH**, scegli una [connessione](#ssh-sessions) e una cartella sulla macchina remota.
912 </Step>
913
914 <Step title="Salva l'ambiente">
915 Seleziona **Create environment**, oppure **Add environment** nella scheda **Cloud**.
916 </Step>
917</Steps>
918
919<h4 id="environments-that-desktop-creates-for-you">
920 Ambienti che Desktop crea per te
921</h4>
922
923Se il selettore di ambiente elenca ambienti locali o SSH che non hai creato, li ha creati Desktop per te. La prima volta che apri la scheda Code nel [layout attuale](#check-which-layout-you-have), Desktop crea fino a otto ambienti. Gli ambienti derivano dalle cartelle locali e SSH che hai usato di più nell'ultimo mese. Puoi [modificarli o eliminarli](#use-edit-or-remove-a-saved-environment).
924
925<h4 id="use-edit-or-remove-a-saved-environment">
926 Usare, modificare o rimuovere un ambiente salvato
927</h4>
928
929Trova la voce dell'ambiente nel [selettore di ambiente](#start-a-session):
930
931* **Avviare una sessione**: seleziona la voce.
932* **Modificare o eliminare**: passa il mouse sulla voce e fai clic sull'icona a forma di ingranaggio. Per eliminare un ambiente locale o SSH, fai clic su **Delete environment** in **Edit environment**.
933* **Archiviare ambienti cloud**: consulta [Archiviare un ambiente](/docs/it/cloud-environments#archive-an-environment).
934
798<h3 id="local-sessions">935<h3 id="local-sessions">
799 Local sessions936 Local sessions
800</h3>937</h3>
801 938
802L'app desktop non sempre eredita il tuo ambiente shell completo. Su macOS, quando avvii l'app dal Dock o dal Finder, legge il tuo profilo shell, come `~/.zshrc` o `~/.bashrc`, per fornire a Claude Code il `PATH` e un insieme fisso di variabili di Claude Code, ma non le altre variabili che esporti lì. Su Windows, l'app eredita le variabili d'ambiente utente e di sistema ma non legge i profili PowerShell.939L'app desktop non sempre eredita il tuo ambiente shell completo. Su macOS, quando avvii l'app dal Dock o dal Finder, legge il tuo profilo shell, come `~/.zshrc` o `~/.bashrc`, per fornire a Claude Code il `PATH` e un insieme fisso di variabili di Claude Code, ma non le altre variabili che esporti lì. Su Windows, l'app eredita le variabili d'ambiente utente e di sistema ma non legge i profili PowerShell.
803 940
804Per impostare variabili di ambiente per le sessioni locali e i server di sviluppo su qualsiasi piattaforma, apri il menu a discesa dell'ambiente nella casella del prompt, passa il mouse su **Local** e fai clic sull'icona dell'ingranaggio per aprire l'editor di ambiente locale. Le variabili che salvi qui vengono archiviate crittografate sulla tua macchina e si applicano a ogni sessione locale e server di anteprima che avvii. Puoi anche aggiungere variabili alla chiave `env` nel tuo file `~/.claude/settings.json`, anche se queste raggiungono solo le sessioni Claude e non i server di sviluppo. Vedi [variabili di ambiente](/docs/it/env-vars) per l'elenco completo delle variabili supportate.941<h4 id="set-environment-variables-for-local-sessions">
942 Impostare le variabili d'ambiente per le sessioni locali
943</h4>
944
945Aggiungi le variabili a un ambiente locale salvato e avvia le tue sessioni da esso. Desktop [imposta alcune variabili da sé](#environment-variables-desktop-sets-itself), come `API_TIMEOUT_MS`, e le tue sessioni ricevono il suo valore per quelle al posto del tuo.
946
947<Note>
948 Se il tuo selettore di ambiente si trova sopra la casella del prompt, hai il [layout precedente](#check-which-layout-you-have), che non prevede ambienti locali salvati. Usa invece l'[editor dell'ambiente locale](#use-the-local-environment-editor).
949</Note>
950
951<Steps>
952 <Step title="Apri il modulo dell'ambiente">
953 Apri [**New environment**](#create-a-saved-environment) o [**Edit environment**](#use-edit-or-remove-a-saved-environment).
954 </Step>
955
956 <Step title="Inserisci le variabili">
957 Seleziona **Environment variables**, inserisci un `KEY=value` per riga e seleziona **Done**.
958 </Step>
959
960 <Step title="Salva l'ambiente">
961 Seleziona **Create environment** o **Save**.
962 </Step>
963</Steps>
964
965Solo le sessioni che avvii da quell'ambiente ricevono le variabili.
966
967Per impostare una variabile per ogni sessione locale, aggiungila alla [chiave `env`](/docs/it/env-vars#set-variables-in-settings-files) nel tuo file `~/.claude/settings.json`. Claude Code [ignora il valore](/docs/it/settings-reference#how-env-values-interact-with-your-shell) se quella variabile è già presente nell'ambiente con cui Desktop avvia la sessione. Consulta [variabili d'ambiente](/docs/it/env-vars) per l'elenco completo delle variabili supportate.
968
969<h4 id="set-environment-variables-for-dev-servers">
970 Impostare le variabili d'ambiente per i dev server
971</h4>
972
973Per fornire un segreto a un dev server senza eseguirne il commit in [`launch.json`](#configure-preview-servers), impostalo in uno di questi punti, poi riavvia Desktop:
974
975* **macOS e Linux**: esportalo nel profilo della tua shell
976* **Windows**: aggiungilo alle tue variabili d'ambiente utente o di sistema
977* **Qualsiasi piattaforma**: salvalo nell'[editor dell'ambiente locale](#use-the-local-environment-editor), se riesci ad aprirlo
978
979I dev server non ricevono le variabili che aggiungi a un [ambiente salvato](#create-a-saved-environment) o a `~/.claude/settings.json`.
980
981<h4 id="use-the-local-environment-editor">
982 Usare l'editor dell'ambiente locale
983</h4>
984
985Per aprire l'editor dell'ambiente locale, fai clic sull'icona a forma di ingranaggio sulla voce del tuo computer, non su quella di un ambiente salvato:
986
987* **Selettore sotto la casella del prompt**: passa il mouse sulla voce del tuo computer, la prima sotto **Local**. Se compare un'icona a forma di ingranaggio, fai clic su di essa. In caso contrario, l'editor non è disponibile, quindi imposta la variabile per le [sessioni locali](#set-environment-variables-for-local-sessions) o per i [dev server](#set-environment-variables-for-dev-servers) in un altro modo.
988* **Selettore sopra la casella del prompt**: passa il mouse su **Local** e fai clic sull'icona a forma di ingranaggio
989
990Inserisci un `KEY=value` per riga e seleziona **Save changes**. Le variabili che salvi qui vengono memorizzate crittografate sulla tua macchina. Le sessioni locali le ricevono, tranne qualsiasi variabile che [Desktop imposta da sé](#environment-variables-desktop-sets-itself), come `API_TIMEOUT_MS`. Riavvia Desktop per fornire le tue variabili ai dev server.
991
992<h4 id="environment-variables-desktop-sets-itself">
993 Variabili d'ambiente che Desktop imposta da sé
994</h4>
995
996Se hai impostato `API_TIMEOUT_MS` o `ANTHROPIC_BASE_URL` e non è cambiato nulla nelle tue sessioni locali, è perché Desktop imposta da sé queste [variabili](/docs/it/env-vars#variables), tra le altre. Una sessione locale riceve il valore di Desktop sia che tu abbia impostato il tuo nel profilo della shell, nelle variabili utente o di sistema di Windows, nell'editor dell'ambiente locale o in un ambiente salvato. Spostare il tuo valore in un file di impostazioni non aiuta, perché Claude Code [ignora quel valore](/docs/it/settings-reference#how-env-values-interact-with-your-shell) in una sessione locale.
997
998* `API_TIMEOUT_MS`: una sessione locale riceve `900000`, ovvero 15 minuti. Per un timeout più lungo, [installa la CLI di Claude Code](/docs/it/quickstart) e usala al posto di Desktop. [Imposta la variabile nella tua shell](/docs/it/env-vars#set-variables-in-your-shell) ed esegui `claude` nel tuo terminale.
999* `ANTHROPIC_BASE_URL`: una sessione locale riceve l'host API di Anthropic quando hai effettuato l'accesso con un account Claude. Per usare un gateway, configura invece la [configurazione di inferenza di terze parti](/docs/it/llm-gateway-connect#desktop-app) di Desktop.
1000
1001<h4 id="turn-off-extended-thinking">
1002 Disattivare il ragionamento esteso
1003</h4>
805 1004
806Il [ragionamento esteso](/docs/it/model-config#extended-thinking) è abilitato per impostazione predefinita, il che migliora le prestazioni su compiti di ragionamento complesso ma utilizza token aggiuntivi. Sulla Anthropic API, imposta `MAX_THINKING_TOKENS` a `0` nell'editor di ambiente locale per disattivare il ragionamento; questo non ha effetto su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable, che utilizzano sempre il ragionamento esteso. Con il ragionamento disattivato sulla Anthropic API, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.1005Il [ragionamento esteso](/docs/it/model-config#extended-thinking) è abilitato per impostazione predefinita, il che migliora le prestazioni nelle attività di ragionamento complesse ma usa token aggiuntivi. Per disattivarlo, imposta `MAX_THINKING_TOKENS` su `0` in un [ambiente locale salvato](#set-environment-variables-for-local-sessions) o nell'[editor dell'ambiente locale](#use-the-local-environment-editor). Il ragionamento si disattiva quindi sull'API di Anthropic, tranne su Opus 5.5, Sonnet 5.5, Haiku 5.5 e sui modelli Fable, che usano sempre il ragionamento esteso.
1006
1007Su Opus 5, seleziona anche un effort `high` o inferiore prima di avviare la sessione. Nel [layout attuale](#check-which-layout-you-have), apri il selettore del modello e seleziona un livello sotto **Effort**. Se hai avviato la sessione a un livello più alto, avviane una nuova a `high` o inferiore.
1008
1009<h4 id="fixed-thinking-budgets">
1010 Budget di ragionamento fissi
1011</h4>
807 1012
808Sui modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level), Claude Code ignora il numero in sé in un valore positivo di `MAX_THINKING_TOKENS`, perché è invece il ragionamento adattivo a controllare la profondità del ragionamento. Su Opus 4.6 e Sonnet 4.6, imposta `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` a `1` per usare un budget di ragionamento fisso; i modelli Fable, Sonnet 5 e versioni successive, Haiku 5.5, e Opus 4.7 e versioni successive utilizzano sempre il ragionamento adattivo e non hanno una modalità di budget fisso.1013Sui modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level), Claude Code ignora il numero in sé in un valore positivo di `MAX_THINKING_TOKENS`, perché è invece il ragionamento adattivo a controllare la profondità del ragionamento. Su Opus 4.6 e Sonnet 4.6, imposta `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` a `1` per usare un budget di ragionamento fisso; i modelli Fable, Sonnet 5 e versioni successive, Haiku 5.5, e Opus 4.7 e versioni successive utilizzano sempre il ragionamento adattivo e non hanno una modalità di budget fisso.
809 1014
811 Local sessions on managed devices1016 Local sessions on managed devices
812</h4>1017</h4>
813 1018
814Il tuo amministratore può disattivare le sessioni locali con l'[impostazione gestita `disableDesktopLocalSessions`](#managed-settings). Quando lo fa, **Local** rimane nel menu a discesa dell'ambiente ma è disattivato e non può essere selezionato, con un tooltip che dice che la tua organizzazione lo ha disattivato, e su Windows la voce [WSL](/docs/it/desktop-wsl), la cui disponibilità su dispositivi gestiti è [governata separatamente](/docs/it/admin-setup#wsl-sessions-in-claude-code-desktop), è disattivata allo stesso modo. Le nuove sessioni predefinite alla prima connessione SSH se una è configurata, e Desktop mostra un messaggio che le sessioni locali non sono disponibili su questo dispositivo se provi a continuare una sessione esistente. Scegli un ambiente [SSH](#ssh-sessions) o [cloud](#cloud-sessions) invece, o contatta il tuo team IT.1019Se la voce del tuo computer è disattivata nel selettore di ambiente, con il tooltip **Disabled by your organization**, il tuo amministratore ha [disattivato le sessioni locali](#managed-settings). Su Windows la voce [WSL](/docs/it/desktop-wsl), la cui disponibilità sui dispositivi gestiti è [regolata separatamente](/docs/it/admin-setup#wsl-sessions-in-claude-code-desktop), viene disattivata allo stesso modo.
1020
1021Le nuove sessioni usano per impostazione predefinita la prima connessione SSH, se ne è configurata una. Se provi a continuare una sessione locale esistente, Desktop mostra un messaggio che indica che le sessioni locali non sono disponibili su questo dispositivo. Gli [ambienti locali salvati](#create-a-saved-environment) mostrano questo errore quando ne selezioni uno: `Couldn’t switch environments: the Local environment isn’t available anymore.` Scegli invece un ambiente [SSH](#ssh-sessions) o [cloud](#cloud-sessions), oppure contatta il tuo team IT.
815 1022
816<h3 id="cloud-sessions">1023<h3 id="cloud-sessions">
817 Cloud sessions1024 Cloud sessions
819 1026
820Le sessioni cloud continuano in background anche se chiudi l'app. L'utilizzo conta verso i limiti del tuo [piano di abbonamento](/docs/it/costs) senza costi di calcolo separati.1027Le sessioni cloud continuano in background anche se chiudi l'app. L'utilizzo conta verso i limiti del tuo [piano di abbonamento](/docs/it/costs) senza costi di calcolo separati.
821 1028
822Puoi creare ambienti cloud personalizzati con diversi livelli di accesso alla rete e variabili di ambiente. Per gestirli, apri il menu a discesa dell'ambiente nella casella del prompt e seleziona **Cloud**:1029Per aggiungere, modificare o [archiviare](/docs/it/cloud-environments#archive-an-environment) un ambiente cloud, apri il [selettore di ambiente](#start-a-session):
823 1030
824* **Add an environment**: seleziona **Add cloud environment**1031* **Aggiungere un ambiente**: seleziona **New environment** in fondo al menu del selettore, poi la scheda **Cloud** della [finestra di dialogo **New environment**](#create-a-saved-environment)
825* **Edit or archive one of your own environments**: passa il mouse su di esso e fai clic sull'icona dell'ingranaggio1032* **Edit or archive one of your own environments**: passa il mouse su di esso e fai clic sull'icona dell'ingranaggio
826 1033
827Vedi [Configure cloud environments](/docs/it/cloud-environments) per i dettagli sulla configurazione dell'accesso alla rete e delle variabili di ambiente.1034Vedi [Configure cloud environments](/docs/it/cloud-environments) per i dettagli sulla configurazione dell'accesso alla rete e delle variabili di ambiente.
836 Se usi Desktop con un [provider di terze parti](/docs/it/third-party-integrations), le sessioni SSH richiedono una configurazione a parte. Consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1043 Se usi Desktop con un [provider di terze parti](/docs/it/third-party-integrations), le sessioni SSH richiedono una configurazione a parte. Consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
837</Note>1044</Note>
838 1045
839Per aggiungere una connessione SSH, apri il menu a discesa dell'ambiente nella casella del prompt prima di avviare una sessione, quindi seleziona **SSH > Add SSH connection…** e compila i dettagli della connessione:1046Aggiungi una connessione SSH nella [finestra di dialogo **New environment**](#create-a-saved-environment), poi avvia una sessione su quella connessione. Se una nuova sessione non ha un selettore di ambiente sotto la casella del prompt, hai il layout precedente. Consulta [Verificare quale layout hai](#check-which-layout-you-have).
1047
1048<Steps>
1049 <Step title="Apri la finestra di dialogo New environment">
1050 Prima di avviare una sessione, apri il selettore di ambiente sotto la casella del prompt e seleziona **New environment** in fondo al suo menu.
1051 </Step>
1052
1053 <Step title="Aggiungi la connessione">
1054 Nella scheda **SSH** della finestra di dialogo **New environment**, apri l'elenco **Host**, seleziona **Add SSH connection…** e compila i dettagli della connessione:
840 1055
841* **Name**: un'etichetta amichevole per questa connessione1056 * **Name**: un'etichetta descrittiva per questa connessione.
842* **SSH host**: `user@hostname` o un host definito in `~/.ssh/config`1057 * **SSH host**: `user@hostname` o un host definito in `~/.ssh/config`.
843* **SSH port**: 22 per impostazione predefinita se lasciato vuoto, oppure usa la porta della tua configurazione SSH1058 * **SSH port**: se lasciato vuoto usa 22 come valore predefinito, oppure usa la porta della tua configurazione SSH.
844* **SSH key (optional)**: percorso della tua chiave privata, come `~/.ssh/id_ed25519`. Lascia vuoto per usare la tua configurazione SSH o l'agente SSH.1059 * **SSH key (optional)**: percorso della tua chiave privata, come `~/.ssh/id_ed25519`. Lascia vuoto per usare la tua configurazione SSH o il tuo agente SSH.
845* **Worktree folder**: una cartella sulla macchina remota, come `~/worktrees`, in cui le nuove sessioni creano i propri worktree. Lascia vuoto per usare il [valore predefinito della macchina remota](#choose-where-ssh-session-worktrees-go).1060 * **Worktree folder**: una cartella sulla macchina remota, come `~/worktrees`, in cui le nuove sessioni creano i loro worktree. Lascia vuoto per usare il [valore predefinito della macchina remota](#choose-where-ssh-session-worktrees-go).
846 1061
847Una volta aggiunta, la connessione appare sotto **SSH** nel menu a discesa dell'ambiente. Selezionala per avviare una sessione su quella macchina. Claude viene eseguito sulla macchina remota con accesso ai suoi file e strumenti.1062 Poi seleziona **Add SSH connection**.
1063 </Step>
1064
1065 <Step title="Avvia una sessione sulla connessione">
1066 Seleziona una cartella sulla macchina remota e fai clic su **Create environment**. Mantieni la macchina e la cartella insieme come [ambiente salvato](#create-a-saved-environment) per le sessioni successive. Desktop lo seleziona per la nuova sessione, quindi digita la tua attività e premi **Invio**.
1067 </Step>
1068</Steps>
848 1069
849La macchina remota può eseguire Linux, macOS o [Windows](#windows-remote-machines). Desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti. Una volta connesso, le sessioni SSH supportano modalità di permesso, connettori, plugin e server MCP.1070La macchina remota può eseguire Linux, macOS o [Windows](#windows-remote-machines). Desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti. Una volta connesso, le sessioni SSH supportano modalità di permesso, connettori, plugin e server MCP.
850 1071
1175 1396
1176Le modifiche ai file e alcuni strumenti possono non riuscire mentre Desktop è disconnesso. Se l'attività ne ha bisogno, mantieni Desktop connesso:1397Le modifiche ai file e alcuni strumenti possono non riuscire mentre Desktop è disconnesso. Se l'attività ne ha bisogno, mantieni Desktop connesso:
1177 1398
1178* **Worktree**: in una sessione che usa un [worktree](#work-in-parallel-with-sessions), Desktop controlla ogni modifica ai file prima che Claude la effettui. Mentre Desktop è disconnesso, ogni modifica attende circa 30 secondi e poi non riesce. I comandi shell vengono comunque eseguiti. Su una macchina remota Linux o macOS, [le modifiche possono continuare a funzionare](#worktree-edits-while-disconnected). Se non sei sicuro, avvia la sessione senza un worktree.1399* **Worktree**: in una sessione che usa un [worktree](#run-a-session-in-its-own-worktree), Desktop verifica ogni modifica ai file prima che Claude la apporti. Mentre Desktop è disconnesso, ogni modifica attende circa 30 secondi e poi fallisce. I comandi della shell vengono comunque eseguiti. Su una macchina remota Linux o macOS, [le modifiche possono continuare a funzionare](#worktree-edits-while-disconnected). Se non sei sicuro, avvia la sessione senza un worktree.
1179* **Restrizioni sulle cartelle**: se la tua organizzazione limita le cartelle che le sessioni possono usare, Desktop controlla ogni lettura, ricerca e modifica di file, con o senza un worktree. Mentre Desktop è disconnesso, ciascuna attende fino a 10 minuti e poi non riesce.1400* **Restrizioni sulle cartelle**: se la tua organizzazione limita le cartelle che le sessioni possono usare, Desktop controlla ogni lettura, ricerca e modifica di file, con o senza un worktree. Mentre Desktop è disconnesso, ciascuna attende fino a 10 minuti e poi non riesce.
1180* **Connettori**: i [connettori](#connect-external-tools) e gli altri strumenti forniti da Desktop passano attraverso Desktop, quindi mentre è disconnesso ogni chiamata non riesce dopo circa 30 secondi1401* **Connettori**: i [connettori](#connect-external-tools) e gli altri strumenti forniti da Desktop passano attraverso Desktop, quindi mentre è disconnesso ogni chiamata non riesce dopo circa 30 secondi
1181* **Workflow**: Desktop controlla ogni nuovo [workflow](/docs/it/workflows) prima che venga avviato, quindi mentre Desktop è disconnesso un nuovo workflow attende fino a 10 minuti e poi non riesce1402* **Workflow**: Desktop controlla ogni nuovo [workflow](/docs/it/workflows) prima che venga avviato, quindi mentre Desktop è disconnesso un nuovo workflow attende fino a 10 minuti e poi non riesce
1264 Scegliere dove vengono creati i worktree delle sessioni SSH1485 Scegliere dove vengono creati i worktree delle sessioni SSH
1265</h4>1486</h4>
1266 1487
1267A meno che la tua organizzazione non limiti le cartelle che le sessioni possono usare, le nuove sessioni SSH creano i propri [worktree](#work-in-parallel-with-sessions) nella prima di queste posizioni che risulta impostata:1488A meno che la tua organizzazione non limiti le cartelle che le sessioni possono usare, le nuove sessioni SSH creano i loro [worktree](#run-a-session-in-its-own-worktree) nella prima di queste posizioni che risulta impostata:
1268 1489
12691. **Worktree folder** nella connessione SSH14901. **Worktree folder** nella connessione SSH
12702. [`worktree.location`](/docs/it/settings-reference#worktree-location) in `~/.claude/settings.json` sulla macchina remota14912. [`worktree.location`](/docs/it/settings-reference#worktree-location) in `~/.claude/settings.json` sulla macchina remota
1272 1493
1273Ogni progetto ottiene una propria sottocartella nella cartella che imposti, quindi con `~/worktrees` il percorso di un worktree è `~/worktrees/<project>-<id>/<worktree-name>`. Se la cartella che imposti si trova all'interno del progetto, Desktop la ignora per quel progetto e usa il valore predefinito. Su una [macchina remota Windows](#windows-remote-machines), Desktop usa sempre il valore predefinito.1494Ogni progetto ottiene una propria sottocartella nella cartella che imposti, quindi con `~/worktrees` il percorso di un worktree è `~/worktrees/<project>-<id>/<worktree-name>`. Se la cartella che imposti si trova all'interno del progetto, Desktop la ignora per quel progetto e usa il valore predefinito. Su una [macchina remota Windows](#windows-remote-machines), Desktop usa sempre il valore predefinito.
1274 1495
1275Per impostare **Worktree folder** su una connessione che hai aggiunto in precedenza o su una gestita dalla tua organizzazione, passa il mouse su di essa nel menu a discesa dell'ambiente e fai clic sull'icona dell'ingranaggio.1496<a id="set-the-worktree-folder-on-an-existing-connection" />
1276 1497
1277Il campo richiede Claude Desktop v1.44121.0 o versioni successive. Se la tua organizzazione limita le cartelle che le sessioni possono usare, Desktop nasconde il campo e mantiene i worktree all'interno del progetto.1498<h5 id="set-the-worktree-folder-on-an-existing-connection">
1499 Impostare la cartella dei worktree su una connessione esistente
1500</h5>
1501
1502Imposta **Worktree folder** nelle impostazioni di una connessione che hai aggiunto in precedenza o di una gestita dalla tua organizzazione. Il campo richiede Claude Desktop v1.44121.0 o successiva. Se la tua organizzazione limita le cartelle che le sessioni possono usare, Desktop nasconde il campo e mantiene i worktree all'interno del progetto.
1503
1504<Steps>
1505 <Step title="Trova la connessione">
1506 Apri il [selettore di ambiente](#start-a-session) e trova la connessione sotto **SSH**.
1507 </Step>
1508
1509 <Step title="Apri le impostazioni della connessione">
1510 Passa il mouse sulla connessione e fai clic sull'icona a forma di ingranaggio. Se la finestra di dialogo che si apre mostra **Edit connection…** accanto a **Host**, seleziona **Edit connection…**.
1511 </Step>
1512
1513 <Step title="Imposta la cartella">
1514 In **Worktree folder**, inserisci una cartella sulla macchina remota, come `~/worktrees`, e seleziona **Save changes**.
1515 </Step>
1516</Steps>
1278 1517
1279<h4 id="files-and-processes-on-the-remote-machine">1518<h4 id="files-and-processes-on-the-remote-machine">
1280 File e processi sulla macchina remota1519 File e processi sulla macchina remota
1321 Terminare il processo di una sessione1560 Terminare il processo di una sessione
1322</h5>1561</h5>
1323 1562
1324Per terminare il processo Claude Code di una sessione, [archivia la sessione](#work-in-parallel-with-sessions) in Desktop mentre Desktop è connesso alla macchina remota. Il processo continua a essere eseguito dopo che la sua attività è terminata e dopo che chiudi Desktop.1563Per terminare il processo di Claude Code di una sessione, [archivia la sessione](#archive-a-session) in Desktop mentre Desktop è connesso alla macchina remota. Il processo continua a essere eseguito dopo che la sua attività è terminata e dopo che esci da Desktop.
1325 1564
1326Prima di archiviare una sessione che ha un worktree, consulta [Lavorare in parallelo con le sessioni](#work-in-parallel-with-sessions).1565Prima di archiviare una sessione il cui worktree ha modifiche non sottoposte a commit, consulta [Conservare le modifiche non sottoposte a commit quando una sessione viene archiviata](#keep-uncommitted-changes-when-a-session-is-archived).
1327 1566
1328<h5 id="see-which-user-the-processes-run-as">1567<h5 id="see-which-user-the-processes-run-as">
1329 Vedere con quale utente vengono eseguiti i processi1568 Vedere con quale utente vengono eseguiti i processi
1474 Pre-configure SSH connections for your team1713 Pre-configure SSH connections for your team
1475</h4>1714</h4>
1476 1715
1477Gli amministratori possono distribuire connessioni SSH ai membri del team impostando `sshConfigs` nelle [impostazioni gestite](/docs/it/managed-settings). Le connessioni definite in questo modo appaiono nel menu a discesa dell'ambiente di ogni utente automaticamente e vengono mostrate come gestite. Gli utenti possono selezionarle e [impostare il proprio campo **Worktree folder**](#choose-where-ssh-session-worktrees-go) per esse, ma non possono modificare nient'altro né eliminarle nell'app.1716Gli amministratori possono distribuire connessioni SSH ai membri del team impostando `sshConfigs` nelle [impostazioni gestite](/docs/it/managed-settings).
1717
1718* **Cosa vedono gli utenti**: le connessioni definite in questo modo compaiono automaticamente nel selettore di ambiente di ciascun utente.
1719* **Cosa possono modificare gli utenti**: gli utenti possono selezionare una connessione gestita e [impostare la propria **Worktree folder**](#set-the-worktree-folder-on-an-existing-connection) per essa. Non possono modificarne gli altri campi né eliminarla nell'app.
1478 1720
1479L'esempio seguente pre-configura una singola connessione:1721L'esempio seguente pre-configura una singola connessione:
1480 1722
1563Per verificare che le impostazioni vengano applicate, controlla il computer di uno sviluppatore:1805Per verificare che le impostazioni vengano applicate, controlla il computer di uno sviluppatore:
1564 1806
1565<Steps>1807<Steps>
1566 <Step title="Controlla il menu a discesa dell'ambiente">1808 <Step title="Controlla il selettore di ambiente">
1567 Chiudi e riapri Desktop, quindi apri il menu a discesa dell'ambiente nella casella del prompt. **Local** è disattivato e **Shared Dev VM** appare sotto **SSH**. Se **Local** è ancora disponibile, controlla la versione di Desktop, che il file sia JSON valido e quale fonte gestita legge il computer.1809 Chiudi e riapri Desktop, poi apri il [selettore di ambiente](#start-a-session). Le impostazioni sono applicate se mostra:
1810
1811 * La voce relativa a quel computer, in grigio
1812 * **Shared Dev VM** sotto **SSH**. Se non è elencata lì, fai clic sulla singola riga **SSH**, oppure su **More** alla fine del gruppo.
1813
1814 Se la voce relativa al computer è ancora disponibile, verifica queste cause:
1815
1816 * **Versione di Desktop**: aggiorna Desktop se è precedente alla v1.37937.0.
1817 * **File delle impostazioni gestite**: assicurati che il file sia un JSON valido.
1818 * **Fonte gestita**: assicurati che il computer legga la [fonte gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources) che contiene le chiavi.
1568 </Step>1819 </Step>
1569 1820
1570 <Step title="Aggiungi un host che non è nell'allowlist">1821 <Step title="Aggiungi un host che non è nell'allowlist">
1571 [Aggiungi una connessione SSH](#ssh-sessions) con un nome host che non è nell'allowlist, come `other.example.com`. Desktop salva la connessione ma si rifiuta di connettersi e indica che le impostazioni della tua organizzazione non consentono la connessione.1822 [Aggiungi una connessione SSH](#ssh-sessions) con un hostname che non è nell'allowlist, come `other.example.com`. Desktop salva la connessione ma rifiuta di connettersi, e indica che le impostazioni della tua organizzazione non consentono la connessione.
1572 </Step>1823 </Step>
1573</Steps>1824</Steps>
1574 1825
1612| `browserExternalPageTools` | imposta su `"disabled"` per impedire a Claude di utilizzare strumenti per leggere o agire su pagine esterne nel [riquadro Browser](#browse-external-sites). Gli utenti possono comunque navigare verso siti esterni da soli, e le anteprime del server di sviluppo locale non sono interessate. |1863| `browserExternalPageTools` | imposta su `"disabled"` per impedire a Claude di utilizzare strumenti per leggere o agire su pagine esterne nel [riquadro Browser](#browse-external-sites). Gli utenti possono comunque navigare verso siti esterni da soli, e le anteprime del server di sviluppo locale non sono interessate. |
1613| `disableMobileSimulatorTools` | imposta su `true` per bloccare gli strumenti di Claude per il controllo e l'acquisizione dei dispositivi nel [riquadro iOS Simulator](/docs/it/desktop-ios-simulator#turn-off-simulator-access). Il riquadro rimane utilizzabile per i tocchi dell'utente; solo l'accesso di Claude viene rimosso. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |1864| `disableMobileSimulatorTools` | imposta su `true` per bloccare gli strumenti di Claude per il controllo e l'acquisizione dei dispositivi nel [riquadro iOS Simulator](/docs/it/desktop-ios-simulator#turn-off-simulator-access). Il riquadro rimane utilizzabile per i tocchi dell'utente; solo l'accesso di Claude viene rimosso. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |
1614| `disableBrowserExternalNavigation` | imposta su `true` per disattivare completamente la navigazione esterna nel [riquadro Browser](#browse-external-sites). Né gli utenti né Claude possono navigare verso siti esterni, e le anteprime del server localhost dev non sono interessate. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |1865| `disableBrowserExternalNavigation` | imposta su `true` per disattivare completamente la navigazione esterna nel [riquadro Browser](#browse-external-sites). Né gli utenti né Claude possono navigare verso siti esterni, e le anteprime del server localhost dev non sono interessate. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |
1615| `sshConfigs` | pre-configura le [connessioni SSH](#pre-configure-ssh-connections-for-your-team) che appaiono nel menu a discesa dell'ambiente. Gli utenti non possono eliminare le connessioni gestite né modificare nulla tranne la propria **Worktree folder**. |1866| `sshConfigs` | pre-configura le [connessioni SSH](#pre-configure-ssh-connections-for-your-team) che appaiono nel selettore dell'ambiente. Gli utenti non possono eliminare le connessioni gestite né modificare nulla tranne la propria **Worktree folder**. |
1616| `sshHostAllowlist` | limita le [sessioni SSH](#restrict-which-ssh-hosts-users-can-connect-to) agli host il cui nome host risolto corrisponde a uno di questi modelli. Letto solo dalle impostazioni gestite. |1867| `sshHostAllowlist` | limita le [sessioni SSH](#restrict-which-ssh-hosts-users-can-connect-to) agli host il cui nome host risolto corrisponde a uno di questi modelli. Letto solo dalle impostazioni gestite. |
1617| `disableDesktopLocalSessions` | imposta su `true` per disattivare le [sessioni Code che vengono eseguite sul dispositivo](#local-sessions-on-managed-devices), lasciando disponibili le sessioni SSH verso altri host e le sessioni cloud. Il valore deve essere il booleano JSON `true`. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.37937.0 o successivo. |1868| `disableDesktopLocalSessions` | imposta su `true` per disattivare le [sessioni Code che vengono eseguite sul dispositivo](#local-sessions-on-managed-devices), lasciando disponibili le sessioni SSH verso altri host e le sessioni cloud. Il valore deve essere il booleano JSON `true`. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.37937.0 o successivo. |
1618| `disableSshSavedPasswords` | imposta su `true` per impedire a Desktop di offrire di ricordare le password SSH e di usare o mostrare quelle salvate in precedenza. Attivarla non le elimina. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.49585.0 o successivo. |1869| `disableSshSavedPasswords` | imposta su `true` per impedire a Desktop di offrire di ricordare le password SSH e di usare o mostrare quelle salvate in precedenza. Attivarla non le elimina. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.49585.0 o successivo. |
1756 2007
1757| CLI | Equivalente desktop |2008| CLI | Equivalente desktop |
1758| - | - |2009| - | - |
1759| `--model sonnet` | Menu a discesa del modello accanto al pulsante di invio |2010| `--model sonnet` | Selettore del modello nella riga sotto la casella del prompt |
1760| `--resume`, `--continue` | Fai clic su una sessione nella barra laterale, o digita `/resume` nella casella del prompt per riprendere una sessione che hai avviato dalla CLI |2011| `--resume`, `--continue` | Fai clic su una sessione nella barra laterale, o digita `/resume` nella casella del prompt per riprendere una sessione che hai avviato dalla CLI |
1761| `--permission-mode` | Selettore di modalità accanto al pulsante di invio |2012| `--permission-mode` | Selettore di modalità nella riga sotto la casella del prompt |
1762| `--dangerously-skip-permissions` | Modalità Bypass permissions. Su piani Pro e Max, abilitala in Impostazioni → Claude Code → "Allow bypass permissions mode"; su piani Team ed Enterprise, la politica organizzativa la controlla |2013| `--dangerously-skip-permissions` | Modalità Bypass permissions. Su piani Pro e Max, abilitala in Impostazioni → Claude Code → "Allow bypass permissions mode"; su piani Team ed Enterprise, la politica organizzativa la controlla |
1763| `--add-dir` | Aggiungi più repo con il pulsante **+** nelle sessioni cloud |2014| `--add-dir` | [Aggiungi cartelle a una sessione](#add-folders-to-a-session) nelle sessioni locali e SSH, oppure seleziona [più repository](#run-long-running-tasks-in-the-cloud) in una sessione cloud |
1764| `--allowedTools`, `--disallowedTools` | Nessun equivalente per sessione. Le regole di permesso nei [file di impostazioni](/docs/it/settings) si applicano ancora. |2015| `--allowedTools`, `--disallowedTools` | Nessun equivalente per sessione. Le regole di permesso nei [file di impostazioni](/docs/it/settings) si applicano ancora. |
1765| `--verbose` | [Modalità di visualizzazione Verbose](#switch-view-modes) |2016| `--verbose` | [Modalità di visualizzazione Verbose](#switch-view-modes) |
1766| `--print`, `--output-format` | Non disponibile. Desktop è solo interattivo. |2017| `--print`, `--output-format` | Non disponibile. Desktop è solo interattivo. |
1767| `ANTHROPIC_MODEL` env var | Menu a discesa del modello accanto al pulsante di invio |2018| `ANTHROPIC_MODEL` env var | Selettore del modello nella riga sotto la casella del prompt |
1768| `MAX_THINKING_TOKENS` env var | Imposta nell'editor di ambiente locale. Vedi [configurazione dell'ambiente](#environment-configuration). |2019| `MAX_THINKING_TOKENS` env var | Vedi [Disattivare il ragionamento esteso](#turn-off-extended-thinking) |
1769 2020
1770<h3 id="shared-configuration">2021<h3 id="shared-configuration">
1771 Configurazione condivisa2022 Configurazione condivisa
1777* I **[server MCP](/docs/it/mcp)** configurati in `~/.claude.json` o `.mcp.json` funzionano in entrambi2028* I **[server MCP](/docs/it/mcp)** configurati in `~/.claude.json` o `.mcp.json` funzionano in entrambi
1778* Gli **[hook](/docs/it/hooks)** e le **[skill](/docs/it/skills)** definiti nelle impostazioni si applicano a entrambi2029* Gli **[hook](/docs/it/hooks)** e le **[skill](/docs/it/skills)** definiti nelle impostazioni si applicano a entrambi
1779* Le **[impostazioni](/docs/it/settings)** in `~/.claude.json` e `~/.claude/settings.json` sono condivise. Le regole di permesso, gli strumenti consentiti e altre impostazioni in `settings.json` si applicano alle sessioni Desktop.2030* Le **[impostazioni](/docs/it/settings)** in `~/.claude.json` e `~/.claude/settings.json` sono condivise. Le regole di permesso, gli strumenti consentiti e altre impostazioni in `settings.json` si applicano alle sessioni Desktop.
1780* **Modelli**: gli stessi [modelli](/docs/it/model-config#available-models) sono disponibili in entrambi. In Desktop, seleziona il modello dal menu a discesa accanto al pulsante di invio. Puoi cambiare il modello durante una sessione dallo stesso menu a discesa.2031* **Modelli**: gli stessi [modelli](/docs/it/model-config#available-models) sono disponibili in entrambi. In Desktop, seleziona il modello dal selettore del modello nella riga sotto la casella del prompt. Puoi cambiare il modello durante una sessione dallo stesso selettore.
1781 2032
1782<h4 id="mcp-servers-from-the-claude-desktop-chat-app">2033<h4 id="mcp-servers-from-the-claude-desktop-chat-app">
1783 Server MCP dall'app desktop chat Claude2034 Server MCP dall'app desktop chat Claude
1805| [Provider di terze parti](/docs/it/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API di Anthropic per impostazione predefinita. Per il routing tramite gateway, vedi [connetti l'app desktop a un gateway](/docs/it/llm-gateway-connect#desktop-app). Per eseguire la scheda Code su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM self-hosted, vedi [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |2056| [Provider di terze parti](/docs/it/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API di Anthropic per impostazione predefinita. Per il routing tramite gateway, vedi [connetti l'app desktop a un gateway](/docs/it/llm-gateway-connect#desktop-app). Per eseguire la scheda Code su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM self-hosted, vedi [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |
1806| [Server MCP](/docs/it/mcp) | Configura nei file di impostazioni | UI Connectors per sessioni locali e SSH, o file di impostazioni |2057| [Server MCP](/docs/it/mcp) | Configura nei file di impostazioni | UI Connectors per sessioni locali e SSH, o file di impostazioni |
1807| [Plugin](/docs/it/plugins/overview) | Comando `/plugin` | UI gestore plugin |2058| [Plugin](/docs/it/plugins/overview) | Comando `/plugin` | UI gestore plugin |
1808| @mention file | Basato su testo | Con autocomplete; solo sessioni locali e SSH |2059| @mention file | Basato su testo | Con autocomplete, tranne per il primo messaggio di una sessione cloud |
1809| Allegati di file | Non disponibile | Immagini, PDF |2060| Allegati di file | Non disponibile | Immagini, PDF |
1810| Isolamento della sessione | Flag [`--worktree`](/docs/it/cli-reference) | Opzione **worktree** quando si avvia una sessione |2061| Isolamento della sessione | Flag [`--worktree`](/docs/it/cli-reference) | [Esegui una sessione nel proprio worktree](#run-a-session-in-its-own-worktree) |
1811| Sessioni multiple | Terminali separati | Schede della barra laterale |2062| Sessioni multiple | Terminali separati | Schede della barra laterale |
1812| Attività ricorrenti | Cron job, pipeline CI | [Attività pianificate](/docs/it/desktop-scheduled-tasks) |2063| Attività ricorrenti | Cron job, pipeline CI | [Attività pianificate](/docs/it/desktop-scheduled-tasks) |
1813| Utilizzo del computer | [Abilita tramite `/mcp`](/docs/it/computer-use) su macOS | [Controllo di app e schermo](#let-claude-use-your-computer) su macOS e Windows |2064| Utilizzo del computer | [Abilita tramite `/mcp`](/docs/it/computer-use) su macOS | [Controllo di app e schermo](#let-claude-use-your-computer) su macOS e Windows |
1833 Troubleshooting2084 Troubleshooting
1834</h2>2085</h2>
1835 2086
1836Le sezioni di seguito coprono i problemi specifici dell'app desktop. Per gli errori API di runtime che appaiono nella chat come `API Error: 500`, `529 Overloaded`, `429` o `Prompt is too long`, vedi il [riferimento degli errori](/docs/it/errors). Questi errori e le loro correzioni sono gli stessi su CLI, desktop e web.2087Le sezioni di seguito coprono i problemi specifici dell'app desktop. Per gli errori API di runtime che appaiono nella chat come `API Error: 500`, `529 Overloaded`, `429` o `Prompt is too long`, vedi il [riferimento degli errori](/docs/it/errors).
1837 2088
1838<h3 id="check-your-version">2089<h3 id="check-your-version">
1839 Check your version2090 Check your version
1852 2103
1853Per vedere quale versione di Claude Code esegue una sessione, digita `/status` in una sessione locale nella scheda **Code** e leggi la riga **Claude Code**, che mostra una versione come `2.1.286`.2104Per vedere quale versione di Claude Code esegue una sessione, digita `/status` in una sessione locale nella scheda **Code** e leggi la riga **Claude Code**, che mostra una versione come `2.1.286`.
1854 2105
1855Per ottenere una versione più recente per le sessioni locali, apri **Claude → Check for Updates** su macOS o **Help → Check for Updates** su Windows, quindi avvia una nuova sessione.2106Per ottenere una versione più recente per le sessioni locali, apri **Claude > Check for Updates…** su macOS o **Help > Check for Updates…** su Windows, quindi avvia una nuova sessione.
1856 2107
1857In una sessione locale, la scheda **Code** esegue una propria copia di Claude Code, che ha un proprio numero di versione. L'app desktop scarica e aggiorna quella copia, quindi può differire dal comando `claude` nel tuo terminale, e aggiornarne una non aggiorna l'altra.2108In una sessione locale, la scheda **Code** esegue una propria copia di Claude Code, che ha un proprio numero di versione. L'app desktop scarica e aggiorna quella copia, quindi può differire dal comando `claude` nel tuo terminale, e aggiornarne una non aggiorna l'altra.
1858 2109
2110<h3 id="check-which-layout-you-have">
2111 Verifica quale layout hai
2112</h3>
2113
2114Se una nuova sessione non ha il [selettore dell'ambiente](#start-a-session) sotto la casella del prompt, hai il layout precedente:
2115
2116* **[Desktop precedente alla v2.37337.0](#check-your-version)**: aggiorna per ottenere il layout attuale. Seleziona **Claude > Check for Updates…** su macOS o **Help > Check for Updates…** su Windows.
2117* **[Provider di terze parti](/docs/it/third-party-integrations)**: mantieni il layout precedente, quindi non c'è nulla da fare.
2118
2119Nel layout precedente, scegli l'ambiente e la cartella del progetto sopra la casella del prompt, e la modalità di permesso e il modello nella riga sottostante. Il layout precedente non dispone del [pannello dei dettagli della sessione](#see-session-details) e degli [ambienti locali e SSH salvati](#create-a-saved-environment).
2120
1859<h3 id="403-or-authentication-errors-in-the-code-tab">2121<h3 id="403-or-authentication-errors-in-the-code-tab">
1860 403 or authentication errors in the Code tab2122 403 or authentication errors in the Code tab
1861</h3>2123</h3>
