46 46
47Prima di inviare il tuo primo messaggio, configura quattro cose nell'area del prompt:47Prima di inviare il tuo primo messaggio, configura quattro cose nell'area 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). Vedi [configurazione dell'ambiente](#environment-configuration).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).
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* **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).
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* **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.
52* **Modalità di autorizzazione**: scegli quanta autonomia ha Claude dal [selettore di modalità](#choose-a-permission-mode). Puoi cambiare questo durante la sessione.52* **Modalità di autorizzazione**: scegli quanta autonomia ha Claude dal [selettore di modalità](#choose-a-permission-mode). Puoi cambiare questo durante la sessione.
236 Esegui comandi nel terminale236 Esegui comandi nel terminale
237</h3>237</h3>
238 238
239Il 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**. Il terminale è disponibile nelle sessioni locali e [SSH](#ssh-sessions).239Il 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**.
240
241Il terminale è disponibile nelle sessioni locali e [SSH](#ssh-sessions), con una limitazione sulle [macchine remote Windows](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Apri e modifica file244 Apri e modifica file
468 470
469Vedi [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.471Vedi [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.
470 472
473<Note>
474 Anche un'attività in una [sessione SSH](#ssh-sessions) 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.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Continua su un'altra superficie478 Continua su un'altra superficie
473</h3>479</h3>
772 778
773* **Local**: viene eseguito sulla tua macchina con accesso diretto ai tuoi file779* **Local**: viene eseguito sulla tua macchina con accesso diretto ai tuoi file
774* **Cloud**: viene eseguito sull'infrastruttura gestita da Anthropic per impostazione predefinita. Le sessioni continuano anche se chiudi l'app.780* **Cloud**: viene eseguito sull'infrastruttura gestita da Anthropic per impostazione predefinita. Le sessioni continuano anche se chiudi l'app.
775* **SSH**: viene eseguito su una macchina remota a cui ti connetti tramite SSH, come i tuoi stessi server, VM cloud o dev container781* **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.
776* **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 nativi782* **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
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813Le sessioni SSH ti consentono di eseguire Claude Code su una macchina remota mentre usi l'app desktop come tua interfaccia. Questo è utile per lavorare con codebase che vivono su VM cloud, dev container o server con hardware o dipendenze specifiche.819Le sessioni SSH ti consentono di eseguire Claude Code su una macchina remota mentre usi l'app desktop come tua interfaccia. Questo è utile per lavorare con codebase che vivono su VM cloud, dev container o server con hardware o dipendenze specifiche.
814 820
821<Note>
822 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).
823</Note>
824
815Per 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:825Per 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:
816 826
817* **Name**: un'etichetta amichevole per questa connessione827* **Name**: un'etichetta amichevole per questa connessione
822 832
823Una 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.833Una 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.
824 834
825La macchina remota deve eseguire Linux o macOS. L'app desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti. Una volta connesso, le sessioni SSH supportano modalità di autorizzazione, connettori, plugin e MCP server.835La 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.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Requisiti della macchina remota per le sessioni SSH
839</h4>
840
841Una macchina remota Linux o macOS richiede un processore supportato, un server SSH con SFTP, una cartella di installazione non montata con `noexec`, una shell funzionante e l'accesso alla rete. Verifica ciascun requisito prima di connetterti, oppure quando una connessione non riesce dopo l'accesso:
842
843* **Sistema**: un processore x86\_64 o arm64. La macchina deve anche soddisfare i [requisiti di sistema](/docs/it/setup#system-requirements) di Claude Code.
844* **SFTP**: il server SSH deve offrire il sottosistema SFTP, che viene attivato da una riga `Subsystem sftp` nel suo `sshd_config`. Per verificarlo, connettiti allo stesso host e alla stessa porta con `sftp` in un terminale sul tuo computer. Un server funzionante mostra il prompt `sftp>`.
845* **Sessioni per connessione**: Desktop su macOS e Linux apre diverse sessioni su una sola connessione SSH. Se il `sshd_config` del server imposta `MaxSessions 1`, aumenta il valore, ad esempio al valore predefinito di OpenSSH, cioè 10.
846* **Cartella di installazione**: Desktop installa un programma di supporto e Claude Code in `~/.claude/remote/` nella tua directory home. Li esegue da lì, quindi quella cartella non può trovarsi su un file system montato con `noexec`. Prevedi circa 1 GB di spazio su disco nella directory home di ogni utente che si connette.
847* **Shell**: la shell impostata per il tuo account sulla macchina remota deve eseguire i comandi inviati tramite SSH, come fanno Bash, Zsh e `sh`
848* **Rete**: Claude Code viene eseguito sulla macchina remota ed effettua le sue richieste di rete da lì, quindi la macchina necessita dell'[accesso alla rete richiesto da Claude Code](/docs/it/network-config#network-access-requirements). Se la macchina non riesce a scaricare Claude Code, Desktop lo scarica sul tuo computer e lo carica sulla macchina. Le altre richieste di Claude Code partono comunque dalla macchina remota.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Usare la tua configurazione SSH su macOS e Linux
852</h4>
853
854Su macOS e Linux, Desktop si connette eseguendo il client OpenSSH sul tuo computer, quindi usa il tuo `~/.ssh/config`. La connessione tramite il client OpenSSH richiede Claude Desktop v1.37937.0 o versioni successive. Inserisci un nome `Host` di quel file nel campo **SSH host** per usare le impostazioni della sua voce, come `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump` e `ProxyCommand`.
855
856Prima di aggiungere la connessione, controlla il client e la voce in un terminale sul tuo computer:
857
858* **Versione del client**: esegui `ssh -V`. Il client deve essere OpenSSH 7.6 o versioni successive.
859* **Voce**: esegui `ssh` con il nome `Host`, come `ssh devbox`. Se non riesce, correggi prima la voce.
860
861Puoi lasciare vuoti i campi **SSH port** e **SSH key (optional)**. Se ne compili uno, Desktop lo usa insieme alla voce:
862
863* **SSH port**: un valore qui sovrascrive il `Port` della voce
864* **SSH key (optional)**: Desktop offre il file di chiave che scegli in aggiunta all'`IdentityFile` della voce e alle chiavi nel tuo agente SSH
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Raggiungere una macchina dietro un jump host
868</h5>
869
870Per raggiungere una macchina dietro un jump host, chiamato anche bastion, imposta `ProxyJump` o `ProxyCommand` nella voce. La voce seguente raggiunge `devbox.internal.example.com` tramite `bastion.example.com`:
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Inserisci `devbox` nel campo **SSH host**.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Aumentare il timeout della connessione SSH
883</h5>
884
885Se la tua configurazione SSH non imposta alcun `ConnectTimeout` per l'host, Desktop concede a `ssh` 30 secondi per connettersi. Tramite un jump host o un `ProxyCommand`, quel tempo include il tempo necessario al percorso per connettersi. Se il tuo percorso richiede più tempo, aggiungi un valore più alto alla voce:
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895`ssh` usa il primo valore che trova per un host, quindi mantieni la voce sopra qualsiasi voce `Host *` che imposti `ConnectTimeout`. Per verificarlo, esegui `ssh -G devbox` in un terminale sul tuo computer. Il suo output include `connecttimeout 120`. Dopo aver modificato il valore, chiudi e riapri Desktop.
896
897<h4 id="windows-remote-machines">
898 Macchine remote Windows
899</h4>
900
901Una macchina remota Windows richiede Claude Desktop v2.31226.0 o versioni successive.
902
903Usa OpenSSH Server di Microsoft. La macchina può essere x64 o ARM64. La shell avviata dal server SSH può essere `cmd.exe`, Windows PowerShell 5.1 o Git Bash.
904
905Le macchine remote Windows sono testate meno di quelle Linux. Prova il tuo lavoro su di esse prima di farci affidamento.
906
907Aspettati questi limiti, tra gli altri, su una macchina remota Windows:
908
909* **Terminale**: il [terminale](#run-commands-in-the-terminal) non si apre in una sessione la cui cartella è un percorso Windows, come `C:/projects/app`
910* **Sandbox**: lì Claude Code viene eseguito su Windows nativo, dove esegue i comandi senza sandbox. Consulta [dove viene eseguita la sandbox](/docs/it/sandboxing).
911* **Plugin**: Desktop non copia un plugin che contiene un nome di file o cartella che Windows non può memorizzare, come un nome con `:`. La sessione elenca i plugin che Desktop ha escluso.
912* **Server MCP**: su alcune macchine remote Windows, le chiamate di Claude ai server MCP di `claude_desktop_config.json` passano attraverso Desktop, quindi Claude non può chiamare i loro strumenti [mentre Desktop è disconnesso](#limits-while-desktop-is-disconnected). Prima di Claude Desktop v2.37337.0, questo vale su ogni macchina remota Windows.
913* **Worktree**: i worktree vengono creati in `<project-root>/.claude/worktrees/`. Se [scegli un'altra cartella](#choose-where-ssh-session-worktrees-go), Desktop la ignora.
914* **Messaggi precedenti**: se la shell del server SSH è `cmd.exe` o Windows PowerShell, potresti dover connetterti prima di vedere i messaggi precedenti di una sessione
915* **Fork**: se la shell del server SSH è `cmd.exe` o Windows PowerShell, puoi fare il fork di una sessione solo dal suo primo messaggio
916* **Esecuzione durante la disconnessione**: un'attività [continua a essere eseguita mentre Desktop è disconnesso](#keep-a-task-running-while-desktop-is-disconnected) solo se il server SSH consente a un programma di sopravvivere alla connessione che lo ha avviato. Per scoprirlo, [testa la macchina remota](#prepare-a-long-task).
917* **Processi residui**: al termine di una sessione, controlla la macchina alla ricerca di programmi avviati da Claude Code, perché possono continuare a essere eseguiti. Il [programma di supporto in background](#keep-a-task-running-while-desktop-is-disconnected) che Desktop installa non si arresta da solo lì.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Mantenere un'attività in esecuzione mentre Desktop è disconnesso
921</h4>
922
923Se il tuo computer va in sospensione, perdi la connessione di rete o chiudi Desktop, l'attività prosegue finché non termina, non ha bisogno di te o non raggiunge uno dei [limiti](#limits-while-desktop-is-disconnected). Chiudere il coperchio conta come sospensione. Un riavvio di Desktop o del tuo computer, anche per un aggiornamento, conta come chiusura.
924
925Claude Code viene eseguito come processo sulla macchina remota, sotto un programma di supporto in background che Desktop installa lì, quindi non ha bisogno della tua connessione SSH per continuare a essere eseguito. Il comportamento descritto in questa sezione richiede Claude Desktop v2.31226.0 o versioni successive.
926
927<Warning>
928 Se accedi a Desktop con un account Claude, non contare sul fatto che un'attività venga eseguita per tutta la notte. Desktop rinnova quell'accesso per l'attività solo mentre Desktop è in esecuzione e connesso, quindi l'accesso dell'attività può scadere dopo che ti disconnetti, e l'attività a quel punto si interrompe. Il tempo rimanente al momento della disconnessione varia.
929
930 Il lavoro svolto fino a quel momento rimane sulla macchina remota e puoi continuare con un messaggio al tuo ritorno.
931
932 Se l'attività deve essere eseguita per tutta la notte:
933
934 * [Mantieni il tuo computer attivo](/docs/it/desktop-scheduled-tasks#how-scheduled-tasks-run) e online, con il coperchio aperto e Desktop in esecuzione
935 * Usa un accesso che funzioni senza richieste, come una chiave conservata dal tuo agente SSH, per la macchina remota e per qualsiasi jump host lungo il percorso. Desktop potrà quindi riconnettersi da solo dopo un'interruzione.
936
937 Per un'attività che deve essere eseguita mentre il tuo computer è in sospensione o spento, avvia invece una [sessione cloud](#run-long-running-tasks-in-the-cloud).
938</Warning>
939
940* **Dopo una sospensione o una perdita di rete**: recuperi l'attività in esecuzione se il processo [è ancora in esecuzione](#limits-while-desktop-is-disconnected) e Desktop può accedere senza richieste. Se non può, [invia un messaggio](#reconnect-after-sleep-or-a-network-loss).
941* **Dopo una chiusura, con Desktop su macOS o Linux e un account Claude**: recuperi l'attività in esecuzione se Desktop può [ricollegarsi al processo](#reopen-a-session-after-you-quit-desktop). Se non può, l'attività si interrompe. Se rimane interrotta, invia un messaggio.
942* **Dopo una chiusura, con Desktop su Windows o un [provider di terze parti](/docs/it/third-party-integrations)**: perdi l'attività in esecuzione, perché Desktop termina il processo quando la sessione si apre. Invia un messaggio per continuare.
943
944Quando torni e l'attività non è terminata, verifica se c'è un avviso che Desktop non riesce a riconnettersi, un errore di autenticazione o una richiesta in attesa:
945
946* **Desktop non riesce a riconnettersi**: la sessione indica il motivo, e potrebbe farlo anche una notifica. Desktop potrebbe [aver bisogno che tu acceda](#reconnect-after-sleep-or-a-network-loss).
947* **Errore di autenticazione**: il [token di accesso o la credenziale](#limits-while-desktop-is-disconnected) potrebbero essere scaduti. Con un account Claude, invia un messaggio per continuare. Con un provider di terze parti, consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Richiesta in attesa**: [rispondi](#handle-requests-that-arrive-while-you-are-away)
949* **Nessuno di questi**: invia un messaggio per continuare
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Preparare un'attività lunga
955</h5>
956
957* **Aggiorna prima**: aggiorna Desktop prima di avviare un'attività lunga. Su macOS e Windows, Desktop può riavviarsi da solo per installare un aggiornamento che ha scaricato. Quel riavvio attende mentre Claude sta lavorando a un'attività SSH. Su macOS con un account Claude, per impostazione predefinita il riavvio può comunque procedere una volta che l'aggiornamento ha atteso 72 ore.
958* **Non chiudere Desktop**: se Desktop è in esecuzione su Windows o usa un provider di terze parti, lascialo aperto mentre l'attività lunga è in esecuzione. Dopo una chiusura, [termina l'attività in esecuzione](#reopen-a-session-after-you-quit-desktop) quando la sessione si apre. Lasciarlo aperto non protegge una richiesta che [attende te](#handle-requests-that-arrive-while-you-are-away).
959* **Riduci le richieste**: scegli una modalità di permesso, regole o hook che [facciano attendere l'attività meno spesso](#handle-requests-that-arrive-while-you-are-away)
960* **Controlla il jump host**: se il tuo jump host chiede un accesso, ad esempio una notifica push su un telefono, passa a un accesso che funzioni senza richieste. Altrimenti Desktop può inviare un'altra notifica push ogni volta che tenta di riconnettersi.
961* **Testa la macchina remota**: avvia un'attività breve, chiudi Desktop mentre l'attività è ancora in esecuzione e riapri la sessione ben dopo il momento in cui l'attività dovrebbe essere terminata. Se l'attività non è terminata e la sessione non mostra alcun errore di autenticazione, controlla sulla macchina remota [cosa può terminare un'attività](#limits-while-desktop-is-disconnected).
962* **Tieni i comandi fuori dal terminale di Desktop**: se la macchina remota [disconnette i terminali inattivi](#limits-while-desktop-is-disconnected), esegui i tuoi comandi da un accesso SSH esterno a Desktop
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Limiti mentre Desktop è disconnesso
968</h5>
969
970Un'attività che lasci in esecuzione può terminare quando il suo accesso scade, quando la macchina remota la termina, o quando il programma di supporto si arresta o viene sostituito:
971
972* **Token di accesso o credenziale**: con un account Claude, l'attività si interrompe con un errore di autenticazione quando il token scade. Con un provider di terze parti, lo stesso vale per una credenziale che scade, come una proveniente da single sign-on o da un credential helper. Consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Con un account Claude, [mantieni Desktop in esecuzione e connesso](#keep-a-task-running-while-desktop-is-disconnected) in modo che possa rinnovare l'accesso.
973* **La macchina remota**: se la macchina remota si riavvia, o termina i tuoi processi quando la connessione SSH si chiude, l'attività in esecuzione termina. Nulla la riavvia mentre Desktop è disconnesso. Le macchine Linux in cui `KillUserProcesses` di systemd-logind è `yes` e si applica al tuo utente terminano i tuoi processi in questo modo. Per mantenere un'attività in esecuzione lì, chiedi all'amministratore di escludere il tuo utente, ad esempio con `KillExcludeUsers`.
974* **Terminali inattivi**: alcune macchine remote Linux disconnettono un terminale in cui nessuno digita per un tempo prestabilito (`StopIdleSessionSec` di systemd-logind). Con Desktop su macOS o Linux, il [terminale](#run-commands-in-the-terminal) di una sessione e i comandi `!` condividono per impostazione predefinita la connessione SSH di Desktop. Quella disconnessione chiude quindi la connessione mentre Desktop è connesso, e l'attività in esecuzione può terminare con essa. Chiudere il riquadro del terminale non lo impedisce, quindi [tieni i comandi fuori da quel terminale](#prepare-a-long-task).
975* **Aggiornamenti di Desktop**: se un aggiornamento introduce un nuovo programma di supporto, Desktop sostituisce il programma di supporto sulla macchina remota in una connessione successiva, il che può terminare un'attività ancora in esecuzione
976* **Assenze lunghe**: su una macchina remota Linux o macOS, se Desktop non si connette per 30 giorni, il programma di supporto si arresta e termina ogni processo Claude Code in esecuzione sotto di esso. Connettiti prima di allora.
977
978Le modifiche ai file e alcuni strumenti possono non riuscire mentre Desktop è disconnesso. Se l'attività ne ha bisogno, mantieni Desktop connesso:
979
980* **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.
981* **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.
982* **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
983* **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
984* **Server MCP**: i server MCP che Claude Code avvia sulla macchina remota non passano attraverso Desktop, quindi Claude può comunque chiamare i loro strumenti. I server di `claude_desktop_config.json` rientrano tra questi solo se Desktop non usa il suo [client SSH integrato](#worktree-edits-while-disconnected). Altrimenti, e su [alcune macchine remote Windows](#windows-remote-machines), Claude non può chiamare i loro strumenti mentre Desktop è disconnesso.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Quando le modifiche in un worktree continuano a funzionare">
989 Su una macchina remota Linux o macOS, il controllo non passa attraverso Desktop, quindi le modifiche all'interno del worktree continuano a funzionare mentre Desktop è disconnesso. Prima di Claude Desktop v2.37337.0, questo vale solo su una macchina remota Linux.
990
991 Le modifiche non riescono comunque in alcuni casi, tra cui questi:
992
993 * **Client SSH integrato**: Desktop lo usa, ad esempio in un'installazione da Microsoft Store, su un computer Windows senza OpenSSH 9.4 o versioni successive di Microsoft, oppure per impostazione predefinita su Windows con un provider di terze parti
994 * **Posizione del repository**: il repository è la tua directory home, una cartella al di sopra di essa o `~/.claude`
995 * **Percorsi macOS**: su una macchina remota macOS, il repository si trova sotto `/Volumes`, oppure un nome di cartella nel percorso del repository o del worktree contiene un `~` o un carattere non ASCII
996 * **Restrizioni sulle cartelle**: la tua organizzazione limita le cartelle che le sessioni possono usare
997 * **Launcher aziendale**: prima di Claude Desktop v2.37337.0, accedi con un account Claude e la tua organizzazione avvia Claude Code sulla macchina remota tramite un [launcher aziendale](/docs/it/corporate-launcher)
998
999 Una sessione senza worktree non ha questo controllo, a meno che la tua organizzazione non limiti le cartelle che le sessioni possono usare.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Gestire le richieste che arrivano mentre sei assente
1006</h5>
1007
1008Se Claude ha bisogno della tua approvazione o ti fa una domanda mentre Desktop è disconnesso, Claude attende sulla macchina remota. L'attesa non ha un limite di tempo proprio. Quando Desktop si ricollega al processo, ti mostra la richiesta. Se invece Desktop avvia un nuovo processo, perdi la richiesta.
1009
1010Mentre un'attività attende te, Desktop può riavviarsi da solo, ad esempio per installare un aggiornamento. Se Desktop è in esecuzione su Windows o usa un provider di terze parti, perdi la richiesta dopo quel riavvio.
1011
1012Se perdi una richiesta, invia un messaggio per continuare.
1013
1014Per ridurre la frequenza con cui un'attività si ferma per attenderti, e per ricevere sue notizie mentre sei assente, configura uno di questi elementi prima di allontanarti:
1015
1016* **Modalità auto**: scegli la [modalità auto](#choose-a-permission-mode) se [è disponibile per te](#auto-mode-availability). Dopo blocchi ripetuti, [ti viene chiesto di nuovo](/docs/it/permission-modes#when-auto-mode-falls-back).
1017* **Regole di autorizzazione**: nel tuo file di impostazioni utente sulla macchina remota, `~/.claude/settings.json`, aggiungi [regole allow](/docs/it/permissions#manage-permissions) per i comandi di cui l'attività ha bisogno. Se la tua organizzazione [accetta regole di permesso solo dalle impostazioni gestite](/docs/it/settings-reference#allowmanagedpermissionrulesonly), chiedi al tuo amministratore di aggiungerle alle [impostazioni gestite](#managed-settings) che raggiungono la macchina remota. Per le regole allow nel file `.claude/settings.json` di un progetto, consulta [Project allow rules and workspace trust](/docs/it/permissions#project-allow-rules-and-workspace-trust).
1018* **Un hook che risponde**: configura un [hook `PermissionRequest`](/docs/it/hooks#permissionrequest) in `~/.claude/settings.json` sulla macchina remota per consentire o negare le richieste al posto tuo
1019* **Un hook che ti avvisa**: configura un [hook `Notification`](/docs/it/hooks#notification) con il matcher `permission_prompt` nello stesso file per inviarti un messaggio quando una richiesta è in attesa
1020* **Un hook che ti dice quando Claude ha finito**: configura un [hook `Stop`](/docs/it/hooks#stop) nello stesso file per inviarti un messaggio quando Claude ha finito di rispondere. Non viene eseguito quando un errore API termina il turno. Per quel caso, configura un [hook `StopFailure`](/docs/it/hooks#stopfailure).
1021
1022Se la tua organizzazione [esegue solo hook gestiti](/docs/it/settings-reference#allowmanagedhooksonly), chiedi al tuo amministratore di aggiungere l'hook alle [impostazioni gestite](#managed-settings) che raggiungono la macchina remota.
1023
1024Claude Code non approva automaticamente [alcune azioni](/docs/it/permission-modes#actions-no-mode-auto-approves) in nessuna modalità di permesso, incluso Bypass permissions. A seconda della modalità di permesso, Claude Code nega un'azione di questo tipo o te la chiede, e l'attività attende quindi la tua risposta.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Riconnettersi dopo una sospensione o una perdita di rete
1030</h5>
1031
1032Se Desktop non si è riconnesso quando torni, invia un messaggio nella sessione. Desktop si riconnette da solo solo dove può accedere senza richieste, ad esempio con una chiave conservata dal tuo agente SSH.
1033
1034* **Password memorizzata**: anche una password che lasci memorizzare a Desktop funziona senza richieste, ma per un'assenza lunga preferisci una chiave conservata dal tuo agente SSH. Se gli accessi con quella password si interrompono o si bloccano, Desktop può smettere di riconnettersi e attenderti.
1035* **Qualsiasi altra richiesta**: se la macchina remota chiede qualcos'altro, come un codice monouso, puoi ricevere una notifica sul tuo computer. Fai clic sulla notifica, o invia un messaggio nella sessione, e Desktop mostra la richiesta.
1036
1037<Accordion title="Se un jump host chiede un accesso, l'interruzione è lunga, manca dell'output o il processo non c'è più">
1038 - **Jump host, le notifiche push si fermano mentre sei assente**: questo può accadere con Desktop su macOS o Linux quando nessuno risponde alla richiesta di accesso di un jump host, ad esempio una notifica push su un telefono. Desktop smette quindi di riconnettersi mentre nessuno è al tuo computer. Quando sblocchi o usi il computer, puoi ricevere un'altra notifica push, perché Desktop può riprovare. Dopo tre tentativi senza risposta attende finché non riprovi o invii un messaggio.
1039 - **Jump host, le notifiche push continuano ad arrivare**: dove Desktop non riesce a capire che nessuno risponde, come con Desktop su Windows, continua a tentare finché ha un processo a cui ricollegarsi, che quel processo sia ancora in esecuzione o meno. Puoi ricevere un'altra notifica push a ogni tentativo. Per fermare i tentativi, chiudi Desktop, il che [può farti perdere l'attività in esecuzione](#reopen-a-session-after-you-quit-desktop).
1040 - **Interruzione lunga**: Desktop rallenta a circa un tentativo ogni cinque minuti. Per riconnetterti prima, riprova nella sessione o invia un messaggio, che Desktop recapita una volta connesso.
1041 - **Output mancante**: mentre Desktop è disconnesso, il programma di supporto conserva l'output più recente di Claude Code di ogni sessione in un buffer da 16 MiB e scarta l'output più vecchio. Dopo che Desktop si è riconnesso, la sessione può mostrare `Loading recent output from <host>…`. Se Desktop non riesce a caricare tutto l'output, vedi la riga `Some output produced while you were disconnected may be missing here.` La riga non significa che l'attività si sia interrotta.
1042 - **Processo non più presente**: se il processo non c'è più quando Desktop si riconnette, Desktop può avviarne uno nuovo dalla cronologia salvata della conversazione e dire a Claude di continuare l'attività. Desktop non continua l'attività da solo se il processo continua a terminare, o se Desktop usa un provider di terze parti. Invia un messaggio per continuare.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Riaprire una sessione dopo aver chiuso Desktop
1049</h5>
1050
1051Dopo che hai chiuso Desktop, l'attività continua a essere eseguita sulla macchina remota finché non termina, non ha bisogno di te o non raggiunge uno dei [limiti](#limits-while-desktop-is-disconnected).
1052
1053* **Desktop su macOS o Linux, con un account Claude**: avvia Desktop e apri la sessione. Recuperi l'attività in esecuzione quando Desktop riesce a ricollegarsi al processo. Non sempre ci riesce, ad esempio dopo alcuni aggiornamenti di Desktop o dopo che la tua organizzazione ha modificato le sue impostazioni gestite.
1054* **Su macOS o Linux, quando Desktop non riesce a ricollegarsi**: Desktop termina il processo e ne avvia uno nuovo dalla cronologia salvata della conversazione. La tua attività in esecuzione si interrompe e perdi qualsiasi approvazione o domanda che ti stava attendendo. Dopo un aggiornamento, Desktop può quindi dire a Claude di continuare. Se l'attività rimane interrotta, invia un messaggio.
1055* **Desktop su Windows, o con un provider di terze parti su qualsiasi piattaforma**: avvia di nuovo Desktop solo quando prevedi che l'attività sia terminata. Non recuperi l'attività in esecuzione, perché Desktop non si ricollega mai dopo una chiusura. Termina il processo quando la sessione si apre, il che può accadere all'avvio di Desktop. Invia un messaggio per continuare.
1056
1057Per i deploy di terze parti, consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Mentre il processo Claude Code di una conversazione è ancora in esecuzione, non eseguire [`claude --resume`](/docs/it/cli-reference#cli-flags) per essa sulla macchina remota. Claude Code non te lo impedisce, e a quel punto entrambi i processi scrivono nella stessa conversazione. Se non sei sicuro, aggiungi `--fork-session`, che continua in una copia della conversazione, ma entrambi i processi lavorano comunque sugli stessi file.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Scegliere dove vengono creati i worktree delle sessioni SSH1064 Scegliere dove vengono creati i worktree delle sessioni SSH
8342. [`worktree.location`](/docs/it/settings-reference#worktree-location) in `~/.claude/settings.json` sulla macchina remota10702. [`worktree.location`](/docs/it/settings-reference#worktree-location) in `~/.claude/settings.json` sulla macchina remota
8353. `<project-root>/.claude/worktrees/`, il valore predefinito10713. `<project-root>/.claude/worktrees/`, il valore predefinito
836 1072
837Ogni 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.1073Ogni 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.
838 1074
839Per 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.1075Per 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.
840 1076
