desktop.md +30 −3
116 116
117Claude può avviare un server di sviluppo e aprirlo nel riquadro Browser per verificare le sue modifiche. Funziona sia per le app web frontend sia per i server backend: Claude può testare endpoint API, visualizzare i log del server e iterare sui 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 mostrare l'anteprima in qualsiasi momento. Per impostazione predefinita, Claude [verifica automaticamente](#auto-verify-changes) le modifiche dopo ogni modifica.117Claude può avviare un server di sviluppo e aprirlo nel riquadro Browser per verificare le sue modifiche. Funziona sia per le app web frontend sia per i server backend: Claude può testare endpoint API, visualizzare i log del server e iterare sui 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 mostrare l'anteprima in qualsiasi momento. Per impostazione predefinita, Claude [verifica automaticamente](#auto-verify-changes) le modifiche dopo ogni modifica.
118 118
119119In una sessione locale, fai clic su un percorso HTML, PDF o video nella chat per aprirlo nel riquadro Browser.In una sessione locale, fai clic su un percorso HTML, PDF o video nella chat per aprirlo nel riquadro Browser. In una sessione SSH o WSL, puoi [visualizzare l'anteprima di un file HTML](#preview-html-files-in-ssh-and-wsl-sessions).
120 120
121> [!NOTE]121> [!NOTE]
122>122>
137 137
138Per cancellare i dati salvati del Browser, seleziona **Clear browsing data** nel menu **⋮** del riquadro Browser. Per disattivare completamente il Browser, disattiva **Browser tools** in **Settings > Code** o **Settings > Claude Code**.138Per cancellare i dati salvati del Browser, seleziona **Clear browsing data** nel menu **⋮** del riquadro Browser. Per disattivare completamente il Browser, disattiva **Browser tools** in **Settings > Code** o **Settings > Claude Code**.
139 139
140#### Visualizzare l'anteprima dei file HTML nelle sessioni SSH e WSL
141
142In una sessione [SSH](#ssh-sessions) o [WSL](https://code.claude.com/docs/it/desktop-wsl.md), fai clic sul percorso di un file HTML nella chat per visualizzarne l'anteprima nel riquadro Browser. Se grafici o tabelle nell'anteprima restano vuoti, l'avviso sopra di essa ti spiega il motivo:
143
144* **`This preview doesn't load anything from the web`**: gli script scritti nel file vengono eseguiti, ma un grafico che carica la sua libreria dal web resta vuoto. Se l'avviso ha un pulsante **Export**, selezionalo e apri il file salvato nel tuo browser, dove i contenuti dal web vengono caricati.
145* **`This preview doesn't run scripts or load anything from the web`**: prima di Claude Desktop v4.23118.0, queste anteprime non eseguivano script, quindi aggiorna Desktop e apri di nuovo il file. Se Desktop è aggiornato e l'avviso rimane, riavvia Desktop. Se rimane ancora, gli script potrebbero essere [disattivati per la tua organizzazione](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization), quindi chiedi al tuo amministratore.
146
147Se hai chiuso l'avviso, apri di nuovo il file per farlo ricomparire.
148
149#### Disattivare gli script nelle anteprime SSH e WSL per la tua organizzazione
150
151Per impedire alle [anteprime HTML nelle sessioni SSH e WSL](#preview-html-files-in-ssh-and-wsl-sessions) di eseguire script, imposta l'[impostazione gestita `disableBrowserExternalNavigation`](#managed-settings) su `true`. Con questa impostazione, gli utenti non possono nemmeno [navigare su siti esterni](#restrict-external-browsing-for-your-organization) nel riquadro Browser.
152
153Impostala nelle tue [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md), oppure in una [policy MDM o in un file di impostazioni gestite di Claude Code](https://code.claude.com/docs/it/managed-settings.md#where-each-mechanism-stores-the-policy) sul computer che esegue Desktop. Desktop non la legge dalla macchina remota né dalla distribuzione WSL. Con un [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md), usa la policy MDM o il file.
154
155> [!WARNING]
156>
157> Se il computer che esegue Desktop non riceve ancora impostazioni gestite di Claude Code, imposta anche [`parentSettingsBehavior`](https://code.claude.com/docs/it/settings-reference#parentsettingsbehavior) su `"merge"` nelle impostazioni gestite che crei. Desktop passa la propria policy a Claude Code e, senza `"merge"`, Claude Code [ignora quella policy](https://code.claude.com/docs/it/managed-settings.md#let-an-embedding-host-add-policy) una volta che il computer ha impostazioni gestite. Su Windows, se crei un file di impostazioni gestite, gli utenti perdono anche le sessioni WSL finché non [le consenti](https://code.claude.com/docs/it/admin-setup.md#wsl-sessions-in-claude-code-desktop).
158>
159> Se il computer riceve già impostazioni gestite di Claude Code, aggiungi l'impostazione a quelle e lascia `parentSettingsBehavior` così com'è. Su un computer con più di una policy MDM o file di impostazioni gestite, usa [quello con la priorità più alta](https://code.claude.com/docs/it/managed-settings.md#how-claude-code-combines-managed-sources).
160
161Quindi chiedi agli utenti di riavviare Desktop per assicurarti che l'impostazione venga applicata, e spiega loro cosa aspettarsi:
162
163* **File che aprono**: l'anteprima non esegue script, quindi i grafici e le tabelle disegnati dagli script restano vuoti
164* **Anteprime che stanno eseguendo script**: se Desktop recepisce l'impostazione prima del riavvio, si chiudono. Gli utenti vedono `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`
165* **File che esportano**: se un utente [esporta un file](#preview-html-files-in-ssh-and-wsl-sessions) e lo apre in un browser, i suoi script vengono eseguiti lì, con o senza questa impostazione
166
140### Navigare su siti esterni167### Navigare su siti esterni
141 168
142Il riquadro Browser è un browser a schede, quindi puoi aprire documentazione, issue tracker o qualsiasi altro sito accanto alla tua app in esecuzione. Per aprire il Browser, premi **Cmd+Shift+B** su macOS o **Ctrl+Shift+B** su Windows, oppure fai clic su **Browser** nella barra del titolo della sessione. Puoi accedere ai siti nel riquadro, inclusi i flussi di accesso in popup come Google OAuth.169Il riquadro Browser è un browser a schede, quindi puoi aprire documentazione, issue tracker o qualsiasi altro sito accanto alla tua app in esecuzione. Per aprire il Browser, premi **Cmd+Shift+B** su macOS o **Ctrl+Shift+B** su Windows, oppure fai clic su **Browser** nella barra del titolo della sessione. Puoi accedere ai siti nel riquadro, inclusi i flussi di accesso in popup come Google OAuth.
162 189
163Il Browser segue gli stessi [controlli di allowlist e blocklist dei siti](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) dell'estensione Claude in Chrome. Se la tua organizzazione ha già configurato questi elenchi per l'estensione, il Browser li rispetta automaticamente. Gli amministratori possono anche disattivare gli strumenti di Claude sulle pagine esterne con l'[impostazione gestita `browserExternalPageTools`](#managed-settings). Con gli strumenti disattivati, gli utenti possono comunque visitare siti esterni; gli strumenti di Claude non possono leggerli né agire su di essi.190Il Browser segue gli stessi [controlli di allowlist e blocklist dei siti](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) dell'estensione Claude in Chrome. Se la tua organizzazione ha già configurato questi elenchi per l'estensione, il Browser li rispetta automaticamente. Gli amministratori possono anche disattivare gli strumenti di Claude sulle pagine esterne con l'[impostazione gestita `browserExternalPageTools`](#managed-settings). Con gli strumenti disattivati, gli utenti possono comunque visitare siti esterni; gli strumenti di Claude non possono leggerli né agire su di essi.
164 191
165192Per disattivare completamente la navigazione esterna, imposta l'[impostazione gestita `disableBrowserExternalNavigation`](#managed-settings) su `true`. Questo blocca tutta la navigazione esterna nel Browser, inclusi i siti nell'allowlist della tua organizzazione; i server di sviluppo su localhost e le anteprime dei file continuano a funzionare. Usa `browserExternalPageTools` per consentire agli utenti di continuare a navigare su siti esterni senza gli strumenti di Claude, e `disableBrowserExternalNavigation` per bloccare i siti esterni sia per gli utenti sia per Claude.Per disattivare completamente la navigazione esterna, imposta l'[impostazione gestita `disableBrowserExternalNavigation`](#managed-settings) su `true`. Questo blocca tutta la navigazione esterna nel Browser, inclusi i siti nell'allowlist della tua organizzazione. I server di sviluppo su localhost e le anteprime dei file continuano a funzionare, ma le [anteprime HTML nelle sessioni SSH e WSL](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) non eseguono script. Usa `browserExternalPageTools` per consentire agli utenti di continuare a navigare su siti esterni senza gli strumenti di Claude, e `disableBrowserExternalNavigation` per bloccare i siti esterni sia per gli utenti sia per Claude.
166 193
167### Rivedere le modifiche con la vista diff194### Rivedere le modifiche con la vista diff
168 195
2009| `autoMode` | personalizza cosa il classificatore della modalità auto si fida e blocca in tutta la tua organizzazione. Vedi [Configura la modalità auto](https://code.claude.com/docs/it/auto-mode-config.md). |2036| `autoMode` | personalizza cosa il classificatore della modalità auto si fida e blocca in tutta la tua organizzazione. Vedi [Configura la modalità auto](https://code.claude.com/docs/it/auto-mode-config.md). |
2010| `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. |2037| `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. |
2011| `disableMobileSimulatorTools` | imposta su `true` per bloccare gli strumenti di Claude per il controllo e l'acquisizione dei dispositivi nel [riquadro iOS Simulator](https://code.claude.com/docs/it/desktop-ios-simulator.md#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. |2038| `disableMobileSimulatorTools` | imposta su `true` per bloccare gli strumenti di Claude per il controllo e l'acquisizione dei dispositivi nel [riquadro iOS Simulator](https://code.claude.com/docs/it/desktop-ios-simulator.md#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. |
20122039| `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. || `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. Le anteprime HTML nelle sessioni SSH e WSL [non eseguono script](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |
2013| `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**. |2040| `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**. |
2014| `sshHostCommands` | fornisci agli utenti [connessioni SSH il cui host proviene da un comando](#distribute-commands-to-your-team), insieme alle loro. Desktop la legge dal file di impostazioni gestite o dal criterio MDM sul computer e la ignora nelle [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Richiede Claude Desktop v3.6556.0 o successivo su macOS o Linux, oppure v4.16336.0 o successivo su Windows, con accesso tramite un account Claude. Su Windows, Desktop deve anche [connettersi tramite il client OpenSSH](#use-your-ssh-configuration). |2041| `sshHostCommands` | fornisci agli utenti [connessioni SSH il cui host proviene da un comando](#distribute-commands-to-your-team), insieme alle loro. Desktop la legge dal file di impostazioni gestite o dal criterio MDM sul computer e la ignora nelle [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Richiede Claude Desktop v3.6556.0 o successivo su macOS o Linux, oppure v4.16336.0 o successivo su Windows, con accesso tramite un account Claude. Su Windows, Desktop deve anche [connettersi tramite il client OpenSSH](#use-your-ssh-configuration). |
2015| `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. |2042| `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. |