desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> In una [sessione SSH](#ssh-sessions), Claude non può aprire la tua app nel riquadro Browser, perché lì non dispone degli strumenti del riquadro. Per vedere tu stesso l'app, [inoltra la sua porta al tuo computer](#reach-a-port-on-the-remote-machine).> In una [sessione SSH](#ssh-sessions), Claude non dispone degli strumenti del riquadro Browser, quindi non può aprire la tua app nel riquadro né [verificare automaticamente](#auto-verify-changes) le sue modifiche. Non sono disponibili nemmeno il menu **Dev servers** del riquadro e i tuoi [server di anteprima configurati](#configure-preview-servers). Per vedere tu stesso l'app, avvia il suo server sulla macchina remota, quindi [inoltra la sua porta al tuo computer](#reach-a-port-on-the-remote-machine).
124 124
125Se il riquadro Browser non è aperto dopo che Claude ha avviato un server in una sessione locale, fai clic su **Open** nella scheda del server nella chat.125Se il riquadro Browser non è aperto dopo che Claude ha avviato un server in una sessione locale, fai clic su **Open** nella scheda del server nella chat.
126 126
1002* **Codici monouso con `MaxSessions 1`**: se ogni accesso ti chiede qualcosa, come nel caso dei codici monouso, i comandi `!` non riescono. Esegui invece quei comandi in una scheda del terminale, che mostra la richiesta nel proprio riquadro.1002* **Codici monouso con `MaxSessions 1`**: se ogni accesso ti chiede qualcosa, come nel caso dei codici monouso, i comandi `!` non riescono. Esegui invece quei comandi in una scheda del terminale, che mostra la richiesta nel proprio riquadro.
1003* **Cartella di installazione**: Desktop installa un programma helper 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 ciascun utente che si connette. Per il contenuto di quella cartella, consulta [File e processi sulla macchina remota](#files-and-processes-on-the-remote-machine).1003* **Cartella di installazione**: Desktop installa un programma helper 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 ciascun utente che si connette. Per il contenuto di quella cartella, consulta [File e processi sulla macchina remota](#files-and-processes-on-the-remote-machine).
1004* **Shell**: la shell impostata per il tuo account sulla macchina remota deve eseguire i comandi inviati tramite SSH, come fanno Bash, Zsh e `sh`1004* **Shell**: la shell impostata per il tuo account sulla macchina remota deve eseguire i comandi inviati tramite SSH, come fanno Bash, Zsh e `sh`
10051005* **Rete**: Claude Code viene eseguito sulla macchina remota ed effettua le proprie richieste di rete da lì, quindi la macchina deve disporre dell'[accesso alla rete richiesto da Claude Code](https://code.claude.com/docs/it/network-config.md#network-access-requirements). Se la macchina non può scaricare Claude Code, Desktop lo scarica sul tuo computer e lo carica. Le altre richieste di Claude Code partono comunque dalla macchina remota. Su una macchina remota Linux, se quelle richieste necessitano di un proxy, [impostalo per le sessioni SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).* **Rete**: Claude Code viene eseguito sul computer remoto ed effettua le sue richieste di rete da lì, quindi il computer necessita dell'[accesso alla rete richiesto da Claude Code](https://code.claude.com/docs/it/network-config.md#network-access-requirements). Se il computer non riesce a scaricare Claude Code, Desktop lo scarica sul tuo computer e lo carica. Le altre richieste di Claude Code partono comunque dal computer remoto. Se un computer remoto Linux necessita di un proxy o di un certificato CA, [impostalo per le sessioni SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).
1006 1006
1007#### Verificare la chiave host di una macchina remota1007#### Verificare la chiave host di una macchina remota
1008 1008
1030 1030
1031Se una macchina remota Linux raggiunge Internet tramite un proxy o necessita di un certificato CA, aggiungi le [variabili del proxy e della CA](https://code.claude.com/docs/it/network-config.md) sotto `env` in `~/.claude/settings.json` su quella macchina. Aggiungile anche se le esporti già in `~/.profile`, `~/.bash_profile`, `~/.zprofile` o `~/.zshrc` su quella macchina.1031Se una macchina remota Linux raggiunge Internet tramite un proxy o necessita di un certificato CA, aggiungi le [variabili del proxy e della CA](https://code.claude.com/docs/it/network-config.md) sotto `env` in `~/.claude/settings.json` su quella macchina. Aggiungile anche se le esporti già in `~/.profile`, `~/.bash_profile`, `~/.zprofile` o `~/.zshrc` su quella macchina.
1032 1032
10331033In una sessione SSH, Claude Code non riceve le variabili da quei file, anche quando `claude` in un terminale su quella macchina le riceve. La sessione può quindi bloccarsi, oppure mostrare **The connection from … to the API failed** o **Authentication failed**, e accedere di nuovo non serve.In una sessione SSH, Claude Code non riceve le variabili da quei file, anche quando `claude` in un terminale su quel computer le riceve. La sessione può quindi bloccarsi, oppure mostrare **The connection from … to the API failed**, **Authentication failed** o **Claude Code on … couldn’t verify the API connection’s certificate**. Accedere di nuovo non aiuta.
1034 1034
1035**1. Aggiungi le variabili**1035**1. Aggiungi le variabili**
1036 1036
1948 1948
1949Per le chiavi di permesso, plugin e consegna che solo una fonte gestita può impostare, vedi [Chiavi che solo le impostazioni gestite possono impostare](https://code.claude.com/docs/it/managed-settings.md#managed-only-settings).1949Per le chiavi di permesso, plugin e consegna che solo una fonte gestita può impostare, vedi [Chiavi che solo le impostazioni gestite possono impostare](https://code.claude.com/docs/it/managed-settings.md#managed-only-settings).
1950 1950
1951#### Impostazioni di Claude Code che si comportano diversamente nella scheda Code
1952
1953In una sessione locale, queste chiavi, tra le altre, hanno un effetto diverso o nessun effetto visibile, perché la scheda Code sostituisce l'interfaccia del terminale. Continuano ad applicarsi nel terminale, quindi puoi lasciarle impostate.
1954
1955| Chiave | In una sessione locale |
1956| - | - |
1957| `askUserQuestionTimeout` | il timeout non si applica, quindi una domanda di Claude resta aperta finché un utente non risponde |
1958| `awaySummaryEnabled` | la chiave non ha alcun effetto |
1959| `bashEditDiffEnabled` | la scheda Code non mostra l'elenco dei file modificati da un comando Bash |
1960| `companyAnnouncements` | la scheda Code non mostra gli annunci |
1961| `defaultShell` | i comandi che gli utenti digitano dopo `!` vengono eseguiti in una shell scelta dall'app: la loro shell di login su macOS e Linux, PowerShell su Windows |
1962| `fileSuggestion` | il selettore di file `@` crea il proprio elenco di file e non esegue il comando che imposti |
1963| `modelPicker` | il selettore di modelli elenca i modelli disponibili per l'account di ciascun utente. Per limitarli, imposta [`availableModels`](https://code.claude.com/docs/it/model-config#restrict-model-selection). |
1964| `pluginTrustMessage` | l'avviso che gli utenti vedono quando installano un plugin non include il messaggio che imposti |
1965| `prUrlTemplate` | i link delle pull request usano l'URL della pull request stessa, non il modello |
1966| `respectGitignore` | il selettore di file `@` crea il proprio elenco di file e non legge questa chiave |
1967| `respondToBashCommands` | Claude risponde all'output dei comandi che gli utenti eseguono con `!`, qualunque sia il valore |
1968| `showClearContextOnPlanAccept` | gli utenti non hanno alcuna opzione per cancellare il contesto quando approvano un piano |
1969| `skipDangerousModePermissionPrompt` | la scheda Code ha una propria conferma per la [modalità Bypass permissions](#choose-a-permission-mode), e questa chiave non la salta |
1970| `verbose`, `viewMode` | ogni utente sceglie la visualizzazione in [**Transcript view** nel menu della sessione](#switch-view-modes) |
1971| `worktree.baseRef`, `worktree.sparsePaths`, `worktree.symlinkDirectories` | non vengono usate per il worktree che la scheda Code crea per una sessione |
1972
1951### Criteri di gestione dei dispositivi1973### Criteri di gestione dei dispositivi
1952 1974
1953I team IT possono gestire l'app desktop tramite MDM su macOS, criteri di gruppo su Windows o un file di criteri su Linux. I criteri disponibili includono l'abilitazione o la disabilitazione della funzione Claude Code, il controllo degli aggiornamenti automatici su macOS e Windows e l'impostazione di un URL di distribuzione personalizzato.1975I team IT possono gestire l'app desktop tramite MDM su macOS, criteri di gruppo su Windows o un file di criteri su Linux. I criteri disponibili includono l'abilitazione o la disabilitazione della funzione Claude Code, il controllo degli aggiornamenti automatici su macOS e Windows e l'impostazione di un URL di distribuzione personalizzato.
2100* I file **[CLAUDE.md](https://code.claude.com/docs/it/memory.md)** e `CLAUDE.local.md` nel tuo progetto vengono utilizzati da entrambi2122* I file **[CLAUDE.md](https://code.claude.com/docs/it/memory.md)** e `CLAUDE.local.md` nel tuo progetto vengono utilizzati da entrambi
2101* I **[server MCP](https://code.claude.com/docs/it/mcp.md)** configurati in `~/.claude.json` o `.mcp.json` funzionano in entrambi2123* I **[server MCP](https://code.claude.com/docs/it/mcp.md)** configurati in `~/.claude.json` o `.mcp.json` funzionano in entrambi
2102* Gli **[hook](https://code.claude.com/docs/it/hooks.md)** e le **[skill](https://code.claude.com/docs/it/skills.md)** definiti nelle impostazioni si applicano a entrambi2124* Gli **[hook](https://code.claude.com/docs/it/hooks.md)** e le **[skill](https://code.claude.com/docs/it/skills.md)** definiti nelle impostazioni si applicano a entrambi
21032125* Le **[impostazioni](https://code.claude.com/docs/it/settings.md)** 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.* Le **[impostazioni](https://code.claude.com/docs/it/settings.md)** 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. Alcune chiavi [si comportano diversamente nella scheda Code](#claude-code-settings-that-behave-differently-in-the-code-tab).
2104* **Modelli**: gli stessi [modelli](https://code.claude.com/docs/it/model-config.md#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.2126* **Modelli**: gli stessi [modelli](https://code.claude.com/docs/it/model-config.md#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.
2105 2127
2106#### Server MCP dall'app desktop chat Claude2128#### Server MCP dall'app desktop chat Claude
2281 2303
2282Esamina i file prima di inviarli, perché possono includere nomi e altri dettagli dal tuo ambiente. `<host>` e `<user>` indicano nomi che Desktop ha sostituito. Desktop non sostituisce tutti i nomi, e un nome di host o di utente SSH può comunque apparire così com'è scritto. Se invii il file zip a qualcuno, indica quale host non è riuscito e quando, perché i log potrebbero non nominarlo.2304Esamina i file prima di inviarli, perché possono includere nomi e altri dettagli dal tuo ambiente. `<host>` e `<user>` indicano nomi che Desktop ha sostituito. Desktop non sostituisce tutti i nomi, e un nome di host o di utente SSH può comunque apparire così com'è scritto. Se invii il file zip a qualcuno, indica quale host non è riuscito e quando, perché i log potrebbero non nominarlo.
2283 2305
22842306Il file zip non contiene il log del programma helper che Desktop installa sulla macchina remota. Per ottenere anche quel log, copia `remote-server.log` dalla cartella dell'helper sotto [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) nella directory home dell'utente che si è connesso. Esamina anche quel file prima di inviarlo.Il file zip non contiene il log del programma helper che Desktop installa sulla macchina remota. Per ottenere anche quel log, copia questi file dalla cartella dell'helper sotto [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) nella directory home dell'utente che si è connesso:
2307
2308* **`remote-server.log`**: il log dell'ultima esecuzione dell'helper.
2309* **`remote-server.log.old`**, se presente: il log dell'esecuzione precedente. Copialo il prima possibile, perché lo perdi la prossima volta che Desktop si connette e deve avviare di nuovo l'helper.
2310
2311Esamina anche quei file prima di inviarli.
2285 2312
2286### App won't quit2313### App won't quit
2287 2314