Documentation 2026-11-11 22:59 UTC to 2026-11-12 22:01 UTC

298 298 

299### Le scritture mirror sono best-effort299### Le scritture mirror sono best-effort

300 300 

301Se `append()` rifiuta, l'SDK ritenta il batch fino a due volte in più con un breve backoff, per un massimo di tre tentativi in totale. Una chiamata che scade non viene ritentata, poiché la chiamata originale potrebbe comunque arrivare. Se il batch continua a fallire, l'SDK registra l'errore, emette un messaggio `{ type: "system", subtype: "mirror_error" }` nell'iteratore, scarta il batch e continua la query. Poiché un batch ritentato può ri-consegnare voci che hanno già raggiunto la destinazione, deduplicare per `entry.uuid` nella vostra implementazione di `append()`.301Se `append()` rifiuta, l'SDK riprova il batch fino a due volte in più con un breve backoff, per un massimo di tre tentativi in totale. Una chiamata che scade non viene ritentata, poiché la chiamata originale potrebbe comunque arrivare a destinazione. Poiché un batch ritentato può riconsegnare voci che hanno già raggiunto la destinazione, deduplica per `entry.uuid` nella tua implementazione di `append()`, e conserva ogni voce che non ha un `uuid`.

302 302 

303Un'interruzione dello store non interrompe l'agente, poiché il subprocess scrive localmente per primo. Monitorate `mirror_error` se dovete rilevare la perdita di dati dello store. Su un'esecuzione [ripresa dallo store](#resume-from-the-store), un batch scartato non ha una copia sopravvivente una volta che l'esecuzione termina.303Se il batch continua a fallire, l'SDK registra l'errore, emette un messaggio `{ type: "system", subtype: "mirror_error" }` nell'iteratore, scarta il batch e continua la query. Un'interruzione dello store non interrompe l'agente, poiché il subprocess scrive prima localmente. Monitora `mirror_error` per rilevare la perdita di dati dello store. Su un'esecuzione [ripresa dallo store](#resume-from-the-store), un batch scartato non ha una copia sopravvissuta una volta che l'esecuzione termina.

304 304 

305### `getSessionMessages` restituisce la catena post-compattazione305### `getSessionMessages` restituisce la catena post-compattazione

306 306 

148 148 

149#### Disattivare gli script nelle anteprime SSH e WSL per la tua organizzazione149#### Disattivare gli script nelle anteprime SSH e WSL per la tua organizzazione

150 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.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 `disableRemotePreviewScripts`](#managed-settings) su `true`. Gli utenti possono comunque navigare su siti esterni. Richiede Claude Desktop v5.1231.0 o successivo.

152 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.153> [!NOTE]

154>

155> Le versioni precedenti ignorano `disableRemotePreviewScripts`. Per bloccare gli script in quelle versioni, aggiorna Desktop, oppure imposta anche `disableBrowserExternalNavigation` su `true`. In tal caso gli utenti [non possono navigare su siti esterni](#restrict-external-browsing-for-your-organization) su nessun computer che riceve `disableBrowserExternalNavigation`.

156 

157Imposta ogni chiave 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 legge queste chiavi dalla macchina remota, dalla distribuzione WSL, da un [`policyHelper`](https://code.claude.com/docs/it/settings-reference#policyhelper) né dalle [policy proprie di Desktop](#device-management-policies). Con un [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md), usa la policy MDM o il file.

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161Quindi chiedi agli utenti di riavviare Desktop per assicurarti che l'impostazione venga applicata, e spiega loro cosa aspettarsi:165Quindi chiedi agli utenti di riavviare Desktop per assicurarti che l'impostazione venga applicata, e spiega loro cosa aspettarsi:

162 166 

163* **File che aprono**: l'anteprima non esegue script, quindi i grafici e le tabelle disegnati dagli script restano vuoti167* **File che aprono**: l'anteprima non esegue script, quindi i grafici e le tabelle disegnati dagli script restano vuoti. Il suo avviso inizia con `This preview doesn't run scripts`.

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.`168* **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 impostazione169* **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 170 

171##### Verificare se su un computer vengono ancora eseguiti script

172 

173Dopo il riavvio, apri un file HTML da una sessione SSH o WSL su quel computer. Se l'avviso sopra l'anteprima inizia con `This preview doesn't load anything from the web`, lì gli script vengono ancora eseguiti. Controlla la [versione di Desktop](#check-your-version), dove hai inserito la chiave e che il suo valore sia il booleano JSON `true`.

174 

167### Navigare su siti esterni175### Navigare su siti esterni

168 176 

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.177Il 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.

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. |2045| `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. |

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. |2046| `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. |

2039| `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. |2047| `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. |

2048| `disableRemotePreviewScripts` | imposta su `true` per [disattivare solo gli script nelle anteprime HTML](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) nelle sessioni SSH e WSL. Desktop non la legge dalla macchina remota né dalla distribuzione WSL. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. Richiede Claude Desktop v5.1231.0 o successivo. |

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**. |2049| `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**. |

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). |2050| `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). |

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. |2051| `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. |

2044| `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. |2053| `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. |

2045| `managedMcpServers` | invia le configurazioni del server MCP a tutti gli utenti. Disponibile solo nelle distribuzioni Desktop di terze parti (3P). In ogni voce, imposta un trasporto di `"http"`, `"sse"` o `"stdio"`, i dettagli della connessione e facoltativamente una mappa `toolPolicy` per limitare quali strumenti di quel server gli utenti possono invocare. Forniscilo tramite il file di impostazioni gestite, MDM o il blocco [`desktop`](https://code.claude.com/docs/it/claude-apps-gateway-config#claude-desktop-overlay) di una politica gateway delle app Claude, poiché le distribuzioni di terze parti non ricevono le impostazioni della console di amministrazione. Per fornirlo tramite il gateway, hai bisogno di Claude Code v2.1.232 o successivo sul server gateway. Questa è la chiave dell'app desktop stessa; Claude Code legge un'[impostazione gestita con lo stesso nome](https://code.claude.com/docs/it/managed-mcp.md#provide-servers-through-managed-settings) propria, con una forma di voce diversa. |2054| `managedMcpServers` | invia le configurazioni del server MCP a tutti gli utenti. Disponibile solo nelle distribuzioni Desktop di terze parti (3P). In ogni voce, imposta un trasporto di `"http"`, `"sse"` o `"stdio"`, i dettagli della connessione e facoltativamente una mappa `toolPolicy` per limitare quali strumenti di quel server gli utenti possono invocare. Forniscilo tramite il file di impostazioni gestite, MDM o il blocco [`desktop`](https://code.claude.com/docs/it/claude-apps-gateway-config#claude-desktop-overlay) di una politica gateway delle app Claude, poiché le distribuzioni di terze parti non ricevono le impostazioni della console di amministrazione. Per fornirlo tramite il gateway, hai bisogno di Claude Code v2.1.232 o successivo sul server gateway. Questa è la chiave dell'app desktop stessa; Claude Code legge un'[impostazione gestita con lo stesso nome](https://code.claude.com/docs/it/managed-mcp.md#provide-servers-through-managed-settings) propria, con una forma di voce diversa. |

2046 2055 

2047Se disattivi una funzionalità con `browserExternalPageTools`, `disableMobileSimulatorTools` o `disableBrowserExternalNavigation` nel [criterio MDM o file di impostazioni gestite di rango più alto](https://code.claude.com/docs/it/managed-settings.md#how-claude-code-combines-managed-sources) di un computer, la funzionalità resta disattivata su quel computer. Resta disattivata anche quando le tue [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md) lasciano quella chiave non impostata o consentono la funzionalità. Non usare un valore di registro `HKCU` a livello utente per questo scopo. Per riattivare la funzionalità, rimuovi il valore ovunque lo abbia impostato. Richiede Claude Desktop v4.4212.0 o successivo.2056Se disattivi una funzionalità con una di queste quattro chiavi nel [criterio MDM o file di impostazioni gestite di rango più alto](https://code.claude.com/docs/it/managed-settings.md#how-claude-code-combines-managed-sources) di un computer, la funzionalità resta disattivata su quel computer:

2057 

2058* **`browserExternalPageTools`, `disableMobileSimulatorTools`, `disableBrowserExternalNavigation`**: richiede Claude Desktop v4.4212.0 o successivo

2059* **`disableRemotePreviewScripts`**: richiede Claude Desktop v5.1231.0 o successivo

2060 

2061Resta disattivata anche quando le tue [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md) lasciano quella chiave non impostata o consentono la funzionalità. Non usare un valore di registro `HKCU` a livello utente per questo scopo. Per riattivare la funzionalità, rimuovi il valore ovunque tu l'abbia impostato.

2048 2062 

2049Quali impostazioni gestite raggiungono una sessione Desktop dipende da dove quella sessione viene eseguita. Le restrizioni del modello come [`availableModels`](https://code.claude.com/docs/it/model-config#restrict-model-selection) vengono applicate nelle sessioni Claude Code di Desktop nello stesso modo che nel CLI del terminale; vedi [copertura della superficie](https://code.claude.com/docs/it/model-config.md#surface-coverage).2063Quali impostazioni gestite raggiungono una sessione Desktop dipende da dove quella sessione viene eseguita. Le restrizioni del modello come [`availableModels`](https://code.claude.com/docs/it/model-config#restrict-model-selection) vengono applicate nelle sessioni Claude Code di Desktop nello stesso modo che nel CLI del terminale; vedi [copertura della superficie](https://code.claude.com/docs/it/model-config.md#surface-coverage).

2050 2064 

2109>2123>

2110> Controlla il valore di `forceLoginOrgUUID` prima di distribuirlo. Se l'ID non è quello della tua organizzazione, le persone della tua organizzazione non possono usare Claude Desktop a meno che non appartengano anche a un'organizzazione con quell'ID. Per risolvere, distribuisci l'ID corretto e chiedi loro di riavviare Claude Desktop.2124> Controlla il valore di `forceLoginOrgUUID` prima di distribuirlo. Se l'ID non è quello della tua organizzazione, le persone della tua organizzazione non possono usare Claude Desktop a meno che non appartengano anche a un'organizzazione con quell'ID. Per risolvere, distribuisci l'ID corretto e chiedi loro di riavviare Claude Desktop.

2111 2125 

2112Se imposti `forceLoginMethod` e `forceLoginOrgUUID` nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) di Claude Code, non modifichi la schermata di accesso di Claude Desktop.2126Se imposti `forceLoginMethod` e `forceLoginOrgUUID` nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) di Claude Code, non modifichi la schermata di accesso di Claude Desktop. Una persona può comunque usare Claude Desktop con la propria chiave API Claude o il proprio [account Claude Console](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in) ed eseguire in quel modo sessioni della scheda Code.

2127 

2128Per impedirlo, distribuisci anche `forceLoginOrgUUID` nel criterio di Claude Desktop (in `HKLM` su Windows), con l'ID della tua organizzazione claude.ai. A meno che il criterio stesso non [selezioni la Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach), Claude Desktop smette di usare la chiave API o l'account Console di una persona al successivo avvio dell'app.

2129 

2130Controlla due casi prima di distribuirlo:

2131 

2132* **Organizzazioni Claude Console**: non distribuire `forceLoginOrgUUID` da solo con l'ID di un'organizzazione Claude Console, altrimenti impediresti alle tue persone di accedere a Claude Desktop. Vedi invece [Quali dispositivi offrono l'accesso con account Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in).

2133* **Enterprise Admin Console**: se fornisce la configurazione di Claude Desktop dei tuoi computer, aggiornali prima a Claude Desktop v2.37337.0 o successivo, perché le versioni precedenti la ignorano una volta impostata questa chiave. Vedi [Mantenere un dispositivo sul suo profilo gestito](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile).

2113 2134 

2114### Requisiti di accesso alla rete2135### Requisiti di accesso alla rete

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**: un terminale tiene la conversazione, ad esempio uno in cui l'hai ripresa con `claude --resume` o `/resume`. La riga mostra anche `Open in a terminal`.5469* **`running in another terminal`**: un processo diverso da una sessione in background tiene la conversazione, ad esempio un'esecuzione di `claude -p`, o un terminale in cui l'hai ripresa con `claude --resume` o `/resume`. La riga mostra anche `Open in a terminal`.

5470* **`already open in another running Claude session`**: un altro processo Claude Code non interattivo la tiene, ad esempio un processo [sessione in background](https://code.claude.com/docs/it/agent-view.md#the-supervisor-process) per la stessa conversazione che non è ancora uscito.5470* **`already open in another running Claude session`**: un'altra [sessione in background](https://code.claude.com/docs/it/agent-view.md#the-supervisor-process) la tiene.

5471 5471 

5472**Cosa fare:**5472**Cosa fare:**

5473 5473 

5474* Continua la conversazione nel processo che l'ha aperta, o esci da quel processo e apri di nuovo la riga5474* Per `running in another terminal`: continua in quel terminale, oppure esci da quel processo o lascia che finisca, quindi riprova

5475* Per `already open in another running Claude session`: usa quella sessione, oppure interrompila e quindi riprova

5475 5476 

5476Prima della v2.1.248, esisteva solo il rifiuto `already open in another running Claude session`: una conversazione ripresa in un terminale non contava come aperta, e aprire la riga avviava un secondo processo Claude Code che scriveva sulla stessa conversazione.5477Prima della v2.1.248, esisteva solo il rifiuto `already open in another running Claude session`: una conversazione ripresa in un terminale non contava come aperta, e aprire la riga avviava un secondo processo Claude Code che scriveva sulla stessa conversazione.

5477 5478 

218 218 

219## Mod integrati in Claude Code219## Mod integrati in Claude Code

220 220 

221Alcune funzionalità di Claude Code sono esse stesse dei mod. Per vedere quelli presenti nella tua sessione, esegui `/plugin` nel prompt di Claude Code e vai alla scheda **Installed**, che li elenca sotto **Built-in**. Non puoi aggiornare o disinstallare un mod integrato, e l'ultima colonna della tabella indica come disattivare ciascuno di essi. La [riga `mods active`](#see-which-mods-a-session-loaded) omette i mod integrati.221Alcune funzionalità di Claude Code sono esse stesse dei mod. Per vedere quelli presenti nella tua sessione, esegui `/plugin` nel prompt di Claude Code e vai alla scheda **Installed**, che li elenca sotto **Built-in**. Non puoi aggiornare o disinstallare un mod integrato. La [riga `mods active`](#see-which-mods-a-session-loaded) omette i mod integrati.

222 222 

223Questa tabella elenca ogni voce con il nome mostrato da `/plugin`:223Questa tabella elenca alcune delle voci **Built-in** con il nome mostrato da `/plugin`:

224 224 

225| Nome in `/plugin` | Cosa fa | Dove è attivo | Come disattivarlo |225| Nome in `/plugin` | Cosa fa | Dove è attivo | Come disattivarlo |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | Invia i record di analisi registrati da Claude Code e dai suoi mod integrati | Ovunque siano attive le analisi di Claude Code | Disabilitalo in `/plugin`, oppure disattiva le analisi, ad esempio con [`DISABLE_TELEMETRY`](https://code.claude.com/docs/it/env-vars) |231| `cc-plugin-telemetry` | Invia i record di analisi registrati da Claude Code e dai suoi mod integrati | Ovunque siano attive le analisi di Claude Code | Disabilitalo in `/plugin`, oppure disattiva le analisi, ad esempio con [`DISABLE_TELEMETRY`](https://code.claude.com/docs/it/env-vars) |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/it/interactive-mode.md#you-should-know-suggestions): un agente secondario mostra una nota sopra il prompt quando trova qualcosa che potresti esserti perso | Disattivato finché non lo [attivi](https://code.claude.com/docs/it/interactive-mode.md#you-should-know-suggestions) | Disabilitalo in `/plugin` |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/it/interactive-mode.md#you-should-know-suggestions): un agente secondario mostra una nota sopra il prompt quando trova qualcosa che potresti esserti perso | Disattivato finché non lo [attivi](https://code.claude.com/docs/it/interactive-mode.md#you-should-know-suggestions) | Disabilitalo in `/plugin` |

233 233 

234Per un plugin **Built-in** che non è nella tabella, [apri i suoi dettagli in `/plugin`](https://code.claude.com/docs/it/plugins/install#manage-installed-plugins) per leggere cosa fa o per disabilitarlo.

235 

234Le impostazioni e i flag che bloccano i mod installati, come `disableAllHooks`, `--bare` e `--safe-mode`, non bloccano i mod integrati.236Le impostazioni e i flag che bloccano i mod installati, come `disableAllHooks`, `--bare` e `--safe-mode`, non bloccano i mod integrati.

235 237 

236### Leggi il sorgente dei mod integrati238### Leggi il sorgente dei mod integrati

194| `session.receive` | `($, e) => ({ text: e.text })`. Attivalo con `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |194| `session.receive` | `($, e) => ({ text: e.text })`. Attivalo con `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` dispone delle asserzioni `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` e `toThrow`, e di `.not` prima di ciascuna di esse.197### Verificare un risultato con `expect`

198 

199Il kit dispone di queste asserzioni, e quella che scegli va dopo il valore che stai verificando, come in `expect(answer.text).toBe('ok')`:

200 

201* **Uguaglianza**: `toBe` per lo stesso valore o oggetto, `toEqual` per la struttura, `toStrictEqual` per la struttura più i campi `undefined` e il prototipo, e `toMatchObject` per i campi che indichi

202* **Testo**: `toMatch`, che accetta un'espressione regolare o una sottostringa, `toStartWith` e `toEndWith`

203* **Numeri**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Contenuto**: `toContain` per una sottostringa o un membro, `toContainEqual` per un membro confrontato per struttura, `toHaveLength` e `toHaveProperty`

205* **Presenza e tipo**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Eccezioni**: `toThrow`, per una funzione che `expect` chiama, o per una promise che verifichi con `.rejects`

207 

208Anteponi `.not` a un'asserzione per verificare il contrario, e `.resolves` o `.rejects` per verificare con cosa si conclude una promise.

198 209 

199Quando un `expect` fallisce all'interno di uno stub o di un hook che hai passato a `on` come funzione semplice anziché come generatore asincrono, il test fallisce. Il motore salta quell'hook, e l'output dell'errore lo indica per nome, ad esempio `in the test's store.set hook`.210Quando un `expect` fallisce all'interno di uno stub o di un hook che hai passato a `on` come funzione semplice anziché come generatore asincrono, il test fallisce. Il motore salta quell'hook, e l'output dell'errore lo indica per nome, ad esempio `in the test's store.set hook`.

200 211 

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rifiuta server specifici dal [`.mcp.json`](https://code.claude.com/docs/it/mcp#project-scope) di un progetto | MCP | Any file |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rifiuta server specifici dal [`.mcp.json`](https://code.claude.com/docs/it/mcp#project-scope) di un progetto | MCP | Any file |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Blocca gli strumenti di Claude nel riquadro iOS Simulator di [desktop](https://code.claude.com/docs/it/desktop.md) | Strumenti | Managed |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Blocca gli strumenti di Claude nel riquadro iOS Simulator di [desktop](https://code.claude.com/docs/it/desktop.md) | Strumenti | Managed |

88| [`disableRemoteControl`](#disableremotecontrol) | Disattiva [Remote Control](https://code.claude.com/docs/it/remote-control.md) ovunque possa essere avviato | Remoto, desktop e notifiche | Any file |88| [`disableRemoteControl`](#disableremotecontrol) | Disattiva [Remote Control](https://code.claude.com/docs/it/remote-control.md) ovunque possa essere avviato | Remoto, desktop e notifiche | Any file |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | Disattiva gli script nelle anteprime HTML dell'app [desktop](https://code.claude.com/docs/it/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) nelle sessioni SSH e WSL | Remoto, desktop e notifiche | Managed |

89| [`disableSideloadFlags`](#disablesideloadflags) | Rifiuta i flag CLI che caricano tramite sideload [plugin](https://code.claude.com/docs/it/plugins/overview.md), [subagent](https://code.claude.com/docs/it/sub-agents.md) e [server MCP](https://code.claude.com/docs/it/mcp.md) | Impostazioni aziendali e gestite | Managed |90| [`disableSideloadFlags`](#disablesideloadflags) | Rifiuta i flag CLI che caricano tramite sideload [plugin](https://code.claude.com/docs/it/plugins/overview.md), [subagent](https://code.claude.com/docs/it/sub-agents.md) e [server MCP](https://code.claude.com/docs/it/mcp.md) | Impostazioni aziendali e gestite | Managed |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | Impedisci alle [skill](https://code.claude.com/docs/it/skills.md) e ai comandi personalizzati di eseguire shell inline | Plugin e skill | Any file |91| [`disableSkillShellExecution`](#disableskillshellexecution) | Impedisci alle [skill](https://code.claude.com/docs/it/skills.md) e ai comandi personalizzati di eseguire shell inline | Plugin e skill | Any file |

91| [`disableWorkflows`](#disableworkflows) | Disattiva i [workflow dinamici](https://code.claude.com/docs/it/workflows.md) per tutti; usa `enableWorkflows` per te stesso | Hook e automazione | Any file |92| [`disableWorkflows`](#disableworkflows) | Disattiva i [workflow dinamici](https://code.claude.com/docs/it/workflows.md) per tutti; usa `enableWorkflows` per te stesso | Hook e automazione | Any file |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Fai in modo che gli strumenti `Write`, `Edit` e `NotebookEdit` rifiutino i percorsi al di fuori delle [directory di lavoro](https://code.claude.com/docs/it/permissions.md#working-directories) in ogni modalità di permesso, tranne [alcuni file di Claude Code stesso](#what-the-write-block-refuses-and-what-stays-writable) | Impostazioni dei permessi | Any file |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Fai in modo che gli strumenti `Write`, `Edit` e `NotebookEdit` rifiutino i percorsi al di fuori delle [directory di lavoro](https://code.claude.com/docs/it/permissions.md#working-directories) in ogni modalità di permesso, tranne [alcuni file di Claude Code stesso](#what-the-write-block-refuses-and-what-stays-writable) | Impostazioni dei permessi | Any file |

148| [`permissions.defaultMode`](#permissions-defaultmode) | Imposta la [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md#which-mode-a-session-starts-in) predefinita per le nuove sessioni | Impostazioni dei permessi | Any file |149| [`permissions.defaultMode`](#permissions-defaultmode) | Imposta la [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md#which-mode-a-session-starts-in) predefinita per le nuove sessioni | Impostazioni dei permessi | Any file |

149| [`permissions.deny`](#permissions-deny) | Blocca gli [usi degli strumenti](https://code.claude.com/docs/it/permissions.md#permission-rule-syntax) elencati, incluse le letture di file che contengono segreti | Impostazioni dei permessi | Any file |150| [`permissions.deny`](#permissions-deny) | Blocca gli [usi degli strumenti](https://code.claude.com/docs/it/permissions.md#permission-rule-syntax) elencati, incluse le letture di file che contengono segreti | Impostazioni dei permessi | Any file |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | Nega le chiamate agli strumenti che resterebbero in attesa di una [richiesta di permesso](https://code.claude.com/docs/it/permissions.md#permission-system), in modo che una sessione che nessuno sta osservando continui a funzionare | Impostazioni dei permessi | User or managed |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Impedisci a chiunque di entrare nella [modalità bypassPermissions](https://code.claude.com/docs/it/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Impostazioni dei permessi | Any file |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Impedisci a chiunque di entrare nella [modalità bypassPermissions](https://code.claude.com/docs/it/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Impostazioni dei permessi | Any file |

151| [`plansDirectory`](#plansdirectory) | Scegli dove il [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode) scrive i file dei piani | Memoria e contesto | Any file |153| [`plansDirectory`](#plansdirectory) | Scegli dove il [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode) scrive i file dei piani | Memoria e contesto | Any file |

152| [`pluginConfigs`](#pluginconfigs) | Archivia le risposte che hai dato alla finestra di dialogo di configurazione di un [plugin](https://code.claude.com/docs/it/plugins/overview.md) | Plugin e skill | User or managed |154| [`pluginConfigs`](#pluginconfigs) | Archivia le risposte che hai dato alla finestra di dialogo di configurazione di un [plugin](https://code.claude.com/docs/it/plugins/overview.md) | Plugin e skill | User or managed |

228| [`statusLine`](#statusline) | Esegui un tuo comando per generare una [riga di stato](https://code.claude.com/docs/it/statusline.md) sotto il prompt | Interfaccia e terminale | Any file |230| [`statusLine`](#statusline) | Esegui un tuo comando per generare una [riga di stato](https://code.claude.com/docs/it/statusline.md) sotto il prompt | Interfaccia e terminale | Any file |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Definisci l'allowlist delle fonti [marketplace](https://code.claude.com/docs/it/plugins/overview.md) che gli utenti possono aggiungere e da cui possono installare | Plugin e skill | Managed |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Definisci l'allowlist delle fonti [marketplace](https://code.claude.com/docs/it/plugins/overview.md) che gli utenti possono aggiungere e da cui possono installare | Plugin e skill | Managed |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Blocca [skill](https://code.claude.com/docs/it/skills.md), [agenti](https://code.claude.com/docs/it/sub-agents.md), [hook](https://code.claude.com/docs/it/hooks.md) e [server MCP](https://code.claude.com/docs/it/mcp.md) provenienti da fonti utente e di progetto | Plugin e skill | Managed |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Blocca [skill](https://code.claude.com/docs/it/skills.md), [agenti](https://code.claude.com/docs/it/sub-agents.md), [hook](https://code.claude.com/docs/it/hooks.md) e [server MCP](https://code.claude.com/docs/it/mcp.md) provenienti da fonti utente e di progetto | Plugin e skill | Managed |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Limita gli [agenti](https://code.claude.com/docs/it/sub-agents.md) alle fonti plugin e gestite | Plugin e skill | Managed |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Blocca gli [agenti](https://code.claude.com/docs/it/sub-agents.md) provenienti da fonti utente e di progetto | Plugin e skill | Managed |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Limita gli [hook](https://code.claude.com/docs/it/hooks.md) alle fonti plugin e gestite | Plugin e skill | Managed |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Blocca gli [hook](https://code.claude.com/docs/it/hooks.md) provenienti da fonti utente e di progetto | Plugin e skill | Managed |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Limita i [server MCP](https://code.claude.com/docs/it/mcp.md) alle fonti plugin e gestite | Plugin e skill | Managed |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Blocca i [server MCP](https://code.claude.com/docs/it/mcp.md) provenienti da fonti utente e di progetto | Plugin e skill | Managed |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Limita le [skill](https://code.claude.com/docs/it/skills.md) alle fonti plugin e gestite | Plugin e skill | Managed |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Blocca le [skill](https://code.claude.com/docs/it/skills.md) provenienti da fonti utente e di progetto | Plugin e skill | Managed |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Scegli la [durata della cache del prompt](https://code.claude.com/docs/it/prompt-caching.md#cache-lifetime) per i subagent e altre richieste al di fuori della conversazione principale | Modello e risposte | Any file |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Scegli la [durata della cache del prompt](https://code.claude.com/docs/it/prompt-caching.md#cache-lifetime) per i subagent e altre richieste al di fuori della conversazione principale | Modello e risposte | Any file |

236| [`subagentStatusLine`](#subagentstatusline) | Riscrivi le righe nella visualizzazione delle attività dei [subagent](https://code.claude.com/docs/it/sub-agents.md) con un tuo comando | Interfaccia e terminale | Any file |238| [`subagentStatusLine`](#subagentstatusline) | Riscrivi le righe nella visualizzazione delle attività dei [subagent](https://code.claude.com/docs/it/sub-agents.md) con un tuo comando | Interfaccia e terminale | Any file |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | Cambia modello automaticamente o metti in pausa quando un [classificatore di sicurezza](https://code.claude.com/docs/it/model-config.md#ask-before-switching) segnala una richiesta | Modello e risposte | Any file |239| [`switchModelsOnFlag`](#switchmodelsonflag) | Cambia modello automaticamente o metti in pausa quando un [classificatore di sicurezza](https://code.claude.com/docs/it/model-config.md#ask-before-switching) segnala una richiesta | Modello e risposte | Any file |

288}290}

289```291```

290 292 

291La chiave non ha effetto sui provider in cui l'advisor [non è disponibile](https://code.claude.com/docs/it/advisor.md#requirements), come Amazon Bedrock e Claude Platform on AWS. `"fable"` richiede [l'accesso a Fable](https://code.claude.com/docs/it/advisor.md#choose-an-advisor-model).293La chiave non ha effetto sui provider in cui l'advisor [non è disponibile](https://code.claude.com/docs/it/advisor.md#requirements), come Amazon Bedrock. Su Claude Platform on AWS, la chiave richiede Claude Code v2.1.300 o successivo. `"fable"` richiede [l'accesso a Fable](https://code.claude.com/docs/it/advisor.md#choose-an-advisor-model).

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449Attiva la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) per le sessioni in cui è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo in cui vuoi velocità a un costo per token più alto. Di solito non modifichi questa chiave a mano. Eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, ed eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave.451Attiva la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) per le sessioni in cui è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo in cui vuoi velocità a un costo per token più alto. Di solito non modifichi questa chiave a mano. Eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, ed eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave.

450 452 

451Solo Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8 supportano la modalità veloce. Eseguire `/fast` da un altro modello ti fa passare a Opus, e passare a un modello non supportato disattiva la modalità veloce. Consulta [Cambiare modello con la modalità veloce attiva](https://code.claude.com/docs/it/fast-mode.md#switch-models-while-fast-mode-is-on).453Sull'API Anthropic, solo Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8 supportano la modalità veloce. Eseguire `/fast` da un altro modello ti fa passare a Opus, e passare a un modello non supportato disattiva la modalità veloce. Consulta [Cambiare modello con la modalità veloce attiva](https://code.claude.com/docs/it/fast-mode.md#switch-models-while-fast-mode-is-on). Su Agent Platform di Google Cloud, invece, [`/fast` ti fa passare a Fable 5.2](https://code.claude.com/docs/it/fast-mode#use-fast-mode-on-agent-platform) e non scrive questa chiave, e Claude Code ignora un `true` salvato.

452 454 

453* **Ambito**: [`Any file`](#scopes)455* **Ambito**: [`Any file`](#scopes)

454* **Tipo**: Boolean456* **Tipo**: Boolean

904Controlla quali strumenti Claude può utilizzare senza chiedere, per quali chiede conferma e quali sono bloccati. Imposta anche la [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md) predefinita per le nuove sessioni. Ogni chiave `permissions.*` di seguito si annida sotto questo oggetto.906Controlla quali strumenti Claude può utilizzare senza chiedere, per quali chiede conferma e quali sono bloccati. Imposta anche la [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md) predefinita per le nuove sessioni. Ogni chiave `permissions.*` di seguito si annida sotto questo oggetto.

905 907 

906* **Ambito**: [`Any file`](#scopes)908* **Ambito**: [`Any file`](#scopes)

907* **Tipo**: oggetto con `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` e `disableAutoMode`909* **Tipo**: oggetto con `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `denyInsteadOfPrompting`, `disableBypassPermissionsMode` e `disableAutoMode`

908* **Predefinito**: non impostato910* **Predefinito**: non impostato

909 911 

910Questo esempio approva i comandi `npm run` senza chiedere, chiede conferma prima di `git push`, blocca le letture di `.env` e avvia le sessioni in `acceptEdits`:912Questo esempio approva i comandi `npm run` senza chiedere, chiede conferma prima di `git push`, blocca le letture di `.env` e avvia le sessioni in `acceptEdits`:

1163 1165 

1164Le regole di permesso si sovrappongono a ogni modalità: le regole `deny` bloccano in ogni modalità, inclusa `bypassPermissions`. Consulta [Modalità di permesso](https://code.claude.com/docs/it/permission-modes.md). Nelle sessioni cloud, Claude Code rispetta solo `acceptEdits`, `plan`, `default` e `auto` da questa chiave. Per le conversazioni avviate dall'estensione VS Code, consulta [quale impostazione legge l'estensione per la modalità di permesso iniziale](https://code.claude.com/docs/it/permission-modes.md#switch-permission-modes).1166Le regole di permesso si sovrappongono a ogni modalità: le regole `deny` bloccano in ogni modalità, inclusa `bypassPermissions`. Consulta [Modalità di permesso](https://code.claude.com/docs/it/permission-modes.md). Nelle sessioni cloud, Claude Code rispetta solo `acceptEdits`, `plan`, `default` e `auto` da questa chiave. Per le conversazioni avviate dall'estensione VS Code, consulta [quale impostazione legge l'estensione per la modalità di permesso iniziale](https://code.claude.com/docs/it/permission-modes.md#switch-permission-modes).

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170Imposta questa chiave su `true` per mantenere in esecuzione una sessione quando non c'è nessuno a rispondere a una richiesta di permesso. Claude Code nega una chiamata a uno strumento che altrimenti resterebbe in attesa di una richiesta di conferma, e il turno continua. Richiede Claude Code v2.1.319 o successivo.

1171 

1172Una chiamata procede se una regola di consenso, la tua [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md) o il classificatore della modalità auto la approva. Per consentire la maggior parte delle chiamate per cui altrimenti verrebbe chiesta conferma, rispondi da un [hook `PermissionRequest`](https://code.claude.com/docs/it/hooks#permissionrequest).

1173 

1174* **Ambito**: [`User or managed`](#scopes), e `--settings`. Un repository non può impostarla per te.

1175* **Tipo**: Booleano

1176 * `true`: Claude Code nega le chiamate per cui altrimenti chiederebbe conferma

1177 * `false`: equivale a non impostato; le chiamate vengono comunque negate se un'altra di queste fonti imposta `true`

1178* **Predefinito**: non impostato, quindi una chiamata che richiede approvazione ti chiede conferma

1179 

1180In `~/.claude/settings.json`, questo esempio avvia le sessioni in modalità auto e nega tutto ciò che ricadrebbe comunque su una richiesta di conferma:

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191La chiave si applica nelle esecuzioni `-p`, nelle sessioni interattive del terminale, nell'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md), nelle sessioni locali nell'[app Desktop](https://code.claude.com/docs/it/desktop.md), nei [subagent](https://code.claude.com/docs/it/sub-agents.md) e nei [team di agenti](https://code.claude.com/docs/it/agent-teams.md). Per negare invece ciò che chiederebbe conferma in una singola esecuzione [non interattiva](https://code.claude.com/docs/it/headless.md), passa [`--permission-prompts none`](https://code.claude.com/docs/it/headless#turn-off-permission-prompts-in-unattended-runs) con `-p`.

1192 

1193#### Cos'altro blocca `denyInsteadOfPrompting`

1194 

1195Con l'impostazione attiva, Claude Code blocca anche queste richieste di risposta:

1196 

1197* **Strumenti di domanda e di piano**: Claude Code esclude [`AskUserQuestion`](https://code.claude.com/docs/it/tools-reference#askuserquestion-tool-behavior), `EnterPlanMode` e `ExitPlanMode`, quindi una sessione in plan mode non può uscirne da sola. Un membro di un team di agenti mantiene `EnterPlanMode` e `ExitPlanMode`

1198* **Elicitation MCP**: Claude Code annulla una [richiesta di elicitation](https://code.claude.com/docs/it/mcp.md#respond-to-mcp-elicitation-requests) a meno che un [hook `Elicitation`](https://code.claude.com/docs/it/hooks#elicitation) non vi risponda

1199* **Host dei permessi**: Claude Code non interpella la tua [callback `canUseTool`](https://code.claude.com/docs/it/agent-sdk/user-input) né [`--permission-prompt-tool`](https://code.claude.com/docs/it/cli-reference#cli-flags). Per approvare le chiamate da codice, rispondi da un hook `PermissionRequest`. Alcune chiamate vengono negate prima che venga interpellato qualsiasi hook, come una [rimozione di percorsi critici](https://code.claude.com/docs/it/permission-modes.md#critical-path-removals-in-each-permission-mode) in modalità `auto` non coperta da alcuna regola ask.

1200* **Avviso di fatturazione del classificatore**: dove l'[avviso sulle richieste del classificatore fatturate](https://code.claude.com/docs/it/auto-mode-classifier-billing.md) aprirebbe una finestra di dialogo, Claude Code non lo mostra e nega le azioni che richiedono quelle richieste

1201 

1202Una sessione può comunque restare in attesa della [finestra di dialogo di fiducia del workspace](https://code.claude.com/docs/it/permissions.md#project-allow-rules-and-workspace-trust) e dell'[approvazione dei server MCP di progetto](https://code.claude.com/docs/it/mcp.md#project-server-approvals-and-workspace-trust). Rispondi a entrambe prima di lasciare la sessione in esecuzione.

1203 

1204#### Messaggi da `denyInsteadOfPrompting`

1205 

1206Questi messaggi segnalano chiamate rifiutate. Non sono richieste di conferma, quindi nulla attende la tua risposta.

1207 

1208Il diniego che Claude legge può iniziare con questo testo:

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214Nell'output `stream-json`, [le esecuzioni che emettono un messaggio `permission_denied`](https://code.claude.com/docs/it/agent-sdk/typescript#sdkpermissiondeniedmessage) riportano questo `decision_reason`:

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220In modalità auto con l'impostazione attiva, il turno termina dopo 20 chiamate consecutive che il classificatore ha bloccato o che un [controllo di sicurezza ha rifiutato](https://code.claude.com/docs/it/errors.md#auto-mode-cannot-determine-the-safety-of-an-action), e vedi questo messaggio:

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226Un'esecuzione `-p` segnala quel turno come `error_during_execution`.

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168Impedisci a chiunque di entrare in modalità `bypassPermissions`. Claude Code rifiuta quindi il flag `--dangerously-skip-permissions` e ignora il `permissionMode: bypassPermissions` della [definizione di un agente](https://code.claude.com/docs/it/sub-agents.md#permission-modes), quindi il subagent viene eseguito con la modalità di permesso della sessione padre.1230Impedisci a chiunque di entrare in modalità `bypassPermissions`. Claude Code rifiuta quindi il flag `--dangerously-skip-permissions` e ignora il `permissionMode: bypassPermissions` della [definizione di un agente](https://code.claude.com/docs/it/sub-agents.md#permission-modes), quindi il subagent viene eseguito con la modalità di permesso della sessione padre.

1202 1264 

1203Salta la finestra di dialogo di conferma che Claude Code mostra prima che una sessione entri in modalità `bypassPermissions`, sia da `--dangerously-skip-permissions` sia da `defaultMode: "bypassPermissions"`. Claude Code scrive `true` qui nelle tue impostazioni utente quando accetti quella finestra di dialogo una volta.1265Salta la finestra di dialogo di conferma che Claude Code mostra prima che una sessione entri in modalità `bypassPermissions`, sia da `--dangerously-skip-permissions` sia da `defaultMode: "bypassPermissions"`. Claude Code scrive `true` qui nelle tue impostazioni utente quando accetti quella finestra di dialogo una volta.

1204 1266 

1205* **Ambito**: [`User, local, or managed`](#scopes). Un repository non attendibile non può saltare la finestra di dialogo per te.1267* **Ambito**: [`User, local, or managed`](#scopes), e i file passati con `--settings`. Le [sessioni in background](https://code.claude.com/docs/it/permission-modes.md#bypass-permissions-ignored-in-a-background-session) considerano solo le impostazioni utente e gestite. Un repository non attendibile non può saltare la finestra di dialogo per te.

1206* **Tipo**: Booleano1268* **Tipo**: Booleano

1207 * `true`: Claude Code salta la finestra di dialogo di conferma prima che una sessione entri in modalità `bypassPermissions`1269 * `true`: Claude Code salta la finestra di dialogo di conferma prima che una sessione entri in modalità `bypassPermissions`

1208 * `false`: equivale a non impostato; la finestra di dialogo appare a meno che un altro di questi file non imposti `true`1270 * `false`: equivale a non impostato; la finestra di dialogo appare a meno che un altro di questi file non imposti `true`

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code colora il codice per linguaggio nei diff, blocchi di codice e anteprime di file che mostra nel terminale, con il suo evidenziatore integrato; nessun plugin o language server è coinvolto. Imposta questa chiave su `true` per mostrarli come testo semplice invece, ad esempio se i colori si scontrano con il tuo tema del terminale o rallentano un lettore di schermo.3197Claude Code colora il codice per linguaggio nei diff, nei blocchi di codice e nelle anteprime di file che mostra nel terminale, con il suo evidenziatore integrato. Imposta questa chiave su `true` per mostrarli invece come testo semplice, ad esempio se i colori si scontrano con il tema del tuo terminale o rallentano un lettore di schermo.

3136 3198 

3137* **Scope**: [`Any file`](#scopes)3199* **Scope**: [`Any file`](#scopes)

3138* **Type**: Boolean3200* **Type**: Boolean

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113Blocca skills, agent, hook e server MCP dalle origini utente e progetto, quindi possono provenire solo da plugin o impostazioni gestite. Combinalo con [`strictKnownMarketplaces`](#strictknownmarketplaces) per controllare l'intera catena di approvvigionamento della personalizzazione: l'allowlist del marketplace controlla quali plugin gli utenti possono installare.4175Blocca skill, agenti, hook e server MCP dalle origini utente e di progetto. Combinala con [`strictKnownMarketplaces`](#strictknownmarketplaces) per scegliere da quali marketplace gli utenti possono installare plugin. Aggiungi [`disableSideloadFlags`](#disablesideloadflags) per rifiutare i flag della CLI che caricano lateralmente plugin, agenti e server MCP per una singola esecuzione.

4114 4176 

4115* **Scope**: [`Managed`](#scopes)4177* **Scope**: [`Managed`](#scopes)

4116* **Type**: `true` per bloccare tutti e quattro i tipi di personalizzazione, o un array che nomina i tipi da bloccare, da `"skills"`, `"agents"`, `"hooks"` e `"mcp"`4178* **Type**: `true` per bloccarli tutti, oppure un array che nomina quelli da bloccare, tra `"skills"`, `"agents"`, `"hooks"` e `"mcp"`

4117* **Default**: non impostato, quindi nulla è bloccato4179* **Default**: non impostato, quindi nulla è bloccato

4118 4180 

4119Questo esempio blocca skills e hook e lascia agent e server MCP sbloccati:4181Questo esempio blocca skills e hook e lascia agent e server MCP sbloccati:

4216Ogni scope serve a uno scopo diverso:4278Ogni scope serve a uno scopo diverso:

4217 4279 

4218* **User settings**: le tue preferenze personali dei plugin4280* **User settings**: le tue preferenze personali dei plugin

4219* **Project settings**: i plugin condivisi con tutti nel repository4281* **Project settings**: i plugin attivati per tutti nel repository. Questo non li installa, quindi ogni utente [li installa](https://code.claude.com/docs/it/plugins/org.md#require-plugins-per-repository).

4220* **Local settings**: override per macchina, gitignored quando Claude Code salva un'impostazione lì4282* **Local settings**: override per macchina, gitignored quando Claude Code salva un'impostazione lì

4221* **Managed settings**: policy a livello organizzativo. Un plugin impostato a `false` qui è bloccato dall'installazione in ogni scope e nascosto dal marketplace4283* **Managed settings**: policy a livello organizzativo. Un plugin impostato a `false` qui è bloccato dall'installazione in ogni scope e nascosto dal marketplace

4222 4284 

4223Le impostazioni del progetto hanno precedenza sulle impostazioni utente, quindi impostare un plugin a `false` in `~/.claude/settings.json` non disabilita un plugin che il `.claude/settings.json` del progetto abilita. Per rinunciare a un plugin abilitato dal progetto sulla tua macchina, impostalo a `false` in `.claude/settings.local.json` invece. I plugin forzatamente abilitati dalle impostazioni gestite non possono essere disabilitati in questo modo, poiché le impostazioni gestite sovrascrivono le impostazioni locali.4285Le impostazioni del progetto hanno precedenza sulle impostazioni utente, quindi impostare un plugin a `false` in `~/.claude/settings.json` non disabilita un plugin che il `.claude/settings.json` del progetto abilita. Per rinunciare a un plugin abilitato dal progetto sulla tua macchina, impostalo a `false` in `.claude/settings.local.json` invece. I plugin forzatamente abilitati dalle impostazioni gestite non possono essere disabilitati in questo modo, poiché le impostazioni gestite sovrascrivono le impostazioni locali.

4224 4286 

4225Abilitare un plugin da un'origine esterna come un repository GitHub o un pacchetto npm nel `.claude/settings.json` di un progetto non lo installa per altre persone. Su ogni percorso che carica i plugin, Claude Code segnala il plugin come non installato finché ogni utente non lo [installa da solo](https://code.claude.com/docs/it/plugins/org.md#require-plugins-per-repository).

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229Registra marketplace di plugin aggiuntivi per nome, in modo che le persone che aprono il repository, o tutti quelli che le impostazioni gestite raggiungono, ottengono il marketplace senza aggiungerlo da soli. Claude Code registra ogni marketplace che non conosce già. Se un plugin che [`enabledPlugins`](#enabledplugins) nomina da esso si installa dipende dall'origine del plugin e da quale file lo abilita; quella voce ha le regole.4289Registra marketplace di plugin aggiuntivi per nome, in modo che le persone che aprono il repository, o tutti quelli raggiunti dalle tue impostazioni gestite, ottengano il marketplace senza aggiungerlo da soli. Claude Code registra ogni marketplace che non conosce già. Se un plugin che [`enabledPlugins`](#enabledplugins) nomina da esso venga installato dipende dall'origine del plugin e da quale file lo abilita; [Abilitato nelle impostazioni di progetto ma non installato](https://code.claude.com/docs/it/plugins/loading.md#enabled-in-project-settings-but-not-installed) riporta le regole.

4230 4290 

4231* **Scope**: [`Any file`](#scopes). Claude Code onora le voci nel `.claude/settings.json` o `.claude/settings.local.json` di un repository solo dopo che accetti il dialogo di fiducia dell'area di lavoro per quella cartella; in una cartella che non hai fidato, inclusa una corsa `-p` lì, le ignora senza un messaggio.4291* **Scope**: [`Any file`](#scopes). Claude Code onora le voci nel `.claude/settings.json` o `.claude/settings.local.json` di un repository solo dopo che accetti il dialogo di fiducia dell'area di lavoro per quella cartella; in una cartella che non hai fidato, inclusa una corsa `-p` lì, le ignora senza un messaggio.

4232* **Type**: oggetto che mappa un nome di marketplace a un oggetto con un oggetto `source` e un Boolean `autoUpdate` opzionale4292* **Type**: oggetto che mappa un nome di marketplace a un oggetto con un oggetto `source` e un Boolean `autoUpdate` opzionale

4354 4414 

4355Elenca i plugin gestiti i cui [mods](https://code.claude.com/docs/it/plugins/mods/overview.md) vengono eseguiti prima di ogni mod che un utente installa, nell'ordine elencato. Quando imposti questa chiave nelle impostazioni gestite, nomina `sec-default@builtin` nell'elenco per mantenere la guardia incorporata. Nelle impostazioni gestite, Claude Code salta un id il cui plugin non conta come della tua organizzazione. Vedi [Installa i mods della tua organizzazione e imposta l'ordine](https://code.claude.com/docs/it/plugins/mods/admin.md#install-your-organizations-mods) per quelle condizioni e per come le due chiavi di ordinamento funzionano insieme.4415Elenca i plugin gestiti i cui [mods](https://code.claude.com/docs/it/plugins/mods/overview.md) vengono eseguiti prima di ogni mod che un utente installa, nell'ordine elencato. Quando imposti questa chiave nelle impostazioni gestite, nomina `sec-default@builtin` nell'elenco per mantenere la guardia incorporata. Nelle impostazioni gestite, Claude Code salta un id il cui plugin non conta come della tua organizzazione. Vedi [Installa i mods della tua organizzazione e imposta l'ordine](https://code.claude.com/docs/it/plugins/mods/admin.md#install-your-organizations-mods) per quelle condizioni e per come le due chiavi di ordinamento funzionano insieme.

4356 4416 

4357* **Scope**: [`User or managed`](#scopes). Claude Code legge la chiave dalle impostazioni gestite. Legge la chiave dalle impostazioni utente solo su una macchina senza impostazioni gestite, in una sessione la cui credenziale non è un `/login` Team o Enterprise. Ignora la chiave nelle impostazioni di progetto e locali e in un file `--settings`.4417* **Scope**: [`User or managed`](#scopes). Claude Code legge la chiave dalle impostazioni gestite. Legge la chiave dalle impostazioni utente solo su una macchina senza impostazioni gestite né file `managed-mcp.json`, in una sessione la cui credenziale non è un `/login` Team o Enterprise. Ignora la chiave nelle impostazioni di progetto e locali e in un file `--settings`.

4358* **Type**: array di stringhe `plugin-name@marketplace-name`4418* **Type**: array di stringhe `plugin-name@marketplace-name`

4359* **Default**: non impostato4419* **Default**: non impostato

4360 4420 

4374 4434 

4375Elenca i plugin gestiti i cui [mods](https://code.claude.com/docs/it/plugins/mods/overview.md) vengono eseguiti dopo ogni mod che un utente installa, nell'ordine elencato. Un id elencato sia in `prependPlugins` che in `appendPlugins` viene preposto. Nelle impostazioni gestite, Claude Code salta un id il cui plugin non [conta come della tua organizzazione](https://code.claude.com/docs/it/plugins/mods/admin.md#install-your-organizations-mods).4435Elenca i plugin gestiti i cui [mods](https://code.claude.com/docs/it/plugins/mods/overview.md) vengono eseguiti dopo ogni mod che un utente installa, nell'ordine elencato. Un id elencato sia in `prependPlugins` che in `appendPlugins` viene preposto. Nelle impostazioni gestite, Claude Code salta un id il cui plugin non [conta come della tua organizzazione](https://code.claude.com/docs/it/plugins/mods/admin.md#install-your-organizations-mods).

4376 4436 

4377* **Scope**: [`User or managed`](#scopes). Claude Code legge la chiave dalle impostazioni gestite. Legge la chiave dalle impostazioni utente solo su una macchina senza impostazioni gestite, in una sessione la cui credenziale non è un `/login` Team o Enterprise. Ignora la chiave nelle impostazioni di progetto e locali e in un file `--settings`.4437* **Scope**: [`User or managed`](#scopes). Claude Code legge la chiave dalle impostazioni gestite. Legge la chiave dalle impostazioni utente solo su una macchina senza impostazioni gestite né file `managed-mcp.json`, in una sessione la cui credenziale non è un `/login` Team o Enterprise. Ignora la chiave nelle impostazioni di progetto e locali e in un file `--settings`.

4378* **Type**: array di stringhe `plugin-name@marketplace-name`4438* **Type**: array di stringhe `plugin-name@marketplace-name`

4379* **Default**: non impostato4439* **Default**: non impostato

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615Scegli cosa fa questa sessione con i [messaggi provenienti dalle tue altre sessioni di Claude Code](https://code.claude.com/docs/it/cross-session-messaging.md#control-inbound-messages). Quando nessun valore si applica, Claude Code decide per ogni messaggio in base alle classi di modalità di permesso delle due sessioni. Richiede Claude Code v2.1.224 o successivo.4675Scegli cosa fa questa sessione con i [messaggi provenienti dalle tue altre sessioni di Claude Code](https://code.claude.com/docs/it/cross-session-messaging.md#control-inbound-messages). Quando nessun valore si applica, Claude Code decide per ogni messaggio in base alle classi di modalità di permesso delle due sessioni.

4616 4676 

4617* **Scope**: [`Any file`](#scopes). Un valore di progetto o locale si applica solo quando è più rigoroso del valore fornito dalle impostazioni gestite, dal flag `--settings` o dalle impostazioni utente.4677* **Scope**: [`Any file`](#scopes). Un valore di progetto o locale si applica solo quando è più rigoroso del valore fornito dalle impostazioni gestite, dal flag `--settings` o dalle impostazioni utente.

4618* **Type**: string, uno tra:4678* **Type**: string, uno tra:

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011Impedisci l'esecuzione degli script quando le persone [visualizzano l'anteprima di un file HTML](https://code.claude.com/docs/it/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) da una sessione SSH o WSL nell'app desktop. La navigazione esterna nel riquadro Browser non è interessata.

5012 

5013L'app desktop legge questa chiave; la CLI del terminale la ignora. Richiede Claude Desktop v5.1231.0 o successivo. Le versioni precedenti ignorano la chiave: per bloccare gli script in quelle versioni, imposta anche [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation), che disattiva anche la navigazione esterna.

5014 

5015* **Scope**: [`Managed`](#scopes). L'app desktop non legge la chiave dalla macchina remota né dalla distribuzione WSL.

5016* **Type**: Boolean; solo il Boolean JSON `true` ha effetto

5017 * `true`: le anteprime HTML nelle sessioni SSH e WSL non eseguono script

5018 * `false`: la chiave non disattiva gli script

5019* **Default**: non impostato, quindi la chiave non ha effetto

5020 

5021Se il computer che esegue l'app desktop non riceve altre impostazioni gestite di Claude Code, imposta anche [`parentSettingsBehavior`](#parentsettingsbehavior) su `"merge"` nelle impostazioni gestite che crei. 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). [Disattiva gli script nelle anteprime SSH e WSL per la tua organizzazione](https://code.claude.com/docs/it/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) spiega entrambi gli aspetti e indica dove impostare la chiave.

5022 

5023Questo esempio mostra la chiave da sola, come la aggiungeresti alle impostazioni gestite che un computer riceve già:

5024 

5025```json managed-settings.json theme={null}

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031L'app desktop ignora qualsiasi altro valore e un valore che non è un Boolean, come la stringa `"true"` o `1`, registra anche un avviso.

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951Disattiva lo strumento [Artifact](https://code.claude.com/docs/it/artifacts.md), che pubblica l'output della sessione come pagina web privata su claude.ai. Quando disattivi la riga **Artifacts** in `/config`, Claude Code scrive questa chiave nelle tue impostazioni utente, quindi di solito non la modifichi manualmente.5035Disattiva lo strumento [Artifact](https://code.claude.com/docs/it/artifacts.md), che pubblica l'output della sessione come pagina web privata su claude.ai. Quando disattivi la riga **Artifacts** in `/config`, Claude Code scrive questa chiave nelle tue impostazioni utente, quindi di solito non la modifichi manualmente.

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222Limita il tipo di account con cui le persone possono accedere. Imposta `"claudeai"` per consentire solo account claude.ai, `"console"` per consentire solo account Claude Console, oppure `"gateway"` per indirizzare le persone a un [cloud gateway](https://code.claude.com/docs/it/claude-apps-gateway) anziché a un accesso first-party. Gli amministratori lo impostano nelle impostazioni gestite e lo abbinano a [`forceLoginOrgUUID`](#forceloginorguuid) per mantenere gli accessi claude.ai degli sviluppatori all'interno di un'unica organizzazione.5306Limita il tipo di account con cui le persone possono accedere: `"claudeai"` per l'accesso claude.ai oppure `"console"` per l'accesso Claude Console. Imposta `"gateway"` per indirizzare le persone a un [cloud gateway](https://code.claude.com/docs/it/claude-apps-gateway) anziché a un accesso first-party. Gli amministratori lo impostano nelle impostazioni gestite e lo abbinano a [`forceLoginOrgUUID`](#forceloginorguuid) per mantenere gli accessi claude.ai degli sviluppatori all'interno di un'unica organizzazione.

5223 5307 

5224Se lo imposti su `"claudeai"` in qualsiasi file di impostazioni, Claude Code smette anche di offrire l'[accesso Console senza chiave](https://code.claude.com/docs/it/authentication.md#sign-in-without-an-api-key) nelle sessioni a cui quel file si applica. Con il solo `"console"`, le persone possono comunque raggiungere l'accesso senza chiave dopo un accesso non riuscito. Per impedire a Claude Code di offrirlo, consulta [Smettere di offrire l'accesso senza chiave sulle macchine gestite](https://code.claude.com/docs/it/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), che elenca anche cos'altro cambia `forceLoginOrgUUID`.5308Se lo imposti su `"claudeai"` in qualsiasi file di impostazioni, Claude Code smette anche di offrire l'[accesso Console senza chiave](https://code.claude.com/docs/it/authentication.md#sign-in-without-an-api-key) nelle sessioni a cui quel file si applica. Con il solo `"console"`, le persone possono comunque raggiungere l'accesso senza chiave dopo un accesso non riuscito. Per impedire a Claude Code di offrirlo, consulta [Smettere di offrire l'accesso senza chiave sulle macchine gestite](https://code.claude.com/docs/it/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), che elenca anche cos'altro cambia `forceLoginOrgUUID`.

5225 5309 

5226* **Ambito**: [`Any file`](#scopes). Claude Code rispetta `"gateway"` dalle stesse fonti di [`forceLoginGatewayUrl`](#forcelogingatewayurl) e lo considera non impostato altrove.5310* **Ambito**: [`Any file`](#scopes). Claude Code rispetta `"gateway"` dalle stesse fonti di [`forceLoginGatewayUrl`](#forcelogingatewayurl) e lo considera non impostato altrove.

5227* **Tipo**: stringa, una tra:5311* **Tipo**: stringa, una tra:

5228 * `"claudeai"`: solo gli account claude.ai possono accedere5312 * `"claudeai"`: accesso claude.ai

5229 * `"console"`: solo gli account Claude Console possono accedere5313 * `"console"`: accesso Claude Console

5230 * `"gateway"`: Claude Code indirizza le persone a un cloud gateway anziché a un accesso first-party5314 * `"gateway"`: Claude Code indirizza le persone a un cloud gateway anziché a un accesso first-party

5231* **Predefinito**: non impostato, quindi le persone scelgono un metodo di accesso5315* **Predefinito**: non impostato, quindi le persone scelgono un metodo di accesso

5232 5316 

5471 5555 

5472Imposta quanti giorni Claude Code mantiene [i trascritti della sessione e altri dati dell'applicazione](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically) prima di eliminarli. Claude Code esegue l'eliminazione come una scansione di background dopo l'avvio di una sessione, purché possa determinare in modo sicuro il periodo di conservazione. La scansione elimina i trascritti senza mostrare un messaggio, quindi una sessione che non hai utilizzato per più tempo del periodo di conservazione non appare più nel selettore [`/resume`](https://code.claude.com/docs/it/sessions#resume-a-session).5556Imposta quanti giorni Claude Code mantiene [i trascritti della sessione e altri dati dell'applicazione](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically) prima di eliminarli. Claude Code esegue l'eliminazione come una scansione di background dopo l'avvio di una sessione, purché possa determinare in modo sicuro il periodo di conservazione. La scansione elimina i trascritti senza mostrare un messaggio, quindi una sessione che non hai utilizzato per più tempo del periodo di conservazione non appare più nel selettore [`/resume`](https://code.claude.com/docs/it/sessions#resume-a-session).

5473 5557 

5558Per impostazione predefinita, Claude Code mantiene oltre questo periodo le trascrizioni delle sessioni che hai avviato o continuato più di recente in Claude Desktop o Cowork, anche se imposti tu stesso questa chiave. Questo periodo [si applica comunque a esse in alcuni casi](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically), ad esempio con la configurazione HIPAA. Prima della v2.1.248, Claude Code le eliminava dopo questo periodo.

5559 

5474* **Scope**: [`Any file`](#scopes)5560* **Scope**: [`Any file`](#scopes)

5475* **Type**: numero di giorni, un numero intero, minimo `1`5561* **Type**: numero di giorni, un numero intero, minimo `1`

5476* **Default**: `30`5562* **Default**: `30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Imposta un limite di età in giorni per le trascrizioni delle sessioni che hai avviato o continuato più di recente in Claude Desktop o Cowork. Senza questa chiave, Claude Code [mantiene quelle trascrizioni a qualsiasi età](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically). Claude Code elimina ognuna una volta che è più vecchia sia di questo limite che di [`cleanupPeriodDays`](#cleanupperioddays), quindi con `cleanupPeriodDays` al suo valore predefinito di 30, un valore di `7` le mantiene comunque 30 giorni. [Cleaned up automatically](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically) elenca i casi in cui si applica invece `cleanupPeriodDays` e Claude Code ignora questa chiave. Richiede Claude Code v2.1.248 o successivo.5574Imposta un limite di età in giorni per le trascrizioni delle sessioni che hai avviato o continuato più di recente in Claude Desktop o Cowork. Senza questa chiave, Claude Code [mantiene quelle trascrizioni a qualsiasi età](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically), tranne in casi come una sessione che hai eliminato in Claude Desktop. Richiede Claude Code v2.1.248 o successivo.

5575 

5576Claude Code elimina ogni trascrizione una volta che è più vecchia sia di questo limite che di [`cleanupPeriodDays`](#cleanupperioddays), quindi con `cleanupPeriodDays` al suo valore predefinito di 30, un valore di `7` le mantiene comunque 30 giorni. [Cleaned up automatically](https://code.claude.com/docs/it/claude-directory.md#cleaned-up-automatically) elenca i casi in cui si applica invece `cleanupPeriodDays` e Claude Code ignora questa chiave.

5489 5577 

5490* **Scope**: [`User or managed`](#scopes). Claude Code legge anche la chiave da un file che passi con `--settings`, e la ignora nelle impostazioni di progetto e locali.5578* **Scope**: [`User or managed`](#scopes). Claude Code legge anche la chiave da un file che passi con `--settings`, e la ignora nelle impostazioni di progetto e locali.

5491* **Type**: numero di giorni, un numero intero, minimo `0`5579* **Type**: numero di giorni, un numero intero, minimo `0`