Documentation — Spybara

accessibility.md +1 −1

Details

111 Rispondete a menu e prompt111 Rispondete a menu e prompt

112</h2>112</h2>

113 113

114In modalità lettore di schermo, i menu che normalmente navighereste con i tasti freccia, inclusi i prompt di permesso, diventano elenchi numerati. Claude Code annuncia ogni opzione come una riga numerata, quindi un prompt `Enter selection` che nomina l'intervallo valido. Digitate il numero dell'opzione che desiderate e premete Invio.114In modalità lettore di schermo, i menu che normalmente navighereste con i tasti freccia, inclusi i prompt di permesso, diventano elenchi numerati. Claude Code annuncia ogni opzione come una riga numerata, quindi un prompt `Select with numbers` che nomina l'intervallo valido. Digitate il numero dell'opzione che desiderate e premete Invio.

115 115

116* Premete Escape per annullare un menu il cui prompt termina con `or Escape to cancel`.116* Premete Escape per annullare un menu il cui prompt termina con `or Escape to cancel`.

117* Se digitate un numero che non è nell'elenco, Claude Code annuncia l'intervallo valido e vi consente di riprovare.117* Se digitate un numero che non è nell'elenco, Claude Code annuncia l'intervallo valido e vi consente di riprovare.

admin-setup.md +2 −2

Details

97| :- | :- | :- |97| :- | :- | :- |

99| [Permission lockdown](/docs/it/permissions#managed-only-settings) | Rendi le impostazioni gestite l'[unica fonte di impostazioni per le regole di autorizzazione](/docs/it/settings-reference#allowmanagedpermissionrulesonly). Disabilita `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |99| [Permission lockdown](/docs/it/permissions#managed-only-settings) | Rendi le impostazioni gestite l'[unica fonte di impostazioni per le regole di autorizzazione](/docs/it/settings-reference#allowmanagedpermissionrulesonly). Disabilita `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |

100| [Starting permission mode](/docs/it/permission-modes#which-mode-a-session-starts-in) | Scegli la modalità di autorizzazione in cui iniziano le sessioni del terminale dei tuoi sviluppatori invece della modalità di autorizzazione iniziale integrata, o rimuovi la modalità automatica. L'estensione VS Code legge un `defaultMode` che imposti solo su piani Pro, Max e Team; [Switch permission modes](/docs/it/permission-modes#switch-permission-modes) elenca cosa legge l'estensione | `permissions.defaultMode`, `permissions.disableAutoMode` |100| [Starting permission mode](/docs/it/permission-modes#which-mode-a-session-starts-in) | Scegli la modalità di autorizzazione in cui iniziano le sessioni del terminale dei tuoi sviluppatori invece della modalità di autorizzazione iniziale integrata, o rimuovi la modalità automatica. [Switch permission modes](/docs/it/permission-modes#switch-permission-modes) elenca quando l'estensione VS Code legge un `defaultMode` che imposti | `permissions.defaultMode`, `permissions.disableAutoMode` |

101| [Sandboxing](/docs/it/sandboxing) | Isolamento del filesystem e della rete a livello di sistema operativo con allowlist di domini | `sandbox.enabled`, `sandbox.network.allowedDomains` |101| [Sandboxing](/docs/it/sandboxing) | Isolamento del filesystem e della rete a livello di sistema operativo con allowlist di domini | `sandbox.enabled`, `sandbox.network.allowedDomains` |

102| [Managed policy CLAUDE.md](/docs/it/memory#deploy-organization-wide-claude-md) | Istruzioni a livello di organizzazione caricate in ogni sessione, non possono essere escluse | File nel percorso della policy gestita |102| [Managed policy CLAUDE.md](/docs/it/memory#deploy-organization-wide-claude-md) | Istruzioni a livello di organizzazione caricate in ogni sessione, non possono essere escluse | File nel percorso della policy gestita |

103| [MCP server control](/docs/it/managed-mcp) | Limitare quali server MCP gli utenti possono aggiungere o connettere, distribuire un set fisso, o fornire server remoti a ogni utente insieme ai loro | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, o un file `managed-mcp.json` distribuito |103| [MCP server control](/docs/it/managed-mcp) | Limitare quali server MCP gli utenti possono aggiungere o connettere, distribuire un set fisso, o fornire server remoti a ogni utente insieme ai loro | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, o un file `managed-mcp.json` distribuito |

105| [Customization lockdown](/docs/it/settings-reference#strictpluginonlycustomization) | Bloccare skills, agent, hook e server MCP da fonti utente e progetto, in modo che possano provenire solo da plugin o impostazioni gestite. Bloccare le skills interrompe anche la sincronizzazione dei [skills che i tuoi sviluppatori abilitano su claude.ai](/docs/it/skills#where-synced-skills-load) | `strictPluginOnlyCustomization` |105| [Customization lockdown](/docs/it/settings-reference#strictpluginonlycustomization) | Bloccare skills, agent, hook e server MCP da fonti utente e progetto, in modo che possano provenire solo da plugin o impostazioni gestite. Bloccare le skills interrompe anche la sincronizzazione dei [skills che i tuoi sviluppatori abilitano su claude.ai](/docs/it/skills#where-synced-skills-load) | `strictPluginOnlyCustomization` |

106| [Disable claude.ai sync](/docs/it/settings-reference#syncclaudeaiskills) | Impedire a Claude Code di caricare i [skills](/docs/it/skills#how-synced-skills-behave) e i [plugin](/docs/it/plugins/loading#synced-plugins) che i tuoi sviluppatori abilitano su claude.ai. Se disattivi Skills per la tua organizzazione su claude.ai, Claude Code interrompe la sincronizzazione di entrambi, e su v2.1.273 o successivo rimuove anche quelli già sincronizzati. Per interrompere uno dei due senza disattivare Skills, imposta la sua chiave su `false` nelle impostazioni gestite | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |106| [Disable claude.ai sync](/docs/it/settings-reference#syncclaudeaiskills) | Impedire a Claude Code di caricare i [skills](/docs/it/skills#how-synced-skills-behave) e i [plugin](/docs/it/plugins/loading#synced-plugins) che i tuoi sviluppatori abilitano su claude.ai. Se disattivi Skills per la tua organizzazione su claude.ai, Claude Code interrompe la sincronizzazione di entrambi, e su v2.1.273 o successivo rimuove anche quelli già sincronizzati. Per interrompere uno dei due senza disattivare Skills, imposta la sua chiave su `false` nelle impostazioni gestite | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

107| [Hook restrictions](/docs/it/settings-reference#allowmanagedhooksonly) | Limitare quali hook vengono eseguiti e limitare gli URL degli hook HTTP; consulta [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) per l'elenco completo degli effetti | `allowManagedHooksOnly`, `allowedHttpHookUrls` |107| [Hook restrictions](/docs/it/settings-reference#allowmanagedhooksonly) | Limitare quali hook vengono eseguiti e limitare gli URL degli hook HTTP; consulta [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) per l'elenco completo degli effetti | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

108| [Login enforcement](/docs/it/settings-reference#forceloginmethod) | Limitare l'accesso a un metodo specifico o a un'organizzazione Anthropic. La restrizione del metodo si applica all'estensione VS Code, Agent SDK, `claude setup-token` e `/install-github-app`, e la schermata di accesso interattivo del terminale, raggiunta da `/login` o dall'onboarding al primo avvio, preseleziona il metodo senza applicarlo; Claude Code verifica l'organizzazione per gli accessi dell'account claude.ai nel terminale, nell'estensione VS Code e in Agent SDK, e non la verifica per gli accessi a Claude Console o per l'accesso al [gateway](/docs/it/claude-apps-gateway). Prima della v2.1.212, solo gli accessi al terminale applicavano entrambe le chiavi. Quando impostato, le sessioni autenticate da `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` vengono bloccate all'avvio; le sessioni dei provider cloud non sono interessate | `forceLoginMethod`, `forceLoginOrgUUID` |108| [Login enforcement](/docs/it/settings-reference#forceloginmethod) | Limitare l'accesso a un metodo specifico o a un'organizzazione Anthropic. La restrizione del metodo si applica all'estensione VS Code, Agent SDK, `claude setup-token` e `/install-github-app`, e la schermata di accesso interattivo del terminale, raggiunta da `/login` o dall'onboarding al primo avvio, preseleziona il metodo senza applicarlo; Claude Code verifica l'organizzazione per gli accessi dell'account claude.ai nel terminale, nell'estensione VS Code e in Agent SDK, e non la verifica per gli accessi a Claude Console o per l'accesso al [gateway](/docs/it/claude-apps-gateway). Prima della v2.1.212, solo gli accessi al terminale applicavano entrambe le chiavi. Quando impostato, le sessioni autenticate da `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` vengono bloccate all'avvio; le sessioni dei provider cloud non sono interessate a meno che una di queste credenziali, o una chiave API salvata da un accesso precedente a Claude Console, non sia anche presente | `forceLoginMethod`, `forceLoginOrgUUID` |

109| [Disable agent view](/docs/it/agent-view#how-background-sessions-are-hosted) | Disattivare `claude agents`, `--bg`, `/background` e il supervisore on-demand | `disableAgentView` |109| [Disable agent view](/docs/it/agent-view#how-background-sessions-are-hosted) | Disattivare `claude agents`, `--bg`, `/background` e il supervisore on-demand | `disableAgentView` |

110| [Configure the corporate launcher](/docs/it/corporate-launcher) | Anteponi il [supervisore dell'agente di background](/docs/it/agent-view#how-background-sessions-are-hosted), i suoi worker e gli [altri processi di background coperti](/docs/it/corporate-launcher#what-the-launcher-covers) con un launcher aziendale richiesto invece di disattivare la visualizzazione dell'agente | `processWrapper` |110| [Configure the corporate launcher](/docs/it/corporate-launcher) | Anteponi il [supervisore dell'agente di background](/docs/it/agent-view#how-background-sessions-are-hosted), i suoi worker e gli [altri processi di background coperti](/docs/it/corporate-launcher#what-the-launcher-covers) con un launcher aziendale richiesto invece di disattivare la visualizzazione dell'agente | `processWrapper` |

111| [Model restrictions](/docs/it/model-config#restrict-model-selection) | `availableModels` filtra quali modelli appaiono nel selettore. L'aggiunta di `enforceAvailableModels` vincola anche il modello predefinito selezionato automaticamente. Consulta [surface coverage](/docs/it/model-config#surface-coverage) per come questa impostazione raggiunge la CLI, il web e l'IDE | `availableModels`, `enforceAvailableModels` |111| [Model restrictions](/docs/it/model-config#restrict-model-selection) | `availableModels` filtra quali modelli appaiono nel selettore. L'aggiunta di `enforceAvailableModels` vincola anche il modello predefinito selezionato automaticamente. Consulta [surface coverage](/docs/it/model-config#surface-coverage) per come questa impostazione raggiunge la CLI, il web e l'IDE | `availableModels`, `enforceAvailableModels` |

advisor.md +3 −2

Details

101| - | - | - |101| - | - | - |

103| Sonnet 4.6 | Fable, Opus, Sonnet | |103| Sonnet 4.6 | Fable, Opus, Sonnet | |

161 161

162* **Reviewed**: la riga conferma che l'advisor ha esaminato la conversazione. Quando l'advisor ha restituito una guida leggibile, premi `Ctrl+O` per leggerla.162* **Reviewed**: la riga conferma che l'advisor ha esaminato la conversazione. Quando l'advisor ha restituito una guida leggibile, premi `Ctrl+O` per leggerla.

163* **Declined**: la riga legge `Advisor declined to advise on this request`. Se l'advisor ha fornito un motivo, premi `Ctrl+O` per leggerlo.163* **Declined**: la riga legge `Advisor declined to advise on this request`. Se l'advisor ha fornito un motivo, premi `Ctrl+O` per leggerlo.

164* **Unavailable**: la chiamata dell'advisor non è riuscita, e la riga legge `Advisor unavailable (<error_code>)`, dove `<error_code>` è il codice restituito dalla chiamata.

164 165

165Claude generalmente segue la guida dell'advisor, ma si adatta quando le sue stesse prove contraddicono un'affermazione specifica: se un passaggio consigliato fallisce quando provato, o il contenuto del file contraddice il consiglio, Claude evidenzia il conflitto piuttosto che seguire la guida incondizionatamente.166Claude generalmente segue la guida dell'advisor, ma si adatta quando le sue stesse prove contraddicono un'affermazione specifica: se un passaggio consigliato fallisce quando provato, o il contenuto del file contraddice il consiglio, Claude evidenzia il conflitto piuttosto che seguire la guida incondizionatamente.

166 167

agent-sdk/custom-tools.md +13 −12

Details

34* **Descrizione:** cosa fa lo strumento. Claude legge questo per decidere quando chiamarlo.34* **Descrizione:** cosa fa lo strumento. Claude legge questo per decidere quando chiamarlo.

35* **Schema di input:** gli argomenti che Claude deve fornire. In TypeScript questo è sempre uno [schema Zod](https://zod.dev/), e gli `args` del handler sono tipizzati automaticamente da esso. In Python questo è un dict che mappa nomi a tipi, come `{"latitude": float}`, che l'SDK converte in JSON Schema per voi. Il decoratore Python accetta anche un dict completo di [JSON Schema](https://json-schema.org/understanding-json-schema/about) direttamente quando avete bisogno di enum, intervalli, campi opzionali o oggetti annidati.35* **Schema di input:** gli argomenti che Claude deve fornire. In TypeScript questo è sempre uno [schema Zod](https://zod.dev/), e gli `args` del handler sono tipizzati automaticamente da esso. In Python questo è un dict che mappa nomi a tipi, come `{"latitude": float}`, che l'SDK converte in JSON Schema per voi. Il decoratore Python accetta anche un dict completo di [JSON Schema](https://json-schema.org/understanding-json-schema/about) direttamente quando avete bisogno di enum, intervalli, campi opzionali o oggetti annidati.

36* **Handler:** la funzione asincrona che viene eseguita quando Claude chiama lo strumento. Riceve gli argomenti convalidati e deve restituire un oggetto con:36* **Handler:** la funzione asincrona che viene eseguita quando Claude chiama lo strumento. Riceve gli argomenti convalidati e deve restituire un oggetto con:

37 * `content` (obbligatorio): un array di blocchi di risultato, ciascuno con un `type` di `"text"`, `"image"`, `"audio"`, `"resource"` o `"resource_link"`. Vedere [Return images and resources](#return-images-and-resources) per i blocchi non testuali.37 * `content` (obbligatorio): un array di blocchi di risultato, ciascuno con un `type` di `"text"`, `"image"`, `"audio"`, `"resource"` o `"resource_link"`. Vedere [Restituire immagini e risorse](#return-images-and-resources) per i blocchi non testuali.

38 * `structuredContent` (opzionale): un oggetto JSON che contiene il risultato come dati leggibili da macchina, restituito insieme a `content`. Vedere [Return structured data](#return-structured-data).38 * `structuredContent` (opzionale): un oggetto JSON che contiene il risultato come dati leggibili da macchina, restituito insieme a `content`. Vedere [Restituire dati strutturati](#return-structured-data).

~~39 * `isError` (opzionale): impostare su `true` per segnalare un errore dello strumento in modo che Claude possa reagire. Vedere [Handle errors](#handle-errors).~~39 * `isError` (opzionale): impostare su `true` per segnalare un errore dello strumento in modo che Claude possa reagire. Vedere [Gestire gli errori](#handle-errors).

40 40

41Dopo aver definito uno strumento, avvolgetelo in un server con [`createSdkMcpServer`](/docs/it/agent-sdk/typescript#createsdkmcpserver) (TypeScript) o [`create_sdk_mcp_server`](/docs/it/agent-sdk/python#create_sdk_mcp_server) (Python). Il server viene eseguito in-process all'interno della vostra applicazione, non come processo separato.41Dopo aver definito uno strumento, avvolgetelo in un server con [`createSdkMcpServer`](/docs/it/agent-sdk/typescript#createsdkmcpserver) (TypeScript) o [`create_sdk_mcp_server`](/docs/it/agent-sdk/python#create_sdk_mcp_server) (Python). Il server viene eseguito in-process all'interno della vostra applicazione, non come processo separato.

42 42

44 Esempio di strumento meteo44 Esempio di strumento meteo

45</h3>45</h3>

46 46

47Questo esempio definisce uno strumento `get_temperature` e lo avvolge in un server MCP. Configura solo lo strumento; per passarlo a `query` e eseguirlo, vedere [Call a custom tool](#call-a-custom-tool) di seguito.47Questo esempio definisce uno strumento `get_temperature` e lo avvolge in un server MCP. Configura solo lo strumento; per passarlo a `query` e eseguirlo, vedere [Chiamare uno strumento personalizzato](#call-a-custom-tool) di seguito.

48 48

49<CodeGroup>49<CodeGroup>

50 ```python Python theme={null}50 ```python Python theme={null}

129Vedere il riferimento TypeScript [`tool()`](/docs/it/agent-sdk/typescript#tool) o il riferimento Python [`@tool`](/docs/it/agent-sdk/python#tool) per i dettagli completi dei parametri, inclusi i formati di input JSON Schema e la struttura del valore di ritorno.129Vedere il riferimento TypeScript [`tool()`](/docs/it/agent-sdk/typescript#tool) o il riferimento Python [`@tool`](/docs/it/agent-sdk/python#tool) per i dettagli completi dei parametri, inclusi i formati di input JSON Schema e la struttura del valore di ritorno.

130 130

131<Tip>131<Tip>

132 Per rendere un parametro opzionale: in TypeScript, aggiungete `.default()` al campo Zod. In Python, lo schema dict tratta ogni chiave come obbligatoria, quindi omettete il parametro dallo schema, menzionatelo nella stringa di descrizione e leggetelo con `args.get()` nel handler. Lo strumento [`get_precipitation_chance` di seguito](#add-more-tools) mostra entrambi i modelli.132 Per rendere un parametro opzionale: in TypeScript, aggiungete `.optional()` al campo Zod e applicate il valore predefinito nel handler. In Python, lo schema dict tratta ogni chiave come obbligatoria, quindi omettete il parametro dallo schema, menzionatelo nella stringa di descrizione e leggetelo con `args.get()` nel handler. Lo strumento [`get_precipitation_chance` di seguito](#add-more-tools) mostra entrambi i modelli.

133</Tip>133</Tip>

134 134

135<h3 id="call-a-custom-tool">135<h3 id="call-a-custom-tool">

248 .int()248 .int()

249 .min(1)249 .min(1)

250 .max(24)250 .max(24)

251 .default(12) // .default() makes the parameter optional251 .optional() // .optional() lets Claude omit the parameter

252 .describe("How many hours of forecast to return")252 .describe("How many hours of forecast to return")

253 },253 },

254 async (args) => {254 async (args) => {

255 const hours = args.hours ?? 12; // Apply the default in the handler

255 const response = await fetch(256 const response = await fetch(

256 `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&hourly=precipitation_probability&forecast_days=1`257 `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&hourly=precipitation_probability&forecast_days=1`

257 );258 );

258 const data: any = await response.json();259 const data: any = await response.json();

259 const chances = data.hourly.precipitation_probability.slice(0, args.hours);260 const chances = data.hourly.precipitation_probability.slice(0, hours);

260 261

261 return {262 return {

262 content: [{ type: "text", text: `Next ${args.hours} hours: ${chances.join("%, ")}%` }]263 content: [{ type: "text", text: `Next ${hours} hours: ${chances.join("%, ")}%` }]

263 };264 };

264 }265 }

265 );266 );

469 Immagini470 Immagini

470</h3>471</h3>

471 472

472Un blocco immagine contiene i byte dell'immagine inline, codificati in base64. Non esiste un campo URL. Per restituire un'immagine che si trova in un URL, recuperarla nel gestore, leggere i byte della risposta e codificarli in base64 prima di restituirli. Il risultato viene elaborato come input visivo.473Un blocco immagine contiene i byte dell'immagine inline, codificati in base64. Non esiste un campo URL. Per restituire un'immagine che si trova in un URL, recuperarla nel gestore, leggere i byte della risposta e codificarli in base64 prima di restituirli. Un'immagine PNG, JPEG, GIF o WebP raggiunge Claude come input visivo; un'immagine di qualsiasi altro tipo viene salvata su disco e Claude riceve il suo percorso di file come testo.

473 474

475| :- | :- | :- |476| :- | :- | :- |

538 Risorse539 Risorse

539</h3>540</h3>

540 541

541Un blocco risorsa incorpora un pezzo di contenuto identificato da un URI. L'URI è un'etichetta per Claude a cui fare riferimento; il contenuto effettivo si trova nel campo `text` o `blob` del blocco. Utilizzare questa opzione quando il tool produce qualcosa che ha senso affrontare per nome in seguito, come un file generato o un record da un sistema esterno.542Un blocco risorsa incorpora un pezzo di contenuto identificato da un URI. Il contenuto effettivo si trova nel campo `text` o `blob` del blocco. Utilizzare questa opzione quando il tool produce un file generato o un record da un sistema esterno.

542 543

544| :- | :- | :- |545| :- | :- | :- |

548| `resource.blob` | `string` | Il contenuto codificato in base64, se è binario. Solo TypeScript: l'SDK Python elimina le risorse binarie dal risultato del tool e registra un avviso |549| `resource.blob` | `string` | Il contenuto codificato in base64, se è binario. Solo TypeScript: l'SDK Python elimina le risorse binarie dal risultato del tool e registra un avviso |

550 551

551Questo esempio mostra un blocco risorsa restituito dall'interno di un gestore di tool. L'URI `file:///tmp/report.md` è un'etichetta a cui Claude può fare riferimento in seguito; l'SDK non legge da quel percorso.552Questo esempio mostra un blocco risorsa restituito dall'interno di un gestore di tool. L'SDK non legge dall'URI dell'esempio, `file:///tmp/report.md`.

552 553

553<CodeGroup>554<CodeGroup>

554 ```typescript TypeScript theme={null}555 ```typescript TypeScript theme={null}

572 {573 {

573 "type": "resource",574 "type": "resource",

574 "resource": {575 "resource": {

575 "uri": "file:///tmp/report.md", # Label for Claude to reference, not a path the SDK reads576 "uri": "file:///tmp/report.md", # Not a path the SDK reads

576 "mimeType": "text/markdown",577 "mimeType": "text/markdown",

577 "text": "# Report\n...", # The actual content, inline578 "text": "# Report\n...", # The actual content, inline

578 },579 },

agent-sdk/examples.md +4 −4

Details

6 6

7> Trova un progetto Agent SDK completo e eseguibile o una ricetta guidata nel Claude Cookbook che corrisponda a ciò che desideri costruire.7> Trova un progetto Agent SDK completo e eseguibile o una ricetta guidata nel Claude Cookbook che corrisponda a ciò che desideri costruire.

8 8

9Questa pagina ti indirizza verso progetti Agent SDK completi ed eseguibili e ricette guidate del Claude Cookbook. Le applicazioni TypeScript si trovano nel repository [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos), e le ricette Python si trovano nel [Claude Cookbook](https://platform.claude.com/cookbook).9Questa pagina ti indirizza verso progetti Agent SDK completi ed eseguibili e ricette guidate del Claude Cookbook. Le applicazioni si trovano nel repository [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos), e le ricette Python si trovano nel [Claude Cookbook](https://platform.claude.com/cookbook).

10 10

11<h2 id="run-a-minimal-agent-first">11<h2 id="run-a-minimal-agent-first">

12 Esegui prima un agente minimalista12 Esegui prima un agente minimalista

18 18

19* [Hello World](https://github.com/anthropics/claude-agent-sdk-demos/tree/main/hello-world): un progetto TypeScript minimalista da clonare quando desideri iniziare dal codice del repository19* [Hello World](https://github.com/anthropics/claude-agent-sdk-demos/tree/main/hello-world): un progetto TypeScript minimalista da clonare quando desideri iniziare dal codice del repository

20 20

~~21<h2 id="explore-a-typescript-application">~~21<h2 id="explore-a-demo-application">

~~22 Esplora un'applicazione TypeScript~~22 Esplora un'applicazione demo

23</h2>23</h2>

24 24

25Le applicazioni TypeScript in [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) sono demo per lo sviluppo locale, da un client di posta elettronica a un sistema di ricerca multi-agente. Clona la demo la cui struttura corrisponde a ciò che stai costruendo.25Le applicazioni in [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) sono demo per lo sviluppo locale, da un client di posta elettronica a un sistema di ricerca multi-agente. Clona la demo la cui struttura corrisponde a ciò che stai costruendo.

26 26

27<h2 id="work-through-a-python-recipe">27<h2 id="work-through-a-python-recipe">

28 Lavora attraverso una ricetta Python28 Lavora attraverso una ricetta Python

agent-sdk/file-checkpointing.md +1 −1

Details

247 ```247 ```

248 </CodeGroup>248 </CodeGroup>

249 249

250 Se acquisisci l'ID di sessione e l'ID di checkpoint, puoi anche ripristinare dalla CLI. Questo comando richiede l'eseguibile `claude`, che proviene da [installazione di Claude Code](/docs/it/setup) e non è installato dal pacchetto SDK. L'SDK abilita il checkpointing per te, ma quando esegui `claude -p` direttamente devi impostare la variabile di ambiente `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING`:250 Se acquisisci l'ID di sessione e l'ID di checkpoint, puoi anche ripristinare dalla CLI. Questo comando richiede l'eseguibile `claude`, che proviene da [installazione di Claude Code](/docs/it/setup). L'SDK abilita il checkpointing per te, ma quando esegui `claude -p` direttamente devi impostare la variabile di ambiente `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING`:

251 251

252 ```bash theme={null}252 ```bash theme={null}

253 CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>253 CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>

agent-sdk/hosting.md +6 −1

Details

127 127

128I carichi di lavoro di esempio includono un agente di posta che triage e risponde alla posta in arrivo, un generatore di siti che ospita un sito modificabile per utente attraverso le porte del container e un chatbot che gestisce il traffico continuo da una piattaforma come Slack.128I carichi di lavoro di esempio includono un agente di posta che triage e risponde alla posta in arrivo, un generatore di siti che ospita un sito modificabile per utente attraverso le porte del container e un chatbot che gestisce il traffico continuo da una piattaforma come Slack.

129 129

130Il container espone un endpoint HTTP o WebSocket e mappa ogni sessione attiva a una query di lunga durata e al sottoprocesso dietro di essa. In TypeScript, utilizzare [`streamInput()`](/docs/it/agent-sdk/typescript#query-object) per aggiungere turni a una sessione attiva e [`startup()`](/docs/it/agent-sdk/typescript#startup) per pre-riscaldare i sottoprocessi prima del traffico in arrivo. In Python, utilizzare [`ClaudeSDKClient`](/docs/it/agent-sdk/python#claudesdkclient) per mantenere una sessione aperta tra i turni. Dimensionare il container in modo che possa contenere il numero massimo di sessioni simultanee in memoria.130Il container espone un endpoint HTTP o WebSocket e mappa ogni sessione attiva a una query di lunga durata e al sottoprocesso dietro di essa. Le chiamate che mantengono le sessioni aperte e attive differiscono tra gli SDK:

131

132* **TypeScript**: utilizzare [`streamInput()`](/docs/it/agent-sdk/typescript#query-object) per aggiungere turni a una sessione attiva. Chiamare [`startup()`](/docs/it/agent-sdk/typescript#startup) per pre-riscaldare i sottoprocessi prima del traffico in arrivo. Se non si conosce la directory di lavoro di una sessione fino all'arrivo della sua prima richiesta, pre-riscaldare con [`prewarm()`](/docs/it/agent-sdk/typescript#prewarm) invece.

133* **Python**: utilizzare [`ClaudeSDKClient`](/docs/it/agent-sdk/python#claudesdkclient) per mantenere una sessione aperta tra i turni.

134

135Dimensionare il container in modo che possa contenere il numero massimo di sessioni simultanee in memoria.

131 136

132<h3 id="hybrid-sessions">137<h3 id="hybrid-sessions">

133 Sessioni ibride138 Sessioni ibride

agent-sdk/mcp.md +1 −1

Details

162| :- | :- | :- |162| :- | :- | :- |

163| server stdio, o server HTTP/SSE senza un elenco di strumenti memorizzato nella cache | Sì, fino a quando non si connette | [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita; la connessione non riesce a quella scadenza |163| server stdio, o server HTTP/SSE senza un elenco di strumenti memorizzato nella cache | Sì, fino a quando non si connette | [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita; la connessione non riesce a quella scadenza |

164| Server remoto con un elenco di strumenti memorizzato nella cache, salvato da Claude Code da una connessione precedente | No; gli strumenti memorizzati nella cache sono disponibili dal primo turno | Nessuno; si connette alla sua prima chiamata di strumento, e quella connessione differita ha il suo proprio timeout |164| Server remoto con un elenco di strumenti memorizzato nella cache, salvato da Claude Code da una connessione precedente | No; gli strumenti memorizzati nella cache sono disponibili dal primo turno | Nessuno; si connette alla sua prima chiamata di strumento, e quella connessione differita ha il suo proprio timeout |

165| Server [SDK](#sdk-mcp-servers) in-process | Sì, fino a quando non si connette e non elenca i suoi strumenti | Nessuno; le richieste di connessione e di elenco degli strumenti hanno ciascuna il loro proprio timeout |165| Server [SDK](#sdk-mcp-servers) in-process | Sì, fino a quando non si connette e non elenca i suoi strumenti | [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita, per tentativo di connessione; la connessione non riesce a quella scadenza |

166 166

167I server caricati da [file di configurazione](#from-a-config-file) come `.mcp.json` o da plugin comunemente mostrano `pending` nel messaggio init. Quando `options.mcpServers` contiene un server stdio, HTTP o SSE, il primo turno attende anche questi server in sospeso, fino a `MCP_TIMEOUT`. Quando `options.mcpServers` è vuoto o contiene solo server SDK, il primo turno attende invece fino a 2 secondi:167I server caricati da [file di configurazione](#from-a-config-file) come `.mcp.json` o da plugin comunemente mostrano `pending` nel messaggio init. Quando `options.mcpServers` contiene un server stdio, HTTP o SSE, il primo turno attende anche questi server in sospeso, fino a `MCP_TIMEOUT`. Quando `options.mcpServers` è vuoto o contiene solo server SDK, il primo turno attende invece fino a 2 secondi:

168 168

agent-sdk/modifying-system-prompts.md +123 −8

Details

14 14

15Un system prompt è l'insieme iniziale di istruzioni che modella il comportamento di Claude durante una conversazione. Agent SDK ha tre punti di partenza per esso:15Un system prompt è l'insieme iniziale di istruzioni che modella il comportamento di Claude durante una conversazione. Agent SDK ha tre punti di partenza per esso:

16 16

17* **Default minimalista**: quando non impostate `systemPrompt` in TypeScript o `system_prompt` in Python, l'SDK utilizza un prompt minimalista che copre la chiamata degli strumenti ma omette il resto del contenuto del preset `claude_code`, incluse le istruzioni di sicurezza e protezione e il contesto sulla directory di lavoro e sull'ambiente. Questo differisce da `claude -p`, che utilizza il system prompt di Claude Code per impostazione predefinita. Se state migrando dalla CLI e desiderate un comportamento corrispondente, impostate il preset `claude_code`.17* **Default minimalista**: quando non impostate `systemPrompt` in TypeScript o `system_prompt` in Python, l'SDK utilizza un prompt minimalista che copre la chiamata degli strumenti ma omette il resto del contenuto del preset `claude_code`, incluse le istruzioni di sicurezza e protezione. Questo differisce da `claude -p`, che utilizza il system prompt di Claude Code per impostazione predefinita. Se state migrando dalla CLI e desiderate un comportamento corrispondente, impostate il preset `claude_code`.

18* **Preset `claude_code`**: il system prompt che utilizza la CLI di Claude Code, con istruzioni di utilizzo degli strumenti, istruzioni di sicurezza e protezione, e contesto sulla directory di lavoro e sull'ambiente. Impostate `systemPrompt: { type: "preset", preset: "claude_code" }` in TypeScript o `system_prompt={"type": "preset", "preset": "claude_code"}` in Python, facoltativamente con `append` per aggiungere le vostre istruzioni alla fine.18* **Preset `claude_code`**: il system prompt che utilizza la CLI di Claude Code, con istruzioni di utilizzo degli strumenti e istruzioni di sicurezza e protezione. Impostate `systemPrompt: { type: "preset", preset: "claude_code" }` in TypeScript o `system_prompt={"type": "preset", "preset": "claude_code"}` in Python, facoltativamente con `append` per aggiungere le vostre istruzioni alla fine.

19* **Stringa personalizzata**: un prompt che scrivete voi stessi. L'SDK invia solo ciò che fornite.19* **Stringa personalizzata**: un prompt che scrivete voi stessi. L'SDK invia solo ciò che fornite.

20 20

21<h3 id="decide-on-a-starting-point">21<h3 id="decide-on-a-starting-point">

26 26

28| :- | :- | :- |28| :- | :- | :- |

29| Uno strumento di codifica simile a CLI o IDE dove un umano osserva e guida, e i default di Claude Code sono quello che desiderate | Preset `claude_code` | Il prompt di Claude Code, inclusa la guida degli strumenti, le regole di sicurezza, e il contesto dell'ambiente |29| Uno strumento di codifica simile a CLI o IDE dove un umano osserva e guida, e i default di Claude Code sono quello che desiderate | Preset `claude_code` | Il prompt di Claude Code, inclusa la guida degli strumenti e le regole di sicurezza |

30| Lo stesso tipo di strumento, più regole specifiche del prodotto come standard di codifica, formato di output o contesto di dominio | Preset `claude_code` con `append` | Tutto quanto sopra, con le vostre istruzioni aggiunte dopo il preset. Nulla viene rimosso, quindi questa è la personalizzazione a rischio più basso |30| Lo stesso tipo di strumento, più regole specifiche del prodotto come standard di codifica, formato di output o contesto di dominio | Preset `claude_code` con `append` | Tutto quanto sopra, con le vostre istruzioni aggiunte dopo il preset. Nulla viene rimosso, quindi questa è la personalizzazione a rischio più basso |

31| Un agente con una superficie diversa, un'identità diversa o un modello di permessi diverso, o un agente non di codifica | Stringa di prompt personalizzata | Solo quello che scrivete. Siete responsabili della sostituzione della guida degli strumenti e delle istruzioni di sicurezza di cui il vostro agente ha ancora bisogno |31| Un agente con una superficie diversa, un'identità diversa o un modello di permessi diverso, o un agente non di codifica | Stringa di prompt personalizzata | Solo quello che scrivete. Siete responsabili della sostituzione della guida degli strumenti e delle istruzioni di sicurezza di cui il vostro agente ha ancora bisogno |

32| Un ciclo di chiamata degli strumenti sottile senza persona dell'agente, dove fornite tutto il comportamento nel prompt dell'utente | Nessuna opzione `systemPrompt` | Il default minimalista: supporto per la chiamata degli strumenti e nient'altro |32| Un ciclo di chiamata degli strumenti sottile senza persona dell'agente, dove fornite tutto il comportamento nel prompt dell'utente | Nessuna opzione `systemPrompt` | Il default minimalista: supporto per la chiamata degli strumenti e nient'altro |

225 Migliorare il prompt caching tra utenti e macchine225 Migliorare il prompt caching tra utenti e macchine

226</h4>226</h4>

227 227

228Per impostazione predefinita, due sessioni che utilizzano lo stesso preset `claude_code` e lo stesso testo `append` non possono comunque condividere una voce della cache del prompt se vengono eseguite da directory di lavoro diverse. Questo perché il preset incorpora il contesto per sessione nel system prompt prima del vostro testo `append`: la directory di lavoro, se è un repository git, la piattaforma, la shell attiva, la versione del sistema operativo, e i percorsi della memoria automatica. Qualsiasi differenza in quel contesto produce un system prompt diverso e un cache miss. Il contenuto di CLAUDE.md non influisce sulla cache del system prompt perché l'SDK lo inietta nella conversazione, non nel system prompt.228Per impostazione predefinita, due sessioni che utilizzano lo stesso preset `claude_code` e lo stesso testo `append` non possono comunque condividere una voce della cache del prompt quando le loro posizioni di memoria automatica differiscono. Il preset incorpora quella posizione nel system prompt prima del vostro testo `append`. La posizione predefinita è un percorso assoluto sotto `~/.claude/projects/` denominato in base al percorso del repository su disco, quindi differisce tra utenti, macchine e checkout.

229 229

230Per rendere il system prompt identico tra le sessioni, impostate `excludeDynamicSections: true` in TypeScript o `"exclude_dynamic_sections": True` in Python. Il contesto per sessione si sposta nel primo messaggio dell'utente, lasciando solo il preset statico e il vostro testo `append` nel system prompt in modo che le configurazioni identiche condividano una voce della cache tra utenti e macchine.230Il contenuto di CLAUDE.md e i dettagli dell'ambiente come la directory di lavoro, la piattaforma, la shell e la versione del sistema operativo non influiscono sulla cache del system prompt, perché Claude Code li fornisce nella conversazione, non nel system prompt.

231

232Per rendere il system prompt identico tra le sessioni, impostate `excludeDynamicSections: true` in TypeScript o `"exclude_dynamic_sections": True` in Python. Il contesto per utente si sposta nel primo messaggio dell'utente, lasciando solo il preset statico e il vostro testo `append` nel system prompt in modo che le configurazioni identiche condividano una voce della cache tra utenti e macchine.

231 233

232<Note>234<Note>

233 `excludeDynamicSections` richiede `@anthropic-ai/claude-agent-sdk` v0.2.98 o successivo, o `claude-agent-sdk` v0.1.58 o successivo per Python. Impostatelo solo sulla forma dell'oggetto preset. L'SDK lo ignora quando passate un prompt personalizzato invece del preset; per mantenere le istruzioni di un prompt personalizzato memorizzate nella cache nell'SDK TypeScript, vedi [Memorizzare nella cache la parte statica di un prompt personalizzato](#cache-the-static-part-of-a-custom-prompt).235 `excludeDynamicSections` richiede `@anthropic-ai/claude-agent-sdk` v0.2.98 o successivo, o `claude-agent-sdk` v0.1.58 o successivo per Python. Impostatelo solo sulla forma dell'oggetto preset. L'SDK lo ignora quando passate un prompt personalizzato invece del preset; per mantenere le istruzioni di un prompt personalizzato memorizzate nella cache nell'SDK TypeScript, vedi [Memorizzare nella cache la parte statica di un prompt personalizzato](#cache-the-static-part-of-a-custom-prompt).

234</Note>236</Note>

235 237

236L'esempio seguente abbina un blocco `append` condiviso con `excludeDynamicSections` in modo che una flotta di agenti in esecuzione da directory diverse possa riutilizzare lo stesso system prompt memorizzato nella cache:238L'esempio seguente abbina un blocco `append` condiviso con `excludeDynamicSections` in modo che una flotta di agenti possa riutilizzare lo stesso system prompt memorizzato nella cache:

237 239

238<CodeGroup>240<CodeGroup>

239 ```typescript TypeScript theme={null}241 ```typescript TypeScript theme={null}

279 ```281 ```

280</CodeGroup>282</CodeGroup>

281 283

282**Compromessi:** la directory di lavoro, il flag del repository git, la piattaforma, la shell attiva, la versione del sistema operativo, e i percorsi della memoria automatica raggiungono comunque Claude, ma come parte del primo messaggio dell'utente piuttosto che del system prompt. Le istruzioni nel messaggio dell'utente hanno un peso leggermente inferiore rispetto allo stesso testo nel system prompt, quindi Claude potrebbe fare affidamento su di esse meno fortemente quando ragiona sulla directory corrente o sui percorsi della memoria automatica. Abilitate questa opzione quando il riutilizzo della cache tra sessioni è più importante che il contesto dell'ambiente massimamente autorevole.284**Compromessi:** il testo che si sposta fuori dal system prompt raggiunge comunque Claude, ma in un messaggio dell'utente. Quel testo è almeno la posizione della directory di memoria automatica, e spesso l'intera sezione di memoria automatica. Le istruzioni in un messaggio dell'utente hanno un peso leggermente inferiore rispetto allo stesso testo nel system prompt, quindi Claude potrebbe seguire la sua guida di memoria automatica meno coerentemente. Abilitate questa opzione quando il riutilizzo della cache tra sessioni è più importante che quello.

283 285

284Per il flag equivalente in modalità CLI non interattiva, vedi [`--exclude-dynamic-system-prompt-sections`](/docs/it/cli-reference).286Per il flag equivalente in modalità CLI non interattiva, vedi [`--exclude-dynamic-system-prompt-sections`](/docs/it/cli-reference).

285 287

418 420

419La registrazione di un `append` o prompt personalizzato per impostazione predefinita richiede Claude Code v2.1.265 o successivo, che l'Agent SDK TypeScript raggruppa dalla v0.3.265 e l'Agent SDK Python dalla v0.2.153. Prima di Claude Code v2.1.268, le sessioni che non [recuperano i flag delle funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), incluse le sessioni su Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry, ricostruivano il prompt su ogni richiesta e `snapshot` non aveva effetto.421La registrazione di un `append` o prompt personalizzato per impostazione predefinita richiede Claude Code v2.1.265 o successivo, che l'Agent SDK TypeScript raggruppa dalla v0.3.265 e l'Agent SDK Python dalla v0.2.153. Prima di Claude Code v2.1.268, le sessioni che non [recuperano i flag delle funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), incluse le sessioni su Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry, ricostruivano il prompt su ogni richiesta e `snapshot` non aveva effetto.

420 422

423<h2 id="context-claude-code-adds-outside-the-system-prompt">

424 Contesto che Claude Code aggiunge al di fuori del prompt di sistema

425</h2>

426

427I promemoria di sistema sono messaggi che Claude Code aggiunge alla conversazione durante una sessione per fornire a Claude il contesto, come il contenuto dei vostri file CLAUDE.md o una nota che un file è cambiato su disco. Claude Code li invia nella conversazione, non nel prompt di sistema, quindi raggiungono Claude indipendentemente dal fatto che utilizziate il preset `claude_code` o passiate una vostra stringa come `systemPrompt`.

428

429Questa sezione copre i [promemoria più probabili a cambiare il comportamento del vostro agente](#reminders-claude-code-adds-to-the-conversation), come [disattivare quelli che il vostro agente sostituisce](#turn-off-the-context-your-agent-replaces), e come [vedere cosa Claude ha ricevuto](#see-what-claude-received) in una richiesta specifica.

430

431<h3 id="reminders-claude-code-adds-to-the-conversation">

432 Promemoria che Claude Code aggiunge alla conversazione

433</h3>

434

435I promemoria di sistema sono testi che Claude Code aggiunge alla conversazione insieme ai prompt che il vostro codice invia. I seguenti promemoria sono quelli più probabili a cambiare il comportamento del vostro agente:

436

437* **Istruzioni del progetto**: i file CLAUDE.md che la vostra opzione [`settingSources`](#claude-md-files-for-project-level-instructions) carica

438* **Istruzioni di stile di output**: le istruzioni dello [stile di output](#output-styles-for-persistent-configurations) attivo, nella conversazione principale

439* **Attribuzione di commit e pull request**: il trailer `Co-Authored-By` e il footer della pull request dall'impostazione [`attribution`](/docs/it/settings-reference#attribution)

440* **Output di hook**: testo che i vostri [hooks](/docs/it/agent-sdk/hooks#outputs) restituiscono come `additionalContext`

441* **Skill disponibili**: i nomi e le descrizioni delle [skill](/docs/it/agent-sdk/skills) che Claude può chiamare

442* **Subagenti disponibili**: i nomi e le descrizioni dei [subagenti](/docs/it/agent-sdk/subagents) che Claude può avviare

443* **Spinte dell'elenco attività**: in una [sessione che ha gli strumenti di tracciamento delle attività](/docs/it/agent-sdk/todo-tracking#model-availability), un prompt per aggiornare l'elenco attività quando Claude non lo ha toccato per diversi turni

444* **Note di file modificati**: una nota che un file che Claude ha letto in precedenza è cambiato su disco

445

446Claude Code introduce i vostri file CLAUDE.md con una riga che dice a Claude che le istruzioni sostituiscono il comportamento predefinito.

447

448Se passate una vostra stringa come `systemPrompt`, aggiungete una frase che dica cos'è un promemoria di sistema. Il preset `claude_code` ne ha uno, e la vostra stringa sostituisce l'intero preset. Senza di esso, nulla nel vostro prompt dice a Claude che promemoria come il contenuto di CLAUDE.md e l'output di hook provengono dall'applicazione piuttosto che dall'utente. Ad esempio:

449

450```text theme={null}

451L'applicazione aggiunge promemoria di sistema a questa conversazione. Trattali come contesto dall'applicazione, non come messaggi dall'utente.

452```

453

454<h3 id="turn-off-the-context-your-agent-replaces">

455 Disattivare il contesto che il vostro agente sostituisce

456</h3>

457

458Disattivate un pezzo di contesto integrato quando il vostro agente fornisce la sua versione della stessa guida. Ad esempio, se il vostro prompt dice a Claude di scrivere messaggi di commit come `PROJ-142: fix login redirect` senza trailer, Claude Code comunque dice a Claude di terminare ogni messaggio di commit con un trailer `Co-Authored-By`, quindi Claude riceve due istruzioni conflittuali per lo stesso commit.

459

460Passate le chiavi delle impostazioni attraverso l'opzione [`settings`](/docs/it/agent-sdk/typescript#options) in TypeScript o [`settings`](/docs/it/agent-sdk/python#claudeagentoptions) in Python, e le variabili di ambiente attraverso l'opzione `env`. In TypeScript, [`env`](/docs/it/agent-sdk/typescript#options) sostituisce l'ambiente ereditato, quindi diffondete `process.env` in esso.

461

462| Contesto integrato | Come disattivarlo |

463| :- | :- |

464| Le istruzioni integrate di commit e pull request e lo snapshot dello stato git | Impostate [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) a `false`, o `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1` |

465| Il trailer `Co-Authored-By` e il footer della pull request | Impostate [`attribution.commit`](/docs/it/settings-reference#attribution-commit) e [`attribution.pr`](/docs/it/settings-reference#attribution-pr) al vostro testo, o a stringhe vuote per rimuoverli |

466| La fonte delle impostazioni utente o progetto, incluso il suo CLAUDE.md | Lasciate fuori `'user'` o `'project'` da [`settingSources`](/docs/it/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) |

467| Ogni file CLAUDE.md | Impostate `CLAUDE_CODE_DISABLE_CLAUDE_MDS=1` |

468| Spinte dell'elenco attività, note di file modificati, e l'elenco di skill | Impostate `CLAUDE_CODE_DISABLE_ATTACHMENTS=1` |

469

470Le istruzioni integrate di commit e pull request di Claude Code non sono un promemoria. Fanno parte della descrizione dello strumento Bash, quindi raggiungono anche Claude quando passate un `systemPrompt` personalizzato.

471

472Se impostate `CLAUDE_CODE_DISABLE_ATTACHMENTS`, Claude Code invia anche le menzioni di file `@` come testo semplice invece di espanderle nel contenuto del file. L'elenco dei subagenti disponibili e le notifiche di attività in background arrivano comunque.

473

474L'esempio seguente è per un agente che porta le sue regole di commit in `append`. Imposta entrambe le chiavi `attribution` a stringhe vuote per rimuovere il trailer e il footer, e disattiva `includeGitInstructions` in modo che le istruzioni del flusso di lavoro di commit di Claude Code non competano con le vostre:

475

476<CodeGroup>

477 ```typescript TypeScript theme={null}

478 import { query } from "@anthropic-ai/claude-agent-sdk";

479

480 for await (const message of query({

481 prompt: "Commit the staged changes for ticket PROJ-142",

482 options: {

483 systemPrompt: {

484 type: "preset",

485 preset: "claude_code",

486 append: "Write commit messages as: <ticket id>: <summary>. Add no trailers."

487 },

488 settings: {

489 includeGitInstructions: false,

490 attribution: { commit: "", pr: "" }

491 },

492 allowedTools: ["Bash(git *)"]

493 }

494 })) {

495 if (message.type === "result") console.log(message.subtype);

496 }

497 ```

498

499 ```python Python theme={null}

500 import asyncio

501 from claude_agent_sdk import query, ClaudeAgentOptions

502

503

504 async def main():

505 async for message in query(

506 prompt="Commit the staged changes for ticket PROJ-142",

507 options=ClaudeAgentOptions(

508 system_prompt={

509 "type": "preset",

510 "preset": "claude_code",

511 "append": "Write commit messages as: <ticket id>: <summary>. Add no trailers.",

512 },

513 settings='{"includeGitInstructions": false, "attribution": {"commit": "", "pr": ""}}',

514 allowed_tools=["Bash(git *)"],

515 ),

516 ):

517 print(message)

518

519

520 asyncio.run(main())

521 ```

522</CodeGroup>

523

524Per confermare il cambiamento, eseguite l'esempio in un repository con modifiche in staging e controllate il nuovo commit con `git log -1`. Il messaggio termina senza un trailer `Co-Authored-By`.

525

526<h3 id="see-what-claude-received">

527 Vedere cosa Claude ha ricevuto

528</h3>

529

530Il flusso di messaggi SDK non include promemoria di sistema, quindi leggere i messaggi che il vostro codice riceve non vi mostrerà cosa Claude ha visto. Per vederli, registrate le richieste che Claude Code invia:

531

532* **Registrazione delle richieste raw**: impostate [`OTEL_LOG_RAW_API_BODIES`](/docs/it/monitoring-usage#api-request-body-event) a `file:<dir>`. Claude Code scrive ogni corpo della richiesta in quella directory.

533* **Un gateway che controllate**: puntate [`ANTHROPIC_BASE_URL`](/docs/it/llm-gateway) a un proxy che registra i corpi delle richieste.

534

535In una richiesta registrata, cercate nell'array `messages`. Un promemoria appare all'interno di un messaggio utente avvolto in tag `<system-reminder>` o, su alcuni modelli, come un messaggio separato con il ruolo `system`.

536

421<h2 id="compare-the-four-approaches">537<h2 id="compare-the-four-approaches">

422 Confronto dei quattro approcci538 Confronto dei quattro approcci

423</h2>539</h2>

agent-sdk/observability.md +2 −2

Details

250| Variabile | Aggiunge |250| Variabile | Aggiunge |

251| - | - |251| - | - |

252| `OTEL_LOG_USER_PROMPTS=1` | Testo del prompt su eventi `claude_code.user_prompt` e sullo span `claude_code.interaction` |252| `OTEL_LOG_USER_PROMPTS=1` | Testo del prompt su eventi `claude_code.user_prompt` e sullo span `claude_code.interaction` |

253| `OTEL_LOG_TOOL_DETAILS=1` | Argomenti di input dello strumento (percorsi di file, comandi shell, pattern di ricerca) su eventi `claude_code.tool_result` |253| `OTEL_LOG_TOOL_DETAILS=1` | Argomenti di input dello strumento come percorsi di file, comandi shell e pattern di ricerca su eventi `claude_code.tool_result`, e nomi reali di agente, skill, plugin e server MCP sulle [metriche di costo e token](/docs/it/monitoring-usage#cost-counter) |

254| `OTEL_LOG_TOOL_CONTENT=1` | Un evento span [`tool.output`](/docs/it/monitoring-usage#tool-output-span-event) su `claude_code.tool` con contenuti di file e output Bash, troncato a 60 KB per impostazione predefinita, configurabile tramite `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, che richiede Claude Code v2.1.214 o successivo. Richiede che il [tracing](#read-agent-traces) sia abilitato. Gli attributi dello span trasportano il contenuto dello strumento sotto [i loro propri gate](/docs/it/monitoring-usage#new-context-gates) |254| `OTEL_LOG_TOOL_CONTENT=1` | Un evento span [`tool.output`](/docs/it/monitoring-usage#tool-output-span-event) su `claude_code.tool` con contenuti di file, output Bash e ciò che restituiscono gli strumenti MCP, WebFetch e WebSearch, troncato a 60 KB per impostazione predefinita, configurabile tramite `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, che richiede Claude Code v2.1.214 o successivo. I risultati degli strumenti MCP, WebFetch e WebSearch richiedono Claude Code v2.1.283 o successivo. Richiede che il [tracing](#read-agent-traces) sia abilitato. Gli attributi dello span trasportano il contenuto dello strumento sotto [i loro propri gate](/docs/it/monitoring-usage#new-context-gates) |

255| `OTEL_LOG_RAW_API_BODIES` | Richiesta e risposta JSON complete dell'API Anthropic Messages come eventi di log `claude_code.api_request_body` e `claude_code.api_response_body`. Imposta su `1` per corpi inline troncati a 60 KB per impostazione predefinita, o `file:<dir>` per corpi non troncati su disco con un percorso `body_ref` nell'evento. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di troncamento inline, e richiede Claude Code v2.1.214 o successivo. I corpi includono l'intera cronologia della conversazione e hanno il contenuto del pensiero esteso oscurato. L'abilitazione di questo implica il consenso a tutto ciò che le tre variabili sopra rivelerebbero |255| `OTEL_LOG_RAW_API_BODIES` | Richiesta e risposta JSON complete dell'API Anthropic Messages come eventi di log `claude_code.api_request_body` e `claude_code.api_response_body`. Imposta su `1` per corpi inline troncati a 60 KB per impostazione predefinita, o `file:<dir>` per corpi non troncati su disco con un percorso `body_ref` nell'evento. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di troncamento inline, e richiede Claude Code v2.1.214 o successivo. I corpi includono l'intera cronologia della conversazione e hanno il contenuto del pensiero esteso oscurato. L'abilitazione di questo implica il consenso a tutto ciò che le tre variabili sopra rivelerebbero |

256 256

257Lascia questi non impostati a meno che la tua pipeline di osservabilità non sia approvata per archiviare i dati che il tuo agente gestisce. Vedi [Security and privacy](/docs/it/monitoring-usage#security-and-privacy) nel riferimento Monitoring per l'elenco completo degli attributi e il comportamento di oscuramento.257Lascia questi non impostati a meno che la tua pipeline di osservabilità non sia approvata per archiviare i dati che il tuo agente gestisce. Vedi [Security and privacy](/docs/it/monitoring-usage#security-and-privacy) nel riferimento Monitoring per l'elenco completo degli attributi e il comportamento di oscuramento.

agent-sdk/permissions.md +6 −2

Details

41 </Step>41 </Step>

42 42

43 <Step title="Regole di autorizzazione">43 <Step title="Regole di autorizzazione">

44 Controllare le regole `allow` (da `allowed_tools` e settings.json). Se una regola corrisponde, lo strumento viene approvato. Una chiamata che lo strumento approva da solo viene risolta in questo passaggio, senza alcuna regola necessaria: ad esempio una lettura di file all'interno delle vostre directory di lavoro o un [comando Bash di sola lettura](/docs/it/permissions#read-only-commands). Le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](/docs/it/permission-modes#critical-paths) non vengono mai approvate da una regola di autorizzazione: raggiungono il vostro callback nelle modalità che richiedono, vanno al [classificatore](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) in modalità `auto` su Claude Code v2.1.218 o successivo, e vengono negate in modalità `dontAsk`.44 Controllare le regole `allow` (da `allowed_tools` e settings.json). Se una regola corrisponde, lo strumento viene approvato. Una chiamata che lo strumento approva da solo viene risolta in questo passaggio, senza alcuna regola necessaria: ad esempio una lettura di file all'interno delle vostre directory di lavoro o un [comando Bash di sola lettura](/docs/it/permissions#read-only-commands).

46 Le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](/docs/it/permission-modes#critical-paths) non vengono mai approvate da una regola di autorizzazione. Se raggiungono il vostro callback dipende dalla modalità di autorizzazione: in una sessione Agent SDK in modalità `auto`, ad esempio, Claude Code le nega per impostazione predefinita senza chiamarlo. La tabella della modalità [Percorsi critici](/docs/it/permission-modes#critical-paths) elenca cosa fa ogni modalità con loro.

45 </Step>47 </Step>

46 48

47 <Step title="Callback canUseTool">49 <Step title="Callback canUseTool">

89Utilizzate `//path` per un percorso del filesystem assoluto: una regola di negazione di `Edit(//secrets/**)` blocca le scritture ovunque sotto `/secrets` su disco. Con una singola barra iniziale, `Edit(/secrets/**)` si ancora alla fonte della regola. Per le regole passate attraverso `allowed_tools` o `disallowed_tools`, ciò significa la directory di lavoro della sessione, quindi la regola non blocca `/secrets` su disco. Consultate [Regole Read e Edit](/docs/it/permissions#read-and-edit) per i quattro moduli di ancoraggio e come le regole dai file di impostazioni si risolvono.91Utilizzate `//path` per un percorso del filesystem assoluto: una regola di negazione di `Edit(//secrets/**)` blocca le scritture ovunque sotto `/secrets` su disco. Con una singola barra iniziale, `Edit(/secrets/**)` si ancora alla fonte della regola. Per le regole passate attraverso `allowed_tools` o `disallowed_tools`, ciò significa la directory di lavoro della sessione, quindi la regola non blocca `/secrets` su disco. Consultate [Regole Read e Edit](/docs/it/permissions#read-and-edit) per i quattro moduli di ancoraggio e come le regole dai file di impostazioni si risolvono.

90 92

91<Warning>93<Warning>

92 **Gli strumenti approvati automaticamente non raggiungono mai `canUseTool`.** Una chiamata a uno strumento approvata in qualsiasi fase precedente, da `acceptEdits` o `bypassPermissions`, o da una regola di consentimento, salta il callback `canUseTool`, quindi i controlli di autorizzazione che inserite lì vengono silenziosamente ignorati per quello strumento. `AskUserQuestion`, gli strumenti MCP contrassegnati [`_meta["anthropic/requiresUserInteraction"]`](/docs/it/mcp#require-approval-for-a-specific-tool), gli strumenti del connettore [che la vostra organizzazione ha impostato su `ask`](/docs/it/mcp#organization-controls-on-connector-tools), e le rimozioni `rm` e `rmdir` che puntano a un [percorso critico](/docs/it/permission-modes#critical-paths) raggiungono ancora il callback, anche quando una regola di consentimento corrisponde. In modalità `auto`, le rimozioni di percorsi critici vanno al [classificatore](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) invece del callback, mentre le altre chiamate elencate qui lo raggiungono ancora; il routing del classificatore richiede Claude Code v2.1.218 o successivo. In modalità `dontAsk` queste chiamate vengono invece negate, senza invocare il callback.94 **Gli strumenti approvati automaticamente non raggiungono mai `canUseTool`.** Una chiamata a uno strumento approvata in qualsiasi fase precedente, da `acceptEdits` o `bypassPermissions`, o da una regola di consentimento, salta il callback `canUseTool`, quindi i controlli di autorizzazione che inserite lì vengono silenziosamente ignorati per quello strumento.

96 Una regola di consentimento non approva mai automaticamente `AskUserQuestion`, strumenti MCP contrassegnati [`_meta["anthropic/requiresUserInteraction"]`](/docs/it/mcp#require-approval-for-a-specific-tool), strumenti del connettore [che la vostra organizzazione ha impostato su `ask`](/docs/it/mcp#organization-controls-on-connector-tools), o rimozioni `rm` e `rmdir` che puntano a un [percorso critico](/docs/it/permission-modes#critical-paths). In modalità `dontAsk` Claude Code nega queste chiamate senza invocare il callback. In altre modalità le prime tre raggiungono il callback. A seconda della [modalità di autorizzazione](/docs/it/permission-modes#critical-paths), una rimozione di percorso critico raggiunge il callback anche o Claude Code la nega senza chiamarla, come fa per impostazione predefinita per una sessione Agent SDK in modalità `auto`.

93 97

94 La copertura dipende dalla forma della voce: un nome semplice come `Read` o `mcp__github__get_issue` approva automaticamente ogni chiamata a quello strumento a parte le eccezioni sopra, mentre una regola limitata come `Bash(npm test *)` approva automaticamente solo le chiamate corrispondenti, e le altre chiamate `Bash` che necessitano di approvazione passano ancora attraverso il callback. Per i controlli che devono essere eseguiti su ogni chiamata a uno strumento, utilizzate un [hook `PreToolUse`](/docs/it/agent-sdk/hooks): gli hook vengono eseguiti prima di ogni altro passaggio, e un hook di negazione si applica anche in modalità `bypassPermissions`.98 La copertura dipende dalla forma della voce: un nome semplice come `Read` o `mcp__github__get_issue` approva automaticamente ogni chiamata a quello strumento a parte le eccezioni sopra, mentre una regola limitata come `Bash(npm test *)` approva automaticamente solo le chiamate corrispondenti, e le altre chiamate `Bash` che necessitano di approvazione passano ancora attraverso il callback. Per i controlli che devono essere eseguiti su ogni chiamata a uno strumento, utilizzate un [hook `PreToolUse`](/docs/it/agent-sdk/hooks): gli hook vengono eseguiti prima di ogni altro passaggio, e un hook di negazione si applica anche in modalità `bypassPermissions`.

95</Warning>99</Warning>

agent-sdk/plugins.md +1 −1

Details

331 Plugin non caricato331 Plugin non caricato

332</h3>332</h3>

333 333

334Se il tuo plugin non appare nel messaggio di init:334Se il tuo plugin non appare nell'elenco `plugins` del messaggio di init, controlla il suo campo [`plugin_errors`](/docs/it/agent-sdk/typescript#sdksystemmessage) per il motivo, quindi procedi con questi controlli:

335 335

3361. **Controlla il percorso**: assicurati che il percorso punti alla directory radice del plugin, la directory padre di `skills/`, `agents/`, `hooks/`, `commands/`, o `.claude-plugin/`3361. **Controlla il percorso**: assicurati che il percorso punti alla directory radice del plugin, la directory padre di `skills/`, `agents/`, `hooks/`, `commands/`, o `.claude-plugin/`

3372. **Valida plugin.json**: se il tuo plugin include un manifest, assicurati che abbia una sintassi JSON valida3372. **Valida plugin.json**: se il tuo plugin include un manifest, assicurati che abbia una sintassi JSON valida

agent-sdk/python.md +5 −3

Details

875 include_partial_messages: bool = False875 include_partial_messages: bool = False

876 include_hook_events: bool = False876 include_hook_events: bool = False

877 forward_subagent_text: bool = False877 forward_subagent_text: bool = False

878 verbatim_prompts: bool = False

878 fork_session: bool = False879 fork_session: bool = False

879 resume_session_at: str | None = None880 resume_session_at: str | None = None

880 resume_drops_turn: str | None = None881 resume_drops_turn: str | None = None

930| `forward_subagent_text` | `bool` | `False` | Inoltra i blocchi di testo e pensiero dei subagenti nel flusso di messaggi. Senza questa opzione, Claude Code emette blocchi `tool_use` e `tool_result` dei subagenti ma non testo o pensiero. Richiede Python Agent SDK 0.2.140 o successivo |931| `forward_subagent_text` | `bool` | `False` | Inoltra i blocchi di testo e pensiero dei subagenti nel flusso di messaggi. Senza questa opzione, Claude Code emette blocchi `tool_use` e `tool_result` dei subagenti ma non testo o pensiero. Richiede Python Agent SDK 0.2.140 o successivo |

932| `verbatim_prompts` | `bool` | `False` | Consegna ogni prompt come scritto. L'SDK invia ogni messaggio utente con `client_composed` impostato a `True`. Vedi [`client_composed`](/docs/it/agent-sdk/typescript#sdkusermessage) per ciò che Claude Code salta su quei messaggi. Usa questa opzione quando il testo del prompt include contenuto che l'utente finale non ha digitato. Per il controllo per turno, lascialo disattivato e imposta `"client_composed": True` su singoli messaggi trasmessi invece. Mentre l'opzione è attiva, l'SDK sovrascrive qualsiasi valore `client_composed` che imposti. Richiede Python Agent SDK 0.2.158 o successivo e Claude Code v2.1.248 o successivo; la CLI fornita con quelle versioni dell'SDK soddisfa il requisito di Claude Code |

932| `resume_session_at` | `str \| None` | `None` | Quando si riprende, carica la conversazione solo fino a e includendo il messaggio con questo UUID. Usa con `resume`, e solitamente `fork_session`, per ramificarsi da un punto precedente. Richiede Python Agent SDK 0.2.137 o successivo |934| `resume_session_at` | `str \| None` | `None` | Quando si riprende, carica la conversazione solo fino a e includendo il messaggio con questo UUID. Usa con `resume`, e solitamente `fork_session`, per ramificarsi da un punto precedente. Richiede Python Agent SDK 0.2.137 o successivo |

933| `resume_drops_turn` | `str \| None` | `None` | UUID del prompt utente il cui turno un troncamento `resume_session_at` scarta. Quando impostato, la CLI rifiuta la ripresa se l'intervallo scartato contiene voci non attribuibili a quel turno. Richiede Python Agent SDK 0.2.137 o successivo e Claude Code v2.1.223 o successivo; la CLI fornita con quelle versioni dell'SDK soddisfa il requisito di Claude Code |935| `resume_drops_turn` | `str \| None` | `None` | UUID del prompt utente il cui turno un troncamento `resume_session_at` scarta. Quando impostato, la CLI rifiuta la ripresa se l'intervallo scartato contiene voci non attribuibili a quel turno. Richiede Python Agent SDK 0.2.137 o successivo e Claude Code v2.1.223 o successivo; la CLI fornita con quelle versioni dell'SDK soddisfa il requisito di Claude Code |

1010| `type` | Sì | Deve essere `"preset"` per utilizzare un prompt di sistema preset |1012| `type` | Sì | Deve essere `"preset"` per utilizzare un prompt di sistema preset |

1011| `preset` | Sì | Deve essere `"claude_code"` per utilizzare il prompt di sistema di Claude Code |1013| `preset` | Sì | Deve essere `"claude_code"` per utilizzare il prompt di sistema di Claude Code |

1012| `append` | No | Istruzioni aggiuntive da aggiungere al prompt di sistema preset |1014| `append` | No | Istruzioni aggiuntive da aggiungere al prompt di sistema preset |

1013| `exclude_dynamic_sections` | No | Sposta il contesto per sessione come directory di lavoro, il flag git-repo e i percorsi di memoria automatica dal prompt di sistema nel primo messaggio utente. Migliora il riutilizzo della cache dei prompt tra utenti e macchine. Vedi [Modifica i prompt di sistema](/docs/it/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1015| `exclude_dynamic_sections` | No | Sposta il contesto per utente, come la posizione della memoria automatica, dal prompt di sistema nel primo messaggio utente. Migliora il riutilizzo della cache dei prompt tra utenti e macchine. Vedi [Modifica i prompt di sistema](/docs/it/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1014| `snapshot` | No | Imposta a `False` per ricostruire il prompt di sistema su ogni richiesta invece di [riutilizzare il prompt che la sessione ha registrato alla sua prima richiesta](/docs/it/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Richiede `claude-agent-sdk` v0.2.153 o successivo |1016| `snapshot` | No | Imposta a `False` per ricostruire il prompt di sistema su ogni richiesta invece di [riutilizzare il prompt che la sessione ha registrato alla sua prima richiesta](/docs/it/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Richiede `claude-agent-sdk` v0.2.153 o successivo |

1015 1017

1016<h3 id="systempromptcustom">1018<h3 id="systempromptcustom">

1221 "plan", # Planning mode - explore without editing1223 "plan", # Planning mode - explore without editing

1222 "dontAsk", # Deny anything not pre-approved instead of prompting1224 "dontAsk", # Deny anything not pre-approved instead of prompting

1223 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)1225 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)

1224 "auto", # Model classifier approves or denies permission prompts1226 "auto", # A model classifier reviews actions such as shell commands and network requests

1225]1227]

1226```1228```

1227 1229

3791<Warning>3793<Warning>

3792 I comandi in esecuzione con `dangerouslyDisableSandbox: True` hanno accesso completo al sistema. Assicurati che il tuo handler `can_use_tool` validi queste richieste attentamente.3794 I comandi in esecuzione con `dangerouslyDisableSandbox: True` hanno accesso completo al sistema. Assicurati che il tuo handler `can_use_tool` validi queste richieste attentamente.

3793 3795

3794 Se `permission_mode` è impostato su `bypassPermissions` e `allow_unsandboxed_commands` è abilitato, il modello può autonomamente eseguire comandi al di fuori della sandbox senza prompt di approvazione, a parte le [azioni che nessuna modalità approva automaticamente](/docs/it/permission-modes#actions-no-mode-auto-approves). Questa combinazione consente effettivamente al modello di sfuggire all'isolamento della sandbox silenziosamente.3796 Se `permission_mode` è impostato su `bypassPermissions` e `allowUnsandboxedCommands` è abilitato, il modello può autonomamente eseguire comandi al di fuori della sandbox senza prompt di approvazione, a parte le [azioni che nessuna modalità approva automaticamente](/docs/it/permission-modes#actions-no-mode-auto-approves). Questa combinazione consente effettivamente al modello di sfuggire all'isolamento della sandbox silenziosamente.

3795</Warning>3797</Warning>

3796 3798

3797<h2 id="see-also">3799<h2 id="see-also">

agent-sdk/streaming-output.md +1 −1

Details

330 Limitazioni note330 Limitazioni note

331</h2>331</h2>

332 332

333* **Structured output**: il risultato JSON appare solo nel `ResultMessage.structured_output` finale, non come delta di streaming. Vedi [structured outputs](/docs/it/agent-sdk/structured-outputs) per i dettagli.333* **Structured output**: con i messaggi parziali abilitati, il JSON viene trasmesso come chunk `input_json_delta` non convalidati di una chiamata di strumento, e solo il risultato convalidato raggiunge il `ResultMessage.structured_output` finale. Vedi [structured outputs](/docs/it/agent-sdk/structured-outputs) per i dettagli.

334 334

335<h2 id="next-steps">335<h2 id="next-steps">

336 Passaggi successivi336 Passaggi successivi

agent-sdk/troubleshooting.md +1 −1

Details

162 structured\_output is None but the result says success162 structured\_output is None but the result says success

163</h3>163</h3>

164 164

165Un messaggio di risultato può terminare con `subtype: "success"` mentre `structured_output` è `None` in Python o `undefined` in TypeScript. L'esecuzione si completa, ma non esiste un output convalidato. Un modo per raggiungere questo è uno schema che nessun output può soddisfare, ad esempio vincoli di lunghezza in conflitto. L'esecuzione termina senza un errore di convalida, e l'unico segnale è il `structured_output` mancante.165Un messaggio di risultato può terminare con `subtype: "success"` mentre `structured_output` è `None` in Python o `undefined` in TypeScript. L'esecuzione si completa, ma non esiste un output convalidato. Un modo per raggiungere questo è uno schema che nessun output può soddisfare, ad esempio vincoli di lunghezza in conflitto.

166 166

167Tratta questo risultato come un errore nel codice dell'applicazione. Controlla sia che `subtype` sia `success` che che `structured_output` sia presente prima di utilizzarlo. La sezione [Error handling](/docs/it/agent-sdk/structured-outputs#error-handling) mostra questo modello per entrambi gli SDK.167Tratta questo risultato come un errore nel codice dell'applicazione. Controlla sia che `subtype` sia `success` che che `structured_output` sia presente prima di utilizzarlo. La sezione [Error handling](/docs/it/agent-sdk/structured-outputs#error-handling) mostra questo modello per entrambi gli SDK.

168 168

agent-sdk/typescript.md +308 −81

Details

54* Per la compilazione incrociata, installa il pacchetto della piattaforma non corrispondente, ad esempio `npm install @anthropic-ai/claude-agent-sdk-linux-x64 --force`.54* Per la compilazione incrociata, installa il pacchetto della piattaforma non corrispondente, ad esempio `npm install @anthropic-ai/claude-agent-sdk-linux-x64 --force`.

55* Su Windows, il sottopercorso binario è `claude.exe`, ad esempio `@anthropic-ai/claude-agent-sdk-win32-x64/claude.exe`.55* Su Windows, il sottopercorso binario è `claude.exe`, ad esempio `@anthropic-ai/claude-agent-sdk-win32-x64/claude.exe`.

56 56

57<h3 id="import-the-/core-entry-when-you-bundle-the-agent-sdk">

58 Importa l'entry `/core` quando raggruppi l'Agent SDK

59</h3>

61Se la tua applicazione raggruppa l'Agent SDK insieme alle sue dipendenze, importa da `@anthropic-ai/claude-agent-sdk/core` invece che dalla radice del pacchetto. L'entry `/core` richiede Agent SDK TypeScript v0.3.282 o successivo, e i suoi tipi richiedono TypeScript 5.0 o successivo.

63L'entry `/core` esporta lo stesso `query()`, `startup()`, `tool()`, `createSdkMcpServer()` e `resolveSettings()` come l'entry radice, insieme alle funzioni che rinominano, taggano ed eliminano le sessioni, `AbortError`, le costanti di runtime e ogni tipo. Non aggiunge nomi propri. Per mantenere piccolo il codice che la tua applicazione carica, `/core` omette alcune esportazioni radice, inclusi `prewarm()`, la classe `InMemorySessionStore` e gli helper che elencano, leggono, biforcano, importano e riassumono le sessioni. Se ne hai bisogno di uno, usa l'entry radice.

65L'entry radice incorpora le sue proprie copie di `zod` e `@modelcontextprotocol/sdk`. L'entry `/core` le importa dal tuo `node_modules` negli intervalli che le `peerDependencies` dell'Agent SDK dichiarano, quindi un bundle che le include già non porta una seconda copia. Importa da una o dall'altra dell'entry radice o `/core` in un dato processo, non entrambe: sono bundle separati, e caricare entrambe ti dà due copie delle classi e dello stato dell'Agent SDK.

57<h2 id="functions">67<h2 id="functions">

58 Funzioni68 Funzioni

59</h2>69</h2>

93 `startup()`103 `startup()`

94</h3>104</h3>

95 105

96Pre-riscalda il subprocess CLI generandolo e completando l'handshake di inizializzazione prima che un prompt sia disponibile. L'handle [`WarmQuery`](#warmquery) restituito accetta un prompt in seguito e lo scrive in un processo già pronto, quindi la prima chiamata `query()` si risolve senza pagare il costo di generazione e inizializzazione del subprocess inline.106Pre-riscalda il subprocess CLI generandolo e completando l'handshake di inizializzazione prima che un prompt sia disponibile. L'handle [`WarmQuery`](#warmquery) restituito accetta un prompt in seguito e lo scrive in un processo già pronto, quindi la prima chiamata `query()` si risolve senza pagare il costo di generazione e inizializzazione del subprocess inline. Se non conosci ancora la directory di lavoro della sessione, utilizza [`prewarm()`](#prewarm) invece.

97 107

98```typescript theme={null}108```typescript theme={null}

99function startup(params?: {109function startup(params?: {

135}145}

136```146```

137 147

148<h3 id="prewarm">

149 `prewarm()`

150</h3>

151

152*Alpha.* Avvia un processo Claude Code come riserva prima di sapere quale sessione servirà, così potrai associarlo a una sessione in seguito con [`claim()`](#spareprocess). Utilizzalo in un'applicazione che si avvia prima che l'utente scelga una cartella. Richiede TypeScript Agent SDK v0.3.282 o successivo.

153

154`prewarm()` completa lo stesso handshake di inizializzazione di [`startup()`](#startup), con il processo in attesa in `options.cwd` quando lo imposti e altrimenti in una directory temporanea privata sotto la tua directory di configurazione di Claude Code. La directory di lavoro della sessione, i suoi hook `SessionStart`, i suoi server MCP stdio, e il suo contesto CLAUDE.md e git attendono il claim. Una riserva mantiene approssimativamente da 230 a 260 MB di memoria mentre attende. Se il tuo [`spawnClaudeCodeProcess`](#options) esegue Claude Code su un'altra macchina o in un contenitore, imposta `options.cwd` a una directory che esiste lì affinché la riserva attenda.

155

156```typescript theme={null}

157function prewarm(params?: {

158 options?: Options;

159 initializeTimeoutMs?: number;

160}): Promise<SpareProcess>;

161```

162

163`options` e `initializeTimeoutMs` significano lo stesso che per `startup()`, tranne che `options.cwd` imposta solo la directory in cui la riserva attende. La promessa si risolve con un [`SpareProcess`](#spareprocess) una volta che il processo ha completato il suo handshake di inizializzazione. `prewarm()` genera un'eccezione se `options` imposta `resume`, `continue`, o `forkSession`, perché una riserva non ha ancora una sessione. Tutto ciò che un claim non può impostare, come `mcpServers`, `hooks`, `canUseTool`, `settingSources`, `systemPrompt`, e `plugins`, è fisso per la vita della riserva, quindi mantieni una riserva per ogni set distinto di quelle opzioni e prewarm di nuovo quando cambiano.

164

165<h4 id="example-2">

166 Esempio

167</h4>

168

169Prewarm all'avvio dell'applicazione, quindi claim la riserva quando l'utente avvia una sessione:

170

171```typescript theme={null}

172import { prewarm } from "@anthropic-ai/claude-agent-sdk";

173

174// All'avvio dell'applicazione, prima che la cartella della sessione sia nota

175const spare = await prewarm({ options: { maxTurns: 3 } });

176

177// Più tardi, quando l'utente avvia una sessione in una cartella

178const claimedQuery = spare.claim({

179 prompt: "What files are here?",

180 options: { cwd: "/path/to/project" },

181});

182

183spare.claimed.catch((error: Error) => {

184 // A meno che il messaggio non inizi con "option_not_applied", il prompt non è stato eseguito:

185 // avvia questa sessione con query() invece

186 console.error("Claim failed:", error.message);

187});

188

189for await (const message of claimedQuery) {

190 console.log(message);

191}

192```

193

138<h3 id="tool">194<h3 id="tool">

139 `tool()`195 `tool()`

140</h3>196</h3>

167 `ToolAnnotations`223 `ToolAnnotations`

168</h4>224</h4>

169 225

170Re-esportato da `@modelcontextprotocol/sdk/types.js`. Tutti i campi sono suggerimenti opzionali; i client non dovrebbero fare affidamento su di essi per decisioni di sicurezza.226Definito in `@modelcontextprotocol/sdk/types.js`. Tutti i campi sono suggerimenti opzionali; i client non dovrebbero fare affidamento su di essi per decisioni di sicurezza.

171 227

173| :- | :- | :- | :- |229| :- | :- | :- | :- |

250| :- | :- | :- |306| :- | :- | :- |

261 317

262<h4 id="example-2">318<h4 id="example-3">

263 Esempio319 Esempio

264</h4>320</h4>

265 321

312| `parent_tool_use_id` | `string \| null` | Per i messaggi dei subagent, l'`tool_use_id` della chiamata del tool `Agent` o `Skill` che lo ha generato. `null` per i messaggi della sessione principale e le sessioni precedenti |368| `parent_tool_use_id` | `string \| null` | Per i messaggi dei subagent, l'`tool_use_id` della chiamata del tool `Agent` o `Skill` che lo ha generato. `null` per i messaggi della sessione principale e le sessioni precedenti |

313| `parent_agent_id` | `string \| null` | Per i messaggi da un [subagent annidato](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents), l'`agentId` del subagent che lo ha generato. `null` per i messaggi della sessione principale, i messaggi dai subagent di primo livello e le sessioni precedenti. Richiede Claude Code v2.1.202 o successivo |369| `parent_agent_id` | `string \| null` | Per i messaggi da un [subagent annidato](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents), l'`agentId` del subagent che lo ha generato. `null` per i messaggi della sessione principale, i messaggi dai subagent di primo livello e le sessioni precedenti. Richiede Claude Code v2.1.202 o successivo |

314 370

315<h4 id="example-3">371<h4 id="example-4">

316 Esempio372 Esempio

317</h4>373</h4>

318 374

453| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Impostazioni grezze per fonte, ordinate dalla precedenza più bassa a quella più alta |509| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Impostazioni grezze per fonte, ordinate dalla precedenza più bassa a quella più alta |

454 510

455<h4 id="example-4">511<h4 id="example-5">

456 Esempio512 Esempio

457</h4>513</h4>

458 514

547| `toolAliases` | `Record<string, string>` | `undefined` | Mappa i nomi degli strumenti incorporati ai nomi degli strumenti MCP in modo che Claude chiami la tua implementazione MCP al posto di quella incorporata. Ad esempio, `{ Bash: 'mcp__workspace__bash' }` |603| `toolAliases` | `Record<string, string>` | `undefined` | Mappa i nomi degli strumenti incorporati ai nomi degli strumenti MCP in modo che Claude chiami la tua implementazione MCP al posto di quella incorporata. Ad esempio, `{ Bash: 'mcp__workspace__bash' }` |

549| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Configurazione dello strumento. Passa un array di nomi di strumenti o usa il preset per ottenere gli strumenti predefiniti di Claude Code |605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Configurazione dello strumento. Passa un array di nomi di strumenti o usa il preset per ottenere gli strumenti predefiniti di Claude Code |

606| `verbatimPrompts` | `boolean` | `false` | Consegna ogni prompt come scritto. L'SDK invia ogni messaggio utente con `client_composed: true`. Vedi [`client_composed`](#sdkusermessage) per cosa Claude Code salta su quei messaggi. Usa questa opzione quando il testo del tuo prompt include contenuto che l'utente finale non ha digitato. Per il controllo per turno, lascialo disattivato e imposta `client_composed` su messaggi trasmessi individuali. Richiede TypeScript Agent SDK v0.3.280 o successivo e Claude Code v2.1.248 o successivo; la versione di Claude Code in bundle con quelle versioni SDK soddisfa il requisito di versione di Claude Code |

550 607

551<h4 id="handle-slow-or-stalled-api-responses">608<h4 id="handle-slow-or-stalled-api-responses">

552 Gestire risposte API lente o bloccate609 Gestire risposte API lente o bloccate

617 path: string,674 path: string,

618 options?: { maxBytes?: number; encoding?: 'utf-8' | 'base64' }675 options?: { maxBytes?: number; encoding?: 'utf-8' | 'base64' }

619 ): Promise<SDKControlReadFileResponse | null>;676 ): Promise<SDKControlReadFileResponse | null>;

677 reloadPlugins(options?: {

678 holdOnCacheImpact?: boolean;

679 }): Promise<SDKControlReloadPluginsResponse>;

620 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;680 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;

681 reloadOutputStyles(): Promise<SDKControlReloadOutputStylesResponse>;

621 accountInfo(): Promise<AccountInfo>;682 accountInfo(): Promise<AccountInfo>;

622 reconnectMcpServer(serverName: string): Promise<void>;683 reconnectMcpServer(serverName: string): Promise<void>;

623 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;684 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;

651| `getContextUsage(opts?)` | Restituisce un [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) che suddivide l'utilizzo della finestra di contesto della sessione per categoria, skill e strumento. Con il predefinito `detail`, sono gli stessi dati che `/context` mostra in una sessione interattiva. L'[opzione `detail`](#sdkcontrolgetcontextusageresponse) richiede Agent SDK v0.3.257 o successivo |712| `getContextUsage(opts?)` | Restituisce un [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) che suddivide l'utilizzo della finestra di contesto della sessione per categoria, skill e strumento. Con il predefinito `detail`, sono gli stessi dati che `/context` mostra in una sessione interattiva. L'[opzione `detail`](#sdkcontrolgetcontextusageresponse) richiede Agent SDK v0.3.257 o successivo |

652| `readFile(path, options?)` | Legge un file dal filesystem della sessione. Claude Code risolve il percorso rispetto a `cwd`; [Cosa `readFile()` può leggere](#what-readfile-can-read) elenca i file che serve. Passa `{ maxBytes }` per cambiare il limite di lettura (predefinito 1 MB, massimo 10 MB) e `{ encoding: 'base64' }` per file binari come immagini. Si risolve con un [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse), o `null` su rifiuto di permesso, file mancante, o errore di trasporto. Richiede TypeScript SDK v0.2.121 o successivo |713| `readFile(path, options?)` | Legge un file dal filesystem della sessione. Claude Code risolve il percorso rispetto a `cwd`; [Cosa `readFile()` può leggere](#what-readfile-can-read) elenca i file che serve. Passa `{ maxBytes }` per cambiare il limite di lettura (predefinito 1 MB, massimo 10 MB) e `{ encoding: 'base64' }` per file binari come immagini. Si risolve con un [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse), o `null` su rifiuto di permesso, file mancante, o errore di trasporto. Richiede TypeScript SDK v0.2.121 o successivo |

714| `reloadPlugins(options?)` | Ricarica i plugin dal disco, in modo che i plugin che installi o modifichi mid-session raggiungano la sessione in esecuzione. Si risolve con un [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) che elenca i comandi, i subagent, i plugin e lo stato del server MCP della sessione. Richiede Agent SDK v0.2.85 o successivo. L'[opzione `holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) richiede Agent SDK v0.3.268 o successivo |

653| `reloadSkills()` | Ricarica le skill dal disco, in modo che le skill che aggiungi o modifichi mid-session diventino disponibili per la sessione in esecuzione. Si risolve con un [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) che elenca le skill disponibili dopo il ricaricamento. Richiede Agent SDK v0.3.163 o successivo |715| `reloadSkills()` | Ricarica le skill dal disco, in modo che le skill che aggiungi o modifichi mid-session diventino disponibili per la sessione in esecuzione. Si risolve con un [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) che elenca le skill disponibili dopo il ricaricamento. Richiede Agent SDK v0.3.163 o successivo |

716| `reloadOutputStyles()` | Re-legge gli [stili di output](/docs/it/output-styles) dal disco, in modo che un file di stile che aggiungi o modifichi mid-session diventi disponibile per la sessione in esecuzione. Si risolve con un [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) che elenca i nomi di stile disponibili dopo il ricaricamento. Richiede Agent SDK v0.3.261 o successivo |

655| `reconnectMcpServer(serverName)` | Ricollega un server MCP per nome. Se il nome corrisponde anche a una voce in un file di impostazioni come `.mcp.json` o `~/.claude.json`, Claude Code ricollega il server che hai configurato tramite [`mcpServers`](#options) o `setMcpServers()`, non la voce del file di impostazioni. Quell'ordine di risoluzione richiede Claude Code v2.1.257 o successivo |718| `reconnectMcpServer(serverName)` | Ricollega un server MCP per nome. Se il nome corrisponde anche a una voce in un file di impostazioni come `.mcp.json` o `~/.claude.json`, Claude Code ricollega il server che hai configurato tramite [`mcpServers`](#options) o `setMcpServers()`, non la voce del file di impostazioni. Quell'ordine di risoluzione richiede Claude Code v2.1.257 o successivo |

656| `toggleMcpServer(serverName, enabled)` | Abilita o disabilita un server MCP per nome, con la stessa risoluzione del nome di `reconnectMcpServer()`. La disabilitazione disconnette il server |719| `toggleMcpServer(serverName, enabled)` | Abilita o disabilita un server MCP per nome, con la stessa risoluzione del nome di `reconnectMcpServer()`. La disabilitazione disconnette il server |

672* **Applicate durante il turno corrente**: `model`. Se cambi `model` mentre Claude sta lavorando su un turno, la risposta che Claude sta già generando termina sul modello vecchio, e il resto del turno, a partire dalla prossima chiamata che Claude Code fa al modello, usa quello nuovo. I subagent mantengono il loro modello. Prima di v2.1.212, un cambio mid-turn aspettava il turno successivo.735* **Applicate durante il turno corrente**: `model`. Se cambi `model` mentre Claude sta lavorando su un turno, la risposta che Claude sta già generando termina sul modello vecchio, e il resto del turno, a partire dalla prossima chiamata che Claude Code fa al modello, usa quello nuovo. I subagent mantengono il loro modello. Prima di v2.1.212, un cambio mid-turn aspettava il turno successivo.

673* **Nessun effetto mid-session**: le opzioni del prompt di sistema. Questi vengono risolti una volta all'avvio, quindi la sessione in esecuzione mantiene il valore originale anche se la chiamata ha successo. Per cambiarli, avvia una nuova sessione.736* **Nessun effetto mid-session**: le opzioni del prompt di sistema. Questi vengono risolti una volta all'avvio, quindi la sessione in esecuzione mantiene il valore originale anche se la chiamata ha successo. Per cambiarli, avvia una nuova sessione.

674 737

675`effortLevel` accetta un nome di [livello di sforzo](/docs/it/model-config#adjust-effort-level). Accetta anche `"ultracode"`, che richiede uno sforzo `xhigh` con [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) attivo. `applyFlagSettings()` dichiara `effortLevel` senza quel valore, quindi passa l'equivalente `{ ultracode: true }` in TypeScript. Il valore `ultracode` richiede Claude Code v2.1.203 o successivo ed è accettato solo da `applyFlagSettings()`, non dalla chiave `effortLevel` in un file di impostazioni.738`effortLevel` accetta un nome di [livello di sforzo](/docs/it/model-config#adjust-effort-level). Accetta anche `"ultracode"`, che richiede uno sforzo `xhigh` con [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) attivo. `applyFlagSettings()` dichiara `effortLevel` senza quel valore, quindi in TypeScript passa `{ ultracode: true, effortLevel: "xhigh" }` per lo stesso risultato, o la chiave [`ultracode`](/docs/it/settings-reference#ultracode) da sola per attivare ultracode al livello di sforzo corrente della sessione. Il valore `ultracode` richiede Claude Code v2.1.203 o successivo ed è accettato solo da `applyFlagSettings()`, non dalla chiave `effortLevel` in un file di impostazioni. Prima di v2.1.284, la chiave `ultracode` da sola impostava anche il livello a `xhigh`.

676 739

677I valori vengono scritti nel livello flag-settings, lo stesso livello che l'opzione `settings` inline di `query()` popola all'avvio. Questo è lo stesso livello che la [sezione di precedenza sulla pagina](#settings-precedence) chiama opzioni programmatiche.740I valori vengono scritti nel livello flag-settings, lo stesso livello che l'opzione `settings` inline di `query()` popola all'avvio. Questo è lo stesso livello che la [sezione di precedenza sulla pagina](#settings-precedence) chiama opzioni programmatiche.

678 741

741 804

742`WarmQuery` implementa `AsyncDisposable`, quindi può essere usato con `await using` per la pulizia automatica.805`WarmQuery` implementa `AsyncDisposable`, quindi può essere usato con `await using` per la pulizia automatica.

743 806

807<h3 id="spareprocess">

808 `SpareProcess`

809</h3>

810

811*Alpha.* Handle restituito da [`prewarm()`](#prewarm): un processo Claude Code avviato che non è ancora vincolato a una sessione e può essere rivendicato una volta. Richiede TypeScript Agent SDK v0.3.282 o successivo.

812

813```typescript theme={null}

814interface SpareProcess extends AsyncDisposable {

815 claim(params: {

816 prompt: string | AsyncIterable<SDKUserMessage>;

817 options: ClaimOptions;

818 }): Query;

819 readonly claimed: Promise<{ cwd: string; sessionId: string; parkedMs?: number; sdkMcpSettled: boolean }>;

820 readonly exited: Promise<void>;

821 close(): void;

822}

823```

824

825<h4 id="members">

826 Membri

827</h4>

828

829| Membro | Descrizione |

830| :- | :- |

831| `claim({ prompt, options })` | Vincola lo spare a una sessione in `options.cwd` e invia il suo primo messaggio. Restituisce un [`Query`](#query-object) in modo sincrono, come `query()` fa. Può essere chiamato solo una volta |

832| `claimed` | Si risolve con la directory di lavoro e l'ID della sessione una volta che Claude Code accetta la rivendicazione. Rifiuta quando Claude Code rifiuta la rivendicazione, quando il processo è uscito o è stato chiuso per primo, e, con un messaggio che inizia con `option_not_applied`, quando la sessione è in esecuzione senza il `model` o `maxThinkingTokens` che hai richiesto |

833| `exited` | Si stabilizza quando il processo esce, rivendicato o meno. Sostituisci uno spare che esce prima che tu lo rivendichi |

834| `close()` | Termina il processo. Prima di una rivendicazione questo scarta lo spare e rifiuta `claimed` |

835

836`options.cwd` è richiesto. Una rivendicazione può anche impostare `additionalDirectories`, `model`, `permissionMode`, `maxThinkingTokens`, un overlay flag-settings in `settings`, `appendSystemPrompt`, `title`, `agents`, e token per-sessione in `env`.

837

838Claude Code può rifiutare una rivendicazione, ad esempio per una cartella che non esiste o una le cui impostazioni del progetto impostano `env`, `agent`, o `model`. Quando `claimed` rifiuta con un messaggio che inizia con `option_not_applied`, la sessione è in esecuzione senza il `model` o `maxThinkingTokens` che hai richiesto. Dopo qualsiasi altro rifiuto il tuo prompt non ha eseguito, quindi avvia la sessione con `query()` invece.

839

744<h3 id="sdkcontrolinitializeresponse">840<h3 id="sdkcontrolinitializeresponse">

745 `SDKControlInitializeResponse`841 `SDKControlInitializeResponse`

746</h3>842</h3>

824 tokens: number;920 tokens: number;

825 color: string;921 color: string;

826 isDeferred?: boolean;922 isDeferred?: boolean;

923 kind: "used" | "free" | "buffer" | "deferred";

827 }[];924 }[];

828 totalTokens: number;925 totalTokens: number;

829 maxTokens: number;926 maxTokens: number;

913 1010

914Leggi l'attribuzione dei token dalle raccolte di campi:1011Leggi l'attribuzione dei token dalle raccolte di campi:

915 1012

916* `categories` contiene i totali per categoria.1013* `categories` contiene i totali per categoria. Ogni voce's `kind` classifica la riga con gli stessi valori di [`SDKContextUsageCategory`](#sdkcontextusagecategory). Classifica le righe su di esso piuttosto che sul `name` di visualizzazione. Il campo richiede Agent SDK v0.3.268 o successivo.

917* `mcpTools` e `agents` attribuiscono i token ai singoli strumenti MCP e subagent.1014* `mcpTools` e `agents` attribuiscono i token ai singoli strumenti MCP e subagent.

918* `memoryFiles` elenca ogni file di memoria caricato con il suo costo.1015* `memoryFiles` elenca ogni file di memoria caricato con il suo costo.

919* `skills.skillFrontmatter` attribuisce i token della voce di skill a ogni skill inclusa. I conteggi per skill misurano ogni voce di skill come Claude Code effettivamente la invia, che può essere più breve del frontmatter completo della skill. Confronta `skills.totalSkills` con `skills.includedSkills` per vedere se ogni skill scoperta ha fatto parte dell'elenco.1016* `skills.skillFrontmatter` attribuisce i token della voce di skill a ogni skill inclusa. I conteggi per skill misurano ogni voce di skill come Claude Code effettivamente la invia, che può essere più breve del frontmatter completo della skill. Confronta `skills.totalSkills` con `skills.includedSkills` per vedere se ogni skill scoperta ha fatto parte dell'elenco.

950 1047

951Le regole di negazione e richiesta di Read bloccano comunque un percorso corrispondente, e una regola di autorizzazione Read ampia non apre il resto del filesystem a `readFile()`. Per qualsiasi altra cosa la chiamata si risolve con `null`.1048Le regole di negazione e richiesta di Read bloccano comunque un percorso corrispondente, e una regola di autorizzazione Read ampia non apre il resto del filesystem a `readFile()`. Per qualsiasi altra cosa la chiamata si risolve con `null`.

952 1049

1050<h3 id="sdkcontrolreloadpluginsresponse">

1051 `SDKControlReloadPluginsResponse`

1052</h3>

1053

1054Tipo di ritorno di [`reloadPlugins()`](#query-object).

1055

1056```typescript theme={null}

1057type SDKControlReloadPluginsResponse = {

1058 commands: SlashCommand[];

1059 agents: AgentInfo[];

1060 plugins: {

1061 name: string;

1062 path: string;

1063 source?: string;

1064 version?: string;

1065 }[];

1066 mcpServers: McpServerStatus[];

1067 error_count: number;

1068 held?: boolean;

1069 cache_impact?: {

1070 mcp_servers_added: string[];

1071 mcp_servers_removed: string[];

1072 lsp_tool_change: ("adds" | "may-add" | "removes" | "may-remove") | null;

1073 };

1074};

1075```

1076

1077I campi della raccolta descrivono la sessione dopo la chiamata:

1078

1079* `commands`, `agents`, e `mcpServers`: i comandi, i subagent e lo stato del server MCP della sessione, nelle stesse forme che `supportedCommands()`, `supportedAgents()`, e `mcpServerStatus()` restituiscono. `supportedAgents()` continua a restituire l'elenco catturato all'inizializzazione, quindi leggi `agents` qui per l'insieme dopo un ricaricamento

1080* `plugins`: ogni plugin caricato con il suo `name` e il percorso di installazione `path`. `version` ripete ciò che il manifest del plugin dichiara ed è controllato dall'autore del plugin, quindi convalidalo prima di fidarti. È omesso quando il manifest non dichiara nulla

1081* `error_count`: il numero di errori dal caricamento dei plugin

1082

1083Passa `{ holdOnCacheImpact: true }` a `reloadPlugins()` per trattenere un ricaricamento che invaliderebbe la cache del prompt della conversazione invece di applicarlo. Claude Code esegue il controllo che il comando interattivo `/reload-plugins` fa prima di [avvertire del costo della cache](/docs/it/prompt-caching#enabling-or-disabling-a-plugin). L'opzione richiede Agent SDK v0.3.268 o successivo. Un eseguibile Claude Code più vecchio di v2.1.268, come uno che punti `pathToClaudeCodeExecutable` a, ignora l'opzione e applica il ricaricamento.

1084

1085Quando passi l'opzione, leggi `held` per sapere cosa è successo:

1086

1087* `true`: il ricaricamento non è stato applicato, e i campi della raccolta descrivono la sessione come ancora è. `cache_impact` dice cosa applicare cambierebbe. Per applicare comunque, chiama `reloadPlugins()` di nuovo senza l'opzione.

1088* `false`: il controllo non ha trovato alcun impatto sulla cache, e il ricaricamento è stato applicato.

1089* Assente: non hai passato l'opzione, o l'eseguibile Claude Code è più vecchio di v2.1.268 e ha applicato il ricaricamento.

1090

1091`cache_impact` è presente solo insieme a `held: true`. `mcp_servers_added` e `mcp_servers_removed` nominano i server MCP del plugin che il ricaricamento registrerebbe o eliminerebbe, come nomi con ambito `plugin:<plugin>:<server>`. I nomi sono creati dal plugin, quindi convalidali prima di mostrarli. `lsp_tool_change` dice se applicare aggiungerebbe o rimuoverebbe lo strumento LSP, o `null` quando non farebbe nulla. Le forme `may-` significano che il controllo non poteva vedere completamente l'insieme di plugin in sospeso.

1092

953<h3 id="sdkcontrolreloadskillsresponse">1093<h3 id="sdkcontrolreloadskillsresponse">

954 `SDKControlReloadSkillsResponse`1094 `SDKControlReloadSkillsResponse`

955</h3>1095</h3>

964 1104

965`skills` elenca le skill disponibili dopo il ricaricamento, nella stessa forma [`SlashCommand`](#slashcommand) che `supportedCommands()` restituisce.1105`skills` elenca le skill disponibili dopo il ricaricamento, nella stessa forma [`SlashCommand`](#slashcommand) che `supportedCommands()` restituisce.

966 1106

1107<h3 id="sdkcontrolreloadoutputstylesresponse">

1108 `SDKControlReloadOutputStylesResponse`

1109</h3>

1110

1111Tipo di ritorno di [`reloadOutputStyles()`](#query-object).

1112

1113```typescript theme={null}

1114type SDKControlReloadOutputStylesResponse = {

1115 available_output_styles: string[];

1116};

1117```

1118

1119`available_output_styles` elenca i nomi degli stili di output incorporati e personalizzati disponibili dopo il ricaricamento.

1120

967<h3 id="sdkcontrolmcpreadresourceresponse">1121<h3 id="sdkcontrolmcpreadresourceresponse">

968 `SDKControlMcpReadResourceResponse`1122 `SDKControlMcpReadResourceResponse`

969</h3>1123</h3>

984 1138

985Passa `readMcpResource()` il nome del server come `mcpServerStatus()` lo segnala e un URI `ui://`, come l'`ui.resourceUri` che uno strumento dichiara nel suo [`_meta`](#mcpserverstatus). La chiamata rifiuta per qualsiasi altro schema URI, per un [SDK MCP server](#createsdkmcpserver) che la tua applicazione ospita stessa, e per un server che non è connesso. È disponibile quando il messaggio init's [`capabilities`](#sdksystemmessage) include `mcp_read_resource_v1`.1139Passa `readMcpResource()` il nome del server come `mcpServerStatus()` lo segnala e un URI `ui://`, come l'`ui.resourceUri` che uno strumento dichiara nel suo [`_meta`](#mcpserverstatus). La chiamata rifiuta per qualsiasi altro schema URI, per un [SDK MCP server](#createsdkmcpserver) che la tua applicazione ospita stessa, e per un server che non è connesso. È disponibile quando il messaggio init's [`capabilities`](#sdksystemmessage) include `mcp_read_resource_v1`.

986 1140

987Ogni voce `contents` è un elemento di contenuto come il server lo ha inviato. `blob` contiene dati base64 per un elemento binario, e `_meta` è il `_meta` dell'elemento stesso, dove un server MCP Apps mette il `ui.csp` e `ui.permissions` della risorsa. I contenuti sono HTML di terze parti non attendibile, quindi rendili in una sandbox.1141Ogni voce `contents` è un elemento di contenuto come il server lo ha inviato, meno qualsiasi chiave `_meta` sotto il prefisso `com.anthropic/`, che è riservato a Claude Code. `blob` contiene dati base64 per un elemento binario, e `_meta` è il `_meta` dell'elemento stesso, dove un server MCP Apps mette il `ui.csp` e `ui.permissions` della risorsa.

1142

1143I contenuti sono HTML di terze parti non attendibile, quindi rendili in una sandbox.

988 1144

989<h3 id="agentdefinition">1145<h3 id="agentdefinition">

990 `AgentDefinition`1146 `AgentDefinition`

1142 blockedPath?: string;1298 blockedPath?: string;

1143 mcpServer?: { name: string; source: string };1299 mcpServer?: { name: string; source: string };

1144 decisionReason?: string;1300 decisionReason?: string;

1301 defaultToNo?: boolean;

1302 suppressAlwaysAllowRule?: boolean;

1145 toolUseID: string;1303 toolUseID: string;

1146 agentID?: string;1304 agentID?: string;

1147 requestId: string;1305 requestId: string;

1157| `mcpServer` | `{ name: string; source: string }` | Per uno strumento `mcp__*`, il server MCP che lo serve e da dove proviene la definizione di quel server, con i campi di [`McpServerProvenance`](#mcpserverprovenance). Assente per altri strumenti. Richiede Agent SDK v0.3.274 o successivo |1315| `mcpServer` | `{ name: string; source: string }` | Per uno strumento `mcp__*`, il server MCP che lo serve e da dove proviene la definizione di quel server, con i campi di [`McpServerProvenance`](#mcpserverprovenance). Assente per altri strumenti. Richiede Agent SDK v0.3.274 o successivo |

1317| `defaultToNo` | `boolean` | Quando `true`, un singolo tasto errato non deve approvare questa richiesta: apri il tuo prompt sulla sua opzione di declino, non pre-selezionare approvazione, e non offrire alcuna scorciatoia di approvazione con un tasto. Richiede Agent SDK v0.3.268 o successivo |

1318| `suppressAlwaysAllowRule` | `boolean` | Quando `true`, non offrire una scelta persistente sempre-consenti per questa richiesta, perché la regola che scriverebbe concede più dell'azione della richiesta stessa. Richiede Agent SDK v0.3.268 o successivo |

1161| `requestId` | `string` | L'`request_id` dell'envelope `control_request`. Un `control_response` che la tua applicazione invia al di fuori dell'SDK, come un POST HTTP firmato, deve echeggiare questo valore in modo che il processo Claude Code possa abbinare la risposta alla richiesta |1321| `requestId` | `string` | L'`request_id` dell'envelope `control_request`. Un `control_response` che la tua applicazione invia al di fuori dell'SDK, come un POST HTTP firmato, deve echeggiare questo valore in modo che il processo Claude Code possa abbinare la risposta alla richiesta |

1380 context_usage?: SDKContextUsage;1540 context_usage?: SDKContextUsage;

1381 user_message_uuid?: string;1541 user_message_uuid?: string;

1382 user_message_uuids?: string[];1542 user_message_uuids?: string[];

1543 resume_reason?: string;

1383};1544};

1384```1545```

1385 1546

1387 1548

1388`SDKAssistantMessageError` è uno di: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_found'`, `'server_error'`, `'max_output_tokens'`, `'cloud_credential_error'`, o `'unknown'`. Quattro di questi valori significano più di quanto i loro nomi dicono:1549`SDKAssistantMessageError` è uno di: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_found'`, `'server_error'`, `'max_output_tokens'`, `'cloud_credential_error'`, o `'unknown'`. Quattro di questi valori significano più di quanto i loro nomi dicono:

1389 1550

1390* `'model_not_found'`: il modello selezionato non esiste o non è disponibile per il tuo account o deployment1551* `'model_not_found'`: il modello selezionato non esiste o non è disponibile per il vostro account o deployment

1391* `'overloaded'`: l'API ha restituito un 529 perché il server è al massimo della capacità, a differenza di `'rate_limit'`, che è un 429 rispetto alla tua quota1552* `'overloaded'`: l'API ha restituito un 529 perché il server è al massimo della capacità, a differenza di `'rate_limit'`, che è un 429 rispetto alla vostra quota

1392* `'account_on_hold'`: [il tuo account è in sospeso](/docs/it/errors#your-account-is-on-hold)1553* `'account_on_hold'`: [il vostro account è in sospeso](/docs/it/errors#your-account-is-on-hold)

1393* `'cloud_credential_error'`: Claude Code non ha potuto ottenere credenziali AWS o Google Cloud utilizzabili sulla macchina su cui viene eseguito, quindi nessuna richiesta ha raggiunto il provider cloud. La causa solita è un accesso al cloud scaduto o mai completato su quella macchina, anche se un servizio di credenziali brevemente irraggiungibile segnala lo stesso valore. Vedi [Impossibile caricare le credenziali AWS o Google Cloud](/docs/it/errors#could-not-load-aws-or-google-cloud-credentials). Richiede TypeScript Agent SDK v0.3.267 o successivo, che raggruppa Claude Code v2.1.2671554* `'cloud_credential_error'`: Claude Code non ha potuto ottenere credenziali AWS o Google Cloud utilizzabili sulla macchina su cui viene eseguito, quindi nessuna richiesta ha raggiunto il provider cloud. La causa solita è un accesso al cloud scaduto o mai completato su quella macchina, anche se un servizio di credenziali brevemente irraggiungibile segnala lo stesso valore. Vedi [Impossibile caricare le credenziali AWS o Google Cloud](/docs/it/errors#could-not-load-aws-or-google-cloud-credentials). Richiede TypeScript Agent SDK v0.3.267 o successivo, che raggruppa Claude Code v2.1.267

1394 1555

1395`aborted` è `true` quando un'interruzione o un'interruzione ha troncato il messaggio dell'assistente prima del completamento del flusso: il messaggio non ha `stop_reason` e il contenuto può terminare a metà parola. Il campo è assente sui messaggi completati normalmente. Richiede Agent SDK v0.3.214 o successivo.1556`aborted` è `true` quando un'interruzione o un'interruzione ha troncato il messaggio dell'assistente prima del completamento del flusso: il messaggio non ha `stop_reason` e il contenuto può terminare a metà parola. Il campo è assente sui messaggi completati normalmente. Richiede Agent SDK v0.3.214 o successivo.

1396 1557

1397Claude Code imposta `user_message_uuid` e `user_message_uuids` sul primo messaggio dell'assistente del turno, secondo le condizioni in [`user_message_uuid`](#user_message_uuid).1558Claude Code imposta `user_message_uuid` e `user_message_uuids` sul primo messaggio dell'assistente del turno, secondo le condizioni in [`user_message_uuid`](#user_message_uuid). Quando Claude Code riesegue un turno che un riavvio ha interrotto, i messaggi dell'assistente della riesecuzione che contengono questi campi contengono anche [`resume_reason`](#resume_reason).

1398 1559

1399`timestamp` è l'ora ISO 8601 quando il contenuto del messaggio ha finito di generarsi sul processo che lo ha prodotto. Il valore proviene dall'orologio di quella macchina, quindi usalo solo per la visualizzazione e non ordinare i messaggi per esso. Un turno API può produrre diversi messaggi dell'assistente che condividono un `message.id`, ciascuno con il proprio `timestamp`. Quando il campo è assente, ricadi al momento in cui hai ricevuto il messaggio.1560`timestamp` è l'ora ISO 8601 quando il contenuto del messaggio ha finito di generarsi sul processo che lo ha prodotto. Il valore proviene dall'orologio di quella macchina, quindi usatelo solo per la visualizzazione e non ordinate i messaggi per esso. Un turno API può produrre diversi messaggi dell'assistente che condividono un `message.id`, ciascuno con il proprio `timestamp`. Quando il campo è assente, ricadete al momento in cui avete ricevuto il messaggio.

1400 1561

1401`context_usage` è una copia strutturata del rapporto `/context`, tipizzata come [`SDKContextUsage`](#sdkcontextusage), e richiede Agent SDK v0.3.232 o successivo. Quando invii `/context` come prompt, Claude Code consegna il rapporto come messaggio dell'assistente il cui `message.content` contiene la tabella markdown, e allega `context_usage` a quello stesso messaggio. Claude Code non imposta il campo su nessun altro messaggio dell'assistente, e le versioni precedenti consegnano la tabella `/context` senza di esso, quindi leggi la suddivisione dal campo quando è presente e ricadi al testo markdown quando non lo è.1562`context_usage` è una copia strutturata del rapporto `/context`, tipizzata come [`SDKContextUsage`](#sdkcontextusage), e richiede Agent SDK v0.3.232 o successivo. Quando inviate `/context` come prompt, Claude Code consegna il rapporto come messaggio dell'assistente il cui `message.content` contiene la tabella markdown, e allega `context_usage` a quello stesso messaggio. Claude Code non imposta il campo su nessun altro messaggio dell'assistente, e le versioni precedenti consegnano la tabella `/context` senza di esso, quindi leggete la suddivisione dal campo quando è presente e ricadete al testo markdown quando non lo è.

1402 1563

1403<h3 id="sdkusermessage">1564<h3 id="sdkusermessage">

1404 `SDKUserMessage`1565 `SDKUserMessage`

1416 parent_tool_use_id: string | null;1577 parent_tool_use_id: string | null;

1417 isSynthetic?: boolean;1578 isSynthetic?: boolean;

1418 shouldQuery?: boolean;1579 shouldQuery?: boolean;

1580 client_composed?: true;

1419 tool_use_result?: unknown;1581 tool_use_result?: unknown;

1420 origin?: SDKMessageOrigin;1582 origin?: SDKMessageOrigin;

1421 inline_pastes?: string[];1583 inline_pastes?: string[];

1422};1584};

1423```1585```

1424 1586

1425Imposta `pasted_content` per inviare contenuto che l'utente ha incollato nella tua interfaccia utente del prompt piuttosto che digitato, una voce per incolla, ciascuna una stringa o un array di blocchi di contenuto. Claude Code aggiunge il testo di ogni voce dopo il testo digitato, in ordine, e può avvolgere ogni incolla in tag `<pasted_content>`. I blocchi diversi dal testo vengono ignorati, quindi invia immagini e documenti in `message.content`. Richiede Agent SDK v0.3.277 o successivo.1587Impostate `pasted_content` per inviare contenuto che l'utente ha incollato nella vostra interfaccia utente del prompt piuttosto che digitato, una voce per incolla, ciascuna una stringa o un array di blocchi di contenuto. Claude Code aggiunge il testo di ogni voce dopo il testo digitato, in ordine, e può avvolgere ogni incolla in tag `<pasted_content>`. I blocchi diversi dal testo vengono ignorati, quindi inviate immagini e documenti in `message.content`. Richiede Agent SDK v0.3.277 o successivo.

1588

1589Impostate `shouldQuery` o `client_composed` per cambiare come Claude Code gestisce un messaggio che inviate:

1426 1590

1427Imposta `shouldQuery` a `false` per aggiungere il messaggio alla trascrizione senza attivare un turno dell'assistente. Il messaggio viene mantenuto e unito al prossimo messaggio utente che attiva un turno. Usa questo per iniettare contesto, come l'output di un comando che hai eseguito fuori banda, senza spendere una chiamata di modello su di esso.1591* `shouldQuery`: impostatelo a `false` per aggiungere il messaggio alla trascrizione senza attivare un turno dell'assistente. Il messaggio viene mantenuto e unito al prossimo messaggio utente che attiva un turno. Usate questo per iniettare contesto, come l'output di un comando che avete eseguito fuori banda, senza spendere una chiamata di modello su di esso.

1592* `client_composed`: impostatelo a `true` per fare in modo che Claude Code consegni il testo del messaggio come scritto. Claude Code allora non espande le menzioni `@path` o [`@server:resource`](/docs/it/mcp#use-mcp-resources), e non esegue il testo che inizia con `/` come un comando. Mentre l'opzione [`verbatimPrompts`](#options) è attiva, l'SDK imposta il campo su ogni messaggio. Richiede TypeScript Agent SDK v0.3.280 o successivo e Claude Code v2.1.248 o successivo.

1428 1593

1429Su un messaggio che contiene un blocco `tool_result`, `tool_use_result` è l'oggetto di output strutturato dello strumento piuttosto che il testo inviato al modello. La sua forma dipende dallo strumento denominato dal blocco `tool_use` corrispondente, quindi il campo è tipizzato `unknown`; le forme integrate sono elencate in [Tipi di output dello strumento](#tool-output-types).1594Su un messaggio che contiene un blocco `tool_result`, `tool_use_result` è l'oggetto di output strutturato dello strumento piuttosto che il testo inviato al modello. La sua forma dipende dallo strumento denominato dal blocco `tool_use` corrispondente, quindi il campo è tipizzato `unknown`; le forme integrate sono elencate in [Tipi di output dello strumento](#tool-output-types).

1430 1595

1431Per lo strumento `Agent`, `tool_use_result` è [`AgentOutput`](#agent-2). Su un risultato `completed`, `content` contiene il rapporto del subagente senza l'ID agente e il trailer di utilizzo che Claude Code aggiunge al testo `tool_result`, quindi esegui il rendering da `tool_use_result` invece di analizzare quel testo.1596Per lo strumento `Agent`, `tool_use_result` è [`AgentOutput`](#agent-2). Su un risultato `completed`, `content` contiene il rapporto del subagente senza l'ID agente e il trailer di utilizzo che Claude Code aggiunge al testo `tool_result`, quindi eseguite il rendering da `tool_use_result` invece di analizzare quel testo.

1432 1597

1433Per uno strumento MCP il cui risultato contiene blocchi `resource_link`, `tool_use_result` è un oggetto con un array `resourceLinks` di voci [`SDKMcpResourceLink`](#sdkmcpresourcelink). Claude riceve ogni link come una riga di testo nel blocco `tool_result`, quindi leggi `resourceLinks` per rendere i file che il server ha restituito invece di analizzare quel testo. Claude Code omette `resourceLinks` quando il risultato non ha link e sui risultati dei subagenti, mantiene al massimo 50 link per risultato, e smette di aggiungere link una volta che l'array raggiunge 64 KiB di JSON serializzato. `resourceLinks` richiede Agent SDK v0.3.257 o successivo.1598Per uno strumento MCP il cui risultato contiene blocchi `resource_link`, `tool_use_result` è un oggetto con un array `resourceLinks` di voci [`SDKMcpResourceLink`](#sdkmcpresourcelink). Claude riceve ogni link come una riga di testo nel blocco `tool_result`, quindi leggete `resourceLinks` per rendere i file che il server ha restituito invece di analizzare quel testo. Claude Code omette `resourceLinks` quando il risultato non ha link e sui risultati dei subagenti, mantiene al massimo 50 link per risultato, e smette di aggiungere link una volta che l'array raggiunge 64 KiB di JSON serializzato. `resourceLinks` richiede Agent SDK v0.3.257 o successivo.

1434 1599

1435Imposta `inline_pastes` per dire a Claude Code quali parti di `message.content` l'utente ha incollato piuttosto che digitato, una stringa per incolla. Il testo del prompt rimane dove l'utente lo ha messo. Claude Code può avvolgere ogni incolla elencata in tag `<pasted_content>` dove si trova, in modo che Claude possa distinguere il materiale incollato dalle parole dell'utente. Solo gli incolla nell'ultimo blocco di testo del prompt vengono avvolti. Richiede TypeScript Agent SDK v0.3.280 o successivo.1600Impostate `inline_pastes` per dire a Claude Code quali parti di `message.content` l'utente ha incollato piuttosto che digitato, una stringa per incolla. Il testo del prompt rimane dove l'utente lo ha messo. Claude Code può avvolgere ogni incolla elencata in tag `<pasted_content>` dove si trova, in modo che Claude possa distinguere il materiale incollato dalle parole dell'utente. Solo gli incolla nell'ultimo blocco di testo del prompt vengono avvolti. Richiede TypeScript Agent SDK v0.3.280 o successivo.

1436 1601

1437<h3 id="sdkusermessagereplay">1602<h3 id="sdkusermessagereplay">

1438 `SDKUserMessageReplay`1603 `SDKUserMessageReplay`

1448 message: MessageParam;1613 message: MessageParam;

1449 parent_tool_use_id: string | null;1614 parent_tool_use_id: string | null;

1450 isSynthetic?: boolean;1615 isSynthetic?: boolean;

1616 client_composed?: true;

1451 tool_use_result?: unknown;1617 tool_use_result?: unknown;

1452 origin?: SDKMessageOrigin;1618 origin?: SDKMessageOrigin;

1453 isReplay: true;1619 isReplay: true;

1454};1620};

1455```1621```

1456 1622

1457Un turno utente iniettato dall'esterno della sessione, uno il cui [`origin`](#sdkmessageorigin) è di tipo `peer` o `channel`, raggiunge il flusso come una riproduzione indipendentemente dal fatto che sia stato consegnato durante un turno attivo o abbia avviato un nuovo turno mentre la sessione era inattiva. Prima della v2.1.207, un turno iniettato consegnato mentre la sessione era inattiva non produceva alcun messaggio sul flusso e appariva solo quando rileggi la trascrizione.1623Un turno utente iniettato dall'esterno della sessione, uno il cui [`origin`](#sdkmessageorigin) è di tipo `peer` o `channel`, raggiunge il flusso come una riproduzione indipendentemente dal fatto che sia stato consegnato durante un turno attivo o abbia avviato un nuovo turno mentre la sessione era inattiva. Prima della v2.1.207, un turno iniettato consegnato mentre la sessione era inattiva non produceva alcun messaggio sul flusso e appariva solo quando rileggevate la trascrizione.

1458 1624

1459<h3 id="sdkresultmessage">1625<h3 id="sdkresultmessage">

1460 `SDKResultMessage`1626 `SDKResultMessage`

1480 ttft_stream_ms?: number;1646 ttft_stream_ms?: number;

1481 user_message_uuid?: string;1647 user_message_uuid?: string;

1482 user_message_uuids?: string[];1648 user_message_uuids?: string[];

1649 resume_reason?: string;

1650 local_command?: string;

1483 request_sent_wall_ms?: number;1651 request_sent_wall_ms?: number;

1484 first_content_frame_ms?: number;1652 first_content_frame_ms?: number;

1485 first_stream_post_ms?: number;1653 first_stream_post_ms?: number;

1493 structured_output?: unknown;1661 structured_output?: unknown;

1494 deferred_tool_use?: { id: string; name: string; input: Record<string, unknown> };1662 deferred_tool_use?: { id: string; name: string; input: Record<string, unknown> };

1495 terminal_reason?: TerminalReason;1663 terminal_reason?: TerminalReason;

1664 result_index?: number;

1496 fast_mode_state?: FastModeState;1665 fast_mode_state?: FastModeState;

1497 fast_mode_disabled_reason?: FastModeDisabledReason;1666 fast_mode_disabled_reason?: FastModeDisabledReason;

1498 origin?: SDKMessageOrigin;1667 origin?: SDKMessageOrigin;

1520 startup_failure_reason?: SDKStartupFailureReason;1689 startup_failure_reason?: SDKStartupFailureReason;

1521 user_message_uuid?: string;1690 user_message_uuid?: string;

1522 user_message_uuids?: string[];1691 user_message_uuids?: string[];

1692 resume_reason?: string;

1523 terminal_reason?: TerminalReason;1693 terminal_reason?: TerminalReason;

1694 result_index?: number;

1524 fast_mode_state?: FastModeState;1695 fast_mode_state?: FastModeState;

1525 fast_mode_disabled_reason?: FastModeDisabledReason;1696 fast_mode_disabled_reason?: FastModeDisabledReason;

1526 origin?: SDKMessageOrigin;1697 origin?: SDKMessageOrigin;

1532* `api_error_status`: il codice di stato HTTP dell'errore API che ha terminato la conversazione. Assente o `null` quando il turno è terminato senza un errore API.1703* `api_error_status`: il codice di stato HTTP dell'errore API che ha terminato la conversazione. Assente o `null` quando il turno è terminato senza un errore API.

1533* `ttft_ms`: tempo al primo token in millisecondi, misurato quando arriva il primo messaggio dell'assistente completo. Presente solo sul ramo di successo.1704* `ttft_ms`: tempo al primo token in millisecondi, misurato quando arriva il primo messaggio dell'assistente completo. Presente solo sul ramo di successo.

1534* `ttft_stream_ms`: tempo in millisecondi fino al primo evento di flusso `message_start`, quando il flusso di risposta si apre. Inferiore a `ttft_ms`; il divario tra i due è il tempo impiegato per lo streaming del primo messaggio. Presente solo sul ramo di successo.1705* `ttft_stream_ms`: tempo in millisecondi fino al primo evento di flusso `message_start`, quando il flusso di risposta si apre. Inferiore a `ttft_ms`; il divario tra i due è il tempo impiegato per lo streaming del primo messaggio. Presente solo sul ramo di successo.

1535* `user_message_uuid`: l'`uuid` del messaggio che hai inviato a cui questo turno ha risposto. Vedi [`user_message_uuid`](#user_message_uuid) per quali risultati lo contengono.1706* `user_message_uuid`: l'`uuid` del messaggio che avete inviato a cui questo turno ha risposto. Vedi [`user_message_uuid`](#user_message_uuid) per quali risultati lo contengono.

1536* `user_message_uuids`: gli `uuid` di ogni messaggio che hai inviato a cui Claude Code ha risposto in questo turno. Vedi [`user_message_uuids`](#user_message_uuids).1707* `user_message_uuids`: gli `uuid` di ogni messaggio che avete inviato a cui Claude Code ha risposto in questo turno. Vedi [`user_message_uuids`](#user_message_uuids).

1708* `resume_reason`: il motivo per cui Claude Code ha rieseguito questo turno dopo un riavvio che lo ha interrotto. Presente su entrambi i rami, e solo su tale riesecuzione. Vedi [`resume_reason`](#resume_reason).

1709* `local_command`: il nome del comando che il turno ha inviato, sul risultato di successo di un turno che un comando ha completato senza entrare nel ciclo dell'agente, come `/compact`. Il nome è piegato a lettere minuscole e trattini bassi, quindi `/reload-plugins` segnala `reload_plugins`. Un comando che un server MCP fornisce, e il `/mcp` integrato, segnalano `mcp`. Un comando che avete definito voi stessi segnala `custom`. Gli argomenti non sono mai inclusi. Assente su ogni turno che è entrato nel ciclo dell'agente e su invii che non hanno eseguito alcun comando. Richiede Agent SDK v0.3.268 o successivo.

1537* `request_sent_wall_ms`: millisecondi di epoca in cui Claude Code ha inviato la richiesta API, per join rispetto ai timestamp lato server. Presente solo insieme a [`user_message_uuid`](#user_message_uuid), su un risultato di successo con `is_error` false il cui turno ha inviato una richiesta API.1710* `request_sent_wall_ms`: millisecondi di epoca in cui Claude Code ha inviato la richiesta API, per join rispetto ai timestamp lato server. Presente solo insieme a [`user_message_uuid`](#user_message_uuid), su un risultato di successo con `is_error` false il cui turno ha inviato una richiesta API.

1538* `first_content_frame_ms`: tempo in millisecondi fino al primo evento di flusso `content_block_start` o `content_block_delta`, contando i blocchi di pensiero come contenuto. Presente sul ramo di successo solo, quando `is_error` è false. Richiede Agent SDK v0.3.260 o successivo.1711* `first_content_frame_ms`: tempo in millisecondi fino al primo evento di flusso `content_block_start` o `content_block_delta`, contando i blocchi di pensiero come contenuto. Presente sul ramo di successo solo, quando `is_error` è false. Richiede Agent SDK v0.3.260 o successivo.

1539* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: tempi per il caricamento del primo evento di flusso del turno. Claude Code li registra solo nelle sessioni che trasmette a claude.ai, come [sessioni cloud](/docs/it/claude-code-on-the-web), e i risultati che `query()` produce non li contengono. Richiede Agent SDK v0.3.260 o successivo.1712* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: tempi per il caricamento del primo evento di flusso del turno. Claude Code li registra solo nelle sessioni che trasmette a claude.ai, come [sessioni cloud](/docs/it/claude-code-on-the-web), e i risultati che `query()` produce non li contengono. Richiede Agent SDK v0.3.260 o successivo.

1540* `usage`: solo ciclo agente principale. Esclude le chiamate di subagente e modello ausiliario, ed è per turno nelle sessioni di input in streaming. Preferisci `modelUsage` per la contabilità di token/costo.1713* `usage`: solo ciclo agente principale. Esclude le chiamate di subagente e modello ausiliario, ed è per turno nelle sessioni di input in streaming. Preferite `modelUsage` per la contabilità di token/costo.

1541* `modelUsage`: totali per modello per ogni chiamata di modello effettuata attraverso la pipeline di query durante questa chiamata `query()`, incluso il ciclo principale, i subagenti e le chiamate interne come la compattazione e gli agenti Workflow. Le chiamate helper al di fuori di quella pipeline, come il classificatore di autorizzazione e le richieste di conteggio dei token, sono escluse. Una chiamata che riprende una sessione conta anche i [totali per modello ripristinati dalle chiamate precedenti della sessione](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Nelle sessioni di input in streaming i totali sono cumulativi tra i turni, quindi leggi il risultato più recente piuttosto che sommare tra i risultati. Vedi [Traccia i costi in modalità input in streaming](/docs/it/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) per i reset e [Recupera i totali dopo un arresto anomalo della sessione](/docs/it/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) per i risultati azzerati.1714* `modelUsage`: totali per modello per ogni chiamata di modello effettuata attraverso la pipeline di query durante questa chiamata `query()`, incluso il ciclo principale, i subagenti e le chiamate interne come la compattazione e gli agenti Workflow. Le chiamate helper al di fuori di quella pipeline, come il classificatore di autorizzazione e le richieste di conteggio dei token, sono escluse. Una chiamata che riprende una sessione conta anche i [totali per modello ripristinati dalle chiamate precedenti della sessione](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Nelle sessioni di input in streaming i totali sono cumulativi tra i turni, quindi leggete il risultato più recente piuttosto che sommare tra i risultati. Vedi [Traccia i costi in modalità input in streaming](/docs/it/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) per i reset e [Recupera i totali dopo un arresto anomalo della sessione](/docs/it/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) per i risultati azzerati.

1542* `total_cost_usd`: costo stimato cumulativo in USD, coprendo le stesse chiamate di `modelUsage` e reset negli stessi punti. Una chiamata che riprende una sessione conta anche i [totali ripristinati dalle chiamate precedenti della sessione](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). È una stima, non un estratto conto di fatturazione. Vedi [Traccia costo e utilizzo](/docs/it/agent-sdk/cost-tracking) per le avvertenze di accuratezza.1715* `total_cost_usd`: costo stimato cumulativo in USD, coprendo le stesse chiamate di `modelUsage` e reset negli stessi punti. Una chiamata che riprende una sessione conta anche i [totali ripristinati dalle chiamate precedenti della sessione](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). È una stima, non un estratto conto di fatturazione. Vedi [Traccia costo e utilizzo](/docs/it/agent-sdk/cost-tracking) per le avvertenze di accuratezza.

1543* `queued_turn_count`: il numero di messaggi che hai inviato con `origin: { kind: "human" }` che sono ancora in attesa quando Claude Code ha prodotto il risultato. Vedi [`queued_turn_count`](#queued_turn_count) per cosa significano `0` e un campo assente.1716* `queued_turn_count`: il numero di messaggi che avete inviato con `origin: { kind: "human" }` che sono ancora in attesa quando Claude Code ha prodotto il risultato. Vedi [`queued_turn_count`](#queued_turn_count) per cosa significano `0` e un campo assente.

1717* `result_index`: dove questo risultato cade nell'ordine di consegna dell'esecuzione, contando da 0 su ogni risultato che il processo scrive. Presente su entrambi i rami. Un risultato la cui scrittura fallisce consuma comunque il suo numero, quindi un divario nella sequenza significa che un risultato è stato perso. Richiede Agent SDK v0.3.268 o successivo.

1544* `startup_failure_reason`: il motivo per cui Claude Code ha rifiutato di avviarsi, sul risultato `error_during_execution` che scrive prima di uscire su un errore di avvio noto. Vedi [`startup_failure_reason`](#startup_failure_reason) per i valori e quali errori lo contengono. Richiede Agent SDK v0.3.274 o successivo.1718* `startup_failure_reason`: il motivo per cui Claude Code ha rifiutato di avviarsi, sul risultato `error_during_execution` che scrive prima di uscire su un errore di avvio noto. Vedi [`startup_failure_reason`](#startup_failure_reason) per i valori e quali errori lo contengono. Richiede Agent SDK v0.3.274 o successivo.

1545* `terminal_reason`: il motivo per cui il ciclo è terminato. Uno di `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"`, o `"turn_setup_failed"`.1719* `terminal_reason`: il motivo per cui il ciclo è terminato. Uno di `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"`, o `"turn_setup_failed"`.

1546* `fast_mode_state`: uno di `"on"`, `"off"`, o `"cooldown"`.1720* `fast_mode_state`: uno di `"on"`, `"off"`, o `"cooldown"`.

1547* `fast_mode_disabled_reason`: il motivo per cui [fast mode](/docs/it/fast-mode) non è disponibile in questo momento. Assente quando nulla blocca fast mode, anche se una richiesta potrebbe comunque essere eseguita a velocità standard. Durante il cooldown dopo un limite di velocità fast mode, Claude Code segnala `fast_mode_state: "cooldown"` senza codice di motivo e riabilita fast mode quando il cooldown scade. Richiede Claude Code v2.1.219 o successivo.1721* `fast_mode_disabled_reason`: il motivo per cui [fast mode](/docs/it/fast-mode) non è disponibile in questo momento. Assente quando nulla blocca fast mode, anche se una richiesta potrebbe comunque essere eseguita a velocità standard. Durante il cooldown dopo un limite di velocità fast mode, Claude Code segnala `fast_mode_state: "cooldown"` senza codice di motivo e riabilita fast mode quando il cooldown scade. Richiede Claude Code v2.1.219 o successivo.

1548 1722

1549Usa il codice di motivo per spiegare perché fast mode è disattivato nella tua interfaccia utente invece di derivare nuovamente la disponibilità. Ogni codice nomina il controllo che ha bloccato fast mode:1723Usate il codice di motivo per spiegare perché fast mode è disattivato nella vostra interfaccia utente invece di derivare nuovamente la disponibilità. Ogni codice nomina il controllo che ha bloccato fast mode:

1550 1724

1551| Codice di motivo | Significato |1725| Codice di motivo | Significato |

1552| - | - |1726| - | - |

1560| `model_not_allowed` | Il modello Opus fast mode non è nella lista di autorizzazione [`availableModels`](/docs/it/model-config#restrict-model-selection) dell'organizzazione |1734| `model_not_allowed` | Il modello Opus fast mode non è nella lista di autorizzazione [`availableModels`](/docs/it/model-config#restrict-model-selection) dell'organizzazione |

1561| `sdk_opt_in_required` | La sessione non ha acconsentito a fast mode: passa `fastMode: true` nell'opzione [`settings`](#options) o tramite [`applyFlagSettings()`](#applyflagsettings) |1735| `sdk_opt_in_required` | La sessione non ha acconsentito a fast mode: passate `fastMode: true` nell'opzione [`settings`](#options) o tramite [`applyFlagSettings()`](#applyflagsettings) |

1563 1737

1564La stessa coppia di campi appare su [`SDKSystemMessage`](#sdksystemmessage) e su [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse), quindi puoi leggere lo stato fast mode prima del primo turno.1738La stessa coppia di campi appare su [`SDKSystemMessage`](#sdksystemmessage) e su [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse), quindi potete leggere lo stato fast mode prima del primo turno.

1565 1739

1566Il campo `origin` inoltro l'[`SDKMessageOrigin`](#sdkmessageorigin) del messaggio utente che ha attivato questo risultato. Quando l'SDK inietta un turno di follow-up sintetico, come per un'attività finita in background, il `SDKResultMessage` risultante contiene `origin: { kind: "task-notification" }`. Le routine il cui trigger si è attivato e i messaggi verificati dal server dalle tue altre sessioni arrivano con questo tipo anche, ciascuno con il `subkind` descritto in [Subkind di notifica attività](#task-notification-subkinds). Controlla `kind` per distinguere i risultati che rispondono al tuo prompt dai follow-up iniettati prima di instradare o sopprimere questi ultimi. Se la tua applicazione [dichiara esecuzioni programmate](#declare-a-scheduled-run), i loro risultati contengono `kind: "task-notification"` anche, quindi non sopprimere solo su `kind`.1740Il campo `origin` inoltro l'[`SDKMessageOrigin`](#sdkmessageorigin) del messaggio utente che ha attivato questo risultato. Quando l'SDK inietta un turno di follow-up sintetico, come per un'attività finita in background, il `SDKResultMessage` risultante contiene `origin: { kind: "task-notification" }`. Le routine il cui trigger si è attivato e i messaggi verificati dal server dalle vostre altre sessioni arrivano con questo tipo anche, ciascuno con il `subkind` descritto in [Subkind di notifica attività](#task-notification-subkinds). Controllate `kind` per distinguere i risultati che rispondono al vostro prompt dai follow-up iniettati prima di instradare o sopprimere questi ultimi. Se la vostra applicazione [dichiara esecuzioni programmate](#declare-a-scheduled-run), i loro risultati contengono `kind: "task-notification"` anche, quindi non sopprimete solo su `kind`.

1567 1741

1568Quando più completamenti di attività in background sono in coda insieme, Claude Code può rispondere a loro in un turno piuttosto che uno turno ciascuno. Ogni completamento produce comunque il suo risultato con questa origine. Tutti tranne l'ultimo dei completamenti a cui Claude Code risponde insieme producono risultati vuoti con `num_turns: 0`, in ordine, e il risultato dell'ultimo contiene il turno che risponde a tutti loro.1742Quando più completamenti di attività in background sono in coda insieme, Claude Code può rispondere a loro in un turno piuttosto che uno turno ciascuno. Ogni completamento produce comunque il suo risultato con questa origine. Tutti tranne l'ultimo dei completamenti a cui Claude Code risponde insieme producono risultati vuoti con `num_turns: 0`, in ordine, e il risultato dell'ultimo contiene il turno che risponde a tutti loro.

1569 1743

1570Il campo è assente per i risultati emessi prima di qualsiasi turno utente, come gli errori di avvio.1744Il campo è assente per i risultati emessi prima di qualsiasi turno utente, come gli errori di avvio.

1571 1745

1572Quando un hook `PreToolUse` restituisce `permissionDecision: "defer"`, il risultato ha `stop_reason: "tool_deferred"` e `deferred_tool_use` contiene l'`id`, il `name` e l'`input` del tool in sospeso. Leggi questo campo per visualizzare la richiesta nella tua interfaccia utente, quindi riprendi con lo stesso `session_id` per continuare. Vedi [Rinvia una chiamata di tool per dopo](/docs/it/hooks#defer-a-tool-call-for-later) per il percorso completo.1746Quando un hook `PreToolUse` restituisce `permissionDecision: "defer"`, il risultato ha `stop_reason: "tool_deferred"` e `deferred_tool_use` contiene l'`id`, il `name` e l'`input` del tool in sospeso. Leggete questo campo per visualizzare la richiesta nella vostra interfaccia utente, quindi riprendete con lo stesso `session_id` per continuare. Vedi [Rinvia una chiamata di tool per dopo](/docs/it/hooks#defer-a-tool-call-for-later) per il percorso completo.

1573 1747

1574<h4 id="user_message_uuid">1748<h4 id="user_message_uuid">

1575 `user_message_uuid`1749 `user_message_uuid`

1576</h4>1750</h4>

1577 1751

1578L'`uuid` del [`SDKUserMessage`](#sdkusermessage) a cui il turno sta rispondendo, ripetuto in modo da poter abbinare la risposta di Claude Code al messaggio che hai inviato. Claude Code ripete un `uuid` solo se ne hai impostato uno sul messaggio. Il campo è facoltativo su `SDKUserMessage`, e un prompt di stringa passato a `query()` non ne contiene nessuno.1752L'`uuid` del [`SDKUserMessage`](#sdkusermessage) a cui il turno sta rispondendo, ripetuto in modo da poter abbinare la risposta di Claude Code al messaggio che avete inviato. Claude Code ripete un `uuid` solo se ne avete impostato uno sul messaggio. Il campo è facoltativo su `SDKUserMessage`, e un prompt di stringa passato a `query()` non ne contiene nessuno.

1579 1753

1580Quale dei tuoi messaggi un turno risponde dipende da come il turno è iniziato:1754Quale dei vostri messaggi un turno risponde dipende da come il turno è iniziato:

1581 1755

1582* **Un messaggio regolare che hai inviato**, cioè uno senza `isSynthetic: true`: il turno risponde a quel messaggio per tutta la sua esecuzione. Quando invii diversi messaggi uno dopo l'altro, Claude Code può unirli in un turno, e il campo contiene solo l'`uuid` dell'ultimo messaggio. Per abbinare la risposta a uno qualsiasi dei messaggi uniti, usa [`user_message_uuids`](#user_message_uuids).1756* **Un messaggio regolare che avete inviato**, cioè uno senza `isSynthetic: true`: il turno risponde a quel messaggio per tutta la sua esecuzione. Quando inviate diversi messaggi uno dopo l'altro, Claude Code può unirli in un turno, e il campo contiene solo l'`uuid` dell'ultimo messaggio. Per abbinare la risposta a uno qualsiasi dei messaggi uniti, usate [`user_message_uuids`](#user_message_uuids).

1583* **Un messaggio che hai inviato con `isSynthetic: true`**: il turno risponde a quel messaggio all'inizio. Se Claude Code raccoglie un messaggio regolare tuo tra le chiamate di tool, il turno risponde al messaggio raccolto da allora in poi. L'eco di un `uuid` di messaggio sintetico richiede Agent SDK v0.3.265 o successivo; le versioni precedenti non ecolano nulla sui turni sintetici.1757* **Un messaggio che avete inviato con `isSynthetic: true`**: il turno risponde a quel messaggio all'inizio. Se Claude Code raccoglie un messaggio regolare vostro tra le chiamate di tool, il turno risponde al messaggio raccolto da allora in poi. L'eco di un `uuid` di messaggio sintetico richiede Agent SDK v0.3.265 o successivo; le versioni precedenti non ecolano nulla sui turni sintetici.

1584* **Un prompt che Claude Code ha generato da solo**, come il turno che continua il lavoro interrotto dopo il riavvio di una sessione: il turno non risponde a nessun messaggio tuo all'inizio e i suoi frame non contengono alcun eco. Se Claude Code raccoglie un messaggio regolare tuo tra le chiamate di tool, il turno risponde a quel messaggio da allora in poi. L'eco di raccolta richiede Agent SDK v0.3.265 o successivo; le versioni precedenti non ecolano nulla su questi turni.1758* **Il prompt che Claude Code genera per rieseguire un turno interrotto sotto [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/it/env-vars)**: quando l'ultimo prompt del turno interrotto è un messaggio regolare che avete inviato, indipendentemente dal fatto che abbia aperto il turno o Claude Code lo abbia raccolto durante il turno, la riesecuzione risponde a quel messaggio all'inizio. [`resume_reason`](#resume_reason) dice i frame della riesecuzione dal tentativo interrotto. Quando l'ultimo prompt non è un messaggio regolare vostro, la riesecuzione non risponde a nessun messaggio vostro all'inizio. Se Claude Code raccoglie un messaggio regolare vostro tra le chiamate di tool, il turno risponde al messaggio raccolto da allora in poi. L'eco del prompt del turno interrotto richiede Agent SDK v0.3.268 o successivo.

1759* **Qualsiasi altro prompt che Claude Code ha generato da solo**: il turno non risponde a nessun messaggio vostro all'inizio e i suoi frame non contengono alcun eco. Se Claude Code raccoglie un messaggio regolare vostro tra le chiamate di tool, il turno risponde a quel messaggio da allora in poi. L'eco di raccolta richiede Agent SDK v0.3.265 o successivo; le versioni precedenti non ecolano nulla su questi turni.

1585 1760

1586Claude Code ripete l'`uuid` del messaggio a cui ha risposto su tre tipi di frame:1761Claude Code ripete l'`uuid` del messaggio a cui ha risposto su tre tipi di frame:

1587 1762

1588* **Il risultato**: ogni risultato di un turno che ha risposto a un messaggio che hai inviato. Ogni tale risultato lo contiene su Agent SDK v0.3.265 o successivo. Prima della v0.3.265, il risultato di successo di un turno che un messaggio regolare ha avviato non lo conteneva quando il turno non ha inviato alcuna richiesta API o è terminato con una chiamata di tool differita. Prima della v0.3.246, anche i risultati di errore non lo contenevano, e prima della v0.3.216 ogni risultato non lo conteneva.1763* **Il risultato**: ogni risultato di un turno che ha risposto a un messaggio che avete inviato. Ogni tale risultato lo contiene su Agent SDK v0.3.265 o successivo. Prima della v0.3.265, il risultato di successo di un turno che un messaggio regolare ha avviato non lo conteneva quando il turno non ha inviato alcuna richiesta API o è terminato con una chiamata di tool differita. Prima della v0.3.246, anche i risultati di errore non lo contenevano, e prima della v0.3.216 ogni risultato non lo conteneva.

1589* **La prima risposta del turno**: il primo [messaggio dell'assistente](#sdkassistantmessage), o con `includePartialMessages` il primo [evento di flusso](#sdkpartialassistantmessage) il cui `event.type` non è `ping`, in modo da poter associare la risposta prima che il risultato arrivi. Quando un turno non trasmette nulla, Claude Code lo imposta sul primo messaggio dell'assistente. L'eco della prima risposta richiede Agent SDK v0.3.246 o successivo. Quando il messaggio a cui il turno sta rispondendo cambia a metà turno, la prima risposta dopo il cambio contiene il campo anche, su Agent SDK v0.3.265 o successivo; le versioni precedenti lo impostano su un frame di risposta per turno.1764* **La prima risposta del turno**: il primo [messaggio dell'assistente](#sdkassistantmessage), o con `includePartialMessages` il primo [evento di flusso](#sdkpartialassistantmessage) il cui `event.type` non è `ping`, in modo da poter associare la risposta prima che il risultato arrivi. Quando un turno non trasmette nulla, Claude Code lo imposta sul primo messaggio dell'assistente. L'eco della prima risposta richiede Agent SDK v0.3.246 o successivo. Quando il messaggio a cui il turno sta rispondendo cambia a metà turno, la prima risposta dopo il cambio contiene il campo anche, su Agent SDK v0.3.265 o successivo; le versioni precedenti lo impostano su un frame di risposta per turno.

1590* **Ogni frame [`thinking_tokens`](#sdkthinkingtokensmessage) del turno**: in modo da poter attribuire il progresso del pensiero al messaggio che hai inviato senza aspettare la prima risposta del turno. Richiede Agent SDK v0.3.260 o successivo.1765* **Ogni frame [`thinking_tokens`](#sdkthinkingtokensmessage) del turno**: in modo da poter attribuire il progresso del pensiero al messaggio che avete inviato senza aspettare la prima risposta del turno. Richiede Agent SDK v0.3.260 o successivo.

1591 1766

1592Claude Code omette il campo in questi casi:1767Claude Code omette il campo in questi casi:

1593 1768

1594* Frame di risposta diversi da quelle prime risposte1769* Frame di risposta diversi da quelle prime risposte

1595* Frame di subagente1770* Frame di subagente

1596* Turni che non rispondono a nessun messaggio con un `uuid`: il turno ha risposto a un messaggio che hai inviato senza uno, o Claude Code ha avviato il turno stesso e non ha raccolto nessun messaggio regolare che ne ha uno1771* Turni che non rispondono a nessun messaggio di vostri, o rispondono a un messaggio che avete inviato senza un `uuid`

1597* Risultati che non rispondono a nessun messaggio che hai inviato, come il risultato azzerato dopo un arresto anomalo del processo worker1772* Risultati che non rispondono a nessun messaggio che avete inviato, come il risultato azzerato dopo un arresto anomalo del processo worker

1598 1773

1599<h4 id="user_message_uuids">1774<h4 id="user_message_uuids">

1600 `user_message_uuids`1775 `user_message_uuids`

1601</h4>1776</h4>

1602 1777

1603Gli `uuid` di ogni messaggio che hai inviato a cui Claude Code ha risposto in questo turno. Quando invii diversi messaggi uno dopo l'altro, Claude Code può unirli in un turno, e `user_message_uuid` nomina solo l'ultimo di essi. Per abbinare la risposta a uno qualsiasi dei messaggi uniti, cerca l'`uuid` di quel messaggio ovunque in questo elenco. Richiede Agent SDK v0.3.259 o successivo.1778Gli `uuid` di ogni messaggio che avete inviato a cui Claude Code ha risposto in questo turno. Quando inviate diversi messaggi uno dopo l'altro, Claude Code può unirli in un turno, e `user_message_uuid` nomina solo l'ultimo di essi. Per abbinare la risposta a uno qualsiasi dei messaggi uniti, cercate l'`uuid` di quel messaggio ovunque in questo elenco. Richiede Agent SDK v0.3.259 o successivo.

1604 1779

1605Claude Code imposta l'elenco insieme a `user_message_uuid` su ogni frame di risposta che contiene quel campo e sul risultato. Per l'insieme completo di frame che contengono `user_message_uuid`, e la versione che ciascuno richiede, vedi [`user_message_uuid`](#user_message_uuid). L'elenco contiene sempre `user_message_uuid` e contiene al massimo 64 voci.1780Claude Code imposta l'elenco insieme a `user_message_uuid` su ogni frame di risposta che contiene quel campo e sul risultato. Per l'insieme completo di frame che contengono `user_message_uuid`, e la versione che ciascuno richiede, vedi [`user_message_uuid`](#user_message_uuid). L'elenco contiene sempre `user_message_uuid` e contiene al massimo 64 voci.

1606 1781

1607Quando Claude Code raccoglie un messaggio regolare che hai inviato mentre un turno era in esecuzione, aggiunge l'`uuid` di quel messaggio all'elenco del risultato.1782Quando Claude Code raccoglie un messaggio regolare che avete inviato mentre un turno era in esecuzione, aggiunge l'`uuid` di quel messaggio all'elenco del risultato.

1783

1784Quando una prima risposta o un risultato contiene `user_message_uuid` senza l'elenco, proviene da una versione precedente di Claude Code, quindi ricadete al campo singolo.

1785

1786<h4 id="resume_reason">

1787 `resume_reason`

1788</h4>

1789

1790Il motivo per cui Claude Code ha rieseguito questo turno dopo un riavvio. Claude Code imposta questo campo su un turno che ha rieseguito sotto [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/it/env-vars), in modo da poter dire la risposta e il risultato della riesecuzione dal tentativo interrotto. Richiede Agent SDK v0.3.268 o successivo.

1791

1792Claude Code imposta il campo su due tipi di frame:

1608 1793

1609Quando una prima risposta o un risultato contiene `user_message_uuid` senza l'elenco, proviene da una versione precedente di Claude Code, quindi ricadi al campo singolo.1794* **Il risultato della riesecuzione**: su entrambi i rami di successo e errore, indipendentemente dal fatto che il risultato contenga `user_message_uuid`.

1795* **I frame di risposta della riesecuzione**: quelli che contengono [`user_message_uuid`](#user_message_uuid).

1796

1797Il valore è un token minuscolo breve che nomina il motivo per cui il turno è stato rieseguito, come `interrupted_turn`. Il campo è assente su ogni altro turno.

1610 1798

1611<h4 id="queued_turn_count">1799<h4 id="queued_turn_count">

1612 `queued_turn_count`1800 `queued_turn_count`

1613</h4>1801</h4>

1614 1802

1615Il numero di messaggi che hai inviato con [`origin: { kind: "human" }`](#sdkmessageorigin) che sono ancora in attesa nella coda di comando quando Claude Code ha prodotto il risultato. Richiede Agent SDK v0.3.242 o successivo.1803Il numero di messaggi che avete inviato con [`origin: { kind: "human" }`](#sdkmessageorigin) che sono ancora in attesa nella coda di comando quando Claude Code ha prodotto il risultato. Richiede Agent SDK v0.3.242 o successivo.

1616 1804

1617Cosa significano `0` e un campo assente:1805Cosa significano `0` e un campo assente:

1618 1806

1619* **`0`**: Claude Code non conta i messaggi che hai inviato senza quel `origin`, e non conta le notifiche di attività, quindi un turno può comunque seguire.1807* **`0`**: Claude Code non conta i messaggi che avete inviato senza quel `origin`, e non conta le notifiche di attività, quindi un turno può comunque seguire.

1620* **Assente**: il risultato finale che Claude Code emette dopo un arresto anomalo o un errore di avvio fatale omette il campo, e [può contenere totali azzerati](/docs/it/agent-sdk/cost-tracking#recover-totals-after-a-session-crash).1808* **Assente**: il risultato finale che Claude Code emette dopo un arresto anomalo o un errore di avvio fatale omette il campo, e [può contenere totali azzerati](/docs/it/agent-sdk/cost-tracking#recover-totals-after-a-session-crash).

1621 1809

1622<h4 id="startup_failure_reason">1810<h4 id="startup_failure_reason">

1623 `startup_failure_reason`1811 `startup_failure_reason`

1624</h4>1812</h4>

1625 1813

1626Il motivo per cui Claude Code ha rifiutato di avviarsi, in modo che la tua applicazione possa offrire la correzione invece di un nuovo tentativo. Claude Code lo imposta sul risultato `error_during_execution` che scrive prima di uscire su un errore di avvio noto. Quel risultato contiene totali azzerati, e il suo array `errors` contiene lo stesso testo di stderr. Il campo è assente su ogni altro risultato. Richiede Agent SDK v0.3.274 o successivo.1814Il motivo per cui Claude Code ha rifiutato di avviarsi, in modo che la vostra applicazione possa offrire la correzione invece di un nuovo tentativo. Claude Code lo imposta sul risultato `error_during_execution` che scrive prima di uscire su un errore di avvio noto. Quel risultato contiene totali azzerati, e il suo array `errors` contiene lo stesso testo di stderr. Il campo è assente su ogni altro risultato. Richiede Agent SDK v0.3.274 o successivo.

1627 1815

1628Imposta `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` a `1` in [`env`](#options) per ricevere questo risultato per ogni valore `SDKStartupFailureReason`. Senza quella variabile, Claude Code scrive il risultato solo per questi errori, e il resto termina con output stderr, un'uscita non zero, e nessun messaggio di risultato:1816Impostate `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` a `1` in [`env`](#options) per ricevere questo risultato per ogni valore `SDKStartupFailureReason`. Senza quella variabile, Claude Code scrive il risultato solo per questi errori, e il resto termina con output stderr, un'uscita non zero, e nessun messaggio di risultato:

1629 1817

1630* Un resume che Claude Code interrompe perché non può [restituire la sessione al suo worktree](/docs/it/worktrees#the-session-resumes-outside-its-worktree), con `worktree_unverified` o `worktree_resume_refused`. Quella sezione dice quale errore contiene quale valore.1818* Un resume che Claude Code interrompe perché non può [restituire la sessione al suo worktree](/docs/it/worktrees#the-session-resumes-outside-its-worktree), con `worktree_unverified` o `worktree_resume_refused`. Quella sezione dice quale errore contiene quale valore.

1631* Un [`continue`](#options) rifiutato di una conversazione che una sessione in background contiene, con `session_held_by_background`. Per un [`resume`](#options) rifiutato di tale conversazione, Claude Code scrive il risultato solo quando la variabile è impostata.1819* Un [`continue`](#options) rifiutato di una conversazione che una sessione in background contiene, con `session_held_by_background`. Per un [`resume`](#options) rifiutato di tale conversazione, Claude Code scrive il risultato solo quando la variabile è impostata.

1657| `org_pin_api_key_conflict` | Le impostazioni gestite [richiedono un accesso gateway cloud o first-party](/docs/it/authentication#restrict-login-to-your-organization), e una chiave API Anthropic, token di autenticazione, o `apiKeyHelper` è configurato invece |1845| `org_pin_api_key_conflict` | Le impostazioni gestite [richiedono un accesso gateway cloud o first-party](/docs/it/authentication#restrict-login-to-your-organization), e una chiave API Anthropic, token di autenticazione, o `apiKeyHelper` è configurato invece |

1658| `org_verify_failed` | L'organizzazione dell'accesso non ha potuto essere verificata rispetto al pin, ad esempio a causa di un errore di rete o un token revocato |1846| `org_verify_failed` | L'organizzazione dell'accesso non ha potuto essere verificata rispetto al pin, ad esempio a causa di un errore di rete o un token revocato |

1660| `managed_settings_invalid` | Le impostazioni della politica gestita non hanno potuto essere lette, o il pin non nomina alcuna organizzazione |1848| `managed_settings_invalid` | Le impostazioni della politica gestita non hanno potuto essere lette, il pin non nomina alcuna organizzazione, o [le restrizioni di modello gestite](/docs/it/errors#managed-settings-block-the-default-model) non lasciano alcun modello consentito per l'opzione Predefinito |

1661| `remote_settings_required_unavailable` | Le impostazioni gestite che l'organizzazione richiede non hanno potuto essere caricate |1849| `remote_settings_required_unavailable` | Le impostazioni gestite che l'organizzazione richiede non hanno potuto essere caricate |

1663| `gateway_access_denied` | La richiesta di impostazioni gestite al gateway cloud è tornata con un 403, che la [tabella di risoluzione dei problemi](/docs/it/claude-apps-gateway-deploy#troubleshooting) del gateway copre |1851| `gateway_access_denied` | La richiesta di impostazioni gestite al gateway cloud è tornata con un 403, che la [tabella di risoluzione dei problemi](/docs/it/claude-apps-gateway-deploy#troubleshooting) del gateway copre |

1701 output_style: string;1889 output_style: string;

1702 skills: string[];1890 skills: string[];

1703 plugins: { name: string; path: string }[];1891 plugins: { name: string; path: string }[];

1892 plugin_errors?: {

1893 plugin: string;

1894 type: string;

1895 message: string;

1896 path?: string;

1897 }[];

1704 fast_mode_state?: FastModeState;1898 fast_mode_state?: FastModeState;

1705 fast_mode_disabled_reason?: FastModeDisabledReason;1899 fast_mode_disabled_reason?: FastModeDisabledReason;

1710 1904

1711`fast_mode_state` segnala lo stato [fast mode](/docs/it/fast-mode) della sessione. Quando qualcosa blocca fast mode, `fast_mode_disabled_reason` nomina il controllo che lo ha bloccato; il campo richiede Claude Code v2.1.219 o successivo. Per i codici di motivo e i loro significati, vedi [`fast_mode_disabled_reason`](#sdkresultmessage) sul messaggio di risultato.1905`fast_mode_state` segnala lo stato [fast mode](/docs/it/fast-mode) della sessione. Quando qualcosa blocca fast mode, `fast_mode_disabled_reason` nomina il controllo che lo ha bloccato; il campo richiede Claude Code v2.1.219 o successivo. Per i codici di motivo e i loro significati, vedi [`fast_mode_disabled_reason`](#sdkresultmessage) sul messaggio di risultato.

1712 1906

1713`terminal_slash_commands` nomina le voci in `slash_commands` la cui interfaccia è associata al terminale locale, come `exit`. Puoi inviarle come qualsiasi altra voce in `slash_commands`; il campo esiste in modo che un client remoto o mobile possa nasconderle dai suoi menu di comando. Il campo è presente solo quando non vuoto, e richiede Agent SDK v0.3.229 o successivo.1907`terminal_slash_commands` nomina le voci in `slash_commands` la cui interfaccia è associata al terminale locale, come `exit`. Potete inviarle come qualsiasi altra voce in `slash_commands`; il campo esiste in modo che un client remoto o mobile possa nasconderle dai suoi menu di comando. Il campo è presente solo quando non vuoto, e richiede Agent SDK v0.3.229 o successivo.

1714 1908

1715*1909*

1716 1910

1718 1912

1719*1913*

1720 1914

1721`effort`: il [livello di sforzo](/docs/it/model-config#adjust-effort-level) che Claude Code invia sulla prossima richiesta della sessione, o `null` quando non ne invia nessuno. Claude Code imposta il campo solo sul messaggio di init che invia ai client [Remote Control](/docs/it/remote-control), e lo omette dal messaggio di init che la tua applicazione legge. Richiede Agent SDK v0.3.234 o successivo.1915`effort`: il [livello di sforzo](/docs/it/model-config#adjust-effort-level) che Claude Code invia sulla prossima richiesta della sessione, o `null` quando non ne invia nessuno. Claude Code imposta il campo solo sul messaggio di init che invia ai client [Remote Control](/docs/it/remote-control), e lo omette dal messaggio di init che la vostra applicazione legge. Richiede Agent SDK v0.3.234 o successivo.

1722 1916

1723L'array `capabilities` nomina i comportamenti del protocollo che questa CLI implementa, in modo da poter rilevare le funzionalità invece di confrontare le stringhe `claude_code_version`. È un insieme aperto: ignora i valori che non riconosci, e controlla la capacità specifica su cui fai affidamento. Il campo richiede Claude Code v2.1.205 o successivo ed è assente su CLI precedenti.1917L'array `capabilities` nomina i comportamenti del protocollo che questa CLI implementa, in modo da poter rilevare le funzionalità invece di confrontare le stringhe `claude_code_version`. È un insieme aperto: ignorate i valori che non riconoscete, e controllate la capacità specifica su cui fate affidamento. Il campo richiede Claude Code v2.1.205 o successivo ed è assente su CLI precedenti.

1724 1918

1725| Capacità | Significato |1919| Capacità | Significato |

1726| - | - |1920| - | - |

1727| `interrupt_receipt_v1` | [`interrupt()`](#query-object) si risolve con una ricevuta [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) che nomina i messaggi che erano in sospeso quando l'interruzione è arrivata |1921| `interrupt_receipt_v1` | [`interrupt()`](#query-object) si risolve con una ricevuta [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) che nomina i messaggi che erano in sospeso quando l'interruzione è arrivata |

1728| `interrupt_cancel_queued_v1` | La richiesta di controllo `interrupt` onora `cancel_queued: true`, annullando i messaggi che la ricevuta altrimenti elencherebbe sotto `still_queued` e elencandoli sotto `cancelled` invece. Vedi [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Richiede Claude Code v2.1.219 o successivo |1922| `interrupt_cancel_queued_v1` | La richiesta di controllo `interrupt` onora `cancel_queued: true`, annullando i messaggi che la ricevuta altrimenti elencherebbe sotto `still_queued` e elencandoli sotto `cancelled` invece. Vedi [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Richiede Claude Code v2.1.219 o successivo |

1729 1923

1924L'array `plugin_errors` elenca i fallimenti di caricamento del plugin. Una voce descrive un plugin che non ha caricato ed è assente da `plugins`, o un plugin che ha caricato senza una delle sue parti, come il suo file di hooks. La chiave è omessa quando nulla ha fallito. `SDKSystemMessage` dichiara `plugin_errors` in Agent SDK v0.3.283 o successivo.

1925

1926Quando una directory o un archivio dalla vostra opzione [`plugins`](#options) stessa non riesce a caricare, il campo `plugin` della voce contiene un tag posizionale come `inline[0]` invece di un nome di plugin. Questo accade, ad esempio, quando il percorso non esiste o il manifest non è valido. Abbinate tale voce alla vostra opzione dal suo campo `path`.

1927

1928La tabella seguente elenca i campi di ogni voce `plugin_errors`.

1929

1930| Campo | Tipo | Descrizione |

1931| - | - | - |

1932| `plugin` | `string` | L'ID del plugin che fallisce, o un tag posizionale come `inline[0]` quando la directory o l'archivio del plugin stesso non ha caricato |

1933| `type` | `string` | Categoria di errore da un insieme aperto, come `path-not-found` o `manifest-validation-error`. Trattate un valore che non riconoscete come un fallimento generico |

1934| `message` | `string` | Testo di visualizzazione che descrive il fallimento |

1935| `path` | `string` | Presente solo quando la directory o l'archivio del plugin stesso non ha caricato. Il suo percorso assoluto, con un percorso relativo dalla vostra opzione `plugins` risolto rispetto all'opzione [`cwd`](#options) |

1936

1730<h3 id="sdkpartialassistantmessage">1937<h3 id="sdkpartialassistantmessage">

1731 `SDKPartialAssistantMessage`1938 `SDKPartialAssistantMessage`

1732</h3>1939</h3>

1733 1940

1734Messaggio parziale di streaming (solo quando `includePartialMessages` è true). Il campo `parent_tool_use_id` è sempre `null`: gli eventi di flusso vengono emessi solo per la sessione principale. Per l'attribuzione del subagente, utilizza messaggi completi, che contengono `parent_tool_use_id`, o abilita [`forwardSubagentText`](#options) per ricevere il testo e il pensiero del subagente come messaggi completi.1941Messaggio parziale di streaming (solo quando `includePartialMessages` è true). Il campo `parent_tool_use_id` è sempre `null`: gli eventi di flusso vengono emessi solo per la sessione principale. Per l'attribuzione del subagente, utilizzate messaggi completi, che contengono `parent_tool_use_id`, o abilitate [`forwardSubagentText`](#options) per ricevere il testo e il pensiero del subagente come messaggi completi.

1735 1942

1736```typescript theme={null}1943```typescript theme={null}

1737type SDKPartialAssistantMessage = {1944type SDKPartialAssistantMessage = {

1743 ttft_ms?: number; // Tempo al primo token in ms, presente solo negli eventi message_start1950 ttft_ms?: number; // Tempo al primo token in ms, presente solo negli eventi message_start

1744 user_message_uuid?: string;1951 user_message_uuid?: string;

1745 user_message_uuids?: string[];1952 user_message_uuids?: string[];

1953 resume_reason?: string;

1746};1954};

1747```1955```

1748 1956

1749Claude Code imposta `user_message_uuid` e `user_message_uuids` sul primo evento di flusso non-ping del turno, e di nuovo quando il messaggio a cui il turno sta rispondendo cambia, secondo le condizioni in [`user_message_uuid`](#user_message_uuid).1957Claude Code imposta `user_message_uuid` e `user_message_uuids` sul primo evento di flusso non-ping del turno, e di nuovo quando il messaggio a cui il turno sta rispondendo cambia, secondo le condizioni in [`user_message_uuid`](#user_message_uuid). Quando Claude Code riesegue un turno che un riavvio ha interrotto, gli eventi di flusso della riesecuzione che contengono questi campi contengono anche [`resume_reason`](#resume_reason).

1750 1958

1751<h3 id="sdkcompactboundarymessage">1959<h3 id="sdkcompactboundarymessage">

1752 `SDKCompactBoundaryMessage`1960 `SDKCompactBoundaryMessage`

1771 `SDKInformationalMessage`1979 `SDKInformationalMessage`

1772</h3>1980</h3>

1773 1981

1774Banner di testo generico emesso dal ciclo. Contiene righe di stato non di errore, feedback di hook come il motivo del blocco di un hook `UserPromptSubmit`, e output di comando. Su Claude Code v2.1.227 o successivo, il [`systemMessage`](/docs/it/hooks#json-output) di un hook può arrivare come questo messaggio, con ogni riga prefissata dal nome dell'hook, come `PostToolUse:Bash says:`. Se il `systemMessage` di un hook arriva come questo messaggio dipende dall'evento. Ogni [sezione dell'evento](/docs/it/hooks#hook-events) sulla pagina dei hook dice come l'output viene visualizzato. Renderizza `content` come testo semplice al livello specificato.1982Banner di testo generico emesso dal ciclo. Contiene avvisi, avvisi, e altre righe di stato non di errore che Claude Code genera, e feedback di hook come il motivo del blocco di un hook `UserPromptSubmit`.

1983

1984Su Claude Code v2.1.227 o successivo, il [`systemMessage`](/docs/it/hooks#json-output) di un hook può arrivare come questo messaggio, con ogni riga prefissata dal nome dell'hook, come `PostToolUse:Bash says:`. Ogni [sezione dell'evento](/docs/it/hooks#hook-events) sulla pagina dei hook dice come l'output viene visualizzato.

1985

1986Rendete `content` come testo semplice al livello specificato.

1775 1987

1776```typescript theme={null}1988```typescript theme={null}

1777type SDKInformationalMessage = {1989type SDKInformationalMessage = {

1790 `SDKWorkerShuttingDownMessage`2002 `SDKWorkerShuttingDownMessage`

1791</h3>2003</h3>

1792 2004

1793Emesso durante lo spegnimento elegante del worker in modo che i client remoti possano mostrare il motivo per cui il worker se n'è andato invece di aspettare il timeout del battito cardiaco. Il `reason` è una stringa breve in snake\_case impostata dalla CLI host, come `"host_exit"` o `"remote_control_disabled"`. Agisci su questo solo quando stai eseguendo lo streaming in diretta. Una sessione ripresa riproduce le istanze passate di questo messaggio, quindi ignorale in quel caso.2005Emesso durante lo spegnimento elegante del worker in modo che i client remoti possano mostrare il motivo per cui il worker se n'è andato invece di aspettare il timeout del battito cardiaco. Il `reason` è una stringa breve in snake\_case impostata dalla CLI host, come `"host_exit"` o `"remote_control_disabled"`. Agite su questo solo quando state eseguendo lo streaming in diretta. Una sessione ripresa riproduce le istanze passate di questo messaggio, quindi ignoratele in quel caso.

1794 2006

1795```typescript theme={null}2007```typescript theme={null}

1796type SDKWorkerShuttingDownMessage = {2008type SDKWorkerShuttingDownMessage = {

1806 `SDKPluginInstallMessage`2018 `SDKPluginInstallMessage`

1807</h3>2019</h3>

1808 2020

1809Evento di progresso dell'installazione del plugin. Emesso quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/it/env-vars) è impostato, in modo che la tua applicazione Agent SDK possa tracciare l'installazione del plugin del marketplace prima del primo turno. Gli stati `started` e `completed` racchiudono l'installazione complessiva. Gli stati `installed` e `failed` segnalano i singoli marketplace e includono `name`.2021Evento di progresso dell'installazione del plugin. Emesso quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/it/env-vars) è impostato, in modo che la vostra applicazione Agent SDK possa tracciare l'installazione del plugin del marketplace prima del primo turno. Gli stati `started` e `completed` racchiudono l'installazione complessiva. Gli stati `installed` e `failed` segnalano i singoli marketplace e includono `name`.

1810 2022

1811```typescript theme={null}2023```typescript theme={null}

1812type SDKPluginInstallMessage = {2024type SDKPluginInstallMessage = {

1824 `SDKPermissionDeniedMessage`2036 `SDKPermissionDeniedMessage`

1825</h3>2037</h3>

1826 2038

1827Evento di flusso emesso quando il sistema di autorizzazione nega una chiamata di tool senza un prompt interattivo. Usalo per rendere il rifiuto nella tua interfaccia utente mentre accade, piuttosto che osservare solo il risultato del tool `is_error` che segue. Quali rifiuti segnala dipende da come l'esecuzione gestisce i prompt di autorizzazione:2039Evento di flusso emesso quando il sistema di autorizzazione nega una chiamata di tool senza un prompt interattivo. Usatelo per rendere il rifiuto nella vostra interfaccia utente mentre accade, piuttosto che osservare solo il risultato del tool `is_error` che segue. Quali rifiuti segnala dipende da come l'esecuzione gestisce i prompt di autorizzazione:

1828 2040

1829* **Con un callback [`canUseTool`](#canusetool) e il [`permissionPrompts: 'host'`](#options) predefinito**: i prompt di autorizzazione vanno al tuo callback, e questo evento segnala i rifiuti che Claude Code decide da solo senza chiamarlo.2041* **Con un callback [`canUseTool`](#canusetool) e il [`permissionPrompts: 'host'`](#options) predefinito**: i prompt di autorizzazione vanno al vostro callback, e questo evento segnala i rifiuti che Claude Code decide da solo senza chiamarlo.

1830* **Con nessuno dei due**: un'esecuzione `-p` nuda, o `query()` che non imposta né `canUseTool` né `permissionPromptToolName`, nega qualsiasi chiamata di tool che avrebbe richiesto un prompt, e questo evento segnala anche quei rifiuti oltre a quelli che Claude Code decide da solo. Prima della v2.1.223, Claude Code non emetteva questo evento nelle esecuzioni senza un callback.2042* **Con nessuno dei due**: un'esecuzione `-p` nuda, o `query()` che non imposta né `canUseTool` né `permissionPromptToolName`, nega qualsiasi chiamata di tool che avrebbe richiesto un prompt, e questo evento segnala anche quei rifiuti oltre a quelli che Claude Code decide da solo. Prima della v2.1.223, Claude Code non emetteva questo evento nelle esecuzioni senza un callback.

1831* **Con uno strumento di prompt MCP**, impostato con `permissionPromptToolName` o il flag [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags), e il `permissionPrompts: 'host'` predefinito: Claude Code non emette questo evento affatto, nemmeno per i rifiuti di regola che decide da solo.2043* **Con uno strumento di prompt MCP**, impostato con `permissionPromptToolName` o il flag [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags), e il `permissionPrompts: 'host'` predefinito: Claude Code non emette questo evento affatto, nemmeno per i rifiuti di regola che decide da solo.

1832* **Con [`permissionPrompts: 'none'`](#options)**: Claude Code nega le chiamate che avrebbero richiesto un prompt, anche quando `canUseTool` o uno strumento di prompt MCP è anche impostato, e questo evento segnala anche quei rifiuti oltre a quelli che Claude Code decide da solo. Richiede Claude Code v2.1.259 o successivo.2044* **Con [`permissionPrompts: 'none'`](#options)**: Claude Code nega le chiamate che avrebbero richiesto un prompt, anche quando `canUseTool` o uno strumento di prompt MCP è anche impostato, e questo evento segnala anche quei rifiuti oltre a quelli che Claude Code decide da solo. Richiede Claude Code v2.1.259 o successivo.

1918| - | - | - |2130| - | - | - |

1920| `total_tokens` | `number` | La stima di Claude Code dei token in uso. Non limitato alla finestra, quindi può superare `raw_max_tokens` quando la sessione è oltre il limite |2132| `total_tokens` | `number` | La stima di Claude Code dei token in uso. Non limitato alla finestra, quindi può superare `raw_max_tokens` quando la sessione è oltre il limite |

1921| `raw_max_tokens` | `number` | La finestra di contesto del modello, o la [finestra di auto-compattazione](/docs/it/model-config#context-window-and-auto-compaction) inferiore quando una si applica, come una che hai impostato o il limite di 200K che Claude Code applica ad alcuni modelli con una finestra di 1M token. Claude Code misura `total_tokens` rispetto a questa finestra |2133| `raw_max_tokens` | `number` | La finestra di contesto del modello, o la [finestra di auto-compattazione](/docs/it/model-config#context-window-and-auto-compaction) inferiore quando una si applica, come una che avete impostato o il limite di 200K che Claude Code applica ad alcuni modelli con una finestra di 1M token. Claude Code misura `total_tokens` rispetto a questa finestra |

1923| `over_limit` | `object` | Presente solo quando `total_tokens` supera `raw_max_tokens`. `tokens_over` è l'importo in eccesso, e `kind` dice come Claude Code ha risolto la finestra |2135| `over_limit` | `object` | Presente solo quando `total_tokens` supera `raw_max_tokens`. `tokens_over` è l'importo in eccesso, e `kind` dice come Claude Code ha risolto la finestra |

1932* `hard_limit`: la finestra è quella che Claude Code crede sia il limite proprio del modello, oltre il quale l'API rifiuta le richieste2144* `hard_limit`: la finestra è quella che Claude Code crede sia il limite proprio del modello, oltre il quale l'API rifiuta le richieste

1933* `compaction_window`: la finestra è una finestra di politica di compattazione, che può o non può coincidere con il limite del modello2145* `compaction_window`: la finestra è una finestra di politica di compattazione, che può o non può coincidere con il limite del modello

1934 2146

1935Claude Code evolve il tipo in modo additivo, aggiungendo nuovi dati come campi facoltativi piuttosto che rimodellando quelli esistenti. Leggi i campi che conosci e ignora quelli che non riconosci.2147Claude Code evolve il tipo in modo additivo, aggiungendo nuovi dati come campi facoltativi piuttosto che rimodellando quelli esistenti. Leggete i campi che conoscete e ignorate quelli che non riconoscete.

1936 2148

1937<h3 id="sdkcontextusagecategory">2149<h3 id="sdkcontextusagecategory">

1938 `SDKContextUsageCategory`2150 `SDKContextUsageCategory`

1952 2164

1954| - | - | - |2166| - | - | - |

1958 2170

1995 2207

1997| - | - |2209| - | - |

1998| `human` | Input diretto dall'utente finale. Se la tua applicazione inoltro quello che l'utente ha digitato come messaggio utente, imposta il suo `origin` a `{ kind: "human" }` esplicitamente: Claude Code tratta un messaggio utente senza `origin` come non attribuito, e controlla che richiedono un prompt digitato dall'utente, come la [parola chiave del workflow `ultracode`](/docs/it/workflows#ask-for-a-workflow-in-your-prompt), non lo accettano. Prima della v2.1.210, Claude Code trattava un `origin` assente su un messaggio utente come input umano. |2210| `human` | Input diretto dall'utente finale. Se la vostra applicazione inoltro quello che l'utente ha digitato come messaggio utente, impostate il suo `origin` a `{ kind: "human" }` esplicitamente: Claude Code tratta un messaggio utente senza `origin` come non attribuito, e controlla che richiedono un prompt digitato dall'utente, come la [parola chiave del workflow `ultracode`](/docs/it/workflows#ask-for-a-workflow-in-your-prompt), non lo accettano. Prima della v2.1.210, Claude Code trattava un `origin` assente su un messaggio utente come input umano. |

2000| `peer` | Messaggio da un altro agente: un [collega](/docs/it/agent-teams) in-process o un [peer tra sessioni](/docs/it/cross-session-messaging), un'altra delle tue sessioni Claude Code. Vedi [Campi di origine peer](#peer-origin-fields) per la semantica per campo e il modello di fiducia. |2212| `peer` | Messaggio da un altro agente: un [collega](/docs/it/agent-teams) in-process o un [peer tra sessioni](/docs/it/cross-session-messaging), un'altra delle vostre sessioni Claude Code. Vedi [Campi di origine peer](#peer-origin-fields) per la semantica per campo e il modello di fiducia. |

2001| `task-notification` | Turno sintetico iniettato per una consegna che arriva senza un prompt utente fresco, come un'attività finita in background; vedi [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) per quel ramo. Un prompt che la tua applicazione [dichiara come esecuzione programmata](#declare-a-scheduled-run) contiene questo tipo anche. Il `subkind` facoltativo marca cosa ha sollevato la notifica. Vedi [Subkind di notifica attività](#task-notification-subkinds). |2213| `task-notification` | Turno sintetico iniettato per una consegna che arriva senza un prompt utente fresco, come un'attività finita in background; vedi [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) per quel ramo. Un prompt che la vostra applicazione [dichiara come esecuzione programmata](#declare-a-scheduled-run) contiene questo tipo anche. Il `subkind` facoltativo marca cosa ha sollevato la notifica. Vedi [Subkind di notifica attività](#task-notification-subkinds). |

2003| `auto-continuation` | Turno sintetico iniettato quando la sessione continua senza input utente fresco, come un risultato di comando che attiva un prompt di follow-up. |2215| `auto-continuation` | Turno sintetico iniettato quando la sessione continua senza input utente fresco, come un risultato di comando che attiva un prompt di follow-up. |

2004| `unclassified` | Turno iniettato il cui origin non ha potuto essere determinato. Richiede Claude Code v2.1.223 o successivo. Quando Claude Code riceve un [`SDKUserMessage`](#sdkusermessage) con `isSynthetic: true` e non può classificarlo come nessun altro `kind`, imposta questo kind mentre il messaggio arriva e inquadra il turno al modello come una fonte non utente piuttosto che trattarlo come input umano. La tua applicazione non dovrebbe impostare questo valore. |2216| `unclassified` | Turno iniettato il cui origin non ha potuto essere determinato. Richiede Claude Code v2.1.223 o successivo. Quando Claude Code riceve un [`SDKUserMessage`](#sdkusermessage) con `isSynthetic: true` e non può classificarlo come nessun altro `kind`, imposta questo kind mentre il messaggio arriva e inquadra il turno al modello come una fonte non utente piuttosto che trattarlo come input umano. La vostra applicazione non dovrebbe impostare questo valore. |

2005 2217

2006<h3 id="task-notification-subkinds">2218<h3 id="task-notification-subkinds">

2007 Task-notification subkinds2219 Task-notification subkinds

2008</h3>2220</h3>

2009 2221

2010Quando Claude Code consegna una notifica di attività in una sessione, imposta `subkind` sull'`origin` della notifica se i server Anthropic hanno verificato da dove proveniva quella notifica. Imposta anche `subkind` quando la tua applicazione [dichiara il messaggio come esecuzione programmata](#declare-a-scheduled-run) stessa, che richiede TypeScript Agent SDK v0.3.280 o successivo. `subkind` richiede Claude Code v2.1.213 o successivo, e assume uno di due valori:2222Quando Claude Code consegna una notifica di attività in una sessione, imposta `subkind` sull'`origin` della notifica se i server Anthropic hanno verificato da dove proveniva quella notifica. Imposta anche `subkind` quando la vostra applicazione [dichiara il messaggio come esecuzione programmata](#declare-a-scheduled-run) stessa, che richiede TypeScript Agent SDK v0.3.280 o successivo. `subkind` richiede Claude Code v2.1.213 o successivo, e assume uno di due valori:

2011 2223

2012* `scheduled-trigger`: la notifica è il prompt memorizzato di una [routine](/docs/it/routines), consegnato perché uno dei trigger della routine si è attivato: il suo programma, il suo [trigger API](/docs/it/routines#add-an-api-trigger), il suo [trigger GitHub](/docs/it/routines#add-a-github-trigger), o **Esegui ora**. Un prompt che la tua applicazione [dichiara come esecuzione programmata](#declare-a-scheduled-run) contiene questo valore anche. Claude Code inquadra questi al modello come l'attività assegnata della sessione, con un avviso diverso dall'[avviso che altre notifiche di attività contengono](#sdktasknotificationmessage).2224* `scheduled-trigger`: la notifica è il prompt memorizzato di una [routine](/docs/it/routines), consegnato perché uno dei trigger della routine si è attivato: il suo programma, il suo [trigger API](/docs/it/routines#add-an-api-trigger), il suo [trigger GitHub](/docs/it/routines#add-a-github-trigger), o **Esegui ora**. Un prompt che la vostra applicazione [dichiara come esecuzione programmata](#declare-a-scheduled-run) contiene questo valore anche. Claude Code inquadra questi al modello come l'attività assegnata della sessione, con un avviso diverso dall'[avviso che altre notifiche di attività contengono](#sdktasknotificationmessage).

2013*2225*

2014 2226

2015`peer-send-message`: la notifica è un messaggio che un'altra delle tue sessioni ha inviato con lo strumento `send_message` lato server che le sessioni [Claude Code sul web](/docs/it/claude-code-on-the-web) usano per messaggiarsi l'una con l'altra, non lo [strumento `SendMessage` tra sessioni](/docs/it/cross-session-messaging), e i server Anthropic hanno verificato che entrambe le sessioni appartengono allo stesso gruppo privato di sessioni. Richiede Claude Code v2.1.224 o successivo. Una consegna `send_message` che i server non hanno verificato in quel modo non ha `subkind`.2227`peer-send-message`: la notifica è un messaggio che un'altra delle vostre sessioni ha inviato con lo strumento `send_message` lato server che le sessioni [Claude Code sul web](/docs/it/claude-code-on-the-web) usano per messaggiarsi l'una con l'altra, non lo [strumento `SendMessage` tra sessioni](/docs/it/cross-session-messaging), e i server Anthropic hanno verificato che entrambe le sessioni appartengono allo stesso gruppo privato di sessioni. Richiede Claude Code v2.1.224 o successivo. Una consegna `send_message` che i server non hanno verificato in quel modo non ha `subkind`.

2016 2228

2017Ogni altra notifica di attività non ha `subkind`. Questo include [attività PR](/docs/it/claude-code-on-the-web#how-claude-responds-to-pr-activity) consegnate in una sessione e eventi in background come un'attività finita. I messaggi dallo strumento [`SendMessage`](/docs/it/cross-session-messaging) tra sessioni non sono notifiche di attività affatto: che provengano da una sessione sulla stessa macchina o attraverso i server Anthropic da un'altra macchina, Claude Code dà loro `kind: "peer"` e i [campi di origine peer](#peer-origin-fields).2229Ogni altra notifica di attività non ha `subkind`. Questo include [attività PR](/docs/it/claude-code-on-the-web#how-claude-responds-to-pr-activity) consegnate in una sessione e eventi in background come un'attività finita. I messaggi dallo strumento [`SendMessage`](/docs/it/cross-session-messaging) tra sessioni non sono notifiche di attività affatto: che provengano da una sessione sulla stessa macchina o attraverso i server Anthropic da un'altra macchina, Claude Code dà loro `kind: "peer"` e i [campi di origine peer](#peer-origin-fields).

2018 2230

2019`fireReason` dice perché una notifica `scheduled-trigger` si è attivata, come un token minuscolo breve come `scheduled`, `manual`, `retry`, `catch_up`, o `api`. I server Anthropic lo impostano sulle consegne di una [routine](/docs/it/routines), e la tua applicazione lo imposta quando dichiara un'esecuzione programmata. È assente quando nessuno dei due ne ha inviato uno. Richiede TypeScript Agent SDK v0.3.280 o successivo.2231`fireReason` dice perché una notifica `scheduled-trigger` si è attivata, come un token minuscolo breve come `scheduled`, `manual`, `retry`, `catch_up`, o `api`. I server Anthropic lo impostano sulle consegne di una [routine](/docs/it/routines), e la vostra applicazione lo imposta quando dichiara un'esecuzione programmata. È assente quando nessuno dei due ne ha inviato uno. Richiede TypeScript Agent SDK v0.3.280 o successivo.

2020 2232

2021<h4 id="declare-a-scheduled-run">2233<h4 id="declare-a-scheduled-run">

2022 Declare a scheduled run2234 Declare a scheduled run

2023</h4>2235</h4>

2024 2236

2025Se la tua applicazione esegue prompt secondo il suo programma, dichiara ogni esecuzione in modo che Claude Code inquadri il turno al modello come un'attività programmata piuttosto che come input dal vivo dell'utente. Avvia la sessione con `CLAUDE_CODE_HOST_SCHEDULED_RUN` impostato a `1` in [`env`](#options), quindi invia il [`SDKUserMessage`](#sdkusermessage) dell'esecuzione con `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` e senza `isSynthetic`. Claude Code ignora la dichiarazione in un processo avviato senza quella variabile. Ignora anche in un processo il cui ambiente contiene [`CLAUDECODE`](/docs/it/env-vars) o `CLAUDE_CODE_CHILD_SESSION`. Claude Code mantiene `fireReason` solo quando il valore è 1 a 32 lettere minuscole o trattini bassi. Richiede TypeScript Agent SDK v0.3.280 o successivo.2237Se la vostra applicazione esegue prompt secondo il suo programma, dichiarate ogni esecuzione in modo che Claude Code inquadri il turno al modello come un'attività programmata piuttosto che come input dal vivo dell'utente. Avviate la sessione con `CLAUDE_CODE_HOST_SCHEDULED_RUN` impostato a `1` in [`env`](#options), quindi inviate il [`SDKUserMessage`](#sdkusermessage) dell'esecuzione con `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` e senza `isSynthetic`. Claude Code ignora la dichiarazione in un processo avviato senza quella variabile. Ignora anche in un processo il cui ambiente contiene [`CLAUDECODE`](/docs/it/env-vars) o `CLAUDE_CODE_CHILD_SESSION`. Claude Code mantiene `fireReason` solo quando il valore è 1 a 32 lettere minuscole o trattini bassi. Richiede TypeScript Agent SDK v0.3.280 o successivo.

2026 2238

2027<h3 id="peer-origin-fields">2239<h3 id="peer-origin-fields">

2028 Peer origin fields2240 Peer origin fields

2029</h3>2241</h3>

2030 2242

2031Un'origine `peer` identifica quale agente ha inviato il messaggio: un [collega](/docs/it/agent-teams) in-process che invia a `main` con `SendMessage`, o un [peer tra sessioni](/docs/it/cross-session-messaging), un'altra delle tue sessioni Claude Code. I peer tra sessioni richiedono Claude Code v2.1.224 o successivo su macOS e Linux; vedi [disponibilità di messaggistica tra sessioni](/docs/it/cross-session-messaging#availability) per il requisito di Windows nativo. Un peer tra sessioni può essere eseguito sulla stessa macchina, o su [un'altra delle tue macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines) o [Claude Code sul web](/docs/it/claude-code-on-the-web) quando il suo messaggio arriva attraverso Remote Control. I due tipi di mittente riempiono i campi diversamente:2243Un'origine `peer` identifica quale agente ha inviato il messaggio: un [collega](/docs/it/agent-teams) in-process che invia a `main` con `SendMessage`, o un [peer tra sessioni](/docs/it/cross-session-messaging), un'altra delle vostre sessioni Claude Code. I peer tra sessioni richiedono Claude Code v2.1.224 o successivo su macOS e Linux; vedi [disponibilità di messaggistica tra sessioni](/docs/it/cross-session-messaging#availability) per il requisito di Windows nativo. Un peer tra sessioni può essere eseguito sulla stessa macchina, o su [un'altra delle vostre macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines) o [Claude Code sul web](/docs/it/claude-code-on-the-web) quando il suo messaggio arriva attraverso Remote Control. I due tipi di mittente riempiono i campi diversamente:

2032 2244

2033* `from`: il nome del collega, o l'indirizzo del mittente per un peer tra sessioni. Per un [messaggio tra macchine unidirezionale](/docs/it/cross-session-messaging#message-sessions-on-other-machines), il mittente non ha indirizzo di risposta e `from` è `"unknown"`. Il valore è creato dal mittente; `verifiedPeerPid` è l'identità verificata.2245* `from`: il nome del collega, o l'indirizzo del mittente per un peer tra sessioni. Per un [messaggio tra macchine unidirezionale](/docs/it/cross-session-messaging#message-sessions-on-other-machines), il mittente non ha indirizzo di risposta e `from` è `"unknown"`. Il valore è creato dal mittente; `verifiedPeerPid` è l'identità verificata.

2034*2246*

2035 2247

2036`fromMode`: la classe di autorizzazione della sessione di invio, `bypass` o `prompting`, dichiarata da un host che inoltro un messaggio peer tra le tue sessioni, come l'[app desktop](/docs/it/desktop#work-across-sessions). Claude Code lo legge nella sessione ricevente quando applica i [controlli in entrata](/docs/it/cross-session-messaging#control-inbound-messages). Richiede Agent SDK v0.3.234 o successivo.2248`fromMode`: la classe di autorizzazione della sessione di invio, `bypass` o `prompting`, dichiarata da un host che inoltro un messaggio peer tra le vostre sessioni, come l'[app desktop](/docs/it/desktop#work-across-sessions). Claude Code lo legge nella sessione ricevente quando applica i [controlli in entrata](/docs/it/cross-session-messaging#control-inbound-messages). Richiede Agent SDK v0.3.234 o successivo.

2037 2249

2038* `senderTaskId`: l'ID attività del collega. Assente per un peer tra sessioni.2250* `senderTaskId`: l'ID attività del collega. Assente per un peer tra sessioni.

2039*2251*

2042 2254

2043*2255*

2044 2256

2045`body`: il corpo del messaggio decodificato con l'involucro peer rimosso, byte-esatto con quello che il modello vede. Sempre presente per un messaggio di collega; per un peer tra sessioni, presente solo quando il turno è esattamente un involucro peer formato da Claude Code. Renderizza `name` e `body` invece di ri-analizzare il testo del messaggio. Richiede Claude Code v2.1.205 o successivo.2257`body`: il corpo del messaggio decodificato con l'involucro peer rimosso, byte-esatto con quello che il modello vede. Sempre presente per un messaggio di collega; per un peer tra sessioni, presente solo quando il turno è esattamente un involucro peer formato da Claude Code. Rendete `name` e `body` invece di ri-analizzare il testo del messaggio. Richiede Claude Code v2.1.205 o successivo.

2046 2258

2047*2259*

2048 2260

2049`fromSession`: l'ID sessione del mittente apribile dall'host, impostato dall'host del mittente in modo che la tua interfaccia utente possa collegarsi di nuovo alla sessione di invio. Come `from`, è asserito dal mittente: usalo solo come destinazione di navigazione, e non trattarlo come prova dell'identità del mittente. Richiede Claude Code v2.1.216 o successivo.2261`fromSession`: l'ID sessione del mittente apribile dall'host, impostato dall'host del mittente in modo che la vostra interfaccia utente possa collegarsi di nuovo alla sessione di invio. Come `from`, è asserito dal mittente: usatelo solo come destinazione di navigazione, e non trattarlo come prova dell'identità del mittente. Richiede Claude Code v2.1.216 o successivo.

2050 2262

2051*2263*

2052 2264

2053`verifiedPeerPid`: l'ID del processo del processo che si è connesso al socket di messaggistica tra sessioni di questa sessione, verificato dal kernel e letto dalla connessione stessa, mai dal payload. Usalo, non `from`, per identificare il mittente: `from` è falsificabile da qualsiasi processo dello stesso utente. Il campo è assente quando Claude Code non può verificarlo, come su Windows o ingresso non-socket, quindi un valore assente significa che il mittente non è verificato. Per il traffico inoltrato identifica l'inoltro piuttosto che l'autore del messaggio, e gli ID di processo sono riciclabili, quindi trattalo come provenienza piuttosto che come token di autenticazione. Richiede Claude Code v2.1.216 o successivo.2265`verifiedPeerPid`: l'ID del processo del processo che si è connesso al socket di messaggistica tra sessioni di questa sessione, verificato dal kernel e letto dalla connessione stessa, mai dal payload. Usatelo, non `from`, per identificare il mittente: `from` è falsificabile da qualsiasi processo dello stesso utente. Il campo è assente quando Claude Code non può verificarlo, come su Windows o ingresso non-socket, quindi un valore assente significa che il mittente non è verificato. Per il traffico inoltrato identifica l'inoltro piuttosto che l'autore del messaggio, e gli ID di processo sono riciclabili, quindi trattalo come provenienza piuttosto che come token di autenticazione. Richiede Claude Code v2.1.216 o successivo.

2054 2266

2055<h2 id="hook-types">2267<h2 id="hook-types">

2056 Tipi di hook2268 Tipi di hook

2880 Tipi di input dei tool3092 Tipi di input dei tool

2881</h2>3093</h2>

2882 3094

2883Documentazione degli schemi di input per tutti i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk` e possono essere usati per le interazioni dei tool type-safe.3095Documentazione degli schemi di input per tutti i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools` e possono essere usati per le interazioni dei tool type-safe.

2884 3096

2885<h3 id="toolinputschemas">3097<h3 id="toolinputschemas">

2886 `ToolInputSchemas`3098 `ToolInputSchemas`

2887</h3>3099</h3>

2888 3100

2889Unione di tipi di input dei tool esportati da `@anthropic-ai/claude-agent-sdk`; i membri includono:3101Unione di tipi di input dei tool esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools`; i membri includono:

2890 3102

2891```typescript theme={null}3103```typescript theme={null}

2892type ToolInputSchemas =3104type ToolInputSchemas =

3688 Tipi di output dei tool3900 Tipi di output dei tool

3689</h2>3901</h2>

3690 3902

3691Documentazione degli schemi di output per tutti i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk` e rappresentano i dati di risposta effettivi restituiti da ogni tool.3903Documentazione degli schemi di output per tutti i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools` e rappresentano i dati di risposta effettivi restituiti da ogni tool.

3692 3904

3693<h3 id="tooloutputschemas">3905<h3 id="tooloutputschemas">

3694 `ToolOutputSchemas`3906 `ToolOutputSchemas`

3695</h3>3907</h3>

3696 3908

3697Unione di tipi di output dei tool esportati da `@anthropic-ai/claude-agent-sdk`; i membri includono:3909Unione di tipi di output dei tool esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools`; i membri includono:

3698 3910

3699```typescript theme={null}3911```typescript theme={null}

3700type ToolOutputSchemas =3912type ToolOutputSchemas =

5533 `SDKTaskProgressMessage`5745 `SDKTaskProgressMessage`

5534</h3>5746</h3>

5535 5747

5536Emesso periodicamente mentre un subagente o un'attività di background è in esecuzione. Il campo `summary` è popolato solo quando [`agentProgressSummaries`](#options) è abilitato.5748Emesso periodicamente mentre un subagente o un'attività di background è in esecuzione.

5749

5750Per un'attività di subagente, il campo `summary` contiene un riepilogo del progresso generato dal modello ed è popolato solo quando [`agentProgressSummaries`](#options) è abilitato. Per una [chiamata al tool MCP messa in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls), `summary` contiene il progresso più recente segnalato dal server MCP e non dipende da questa opzione.

5537 5751

5538```typescript theme={null}5752```typescript theme={null}

5539type SDKTaskProgressMessage = {5753type SDKTaskProgressMessage = {

5696 5910

5697Emesso quando l'insieme dei comandi disponibili cambia durante la sessione, ad esempio quando Claude Code scopre skill mentre l'agente entra in una sottodirectory. L'array `commands` è l'elenco completo aggiornato, quindi sostituisci qualsiasi elenco di comandi memorizzato nella cache con questo payload. Chiamare [`supportedCommands()`](#query-object) dopo questo messaggio restituisce lo stesso elenco aggiornato, perché il metodo traccia l'ultimo push; questo richiede Agent SDK v0.3.216 o successivo. Nelle versioni SDK precedenti, `supportedCommands()` restituisce lo snapshot acquisito all'inizializzazione e non riflette mai i cambiamenti durante la sessione.5911Emesso quando l'insieme dei comandi disponibili cambia durante la sessione, ad esempio quando Claude Code scopre skill mentre l'agente entra in una sottodirectory. L'array `commands` è l'elenco completo aggiornato, quindi sostituisci qualsiasi elenco di comandi memorizzato nella cache con questo payload. Chiamare [`supportedCommands()`](#query-object) dopo questo messaggio restituisce lo stesso elenco aggiornato, perché il metodo traccia l'ultimo push; questo richiede Agent SDK v0.3.216 o successivo. Nelle versioni SDK precedenti, `supportedCommands()` restituisce lo snapshot acquisito all'inizializzazione e non riflette mai i cambiamenti durante la sessione.

5698 5912

5913Claude Code emette anche questo messaggio quando i [prompt](/docs/it/mcp#use-mcp-prompts-as-commands) di un server MCP si uniscono o lasciano l'elenco, ad esempio quando un server finisce di connettersi dopo l'avvio della sessione. Questo richiede Claude Code v2.1.281 o successivo.

5914

5699```typescript theme={null}5915```typescript theme={null}

5700type SDKCommandsChangedMessage = {5916type SDKCommandsChangedMessage = {

5701 type: "system";5917 type: "system";

5733 new_conversation_id: UUID;5949 new_conversation_id: UUID;

5734 uuid: UUID;5950 uuid: UUID;

5735 session_id: string;5951 session_id: string;

5952 trigger?: "clear" | "plan_mode_exit" | "fresh_session" | "onboarding";

5953 user_message_uuid?: string;

5954 timestamp?: string;

5736};5955};

5737```5956```

5738 5957

5958I campi opzionali descrivono il ripristino:

5959

5960* `trigger`: cosa ha scartato la conversazione. Ripristina la tua trascrizione su ogni messaggio `conversation_reset`, incluso uno in cui questo campo è assente o contiene un valore che non riconosci.

5961* `user_message_uuid`: l'`uuid` del messaggio utente che ha portato il `/clear`. Usalo per abbinare il ripristino a quel messaggio.

5962* `timestamp`: quando è avvenuto il ripristino, come una stringa ISO 8601 in UTC. Usalo per la visualizzazione, non per ordinare i messaggi.

5963

5964I campi `trigger`, `user_message_uuid` e `timestamp` richiedono Claude Code v2.1.281 o successivo.

5965

5739I tipi pubblicati dall'SDK dichiarano `SDKConversationResetMessage` in Claude Code v2.1.203 e successivo. Prima di v2.1.203, `SDKMessage` faceva riferimento al tipo senza dichiararlo, quindi il restringimento su `type === "conversation_reset"` non riusciva a typecheck quando `skipLibCheck` era disabilitato.5966I tipi pubblicati dall'SDK dichiarano `SDKConversationResetMessage` in Claude Code v2.1.203 e successivo. Prima di v2.1.203, `SDKMessage` faceva riferimento al tipo senza dichiararlo, quindi il restringimento su `type === "conversation_reset"` non riusciva a typecheck quando `skipLibCheck` era disabilitato.

5740 5967

5741<h3 id="aborterror">5968<h3 id="aborterror">

5854| `strictAllowlist` | `boolean` | `false` | Nega ai comandi in sandbox l'accesso agli host al di fuori della [lista di autorizzazione della rete](/docs/it/sandboxing#network-isolation) invece di richiedere conferma. Applicato solo ai comandi in sandbox; i tool in-process come WebFetch non sono controllati da esso. Rispettato solo dalle impostazioni utente, gestite o CLI `--settings`; le impostazioni del progetto vengono ignorate. Richiede Claude Code v2.1.219 o successivo |6081| `strictAllowlist` | `boolean` | `false` | Nega ai comandi in sandbox l'accesso agli host al di fuori della [lista di autorizzazione della rete](/docs/it/sandboxing#network-isolation) invece di richiedere conferma. Applicato solo ai comandi in sandbox; i tool in-process come WebFetch non sono controllati da esso. Rispettato solo dalle impostazioni utente, gestite o CLI `--settings`; le impostazioni del progetto vengono ignorate. Richiede Claude Code v2.1.219 o successivo |

5855| `allowManagedDomainsOnly` | `boolean` | `false` | Solo impostazioni gestite. Quando impostato nelle [impostazioni gestite](/docs/it/managed-settings), solo le voci `allowedDomains` e le regole di autorizzazione `WebFetch(domain:...)` dalle impostazioni gestite vengono rispettate, e le voci di autorizzazione dalle impostazioni utente, progetto o locali vengono ignorate. Non ha effetto quando impostato tramite le opzioni SDK |6082| `allowManagedDomainsOnly` | `boolean` | `false` | Solo impostazioni gestite. Quando impostato nelle [impostazioni gestite](/docs/it/managed-settings), solo le voci `allowedDomains` e le regole di autorizzazione `WebFetch(domain:...)` dalle impostazioni gestite vengono rispettate, e le voci di autorizzazione dalle impostazioni utente, progetto o locali vengono ignorate. Dall'SDK, passalo attraverso l'opzione [`managedSettings`](#options) |

agent-sdk/user-input.md +2 −0

Details

296 <Tab title="Approva e ricorda">296 <Tab title="Approva e ricorda">

297 L'utente approva e non vuole essere chiesto di nuovo per questo tipo di chiamata. Il terzo argomento del callback contiene `suggestions`, un array di voci [`PermissionUpdate`](/docs/it/agent-sdk/typescript#permissionupdate) già pronte. Ripeti una di queste in `updatedPermissions` per applicarla. Un suggerimento con la destinazione `localSettings` scrive la regola in `.claude/settings.local.json` in modo che le sessioni future saltino il prompt per le chiamate corrispondenti.297 L'utente approva e non vuole essere chiesto di nuovo per questo tipo di chiamata. Il terzo argomento del callback contiene `suggestions`, un array di voci [`PermissionUpdate`](/docs/it/agent-sdk/typescript#permissionupdate) già pronte. Ripeti una di queste in `updatedPermissions` per applicarla. Un suggerimento con la destinazione `localSettings` scrive la regola in `.claude/settings.local.json` in modo che le sessioni future saltino il prompt per le chiamate corrispondenti.

298 298

299 In TypeScript, salta la scelta di sempre consentire per una richiesta le cui opzioni portano [`suppressAlwaysAllowRule: true`](/docs/it/agent-sdk/typescript#canusetool). L'hint richiede Agent SDK v0.3.268 o successivo, e il `context` Python non lo contiene.

300

299 L'esempio Python richiede `claude-agent-sdk` 0.1.80 o successivo.301 L'esempio Python richiede `claude-agent-sdk` 0.1.80 o successivo.

300 302

301 <CodeGroup>303 <CodeGroup>

agent-teams.md +3 −1

Details

333 Context e comunicazione333 Context e comunicazione

334</h3>334</h3>

335 335

336Ogni compagno di team ha il proprio context window. Quando generato, un compagno di team carica lo stesso contesto di progetto di una sessione regolare: CLAUDE.md, MCP servers e skills. Riceve anche il prompt di generazione dal lead. La cronologia della conversazione del lead non viene trasferita.336Ogni compagno di team ha il proprio context window. Quando generato, un compagno di team carica lo stesso contesto di progetto di una sessione regolare: CLAUDE.md, MCP servers e skills. Se avviate il lead con [`--setting-sources`](/docs/it/cli-reference#cli-flags), i compagni di team caricano dalla stessa lista ristretta di fonti. Prima della v2.1.281, i compagni di team [split-pane](#choose-a-display-mode) caricavano ogni fonte di impostazioni.

337

338Un compagno di team riceve anche il prompt di generazione dal lead. La cronologia della conversazione del lead non viene trasferita.

337 339

338**Come i compagni di team condividono le informazioni:**340**Come i compagni di team condividono le informazioni:**

339 341

agent-view.md +149 −133

Details

260 260

261Premere `←` crea la riga della sessione anche quando la conversazione non ha ancora messaggi, quindi `→` ritorna comunque a essa.261Premere `←` crea la riga della sessione anche quando la conversazione non ha ancora messaggi, quindi `→` ritorna comunque a essa.

262 262

263Puoi disattivare questa scorciatoia con l'impostazione `leftArrowOpensAgents` in `/config`.263Puoi disattivare questa scorciatoia con l'impostazione [`leftArrowOpensAgents`](/docs/it/settings-reference#leftarrowopensagents) in `/config`.

264 264

265<h3 id="organize-the-list">265<h3 id="organize-the-list">

266 Organizzare l'elenco266 Organizzare l'elenco

337`Ctrl+S`, `Ctrl+T`, e `Ctrl+G` seguono il tuo [`keybindings.json`](/docs/it/keybindings). Riassegna o scollega `Ctrl+S` e `Ctrl+T` con le azioni `agents:switchView` e `agents:togglePin` nel contesto [`Agents`](/docs/it/keybindings#agents-actions), e `Ctrl+G` attraverso il binding `chat:externalEditor` del contesto `Chat`. Le altre scorciatoie nella tabella non possono essere riassegnate.337`Ctrl+S`, `Ctrl+T`, e `Ctrl+G` seguono il tuo [`keybindings.json`](/docs/it/keybindings). Riassegna o scollega `Ctrl+S` e `Ctrl+T` con le azioni `agents:switchView` e `agents:togglePin` nel contesto [`Agents`](/docs/it/keybindings#agents-actions), e `Ctrl+G` attraverso il binding `chat:externalEditor` del contesto `Chat`. Le altre scorciatoie nella tabella non possono essere riassegnate.

338 338

339<h2 id="dispatch-new-agents">339<h2 id="dispatch-new-agents">

340 Invia nuovi agenti340 Inviare nuovi agenti

341</h2>341</h2>

342 342

343Puoi inviare nuove sessioni in background da agent view, inviare una sessione interattiva esistente in background, o avviarne una direttamente dalla shell.343Puoi inviare nuove sessioni in background dalla vista agente, inviare o copiare una sessione interattiva esistente in background, oppure avviarne una direttamente dalla shell.

344 344

345<h3 id="from-agent-view">345<h3 id="from-agent-view">

346 Da agent view346 Dalla vista agente

347</h3>347</h3>

348 348

349Digita un prompt nell'input in basso di agent view e premi `Enter` per avviare una nuova sessione in background. La sessione è denominata automaticamente dal prompt; rinominala in seguito con `Ctrl+R`.349Digita un prompt nell'input in fondo alla vista agente e premi `Enter` per avviare una nuova sessione in background. La sessione viene denominata automaticamente dal prompt; rinominala in seguito con `Ctrl+R`.

350 350

351Il nome automatico è un'etichetta breve scritta da un [modello di classe Haiku](/docs/it/model-config). Un nome che la sessione riceve in seguito appare anche sulla sua riga, incluso il [titolo generato](/docs/it/sessions#name-your-sessions) che la sessione ottiene quando [accetti un piano](/docs/it/permission-modes#review-and-approve-a-plan) in quella sessione.351Il nome automatico è un'etichetta breve scritta da un [modello di classe Haiku](/docs/it/model-config). Un nome che la sessione riceve in seguito appare anche sulla sua riga, incluso il [titolo generato](/docs/it/sessions#name-your-sessions) che la sessione riceve quando [accetti un piano](/docs/it/permission-modes#review-and-approve-a-plan) in quella sessione.

352 352

353Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.353Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con l'attività.

354 354

355Il testo incollato più lungo di 800 caratteri o più di tre righe si comprime in un placeholder `[Pasted text #N]` in modo che l'input rimanga su una riga; il testo completo viene inviato quando invii. Per rivedere o modificare il testo compresso prima di inviare, incolla lo stesso testo di nuovo e il placeholder si espande di nuovo nell'input.355Il testo incollato più lungo di 800 caratteri o più di tre righe si comprime in un placeholder `[Pasted text #N]` in modo che l'input rimanga su una riga; il testo completo viene inviato quando invii. Per rivedere o modificare il testo compresso prima di inviare, incolla lo stesso testo di nuovo e il placeholder si espande di nuovo nell'input.

356 356

357Prefissa o menziona parti del prompt per controllare come la sessione inizia:357Prefissa o menziona parti del prompt per controllare come inizia la sessione:

358 358

359| Input | Effetto |359| Input | Effetto |

360| :- | :- |360| :- | :- |

361| `<agent-name> <prompt>` | Se la prima parola corrisponde a un nome di [subagent](/docs/it/sub-agents) personalizzato, quel subagent viene eseguito come agente principale della sessione con la configurazione dal suo frontmatter |361| `<agent-name> <prompt>` | Se la prima parola corrisponde a un nome di [subagente](/docs/it/sub-agents) personalizzato, quel subagente viene eseguito come agente principale della sessione con la configurazione dal suo frontmatter |

362| `@<agent-name>` | Menziona un subagent personalizzato in qualsiasi punto del prompt per eseguirlo come agente principale |362| `@<agent-name>` | Menziona un subagente personalizzato in qualsiasi punto del prompt per eseguirlo come agente principale |

363| `@<repo>` | Menziona un repository per eseguire la sessione lì. Vedi [Invia a una directory specifica](#dispatch-to-a-specific-directory) per quali repository sono elencati |363| `@<repo>` | Menziona un repository per eseguire la sessione lì. Vedi [Inviare a una directory specifica](#dispatch-to-a-specific-directory) per sapere quali repository sono elencati |

365| `! <command>` | Esegui un comando shell come un job in background invece di avviare una sessione Claude. Il job appare come una riga a cui puoi collegarti, osservare e staccarti |365| `! <command>` | Esegui un comando shell come processo in background invece di avviare una sessione Claude. Il processo appare come una riga a cui puoi collegarti, osservare e staccarti |

366| `#<number>` o un URL di pull request o merge request | Se una sessione sta già lavorando su quel pull request o merge request, Claude Code seleziona la sua riga invece di inviare una nuova sessione |366| `#<number>` o un URL di pull request o merge request | Se una sessione sta già lavorando su quella pull request o merge request, Claude Code seleziona la sua riga invece di inviare una nuova sessione |

367 367

368Un piccolo insieme di comandi viene eseguito in agent view stesso invece di essere inviato:368Un piccolo insieme di comandi viene eseguito nella vista agente stessa invece di essere inviato:

369 369

370* `/exit` e `/quit` chiudono agent view370* `/exit` e `/quit` chiudono la vista agente

371* `/logout` ti disconnette371* `/logout` ti disconnette

372* `/model` imposta il [modello di dispatch](#set-the-model)372* `/model` imposta il [modello di invio](#set-the-model)

373* `/login` apre la finestra di dialogo di accesso in modo che tu possa accedere di nuovo senza collegarti a una sessione373* `/login` apre la finestra di dialogo di accesso in modo da poter accedere di nuovo senza collegarti a una sessione

374* Un `/resume` semplice, o il suo alias `/continue`, apre un picker delle sessioni passate del repository per [riportarne una indietro](#organize-the-list) come sessione in background. Richiede Claude Code v2.1.212 o successivo374* Un `/resume` nudo, o il suo alias `/continue`, apre un selettore delle sessioni passate del repository per [riportarne una indietro](#organize-the-list) come sessione in background. Richiede Claude Code v2.1.212 o successivo

375 375

376Skills, i tuoi comandi personali, e built-in che espandono il prompt come `/init` vengono inviati a una nuova sessione in background come loro primo prompt. Gli altri comandi built-in mostrano un suggerimento `attach to a session to run it` invece. Tutto ciò che hai digitato rimane nell'input accanto al suggerimento in modo che tu possa modificarlo.376Skills, i tuoi comandi e built-in che espandono il prompt come `/init` vengono inviati a una nuova sessione in background come primo prompt. Gli altri comandi built-in mostrano un suggerimento `attach to a session to run it` invece. Tutto ciò che hai digitato rimane nell'input accanto al suggerimento in modo da poterlo modificare.

377 377

378Confezionare un compito ricorrente come una [skill](/docs/it/skills) ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.378Confezionare un'attività ricorrente come [skill](/docs/it/skills) ti consente di avviare lo stesso flusso di lavoro dalla vista agente ripetutamente senza riscrivere il prompt.

379 379

380Quando lo stesso `@name` corrisponde sia a un subagent che a un repository fratello, il subagent ha la precedenza. La corrispondenza della prima parola senza `@` si applica anche, quindi un prompt che inizia con uno dei tuoi nomi di subagent invia quel subagent piuttosto che trattare la parola come testo semplice. Usa la forma `@` quando vuoi essere esplicito, o inizia il prompt con una parola diversa per evitare la corrispondenza.380Quando lo stesso `@name` corrisponde sia a un subagente che a un repository fratello, il subagente ha la precedenza. La corrispondenza della prima parola nuda si applica anche, quindi un prompt che inizia casualmente con uno dei nomi dei tuoi subagenti invia quel subagente piuttosto che trattare la parola come testo semplice. Usa la forma `@` quando vuoi essere esplicito, o inizia il prompt con una parola diversa per evitare la corrispondenza.

381 381

382<h4 id="dispatch-to-a-specific-directory">382<h4 id="dispatch-to-a-specific-directory">

383 Invia a una directory specifica383 Inviare a una directory specifica

384</h4>384</h4>

385 385

386Una nuova sessione viene eseguita nella directory da cui hai aperto agent view. Per indirizzare una directory diversa, utilizza uno qualsiasi di questi:386Una nuova sessione viene eseguita nella directory da cui hai aperto la vista agente. Per indirizzare una directory diversa, usa uno di questi:

387 387

388* Apri `claude agents` in quella directory.388* Apri `claude agents` in quella directory.

389* Apri `claude agents` in una directory padre e menziona un repository figlio con `@<repo>` nel prompt. Digitando `@` vengono elencati questi target:389* Apri `claude agents` in una directory padre e menziona un repository figlio con `@<repo>` nel prompt. Digitando `@` vengono elencati questi target:

390 390

391 * Repository Git un livello sotto la directory di lancio391 * Repository Git un livello sotto la directory di avvio

392 * I [git worktrees](/docs/it/worktrees) registrati del repository da cui hai lanciato che si trovano all'interno del suo albero di directory, come quelli che Claude crea sotto `.claude/worktrees/`, etichettati con il loro ramo estratto. I worktrees aggiunti al di fuori del repository, come con `git worktree add ../feature`, non sono elencati392 * I [git worktrees](/docs/it/worktrees) registrati del repository da cui hai avviato che si trovano all'interno del suo albero di directory, come quelli che Claude crea sotto `.claude/worktrees/`, etichettati con il loro ramo estratto. I worktrees aggiunti al di fuori del repository, come con `git worktree add ../feature`, non sono elencati

393 * Qualsiasi directory che ha già una sessione nell'elenco393 * Qualsiasi directory che ha già una sessione nell'elenco

394 394

395 Una directory il cui nome contiene uno spazio non è elencata.395 Una directory il cui nome contiene uno spazio non è elencata.

396* Dalla shell, `cd` nella directory e esegui `claude --bg "<prompt>"`.396* Dalla shell, `cd` nella directory ed esegui `claude --bg "<prompt>"`.

397 397

398Quando agent view è raggruppato per directory, l'invio invia il prompt alla directory della riga selezionata, quindi puoi selezionare un gruppo e inviare in esso senza riscrivere il percorso.398Quando la vista agente è raggruppata per directory, l'invio invia il prompt alla directory della riga selezionata, in modo da poter selezionare un gruppo e inviare in esso senza riscrivere il percorso.

399 399

400<h3 id="from-inside-a-session">400<h3 id="from-inside-a-session">

401 Da dentro una sessione401 Da dentro una sessione

402</h3>402</h3>

403 403

404Due comandi spostano il lavoro dalla sessione in cui ti trovi in background: `/background` invia la conversazione corrente lì e libera il tuo terminale, e `/fork` invia una copia mentre continui a lavorare dove sei.404Due comandi spostano il lavoro dalla sessione in cui sei in background: `/background` invia la conversazione corrente lì e libera il tuo terminale, e `/fork` invia una copia mentre continui a lavorare dove sei.

405 405

406<h4 id="send-the-session-to-the-background">406<h4 id="send-the-session-to-the-background">

407 Invia la sessione in background407 Inviare la sessione in background

408</h4>408</h4>

409 409

410Esegui `/background` o il suo alias `/bg` per spostare la conversazione corrente in una sessione in background. Passa un prompt come `/bg run the test suite and fix any failures` per inviare un'istruzione in più prima. Se Claude sta rispondendo quando esegui `/bg`, la risposta continua nella sessione in background.410Esegui `/background` o il suo alias `/bg` per spostare la conversazione corrente in una sessione in background. Passa un prompt come `/bg run the test suite and fix any failures` per dare prima un'istruzione in più. Se Claude sta rispondendo quando esegui `/bg`, la risposta continua nella sessione in background.

411 411

412L'uscita da una sessione che ha ancora lavoro in background in esecuzione, come subagent, comandi shell in background, workflow, o [monitor](/docs/it/tools-reference#monitor-tool), mostra una finestra di dialogo `Background work is running` invece di uscire immediatamente. Scegli `Move to background and exit` per mettere in background la sessione nello stesso modo in cui `/background` fa e tornare alla tua shell. L'opzione non viene mostrata quando agent view è [disattivato](#turn-off-agent-view).412L'uscita da una sessione che ha ancora lavoro in background in esecuzione, come subagenti, comandi shell in background, flussi di lavoro o [monitor](/docs/it/tools-reference#monitor-tool), mostra una finestra di dialogo `Background work is running` invece di uscire immediatamente. Scegli `Move to background and exit` per inviare la sessione in background nello stesso modo in cui `/background` fa e tornare alla tua shell. L'opzione non viene mostrata quando la vista agente è [disattivata](#turn-off-agent-view).

413 413

414Se una sessione in background nell'elenco ha già il nome della conversazione, Claude Code numera il nome della nuova riga, come `my-session (2)`, e lascia il nome della riga esistente invariato. Per rinominare la nuova riga, selezionala in agent view e premi `Ctrl+R`.414Se una sessione in background nell'elenco ha già il nome della conversazione, Claude Code numera il nome della nuova riga, come `my-session (2)`, e lascia il nome della riga esistente invariato. Per rinominare la nuova riga, selezionala nella vista agente e premi `Ctrl+R`.

415 415

416<h4 id="copy-the-session-with-/fork">416<h4 id="copy-the-session-with-/fork">

417 Copia la sessione con /fork417 Copiare la sessione con /fork

418</h4>418</h4>

419 419

420Esegui `/fork` per copiare la conversazione corrente in una nuova sessione in background mentre l'originale continua a essere eseguita. La copia inizia con tutto nella conversazione fino a quel punto; vedi i punti elenco di seguito per dove viene eseguita la copia. Trasporta anche il modello, la modalità di autorizzazione, il livello di sforzo, e qualsiasi directory o concessioni di autorizzazione "non chiedere di nuovo" che hai aggiunto durante la sessione. La copia appare come sua propria riga in agent view.420Esegui `/fork` per copiare la conversazione corrente in una nuova sessione in background mentre l'originale continua a essere eseguita. La copia inizia con tutto nella conversazione fino a quel punto; vedi i punti elenco di seguito per sapere dove viene eseguita la copia. Trasporta anche il modello, la modalità di autorizzazione, il livello di sforzo e qualsiasi directory o concessione di autorizzazione "non chiedere di nuovo" che hai aggiunto durante la sessione. La copia appare come sua propria riga nella vista agente.

421 421

422Dopo il fork, le due conversazioni sono indipendenti: nulla di ciò che la copia fa entra nella conversazione originale da sola, anche se nelle sessioni in cui [la messaggistica tra sessioni](/docs/it/cross-session-messaging) è abilitata, la Claude di entrambe le sessioni può esplicitamente inviare messaggi all'altra.422Dopo il fork, le due conversazioni sono indipendenti: nulla di ciò che fa la copia entra nella conversazione originale da sola, anche se nelle sessioni in cui la [messaggistica tra sessioni](/docs/it/cross-session-messaging) è abilitata, Claude di entrambe le sessioni può esplicitamente inviare un messaggio all'altra.

423 423

424La copia della sessione richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211, `/fork` avvia un [subagent con fork](/docs/it/sub-agents#fork-the-current-conversation) invece, che è ora `/subtask`. Quando [agent view è disattivato](#turn-off-agent-view), `/fork` mantiene il comportamento del subagent con fork e `/subtask` non è disponibile.424La copia della sessione richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211, `/fork` avvia un [subagente con fork](/docs/it/sub-agents#fork-the-current-conversation) invece, che è ora `/subtask`. Quando la [vista agente è disattivata](#turn-off-agent-view), `/fork` mantiene il comportamento del subagente con fork e `/subtask` non è disponibile.

425 425

426Passa un prompt come `/fork open a draft pull request with the work so far` e la copia inizia a lavorarci immediatamente. Senza un prompt la copia aspetta la sua prima istruzione: seleziona la sua riga in `claude agents` e premi `Space` per inviarne una, o esegui `claude attach <id>`. La riga selezionata mostra `space to send it a prompt` mentre aspetta.426Passa un prompt come `/fork open a draft pull request with the work so far` e la copia inizia a lavorarci immediatamente. Senza un prompt la copia attende la sua prima istruzione: seleziona la sua riga in `claude agents` e premi `Space` per inviarne una, oppure esegui `claude attach <id>`. La riga selezionata mostra `space to send it a prompt` mentre attende.

427 427

428La conferma di `/fork` è una riga che mostra lo stato della copia, come `session running`, il nome della sua riga di agent view, e il suo ID di sessione per `claude attach`. Fai clic sul nome per passare alla copia: questa sessione si sposta in background, come premere `←`, e agent view apre la sessione della copia.428La conferma di `/fork` è una riga che mostra lo stato della copia, come `session running`, il nome della sua riga di vista agente e il suo ID di sessione per `claude attach`. Fai clic sul nome per passare alla copia: questa sessione si sposta in background, come premere `←`, e la vista agente apre la sessione della copia.

429 429

430Tranne quando la copia [modifica in posizione](#how-file-edits-are-isolated), Claude Code le istruisce di creare un worktree proprio prima di apportare modifiche al codice. Al di fuori di un repository git, solo una copia spostata fuori da un worktree creato da hook riceve l'istruzione; senza un [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate), la copia modifica in posizione. Una copia spostata fuori dal tuo worktree riceve anche l'istruzione di non modificare mai, eseguire comandi in, o entrare in quel worktree, qualunque sia l'impostazione di isolamento.430Tranne quando la copia [modifica in posizione](#how-file-edits-are-isolated), Claude Code le istruisce di creare un worktree proprio prima di apportare modifiche al codice. Al di fuori di un repository git, solo una copia spostata da un worktree creato da hook riceve l'istruzione; senza un [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate), la copia modifica in posizione. Una copia spostata dal tuo worktree riceve anche l'istruzione di non modificare mai, eseguire comandi in o entrare in quel worktree, qualunque sia l'impostazione di isolamento.

431 431

432Dove la copia inizia dipende da dove è in esecuzione la sessione corrente:432Il punto in cui inizia la copia dipende da dove è in esecuzione la sessione corrente:

433 433

434* Come qualsiasi sessione inviata, la copia [si sposta nel suo worktree prima di modificare i file](#how-file-edits-are-isolated). In quel caso la conferma non menziona dove viene eseguita la copia.434* Come qualsiasi sessione inviata, la copia [si sposta nel suo worktree prima di modificare i file](#how-file-edits-are-isolated). In quel caso la conferma non menziona dove viene eseguita la copia.

435* Quando la tua sessione si è spostata nel suo [worktree](/docs/it/worktrees) collegato dopo l'avvio, la copia inizia da dove era la sessione prima dello spostamento e, a meno che non [modifichi in posizione](#how-file-edits-are-isolated), apporta le sue modifiche al codice in un worktree proprio lì. Quando il tuo worktree è estratto su un ramo, quell'istruzione dice anche a una copia il cui compito si basa sul tuo lavoro di basare il suo nuovo ramo sul tuo, poiché il tuo ramo rimane estratto nel tuo worktree. La conferma termina con `runs in the origin tree`.435* Quando la tua sessione si è spostata nel suo [worktree](/docs/it/worktrees) collegato dopo l'avvio, la copia inizia da dove era la sessione prima dello spostamento e, a meno che non [modifichi in posizione](#how-file-edits-are-isolated), apporta le sue modifiche al codice in un worktree proprio lì. Quando il tuo worktree è estratto su un ramo, quell'istruzione dice anche a una copia il cui compito si basa sul tuo lavoro di basare il suo nuovo ramo sul tuo, poiché il tuo ramo rimane estratto nel tuo worktree. La conferma termina con `runs in the origin tree`.

436* Quando hai lanciato la sessione all'interno di un worktree collegato di un repository che ha un albero di lavoro principale, la copia inizia in quell'albero di lavoro principale, con la stessa regola del worktree proprio ma nessuna istruzione di ramo. La conferma termina con `runs in the origin tree` anche qui.436* Quando hai avviato la sessione all'interno di un worktree collegato di un repository che ha un albero di lavoro principale, la copia inizia in quell'albero di lavoro principale, con la stessa regola di worktree proprio ma nessuna istruzione di ramo. La conferma termina con `runs in the origin tree` anche qui.

437* Una sessione lanciata all'interno di un worktree di un layout di repository bare non ha un albero di lavoro principale a cui tornare, quindi la copia rimane dove si trova, e la conferma termina con `edits this checkout`. La stessa nota appare quando l'isolamento del worktree è [disattivato](#how-file-edits-are-isolated) in una sessione che non è all'interno di un worktree collegato, perché la copia modifica i file che hai aperto.437* Una sessione avviata all'interno di un worktree di un layout di repository nudo non ha un albero di lavoro principale a cui tornare, quindi la copia rimane dove è, e la conferma termina con `edits this checkout`. La stessa nota appare quando l'isolamento del worktree è [disattivato](#how-file-edits-are-isolated) in una sessione che non è all'interno di un worktree collegato, perché la copia modifica i file che hai aperto.

438 438

439Le sessioni avviate con flag di lancio che la copia non erediterebbe, come un prompt di sistema sostituito o un allowlist `--tools`, non possono essere forkate; Claude Code lo dice invece di fare una copia parziale. Una sessione inviata da agent view viene forkata normalmente: la copia viene lanciata con la stessa [definizione di agente](/docs/it/sub-agents) e istruzioni aggiunte della sessione da cui proviene.439Le sessioni avviate con flag di avvio che la copia non erediterebbe, come un prompt di sistema sostituito o un allowlist `--tools`, non possono essere forkate; Claude Code lo dice invece di fare una copia parziale. Una sessione inviata dalla vista agente viene forkata normalmente: la copia viene avviata con la stessa [definizione di agente](/docs/it/sub-agents) e istruzioni aggiunte della sessione da cui proviene.

440 440

441<h4 id="what-carries-over-when-you-background">441<h4 id="what-carries-over-when-you-background">

442 Cosa si trasporta quando metti in background442 Cosa viene trasportato quando invii in background

443</h4>443</h4>

444 444

445Mettere in background avvia un nuovo processo che riprende dalla conversazione salvata, e il lavoro in corso si trasferisce ad esso: comandi shell in background in esecuzione, subagent in background, workflow dinamici, compiti programmati che hai creato con [`/loop`](/docs/it/scheduled-tasks), e [risposte automatiche di Claude ai commenti degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) si trasferiscono tutti e continuano a essere eseguiti lì. Un subagent si sposta insieme a tutto ciò che ha avviato, quindi si trasferisce solo quando tutto quel lavoro può trasferirsi anche. Per fermare il lavoro in corso invece di trasferirlo, imposta la variabile di ambiente [`CLAUDE_DISABLE_ADOPT=1`](/docs/it/env-vars#variables); Claude Code ti chiede di confermare prima di mettere in background.445L'invio in background avvia un nuovo processo che riprende dalla conversazione salvata, e il lavoro in corso si sposta in esso: comandi shell in background in esecuzione, subagenti in background, flussi di lavoro dinamici, attività pianificate che hai creato con [`/loop`](/docs/it/scheduled-tasks), e le [risposte automatiche di Claude ai commenti degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) si trasportano tutti e continuano a essere eseguiti lì. Un subagente si sposta insieme a tutto ciò che ha avviato, quindi si trasporta solo quando tutto quel lavoro può spostarsi anche. Per interrompere il lavoro in corso invece di trasportarlo, imposta la variabile di ambiente [`CLAUDE_DISABLE_ADOPT=1`](/docs/it/env-vars#variables); Claude Code ti chiede di confermare prima di inviare in background.

446 446

447Quando un [workflow dinamico](/docs/it/workflows) ha ancora subagent in esecuzione, Claude Code chiede prima di mettere in background con la finestra di dialogo `Background this session?`, che dice quanti subagent verrebbero riavviati. Scegli `Stay` per lasciarli finire prima. Se confermi, Claude Code riproduce l'esecuzione nella sessione in background: i subagent che erano ancora in esecuzione ricominciamo dall'inizio, quindi i token che hanno usato finora vengono spesi di nuovo. Vedi [Riprendi dopo una pausa](/docs/it/workflows#resume-after-a-pause) per quali subagent completati restituiscono i loro risultati salvati e quali vengono eseguiti di nuovo.447Quando un [flusso di lavoro dinamico](/docs/it/workflows) ha ancora subagenti in esecuzione, Claude Code chiede prima di inviare in background con la finestra di dialogo `Background this session?`, che dice quanti subagenti verrebbero riavviati. Scegli `Stay` per lasciarli finire prima. Se confermi, Claude Code riproduce l'esecuzione nella sessione in background: i subagenti che erano ancora in esecuzione ricominciamo dall'inizio, quindi i token che hanno usato finora vengono spesi di nuovo. Vedi [Riprendere dopo una pausa](/docs/it/workflows#resume-after-a-pause) per sapere quali subagenti completati restituiscono i loro risultati salvati e quali vengono eseguiti di nuovo.

448 448

449Claude Code interrompe il lavoro che non può trasferirsi, come un [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione, e interrompe un subagent messo in background che possiede un monitor insieme ad esso. Quando uno qualsiasi di essi è in esecuzione, Claude Code mostra la finestra di dialogo `Background this session?` in modo che tu possa confermare prima che il lavoro sia interrotto.449Claude Code interrompe il lavoro che non può essere trasportato, come un [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione, e interrompe un subagente in background che possiede un monitor insieme ad esso. Quando uno di questi lavori è in esecuzione, Claude Code mostra la finestra di dialogo `Background this session?` in modo da poter confermare prima che interrompa il lavoro.

450 450

451Una volta in background, la sessione può avviare nuovi subagent, monitor, e comandi in background, e questi continuano a essere eseguiti durante successivi distacchi e ricollegamenti.451Una volta in background, la sessione può avviare nuovi subagenti, monitor e comandi in background, e quelli continuano a essere eseguiti durante il successivo distacco e ricollegamento.

452 452

453I flag di configurazione dal lancio originale si trasferiscono alla sessione messa in background, quindi i suoi server MCP, le impostazioni e il modello di fallback rimangono in vigore:453I flag di configurazione dal lancio originale si trasportano alla sessione in background, quindi i suoi server MCP, le impostazioni e il modello di fallback rimangono in vigore:

454 454

455* `--mcp-config` e `--strict-mcp-config`455* `--mcp-config` e `--strict-mcp-config`

456* `--settings`456* `--settings`

457* `--setting-sources`

457* `--add-dir`458* `--add-dir`

458* `--plugin-dir`459* `--plugin-dir`

459* `--fallback-model`460* `--fallback-model`

460* `--allow-dangerously-skip-permissions`461* `--allow-dangerously-skip-permissions`

461 462

462Le directory che hai aggiunto durante la sessione con [`/add-dir`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) si trasferiscono anche. Il trasferimento di `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` raggiungibile nella sessione messa in background, ma non concede nulla di nuovo: la modalità richiede comunque la stessa accettazione interattiva una tantum descritta in [Permission mode, model, and effort](#permission-mode-model-and-effort).463Le directory che hai aggiunto durante la sessione con [`/add-dir`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) si trasportano anche. Trasportare `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` raggiungibile nella sessione in background, ma non concede nulla di nuovo: la modalità richiede comunque l'accettazione interattiva una tantum descritta in [Modalità di autorizzazione, modello e sforzo](#permission-mode-model-and-effort).

463 464

464<h3 id="from-your-shell">465<h3 id="from-your-shell">

465 Dalla tua shell466 Dalla tua shell

471claude --bg "investigate the flaky SettingsChangeDetector test"472claude --bg "investigate the flaky SettingsChangeDetector test"

472```473```

473 474

474Il prompt è l'argomento posizionale, non un valore `-p`. Claude Code rifiuta `--bg` combinato con `-p` o `--print` prima che qualsiasi sessione sia creata, perché `--print` non avvia mai la sessione interattiva a cui `claude agents` si collega.475Il prompt è l'argomento posizionale, non un valore `-p`. Claude Code rifiuta `--bg` combinato con `-p` o `--print` prima che venga creata una sessione, perché `--print` non avvia mai la sessione interattiva a cui `claude agents` si collega.

475 476

476Per eseguire un [subagent](/docs/it/sub-agents) specifico che hai definito, come un `code-reviewer`, come agente principale della sessione, combina `--bg` con `--agent`:477Se esegui `claude --bg` da un terminale in una directory che non hai [fidata](/docs/it/permissions#project-allow-rules-and-workspace-trust), la finestra di dialogo di fiducia dell'area di lavoro appare per prima e la sessione inizia una volta che accetti. Se rifiuti, Claude Code esce senza avviare una sessione. Dove nessuna finestra di dialogo può apparire, come in uno script, il comando esce con un errore [`Workspace not trusted`](/docs/it/errors#workspace-not-trusted-when-dispatching-a-background-session) invece.

478

479Per eseguire un [subagente](/docs/it/sub-agents) specifico che hai definito, come un `code-reviewer`, come agente principale della sessione, combina `--bg` con `--agent`:

477 480

478```bash theme={null}481```bash theme={null}

479claude --agent code-reviewer --bg "address review comments on PR 1234"482claude --agent code-reviewer --bg "address review comments on PR 1234"

480```483```

481 484

482Se il nome non corrisponde a nessuno dei tuoi subagent, il lancio fallisce: Claude Code stampa un avviso `no agent named` e comunque segnala la sessione come messa in background, ma la sessione esce immediatamente con un errore `--agent '<name>' not found`.485Se il nome non corrisponde a nessuno dei tuoi subagenti, l'avvio fallisce: Claude Code stampa un avviso `no agent named` e comunica comunque la sessione come in background, ma la sessione esce immediatamente con un errore `--agent '<name>' not found`.

483 486

484Quando la sessione messa in background in seguito riprende o si riavvia, Claude Code ripristina l'agente e le sue restrizioni di strumenti; per il suo prompt di sistema, vedi [Flag di prompt di sistema nelle conversazioni riprese](/docs/it/cli-reference#system-prompt-flags-in-resumed-conversations). Cerca prima il suo agente nella directory della sessione, a condizione che tu abbia [fiducia in quel workspace](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi un agente con ambito di progetto si carica ancora quando la sessione viene ripresa da un'altra directory. Se l'agente non esiste più, la sessione continua con gli strumenti predefiniti e la sua trascrizione si apre con un [avviso che nomina l'agente](/docs/it/errors#session-agent-no-longer-available).487Quando la sessione in background in seguito riprende o si riavvia, Claude Code ripristina l'agente e le sue restrizioni di strumenti; per il suo prompt di sistema, vedi [Flag di prompt di sistema nelle conversazioni riprese](/docs/it/cli-reference#system-prompt-flags-in-resumed-conversations). Cerca prima la directory della sessione stessa per l'agente, a condizione che tu abbia [fidata quell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi un agente con ambito di progetto si carica ancora quando la sessione viene ripresa da un'altra directory. Se l'agente non esiste più, la sessione continua con gli strumenti predefiniti e la sua trascrizione si apre con un [avviso che nomina l'agente](/docs/it/errors#session-agent-no-longer-available).

485 488

486Per continuare una conversazione esistente in background, passa il suo ID di sessione completo con `--resume`:489Per continuare una conversazione esistente in background, passa il suo ID di sessione completo con `--resume`:

487 490

489claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"492claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

490```493```

491 494

492Su Claude Code v2.1.257 o successivo, Claude Code continua quella sessione con lo stesso ID, o avvia una copia con un nuovo ID e stampa una riga `note:` che spiega perché non potrebbe continuare in posizione. Quando la sessione continua in posizione, `claude agents` mostra una riga per essa.495Su Claude Code v2.1.257 o successivo, Claude Code continua quella sessione con lo stesso ID, oppure avvia una copia con un nuovo ID e stampa una riga `note:` che spiega perché non poteva continuare in posizione. Quando la sessione continua in posizione, `claude agents` mostra una riga per essa.

493 496

494Quando combini `--bg` con `--continue`, un `--resume` semplice, o `--resume` con un nome o percorso di file, Claude Code avvia sempre una copia di questo tipo. Aggiungi `--fork-session` per avviare una copia di proposito, senza la nota.497Quando combini `--bg` con `--continue`, un `--resume` nudo, o `--resume` con un nome o percorso di file, Claude Code avvia sempre una copia di questo tipo. Aggiungi `--fork-session` per avviare una copia di proposito, senza la nota.

495 498

496Passa `--name` per impostare il nome di visualizzazione della sessione in agent view invece di quello generato automaticamente:499Passa `--name` per impostare il nome di visualizzazione della sessione nella vista agente invece di quello generato automaticamente:

497 500

498```bash theme={null}501```bash theme={null}

499claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"502claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

500```503```

501 504

502Dopo aver messo in background, Claude stampa l'ID breve della sessione e i comandi per gestirla. Quando il servizio che ospita le sessioni in background non è già in esecuzione, `--bg` potrebbe prima stampare `Starting background service…` sopra questo output. Quando passi `--name`, il nome appare dopo l'ID breve:505Dopo l'invio in background, Claude stampa l'ID breve della sessione e i comandi per gestirla. Quando il servizio che ospita le sessioni in background non è già in esecuzione, `--bg` potrebbe prima stampare `Starting background service…` sopra questo output. Quando passi `--name`, il nome appare dopo l'ID breve:

503 506

504```text theme={null}507```text theme={null}

505backgrounded · 7c5dcf5d · flaky-test-fix508backgrounded · 7c5dcf5d · flaky-test-fix

510```513```

511 514

512<h4 id="run-a-shell-command">515<h4 id="run-a-shell-command">

513 Esegui un comando shell516 Eseguire un comando shell

514</h4>517</h4>

515 518

516Per eseguire un comando shell come un job in background invece di una sessione Claude, passa `--exec`. L'esempio seguente esegue `pytest -x` come un job in background:519Per eseguire un comando shell come processo in background invece di una sessione Claude, passa `--exec`. L'esempio seguente esegue `pytest -x` come processo in background:

517 520

518```bash theme={null}521```bash theme={null}

519claude --bg --exec 'pytest -x'522claude --bg --exec 'pytest -x'

520```523```

521 524

522Da agent view, invia lo stesso tipo di job digitando `!` come primo carattere dell'input di dispatch: il `!` viene visualizzato come prefisso, tutto ciò che digiti dopo di esso è il comando, e `Enter` avvia il job.525Dalla vista agente, invia lo stesso tipo di processo digitando `!` come primo carattere dell'input di invio: il `!` viene mostrato come prefisso, tutto dopo di esso è il comando, e `Enter` avvia il processo.

523 526

524Il comando viene eseguito come un job supportato da PTY e appare come una riga in agent view, con la riga di output più recente come suo stato. Un job shell esegue il comando al posto di Claude, quindi nessun modello viene invocato e l'output non viene inviato a nessuna sessione.527Il comando viene eseguito come processo supportato da PTY e appare come una riga nella vista agente, con la riga di output più recente come suo stato. Un processo shell esegue il comando al posto di Claude, quindi nessun modello viene invocato e l'output non viene inviato a nessuna sessione.

525 528

526Per vedere l'output, collegati alla riga, premi `Space` per visualizzare l'anteprima senza collegarti, o esegui `claude logs <id>` dalla tua shell. L'output acquisito rimane in memoria e non viene scritto su disco. La riga e il suo output si puliscono automaticamente circa cinque minuti dopo l'uscita del comando, quindi leggi prima se hai bisogno del risultato.529Per vedere l'output, collegati alla riga, premi `Space` per visualizzare in anteprima senza collegarti, oppure esegui `claude logs <id>` dalla tua shell. L'output acquisito rimane in memoria e non viene scritto su disco. La riga e il suo output si puliscono automaticamente circa cinque minuti dopo l'uscita del comando, quindi leggi prima se hai bisogno del risultato.

527 530

528<h3 id="how-file-edits-are-isolated">531<h3 id="how-file-edits-are-isolated">

529 Come sono isolate le modifiche ai file532 Come gli edit dei file sono isolati

530</h3>533</h3>

531 534

532Ogni sessione in background, che sia avviata da agent view, `/bg`, o `claude --bg`, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un [git worktree](/docs/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo. Una volta che la sessione è nel suo worktree, Claude Code [applica l'isolamento del worktree](/docs/it/worktrees#how-claude-code-enforces-isolation) per la sessione e per qualsiasi subagent che genera.535Ogni sessione in background, che sia avviata dalla vista agente, `/bg` o `claude --bg`, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un [git worktree](/docs/it/worktrees) isolato sotto `.claude/worktrees/`, in modo che le sessioni parallele possano leggere lo stesso checkout ma ognuna scrive nel suo. Una volta che la sessione è nel suo worktree, Claude Code [applica l'isolamento del worktree](/docs/it/worktrees#how-claude-code-enforces-isolation) per la sessione e per qualsiasi subagente che genera.

533 536

534Claude salta il worktree quando:537Claude salta il worktree quando:

535 538

536* La sessione è già all'interno di un git worktree collegato, che Claude l'abbia creato sotto `.claude/worktrees/` o tu l'abbia creato con `git worktree add` da qualche altra parte539* La sessione è già all'interno di un git worktree collegato, che Claude l'abbia creato sotto `.claude/worktrees/` o tu l'abbia creato con `git worktree add` da qualche altra parte

537* Il file che Claude sta modificando è all'interno di un git worktree collegato, come uno che la sessione o il suo subagent ha creato con `git worktree add`540* Il file che Claude sta modificando è all'interno di un git worktree collegato, come uno che la sessione o il suo subagente ha creato con `git worktree add`

538* La directory di lavoro non è un repository git e nessun [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) è configurato541* La directory di lavoro non è un repository git e nessun [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) è configurato

539* La scrittura è al di fuori della directory di lavoro542* La scrittura è al di fuori della directory di lavoro

540 543

541Per disattivare l'isolamento del worktree per un repository dove i git worktree sono impraticabili, imposta [`worktree.bgIsolation`](/docs/it/settings-reference#worktree-bgisolation) su `"none"`. Le sessioni in background modificheranno quindi la tua copia di lavoro direttamente senza spostarsi prima in un worktree. Aggiungi l'impostazione al file `.claude/settings.json` del progetto:544Per disattivare l'isolamento del worktree per un repository in cui i git worktrees non sono pratici, imposta [`worktree.bgIsolation`](/docs/it/settings-reference#worktree-bgisolation) su `"none"`. Le sessioni in background modificano quindi la tua copia di lavoro direttamente senza spostarsi prima in un worktree. Aggiungi l'impostazione al `.claude/settings.json` del progetto:

542 545

543```json theme={null}546```json theme={null}

544{547{

548}551}

549```552```

550 553

551Al di fuori di un repository git, le sessioni scrivono direttamente nella directory di lavoro e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file. Se utilizzi un sistema di controllo versione diverso, configura un [`WorktreeCreate` hook](/docs/it/worktrees#non-git-version-control) e Claude isola le modifiche nello stesso modo in cui lo fa per git.554Al di fuori di un repository git, le sessioni scrivono nella directory di lavoro direttamente e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file. Se usi un sistema di controllo della versione diverso, configura un [`WorktreeCreate` hook](/docs/it/worktrees#non-git-version-control) e Claude isola gli edit nello stesso modo in cui lo fa per git.

552 555

553Quando l'hook fallisce in una directory che non è un repository git, Claude salta l'isolamento per quella directory e modifica la directory di lavoro in posizione. All'interno di un repository git, Claude Code blocca le scritture al checkout condiviso finché Claude non sposta la sessione in un worktree.556Quando l'hook fallisce in una directory che non è un repository git, Claude salta l'isolamento per quella directory e modifica la directory di lavoro in posizione. All'interno di un repository git, Claude Code blocca le scritture al checkout condiviso fino a quando Claude non sposta la sessione in un worktree.

554 557

555Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.558Per trovare il percorso del worktree di una sessione, visualizza in anteprima la sessione o collegati e controlla la sua directory di lavoro.

556 559

557Un [subagent](/docs/it/sub-agents) che la sessione in background genera eredita la directory di lavoro della sessione, quindi le sue modifiche ai file finiscono nel worktree della sessione piuttosto che nella tua copia di lavoro. Per dare a un subagent il suo proprio worktree separato, imposta [`isolation: worktree`](/docs/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter o passa `isolation: "worktree"` quando lo generi.560Un [subagente](/docs/it/sub-agents) che la sessione in background genera eredita la directory di lavoro della sessione, quindi i suoi edit dei file finiscono nel worktree della sessione piuttosto che nella tua copia di lavoro. Per dare a un subagente il suo worktree separato invece, imposta [`isolation: worktree`](/docs/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter o passa `isolation: "worktree"` quando lo generi.

558 561

559Quando una sessione in background ha apportato modifiche al codice in un worktree in cui Claude è entrato, Claude Code istruisce Claude di preservare il lavoro prima di finire, quindi sopravvive se elimini la sessione e il suo worktree:562Quando una sessione in background ha apportato modifiche al codice in un worktree in cui Claude è entrato, Claude Code istruisce Claude di preservare il lavoro prima di finire, in modo che sopravviva se elimini la sessione e il suo worktree:

560 563

561* **Commit e push**: Claude esegue il commit senza chiedere, e spinge il ramo quando il repository ha un remote.564* **Commit e push**: Claude esegue il commit senza chiedere, e fa il push del ramo quando il repository ha un remote.

562* **Bozza di pull request**: Claude ne apre una quando il compito lo richiede, e l'etichetta [`#N`](#pull-request-status) appare sulla riga.565* **Draft pull request**: Claude ne apre una quando l'attività lo richiede, e l'etichetta [`#N`](#pull-request-status) appare sulla riga.

563* **Mai**: spingere a `main` o `master`, force-push, e merge.566* **Mai**: fare il push a `main` o `master`, force-push e merge.

564* **Le tue istruzioni git hanno la precedenza**: se il compito, `CLAUDE.md`, o [memoria](/docs/it/memory) dice che gestisci tu stesso il commit o il push, Claude lascia git a te.567* **Le tue istruzioni git hanno la precedenza**: se l'attività, `CLAUDE.md` o [memoria](/docs/it/memory) dice che gestisci tu il commit o il push, Claude lascia git a te.

565 568

566Una sessione che modifica un checkout che non ha isolato da sola chiede comunque prima di fare il commit o di cambiare rami. Questo si applica quando l'isolamento è impostato su `"none"`, quando lo spostamento del worktree è fallito, o quando la sessione è stata avviata all'interno di un worktree che già esisteva.569Una sessione che modifica un checkout che non ha isolato se stessa chiede comunque prima di eseguire il commit o di cambiare rami. Questo si applica quando l'isolamento è impostato su `"none"`, quando lo spostamento del worktree è fallito, o quando la sessione è iniziata all'interno di un worktree che già esisteva.

567 570

568Qualunque sia il compito, Claude termina il lavoro con un rapporto che dice cosa ha fatto e dove si trova il lavoro: un percorso, un ramo, una pull request, o la risposta stessa.571Qualunque sia l'attività, Claude termina il lavoro con un rapporto che dice cosa ha fatto e dove si trova il lavoro: un percorso, un ramo, una pull request, o la risposta stessa.

569 572

570<h4 id="what-deleting-a-session-removes">573<h4 id="what-deleting-a-session-removes">

571 Cosa elimina l'eliminazione di una sessione574 Cosa elimina una sessione

572</h4>575</h4>

573 576

574Elimina una sessione con `Ctrl+X` due volte in [agent view](#organize-the-list) o con [`claude rm`](#manage-sessions-from-the-shell). Tranne nei casi mantenuti di seguito, la sessione lascia l'elenco. La sua trascrizione rimane sulla tua macchina attraverso `claude --resume`, e la rimozione sopravvive ai riavvii del supervisore.577Elimina una sessione con `Ctrl+X` due volte nella [vista agente](#organize-the-list) o con [`claude rm`](#manage-sessions-from-the-shell). Tranne nei casi mantenuti di seguito, la sessione lascia l'elenco. La sua trascrizione rimane sulla tua macchina attraverso `claude --resume`, e la rimozione sopravvive ai riavvii del supervisore.

575 578

576Cosa succede a un worktree che Claude ha creato per la sessione:579Cosa succede a un worktree che Claude ha creato per la sessione:

577 580

578* Agent view lo rimuove, inclusi eventuali cambiamenti non committati, quindi esegui il commit di ciò che vuoi mantenere prima.581* La vista agente lo rimuove, incluse le modifiche non sottoposte a commit, quindi esegui il commit di ciò che vuoi mantenere prima.

579* `claude rm` lo mantiene, insieme alla riga della sessione, quando ha cambiamenti non committati.582* `claude rm` lo mantiene, insieme alla riga della sessione, quando ha modifiche non sottoposte a commit.

580* Né agent view né `claude rm` rimuovono un worktree che un'altra sessione in esecuzione sta usando o ha bloccato, e eliminare di nuovo non cambia questo. Claude Code mantiene il worktree e la sessione, e nomina la directory mantenuta e il motivo; in agent view, la riga della sessione mostra `not deleted`. Chiudi l'altra sessione, quindi elimina di nuovo.583* Né la vista agente né `claude rm` rimuovono un worktree che un'altra sessione in esecuzione sta usando o ha bloccato, e eliminare di nuovo non cambia questo. Claude Code mantiene il worktree e la sessione, e nomina la directory mantenuta e il motivo; nella vista agente, la riga della sessione mostra `not deleted`. Chiudi l'altra sessione, quindi elimina di nuovo.

581* Quando elimini una sessione il cui worktree ha commit che Claude Code non può confermare sono salvati altrove, Claude Code mantiene il worktree e la sessione, e il messaggio nomina il ramo del worktree e quanti commit non sono stati spinti. Il messaggio offre anche i due modi per procedere: spingere i commit, o eliminare di nuovo per scartarli.584* Quando elimini una sessione il cui worktree ha commit che Claude Code non può confermare siano salvati altrove, Claude Code mantiene il worktree e la sessione, e il messaggio nomina il ramo del worktree e quanti commit non sono stati sottoposti a push. Il messaggio offre anche i due modi per procedere: fare il push dei commit, o eliminare di nuovo per scartarli.

582 585

583 I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del ramo predefinito del tuo remote `origin`, purché quel ramo sia estratto nel tuo checkout principale, la directory del repository stessa piuttosto che un worktree.586 I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del ramo predefinito del tuo remote `origin`, purché quel ramo sia estratto nel tuo checkout principale, la directory del repository stessa piuttosto che un worktree.

584 587

585 Dopo quel rifiuto, scegli:588 Dopo quel rifiuto, scegli:

586 589

587 * Per mantenere i commit, spingili, o uniscili in quel ramo predefinito, quindi elimina la sessione di nuovo.590 * Per mantenere i commit, fai il push di essi, o uniscili a quel ramo predefinito, quindi elimina di nuovo la sessione.

588 * Per scartarli, elimina la sessione di nuovo senza spingere: premi `Ctrl+X` due volte sulla sua riga in agent view, o esegui il comando `claude rm <id> --discard-unpushed` che il rifiuto ha stampato. Questo rimuove la sessione e il worktree insieme al suo ramo, scartando i commit non spinti e qualsiasi cambiamento non committato.591 * Per scartarli, elimina di nuovo la sessione senza fare il push: premi `Ctrl+X` due volte sulla sua riga nella vista agente, o esegui il comando `claude rm <id> --discard-unpushed` che il rifiuto ha stampato. Questo rimuove la sessione e il worktree insieme al suo ramo, scartando i commit non sottoposti a push e le modifiche non sottoposte a commit.

589 592

590 Quando elimini di nuovo, Claude Code scarta solo ciò che il rifiuto ha mostrato: se il worktree ha guadagnato un commit da allora, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato.593 Quando elimini di nuovo, Claude Code scarta solo ciò che il rifiuto ha mostrato: se il worktree ha guadagnato un commit da allora, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato.

591 594

592 Quando i record di un'altra sessione finita nominano anche il worktree, rimane quando elimini di nuovo; spingere i commit, quindi eliminare di nuovo.595 Quando il record di un'altra sessione finita nomina anche il worktree, rimane quando elimini di nuovo; fai il push dei commit, quindi elimina di nuovo.

593* Un worktree che git non riconosce più, ad esempio dopo `git worktree prune`, non blocca l'eliminazione. Claude Code elimina la sessione e lascia la directory su disco.596* Un worktree che git non riconosce più, ad esempio dopo `git worktree prune`, non blocca l'eliminazione. Claude Code elimina la sessione e lascia la directory su disco.

594* Quando git o il tuo [`WorktreeRemove` hook](/docs/it/hooks#worktreeremove) non riesce a rimuovere il worktree, Claude Code mantiene il worktree e la sessione, e il messaggio nomina la causa. Per un hook, il messaggio dice come è terminato, come `exited 1`, e cita l'inizio del suo stderr. Il messaggio ti dice anche quale di questi fare dopo:597* Quando git o il tuo [`WorktreeRemove` hook](/docs/it/hooks#worktreeremove) non riesce a rimuovere il worktree, Claude Code mantiene il worktree e la sessione, e il messaggio nomina la causa. Per un hook, il messaggio dice come è terminato, come `exited 1`, e cita l'inizio del suo stderr. Il messaggio ti dice anche quale di questi fare dopo:

595 598

596 * Elimina la sessione di nuovo per rimuovere la directory comunque, premendo `Ctrl+X` due volte sulla sua riga in agent view o eseguendo il comando `claude rm <id> --force-remove-worktree <worktree-id>` che il rifiuto di `claude rm` ha stampato. Claude Code offre questo solo quando può confermare che la directory è uno dei worktree collegati del repository sotto `.claude/worktrees/` senza cambiamenti non committati ai file tracciati, nessun repository annidato dentro, e nessun record di un'altra sessione che lo nomina. Il ramo del worktree rimane nel repository.599 * Elimina di nuovo la sessione per rimuovere la directory comunque, premendo `Ctrl+X` due volte sulla sua riga nella vista agente o eseguendo il comando `claude rm <id> --force-remove-worktree <worktree-id>` che il rifiuto di `claude rm` ha stampato. Il ramo del worktree rimane nel repository.

597 * Correggi ciò che sta nel modo, come committare o stash dei cambiamenti non committati, chiudere tutto ciò che sta usando la directory, o correggere l'hook, quindi elimina la sessione di nuovo.600

598 * Rimuovi la directory tu stesso, quindi elimina la sessione di nuovo.601 Claude Code offre questo solo quando può confermare tutto quanto segue:

602

603 * La directory è uno dei worktrees collegati del repository sotto `.claude/worktrees/`

604 * Né il worktree né un submodule estratto ha modifiche non sottoposte a commit ai file tracciati

605 * Nessun record di un'altra sessione lo nomina

606

607 Quando Claude Code non può verificare lo stato di un checkout di submodule, come uno sostituito da un repository git separato, non offre nemmeno questo.

608 * Correggi ciò che ostacola, come eseguire il commit o stashing delle modifiche non sottoposte a commit, spostare un repository git separato dal worktree, chiudere tutto ciò che sta usando la directory, o correggere l'hook, quindi elimina di nuovo la sessione.

609 * Rimuovi la directory tu stesso, quindi elimina di nuovo la sessione.

599 610

600Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posizione in entrambi i casi.611Un worktree che hai creato tu stesso e avviato la sessione dentro viene lasciato in posizione in entrambi i casi.

601 612

602Una sessione il cui worktree directory non appartiene a nessun repository git, perché il repository è stato eliminato o un [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) ha creato la directory altrove, può comunque essere eliminata. Mentre i file rimangono nella directory:613Una sessione il cui worktree directory non appartiene a nessun repository git, perché il repository è stato eliminato o un [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) ha creato la directory altrove, può comunque essere eliminata. Mentre i file rimangono nella directory:

603 614

604* Agent view chiede lo stesso doppio `Ctrl+X` prima di scartarli. Per una directory creata da hook esegue il tuo [`WorktreeRemove` hook](/docs/it/hooks#worktreeremove) invece, e senza uno rifiuta l'eliminazione e mantiene la sessione.615* La vista agente chiede lo stesso doppio `Ctrl+X` prima di scartarli. Per una directory creata da hook esegue il tuo [`WorktreeRemove` hook](/docs/it/hooks#worktreeremove) invece, e senza uno rifiuta l'eliminazione e mantiene la sessione.

605* `claude rm` mantiene la sessione e il worktree, e nomina il motivo.616* `claude rm` mantiene la sessione e il worktree, e nomina il motivo.

606 617

607Entrambi i percorsi mantengono una directory che i record di un'altra sessione finita nominano.618Entrambi i percorsi mantengono una directory che i record di un'altra sessione finita nominano.

608 619

609<h3 id="set-the-model">620<h3 id="set-the-model">

610 Imposta il modello621 Impostare il modello

611</h3>622</h3>

612 623

613Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'impostazione [`model`](/docs/it/settings-reference#model) nei tuoi settings utente. Impostalo selezionando un modello nel picker [`/model`](/docs/it/model-config), o modifica l'impostazione direttamente.624Il nome del modello mostrato nell'intestazione della vista agente è il valore predefinito di invio. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'[impostazione `model`](/docs/it/settings-reference#model) nelle tue impostazioni utente. Impostalo selezionando un modello nel [selettore `/model`](/docs/it/model-config), o modifica l'impostazione direttamente.

614 625

615Per sovrascrivere il default di dispatch per l'intera sessione di agent view, passa `--model` quando apri agent view. Vedi [Permission mode, model, and effort](#permission-mode-model-and-effort).626Per ignorare il valore predefinito di invio per l'intera sessione di vista agente, passa `--model` quando apri la vista agente. Vedi [Modalità di autorizzazione, modello e sforzo](#permission-mode-model-and-effort).

616 627

617Per cambiare il default di dispatch da dentro agent view, digita `/model` seguito da un nome di modello nell'input di dispatch e premi `Enter`. L'intestazione si aggiorna per mostrare quel modello con un marcatore `(session)`, e le sessioni che invii successivamente lo utilizzano. Digita `/model default` per cancellare l'override e tornare al default di dispatch. Questo override dura per il resto della corrente esecuzione di `claude agents` e non scrive nel tuo file di settings. L'esempio seguente invia una sessione su Opus e la successiva su Sonnet:628Per cambiare il valore predefinito di invio da dentro la vista agente, digita `/model` seguito da un nome di modello nell'input di invio e premi `Enter`. L'intestazione si aggiorna per mostrare quel modello con un marcatore `(session)`, e le sessioni che invii in seguito lo utilizzano. Digita `/model default` per cancellare l'override e tornare al valore predefinito di invio. Questo override dura per il resto dell'esecuzione corrente di `claude agents` e non scrive nel tuo file di impostazioni. L'esempio seguente invia una sessione su Opus e la successiva su Sonnet:

618 629

619```text theme={null}630```text theme={null}

620/model opus631/model opus

623run the test suite634run the test suite

624```635```

625 636

626Ogni sessione in background può essere eseguita su un modello diverso. Per sovrascriverlo per una sessione:637Ogni sessione in background può essere eseguita su un modello diverso. Per ignorarlo per una sessione:

627 638

628* Dalla shell, passa `--model` con `claude --bg`.639* Dalla shell, passa `--model` con `claude --bg`.

629* Collegati a una sessione in esecuzione e esegui `/model` per passare: una scelta dal picker, o un `/model <name>` digitato, viene salvato come tuo default per le nuove sessioni a meno che tu non premi `s` nel picker per un passaggio solo per la sessione. Un passaggio solo per la sessione persiste se la sessione viene riavviata.640* Collegati a una sessione in esecuzione ed esegui `/model` per cambiare: una scelta dal selettore, o un `/model <name>` digitato, salva come tuo valore predefinito per le nuove sessioni a meno che non premi `s` nel selettore per un cambio solo sessione. Un cambio solo sessione persiste se la sessione viene rispawnata.

630* Invia un [subagent](/docs/it/sub-agents) il cui frontmatter imposta un campo `model`.641* Invia un [subagente](/docs/it/sub-agents) il cui frontmatter imposta un campo `model`.

631 642

632<h3 id="permission-mode-model-and-effort">643<h3 id="permission-mode-model-and-effort">

633 Permission mode, model, and effort644 Modalità di autorizzazione, modello e sforzo

634</h3>645</h3>

635 646

636Una sessione in background prende le sue impostazioni, provider, modalità di autorizzazione, modello e sforzo da dove e come l'hai inviata. Le sottosezioni di seguito coprono ogni fonte, e cosa persiste quando il supervisore riavvia la sessione.647Una sessione in background prende le sue impostazioni, provider, modalità di autorizzazione, modello e sforzo da dove e come l'hai inviata. Le sottosezioni di seguito coprono ogni fonte, e cosa persiste quando il supervisore riavvia la sessione.

639 Impostazioni e provider650 Impostazioni e provider

640</h4>651</h4>

641 652

642Una sessione in background legge le sue [impostazioni](/docs/it/settings) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì. Questo include i valori [`env`](/docs/it/settings-reference#env) nelle impostazioni del progetto, quindi un `ANTHROPIC_MODEL` o una variabile del provider impostata lì si applica a ogni sessione in background in quella directory.653Una sessione in background legge le sue [impostazioni](/docs/it/settings) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì con i [flag di configurazione che ha trasportato](#what-carries-over-when-you-background). Questo include i [valori `env`](/docs/it/settings-reference#env) nelle impostazioni del progetto, quindi una variabile `ANTHROPIC_MODEL` o provider impostata lì si applica a ogni sessione in background in quella directory.

643 654

644Una sessione in background viene anche eseguita con il `PATH` della shell da cui l'hai inviata, quindi i comandi che esegue trovano gli stessi strumenti del tuo terminale. Mantiene anche la selezione del cloud provider di quella shell, come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, insieme ai suoi alias `ANTHROPIC_DEFAULT_*_MODEL` e qualsiasi override [`CLAUDE_CODE_EXTRA_BODY`](/docs/it/env-vars) che hai esportato lì.655Una sessione in background viene anche eseguita con il `PATH` della shell da cui l'hai inviata, quindi i comandi che esegue trovano gli stessi strumenti del tuo terminale. Mantiene anche la selezione del provider cloud di quella shell, come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, insieme ai suoi alias `ANTHROPIC_DEFAULT_*_MODEL` e a qualsiasi override [`CLAUDE_CODE_EXTRA_BODY`](/docs/it/env-vars) che hai esportato lì.

645 656

646<h4 id="llm-gateway">657<h4 id="llm-gateway">

647 Gateway LLM658 Gateway LLM

649 660

650Se instrada Claude Code attraverso un [gateway LLM](/docs/it/llm-gateway), metti le variabili del gateway in un blocco `env` di un file di impostazioni piuttosto che esportarle nella tua shell, e le sessioni in background le leggono insieme al resto delle loro impostazioni. [Imposta in un file di impostazioni](/docs/it/llm-gateway-connect#set-in-a-settings-file) mostra il blocco e quale file di impostazioni usare per la credenziale.661Se instrada Claude Code attraverso un [gateway LLM](/docs/it/llm-gateway), metti le variabili del gateway in un blocco `env` di un file di impostazioni piuttosto che esportarle nella tua shell, e le sessioni in background le leggono insieme al resto delle loro impostazioni. [Imposta in un file di impostazioni](/docs/it/llm-gateway-connect#set-in-a-settings-file) mostra il blocco e quale file di impostazioni usare per la credenziale.

651 662

652Se esporti un gateway `ANTHROPIC_BASE_URL` solo nella tua shell, raggiunge una sessione in background, insieme a `ANTHROPIC_CUSTOM_HEADERS` e la credenziale che hai esportato con esso, solo quando il [supervisore](#the-supervisor-process) stesso è stato avviato da una shell che ha esportato lo stesso gateway, e solo in questi casi:663Se esporti un `ANTHROPIC_BASE_URL` del gateway solo nella tua shell invece, raggiunge una sessione in background, insieme a `ANTHROPIC_CUSTOM_HEADERS` e la credenziale che hai esportato con esso, solo quando il [supervisore](#the-supervisor-process) stesso è stato avviato da una shell che ha esportato lo stesso gateway, e solo in questi casi:

653 664

654* Metti in background la tua sessione con `←` o `/background`665* Invii la tua sessione in background con `←` o `/background`

655* Invii una sessione nella directory in cui sei666* Invii una sessione nella directory in cui sei

656* Svegli una sessione fermata nella directory in cui sei collegandoti o rispondendo ad essa667* Svegli una sessione interrotta nella directory in cui sei collegandoti o rispondendo ad essa

657 668

658Claude Code inoltra un gateway davanti a un cloud provider. Se la shell da cui invii seleziona il provider ed esporta il suo endpoint del gateway con il suo flag di bypass dell'autenticazione, Claude Code inoltra la coppia endpoint-e-flag alla sessione nelle condizioni che si applicano a `ANTHROPIC_BASE_URL`, insieme a `ANTHROPIC_CUSTOM_HEADERS`. Ad esempio, esporta `CLAUDE_CODE_USE_VERTEX=1` con `ANTHROPIC_VERTEX_BASE_URL` e `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, e Claude Code inoltra quell'endpoint e flag.669Claude Code inoltra un gateway davanti a un provider cloud. Se la shell da cui invii seleziona il provider ed esporta il suo endpoint del gateway con il suo flag di bypass dell'autenticazione, Claude Code inoltra la coppia endpoint-e-flag alla sessione secondo le condizioni che si applicano a `ANTHROPIC_BASE_URL`, insieme a `ANTHROPIC_CUSTOM_HEADERS`. Ad esempio, esporta `CLAUDE_CODE_USE_VERTEX=1` con `ANTHROPIC_VERTEX_BASE_URL` e `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, e Claude Code inoltra quell'endpoint e flag.

659 670

660Claude Code applica un gateway inoltrato solo al processo in esecuzione di quella sessione e non lo scrive mai su disco.671Claude Code applica un gateway inoltrato al processo in esecuzione di quella sessione solo e non lo scrive mai su disco.

661 672

662<h4 id="permission-mode">673<h4 id="permission-mode">

663 Modalità di autorizzazione674 Modalità di autorizzazione

665 676

666La [modalità di autorizzazione](/docs/it/permissions) dipende da come hai avviato la sessione:677La [modalità di autorizzazione](/docs/it/permissions) dipende da come hai avviato la sessione:

667 678

668* **Messa in background con `/bg` o `←`**: Claude Code mantiene la modalità di autorizzazione in cui era la sessione, quindi una che hai cambiato in `acceptEdits` o `auto` rimane lì dopo il distacco679* **Inviata in background con `/bg` o `←`**: Claude Code mantiene la modalità di autorizzazione in cui era la sessione, quindi una che hai cambiato in `acceptEdits` o `auto` rimane lì dopo il distacco

669* **Inviata da un agent view che hai aperto con `←`**: la configurazione del target viene prima, e la modalità di autorizzazione della sessione da cui sei venuto si applica quando nulla altro ne imposta una680* **Inviata da una vista agente che hai aperto con `←`**: la configurazione del target viene per prima, e la modalità di autorizzazione della sessione da cui sei venuto si applica quando nulla altro ne imposta una

670* **Inviata da `claude agents` avviato in una shell, o con `claude --bg`**: la nuova sessione inizia come una nuova sessione `claude` in quella directory, a meno che non l'abbia inviata da un agent view che hai aperto con [dispatch defaults](#dispatch-defaults). [Quale modalità di autorizzazione una sessione inizia](/docs/it/permission-modes#which-mode-a-session-starts-in) elenca l'ordine681* **Inviata da `claude agents` avviato in una shell, o con `claude --bg`**: la nuova sessione inizia come farebbe una nuova sessione `claude` in quella directory, a meno che non l'abbia inviata da una vista agente che hai aperto con [valori predefiniti di invio](#dispatch-defaults). [Quale modalità di autorizzazione una sessione inizia in](/docs/it/permission-modes#which-mode-a-session-starts-in) elenca l'ordine

671 682

672Per una sessione che invii da un agent view aperto con `←`, Claude Code prende la modalità di autorizzazione dal primo di questi che si applica:683Per una sessione che invii da una vista agente aperta con `←`, Claude Code prende la modalità di autorizzazione dalla prima di queste che si applica:

673 684

6741. La [`permissions.defaultMode`](/docs/it/settings-reference#permissions-defaultmode) della directory target. Due regole di origine si applicano:6851. La [`permissions.defaultMode`](/docs/it/settings-reference#permissions-defaultmode) della directory target. Due regole di origine si applicano:

675 * `auto` e `bypassPermissions` [hanno effetto solo dalle impostazioni gestite, un file `--settings`, o `~/.claude/settings.json`](/docs/it/settings-reference#permissions-defaultmode).686 * `auto` e `bypassPermissions` [hanno effetto solo da impostazioni gestite, un file `--settings` o `~/.claude/settings.json`](/docs/it/settings-reference#permissions-defaultmode).

676 * Claude Code rifiuta un `defaultMode` dal `.claude/settings.json` o `.claude/settings.local.json` del progetto che seleziona una modalità più permissiva di quella in cui era la sessione da cui sei venuto.687 * Claude Code rifiuta una `defaultMode` dal `.claude/settings.json` o `.claude/settings.local.json` del progetto che seleziona una modalità più permissiva di quella in cui era la sessione da cui sei venuto.

6772. La modalità di autorizzazione della sessione da cui sei venuto6882. La modalità di autorizzazione della sessione da cui sei venuto

678 689

679Quando Claude Code rifiuta la modalità di una fonte come troppo permissiva, la fonte successiva nell'elenco decide. Ad esempio, se invii da una sessione in modalità piano in una directory le cui impostazioni controllate chiedono `acceptEdits`, la nuova sessione inizia in modalità piano. Se sposti quel `defaultMode` a `~/.claude/settings.json`, si applica indipendentemente dalla modalità di autorizzazione della sessione da cui sei venuto.690Quando Claude Code rifiuta la modalità di una fonte come troppo permissiva, la fonte successiva nell'elenco decide. Ad esempio, se invii da una sessione in modalità piano in una directory le cui impostazioni controllate chiedono `acceptEdits`, la nuova sessione inizia in modalità piano. Se sposti quella `defaultMode` a `~/.claude/settings.json`, si applica indipendentemente dalla modalità di autorizzazione della sessione da cui sei venuto.

680 691

681La permissività corre piano, poi Manual e `dontAsk`, poi `acceptEdits` e auto, che ognuno conta come più permissivo dell'altro, poi `bypassPermissions`.692La permissività va piano, poi Manual e `dontAsk`, poi `acceptEdits` e auto, che ognuno conta come più permissivo dell'altro, poi `bypassPermissions`.

682 693

683<h4 id="dispatch-defaults">694<h4 id="dispatch-defaults">

684 Dispatch defaults695 Valori predefiniti di invio

685</h4>696</h4>

686 697

687Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di `--permission-mode`, `--model`, `--effort`, o `--agent` quando lo apri:698Per impostare i valori predefiniti per ogni sessione che invii dalla vista agente, passa uno qualsiasi di `--permission-mode`, `--model`, `--effort` o `--agent` quando la apri:

688 699

689```bash theme={null}700```bash theme={null}

690claude agents --permission-mode plan --model opus --effort high701claude agents --permission-mode plan --model opus --effort high

692 703

693`--effort` qui accetta gli stessi valori del [flag `--effort` di livello superiore](/docs/it/cli-reference#cli-flags), incluso `ultracode`.704`--effort` qui accetta gli stessi valori del [flag `--effort` di livello superiore](/docs/it/cli-reference#cli-flags), incluso `ultracode`.

694 705

695`--agent` imposta il [subagent](/docs/it/sub-agents) utilizzato quando un prompt di dispatch non ne nomina uno, sia con `@name` che come prima parola. Per impostazione predefinita, utilizza l'impostazione [`agent`](/docs/it/settings-reference#agent) se ne è impostata una, altrimenti l'agente catch-all integrato `claude`. Nominare un subagent nell'input di dispatch sovrascrive entrambi.706`--agent` imposta il [subagente](/docs/it/sub-agents) utilizzato quando un prompt di invio non ne nomina uno, né con `@name` né come prima parola. Predefinito all'[impostazione `agent`](/docs/it/settings-reference#agent) se ne è impostata una, altrimenti l'agente `claude` catch-all integrato. Nominare un subagente nell'input di invio ignora entrambi.

696 707

697`claude agents` accetta anche `--dangerously-skip-permissions` come abbreviazione per `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` per rendere `bypassPermissions` disponibile nel ciclo `Shift+Tab` di ogni sessione inviata senza avviare in quella modalità. Entrambi corrispondono ai [flag CLI di livello superiore](/docs/it/cli-reference).708`claude agents` accetta anche `--dangerously-skip-permissions` come abbreviazione per `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` per rendere `bypassPermissions` disponibile nel ciclo `Shift+Tab` di ogni sessione inviata senza iniziare in quella modalità. Entrambi corrispondono ai [flag CLI di livello superiore](/docs/it/cli-reference).

698 709

699Passa `--restricted` per avviare ogni sessione che invii dalla vista in [modalità ristretta](/docs/it/cli-reference#cli-flags), come se ognuna fosse lanciata con il flag di livello superiore `--restricted`. Richiede Claude Code v2.1.248 o successivo.710Passa `--restricted` per avviare ogni sessione che invii dalla vista in [modalità ristretta](/docs/it/cli-reference#cli-flags), come se ognuna fosse avviata con il flag di livello superiore `--restricted`. Richiede Claude Code v2.1.248 o successivo.

700 711

701I default attivi appaiono nel footer sotto l'input di dispatch.712I valori predefiniti attivi appaiono nel piè di pagina sotto l'input di invio.

702 713

703Claude Code rifiuta `claude --bg --permission-mode bypassPermissions` finché non hai accettato il disclaimer di bypass eseguendo `claude --dangerously-skip-permissions` una volta in modo interattivo, poiché quella modalità permette a una sessione che non stai guardando di agire senza approvazione. Passare `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` mostra lo stesso disclaimer quando non l'hai accettato prima, e accettare applica `bypassPermissions` alle sessioni che avvii dalla vista. Passare `--allow-dangerously-skip-permissions` mostra lo stesso disclaimer anche, e accettare rende `bypassPermissions` disponibile nel ciclo `Shift+Tab` di quelle sessioni senza avviarle in esso.714Claude Code rifiuta `claude --bg --permission-mode bypassPermissions` finché non hai accettato il disclaimer di bypass eseguendo `claude --dangerously-skip-permissions` una volta in modo interattivo, poiché quella modalità consente a una sessione che non stai osservando di agire senza approvazione. Passare `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` mostra lo stesso disclaimer quando non l'hai accettato prima, e accettare applica `bypassPermissions` alle sessioni che avvii dalla vista. Passare `--allow-dangerously-skip-permissions` mostra lo stesso disclaimer anche, e accettare rende `bypassPermissions` disponibile nel ciclo `Shift+Tab` di quelle sessioni senza avviarle in esso.

704 715

705<h4 id="what-persists-across-restarts">716<h4 id="what-persists-across-restarts">

706 Cosa persiste attraverso i riavvii717 Cosa persiste attraverso i riavvii

707</h4>718</h4>

708 719

709La modalità di autorizzazione, il modello e lo sforzo che hai scelto per una sessione in background, insieme ai [flag di configurazione che trasporta](#what-carries-over-when-you-background), persistono tutti quando il supervisore successivamente [arresta e riavvia](#the-supervisor-process) il processo della sessione. Una sessione che hai lanciato con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` rimane in `bypassPermissions` dopo quel riavvio. Un modello o sforzo che hai cambiato a metà sessione con `/model` o `/effort` viene mantenuto anche.720La modalità di autorizzazione, il modello e lo sforzo che hai scelto per una sessione in background, insieme ai [flag di configurazione che trasporta](#what-carries-over-when-you-background), persistono tutti quando il supervisore in seguito [interrompe e riavvia](#the-supervisor-process) il suo processo. Una sessione che hai avviato con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` rimane in `bypassPermissions` dopo quel riavvio. Un modello o sforzo che hai cambiato a metà sessione con `/model` o `/effort` viene mantenuto anche.

710 721

711Se la sessione ha preso il suo sforzo dalle tue impostazioni piuttosto che da `--effort` o `/effort`, Claude Code legge di nuovo le tue impostazioni ogni volta che avvia un processo per la sessione. Dopo aver modificato lo sforzo salvato in `settings.json`, il cambiamento raggiunge le sessioni che metti in background con `←` o `/bg`, e i loro successivi riavvii. Lo sforzo salvato è la chiave [`effortLevel`](/docs/it/settings-reference#effortlevel) o una voce [`modelSettings`](/docs/it/settings-reference#modelsettings).722Se la sessione ha preso il suo sforzo dalle tue impostazioni piuttosto che da `--effort` o `/effort`, Claude Code legge di nuovo le tue impostazioni ogni volta che avvia un processo per la sessione. Dopo aver modificato lo sforzo salvato in `settings.json`, il cambiamento raggiunge le sessioni che invii in background con `←` o `/bg`, e i loro riavvii successivi. Lo sforzo salvato è la chiave [`effortLevel`](/docs/it/settings-reference#effortlevel) o una voce [`modelSettings`](/docs/it/settings-reference#modelsettings).

712 723

713Claude Code mantiene anche un nome che hai impostato con [`/rename`](/docs/it/commands) o `Ctrl+R` attraverso quel riavvio, quindi puoi ancora eseguire [`claude --resume <name>`](/docs/it/sessions#name-your-sessions) per raggiungere la sessione.724Claude Code mantiene anche un nome che hai impostato con [`/rename`](/docs/it/commands) o `Ctrl+R` attraverso quel riavvio, in modo da poter ancora eseguire [`claude --resume <name>`](/docs/it/sessions#name-your-sessions) per raggiungere la sessione.

714 725

715Un prompt che hai stashed con [`Ctrl+S`](/docs/it/interactive-mode#general-controls) mentre collegato viene mantenuto con la sessione anche. Riapri la sessione dopo che il suo processo è stato fermato o riavviato, e `Ctrl+S` ripristina il testo stashed. Il contenuto incollato nello stash non sopravvive al riavvio.726Un prompt che hai nascosto con [`Ctrl+S`](/docs/it/interactive-mode#general-controls) mentre collegato viene mantenuto con la sessione anche. Riapri la sessione dopo che il suo processo è stato interrotto o riavviato, e `Ctrl+S` ripristina il testo nascosto. Il contenuto incollato nel nascondiglio non sopravvive al riavvio.

716 727

717<h3 id="settings-plugins-and-mcp-servers">728<h3 id="settings-plugins-and-mcp-servers">

718 Impostazioni, plugin, e server MCP729 Impostazioni, plugin e server MCP

719</h3>730</h3>

720 731

721Agent view accetta gli stessi flag di configurazione di `claude` per caricare impostazioni, plugin, server MCP, e directory aggiuntive. Agent view applica `--settings` e `--plugin-dir` a se stesso e passa ogni flag di configurazione alle sessioni che invii da esso, quindi un plugin o server MCP che carichi in questo modo è disponibile in quelle sessioni.732La vista agente accetta gli stessi flag di configurazione di `claude` per caricare impostazioni, plugin, server MCP e directory aggiuntive. La vista agente applica `--settings`, `--setting-sources` e `--plugin-dir` a se stessa e passa ogni flag di configurazione alle sessioni che invii da essa, quindi un plugin o server MCP che carichi in questo modo è disponibile in quelle sessioni.

722 733

723| Flag | Effetto |734| Flag | Effetto |

724| :- | :- |735| :- | :- |

737| [`--setting-sources <sources>`](/docs/it/cli-reference#cli-flags) | Carica solo le fonti di impostazioni nominate, nella vista agente e nelle sessioni inviate |

726| [`--add-dir <path>`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) | Concedi accesso ai file a una directory aggiuntiva |738| [`--add-dir <path>`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) | Concedi accesso ai file a una directory aggiuntiva |

727| [`--plugin-dir <path>`](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) | Carica un plugin da una directory locale |739| [`--plugin-dir <path>`](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) | Carica un plugin da una directory locale |

729| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando altre configurazioni MCP. Vedi [Controllo esclusivo con managed-mcp.json](/docs/it/managed-mcp#exclusive-control-with-managed-mcp-json) per cosa fa il flag sotto un file MCP gestito |741| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando altre configurazioni MCP. Vedi [Controllo esclusivo con managed-mcp.json](/docs/it/managed-mcp#exclusive-control-with-managed-mcp-json) per cosa fa il flag sotto un file MCP gestito |

730 742

731Ripeti `--add-dir`, `--plugin-dir`, o `--mcp-config` una volta per valore. `claude agents` non supporta la forma separata da spazi, come `--add-dir a b c`.743Ripeti `--add-dir`, `--plugin-dir` o `--mcp-config` una volta per valore. `claude agents` non supporta la forma separata da spazi, come `--add-dir a b c`.

732 744

733Puoi mettere `--settings` e `--plugin-dir` prima o dopo `agents`. Mantieni `--add-dir` e `--mcp-config` dopo `agents`: se metti uno di questi prima di `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) fallisce con un errore `unknown option`.745Puoi posizionare `--settings`, `--setting-sources` e `--plugin-dir` prima o dopo `agents`. Mantieni `--add-dir` e `--mcp-config` dopo `agents`: se posizioni uno di essi prima di `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) fallisce con un errore `unknown option`.

734 746

735L'esempio seguente apre agent view con un override di impostazioni e una directory extra:747L'esempio seguente apre la vista agente con un override di impostazioni e una directory aggiuntiva:

736 748

737```bash theme={null}749```bash theme={null}

738claude agents --settings ./ci-settings.json --add-dir ../shared-lib750claude agents --settings ./ci-settings.json --add-dir ../shared-lib

1048 1060

1049| Versione | Cambiamento |1061| Versione | Cambiamento |

1050| - | - |1062| - | - |

1063| v2.1.281 | Una restrizione [`--setting-sources`](/docs/it/cli-reference#cli-flags) [si trasferisce](#what-carries-over-when-you-background) a una sessione che metti in background con `←` o `/bg` e alle sessioni che invii dalla vista agente. Prima di questa versione, la sessione generata caricava ogni fonte di impostazioni. |

1064| v2.1.281 | `claude --bg`, e i comandi che riavviano una sessione, controllano la fiducia dell'area di lavoro per la directory della sessione per prima. Da un terminale in quella directory, [il dialogo di fiducia appare](#from-your-shell) se non l'hai ancora accettato; dove nessun dialogo può apparire, come in uno script, il comando esce con un errore [`Workspace not trusted`](/docs/it/errors#workspace-not-trusted-when-dispatching-a-background-session). |

1065| v2.1.274 | Dopo un auto-aggiornamento, una vista agente da cui sei stato assente per circa un'ora può riavviarsi sulla nuova build. Quando lo fa, mantiene i [valori predefiniti di dispatch](#dispatch-defaults) con cui l'hai aperta: `--model`, `--effort`, `--permission-mode`, `--allow-dangerously-skip-permissions`, e `--agent`. Prima di questa versione, la vista riavviata manteneva solo `--cwd` e i flag di configurazione come `--settings` e `--mcp-config`, quindi le sessioni che inviavi successivamente iniziavano senza quei valori predefiniti. |

1066| v2.1.274 | Quando un [delete è rifiutato](#what-deleting-a-session-removes) perché git o il tuo hook `WorktreeRemove` non poteva rimuovere il worktree, un submodulo estratto che Claude Code verifica non ha modifiche non sottoposte a commit ai file tracciati non blocca l'offerta di eliminare di nuovo e rimuovere comunque la directory. Le modifiche non sottoposte a commit all'interno di un submodulo estratto contano come modifiche non sottoposte a commit, e il messaggio nomina il submodulo. Prima di questa versione, qualsiasi checkout di submodulo nel worktree bloccava l'offerta, con un messaggio che diceva che il worktree contiene un repository annidato. |

1051| v2.1.268 | Quando un [delete è rifiutato](#what-deleting-a-session-removes) perché git o il tuo hook `WorktreeRemove` non poteva rimuovere il worktree, il messaggio nomina la causa, incluso come un hook è terminato e l'inizio del suo stderr. Per un worktree collegato sotto la directory `.claude/worktrees/` del repository senza modifiche non sottoposte a commit ai file tracciati, nessun repository annidato al suo interno, e nessun record di un'altra sessione che lo nomina, eliminare di nuovo la sessione rimuove comunque la directory, dalla vista agente o con `claude rm <id> --force-remove-worktree <worktree-id>`. Prima di questa versione, la riga mostrava solo `worktree could not be removed (WorktreeRemove hook failed)` o l'errore di git, lo stderr dell'hook andava solo al log di debug, e eliminare di nuovo era rifiutato allo stesso modo. |1067| v2.1.268 | Quando un [delete è rifiutato](#what-deleting-a-session-removes) perché git o il tuo hook `WorktreeRemove` non poteva rimuovere il worktree, il messaggio nomina la causa, incluso come un hook è terminato e l'inizio del suo stderr. Per un worktree collegato sotto la directory `.claude/worktrees/` del repository senza modifiche non sottoposte a commit ai file tracciati, nessun repository annidato al suo interno, e nessun record di un'altra sessione che lo nomina, eliminare di nuovo la sessione rimuove comunque la directory, dalla vista agente o con `claude rm <id> --force-remove-worktree <worktree-id>`. Prima di questa versione, la riga mostrava solo `worktree could not be removed (WorktreeRemove hook failed)` o l'errore di git, lo stderr dell'hook andava solo al log di debug, e eliminare di nuovo era rifiutato allo stesso modo. |

1052| v2.1.268 | Dopo che il primo `←` mostra `Press ← again to open agents`, o `Press ← again to go back to agents` in una sessione collegata, [la prima pressione che arriva almeno un secondo dopo passa](#switch-sessions-without-leaving-the-terminal), anche quando le pressioni più veloci nel mezzo erano ignorate. Prima di questa versione, ogni pressione ignorata riavviava l'attesa, quindi premere `←` di nuovo a un ritmo costante non passava fino a quando non facevi una pausa per più di un secondo. |1068| v2.1.268 | Dopo che il primo `←` mostra `Press ← again to open agents`, o `Press ← again to go back to agents` in una sessione collegata, [la prima pressione che arriva almeno un secondo dopo passa](#switch-sessions-without-leaving-the-terminal), anche quando le pressioni più veloci nel mezzo erano ignorate. Prima di questa versione, ogni pressione ignorata riavviava l'attesa, quindi premere `←` di nuovo a un ritmo costante non passava fino a quando non facevi una pausa per più di un secondo. |

1053| v2.1.260 | Quando [metti in background una sessione](#from-inside-a-session), l'[elenco agente](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach) delle tue altre sessioni mostra la conversazione una volta, come sua sessione in background, e i loro messaggi ad essa non raggiungono più il terminale da cui l'hai spostata. Prima di questa versione, quel terminale poteva rimanere elencato come una seconda sessione interattiva sotto il nome della conversazione, e una sessione che aveva inviato un messaggio alla conversazione prima dello spostamento continuava a consegnare a quel terminale. |1069| v2.1.260 | Quando [metti in background una sessione](#from-inside-a-session), l'[elenco agente](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach) delle tue altre sessioni mostra la conversazione una volta, come sua sessione in background, e i loro messaggi ad essa non raggiungono più il terminale da cui l'hai spostata. Prima di questa versione, quel terminale poteva rimanere elencato come una seconda sessione interattiva sotto il nome della conversazione, e una sessione che aveva inviato un messaggio alla conversazione prima dello spostamento continuava a consegnare a quel terminale. |

agents.md +1 −1

Details

13| [Subagenti](/docs/it/sub-agents) | Lavoratori delegati all'interno di una sessione che svolgono un compito secondario nel loro contesto e restituiscono un riepilogo | Un compito secondario allagherebbe la Vostra conversazione principale con risultati di ricerca, log o contenuti di file che non consulterete di nuovo |13| [Subagenti](/docs/it/sub-agents) | Lavoratori delegati all'interno di una sessione che svolgono un compito secondario nel loro contesto e restituiscono un riepilogo | Un compito secondario allagherebbe la Vostra conversazione principale con risultati di ricerca, log o contenuti di file che non consulterete di nuovo |

14| [Visualizzazione agenti](/docs/it/agent-view) | Una schermata per inviare e monitorare sessioni in esecuzione in background, aperta con `claude agents`. Anteprima di ricerca | Avete diversi compiti indipendenti e volete delegarli, controllare lo stato a colpo d'occhio e intervenire solo quando uno ha bisogno di voi |14| [Visualizzazione agenti](/docs/it/agent-view) | Una schermata per inviare e monitorare sessioni in esecuzione in background, aperta con `claude agents`. Anteprima di ricerca | Avete diversi compiti indipendenti e volete delegarli, controllare lo stato a colpo d'occhio e intervenire solo quando uno ha bisogno di voi |

15| [Team di agenti](/docs/it/agent-teams) | Più sessioni coordinate con un elenco di attività condiviso e messaggistica tra agenti, gestite da un leader. Sperimentale e disabilitato per impostazione predefinita | Volete che Claude divida un progetto in parti, le assegni e mantenga i lavoratori sincronizzati |15| [Team di agenti](/docs/it/agent-teams) | Più sessioni coordinate con un elenco di attività condiviso e messaggistica tra agenti, gestite da un leader. Sperimentale e disabilitato per impostazione predefinita | Volete che Claude divida un progetto in parti, le assegni e mantenga i lavoratori sincronizzati |

16| [Progetti](/docs/it/claude-projects) | Una conversazione in corso su claude.ai/code o nell'app desktop. Claude avvia sessioni cloud parallele chiamate thread, fornisce a ciascuna i repository, le istruzioni e la memoria del progetto, e vi mostra quali hanno bisogno di voi. Beta pubblica su Pro e Max | Il lavoro si estende su molti compiti nel corso di giorni o settimane, dovrebbe continuare a funzionare quando la Vostra macchina è spenta, e preferite descriverlo una volta piuttosto che inviare e tracciare ogni sessione |16| [Progetti](/docs/it/claude-projects) | Una conversazione in corso su claude.ai/code o nell'app desktop. Claude avvia sessioni parallele chiamate thread, nel cloud o, quando lo chiedete, sul vostro computer tramite Remote Control, fornisce a ciascuna le istruzioni del progetto e vi mostra quali hanno bisogno di voi. Beta pubblica su Pro e Max | Il lavoro si estende su molti compiti nel corso di giorni o settimane, dovrebbe continuare a funzionare quando la Vostra macchina è spenta, e preferite descriverlo una volta piuttosto che inviare e tracciare ogni sessione |

17| [Flussi di lavoro dinamici](/docs/it/workflows) | Uno script che esegue molti subagenti e controlla i loro risultati, per un lavoro troppo grande per coordinare in un solo turno o che necessita di più di un singolo passaggio | Un compito è troppo grande per una manciata di subagenti, oppure volete che i risultati siano verificati l'uno contro l'altro: un audit a livello di codebase, una migrazione di 500 file, ricerca verificata in modo incrociato, o un piano elaborato da diversi angoli |17| [Flussi di lavoro dinamici](/docs/it/workflows) | Uno script che esegue molti subagenti e controlla i loro risultati, per un lavoro troppo grande per coordinare in un solo turno o che necessita di più di un singolo passaggio | Un compito è troppo grande per una manciata di subagenti, oppure volete che i risultati siano verificati l'uno contro l'altro: un audit a livello di codebase, una migrazione di 500 file, ricerca verificata in modo incrociato, o un piano elaborato da diversi angoli |

18 18

19In ogni approccio i lavoratori sono sessioni Claude. Per coinvolgere uno strumento diverso, esponilo a Claude come [server MCP](/docs/it/mcp).19In ogni approccio i lavoratori sono sessioni Claude. Per coinvolgere uno strumento diverso, esponilo a Claude come [server MCP](/docs/it/mcp).

artifacts.md +35 −3

Details

305 305

306Per la tipografia, Claude può caricare un carattere da Google Fonts, l'unica fonte di font esterno che una pagina artifact può caricare. Claude incorpora qualsiasi altro carattere come data URI `@font-face` e assegna a ogni carattere uno stack di fallback, quindi la pagina viene comunque visualizzata se un font non si carica. Per utilizzare un carattere specifico, nominate lo nel vostro prompt o nel vostro sistema di design.306Per la tipografia, Claude può caricare un carattere da Google Fonts, l'unica fonte di font esterno che una pagina artifact può caricare. Claude incorpora qualsiasi altro carattere come data URI `@font-face` e assegna a ogni carattere uno stack di fallback, quindi la pagina viene comunque visualizzata se un font non si carica. Per utilizzare un carattere specifico, nominate lo nel vostro prompt o nel vostro sistema di design.

307 307

308<h2 id="draft-a-design-canvas">308<h2 id="start-from-a-slides-design-or-docs-template">

309 Bozza di una tela di progettazione309 Inizia da un modello di Slides, Design o Docs

310</h2>310</h2>

311 311

312Invece di costruire una pagina da zero, Claude può avviare un artefatto da uno dei modelli sul tuo account claude.ai: [Claude Slides](https://support.claude.com/en/articles/17153992-what-are-artifacts-and-how-do-i-use-them#h_11d5a9a5fa) per una presentazione, [Claude Design](https://support.claude.com/en/articles/14604416-get-started-with-claude-design) per un progetto visivo, o [Claude Docs](https://support.claude.com/en/articles/16923645-get-started-with-claude-docs) per un documento che altre persone leggeranno e modificheranno. Ognuno si apre nel suo editor su claude.ai, dove tu e i tuoi colleghi lo modificate direttamente o chiedete a Claude di farlo, ed esportarlo in formati come PowerPoint, PDF o Word.

313

314Per iniziare da un modello, descrivi quello che vuoi, ad esempio "trasforma le note di migrazione in una presentazione per la revisione di giovedì" o "scrivi questo piano come un documento per il team". Claude sceglie il modello corrispondente, lo riempie dalla tua richiesta e da quello che la sessione già contiene, e ti dà il link. Per una presentazione o un progetto puoi anche eseguire `/slides` o `/design` con un breve.

315

316<Note>

317 I modelli sono in beta. Sono attivati per impostazione predefinita sui piani Pro, Max e Team. Sui piani Enterprise, un Owner [attiva ogni modello](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) in **Organization settings > Artifacts**. Se la tua organizzazione ha il modello Slides disattivato, `/slides` non appare; se ha il modello Design disattivato, `/design` non bozza progetti. Entrambi i comandi richiedono Claude Code v2.1.265 o versioni successive e una sessione in cui [gli artefatti sono disponibili](#availability).

318</Note>

319

320<h3 id="make-a-slide-deck">

321 Crea una presentazione

322</h3>

323

324Esegui `/slides` con un breve che dice cosa copre la presentazione e per chi è:

325

326```text wrap theme={null}

327/slides a quarterly review of the platform team's reliability work, for the engineering all-hands

328```

329

330Claude crea un artefatto Claude Slides e ti dà il link. Aprilo in un browser desktop per modificare o presentare la presentazione. Se esegui `/slides` senza un breve, Claude ti chiede di cosa dovrebbe trattare la presentazione prima di creare qualcosa.

331

332<h3 id="draft-a-design-canvas">

333 Bozza di una tela di progettazione

334</h3>

335

312Per creare un mockup di un'interfaccia utente, un flusso di schermata, una pagina di destinazione o un poster piuttosto che costruire una pagina, eseguire `/design` con un breve. Claude bozza il progetto come tavole da disegno su una tela e pubblica la tela come un artefatto Design. Il breve nomina ciò che desiderate disegnare:336Per creare un mockup di un'interfaccia utente, un flusso di schermata, una pagina di destinazione o un poster piuttosto che costruire una pagina, eseguire `/design` con un breve. Claude bozza il progetto come tavole da disegno su una tela e pubblica la tela come un artefatto Design. Il breve nomina ciò che desiderate disegnare:

313 337

314```text wrap theme={null}338```text wrap theme={null}

317 341

318Apri l'artefatto pubblicato in un browser desktop per rivedere le tavole da disegno. Seleziona un elemento su una tavola da disegno e modificalo, e le tue modifiche vengono salvate automaticamente. Puoi esportare ogni tavola da disegno come PNG o PDF.342Apri l'artefatto pubblicato in un browser desktop per rivedere le tavole da disegno. Seleziona un elemento su una tavola da disegno e modificalo, e le tue modifiche vengono salvate automaticamente. Puoi esportare ogni tavola da disegno come PNG o PDF.

319 343

320`/design` richiede una sessione in cui [gli artefatti sono disponibili](#availability) e Claude Code v2.1.265 o versioni successive.344<h3 id="write-a-document-with-claude-docs">

345 Scrivi un documento con Claude Docs

346</h3>

347

348Claude Docs raggiunge Claude Code come un [connettore](/docs/it/mcp#use-mcp-servers-from-claude-ai) di claude.ai piuttosto che come un comando. Quando è connesso, `/mcp` lo elenca come `claude.ai Claude Docs`. Una richiesta per un documento destinato ad altre persone va quindi a Claude Docs invece di una pagina di artefatto: una specifica, una proposta, o una descrizione del piano che hai elaborato nella sessione. Claude ti dà il link del documento quando è stato bozzato.

349

350Un documento che appartiene al codebase, come un README, rimane un file. Per ottenere un file per qualcosa che Claude altrimenti metterebbe in Claude Docs, specifica il formato, come `.docx` o un file Markdown nel repository.

351

352Per disattivare il connettore, aggiungi `claude.ai Claude Docs` a `deniedMcpServers` o usa l'interruttore `/mcp`, entrambi descritti in [Disabilita i connettori claude.ai](/docs/it/mcp#disable-claude-ai-connectors).

321 353

322<h2 id="page-constraints">354<h2 id="page-constraints">

323 Vincoli della pagina355 Vincoli della pagina

authentication.md +45 −19

Details

32 32

33Per disconnettervi e autenticarvi di nuovo, digitate `/logout` al prompt di Claude Code. La disconnessione ripristina anche lo stato di configurazione al primo avvio, quindi la prossima volta che eseguite `claude` vi guida attraverso l'accesso e la configurazione di nuovo.33Per disconnettervi e autenticarvi di nuovo, digitate `/logout` al prompt di Claude Code. La disconnessione ripristina anche lo stato di configurazione al primo avvio, quindi la prossima volta che eseguite `claude` vi guida attraverso l'accesso e la configurazione di nuovo.

34 34

35Per restare connessi a più account contemporaneamente, come account di lavoro e personali, assegnate a ogni account la propria directory di configurazione. Quando avviate `claude`, impostate la variabile di ambiente [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars#variables) sulla directory per l'account che desiderate utilizzare. Ogni directory ha le proprie impostazioni, cronologia della sessione e accesso a claude.ai o chiave API. Ad esempio, in Bash o Zsh, aggiungete questo alias a `~/.bashrc` o `~/.zshrc` in modo che `claude-work` utilizzi il vostro account di lavoro mentre `claude` mantiene quello personale:

37```bash theme={null}

38alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

39```

41Dopo aver aperto un nuovo terminale ed eseguito `claude-work` per la prima volta, Claude Code vi guida attraverso l'accesso e la configurazione per la nuova directory. Le directory separate non mantengono due accessi a Claude Console [senza una chiave API](#sign-in-without-an-api-key) separati, perché Claude Code memorizza questo tipo di accesso al di fuori della directory di configurazione.

35Se avete difficoltà ad accedere, consultate la sezione [risoluzione dei problemi di autenticazione](/docs/it/troubleshoot-install#login-and-authentication).43Se avete difficoltà ad accedere, consultate la sezione [risoluzione dei problemi di autenticazione](/docs/it/troubleshoot-install#login-and-authentication).

36 44

37<h2 id="set-up-team-authentication">45<h2 id="set-up-team-authentication">

122* Qualsiasi file di impostazioni imposta [`forceLoginOrgUUID`](#restrict-login-to-your-organization), o imposta `forceLoginMethod` su `"claudeai"` o `"console"`130* Qualsiasi file di impostazioni imposta [`forceLoginOrgUUID`](#restrict-login-to-your-organization), o imposta `forceLoginMethod` su `"claudeai"` o `"console"`

123* Una fonte di impostazioni gestite sulla vostra macchina, come il file di impostazioni gestite, un profilo MDM, o le impostazioni gestite dal server memorizzate nella cache, esiste ma Claude Code [non può leggerla](/docs/it/managed-settings#invalid-entries-in-managed-settings) e nessun'altra fonte gestita fornisce una policy131* Una fonte di impostazioni gestite sulla vostra macchina, come il file di impostazioni gestite, un profilo MDM, o le impostazioni gestite dal server memorizzate nella cache, esiste ma Claude Code [non può leggerla](/docs/it/managed-settings#invalid-entries-in-managed-settings) e nessun'altra fonte gestita fornisce una policy

124 132

125Annullate l'impostazione di `ANTHROPIC_API_KEY` prima di accedere senza una chiave. Un profilo scritto dall'accesso Console di Claude Code stesso, o dall'accesso `ant auth login` della CLI Claude Platform, è lo stesso tipo di credenziale, quindi accedere di nuovo lo sostituisce.133Annullate l'impostazione di `ANTHROPIC_API_KEY` prima di accedere senza una chiave.

126 134

127Dopo aver effettuato l'accesso senza una chiave, avete un profilo invece di una chiave API memorizzata:135Dopo aver effettuato l'accesso senza una chiave, avete un profilo invece di una chiave API memorizzata:

128 136

160 168

161Per richiedere che gli accessi claude.ai degli sviluppatori appartengano a una specifica organizzazione Anthropic, impostate [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) e [`forceLoginOrgUUID`](/docs/it/settings-reference#forceloginorguuid) nelle [impostazioni gestite](/docs/it/managed-settings). Impostate `forceLoginOrgUUID` al vostro ID organizzazione, mostrato nelle [impostazioni di amministrazione claude.ai](https://claude.ai/admin-settings/organization) per le organizzazioni Claude for Teams o Enterprise. Claude Code segnala un errore per un accesso claude.ai a qualsiasi altra organizzazione e esce all'avvio se la credenziale claude.ai in uso appartiene a un'organizzazione che non è elencata.169Per richiedere che gli accessi claude.ai degli sviluppatori appartengano a una specifica organizzazione Anthropic, impostate [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) e [`forceLoginOrgUUID`](/docs/it/settings-reference#forceloginorguuid) nelle [impostazioni gestite](/docs/it/managed-settings). Impostate `forceLoginOrgUUID` al vostro ID organizzazione, mostrato nelle [impostazioni di amministrazione claude.ai](https://claude.ai/admin-settings/organization) per le organizzazioni Claude for Teams o Enterprise. Claude Code segnala un errore per un accesso claude.ai a qualsiasi altra organizzazione e esce all'avvio se la credenziale claude.ai in uso appartiene a un'organizzazione che non è elencata.

162 170

163Per gli accessi Claude Console, Claude Code utilizza `forceLoginOrgUUID` per pre-selezionare l'organizzazione nella pagina di accesso Console quando lo impostate su un singolo ID organizzazione Console, mostrato su [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Non controlla a quale organizzazione appartiene la credenziale Console risultante, all'accesso o all'avvio, e uno sviluppatore che ha effettuato l'accesso con un account Console prima che distribuiste le chiavi rimane connesso.171Per gli accessi Claude Console, Claude Code utilizza `forceLoginOrgUUID` per pre-selezionare l'organizzazione nella pagina di accesso Console quando lo impostate su un singolo ID organizzazione Console, mostrato su [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Non controlla a quale organizzazione appartiene la credenziale Console risultante, all'accesso o all'avvio. Uno sviluppatore che ha effettuato l'accesso con un account Console prima che distribuiste le chiavi rimane connesso, e quella chiave salvata è bloccata su una macchina che richiede anche l'accesso [gateway](/docs/it/claude-apps-gateway) o in una sessione che seleziona un provider cloud.

164 172

165Se impostate `forceLoginOrgUUID` in qualsiasi file di impostazioni, Claude Code smette di offrire l'[accesso Console senza chiave](#sign-in-without-an-api-key) nelle sessioni a cui si applica quel file e crea una chiave API. Per indirizzare gli sviluppatori all'accesso claude.ai, impostate `forceLoginMethod` su `"claudeai"`.173Se impostate `forceLoginOrgUUID` in qualsiasi file di impostazioni, Claude Code smette di offrire l'[accesso Console senza chiave](#sign-in-without-an-api-key) nelle sessioni a cui si applica quel file e crea una chiave API. Per indirizzare gli sviluppatori all'accesso claude.ai, impostate `forceLoginMethod` su `"claudeai"`.

166 174

167Gli sviluppatori possono accedere da diversi percorsi: il flusso terminale `/login`, l'[estensione VS Code](/docs/it/vs-code), l'Agent SDK, `claude setup-token`, `/install-github-app`, e l'accesso [gateway](/docs/it/claude-apps-gateway) per le organizzazioni che instradano attraverso un gateway cloud. Su Claude Code v2.1.212 o successivo, ogni percorso applica `forceLoginMethod`; prima di v2.1.212, solo gli accessi terminali applicavano entrambe le chiavi. Sulla schermata di accesso interattiva del terminale, raggiunta da `/login` o dall'onboarding al primo avvio, Claude Code pre-seleziona un metodo `claudeai` o `console` senza applicarlo, quindi anche con `forceLoginMethod` impostato su `"claudeai"`, uno sviluppatore può comunque completare un accesso Console lì. I percorsi differiscono su `forceLoginOrgUUID`:175Su Claude Code v2.1.212 o successivo, ogni percorso di accesso elencato qui applica `forceLoginMethod`. Sulla schermata di accesso interattiva del terminale, raggiunta da `/login` o dall'onboarding al primo avvio, Claude Code pre-seleziona un metodo `claudeai` o `console` senza applicarlo, quindi anche con `forceLoginMethod` impostato su `"claudeai"`, uno sviluppatore può comunque completare un accesso Console lì.

168 176

169* **Accessi terminale, estensione VS Code e Agent SDK**: verificano `forceLoginOrgUUID` per gli accessi dell'account claude.ai177I percorsi differiscono su `forceLoginOrgUUID`:

178

179* **Accessi terminale, [estensione VS Code](/docs/it/vs-code), e Agent SDK**: verificano `forceLoginOrgUUID` per gli accessi dell'account claude.ai

170* **`claude setup-token` e `/install-github-app`**: applicano solo `forceLoginMethod`, quindi possono coniare un token in un'organizzazione diversa180* **`claude setup-token` e `/install-github-app`**: applicano solo `forceLoginMethod`, quindi possono coniare un token in un'organizzazione diversa

171* **Accesso [gateway](/docs/it/claude-apps-gateway)**: selezionato da `forceLoginMethod: "gateway"` piuttosto che limitato da esso, e non autentica rispetto a un'organizzazione Anthropic, quindi `forceLoginOrgUUID` non si applica; utilizzate il vostro provider di identità gateway per limitare l'accesso181* **Accesso [gateway](/docs/it/claude-apps-gateway)**: selezionato da `forceLoginMethod: "gateway"` piuttosto che limitato da esso, e non autentica rispetto a un'organizzazione Anthropic, quindi `forceLoginOrgUUID` non si applica; utilizzate il vostro provider di identità gateway per limitare l'accesso

172 182

173Distribuite le chiavi attraverso il vostro strumento di gestione dei dispositivi. Le [impostazioni gestite dal server](/docs/it/server-managed-settings) raggiungono solo gli account che sono già autenticati nella vostra organizzazione, quindi non possono reindirizzare il primo accesso di uno sviluppatore. Se la vostra organizzazione distribuisce anche impostazioni gestite dal server, impostate le chiavi in entrambi i luoghi: le fonti di impostazioni gestite [non si uniscono](/docs/it/server-managed-settings#settings-precedence), e le impostazioni gestite dal server memorizzate nella cache sostituiscono il file gestito dal dispositivo, a parte alcuni [eccezioni per chiave](/docs/it/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` e i valori `"claudeai"` e `"console"` di `forceLoginMethod` non sono tra quelle eccezioni, quindi manteneteli in entrambi i luoghi.183Distribuite le chiavi attraverso il vostro strumento di gestione dei dispositivi. Le [impostazioni gestite dal server](/docs/it/server-managed-settings) raggiungono solo gli account che sono già autenticati nella vostra organizzazione, quindi non possono reindirizzare il primo accesso di uno sviluppatore. Se la vostra organizzazione distribuisce anche impostazioni gestite dal server, impostate le chiavi in entrambi i luoghi: le fonti di impostazioni gestite [non si uniscono](/docs/it/server-managed-settings#settings-precedence), e le impostazioni gestite dal server memorizzate nella cache sostituiscono il file gestito dal dispositivo, a parte alcuni [eccezioni per chiave](/docs/it/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` e i valori `"claudeai"` e `"console"` di `forceLoginMethod` non sono tra quelle eccezioni, quindi manteneteli in entrambi i luoghi.

174 184

185In una distribuzione [gateway](/docs/it/claude-apps-gateway), mantenete anche `forceLoginMethod` e `forceLoginOrgUUID` fuori dalle [impostazioni che il gateway serve](/docs/it/claude-apps-gateway-config#managed).

186

175Le chiavi decidono anche se una sessione che non utilizza una credenziale di accesso può iniziare. Vedete [`forceLoginOrgUUID`](/docs/it/settings-reference#forceloginorguuid) nel riferimento delle impostazioni per il comportamento completo.187Le chiavi decidono anche se una sessione che non utilizza una credenziale di accesso può iniziare. Vedete [`forceLoginOrgUUID`](/docs/it/settings-reference#forceloginorguuid) nel riferimento delle impostazioni per il comportamento completo.

176 188

177* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper`**: bloccati all'avvio, poiché l'appartenenza all'organizzazione non può essere verificata per una credenziale di ambiente189* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper`**: bloccati all'avvio. Sotto `forceLoginOrgUUID`, l'appartenenza all'organizzazione non può essere verificata per una credenziale di ambiente, e sotto `forceLoginMethod` la credenziale starebbe al posto dell'accesso richiesto. Quando le impostazioni gestite richiedono anche l'accesso [gateway](/docs/it/claude-apps-gateway), Claude Code blocca una chiave API salvata da un precedente accesso Claude Console allo stesso modo. Vedete [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in)

178* **Sessioni del provider cloud come Amazon Bedrock**: non bloccate, perché si autenticano rispetto al vostro provider cloud. Limitatele attraverso le vostre policy IAM cloud190* **Sessioni del provider cloud come Amazon Bedrock**: bloccate solo mentre una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper`, o una chiave API salvata da un precedente accesso Claude Console, è ancora presente sulla macchina. Rimuovetela e la sessione inizia. Queste sessioni si autenticano rispetto al vostro provider cloud, le cui policy di accesso le governano

179* **[Profilo Anthropic o credenziali di federazione](#anthropic-profiles-and-federation-credentials)**: non bloccate, e le chiavi non controllano a quale organizzazione appartiene il profilo191* **[Profilo Anthropic o credenziali di federazione](#anthropic-profiles-and-federation-credentials)**: non bloccate a meno che una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper`, o una chiave API salvata da un precedente accesso Claude Console, sia anche presente sulla macchina. Le chiavi non controllano a quale organizzazione appartiene il profilo

180 192

181<h2 id="credential-management">193<h2 id="credential-management">

182 Gestione delle credenziali194 Gestione delle credenziali

192 * Claude Code gestisce `.credentials.json` attraverso `/login` e `/logout`. Per instradare le richieste attraverso un endpoint API personalizzato, impostate invece la variabile di ambiente [`ANTHROPIC_BASE_URL`](/docs/it/env-vars).204 * Claude Code gestisce `.credentials.json` attraverso `/login` e `/logout`. Per instradare le richieste attraverso un endpoint API personalizzato, impostate invece la variabile di ambiente [`ANTHROPIC_BASE_URL`](/docs/it/env-vars).

193* **Tipi di autenticazione supportati**: credenziali claude.ai, credenziali API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, credenziali del profilo Anthropic e [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), e token di sessione del [gateway delle app Claude](/docs/it/claude-apps-gateway).205* **Tipi di autenticazione supportati**: credenziali claude.ai, credenziali API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, credenziali del profilo Anthropic e [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), e token di sessione del [gateway delle app Claude](/docs/it/claude-apps-gateway).

194* **Script di credenziali personalizzati**: configurate l'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) per eseguire uno script shell che restituisce una chiave API.206* **Script di credenziali personalizzati**: configurate l'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) per eseguire uno script shell che restituisce una chiave API.

195* **Intervalli di aggiornamento**: Claude Code esegue di nuovo `apiKeyHelper` dopo cinque minuti per impostazione predefinita. Impostate la variabile di ambiente `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` per intervalli di aggiornamento personalizzati. Consultate [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) per gli altri casi in cui Claude Code esegue di nuovo l'helper.207* **Intervalli di aggiornamento**: consultate [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) per i casi in cui Claude Code esegue di nuovo l'helper.

196* **Avviso di helper lento**: se `apiKeyHelper` impiega più di 10 secondi per restituire una chiave, Claude Code visualizza un avviso nella barra del prompt mostrando il tempo trascorso. Se vedete questo avviso regolarmente, verificate se lo script di credenziali può essere ottimizzato.208* **Avviso di helper lento**: se `apiKeyHelper` impiega più di 10 secondi per restituire una chiave, Claude Code visualizza un avviso nella barra del prompt mostrando il tempo trascorso. Se vedete questo avviso regolarmente, verificate se lo script di credenziali può essere ottimizzato.

197* **Errori dell'helper**: quando lo script esce con un errore, scade il timeout, o non stampa nulla, le richieste falliscono con [`Your apiKeyHelper script is failing`](/docs/it/errors#your-apikeyhelper-script-is-failing) entro tre tentativi. Prima della v2.1.208, gli errori dell'helper emergevano come un generico 401 dopo circa dieci tentativi silenziosi.209* **Errori dell'helper**: quando lo script esce con un errore, scade il timeout, o non stampa nulla, le richieste falliscono con [`Your apiKeyHelper script is failing`](/docs/it/errors#your-apikeyhelper-script-is-failing) entro tre tentativi.

198 210

199`apiKeyHelper`, `ANTHROPIC_API_KEY`, e `ANTHROPIC_AUTH_TOKEN` si applicano alla CLI e alle superfici che la avvolgono, inclusa l'estensione VS Code, l'Agent SDK, e GitHub Actions. Claude Desktop e le sessioni cloud non chiamano `apiKeyHelper` né leggono queste variabili di ambiente: utilizzano OAuth, ad eccezione delle sessioni desktop che eseguono una [configurazione di inferenza di terze parti](/docs/it/llm-gateway-connect#desktop-app), che si autenticano con le credenziali di quella configurazione.211`apiKeyHelper`, `ANTHROPIC_API_KEY`, e `ANTHROPIC_AUTH_TOKEN` si applicano alla CLI e alle superfici che la avvolgono, inclusa l'estensione VS Code, l'Agent SDK, e GitHub Actions. Claude Desktop e le sessioni cloud non chiamano `apiKeyHelper` né leggono queste variabili di ambiente: utilizzano OAuth, ad eccezione delle sessioni desktop che eseguono una [configurazione di inferenza di terze parti](/docs/it/llm-gateway-connect#desktop-app), che si autenticano con le credenziali di quella configurazione.

200 212

202 Rinnovare un accesso in scadenza214 Rinnovare un accesso in scadenza

203</h3>215</h3>

204 216

205Quando l'accesso creato con `/login` è entro tre giorni dalla scadenza, Claude Code mostra un avviso all'avvio: `Your login expires in 3 days · run /login to renew`. Richiede Claude Code v2.1.203 o successivo. Prima della v2.1.217, l'avviso appariva cinque giorni prima.217Quando l'accesso creato con `/login` è entro tre giorni dalla scadenza, Claude Code mostra un avviso all'avvio: `Your login expires in 3 days · run /login to renew`.

206 218

207Eseguite `/login` per rinnovare. L'avviso è informativo e non blocca mai una richiesta: l'autenticazione continua a funzionare fino a quando l'accesso non scade effettivamente. La durata dell'accesso stesso rimane invariata; l'avviso anticipato è ciò che v2.1.203 aggiunge.219Eseguite `/login` per rinnovare. L'avviso è informativo e non blocca mai una richiesta: l'autenticazione continua a funzionare fino a quando l'accesso non scade effettivamente.

208 220

209Una volta che l'accesso archiviato scade e non può essere aggiornato, ogni richiesta del modello fallisce con [`Login expired · Please run /login`](/docs/it/errors#login-expired) fino a quando non accedete di nuovo. Prima della v2.1.206, Claude Code segnalava un accesso scaduto sulle richieste del modello come un errore del modello.221Una volta che l'accesso archiviato scade e non può essere aggiornato, ogni richiesta del modello fallisce con [`Login expired · Please run /login`](/docs/it/errors#login-expired) fino a quando non accedete di nuovo.

210 222

211Potete verificare questo stato prima che una richiesta fallisca: [`/status`](/docs/it/commands) mostra una riga `Login` che legge `Expired — log in again`, più l'organizzazione e l'email che ha salvato per l'accesso scaduto. La riga appare solo quando l'accesso claude.ai o Claude Console salvato è la credenziale attiva. La riga richiede Claude Code v2.1.210 o successivo.223Potete verificare questo stato prima che una richiesta fallisca: [`/status`](/docs/it/commands) mostra una riga `Login` che legge `Expired — log in again`, più l'organizzazione e l'email che ha salvato per l'accesso scaduto. La riga appare solo quando l'accesso claude.ai o Claude Console salvato è la credenziale attiva. La riga richiede Claude Code v2.1.210 o successivo.

212 224

230 242

231Una sessione del [gateway delle app Claude](/docs/it/claude-apps-gateway) autenticata si trova al di fuori di questo elenco: è una selezione di provider come Amazon Bedrock o Google Cloud's Agent Platform, e ha la precedenza su di essi. Quando esiste una sessione gateway, la CLI si autentica con il token gateway anche se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, o `CLAUDE_CODE_USE_FOUNDRY` è impostato, e le fonti di credenziali sopra come il bearer token, la chiave API, `apiKeyHelper`, e i profili non vengono utilizzati.243Una sessione del [gateway delle app Claude](/docs/it/claude-apps-gateway) autenticata si trova al di fuori di questo elenco: è una selezione di provider come Amazon Bedrock o Google Cloud's Agent Platform, e ha la precedenza su di essi. Quando esiste una sessione gateway, la CLI si autentica con il token gateway anche se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, o `CLAUDE_CODE_USE_FOUNDRY` è impostato, e le fonti di credenziali sopra come il bearer token, la chiave API, `apiKeyHelper`, e i profili non vengono utilizzati.

232 244

233Se le [impostazioni gestite](/docs/it/managed-settings) della Vostra macchina impostano [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) a `"gateway"` o impostano [`forceLoginGatewayUrl`](/docs/it/settings-reference#forcelogingatewayurl), e non selezionate un provider cloud attraverso una variabile come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, la Vostra sessione utilizza solo l'accesso gateway. Claude Code salta le altre fonti di credenziali e vi chiede di accedere con `/login`. Consultate [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) per quello che vedete con ogni credenziale residua. Prima della v2.1.261, o prima della v2.1.265 su una macchina che imposta solo `forceLoginGatewayUrl`, Claude Code utilizzava un accesso salvato residuo su queste macchine fino a quando non avete effettuato l'accesso al gateway.245Se le [impostazioni gestite](/docs/it/managed-settings) della Vostra macchina impostano [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) a `"gateway"` o impostano [`forceLoginGatewayUrl`](/docs/it/settings-reference#forcelogingatewayurl), e non selezionate un provider cloud attraverso una variabile come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, la Vostra sessione utilizza solo l'accesso gateway. Claude Code salta le altre fonti di credenziali e vi chiede di accedere con `/login`. Consultate [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) per quello che vedete con ogni credenziale residua. Richiede Claude Code v2.1.261 o successivo, o v2.1.265 o successivo su una macchina che imposta solo `forceLoginGatewayUrl`.

234 246

235Se avete una sottoscrizione Claude attiva ma avete anche `ANTHROPIC_API_KEY` impostato nel Vostro ambiente, Claude Code utilizza la chiave API una volta che l'approvate. Questo può causare errori di autenticazione se la chiave appartiene a un'organizzazione disabilitata o scaduta.247Se avete una sottoscrizione Claude attiva ma avete anche `ANTHROPIC_API_KEY` impostato nel Vostro ambiente, Claude Code utilizza la chiave API una volta che l'approvate. Questo può causare errori di autenticazione se la chiave appartiene a un'organizzazione disabilitata o scaduta.

236 248

255| Profilo attivo | Il file [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) nella Vostra directory di configurazione, o un profilo denominato `default` | Sopra quando la sua modalità di autenticazione è `oidc_federation`; sotto una credenziale `/login` funzionante quando la sua modalità di autenticazione è `user_oauth` |267| Profilo attivo | Il file [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) nella Vostra directory di configurazione, o un profilo denominato `default` | Sopra quando la sua modalità di autenticazione è `oidc_federation`; sotto una credenziale `/login` funzionante quando la sua modalità di autenticazione è `user_oauth` |

256 268

257La regola `user_oauth` impedisce a un profilo `ant auth login` residuo di spostare le Vostre richieste fuori dall'account a cui avete effettuato l'accesso con `/login`. Per le variabili di federazione, Claude Code legge anche le altre variabili nel [riferimento WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), come `ANTHROPIC_IDENTITY_TOKEN_FILE`, quando scambia il Vostro token di identità. Per il formato del file di profilo, consultate il [riferimento WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).269Per le variabili di federazione, Claude Code legge anche le altre variabili nel [riferimento WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), come `ANTHROPIC_IDENTITY_TOKEN_FILE`, quando scambia il Vostro token di identità. Per il formato del file di profilo, consultate il [riferimento WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

258 270

259Per confermare quale fonte Claude Code ha scelto, eseguite `/status`. Una riga `Profile` nomina la fonte al posto della riga `Login method`, e quando il profilo è la credenziale in uso, le righe `Organization` e `Email` mostrano il suo account.271Per confermare quale fonte Claude Code ha scelto, eseguite `/status`. Una riga `Profile` nomina la fonte al posto della riga `Login method`, e quando il profilo è la credenziale in uso, le righe `Organization` e `Email` mostrano il suo account.

260 272

261Se avviate Claude Code con `--debug`, scrive anche una riga `Using Anthropic profile auth` con il nome della fonte nel log di debug in `~/.claude/debug/<session-id>.txt`. Quando Claude Code passa oltre un profilo attivo `user_oauth` perché avete una credenziale `/login` funzionante, scrive un avviso nel log di debug dicendo che sta utilizzando l'accesso claude.ai.

~~262~~

263Quando l'accesso di un profilo `user_oauth` è scaduto e Claude Code non può rinnovarlo, le richieste falliscono con [Anthropic profile login expired](/docs/it/errors#anthropic-profile-login-expired).273Quando l'accesso di un profilo `user_oauth` è scaduto e Claude Code non può rinnovarlo, le richieste falliscono con [Anthropic profile login expired](/docs/it/errors#anthropic-profile-login-expired).

264 274

265Le funzionalità che necessitano del Vostro accesso claude.ai, come i [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) e [`/schedule`](/docs/it/routines), non sono disponibili mentre una di queste fonti è selezionata. Per impedire a Claude Code di selezionare una fonte:275Le funzionalità che necessitano del Vostro accesso claude.ai, come i [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) e [`/schedule`](/docs/it/routines), non sono disponibili mentre una di queste fonti è selezionata. Per impedire a Claude Code di selezionare una fonte:

279 289

280Il comando apre lo stesso flusso di autorizzazione del browser di `/login`, e il token viene stampato nel terminale dopo che approvate l'accesso nel browser. Non salva il token da nessuna parte; copiatelo e impostatelo come variabile di ambiente `CLAUDE_CODE_OAUTH_TOKEN` ovunque vogliate autenticarvi:290Il comando apre lo stesso flusso di autorizzazione del browser di `/login`, e il token viene stampato nel terminale dopo che approvate l'accesso nel browser. Non salva il token da nessuna parte; copiatelo e impostatelo come variabile di ambiente `CLAUDE_CODE_OAUTH_TOKEN` ovunque vogliate autenticarvi:

281 291

282```bash theme={null}292<Tabs>

283export CLAUDE_CODE_OAUTH_TOKEN=your-token293 <Tab title="macOS, Linux, WSL">

284```294 ```bash theme={null}

295 export CLAUDE_CODE_OAUTH_TOKEN=your-token

296 ```

297 </Tab>

298

299 <Tab title="Windows PowerShell">

300 ```powershell theme={null}

301 $env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

302 ```

303 </Tab>

304

305 <Tab title="Windows CMD">

306 ```batch theme={null}

307 set CLAUDE_CODE_OAUTH_TOKEN=your-token

308 ```

309 </Tab>

310</Tabs>

285 311

286Questo token si autentica con la Vostra sottoscrizione Claude e richiede un piano Pro, Max, Team, o Enterprise. Può solo fare richieste di modello, quindi non può stabilire sessioni di [Remote Control](/docs/it/remote-control) o recuperare [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). I server MCP che configurate localmente funzionano ancora.312Questo token si autentica con la Vostra sottoscrizione Claude e richiede un piano Pro, Max, Team, o Enterprise. Può solo fare richieste di modello, quindi non può stabilire sessioni di [Remote Control](/docs/it/remote-control) o recuperare [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). I server MCP che configurate localmente funzionano ancora.

287 313

auto-mode-config.md +16 −32

Details

9[Auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) consente a Claude Code di funzionare senza prompt di autorizzazione instradando ogni chiamata di strumento attraverso un classificatore che blocca qualsiasi cosa irreversibile, distruttiva o rivolta al di fuori del tuo ambiente. Le regole di negazione e richiesta esplicita vengono valutate prima del classificatore e continuano comunque a bloccare o richiedere. Utilizza il blocco di impostazioni `autoMode` per comunicare al classificatore quali repository, bucket e domini la tua organizzazione ritiene affidabili, in modo che smetta di bloccare le operazioni interne di routine.9[Auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) consente a Claude Code di funzionare senza prompt di autorizzazione instradando ogni chiamata di strumento attraverso un classificatore che blocca qualsiasi cosa irreversibile, distruttiva o rivolta al di fuori del tuo ambiente. Le regole di negazione e richiesta esplicita vengono valutate prima del classificatore e continuano comunque a bloccare o richiedere. Utilizza il blocco di impostazioni `autoMode` per comunicare al classificatore quali repository, bucket e domini la tua organizzazione ritiene affidabili, in modo che smetta di bloccare le operazioni interne di routine.

10 10

11<Note>11<Note>

12 Auto mode è disponibile a tutti gli utenti su ogni provider, inclusa l'API Anthropic, [Claude Platform su AWS](/docs/it/claude-platform-on-aws), Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni [gateway di app Claude](/docs/it/claude-apps-gateway) con accesso. Se Claude Code segnala che la modalità auto non è disponibile per il tuo account, controlla i [requisiti completi](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), che coprono anche i modelli supportati e il controllo a livello di organizzazione sui piani Team ed Enterprise. Nella versione da v2.1.158 a v2.1.206, la modalità auto su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni gateway di app Claude richiedeva l'impostazione di `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 ha rimosso il requisito.12 Questa pagina è il riferimento di configurazione. L'attivazione e la disattivazione della modalità auto sono trattate nella pagina Permission modes:

14 * **Passa alla modalità auto durante una sessione, o esci da essa**: vedi [Switch permission modes](/docs/it/permission-modes#switch-permission-modes)

15 * **Avvia una sessione in modalità auto**: vedi [Start in a different permission mode](/docs/it/permission-modes#start-in-a-different-mode)

13</Note>16</Note>

14 17

15Per impostazione predefinita, il classificatore si fida solo della directory di lavoro e dei remote configurati del repository corrente. Azioni come il push verso l'organizzazione di controllo del codice sorgente della tua azienda o la scrittura in un bucket cloud del team vengono bloccate finché non le aggiungi a `autoMode.environment`.18Auto mode è disponibile a tutti gli utenti su ogni provider, inclusa l'API Anthropic, [Claude Platform su AWS](/docs/it/claude-platform-on-aws), Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni [gateway di app Claude](/docs/it/claude-apps-gateway) con accesso. Se Claude Code segnala che la modalità auto non è disponibile per il tuo account, controlla i [requisiti completi](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), che coprono anche i modelli supportati e il controllo a livello di organizzazione sui piani Team ed Enterprise.

16 19

17Per informazioni su come le sessioni finiscono in modalità auto e cosa blocca il classificatore per impostazione predefinita, consulta [auto mode nella pagina Permission modes](/docs/it/permission-modes#eliminate-prompts-with-auto-mode). Questa pagina è il riferimento di configurazione.20Per impostazione predefinita, il classificatore si fida solo della directory di lavoro e dei remote configurati del repository corrente. Azioni come il push verso l'organizzazione di controllo del codice sorgente della tua azienda o la scrittura in un bucket cloud del team vengono bloccate finché non le aggiungi a `autoMode.environment`.

18 21

19Questa pagina spiega come:22Questa pagina spiega come:

20 23

21* [Aggiungere un checkpoint umano](#add-a-human-checkpoint) per push e pull request con `permissions.ask`24* [Aggiungere un checkpoint umano](#add-a-human-checkpoint) per push e pull request con `permissions.ask`

~~22* [Scegliere dove impostare le regole](#where-the-classifier-reads-configuration) in CLAUDE.md, impostazioni utente e impostazioni gestite~~

23* [Definire l'infrastruttura affidabile](#define-trusted-infrastructure) con `autoMode.environment`25* [Definire l'infrastruttura affidabile](#define-trusted-infrastructure) con `autoMode.environment`

24* [Generare voci di ambiente](#generate-environment-entries) con `/auto-mode-setup`26* [Generare voci di ambiente](#generate-environment-entries) con `/auto-mode-setup`

~~25* [Sostituire le regole di blocco e autorizzazione](#override-the-block-and-allow-rules) quando i valori predefiniti non si adattano alla tua pipeline~~

~~26* [Modificare le regole da `/permissions`](#edit-rules-from-permissions) senza aprire un file di impostazioni~~

~~27* [Instradare tutti i comandi shell attraverso il classificatore](#route-all-shell-commands-through-the-classifier) con `autoMode.classifyAllShell`~~

~~28* [Ispezionare la tua configurazione effettiva](#inspect-the-defaults-and-your-effective-config) con i sottocomandi `claude auto-mode`~~

29* [Esaminare i rifiuti](#review-denials) in modo da sapere cosa aggiungere successivamente27* [Esaminare i rifiuti](#review-denials) in modo da sapere cosa aggiungere successivamente

30 28

31<h2 id="common-boundaries">29<h2 id="common-boundaries">

32 Confini comuni30 Confini comuni

33</h2>31</h2>

34 32

35Auto mode consente push a qualsiasi ramo del repository in cui stai lavorando, incluso il ramo predefinito, e la creazione di pull request per impostazione predefinita. Un ramo non predefinito il cui nome lo contrassegna come bersaglio di distribuzione o pubblicazione, come `production`, `release` o `gh-pages`, non è coperto da quel valore predefinito: il classificatore giudica un push lì in base ai suoi meriti, incluso come distribuzione di produzione. Il contenuto del push viene comunque controllato, quindi un force push, un segreto che entra nel commit o una modifica che invierebbe segreti al di fuori del repository quando CI o una pipeline di distribuzione lo esegue rimane bloccato.33La modalità auto consente push a qualsiasi ramo del repository in cui stai lavorando, incluso il ramo predefinito, e la creazione di pull request per impostazione predefinita. Un ramo non predefinito il cui nome lo contrassegna come bersaglio di distribuzione o pubblicazione, come `production`, `release` o `gh-pages`, non è coperto da quel valore predefinito: il classificatore giudica un push lì in base ai suoi meriti, incluso come distribuzione di produzione. Il contenuto del push viene comunque controllato, quindi un force push, un segreto che entra nel commit o una modifica che invierebbe segreti al di fuori del repository quando CI o una pipeline di distribuzione lo esegue rimane bloccato.

~~37<Info>Prima di v2.1.211, il classificatore consentiva push solo al tuo ramo di lavoro, ai rami creati da Claude e ai push di routine al ramo predefinito.</Info>~~

38 34

39Se desideri un checkpoint umano prima dei comandi push e pull request di Claude, aggiungi regole di autorizzazione: le [ricette di seguito](#add-a-human-checkpoint) mantengono la modalità auto attiva per tutto il resto.35Se desideri un checkpoint umano prima dei comandi push e pull request di Claude, aggiungi regole di autorizzazione: le [ricette di seguito](#add-a-human-checkpoint) mantengono la modalità auto attiva per tutto il resto.

40 36

81 77

82Il classificatore non legge `autoMode` dalle impostazioni di progetto in `.claude/settings.json` o `.claude/settings.local.json`. Entrambi i file risiedono nella directory del repository, quindi un repository archiviato o un passaggio di compilazione potrebbe altrimenti iniettare le proprie regole di autorizzazione. Prima di v2.1.207, il classificatore leggeva anche `.claude/settings.local.json`; sposta qualsiasi blocco `autoMode` in quel file a `~/.claude/settings.json`. Escludere `.claude/settings.local.json` chiude anche il caso in cui un repository esegue il commit del file o uno strumento locale o un passaggio di compilazione lo scrive.78Il classificatore non legge `autoMode` dalle impostazioni di progetto in `.claude/settings.json` o `.claude/settings.local.json`. Entrambi i file risiedono nella directory del repository, quindi un repository archiviato o un passaggio di compilazione potrebbe altrimenti iniettare le proprie regole di autorizzazione. Sposta qualsiasi blocco `autoMode` in `.claude/settings.local.json` a `~/.claude/settings.json`.

83 79

84Le voci di ogni ambito vengono combinate. Uno sviluppatore può estendere `environment`, `allow`, `soft_deny` e `hard_deny` con voci personali ma non può rimuovere le voci fornite dalle impostazioni gestite. Poiché le regole di autorizzazione agiscono come eccezioni alle regole di blocco morbido all'interno del classificatore, una voce `allow` aggiunta da uno sviluppatore può sostituire una voce `soft_deny` dell'organizzazione: la combinazione è additiva, non un confine di politica rigida.80Le voci di ogni ambito vengono combinate. Uno sviluppatore può estendere `environment`, `allow`, `soft_deny` e `hard_deny` con voci personali ma non può rimuovere le voci fornite dalle impostazioni gestite. Poiché le regole di autorizzazione agiscono come eccezioni alle regole di blocco morbido all'interno del classificatore, una voce `allow` aggiunta da uno sviluppatore può sostituire una voce `soft_deny` dell'organizzazione: la combinazione è additiva, non un confine di politica rigida.

85 81

93 89

94Per la maggior parte delle organizzazioni, `autoMode.environment` è l'unico campo che devi impostare. Comunica al classificatore quali repository, bucket e domini sono affidabili: il classificatore lo utilizza per decidere cosa significa "esterno", quindi qualsiasi destinazione non elencata è un potenziale bersaglio di esfiltrazione.90Per la maggior parte delle organizzazioni, `autoMode.environment` è l'unico campo che devi impostare. Comunica al classificatore quali repository, bucket e domini sono affidabili: il classificatore lo utilizza per decidere cosa significa "esterno", quindi qualsiasi destinazione non elencata è un potenziale bersaglio di esfiltrazione.

95 91

~~96A partire da Claude Code v2.1.198, `claude auto-mode defaults` stampa tre tipi di voce di ambiente. Le versioni precedenti a v2.1.195 stampano solo i primi cinque slot di fiducia.~~92`claude auto-mode defaults` stampa tre tipi di voce di ambiente.

97 93

98* **Context slots**: descrivono la tua organizzazione, stack e postura di sicurezza in modo che il classificatore legga le altre regole nel tuo contesto. Ognuno predefinito è `None configured` o all'assunzione conservativa denominata accanto ad esso:94* **Context slots**: descrivono la tua organizzazione, stack e postura di sicurezza in modo che il classificatore legga le altre regole nel tuo contesto. Ognuno predefinito è `None configured` o all'assunzione conservativa denominata accanto ad esso:

99 * **Organization**95 * **Organization**

101 * **Cloud provider(s)**97 * **Cloud provider(s)**

102 * **Repository visibility**: un repository è assunto privato a meno che il suo host remoto e il nome non indichino diversamente, o il classificatore legga un controllo di visibilità precedente nella conversazione che mostra che è pubblico.98 * **Repository visibility**: un repository è assunto privato a meno che il suo host remoto e il nome non indichino diversamente, o il classificatore legga un controllo di visibilità precedente nella conversazione che mostra che è pubblico.

103 99

104 Nelle richieste del classificatore inviate da Claude Code stesso, il classificatore legge i tuoi messaggi e i comandi che Claude esegue, non il loro output. L'evidenza deve essere qualcosa che il classificatore può leggere, come il tuo stesso messaggio che nomina il repository come pubblico; l'output di un `gh repo view` da solo non lo raggiunge. Il controllo delle prove della trascrizione richiede Claude Code v2.1.200 o successivo100 Nelle richieste del classificatore inviate da Claude Code stesso, il classificatore legge i tuoi messaggi e i comandi che Claude esegue, non il loro output. L'evidenza deve essere qualcosa che il classificatore può leggere, come il tuo stesso messaggio che nomina il repository come pubblico; l'output di un `gh repo view` da solo non lo raggiunge.

105 * **Internal sharing / snippet hosting**: i servizi di paste e gist pubblici sono trattati come esterni al confine di fiducia finché non ne nomini uno101 * **Internal sharing / snippet hosting**: i servizi di paste e gist pubblici sono trattati come esterni al confine di fiducia finché non ne nomini uno

106 * **Org-specific CLIs**102 * **Org-specific CLIs**

107 * **Secrets management**103 * **Secrets management**

110 * **Host containment**: predefinito a una macchina sviluppatore ordinaria o runner CI con internet aperto. Se Claude Code viene eseguito in un container, VM o pod con un allow-list di uscita o vicini che non deve toccare, nomina gli host consentiti, se l'endpoint dei metadati cloud dovrebbe essere raggiungibile e quale progetto cloud, cluster o registro il compito utilizza e sotto quale identità. Finché questa voce non nomina quell'identità, il classificatore [blocca](/docs/it/permission-modes#what-the-classifier-blocks-by-default) le richieste per le credenziali dell'host stesso. Richiede Claude Code v2.1.257 o successivo106 * **Host containment**: predefinito a una macchina sviluppatore ordinaria o runner CI con internet aperto. Se Claude Code viene eseguito in un container, VM o pod con un allow-list di uscita o vicini che non deve toccare, nomina gli host consentiti, se l'endpoint dei metadati cloud dovrebbe essere raggiungibile e quale progetto cloud, cluster o registro il compito utilizza e sotto quale identità. Finché questa voce non nomina quell'identità, il classificatore [blocca](/docs/it/permission-modes#what-the-classifier-blocks-by-default) le richieste per le credenziali dell'host stesso. Richiede Claude Code v2.1.257 o successivo

111 * **Protected deployment namespaces / environments**: ricade all'euristica Sensitive remote targets finché non li nomini107 * **Protected deployment namespaces / environments**: ricade all'euristica Sensitive remote targets finché non li nomini

112 * **Data retention / declassification**108 * **Data retention / declassification**

113* **Trust slots**: denominano ciò che il classificatore tratta come interno al tuo confine. Gli slot sono Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services e Internal package registry. Le voci di repository e controllo del codice sorgente predefinite sono il repository di lavoro e i suoi remote configurati. Ogni altro slot di fiducia predefinito è `None configured`, quindi nient'altro è affidabile finché non lo aggiungi. La visibilità di un repository limita solo il materiale confidenziale: un repository privato è una destinazione accettabile per il materiale confidenziale, ma rendere un repository privato non cancella mai i segreti o i dati personali o affidati in esso, e il classificatore tratta il contenuto trasportato, reindirizzato o letto per la prima volta dall'esterno del repository di lavoro come non il lavoro proprio di quel repository. Questo ambito richiede Claude Code v2.1.203 o successivo.109* **Trust slots**: denominano ciò che il classificatore tratta come interno al tuo confine. Gli slot sono Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services e Internal package registry. Le voci di repository e controllo del codice sorgente predefinite sono il repository di lavoro e i suoi remote configurati. Ogni altro slot di fiducia predefinito è `None configured`, quindi nient'altro è affidabile finché non lo aggiungi. La visibilità di un repository limita solo il materiale confidenziale: un repository privato è una destinazione accettabile per il materiale confidenziale, ma rendere un repository privato non cancella mai i segreti o i dati personali o affidati in esso, e il classificatore tratta il contenuto trasportato, reindirizzato o letto per la prima volta dall'esterno del repository di lavoro come non il lavoro proprio di quel repository.

114* **Sensitivity slots**: denominano ciò che le regole protettive trattano come ad alto rischio. Gli slot sono Sensitive data locations & audiences, Sensitive remote targets e Protected IaC scopes. Ognuno predefinito è un'euristica ampia, come trattare qualsiasi host o namespace il cui nome contiene `prod` o `production` come bersaglio remoto sensibile, quindi le regole protettive sono attive prima di configurare qualsiasi cosa. Denominare bersagli concreti in uno slot di sensibilità fa sì che quelle regole si applichino ai bersagli denominati invece dell'euristica.110* **Sensitivity slots**: denominano ciò che le regole protettive trattano come ad alto rischio. Gli slot sono Sensitive data locations & audiences, Sensitive remote targets e Protected IaC scopes. Ognuno predefinito è un'euristica ampia, come trattare qualsiasi host o namespace il cui nome contiene `prod` o `production` come bersaglio remoto sensibile, quindi le regole protettive sono attive prima di configurare qualsiasi cosa. Denominare bersagli concreti in uno slot di sensibilità fa sì che quelle regole si applichino ai bersagli denominati invece dell'euristica.

115 111

116<Info>Prima di v2.1.211, gli slot di contesto includevano anche una voce Default / protected branches che trattava `main` e `master` come protetti finché non ne nominavi altri. v2.1.211 l'ha rimossa: i [push a qualsiasi ramo del repository in cui stai lavorando](#common-boundaries) sono consentiti per impostazione predefinita, quindi non c'è un valore predefinito di ramo protetto da configurare.</Info>

~~117~~

118Per aggiungere le tue voci insieme ai valori predefiniti, includi la stringa letterale `"$defaults"` nell'array. Le voci predefinite vengono inserite in quella posizione, quindi le tue voci personalizzate possono andare prima o dopo di esse.112Per aggiungere le tue voci insieme ai valori predefiniti, includi la stringa letterale `"$defaults"` nell'array. Le voci predefinite vengono inserite in quella posizione, quindi le tue voci personalizzate possono andare prima o dopo di esse.

119 113

120L'esempio seguente mantiene le voci predefinite e aggiunge i repository, i bucket, i domini e i servizi di un'organizzazione.114L'esempio seguente mantiene le voci predefinite e aggiunge i repository, i bucket, i domini e i servizi di un'organizzazione.

143* **Trusted internal domains**: nomi host per API, dashboard e servizi all'interno della tua rete, come `*.internal.example.com`137* **Trusted internal domains**: nomi host per API, dashboard e servizi all'interno della tua rete, come `*.internal.example.com`

144* **Key internal services**: CI, registri di artefatti, indici di pacchetti interni, strumenti di gestione degli incidenti138* **Key internal services**: CI, registri di artefatti, indici di pacchetti interni, strumenti di gestione degli incidenti

145* **Internal package registry**: il registro npm, PyPI o altro privato attraverso il quale gli install dovrebbero instradare, in modo che gli install che lo bypassano per un registro pubblico vengano bloccati139* **Internal package registry**: il registro npm, PyPI o altro privato attraverso il quale gli install dovrebbero instradare, in modo che gli install che lo bypassano per un registro pubblico vengano bloccati

146* **Sensitive data locations & audiences**: i bucket, i database o i percorsi che contengono dati personali, dati aziendali confidenziali, credenziali, dati regolamentati o materiale simile sensibile, e i destinatari con cui i dati in ogni posizione possono essere condivisi, in modo che il classificatore protegga quelle posizioni invece di indovinare dal contenuto. Claude Code v2.1.195 attraverso v2.1.197 denominano questa voce PII / regulated-data locations e coprono solo le posizioni che contengono dati personali o regolamentati, senza la dimensione del destinatario140* **Sensitive data locations & audiences**: i bucket, i database o i percorsi che contengono dati personali, dati aziendali confidenziali, credenziali, dati regolamentati o materiale simile sensibile, e i destinatari con cui i dati in ogni posizione possono essere condivisi, in modo che il classificatore protegga quelle posizioni invece di indovinare dal contenuto.

147* **Sensitive remote targets**: gli spazi dei nomi, gli host o i container che contano come produzione, in modo che i shell remoti e i port-forward in essi richiedano la tua approvazione esplicita141* **Sensitive remote targets**: gli spazi dei nomi, gli host o i container che contano come produzione, in modo che i shell remoti e i port-forward in essi richiedano la tua approvazione esplicita

148* **Protected IaC scopes**: le risorse di infrastruttura il cui apply o destroy dovrebbe sempre richiedere di denominare il cambiamento142* **Protected IaC scopes**: le risorse di infrastruttura il cui apply o destroy dovrebbe sempre richiedere di denominare il cambiamento

149* **Additional context**: vincoli del settore regolamentato, infrastruttura multi-tenant o requisiti di conformità che influiscono su ciò che il classificatore dovrebbe trattare come rischioso143* **Additional context**: vincoli del settore regolamentato, infrastruttura multi-tenant o requisiti di conformità che influiscono su ciò che il classificatore dovrebbe trattare come rischioso

150 144

151Le voci Internal package registry, Sensitive data locations & audiences, Sensitive remote targets e Protected IaC scopes richiedono Claude Code v2.1.195 o successivo. Le versioni precedenti le leggono ancora come contesto semplice ma non hanno le regole incorporate che le prendono di mira.

~~152~~

153Un modello di partenza utile: compila i campi tra parentesi e rimuovi le righe che non si applicano.145Un modello di partenza utile: compila i campi tra parentesi e rimuovi le righe che non si applicano.

154 146

155```json theme={null}147```json theme={null}

169}161}

170```162```

171 163

172Più contesto specifico fornisci, meglio il classificatore può distinguere le operazioni interne di routine dai tentativi di esfiltrazione.

~~173~~

174Non è necessario compilare tutto in una volta. Un rollout ragionevole: inizia con i valori predefiniti e aggiungi l'organizzazione di controllo del codice sorgente e i servizi interni chiave, che risolvono i falsi positivi più comuni come il push verso i tuoi repository. Aggiungi successivamente i domini affidabili e i bucket cloud. Compila il resto man mano che emergono i blocchi.164Non è necessario compilare tutto in una volta. Un rollout ragionevole: inizia con i valori predefiniti e aggiungi l'organizzazione di controllo del codice sorgente e i servizi interni chiave, che risolvono i falsi positivi più comuni come il push verso i tuoi repository. Aggiungi successivamente i domini affidabili e i bucket cloud. Compila il resto man mano che emergono i blocchi.

175 165

176<h2 id="generate-environment-entries">166<h2 id="generate-environment-entries">

305 Instradare tutti i comandi shell attraverso il classificatore295 Instradare tutti i comandi shell attraverso il classificatore

306</h2>296</h2>

307 297

308Per impostazione predefinita, le regole di autorizzazione Bash e PowerShell strette come `Bash(npm test)` rimangono in vigore in modalità auto, e Claude Code le risolve prima che il classificatore venga eseguito, a meno che il comando non contenga [domini consentiti per comando](/docs/it/sandboxing#per-command-allowed-domains-in-auto-mode). Claude Code sospende solo le regole ampie che concedono l'esecuzione di codice arbitrario, come `Bash(*)` o interpreti con caratteri jolly, insieme a ogni regola che nomina [`Monitor`](/docs/it/tools-reference#monitor-tool), perché i comandi Monitor vengono eseguiti attraverso la shell. Ciò significa che una regola stretta può comunque far passare un argomento distruttivo senza che il classificatore lo veda, ad esempio un percorso di script o un flag che il prefisso della regola non ha anticipato.298Per impostazione predefinita, le regole di autorizzazione Bash e PowerShell strette come `Bash(npm test)` rimangono in vigore in modalità auto. Claude Code le risolve prima che il classificatore venga eseguito, a meno che il comando non contenga [domini consentiti per comando](/docs/it/sandboxing#per-command-allowed-domains-in-auto-mode). Claude Code sospende solo le regole ampie che concedono l'esecuzione di codice arbitrario, come `Bash(*)` o interpreti con caratteri jolly, insieme a ogni regola che nomina [`Monitor`](/docs/it/tools-reference#monitor-tool), perché i comandi Monitor vengono eseguiti attraverso la shell. Ciò significa che una regola stretta può comunque far passare un argomento distruttivo senza che il classificatore lo veda, ad esempio un percorso di script o un flag che il prefisso della regola non ha anticipato.

309 299

310Imposta `autoMode.classifyAllShell` su `true` per sospendere ogni regola di autorizzazione Bash e PowerShell mentre la modalità auto è attiva, in modo che il classificatore valuti ogni comando shell indipendentemente dal tuo elenco di autorizzazioni.300Imposta `autoMode.classifyAllShell` su `true` per sospendere ogni regola di autorizzazione Bash e PowerShell mentre la modalità auto è attiva, in modo che il classificatore valuti ogni comando shell indipendentemente dal tuo elenco di autorizzazioni, ad eccezione delle [rimozioni di percorsi critici](/docs/it/permission-modes#critical-paths).

311 301

312```json theme={null}302```json theme={null}

313{303{

321 311

322L'impostazione si applica solo mentre la modalità auto è attiva, e le tue regole di autorizzazione si comportano normalmente in altre modalità di autorizzazione.312L'impostazione si applica solo mentre la modalità auto è attiva, e le tue regole di autorizzazione si comportano normalmente in altre modalità di autorizzazione.

323 313

324<Note>

325 `autoMode.classifyAllShell` richiede Claude Code v2.1.193 o successivo. Le versioni precedenti ignorano la chiave e continuano a trasportare le regole di autorizzazione shell strette nella modalità auto.

326</Note>

~~327~~

328<h2 id="inspect-the-defaults-and-your-effective-config">314<h2 id="inspect-the-defaults-and-your-effective-config">

329 Ispezionare i valori predefiniti e la tua configurazione effettiva315 Ispezionare i valori predefiniti e la tua configurazione effettiva

330</h2>316</h2>

373claude auto-mode critique359claude auto-mode critique

374```360```

375 361

376Esegui `claude auto-mode config` dopo aver salvato le tue impostazioni per confermare che le regole effettive sono quelle che ti aspetti, con `"$defaults"` espanso al suo posto. Se hai scritto regole personalizzate, `claude auto-mode critique` le esamina e contrassegna le voci che sono ambigue, ridondanti o probabilmente causeranno falsi positivi.362Se hai scritto regole personalizzate, `claude auto-mode critique` le esamina e contrassegna le voci che sono ambigue, ridondanti o probabilmente causeranno falsi positivi.

377 363

378Per scartare le tue personalizzazioni e tornare ai valori predefiniti incorporati, esegui il sottocomando reset. Richiede Claude Code v2.1.212 o successivo e rimuove la sezione `autoMode` dal tuo file di impostazioni utente:364Per scartare le tue personalizzazioni e tornare ai valori predefiniti incorporati, esegui il sottocomando reset. Richiede Claude Code v2.1.212 o successivo e rimuove la sezione `autoMode` dal tuo file di impostazioni utente:

379 365

407 393

408Puoi aggiungere la voce di ambiente o la regola `allow` dalla scheda [**Auto mode**](#edit-rules-from-permissions) della finestra di dialogo `/permissions`.394Puoi aggiungere la voce di ambiente o la regola `allow` dalla scheda [**Auto mode**](#edit-rules-from-permissions) della finestra di dialogo `/permissions`.

409 395

410Nella maggior parte delle sessioni il nome del motivo nomina la regola che il classificatore ha abbinato, tra parentesi quadre, come `[Data Exfiltration]` o `[Production Deploy]`, e alcune sessioni eseguono un modello di classificatore che aggiunge una breve spiegazione. Claude Code seleziona il modello di classificatore, quindi quale forma vedi non è qualcosa che configuri.396Il testo tra parentesi quadre, come `[Data Exfiltration]`, è il nome della regola che il classificatore ha abbinato. Per leggere la formulazione completa di quella regola, vedi [Ispezionare i valori predefiniti e la configurazione effettiva](#inspect-the-defaults-and-your-effective-config).

411 397

412<h3 id="fix-repeated-denials">398<h3 id="fix-repeated-denials">

413 Correggere i rifiuti ripetuti399 Correggere i rifiuti ripetuti

415 401

416I rifiuti ripetuti per la stessa destinazione di solito significano che il classificatore manca di contesto. Aggiungi quella destinazione a `autoMode.environment`, o [esegui `/auto-mode-setup`](#generate-environment-entries) per fare in modo che Claude Code rediga le voci, quindi esegui `claude auto-mode config` per confermare che il cambiamento ha avuto effetto.402I rifiuti ripetuti per la stessa destinazione di solito significano che il classificatore manca di contesto. Aggiungi quella destinazione a `autoMode.environment`, o [esegui `/auto-mode-setup`](#generate-environment-entries) per fare in modo che Claude Code rediga le voci, quindi esegui `claude auto-mode config` per confermare che il cambiamento ha avuto effetto.

417 403

418Per reagire ai rifiuti a livello di programmazione, utilizza l'[hook `PermissionDenied`](/docs/it/hooks#permissiondenied).

~~419~~

420<h2 id="see-also">404<h2 id="see-also">

421 Vedi anche405 Vedi anche

422</h2>406</h2>

best-practices.md +16 −16

Details

25***25***

26 26

27<h2 id="give-claude-a-way-to-verify-its-work">27<h2 id="give-claude-a-way-to-verify-its-work">

~~28 Fornite a Claude un modo per verificare il suo lavoro~~28 Dai a Claude un modo per verificare il suo lavoro

29</h2>29</h2>

30 30

31<Tip>31<Tip>

~~32 Fornite a Claude un controllo che possa eseguire: test, una build, uno screenshot da confrontare. È la differenza tra una sessione che osservate e una da cui potete allontanarvi.~~32 Dai a Claude un controllo che può eseguire: test, una build, uno screenshot da confrontare. È la differenza tra una sessione che guardi e una da cui ti allontani.

33</Tip>33</Tip>

34 34

35Claude si ferma quando il lavoro sembra completato. Senza un controllo che possa eseguire, "sembra completato" è l'unico segnale disponibile, e voi diventate il ciclo di verifica: ogni errore vi aspetta per essere notato. Fornite a Claude qualcosa che produce un risultato di successo o fallimento, e il ciclo si chiude da solo. Claude esegue il lavoro, esegue il controllo, legge il risultato e itera fino a quando il controllo non passa.35Claude si ferma quando il lavoro sembra completato. Senza un controllo che possa eseguire, "sembra completato" è l'unico segnale disponibile, e tu diventi il ciclo di verifica: ogni errore aspetta che tu lo noti. Dai a Claude qualcosa che produca un risultato positivo o negativo, e il ciclo si chiude da solo. Claude esegue il lavoro, esegue il controllo, legge il risultato e itera finché il controllo non passa.

36 36

37Il controllo è qualsiasi cosa che restituisca un segnale che Claude possa leggere nella conversazione: una suite di test, un codice di uscita della build, un linter, uno script che confronta l'output rispetto a un fixture, o uno [screenshot del browser](/docs/it/chrome) confrontato con un design. Eseguite [`/verify`](/docs/it/skills#run-and-verify-your-app) voi stessi dopo che il controllo di Claude passa per confermare la modifica rispetto all'app in esecuzione.37Il controllo è qualsiasi cosa che restituisca un segnale che Claude possa leggere nella conversazione: una suite di test, un codice di uscita della build, un linter, uno script che confronta l'output con un fixture, o uno [screenshot del browser](/docs/it/chrome) confrontato con un design. Esegui [`/verify`](/docs/it/skills#run-and-verify-your-app) tu stesso dopo che il controllo di Claude passa per confermare la modifica rispetto all'app in esecuzione.

38 38

40| - | - | - |40| - | - | - |

41| **Fornire criteri di verifica** | *"implementare una funzione che convalida gli indirizzi email"* | *"scrivere una funzione validateEmail. esempi di casi di test: [user@example.com](mailto:user@example.com) è true, invalid è false, [user@.com](mailto:user@.com) è false. eseguire i test dopo l'implementazione"* |41| **Fornisci criteri di verifica** | *"implementa una funzione che convalida gli indirizzi email"* | *"scrivi una funzione validateEmail. esempi di casi di test: [user@example.com](mailto:user@example.com) è vero, invalid è falso, [user@.com](mailto:user@.com) è falso. esegui i test dopo l'implementazione"* |

42| **Verificare visivamente i cambiamenti dell'interfaccia utente** | *"rendere il dashboard più bello"* | *"\[incollare screenshot] implementare questo design. fare uno screenshot del risultato e confrontarlo con l'originale. elencare le differenze e correggerle"* |42| **Verifica i cambiamenti dell'interfaccia utente visivamente** | *"rendi il dashboard più bello"* | *"\[incolla screenshot] implementa questo design. fai uno screenshot del risultato e confrontalo con l'originale. elenca le differenze e correggile"* |

43| **Affrontare le cause radici, non i sintomi** | *"la build sta fallendo"* | *"la build fallisce con questo errore: \[incollare errore]. correggerlo e verificare che la build abbia successo. affrontare la causa radice, non sopprimere l'errore"* |43| **Affronta le cause radice, non i sintomi** | *"la build sta fallendo"* | *"la build fallisce con questo errore: \[incolla errore]. correggilo e verifica che la build abbia successo. affronta la causa radice, non sopprimere l'errore"* |

44 44

~~45Una volta che il controllo esiste, decidete quanto rigidamente deve bloccare l'arresto:~~45Una volta che il controllo esiste, decidi quanto rigidamente deve bloccare l'arresto:

46 46

~~47* **In un unico prompt**: chiedete a Claude di eseguire il controllo e iterare nello stesso messaggio, come nella tabella sopra.~~47* **In un prompt**: chiedi a Claude di eseguire il controllo e iterare nello stesso messaggio, come nella tabella sopra.

48* **In una sessione**: impostate il controllo come condizione [`/goal`](/docs/it/goal). Un valutatore separato lo ri-controlla dopo ogni turno e Claude continua a lavorare fino a quando l'obiettivo non si risolve. Se Claude si blocca, Claude Code alla fine interrompe l'esecuzione con l'obiettivo ancora impostato — vedere [come funziona la valutazione di /goal](/docs/it/goal#how-evaluation-works).48* **In una sessione**: imposta il controllo come condizione [`/goal`](/docs/it/goal). Un valutatore separato lo ri-controlla dopo ogni turno e Claude continua a lavorare finché l'obiettivo non si risolve. Se Claude si blocca, Claude Code alla fine arresta l'esecuzione con l'obiettivo ancora impostato — vedi [come funziona la valutazione di /goal](/docs/it/goal#how-evaluation-works).

49* **Come un gate deterministico**: un [hook Stop](/docs/it/hooks#stop) esegue il vostro controllo come uno script e blocca il turno dall'terminare fino a quando non passa. Claude Code ignora l'hook e termina il turno dopo 8 blocchi consecutivi.49* **Come gate deterministico**: un [Stop hook](/docs/it/hooks#stop) esegue il tuo controllo come script e blocca il turno dall'terminare finché non passa. [Stop input](/docs/it/hooks#stop-input) copre il limite sui blocchi consecutivi.

50* **Da una seconda opinione**: un [subagente di verifica](/docs/it/sub-agents) o un [flusso di lavoro dinamico](/docs/it/workflows) che controlla i propri risultati ha un modello fresco che tenta di confutare il risultato, quindi l'agente che esegue il lavoro non è quello che lo valuta.50* **Da un secondo parere**: un [verification subagent](/docs/it/sub-agents) o un [dynamic workflow](/docs/it/workflows) che controlla i suoi stessi risultati ha un modello fresco che tenta di confutare il risultato, quindi l'agente che esegue il lavoro non è quello che lo valuta.

51 51

52Ogni passaggio scambia la configurazione per l'attenzione. La versione del prompt funziona su qualsiasi attività oggi. Le versioni `/goal` e Stop hook sono quelle che permettono a un'esecuzione incustodita di terminare correttamente senza di voi.52Ogni passaggio scambia la configurazione per l'attenzione. La versione con prompt funziona su qualsiasi attività oggi. Le versioni `/goal` e Stop hook sono quelle che permettono a un'esecuzione incustodita di terminare correttamente senza di te.

53 53

54Fate in modo che Claude mostri prove piuttosto che asserire il successo: l'output del test, il comando che ha eseguito e cosa ha restituito, o uno screenshot del risultato. Rivedere le prove è più veloce che eseguire nuovamente la verifica voi stessi, e funziona per le sessioni che non stavate osservando.54Fai mostrare a Claude le prove piuttosto che asserire il successo: l'output del test, il comando che ha eseguito e cosa ha restituito, o uno screenshot del risultato. Rivedere le prove è più veloce che ri-eseguire la verifica tu stesso, e funziona per le sessioni che non stavi guardando.

55 55

56***56***

57 57

209 Per ottenere meno prompt senza rinunciare al controllo, pre-approvate gli strumenti di cui vi fidate con `/permissions` e lasciate che i comandi in sandbox vengano eseguiti senza chiedere con `/sandbox`. Passate alla modalità Manual quando volete approvare voi stessi le modifiche e i comandi.209 Per ottenere meno prompt senza rinunciare al controllo, pre-approvate gli strumenti di cui vi fidate con `/permissions` e lasciate che i comandi in sandbox vengano eseguiti senza chiedere con `/sandbox`. Passate alla modalità Manual quando volete approvare voi stessi le modifiche e i comandi.

210</Tip>210</Tip>

211 211

212Su piani Pro, Max e Team, la modalità auto è la [modalità di permesso iniziale integrata](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) per le sessioni di terminale interattivo e VS Code: un modello classificatore separato esamina la maggior parte delle azioni invece di voi e blocca solo quello che sembra rischioso, come l'escalation di ambito, l'infrastruttura sconosciuta o le azioni guidate da contenuti ostili.212Con Claude Code v2.1.283 o successivo, la modalità auto è la [modalità di permesso iniziale integrata](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) per le sessioni di terminale interattivo e VS Code: un modello classificatore separato esamina la maggior parte delle azioni invece di voi e blocca solo quello che sembra rischioso, come l'escalation di ambito, l'infrastruttura sconosciuta o le azioni guidate da contenuti ostili. Nelle versioni precedenti, la modalità auto è la modalità di permesso iniziale integrata solo su piani Pro, Max e Team.

213 213

214In modalità Manual, la modalità di permesso iniziale integrata su altri piani, Claude Code chiede prima di azioni che potrebbero modificare il vostro sistema: scritture di file, comandi Bash, strumenti MCP. Questo è sicuro ma tedioso. Dopo la decima approvazione state cliccando piuttosto che revisionando. Due strumenti tagliano queste interruzioni in modalità Manual e si applicano anche in modalità auto:214In modalità Manual, Claude Code chiede prima di azioni che potrebbero modificare il vostro sistema: scritture di file, comandi Bash, strumenti MCP. Questo è sicuro ma tedioso. Dopo la decima approvazione state cliccando piuttosto che revisionando. Due strumenti tagliano queste interruzioni in modalità Manual e si applicano anche in modalità auto:

215 215

216* **Whitelist di permessi**: consentire strumenti specifici che sapete essere sicuri, come `npm run lint` o `git commit`216* **Whitelist di permessi**: consentire strumenti specifici che sapete essere sicuri, come `npm run lint` o `git commit`

217* **Sandboxing**: abilitare l'isolamento a livello di sistema operativo che limita l'accesso al filesystem e alla rete, consentendo a Claude di lavorare più liberamente all'interno di confini definiti217* **Sandboxing**: abilitare l'isolamento a livello di sistema operativo che limita l'accesso al filesystem e alla rete, consentendo a Claude di lavorare più liberamente all'interno di confini definiti

channels.md +1 −1

Details

361 361

362Durante l'anteprima, `--channels` accetta solo plugin da un allowlist mantenuto da Anthropic, o dall'allowlist della tua organizzazione se un amministratore ha impostato [`allowedChannelPlugins`](#restrict-which-channel-plugins-can-run). I plugin di canale in [claude-plugins-official](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins) sono l'insieme approvato predefinito. Se passi qualcosa che non è nell'allowlist effettivo, Claude Code si avvia normalmente ma il canale non si registra, e l'avviso di avvio ti dice perché.362Durante l'anteprima, `--channels` accetta solo plugin da un allowlist mantenuto da Anthropic, o dall'allowlist della tua organizzazione se un amministratore ha impostato [`allowedChannelPlugins`](#restrict-which-channel-plugins-can-run). I plugin di canale in [claude-plugins-official](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins) sono l'insieme approvato predefinito. Se passi qualcosa che non è nell'allowlist effettivo, Claude Code si avvia normalmente ma il canale non si registra, e l'avviso di avvio ti dice perché.

363 363

364Per testare un canale che stai costruendo, usa `--dangerously-load-development-channels`. Vedi [Test durante l'anteprima di ricerca](/docs/it/channels-reference#test-during-the-research-preview) per informazioni sul test di canali personalizzati che costruisci.364Per testare un canale che stai costruendo, passalo a `--dangerously-load-development-channels` nella forma `plugin:<name>@<marketplace>` o `server:<name>`. Vedi [Test durante l'anteprima di ricerca](/docs/it/channels-reference#test-during-the-research-preview) per informazioni sul test di canali personalizzati che costruisci.

365 365

366Segnala problemi o feedback nel [repository GitHub di Claude Code](https://github.com/anthropics/claude-code/issues).366Segnala problemi o feedback nel [repository GitHub di Claude Code](https://github.com/anthropics/claude-code/issues).

367 367

channels-reference.md +1 −1

Details

804 804

805Per rendere il tuo canale installabile e condivisibile, avvolgilo in un [plugin](/docs/it/plugins/overview) e pubblicalo in un [marketplace](/docs/it/plugins/overview). Gli utenti lo installano con `/plugin install`, quindi lo abilitano per sessione con `--channels plugin:<name>@<marketplace>`.805Per rendere il tuo canale installabile e condivisibile, avvolgilo in un [plugin](/docs/it/plugins/overview) e pubblicalo in un [marketplace](/docs/it/plugins/overview). Gli utenti lo installano con `/plugin install`, quindi lo abilitano per sessione con `--channels plugin:<name>@<marketplace>`.

806 806

807Un canale pubblicato nel tuo marketplace ha ancora bisogno di `--dangerously-load-development-channels` per essere eseguito, poiché non è nella [lista di approvazione](/docs/it/channels#supported-channels). La lista di approvazione predefinita è i plugin di canale in `claude-plugins-official`. I [moduli di invio in-app](/docs/it/plugins/publish#submit-to-the-community-marketplace) aggiungono plugin al marketplace della comunità, che non è nella lista di approvazione dei canali.807Un canale pubblicato nel tuo marketplace ha ancora bisogno di `--dangerously-load-development-channels` per essere eseguito, poiché non è nella [lista di approvazione](/docs/it/channels#supported-channels). La lista di approvazione predefinita è i plugin di canale in `claude-plugins-official`. Il marketplace della comunità non è nella lista di approvazione dei canali.

808 808

809Se stai lavorando con un contatto partner di Anthropic, contattalo per coordinare un'inserzione nel marketplace ufficiale. Nei piani Team ed Enterprise, un amministratore può invece includere il tuo plugin nella lista [`allowedChannelPlugins`](/docs/it/channels#restrict-which-channel-plugins-can-run) dell'organizzazione, che sostituisce la lista di approvazione predefinita di Anthropic.809Se stai lavorando con un contatto partner di Anthropic, contattalo per coordinare un'inserzione nel marketplace ufficiale. Nei piani Team ed Enterprise, un amministratore può invece includere il tuo plugin nella lista [`allowedChannelPlugins`](/docs/it/channels#restrict-which-channel-plugins-can-run) dell'organizzazione, che sostituisce la lista di approvazione predefinita di Anthropic.

810 810

checkpointing.md +1 −1

Details

114 I messaggi inviati a metà turno non vengono sottoposti a checkpoint114 I messaggi inviati a metà turno non vengono sottoposti a checkpoint

115</h3>115</h3>

116 116

117Quando un messaggio che [metti in coda mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works) raggiunge Claude durante il turno in esecuzione, si unisce a quel turno invece di iniziarne uno nuovo. Il messaggio appare nella conversazione, ma Claude Code non crea un checkpoint per esso, e il menu di rewind non lo elenca. Un messaggio in coda che Claude Code invia come suo proprio turno riceve un checkpoint come al solito.117Quando un messaggio che [metti in coda mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works) raggiunge Claude durante il turno in esecuzione, si unisce a quel turno invece di iniziarne uno nuovo. Il messaggio appare nella conversazione, ma Claude Code non crea un checkpoint per esso, e il menu di rewind non lo elenca. Un messaggio in coda che Claude Code invia come parte di un nuovo turno riceve un checkpoint come al solito, incluso quando diversi messaggi in coda [condividono quel turno](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued).

118 118

119Per rimuovere tale messaggio, o annullare le modifiche che Claude ha apportato dopo di esso, riavvolgi al prompt che ha avviato il turno. Questo riavvolge l'intero turno, incluso il lavoro che Claude ha svolto prima dell'arrivo del tuo messaggio.119Per rimuovere tale messaggio, o annullare le modifiche che Claude ha apportato dopo di esso, riavvolgi al prompt che ha avviato il turno. Questo riavvolge l'intero turno, incluso il lavoro che Claude ha svolto prima dell'arrivo del tuo messaggio.

120 120

claude-apps-gateway.md +1 −1

Details

77| Provider di identità OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak, o Dex, o qualsiasi altro IdP conforme a OIDC come PingFederate. Il gateway esegue il discovery OIDC standard e il flusso del codice di autorizzazione rispetto ad esso. SAML e LDAP non sono supportati. |77| Provider di identità OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak, o Dex, o qualsiasi altro IdP conforme a OIDC come PingFederate. Il gateway esegue il discovery OIDC standard e il flusso del codice di autorizzazione rispetto ad esso. SAML e LDAP non sono supportati. |

78| PostgreSQL 14 o successivo | Supporta il flusso di accesso del dispositivo, dove il callback del browser scrive e il CLI di polling legge, più contatori di limite di velocità. Qualsiasi Postgres gestito funziona, incluso il livello più piccolo. Senza limiti di spesa configurati, il gateway archivia pochi KB di stato di autenticazione di breve durata; con [limiti di spesa](/docs/it/claude-apps-gateway-spend-limits), contiene anche tabelle di spesa durevole, audit e identità che dovrebbero essere sottoposte a backup. TLS tramite `?sslmode=require` è consigliato. |78| PostgreSQL 14 o successivo | Supporta il flusso di accesso del dispositivo, dove il callback del browser scrive e il CLI di polling legge, più contatori di limite di velocità. Qualsiasi Postgres gestito funziona, incluso il livello più piccolo. Senza limiti di spesa configurati, il gateway archivia pochi KB di stato di autenticazione di breve durata; con [limiti di spesa](/docs/it/claude-apps-gateway-spend-limits), contiene anche tabelle di spesa durevole, audit e identità che dovrebbero essere sottoposte a backup. TLS tramite `?sslmode=require` è consigliato. |

79| Upstream del modello | Credenziali Amazon Bedrock, credenziali Claude Platform su AWS, credenziali Google Cloud, una risorsa Microsoft Foundry o una chiave API Anthropic. Sono supportati più upstream con failover. |79| Upstream del modello | Credenziali Amazon Bedrock, credenziali Claude Platform su AWS, credenziali Google Cloud, una risorsa Microsoft Foundry o una chiave API Anthropic. Sono supportati più upstream con failover. |

80| HTTPS | Il gateway deve essere raggiungibile su `https://` dai laptop degli sviluppatori e da qualsiasi browser utilizzato per l'accesso; il gateway serve la pagina di verifica del dispositivo sullo stesso listener. Fornisci un certificato TLS tramite `listen.tls` o esegui dietro un ingresso che termina TLS, e imposta `listen.public_url` all'origine esterna in entrambi i casi. Un'origine `http://` semplice è accettata solo quando l'host del gateway è loopback: `localhost`, `127.0.0.1`, o `::1`. |80| HTTPS | Il gateway deve essere raggiungibile su `https://` dai laptop degli sviluppatori e da qualsiasi browser utilizzato per l'accesso; il gateway serve la pagina di verifica del dispositivo sullo stesso listener. Fornisci un certificato TLS tramite `listen.tls` o esegui dietro un ingresso che termina TLS, e imposta `listen.public_url` all'origine esterna in entrambi i casi. Su `/login`, Claude Code accetta un'origine `http://` semplice solo quando l'host del gateway è loopback: `localhost`, `127.0.0.1`, o `::1`. |

81| Indirizzo di rete privata | Su `/login`, Claude Code richiede che il nome host o l'indirizzo IP del gateway si risolvano solo in indirizzi privati: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7`, o loopback. Per un gateway che ospiti, qualsiasi indirizzo pubblico al di fuori di un blocco che dichiari è rifiutato; vedi il [modello di minaccia](/docs/it/claude-apps-gateway-deploy#threat-model-summary) nella guida di distribuzione. Se le macchine degli sviluppatori instradano HTTPS attraverso un proxy aziendale, l'accesso richiede anche che l'host proxy si risolva in indirizzi privati; se non lo fa, aggiungi l'host del gateway a `NO_PROXY` in modo che il CLI si connetta direttamente. Se la tua rete interna è numerata da spazio IPv4 pubblico che la tua organizzazione possiede, [dichiara quei blocchi](#allow-a-gateway-on-public-address-space-you-own) in modo che `/login` accetti un gateway lì. |81| Indirizzo di rete privata | Su `/login`, Claude Code richiede che il nome host o l'indirizzo IP del gateway si risolvano solo in indirizzi privati: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7`, o loopback. Per un gateway che ospiti, qualsiasi indirizzo pubblico al di fuori di un blocco che dichiari è rifiutato; vedi il [modello di minaccia](/docs/it/claude-apps-gateway-deploy#threat-model-summary) nella guida di distribuzione. Se le macchine degli sviluppatori instradano HTTPS attraverso un proxy aziendale, l'accesso richiede anche che l'host proxy si risolva in indirizzi privati; se non lo fa, aggiungi l'host del gateway a `NO_PROXY` in modo che il CLI si connetta direttamente. Se la tua rete interna è numerata da spazio IPv4 pubblico che la tua organizzazione possiede, [dichiara quei blocchi](#allow-a-gateway-on-public-address-space-you-own) in modo che `/login` accetti un gateway lì. |

82| Runtime Linux | Il server gateway viene eseguito solo sul binario Linux nativo. macOS funziona per lo sviluppo locale. Windows non è supportato come piattaforma server. |82| Runtime Linux | Il server gateway viene eseguito solo sul binario Linux nativo. macOS funziona per lo sviluppo locale. Windows non è supportato come piattaforma server. |

83 83

claude-apps-gateway-config.md +193 −11

Details

15L'[esempio completo](#complete-example) alla fine di questa pagina esercita ogni sezione.15L'[esempio completo](#complete-example) alla fine di questa pagina esercita ogni sezione.

16 16

17<h2 id="file-structure">17<h2 id="file-structure">

~~18 Struttura del file~~18 Struttura dei file

19</h2>19</h2>

20 20

21Cinque sezioni sono [obbligatorie](#required-sections). Ogni altra sezione è [facoltativa](#optional-sections) e una sezione omessa assume i suoi valori predefiniti. Le chiavi sconosciute causano un errore all'avvio, quindi un errore di battitura emerge come errore denominato piuttosto che come impostazione ignorata silenziosamente.21Cinque sezioni sono [obbligatorie](#required-sections). Ogni altra sezione è [facoltativa](#optional-sections), e una sezione omessa assume i suoi valori predefiniti. Le chiavi sconosciute causano un errore di avvio, quindi un errore di battitura emerge come errore denominato piuttosto che come impostazione ignorata silenziosamente.

22 22

23**Sezioni obbligatorie:**23**Sezioni obbligatorie:**

24 24

25* [`listen`](#listen): indirizzo di binding, URL pubblico, terminazione TLS25* [`listen`](#listen): indirizzo di binding, URL pubblico, terminazione TLS

~~26* [`oidc`](#oidc): il vostro provider di identità (IdP), inclusi emittente, client, mappatura dei claim e chi può accedere~~26* [`oidc`](#oidc): il vostro provider di identità (IdP), inclusi emittente, client, mappatura delle attestazioni e chi può accedere

~~27* [`session`](#session): i token bearer che il gateway conia, con segreto e durata~~27* [`session`](#session): i bearer token che il gateway emette, con segreto e durata

28* [`store`](#store): PostgreSQL, per le concessioni dei dispositivi e i contatori dei limiti di velocità28* [`store`](#store): PostgreSQL, per le concessioni dei dispositivi e i contatori dei limiti di velocità

~~29* [`upstreams`](#upstreams): dove va l'inferenza, sia Anthropic, Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud o Microsoft Foundry~~29* [`upstreams`](#upstreams): dove va l'inferenza, sia che si tratti di Anthropic, Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, o Microsoft Foundry

30 30

31**Sezioni facoltative:**31**Sezioni facoltative:**

32 32

33* [`admin`](#admin): autenticazione dell'API Admin e conservazione dei limiti di spesa33* [`admin`](#admin): autenticazione dell'API Admin e conservazione dei limiti di spesa

34* [`enforcement`](#enforcement): comportamento fail-open o fail-closed dei limiti di spesa34* [`enforcement`](#enforcement): comportamento fail-open o fail-closed dei limiti di spesa

~~35* [`pricing`](#pricing): tariffe contrattuali e un moltiplicatore di sconto per il misuratore di spesa e per le cifre di costo che gli sviluppatori vedono~~35* [`pricing`](#pricing): tariffe contrattuali e un moltiplicatore per il misuratore di spesa e per le cifre di costo che gli sviluppatori vedono

36* [`models`](#models) e `auto_include_builtin_models`: elenco di modelli curato dall'amministratore e ID per upstream36* [`models`](#models) e `auto_include_builtin_models`: elenco di modelli curato dall'amministratore e ID per upstream

37* [`managed`](#managed): politiche di impostazioni gestite per gruppo IdP37* [`managed`](#managed): politiche di impostazioni gestite per gruppo IdP

38* [`telemetry`](#telemetry): inoltro OTLP al vostro stack di osservabilità38* [`telemetry`](#telemetry): inoltro OTLP al vostro stack di osservabilità

~~39* [`access_control`, `limits`, `timeouts`, `rate_limits`](#http-tuning): IP allow/deny, limiti di dimensione delle richieste, time-to-first-byte upstream e limiti di accesso per IP~~39* [`access_control`, `limits`, `timeouts`, `rate_limits`](#http-tuning): IP allow/deny, limiti di dimensione delle richieste, tempo di primo byte upstream e limiti di accesso per IP

40* [`load_test_mode`](#load_test_mode): test di carico del gateway senza chiamare un provider di modelli

40 41

41<h2 id="secret-expansion">42<h2 id="secret-expansion">

42 Espansione dei segreti43 Espansione dei segreti

94| `id_token_signed_response_alg` | No | Algoritmo di firma id\_token previsto. Predefinito `RS256`. Impostate per gli IdP che firmano con ES256, PS256 o EdDSA. |95| `id_token_signed_response_alg` | No | Algoritmo di firma id\_token previsto. Predefinito `RS256`. Impostate per gli IdP che firmano con ES256, PS256 o EdDSA. |

95| `additional_authorized_parties` | No | Valori `azp` extra da accettare oltre a `client_id`, per i flussi di broker e scambio di token di Keycloak |96| `additional_authorized_parties` | No | Valori `azp` extra da accettare oltre a `client_id`, per i flussi di broker e scambio di token di Keycloak |

96| `discovery_url` | No | Recuperate il documento di scoperta da questo URL invece di derivarlo da `issuer`, per gli IdP dietro un proxy che riscrive l'host dell'emittente. Il percorso deve contenere `/.well-known/`. |97| `discovery_url` | No | Recuperate il documento di scoperta da questo URL invece di derivarlo da `issuer`, per gli IdP dietro un proxy che riscrive l'host dell'emittente. Il percorso deve contenere `/.well-known/`. |

97| `use_proxy` | No | Inviate le richieste IdP del gateway stesso attraverso il proxy forward in `HTTPS_PROXY` o `HTTP_PROXY`, onorando `NO_PROXY`. Non impostato o `false`, quelle richieste vanno dirette. Richiede v2.1.227 o successivo; vedere [Richieste IdP attraverso un proxy forward](#idp-requests-through-a-forward-proxy) di seguito. |98| `use_proxy` | No | Inviate le richieste IdP del gateway stesso attraverso il proxy forward in `HTTPS_PROXY` o `HTTP_PROXY`, onorando `NO_PROXY`. `false` mantiene quelle richieste dirette. Richiede v2.1.227 o successivo; vedere [Richieste IdP attraverso un proxy forward](#idp-requests-through-a-forward-proxy) di seguito. |

98| `form_action_origins` | No | Origini aggiuntive per la direttiva `Content-Security-Policy: form-action` della pagina `/device`. Il gateway consente già `'self'` e l'origine dell'`authorization_endpoint` scoperta, ma Chrome applica `form-action` all'intera catena di reindirizzamento. Se il vostro IdP reindirizza attraverso un secondo host, come Azure AD federato ad ADFS, Okta hub-spoke o un intercettore SSO aziendale, elencate ogni origine attraverso cui la richiesta di autorizzazione può reindirizzare. |99| `form_action_origins` | No | Origini aggiuntive per la direttiva `Content-Security-Policy: form-action` della pagina `/device`. Il gateway consente già `'self'` e l'origine dell'`authorization_endpoint` scoperta, ma Chrome applica `form-action` all'intera catena di reindirizzamento. Se il vostro IdP reindirizza attraverso un secondo host, come Azure AD federato ad ADFS, Okta hub-spoke o un intercettore SSO aziendale, elencate ogni origine attraverso cui la richiesta di autorizzazione può reindirizzare. |

99| `ca_cert_pem` | No | Il certificato CA PEM stesso, non un percorso a un file. Sostituisce l'archivio di fiducia del sistema solo per le richieste IdP. Per caricare un file montato, scrivete `${file:/etc/gateway/idp-ca.pem}`. Usate per Keycloak o Dex dietro PKI aziendale. |100| `ca_cert_pem` | No | Il certificato CA PEM stesso, non un percorso a un file. Sostituisce l'archivio di fiducia del sistema solo per le richieste IdP. Per caricare un file montato, scrivete `${file:/etc/gateway/idp-ca.pem}`. Usate per Keycloak o Dex dietro PKI aziendale. |

100 101

106 107

107Con `use_proxy: true`, il pod risolve il nome host di ogni endpoint IdP stesso e chiede al proxy di `CONNECT` all'indirizzo IP risolto, quindi il proxy deve accettare `CONNECT` all'indirizzo IP di ogni host che il documento di scoperta nomina, non solo l'emittente. Usate un URL proxy `http://`. `ca_cert_pem` e la [guardia SSRF](/docs/it/claude-apps-gateway-deploy#threat-model-summary) si applicano anche sul percorso proxato.108Con `use_proxy: true`, il pod risolve il nome host di ogni endpoint IdP stesso e chiede al proxy di `CONNECT` all'indirizzo IP risolto, quindi il proxy deve accettare `CONNECT` all'indirizzo IP di ogni host che il documento di scoperta nomina, non solo l'emittente. Usate un URL proxy `http://`. `ca_cert_pem` e la [guardia SSRF](/docs/it/claude-apps-gateway-deploy#threat-model-summary) si applicano anche sul percorso proxato.

108 109

110[Egress solo proxy](#proxy-only-egress) cambia entrambi questi: mentre è attivo, le richieste IdP seguono il proxy a meno che non impostiate `use_proxy: false`, e il gateway consegna al proxy ogni nome host IdP senza risolverlo prima.

111

112<h4 id="proxy-only-egress">

113 Egress solo proxy

114</h4>

115

116Impostate `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` nell'ambiente del gateway, accanto a `HTTPS_PROXY`, quando il pod raggiunge altri host solo attraverso quel proxy forward e non può risolvere i nomi DNS pubblici stesso, o quando il proxy rifiuta `CONNECT` a un indirizzo IP. Richiede v2.1.277 o successivo. È una variabile di ambiente piuttosto che una chiave `gateway.yaml` in modo che nulla nel file di configurazione possa rilassare il controllo dell'indirizzo del gateway.

117

118```bash theme={null}

119export HTTPS_PROXY=http://proxy.corp.example.com:3128

120export NO_PROXY=

121export no_proxy=

122export CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1

123```

124

125Il gateway registra una riga `network:` all'avvio mentre l'egress solo proxy è attivo.

126

127Ogni riga di seguito è una classe di richiesta in uscita su un gateway con `HTTPS_PROXY` impostato, per impostazione predefinita e mentre l'egress solo proxy è attivo.

128

129| Richiesta in uscita | Predefinito | Egress solo proxy attivo |

130| - | - | - |

131| `provider: anthropic` upstream, scambio di token Workload Identity Federation, esportazioni `telemetry.forward_to` | Risolto e controllato localmente, quindi `CONNECT` all'indirizzo IP controllato attraverso il proxy. Un collettore di telemetria elencato in `NO_PROXY` viene raggiunto direttamente invece | Nome host consegnato al proxy |

132| Scoperta IdP, JWKS, token e userinfo | Diretto a meno che [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy), quindi `CONNECT` all'indirizzo IP controllato | Nome host consegnato al proxy, a meno che `oidc.use_proxy: false` non mantenga un IdP interno diretto |

133| Amazon Bedrock, Claude Platform on AWS, Agent Platform di Google Cloud e upstream Microsoft Foundry; ricerche di gruppi Google | Nome host consegnato al proxy | Invariato |

134

135L'egress solo proxy rimane disattivato a meno che l'ambiente del gateway non soddisfi tutti e tre questi condizioni:

136

137* `HTTPS_PROXY` o `HTTP_PROXY` è impostato.

138* `NO_PROXY` e `no_proxy` sono vuoti. Se la vostra piattaforma inietta uno di questi nei pod, impostate entrambi a un valore vuoto sul contenitore del gateway. Elencando un collettore di telemetria in `NO_PROXY` mantiene l'egress solo proxy disattivato.

139* `CLAUDE_GATEWAY_ALLOW_LOOPBACK` non è attivato. Un collettore o IdP sul loopback proprio del pod non può essere combinato con l'egress solo proxy, perché un indirizzo loopback consegnato al proxy sarebbe il proprio dell'host proxy, quindi date a quei servizi un indirizzo che il proxy può raggiungere invece. Per lo stesso motivo il gateway rifiuta i nomi di stile `localhost` completamente mentre l'egress solo proxy è attivo.

140

141Quando una di queste condizioni non è soddisfatta, il gateway registra un avviso all'avvio nominando la variabile che l'ha fermato e mantiene il comportamento predefinito.

142

143Una volta che l'egress solo proxy è attivo, consentite ogni destinazione nel proxy, incluso un collettore interno e qualsiasi host configurato per indirizzo IP. Potete ancora mantenere un IdP interno diretto con [`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy).

144

145<Warning>

146 Attivate questo solo quando l'allowlist del proxy è almeno altrettanto rigoroso del controllo del gateway stesso. Il proxy deve rifiutare gli endpoint dei metadati cloud come `169.254.169.254` e `metadata.google.internal`, gli indirizzi link-local e il loopback dell'host proxy stesso, e deve rifiutarli per l'indirizzo a cui un nome si risolve, non solo per nome, perché il gateway non cattura più un nome host che si risolve a uno di essi. Un proxy che si connette ovunque gli viene chiesto rimuove la [guardia SSRF](/docs/it/claude-apps-gateway-deploy#threat-model-summary) del gateway per queste richieste.

147</Warning>

148

109<h3 id="session">149<h3 id="session">

110 `session`150 `session`

111</h3>151</h3>

129| `username` | No | Sovrascrive l'utente in `postgres_url` |169| `username` | No | Sovrascrive l'utente in `postgres_url` |

130| `password` | No | Credenziale del database. Impostatela qui piuttosto che in `postgres_url` in modo che la credenziale rimanga fuori dall'URL. Accetta qualsiasi carattere e ha la precedenza sulle credenziali dell'URL. |170| `password` | No | Credenziale del database. Impostatela qui piuttosto che in `postgres_url` in modo che la credenziale rimanga fuori dall'URL. Accetta qualsiasi carattere e ha la precedenza sulle credenziali dell'URL. |

131| `max_connections` | No | Dimensione del pool di connessioni Postgres per replica. Predefinito `5`, che è conservativo e amichevole ai database condivisi. Con i [limiti di spesa](#admin) abilitati, il percorso caldo esegue alcune operazioni per richiesta di inferenza, quindi aumentatelo per un database dedicato sotto carico e mantenete repliche × questo sotto il `max_connections` del database. |171| `max_connections` | No | Dimensione del pool di connessioni Postgres per replica. Predefinito `5`, che è conservativo e amichevole ai database condivisi. Con i [limiti di spesa](#admin) abilitati, il percorso caldo esegue alcune operazioni per richiesta di inferenza, quindi aumentatelo per un database dedicato sotto carico e mantenete repliche × questo sotto il `max_connections` del database. |

172| `connect_timeout_seconds` | No | Secondi che il gateway attende quando apre una connessione Postgres. Un numero intero da `1` a `60`, predefinito `5`. Aumentatelo se i tentativi di connessione scadono quando una nuova istanza del gateway si avvia. Richiede Claude Code v2.1.274 o successivo sul server del gateway. Le versioni precedenti si rifiutano di avviarsi quando la chiave è impostata. |

132 173

133Per lo sviluppo locale, puntate `postgres_url` a un contenitore Postgres usa e getta, ad esempio `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`.174Per lo sviluppo locale, puntate `postgres_url` a un contenitore Postgres usa e getta, ad esempio `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`.

134 175

365| ACI / App Service | Abilitate l'identità gestita assegnata dal sistema o assegnata dall'utente sulla risorsa. `use_azure_ad: true` lo raccoglie. |406| ACI / App Service | Abilitate l'identità gestita assegnata dal sistema o assegnata dall'utente sulla risorsa. `use_azure_ad: true` lo raccoglie. |

366| Altrove | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Quotate `${…}` dentro `{ }`. |407| Altrove | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Quotate `${…}` dentro `{ }`. |

367 408

409<h4 id="static-headers-on-upstream-requests">

410 Intestazioni statiche sulle richieste upstream

411</h4>

412

413Per aggiungere intestazioni fisse alle richieste che il gateway invia a un upstream, impostate `headers:` su quell'upstream. Usatelo quando un proxy che gestite davanti al provider instrada o attribuisce il traffico per un intestazione.

414

415`headers:` richiede Claude Code v2.1.277 o successivo sul server del gateway. Un gateway precedente si rifiuta di avviarsi quando trova la chiave. Aggiornate ogni replica prima di aggiungere la chiave e rimuovete la chiave prima di eseguire il rollback a una versione precedente.

416

417Gli intestazioni vanno al server che `base_url` nomina, o all'endpoint proprio del provider quando `base_url` non è impostato. Il provider li riceve anche a meno che il vostro proxy non li rimuova.

418

419Questo esempio raggiunge un upstream `provider: vertex` attraverso un proxy su `upstream-proxy.internal.example.com`. Imposta l'intestazione `x-source` che il proxy legge e invia un token dalla variabile di ambiente `PROXY_TOKEN` come `x-proxy-token`:

420

421```yaml theme={null}

422upstreams:

423 - provider: vertex

424 region: us-east5

425 project_id: example-prod

426 base_url: https://upstream-proxy.internal.example.com

427 auth: {}

428 headers:

429 x-source: claude-apps-gateway

430 x-proxy-token: ${PROXY_TOKEN}

431```

432

433I valori sono testo ASCII stampabile senza spazio a nessuno dei due lati. Quotate un numero, `true` o `false` in modo che YAML lo legga come testo.

434

435Per mantenere un segreto fuori dal file di configurazione, usate l'[espansione del segreto](#secret-expansion) per caricare il valore da una variabile di ambiente con `${VAR}` o da un file con `${file:/path}`. Un `${VAR}` che si risolve a un valore vuoto ferma il gateway dall'avviarsi.

436

437`headers:` funziona su ogni provider e ogni upstream invia solo il suo.

438

439Non ogni richiesta che il gateway invia a un upstream li porta:

440

441| Richiesta che il gateway invia a questo upstream | Porta `headers:` |

442| - | - |

443| `/v1/messages`, streaming o no, e `/v1/messages/count_tokens` | Sì |

444| Una richiesta che ha eseguito il failover da un altro upstream | Sì, solo `headers:` di questo upstream |

445| Chiamata `CountTokens` di Amazon Bedrock per una richiesta che il client ha abbandonato | No |

446| Lo scambio di token Workload Identity Federation | No |

447

448Su un upstream Amazon Bedrock o Claude Platform on AWS che firma le richieste con AWS SigV4, questi intestazioni fanno parte della firma, quindi il vostro proxy deve passarli attraverso invariati.

449

450Se usate un nome che il gateway riserva, si rifiuta di avviarsi e l'errore di avvio nomina l'intestazione. I nomi riservati includono:

451

452* `authorization` e `x-api-key`

453* `host`, `content-type` e `user-agent`

454* Qualsiasi nome che inizia con `anthropic-`, `x-goog-`, `x-amz-` o `x-amzn-`

455

368<h4 id="multiple-upstreams">456<h4 id="multiple-upstreams">

369 Più upstream457 Più upstream

370</h4>458</h4>

375 463

376`429` è capacità per upstream, quindi l'esaurimento del throughput provisioned (PT) esegue il failover a on-demand. Se impostate [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) su un upstream, un `429` a una richiesta che portava l'email dello sviluppatore è un rifiuto per utente invece e non esegue il failover.464`429` è capacità per upstream, quindi l'esaurimento del throughput provisioned (PT) esegue il failover a on-demand. Se impostate [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) su un upstream, un `429` a una richiesta che portava l'email dello sviluppatore è un rifiuto per utente invece e non esegue il failover.

377 465

466Ogni richiesta inizia al primo upstream. Una richiesta raggiunge un upstream successivo solo quando ogni upstream davanti ad esso ha fallito o non serve il modello richiesto.

467

468Il gateway non mantiene alcun record di upstream falliti, quindi mentre un upstream è inattivo, ogni richiesta che lo raggiunge lo prova ancora e attende che fallisca prima di passare al successivo.

469

470Per un upstream API Anthropic, [`timeouts.upstream_ttfb_ms`](#http-tuning) limita l'attesa su un upstream inattivo. Questa impostazione non si applica agli altri provider, dove il gateway attende fino a un'ora che un upstream inizi a rispondere.

471

378`404` è disponibilità del modello per upstream, quindi un upstream che non ha abilitato un modello non blocca un upstream successivo che lo serve. Un upstream che non può risolvere il modello richiesto viene saltato senza un round-trip di rete.472`404` è disponibilità del modello per upstream, quindi un upstream che non ha abilitato un modello non blocca un upstream successivo che lo serve. Un upstream che non può risolvere il modello richiesto viene saltato senza un round-trip di rete.

379 473

380Questo esempio instrada un'allocazione Bedrock di throughput provisioned per primo, trabocca a on-demand e un secondo account e ricade all'API Anthropic per ultimo:474Questo esempio instrada un'allocazione Bedrock di throughput provisioned per primo, trabocca a on-demand e un secondo account e ricade all'API Anthropic per ultimo:

797 891

798[Claude Desktop](#claude-desktop-overlay) e le sessioni Cowork firmate attraverso il gateway timbrano la loro telemetria con `user.email` e `user.groups` insieme a `enduser.id`, quindi puoi coprire l'utilizzo di terminale, Desktop e Cowork con una query su `user.email` o `user.groups`. `user.groups` è l'elenco di gruppi IdP separato da virgole.892[Claude Desktop](#claude-desktop-overlay) e le sessioni Cowork firmate attraverso il gateway timbrano la loro telemetria con `user.email` e `user.groups` insieme a `enduser.id`, quindi puoi coprire l'utilizzo di terminale, Desktop e Cowork con una query su `user.email` o `user.groups`. `user.groups` è l'elenco di gruppi IdP separato da virgole.

799 893

894Desktop e Cowork telemetry portano anche `enduser.sub`, il claim `sub` che il tuo provider di identità emette per l'utente, che rimane lo stesso quando l'email di un utente cambia. Le sessioni di terminale timbrano lo stesso valore sotto `user.id`, quindi una query che corrisponde a `enduser.sub` rispetto al terminale `user.id` copre l'utilizzo di terminale, Desktop e Cowork di un utente insieme. Sulle esportazioni Desktop e Cowork, `user.id` è un identificatore anonimo, non il soggetto.

895

800Come tutti i dati OpenTelemetry da Claude Code, questi attributi vanno solo alle destinazioni che la tua organizzazione configura, mai ad Anthropic.896Come tutti i dati OpenTelemetry da Claude Code, questi attributi vanno solo alle destinazioni che la tua organizzazione configura, mai ad Anthropic.

801 897

802Se l'elenco di gruppi di un utente è più lungo di 255 caratteri una volta codificato in percentuale, o un nome di gruppo contiene una virgola o un segno di uguale, il gateway lascia `user.groups` fuori dalla telemetria Desktop e Cowork di quell'utente piuttosto che troncarla. Le sessioni di terminale di quell'utente portano comunque l'elenco completo.898Se l'elenco di gruppi di un utente è più lungo di 255 caratteri una volta codificato in percentuale, o un nome di gruppo contiene una virgola o un segno di uguale, il gateway lascia `user.groups` fuori dalla telemetria Desktop e Cowork di quell'utente piuttosto che troncarla. Le sessioni di terminale di quell'utente portano comunque l'elenco completo.

803 899

900Il gateway lascia `enduser.sub` fuori quando il soggetto è più lungo di 255 caratteri una volta codificato in percentuale, o contiene uno spazio, un carattere al di fuori dell'ASCII stampabile, o uno di `,` `;` `=` `\` `"` `%`. La telemetria Desktop e Cowork di quell'utente mantiene i suoi altri attributi.

901

804Hai bisogno di Claude Code v2.1.265 o successivo sul server del gateway per `user.email` e `user.groups` sulla telemetria Desktop e Cowork, e Claude Desktop 1.24012 o successivo su ogni macchina dello sviluppatore per `user.groups`.902Hai bisogno di Claude Code v2.1.265 o successivo sul server del gateway per `user.email` e `user.groups` sulla telemetria Desktop e Cowork, e Claude Desktop 1.24012 o successivo su ogni macchina dello sviluppatore per `user.groups`.

805 903

904Hai bisogno di Claude Code v2.1.274 o successivo sul server del gateway per `enduser.sub`.

905

806```yaml theme={null}906```yaml theme={null}

807telemetry:907telemetry:

808 forward_to:908 forward_to:

834 934

835Per un collettore in-cluster, esponilo su HTTPS al suo indirizzo interno, o eseguilo come sidecar con la variabile impostata.935Per un collettore in-cluster, esponilo su HTTPS al suo indirizzo interno, o eseguilo come sidecar con la variabile impostata.

836 936

937Quando `HTTPS_PROXY` è impostato, il gateway invia le esportazioni attraverso quel proxy.

938

939Per raggiungere un collettore interno direttamente, aggiungilo a `NO_PROXY` per nome host o per un dominio con un punto iniziale come `.internal.example.com`, che richiede Claude Code v2.1.277 o successivo sul server del gateway. Assicurati che il gateway possa raggiungere il collettore senza il proxy. Una voce senza un punto iniziale corrisponde solo a quel nome esatto, non ai nomi sotto di esso. Gli intervalli CIDR non corrispondono.

940

941Con [proxy-only egress](#proxy-only-egress) attivato, consenti il collettore nel proxy invece, poiché qualsiasi voce `NO_PROXY` mantiene l'uscita solo proxy disattivata.

942

837La telemetria è disattivata nella CLI per impostazione predefinita. Quando imposti sia `telemetry.forward_to` che `listen.public_url`, il gateway la attiva per i client connessi spingendo sei variabili di ambiente attraverso `/managed/settings`:943La telemetria è disattivata nella CLI per impostazione predefinita. Quando imposti sia `telemetry.forward_to` che `listen.public_url`, il gateway la attiva per i client connessi spingendo sei variabili di ambiente attraverso `/managed/settings`:

838 944

839* `CLAUDE_CODE_ENABLE_TELEMETRY=1`945* `CLAUDE_CODE_ENABLE_TELEMETRY=1`

841* `OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>`947* `OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>`

842* `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`948* `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`

843 949

950Quando aggiungi le tue etichette personalizzate]\(#add-your-own-labels), il gateway spinge anche `OTEL_RESOURCE_ATTRIBUTES`.

951

844Prima di Claude Code v2.1.265 sul server del gateway, il gateway spingeva tutti e tre i selettori di esportazione come `otlp`, incluso per i segnali che nessuna destinazione ha optato.952Prima di Claude Code v2.1.265 sul server del gateway, il gateway spingeva tutti e tre i selettori di esportazione come `otlp`, incluso per i segnali che nessuna destinazione ha optato.

845 953

846L'endpoint spinto è costruito dall'URL pubblico, quindi metriche e log non hanno bisogno di configurazione OTEL da sviluppatori o policy.954L'endpoint spinto è costruito dall'URL pubblico, quindi metriche e log non hanno bisogno di configurazione OTEL da sviluppatori o policy.

858 966

859Sia la codifica protobuf che JSON OTLP vengono inoltrate, e qualsiasi backend compatibile con OpenTelemetry funziona come destinazione.967Sia la codifica protobuf che JSON OTLP vengono inoltrate, e qualsiasi backend compatibile con OpenTelemetry funziona come destinazione.

860 968

969<h4 id="add-your-own-labels">

970 Add your own labels

971</h4>

972

973Per mettere etichette fisse come `service.namespace` o `deployment.environment.name` sulla telemetria delle sessioni firmate attraverso il gateway, imposta `telemetry.resource_attributes`. Ogni etichetta è un attributo di risorsa OpenTelemetry, e ogni destinazione riceve le stesse etichette.

974

975Le sessioni ottengono le etichette solo quando imposti anche `telemetry.forward_to` e `listen.public_url`. Questo esempio aggiunge due etichette:

976

977```yaml theme={null}

978telemetry:

979 forward_to:

980 - url: https://otel-collector.internal.example.com

981 resource_attributes:

982 service.namespace: claude

983 deployment.environment.name: prod

984```

985

986Il gateway rifiuta di avviarsi quando un'etichetta infrange una di queste regole, e l'errore di avvio nomina l'etichetta:

987

988* I nomi usano solo lettere, cifre, `.`, `_` e `-`

989* I nomi non sono riservati. Confrontati in qualsiasi maiuscola, i nomi riservati sono tutto ciò che inizia con `user.`, `enduser.` o `identity.`, più `service.name`, `service.version`, `claude.deployment_mode`, `host.arch`, `os.type`, `os.version` e `wsl.version`

990* I valori sono ASCII stampabile non vuoto senza spazio e nessuno di `, ; = \ " %`

991* I valori sono al massimo 255 caratteri come il gateway li conta dopo la codifica percentuale, quindi `/`, `:` e `@` contano ciascuno come tre

992* I valori sono testo, quindi cita un numero, `true` o `false`

993

994Hai bisogno di Claude Code v2.1.281 o successivo sul server del gateway per impostare `telemetry.resource_attributes`. Un gateway precedente rifiuta di avviarsi quando trova la chiave. Aggiorna ogni replica prima di aggiungere la chiave, e rimuovi la chiave prima di eseguire il rollback a una versione precedente.

995

996Le sessioni di terminale firmate attraverso `/login` ricevono le etichette come `OTEL_RESOURCE_ATTRIBUTES`, spinte con le altre [telemetry variables](#telemetry). Se imposti `OTEL_RESOURCE_ATTRIBUTES` nel blocco `env` di una policy, le sessioni di terminale che quella policy corrisponde ottengono quel valore invece delle etichette. Claude Desktop riceve le etichette dal gateway insieme a `user.email` e agli altri attributi di identità.

997

998Claude Code copia anche ogni etichetta su ogni punto dati metrico, quindi puoi filtrare le metriche per essa in un backend che non indicizza gli attributi di risorsa. Per disattivare quella copia, vedi [Metrics cardinality control](/docs/it/monitoring-usage#metrics-cardinality-control).

999

861<h4 id="export-directly-to-your-collector">1000<h4 id="export-directly-to-your-collector">

862 Export directly to your collector1001 Export directly to your collector

863</h4>1002</h4>

907| `limits` | `max_request_bytes` | 32 MiB | Max corpo della richiesta in entrata; le richieste di dimensioni eccessive ottengono `413` prima che il corpo sia bufferizzato. Aumenta per richieste di file o immagini di grandi dimensioni. |1046| `limits` | `max_request_bytes` | 32 MiB | Max corpo della richiesta in entrata; le richieste di dimensioni eccessive ottengono `413` prima che il corpo sia bufferizzato. Aumenta per richieste di file o immagini di grandi dimensioni. |

910| `timeouts` | `upstream_ttfb_ms` | 120000 | Max attesa per le intestazioni di risposta dell'upstream (tempo al primo byte). Il corpo della risposta quindi scorre senza cap di wall-clock. Si applica al percorso upstream diretto di Anthropic; ogni altro provider è limitato dal timeout proprio dell'SDK del provider. |1049| `timeouts` | `upstream_ttfb_ms` | 120000 | Max attesa per le intestazioni di risposta dell'upstream (tempo al primo byte). Il corpo della risposta quindi scorre senza cap di wall-clock. Si applica al percorso upstream diretto di Anthropic; su ogni altro provider il gateway attende fino a un'ora affinché la risposta inizi. |

911| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Limite di velocità per IP sull'endpoint di autorizzazione del dispositivo non autenticato. Aumenta per una grande organizzazione dietro un IP di uscita condiviso o NAT. Questi limiti si applicano solo al flusso di accesso con concessione del dispositivo, non all'inferenza `/v1/messages`. Vedi [User-code brute-force resistance](/docs/it/claude-apps-gateway-deploy#user-code-brute-force-resistance). |1050| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Limite di velocità per IP sull'endpoint di autorizzazione del dispositivo non autenticato. Aumenta per una grande organizzazione dietro un IP di uscita condiviso o NAT. [Large rollouts](/docs/it/claude-apps-gateway-deploy#large-rollouts) mostra come dimensionarlo. Questi limiti si applicano solo al flusso di accesso con concessione del dispositivo, non all'inferenza `/v1/messages`. Vedi [User-code brute-force resistance](/docs/it/claude-apps-gateway-deploy#user-code-brute-force-resistance). |

912| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Limite di velocità per IP su invii di `user_code` su `/device` |1051| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Limite di velocità per IP su invii di `user_code` su `/device`. È quello che impedisce a qualcuno di indovinare il codice di un altro sviluppatore. [Large rollouts](/docs/it/claude-apps-gateway-deploy#large-rollouts) mostra quanto aumentarlo. |

913 1052

914Se lasci entrambi gli elenchi `access_control` vuoti, che è il valore predefinito, il gateway serve qualsiasi indirizzo client, quindi solo la tua rete limita chi può raggiungerlo. Questo è importante perché un gateway può spingere [impostazioni gestite](#managed) che eseguono comandi sulle macchine degli sviluppatori.1053Se lasci entrambi gli elenchi `access_control` vuoti, che è il valore predefinito, il gateway serve qualsiasi indirizzo client, quindi solo la tua rete limita chi può raggiungerlo. Questo è importante perché un gateway può spingere [impostazioni gestite](#managed) che eseguono comandi sulle macchine degli sviluppatori.

915 1054

922 1061

923Dietro un tale front end, imposta [`listen.trusted_proxies`](#listen) per primo in modo che il gateway veda gli indirizzi client reali, e mantieni il gateway e tutto davanti ad esso irraggiungibile da internet pubblico indipendentemente.1062Dietro un tale front end, imposta [`listen.trusted_proxies`](#listen) per primo in modo che il gateway veda gli indirizzi client reali, e mantieni il gateway e tutto davanti ad esso irraggiungibile da internet pubblico indipendentemente.

924 1063

1064<h3 id="load_test_mode">

1065 `load_test_mode`

1066</h3>

1067

1068Il blocco `load_test_mode` ti consente di testare il carico di un gateway senza chiamare un provider di modelli. Mentre è attivo, il gateway costruisce e firma ogni richiesta del provider come al solito, la scarta invece di inviarla, e trasmette una risposta in scatola attraverso il suo percorso di risposta normale. La risposta è testo di riempimento che inizia con una frase che dice che è in scatola.

1069

1070Richiede Claude Code v2.1.282 o successivo sul server del gateway. Una versione precedente rifiuta di avviarsi quando trova la chiave. Aggiorna ogni replica prima di aggiungere il blocco, e rimuovi il blocco prima di eseguire il rollback.

1071

1072L'esempio seguente attiva la modalità con i valori predefiniti, una risposta di circa 750 token di testo trasmessi in circa 10 secondi:

1073

1074```yaml theme={null}

1075load_test_mode:

1076 enabled: true

1077 reply_tokens: 750 # roughly how many tokens of text each canned reply carries

1078 reply_seconds: 9.5 # how long a streamed reply takes

1079```

1080

1081| Campo | Obbligatorio | Descrizione |

1082| - | - | - |

1083| `enabled` | Sì | `true` attiva la modalità. `false` mantiene i tuoi numeri nel file con la modalità disattivata. Il gateway rifiuta di avviarsi se il blocco è presente senza di esso. |

1084| `reply_tokens` | No | Predefinito `750`. Approssimativamente quanti token di testo ogni risposta in scatola porta, un numero intero da 1 a 100000. |

1085| `reply_seconds` | No | Predefinito `9.5`. Quanto tempo impiega una risposta trasmessa, da 0 a 600. `0` invia l'intera risposta in una volta. Una risposta a una richiesta non trasmessa torna sempre in una volta. |

1086

1087Un test di carico in questa modalità copre il gateway, il tuo Postgres e tutto davanti al gateway. Non copre i limiti, la velocità o il percorso di rete del provider.

1088

1089Nessuna richiesta di modello viene inviata al provider, quindi la CPU di una replica per richiesta è una stima e legge inferiore alla produzione, che crittografa anche il suo traffico al provider. Conferma un conteggio di replica con un piccolo pilota rispetto al provider reale. Prima di v2.1.283, la stima legge molto più bassa.

1090

1091Mentre la modalità è attiva, una richiesta può portare un header `x-load-test-user` che contiene un numero intero di fino a sette cifre. Il gateway conta ogni numero come uno sviluppatore separato, con l'email e i gruppi dello sviluppatore il cui token è venuto con la richiesta.

1092

1093Dai alla distribuzione del test di carico il suo database vuoto, perché il gateway rifiuta di avviarsi con la modalità attiva rispetto a un database in cui uno sviluppatore ha già speso qualcosa.

1094

1095<Warning>

1096 Non attivare mai questo per un gateway che gli sviluppatori usano. Ogni richiesta ottiene la risposta in scatola e nessun modello viene chiamato. Il gateway registra un avviso `load_test_mode is on` all'avvio e contrassegna ogni evento di audit [`inference`](/docs/it/claude-apps-gateway-deploy#logs) con `load_test: true` mentre la modalità è attiva.

1097</Warning>

1098

925<h2 id="complete-example">1099<h2 id="complete-example">

926 Esempio completo1100 Esempio completo

927</h2>1101</h2>

973store:1147store:

974 postgres_url: ${GATEWAY_POSTGRES_URL}1148 postgres_url: ${GATEWAY_POSTGRES_URL}

975 # max_connections: 51149 # max_connections: 5

1150 # connect_timeout_seconds: 5

976 1151

977# Enables /v1/organizations/spend_limits (mirrors the Anthropic Admin API)1152# Enables /v1/organizations/spend_limits (mirrors the Anthropic Admin API)

978# and per-developer spend enforcement on /v1/messages. Omit to disable.1153# and per-developer spend enforcement on /v1/messages. Omit to disable.

992# enforcement:1167# enforcement:

993# fail_closed_on_error: false1168# fail_closed_on_error: false

994 1169

1170# Load test this deployment without calling a model provider. Never on a

1171# gateway that developers use: every request gets a canned reply.

1172# load_test_mode:

1173# enabled: true

1174# # reply_tokens: 750

1175# # reply_seconds: 9.5

1176

995# Meter at contracted rates instead of USD list price. Requires admin: or a1177# Meter at contracted rates instead of USD list price. Requires admin: or a

996# managed: policy. With managed:, the same rates also go to signed-in clients.1178# managed: policy. With managed:, the same rates also go to signed-in clients.

997# Rates below are placeholders, not real contract prices.1179# Rates below are placeholders, not real contract prices.

claude-apps-gateway-deploy.md +17 −5

Details

181 Salute181 Salute

182</h3>182</h3>

183 183

184Il gateway serve `GET /healthz` come sonda di liveness e `GET /readyz` come sonda di readiness; `/readyz` verifica che lo store sia raggiungibile. Entrambi sono esenti da `access_control.allow_cidrs`, quindi le sonde continuano a funzionare su un listener bloccato.184Il gateway serve `GET /healthz` come sonda di liveness e `GET /readyz` come sonda di readiness. `/readyz` verifica che lo store sia raggiungibile. Se imposti [`store.readiness_grace_seconds`](/docs/it/claude-apps-gateway-config#store), `/readyz` continua a segnalare ready per fino a quel numero di secondi dopo che lo store smette di rispondere.

185

186Entrambi gli endpoint sono esenti da `access_control.allow_cidrs`, quindi le sonde continuano a funzionare su un listener bloccato.

185 187

186Il documento di scoperta OAuth in `/.well-known/oauth-authorization-server` restituisce anche `200` solo dopo il caricamento della configurazione, la scoperta OIDC, la costruzione del client upstream e la migrazione di Postgres, quindi funge anche da controllo di avvio end-to-end.188Il documento di scoperta OAuth in `/.well-known/oauth-authorization-server` restituisce anche `200` solo dopo il caricamento della configurazione, la scoperta OIDC, la costruzione del client upstream e la migrazione di Postgres, quindi funge anche da controllo di avvio end-to-end.

187 189

217* **Sessioni esistenti**: i bearer token si convalidano localmente con il segreto JWT, gli aggiornamenti della sessione non toccano lo store, e il processo del gateway può comunque servire l'inferenza219* **Sessioni esistenti**: i bearer token si convalidano localmente con il segreto JWT, gli aggiornamenti della sessione non toccano lo store, e il processo del gateway può comunque servire l'inferenza

218* **Nuovi accessi**: falliscono fino al recupero di Postgres, perché il flusso del dispositivo e i suoi contatori di limite di velocità vivono in Postgres220* **Nuovi accessi**: falliscono fino al recupero di Postgres, perché il flusso del dispositivo e i suoi contatori di limite di velocità vivono in Postgres

219* **[Applicazione del limite di spesa](/docs/it/claude-apps-gateway-spend-limits#postgres-availability)**: fallisce aperto per impostazione predefinita durante l'interruzione, quindi l'inferenza continua a fluire; capovolgilo per fallire chiuso se preferisci bloccare piuttosto che eseguire senza misurazione221* **[Applicazione del limite di spesa](/docs/it/claude-apps-gateway-spend-limits#postgres-availability)**: fallisce aperto per impostazione predefinita durante l'interruzione, quindi l'inferenza continua a fluire; capovolgilo per fallire chiuso se preferisci bloccare piuttosto che eseguire senza misurazione

220* **Readiness**: `/readyz` segnala non-ready durante l'interruzione, quindi gli orchestrator che controllano il traffico sulla readiness rimuovono ogni replica dalla rotazione contemporaneamente. In quella topologia tutto il traffico, inclusa l'inferenza che il gateway potrebbe comunque servire, fallisce al load balancer fino al recupero di Postgres. La sonda di liveness su `/healthz` continua a passare, quindi le repliche non vengono riavviate. Punta la sonda di readiness a `/healthz` invece se preferisci che gli sviluppatori che hanno effettuato l'accesso continuino a lavorare attraverso un'interruzione dello store; il costo è che i nuovi accessi falliscono contro una replica che ancora segnala ready.222* **Readiness**: per impostazione predefinita `/readyz` segnala non-ready non appena Postgres è irraggiungibile, quindi ogni replica fallisce il suo controllo di readiness contemporaneamente. Dove il traffico raggiunge solo le repliche che superano il controllo, tutto il traffico, inclusa l'inferenza che il gateway potrebbe comunque servire, fallisce fino al recupero di Postgres. La sonda di liveness su `/healthz` continua a passare durante tutto il tempo.

223

224Se il tuo IdP si arresta, le sessioni esistenti funzionano fino a `ttl_hours` e i nuovi accessi falliscono. Un aggiornamento della sessione riceve una risposta di riprovare e ha successo una volta che l'IdP è di nuovo disponibile. Imposta un `ttl_hours` più lungo se il tuo IdP ha frequenti finestre di manutenzione.

225

226<h4 id="readiness-grace-period">

227 Periodo di grazia della readiness

228</h4>

229

230Per mantenere gli sviluppatori che hanno effettuato l'accesso al lavoro attraverso una breve interruzione di Postgres come un failover del database, imposta [`store.readiness_grace_seconds`](/docs/it/claude-apps-gateway-config#store) a più lungo di quanto impiega il failover, ad esempio `300`. Con i limiti di spesa attivi e il comportamento predefinito fail-open, le richieste attraverso una replica che rimane ready non sono misurate fino al recupero di Postgres, quindi mantieni il valore il più basso possibile che copra il tuo failover. Se imposti [`enforcement.fail_closed_on_error: true`](/docs/it/claude-apps-gateway-config#enforcement), il gateway rifiuta l'inferenza degli sviluppatori che hanno effettuato l'accesso con il messaggio `429` `spend limit unavailable` fino al recupero di Postgres, anche mentre le repliche continuano a superare il loro controllo di readiness.

231

232L'impostazione richiede Claude Code v2.1.282 o successivo sul server del gateway. Un gateway precedente rifiuta di avviarsi quando trova la chiave, quindi aggiorna ogni replica prima di aggiungerla. [Aggiornamenti](#upgrades) copre il rollback.

221 233

222Se il tuo IdP si arresta, le sessioni esistenti funzionano fino a `ttl_hours`, i nuovi accessi falliscono, e un aggiornamento della sessione riceve una risposta di riprovare e continua una volta che l'IdP è di nuovo disponibile. Imposta un `ttl_hours` più lungo se il tuo IdP ha frequenti finestre di manutenzione.234Se punti la sonda di readiness a `/healthz` invece, le repliche continuano a superarla durante un'interruzione, ma `/healthz` non segnala mai non-ready, quindi una replica il cui collegamento Postgres non si recupera continua a superare anche quella.

223 235

224<h3 id="jwt-secret-rotation">236<h3 id="jwt-secret-rotation">

225 Rotazione del segreto JWT237 Rotazione del segreto JWT

226</h3>238</h3>

227 239

228Ruota il segreto di firma in tre passaggi in modo che le sessioni esistenti rimangono valide:240Ruota il segreto di firma in fasi in modo che le sessioni esistenti rimangono valide:

229 241

2301. Genera un nuovo segreto. Anteponi l'array `session.jwt_secret`.2421. Genera un nuovo segreto. Anteponi l'array `session.jwt_secret`.

2312. Esegui il rollout della distribuzione. I nuovi token firmano con il nuovo segreto; i vecchi token si convalidano comunque.2432. Esegui il rollout della distribuzione. I nuovi token firmano con il nuovo segreto; i vecchi token si convalidano comunque.

357| Le richieste di uno sviluppatore falliscono con `Not signed in to the Cloud gateway — run /login.` | Le impostazioni gestite della macchina impostano `forceLoginMethod: "gateway"` o `forceLoginGatewayUrl`, e la sessione non ha un accesso al gateway. Un accesso a claude.ai residuo non soddisfa il requisito. | Chiedi allo sviluppatore di eseguire `/login` e completare l'accesso al gateway. Vedi anche [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |369| Le richieste di uno sviluppatore falliscono con `Not signed in to the Cloud gateway — run /login.` | Le impostazioni gestite della macchina impostano `forceLoginMethod: "gateway"` o `forceLoginGatewayUrl`, e la sessione non ha un accesso al gateway. Un accesso a claude.ai residuo non soddisfa il requisito. | Chiedi allo sviluppatore di eseguire `/login` e completare l'accesso al gateway. Vedi anche [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |

358| Claude Desktop segnala che la sua configurazione di bootstrap non poteva essere recuperata | `/user/bootstrap` ha restituito 404: il criterio che corrisponde all'utente non contiene una chiave `desktop`, oppure nessun criterio corrisponde. Il log di audit del gateway registra ogni rifiuto come `desktop_bootstrap.denied` con il motivo. | Aggiungi un blocco `desktop` al criterio che corrisponde all'utente, oppure al livello base `match: {}`; un `desktop: {}` vuoto è sufficiente. Vedi [Claude Desktop overlay](/docs/it/claude-apps-gateway-config#claude-desktop-overlay). |370| Claude Desktop segnala che la sua configurazione di bootstrap non poteva essere recuperata | `/user/bootstrap` ha restituito 404: il criterio che corrisponde all'utente non contiene una chiave `desktop`, oppure nessun criterio corrisponde. Il log di audit del gateway registra ogni rifiuto come `desktop_bootstrap.denied` con il motivo. | Aggiungi un blocco `desktop` al criterio che corrisponde all'utente, oppure al livello base `match: {}`; un `desktop: {}` vuoto è sufficiente. Vedi [Claude Desktop overlay](/docs/it/claude-apps-gateway-config#claude-desktop-overlay). |

359| L'avvio mostra `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | La build di Claude Code installata precede il supporto del gateway | Chiedi allo sviluppatore di aggiornare Claude Code a una versione che include il supporto Cloud gateway |371| L'avvio mostra `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | La build di Claude Code installata precede il supporto del gateway | Chiedi allo sviluppatore di aggiornare Claude Code a una versione che include il supporto Cloud gateway |

360| L'avvio esce con `Administrator policy requires a Cloud gateway sign-in on this machine` | L'ambiente dello sviluppatore imposta `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, le loro impostazioni configurano un [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper), oppure una chiave API da un accesso precedente a Claude Console è ancora salvata | Chiedi allo sviluppatore di cancellare ciascuno che si applica: annulla l'impostazione della variabile, rimuovi la voce `apiKeyHelper`, oppure esegui `claude auth logout` per rimuovere la chiave salvata. Quindi chiedigli di avviare `claude` e accedere con `/login`. Vedi anche [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |372| L'avvio esce con `Administrator policy requires a Cloud gateway sign-in on this machine` | L'ambiente dello sviluppatore imposta `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, le loro impostazioni configurano un [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper), oppure una chiave API da un accesso precedente a Claude Console è ancora salvata | Chiedi allo sviluppatore di cancellare ciascuno che si applica: annulla l'impostazione della variabile, rimuovi la voce `apiKeyHelper`, oppure esegui `claude auth logout` per rimuovere la chiave salvata. Una sessione che seleziona un provider cloud con `CLAUDE_CODE_USE_*` quindi inizia senza accesso; per ogni altra sessione, chiedigli di avviare `claude` e accedere con `/login`. Vedi anche [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |

361| L'avvio o `/login` segnala `Claude Code may not be enabled for your organization` dopo un 403 al caricamento delle impostazioni gestite | Il gateway, o qualcosa davanti ad esso, ha risposto alla richiesta `/managed/settings` con 403. La rotta delle impostazioni del gateway stesso non risponde mai con 403. Lo stato proviene dai controlli IP [`access_control`](/docs/it/claude-apps-gateway-config#http-tuning) o da un proxy o WAF davanti al gateway. Il log di audit registra un rifiuto del controllo IP come `access.denied` con il motivo. Lo sviluppatore rimane connesso. | Controlla il log di audit per `access.denied` al momento dell'errore e correggi gli elenchi `access_control` o il front end, quindi chiedi allo sviluppatore di avviare `claude` di nuovo |373| L'avvio o `/login` segnala `Claude Code may not be enabled for your organization` dopo un 403 al caricamento delle impostazioni gestite | Il gateway, o qualcosa davanti ad esso, ha risposto alla richiesta `/managed/settings` con 403. La rotta delle impostazioni del gateway stesso non risponde mai con 403. Lo stato proviene dai controlli IP [`access_control`](/docs/it/claude-apps-gateway-config#http-tuning) o da un proxy o WAF davanti al gateway. Il log di audit registra un rifiuto del controllo IP come `access.denied` con il motivo. Lo sviluppatore rimane connesso. | Controlla il log di audit per `access.denied` al momento dell'errore e correggi gli elenchi `access_control` o il front end, quindi chiedi allo sviluppatore di avviare `claude` di nuovo |

362| CLI `/login`: `The gateway is limiting sign-in attempts right now`, oppure `Request failed with status code 429` nelle versioni precedenti. La pagina `/device` potrebbe mostrare `Too many attempts` agli sviluppatori che non hanno mai provato prima | È stato raggiunto il limite di velocità di accesso per IP. O `listen.trusted_proxies` non copre il bilanciatore di carico, quindi ogni sviluppatore condivide il suo indirizzo, oppure molti sviluppatori condividono un indirizzo di uscita NAT o VPN. Gli eventi di audit con `result: rate_limited` mostrano lo stesso uno o pochi valori `client_ip`. | Imposta prima `listen.trusted_proxies` agli intervalli di origine del bilanciatore di carico, quindi aumenta `rate_limits` se gli sviluppatori condividono ancora indirizzi. Vedi [Large rollouts](#large-rollouts). |374| CLI `/login`: `The gateway is limiting sign-in attempts right now`, oppure `Request failed with status code 429` nelle versioni precedenti. La pagina `/device` potrebbe mostrare `Too many attempts` agli sviluppatori che non hanno mai provato prima | È stato raggiunto il limite di velocità di accesso per IP. O `listen.trusted_proxies` non copre il bilanciatore di carico, quindi ogni sviluppatore condivide il suo indirizzo, oppure molti sviluppatori condividono un indirizzo di uscita NAT o VPN. Gli eventi di audit con `result: rate_limited` mostrano lo stesso uno o pochi valori `client_ip`. | Imposta prima `listen.trusted_proxies` agli intervalli di origine del bilanciatore di carico, quindi aumenta `rate_limits` se gli sviluppatori condividono ancora indirizzi. Vedi [Large rollouts](#large-rollouts). |

363| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Il nome host del gateway si risolve in almeno un indirizzo IP pubblico. Claude Code controlla ogni indirizzo risolto e richiede che tutti siano privati. Una causa comune è un nome dual-stack in cui una famiglia si risolve in un indirizzo pubblico, inclusi i bilanciatori di carico dual-stack interni di AWS, che restituiscono indirizzi AAAA in intervallo pubblico. | Fai in modo che il nome del gateway si risolva solo in indirizzi privati sulle macchine degli sviluppatori. Per un nome dual-stack, elimina il record in intervallo pubblico o servi un nome DNS solo interno separato. Vedi il [prerequisito di rete privata](/docs/it/claude-apps-gateway#prerequisites). Se l'indirizzo è spazio pubblico che la tua organizzazione possiede e utilizza internamente, [dichiara quel blocco](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) invece. |375| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Il nome host del gateway si risolve in almeno un indirizzo IP pubblico. Claude Code controlla ogni indirizzo risolto e richiede che tutti siano privati. Una causa comune è un nome dual-stack in cui una famiglia si risolve in un indirizzo pubblico, inclusi i bilanciatori di carico dual-stack interni di AWS, che restituiscono indirizzi AAAA in intervallo pubblico. | Fai in modo che il nome del gateway si risolva solo in indirizzi privati sulle macchine degli sviluppatori. Per un nome dual-stack, elimina il record in intervallo pubblico o servi un nome DNS solo interno separato. Vedi il [prerequisito di rete privata](/docs/it/claude-apps-gateway#prerequisites). Se l'indirizzo è spazio pubblico che la tua organizzazione possiede e utilizza internamente, [dichiara quel blocco](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) invece. |

claude-apps-gateway-on-aws.md +3 −1

Details

255 255

256 store:256 store:

257 postgres_url: ${GATEWAY_POSTGRES_URL} # EKS: ${file:/secrets/postgres-url}257 postgres_url: ${GATEWAY_POSTGRES_URL} # EKS: ${file:/secrets/postgres-url}

258 # readiness_grace_seconds: 300 # mantieni il passaggio del controllo di stato

259 # attraverso un failover RDS

258 260

259 upstreams:261 upstreams:

260 - provider: bedrock262 - provider: bedrock

423 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"425 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"

424 ```426 ```

425 427

426 Il periodo di grazia di 60 secondi dà a un'attività fredda il tempo di estrarre l'immagine, connettersi allo store e rispondere al suo primo controllo di stato prima che ECS inizi a contare i fallimenti rispetto alla distribuzione. Il controllo di stato del gruppo di destinazione su `GET /readyz` verifica che lo store sia raggiungibile, quindi un'attività che non può raggiungere Postgres non entra mai in rotazione; consultate [Comportamento di interruzione](/docs/it/claude-apps-gateway-deploy#outage-behavior) per il compromesso e l'alternativa `/healthz`.428 Il periodo di grazia di 60 secondi dà a un'attività fredda il tempo di estrarre l'immagine, connettersi allo store e rispondere al suo primo controllo di stato prima che ECS inizi a contare i fallimenti rispetto alla distribuzione. Il controllo di stato del gruppo di destinazione su `GET /readyz` verifica che lo store sia raggiungibile, quindi un'attività che non può raggiungere Postgres non entra mai in rotazione. Per mantenere le attività che passano il controllo attraverso una breve interruzione del database come un failover RDS, impostate `store.readiness_grace_seconds` come descritto in [Comportamento di interruzione](/docs/it/claude-apps-gateway-deploy#outage-behavior), che copre anche l'alternativa `/healthz`.

427 429

428 Le attività vengono eseguite in subnet private senza IP pubblico, quindi tutto l'egresso (verso Bedrock, il vostro IdP, Secrets Manager, ECR e CloudWatch Logs) passa attraverso il gateway NAT. Per mantenere il traffico Bedrock fuori dal percorso pubblico, create un endpoint VPC dell'interfaccia `bedrock-runtime` e puntate l'`base_url` dell'upstream ad esso, come mostrato nel [riferimento upstream Bedrock](/docs/it/claude-apps-gateway-config#amazon-bedrock); l'IdP ha ancora bisogno di uscita a Internet.430 Le attività vengono eseguite in subnet private senza IP pubblico, quindi tutto l'egresso (verso Bedrock, il vostro IdP, Secrets Manager, ECR e CloudWatch Logs) passa attraverso il gateway NAT. Per mantenere il traffico Bedrock fuori dal percorso pubblico, create un endpoint VPC dell'interfaccia `bedrock-runtime` e puntate l'`base_url` dell'upstream ad esso, come mostrato nel [riferimento upstream Bedrock](/docs/it/claude-apps-gateway-config#amazon-bedrock); l'IdP ha ancora bisogno di uscita a Internet.

429 431

claude-apps-gateway-spend-limits.md +2 −0

Details

86 86

87La pre-verifica interroga Postgres con un timeout di due secondi. Se l'archivio è irraggiungibile o scade, l'applicazione fallisce aperta per impostazione predefinita: la richiesta procede, il gateway registra un avviso e la risposta non contiene header `anthropic-ratelimit-unified-*`. Imposta [`enforcement.fail_closed_on_error: true`](/docs/it/claude-apps-gateway-config#enforcement) per fallire chiuso invece, che restituisce lo stesso `429 billing_error` ma con il messaggio `spend limit unavailable` e nessun periodo, ora di reset o header `retry-after`. Fail-open impedisce a un'interruzione dell'archivio di diventare un'interruzione dell'inferenza; fail-closed garantisce nessuna spesa non misurata.87La pre-verifica interroga Postgres con un timeout di due secondi. Se l'archivio è irraggiungibile o scade, l'applicazione fallisce aperta per impostazione predefinita: la richiesta procede, il gateway registra un avviso e la risposta non contiene header `anthropic-ratelimit-unified-*`. Imposta [`enforcement.fail_closed_on_error: true`](/docs/it/claude-apps-gateway-config#enforcement) per fallire chiuso invece, che restituisce lo stesso `429 billing_error` ma con il messaggio `spend limit unavailable` e nessun periodo, ora di reset o header `retry-after`. Fail-open impedisce a un'interruzione dell'archivio di diventare un'interruzione dell'inferenza; fail-closed garantisce nessuna spesa non misurata.

88 88

89Fail-open aiuta solo mentre il tuo load balancer o orchestrator instrada ancora il traffico al gateway. Vedi [Outage behavior](/docs/it/claude-apps-gateway-deploy#outage-behavior) per `store.readiness_grace_seconds`, che mantiene le repliche che superano il loro controllo di disponibilità durante una breve interruzione.

89<h3 id="usage-warnings-in-claude-code">91<h3 id="usage-warnings-in-claude-code">

90 Avvisi di utilizzo in Claude Code92 Avvisi di utilizzo in Claude Code

91</h3>93</h3>

claude-code-on-the-web.md +4 −1

Details

61 61

62I thread in un [progetto](/docs/it/claude-projects) hanno bisogno che l'app sia installata su ogni repository che clonano, indipendentemente dal metodo con cui ti sei connesso. Vedi [Configura l'accesso a GitHub](/docs/it/claude-projects#set-up-github-access).62I thread in un [progetto](/docs/it/claude-projects) hanno bisogno che l'app sia installata su ogni repository che clonano, indipendentemente dal metodo con cui ti sei connesso. Vedi [Configura l'accesso a GitHub](/docs/it/claude-projects#set-up-github-access).

63 63

64In ambienti ospitati da Anthropic, le tue credenziali GitHub rimangono crittografate sui server di Anthropic e non entrano mai nella VM di una sessione. Le operazioni GitHub dalla VM passano attraverso il [proxy GitHub](/docs/it/cloud-environments#github-proxy), che allega la credenziale sul lato server.

64Per come `/schedule` verifica l'accesso al repository prima di creare una routine, vedi [Repository e autorizzazioni di ramo](/docs/it/routines#repositories-and-branch-permissions). Vedi [Connetti dal tuo terminale](/docs/it/web-quickstart#connect-from-your-terminal) per la procedura dettagliata di `/web-setup`, incluso ciò che `/web-setup` memorizza e come rimuoverlo.66Per come `/schedule` verifica l'accesso al repository prima di creare una routine, vedi [Repository e autorizzazioni di ramo](/docs/it/routines#repositories-and-branch-permissions). Vedi [Connetti dal tuo terminale](/docs/it/web-quickstart#connect-from-your-terminal) per la procedura dettagliata di `/web-setup`, incluso ciò che `/web-setup` memorizza e come rimuoverlo.

65 67

66La configurazione rapida del web è un'impostazione dell'organizzazione che consente ai membri di connettere GitHub con `/web-setup`, salta il prompt di installazione dell'app Claude GitHub durante l'onboarding del browser e fa sì che l'onboarding del browser crei l'[ambiente **Default**](/docs/it/cloud-environments#the-default-environment) per loro invece di mostrare il modulo dell'ambiente. Nei piani Team ed Enterprise è disabilitato per impostazione predefinita, il che nasconde `/web-setup`. Un [Proprietario](/docs/it/server-managed-settings#access-control) lo attiva con l'interruttore **Quick web setup** su [**Impostazioni di amministrazione > Claude Code**](https://claude.ai/admin-settings/claude-code).68La configurazione rapida del web è un'impostazione dell'organizzazione che consente ai membri di connettere GitHub con `/web-setup`, salta il prompt di installazione dell'app Claude GitHub durante l'onboarding del browser e fa sì che l'onboarding del browser crei l'[ambiente **Default**](/docs/it/cloud-environments#the-default-environment) per loro invece di mostrare il modulo dell'ambiente. Nei piani Team ed Enterprise è disabilitato per impostazione predefinita, il che nasconde `/web-setup`. Un [Proprietario](/docs/it/server-managed-settings#access-control) lo attiva con l'interruttore **Quick web setup** su [**Impostazioni di amministrazione > Claude Code**](https://claude.ai/admin-settings/claude-code).

135 137

136Quando esegui `claude --cloud` da un repository che non ha un remoto git, o da un repository github.com su cui l'app GitHub di Claude non è installata, Claude Code raggruppa il tuo repository locale e lo carica direttamente nella sessione cloud. Questo si applica anche se hai connesso GitHub con `/web-setup`. Il bundle include la tua cronologia completa del repository su tutti i rami, più eventuali modifiche non sottoposte a commit ai file tracciati.138Quando esegui `claude --cloud` da un repository che non ha un remoto git, o da un repository github.com su cui l'app GitHub di Claude non è installata, Claude Code raggruppa il tuo repository locale e lo carica direttamente nella sessione cloud. Questo si applica anche se hai connesso GitHub con `/web-setup`. Il bundle include la tua cronologia completa del repository su tutti i rami, più eventuali modifiche non sottoposte a commit ai file tracciati.

137 139

138Su macOS, Linux e WSL, Claude Code lascia fuori dall'upload le modifiche non sottoposte a commit ai file denominati come credenziali o chiavi e nomina i file che ha lasciato fuori. Questo copre i file `.env`, i file Terraform `*.tfvars` e i file di chiave come `id_rsa` e `*.pem`. La sessione inizia con la versione sottoposta a commit di ognuno, o senza il file se nessuno è sottoposto a commit. In un worktree collegato, submodulo o layout simile, Claude Code carica queste modifiche con il resto e nomina i file che carica.140Su macOS, Linux e WSL, Claude Code lascia fuori dall'upload le modifiche non sottoposte a commit ai file denominati come credenziali o chiavi e nomina i file che ha lasciato fuori. Questo copre i file `.env`, i file Terraform `*.tfvars` e i file di chiave come `id_rsa` e `*.pem`. La sessione inizia con la versione sottoposta a commit di ognuno, o senza il file se nessuno è sottoposto a commit.

139 141

140Per caricare un bundle anche quando Claude Code altrimenti clonerebbe dal remoto, imposta `CCR_FORCE_BUNDLE=1`:142Per caricare un bundle anche quando Claude Code altrimenti clonerebbe dal remoto, imposta `CCR_FORCE_BUNDLE=1`:

141 143

429Prima di fare affidamento sulle sessioni cloud per un flusso di lavoro, tieni conto di questi vincoli:431Prima di fare affidamento sulle sessioni cloud per un flusso di lavoro, tieni conto di questi vincoli:

430 432

431* **Limiti di velocità**: le sessioni cloud condividono i limiti di velocità con tutti gli altri utilizzi di Claude e Claude Code all'interno del tuo account. L'esecuzione di più attività in parallelo consuma più limiti di velocità proporzionalmente. Non esiste alcun addebito di calcolo separato per la VM cloud.433* **Limiti di velocità**: le sessioni cloud condividono i limiti di velocità con tutti gli altri utilizzi di Claude e Claude Code all'interno del tuo account. L'esecuzione di più attività in parallelo consuma più limiti di velocità proporzionalmente. Non esiste alcun addebito di calcolo separato per la VM cloud.

434* **Limiti di tempo**: i comandi che Claude esegue e gli hook SessionStart hanno timeout predefiniti che puoi modificare, e uno script di configurazione viene memorizzato nella cache solo quando termina in circa cinque minuti. Vedi [Limiti di tempo](/docs/it/cloud-environments#time-limits)

432* **Autenticazione del repository**: puoi estrarre una sessione cloud nel tuo terminale solo quando sei autenticato allo stesso account435* **Autenticazione del repository**: puoi estrarre una sessione cloud nel tuo terminale solo quando sei autenticato allo stesso account

433* **Restrizioni della piattaforma**: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di [GitHub Enterprise Server](/docs/it/github-enterprise-server) sono supportate per i piani Team ed Enterprise. Puoi inviare un repository GitLab, Bitbucket o altro non-GitHub a una sessione cloud come [bundle locale](#send-local-repositories-without-github) impostando `CCR_FORCE_BUNDLE=1`, ma la sessione non può eseguire il push dei risultati di nuovo a quel remoto436* **Restrizioni della piattaforma**: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di [GitHub Enterprise Server](/docs/it/github-enterprise-server) sono supportate per i piani Team ed Enterprise. Puoi inviare un repository GitLab, Bitbucket o altro non-GitHub a una sessione cloud come [bundle locale](#send-local-repositories-without-github) impostando `CCR_FORCE_BUNDLE=1`, ma la sessione non può eseguire il push dei risultati di nuovo a quel remoto

434* **Elenco IP consentiti dell'organizzazione**: le sessioni cloud chiamano l'API Anthropic dall'infrastruttura gestita da Anthropic, non dalla tua rete, mentre le sessioni in un [ambiente self-hosted](/docs/it/self-hosted-environments) la chiamano dalla tua rete. Se la tua organizzazione ha [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) abilitato, ogni sessione cloud ospitata da Anthropic fallisce con un errore di autenticazione. Lo stesso vale per [Code Review](/docs/it/code-review) e per [routine](/docs/it/routines) che vengono eseguite su ambienti ospitati da Anthropic; una routine instradata a un ambiente self-hosted chiama l'API dalla tua rete. Contatta il [supporto Anthropic](https://support.claude.com/) per esentare i servizi ospitati da Anthropic dall'elenco IP consentiti della tua organizzazione.437* **Elenco IP consentiti dell'organizzazione**: le sessioni cloud chiamano l'API Anthropic dall'infrastruttura gestita da Anthropic, non dalla tua rete, mentre le sessioni in un [ambiente self-hosted](/docs/it/self-hosted-environments) la chiamano dalla tua rete. Se la tua organizzazione ha [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) abilitato, ogni sessione cloud ospitata da Anthropic fallisce con un errore di autenticazione. Lo stesso vale per [Code Review](/docs/it/code-review) e per [routine](/docs/it/routines) che vengono eseguite su ambienti ospitati da Anthropic; una routine instradata a un ambiente self-hosted chiama l'API dalla tua rete. Contatta il [supporto Anthropic](https://support.claude.com/) per esentare i servizi ospitati da Anthropic dall'elenco IP consentiti della tua organizzazione.

claude-directory.md +24 −2

Details

1554| `projects/<project>/<session>.jsonl` | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |1554| `projects/<project>/<session>.jsonl` | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |

1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Una trascrizione precedente per la sessione che Claude Code ha messo da parte invece di sovrascriverla o eliminarla. Non appare nel selettore di sessione |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Una trascrizione precedente per la sessione che Claude Code ha messo da parte invece di sovrascriverla o eliminarla. Non appare nel selettore di sessione |

1556| `projects/<project>/<session>/subagents/` | Trascrizioni di conversazione [Subagent](/docs/it/sub-agents), rimosse con la trascrizione della sessione padre quando scade |1556| `projects/<project>/<session>/subagents/` | Trascrizioni di conversazione [Subagent](/docs/it/sub-agents), rimosse con la trascrizione della sessione padre quando scade |

1557| `projects/<project>/<session>/tool-results/` | Output di strumenti di grandi dimensioni versati in file separati |1557| `projects/<project>/<session>/tool-results/` | Output di strumenti di grandi dimensioni versati in file separati, e copie a dimensione intera di [immagini che gli strumenti MCP restituiscono](/docs/it/mcp#images-in-tool-results) |

1558| `file-history/<session>/` | Snapshot pre-modifica dei file che Claude ha modificato, utilizzati per il [ripristino del checkpoint](/docs/it/checkpointing). Contiene snapshot per i 100 checkpoint più recenti; i file snapshot a cui nessun checkpoint conservato fa riferimento vengono eliminati, tranne il primo snapshot di ogni file |1558| `file-history/<session>/` | Snapshot pre-modifica dei file che Claude ha modificato, utilizzati per il [ripristino del checkpoint](/docs/it/checkpointing). Contiene snapshot per i 100 checkpoint più recenti; i file snapshot a cui nessun checkpoint conservato fa riferimento vengono eliminati, tranne il primo snapshot di ogni file |

1559| `plans/` | File di piano scritti durante la [Plan Mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) |1559| `plans/` | File di piano scritti durante la [Plan Mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) |

1560| `debug/` | Log di debug per sessione, scritti mentre il debug logging è attivo, ad esempio quando inizi con [`--debug`](/docs/it/cli-reference#cli-flags) o esegui `/debug` |1560| `debug/` | Log di debug per sessione, scritti mentre il debug logging è attivo, ad esempio quando inizi con [`--debug`](/docs/it/cli-reference#cli-flags) o esegui `/debug` |

1582* **Modalità bare**: quando esegui `claude -p` con [`--bare`](/docs/it/headless#start-faster-with-bare-mode), Claude Code non esegue la pulizia in quella sessione.1582* **Modalità bare**: quando esegui `claude -p` con [`--bare`](/docs/it/headless#start-faster-with-bare-mode), Claude Code non esegue la pulizia in quella sessione.

1583* **Pulizia in pausa**: se Claude Code non può determinare in modo sicuro il periodo di conservazione, mette in pausa la pulizia della conservazione; l'[evento `retention_sweep`](/docs/it/monitoring-usage#retention-sweep-event) elenca ogni configurazione che la mette in pausa. Quando la causa è un file di impostazioni che non può essere letto o analizzato, o errori di impostazioni con `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` impostati esplicitamente, Claude Code mostra anche un avviso in `/status` finché non correggi gli errori di impostazioni. Quando le [impostazioni gestite](/docs/it/server-managed-settings) forniscono `cleanupPeriodDays`, Claude Code esegue la pulizia al valore gestito in entrambi i casi.1583* **Pulizia in pausa**: se Claude Code non può determinare in modo sicuro il periodo di conservazione, mette in pausa la pulizia della conservazione; l'[evento `retention_sweep`](/docs/it/monitoring-usage#retention-sweep-event) elenca ogni configurazione che la mette in pausa. Quando la causa è un file di impostazioni che non può essere letto o analizzato, o errori di impostazioni con `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` impostati esplicitamente, Claude Code mostra anche un avviso in `/status` finché non correggi gli errori di impostazioni. Quando le [impostazioni gestite](/docs/it/server-managed-settings) forniscono `cleanupPeriodDays`, Claude Code esegue la pulizia al valore gestito in entrambi i casi.

1584 1584

1585<h3 id="session-scratchpad-directory">

1586 Directory scratchpad della sessione

1587</h3>

1588

1589Lo scratchpad è una directory per sessione che Claude Code fornisce a Claude per file temporanei: risultati intermedi, script helper e bozze che non appartengono al tuo progetto. Quando Claude dice che ha salvato qualcosa "nello scratchpad", il file è lì. Claude lo usa invece di `/tmp`, e può creare, modificare e leggere file in esso senza un prompt di permesso.

1590

1591Lo scratchpad si trova nella directory temporanea di Claude Code piuttosto che in `~/.claude`. Trova il percorso della sessione corrente per la tua piattaforma:

1592

1593* **macOS**: `/private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`

1594* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, o la stessa forma sotto `$TMPDIR` quando il tuo sistema ne imposta uno

1595* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`

1596

1597`<project>` è il percorso della tua directory di lavoro con ogni carattere diverso da lettere e cifre sostituito da `-`, ad esempio `-Users-you-my-project`. Se imposti [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars), l'albero si sposta sotto quella directory. Gli hooks ricevono il percorso della sessione corrente come [`scratchpad_dir`](/docs/it/hooks#common-input-fields).

1598

1599I file scratchpad durano quanto la trascrizione della sessione: la [pulizia della conservazione](#cleaned-up-automatically) elimina la directory quando elimina la trascrizione, e [`claude project purge`](#clear-local-data) non tocca la directory temporanea. Poiché la directory si trova nella posizione temporanea del sistema, il tuo sistema operativo può anche cancellarla, ad esempio al riavvio. Per mantenere qualcosa che Claude ha scritto lì, chiedi a Claude di spostarlo nel tuo progetto.

1600

1601Una sessione ha uno scratchpad solo quando tutti questi elementi sono veri:

1602

1603* Sei connesso con un account claude.ai piuttosto che con una chiave API

1604* La sessione utilizza l'API Anthropic, non Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry

1605* [`enableArtifact`](/docs/it/settings-reference#enableartifact) non è impostato su `false`

1606

1585<h3 id="kept-until-you-delete-them">1607<h3 id="kept-until-you-delete-them">

1586 Mantenuti fino a quando non li elimini1608 Mantenuti fino a quando non li elimini

1587</h3>1609</h3>

1626* Righe di prompt corrispondenti in `history.jsonl`1648* Righe di prompt corrispondenti in `history.jsonl`

1627* La voce del progetto in `~/.claude.json`1649* La voce del progetto in `~/.claude.json`

1628 1650

1629Le immagini che hai incollato o allegato nelle sessioni del progetto sono archiviate nella directory temporanea di Claude Code piuttosto che in `~/.claude`, quindi la pulizia non le rimuove. La [pulizia della conservazione](#cleaned-up-automatically) le elimina una volta che sono più vecchie di `cleanupPeriodDays`.1651Le immagini che hai incollato o allegato nelle sessioni del progetto e la [scratchpad](#session-scratchpad-directory) di ogni sessione sono archiviate nella directory temporanea di Claude Code piuttosto che in `~/.claude`, quindi la pulizia non le rimuove. La [pulizia della conservazione](#cleaned-up-automatically) elimina ancora le immagini una volta che sono più vecchie di `cleanupPeriodDays`; lo scratchpad di una sessione eliminata rimane fino a quando non lo elimini o il tuo sistema operativo non cancella la directory temporanea.

1630 1652

1631Il comando stampa il piano di eliminazione completo e chiede conferma prima di rimuovere qualsiasi cosa.1653Il comando stampa il piano di eliminazione completo e chiede conferma prima di rimuovere qualsiasi cosa.

1632 1654

claude-projects.md +46 −4

Details

12 12

13Un progetto è una conversazione in corso dove Claude coordina un flusso di lavoro correlato per voi. Gli dite cosa deve essere fatto e lui avvia un thread per ogni attività.13Un progetto è una conversazione in corso dove Claude coordina un flusso di lavoro correlato per voi. Gli dite cosa deve essere fatto e lui avvia un thread per ogni attività.

14 14

15Ogni thread è solitamente una [sessione cloud](/docs/it/claude-code-on-the-web): Claude Code in esecuzione nel cloud piuttosto che sulla vostra macchina. Quando un'attività ha bisogno di qualcosa che solo il vostro computer ha, potete chiedere a Claude di eseguire quel thread sul vostro computer invece attraverso [Remote Control](/docs/it/remote-control). I thread vengono eseguiti in parallelo e potete controllarli e guidarli dal vostro telefono. I thread cloud continuano dopo che chiudete il laptop.15Ogni thread è solitamente una [sessione cloud](/docs/it/claude-code-on-the-web): Claude Code in esecuzione nel cloud piuttosto che sulla vostra macchina. Quando un'attività ha bisogno di qualcosa che solo il vostro computer ha, potete chiedere a Claude di [eseguire quel thread sul vostro computer](#run-a-thread-on-your-own-computer) invece che nel cloud, attraverso [Remote Control](/docs/it/remote-control). I thread vengono eseguiti in parallelo e potete controllarli e guidarli dal vostro telefono. I thread cloud continuano dopo che chiudete il laptop, mentre un thread sul vostro computer viene eseguito solo mentre quel computer è acceso.

16 16

17Senza un progetto, eseguire più sessioni significa fare il coordinamento da solo: decidi su cosa lavora ciascuno, ripeti lo stesso contesto all'inizio di ciascuno, e controlli indietro per vedere quale è terminato o ha bisogno di una risposta. Con un progetto, invece:17Senza un progetto, eseguire più sessioni significa fare il coordinamento da solo: decidi su cosa lavora ciascuno, ripeti lo stesso contesto all'inizio di ciascuno, e controlli indietro per vedere quale è terminato o ha bisogno di una risposta. Con un progetto, invece:

18 18

39 Quando qualcos'altro si adatta meglio39 Quando qualcos'altro si adatta meglio

40</h3>40</h3>

41 41

42I thread cloud funzionano su repository GitHub e sui file, cartelle e cartelle Google Drive che carichi nel progetto, non su file o strumenti che esistono solo sulla tua macchina. Se un'attività ha bisogno della tua macchina, chiedi a Claude di eseguire il suo thread lì attraverso [Remote Control](/docs/it/remote-control). [Limitations](#limitations) elenca di cosa ha bisogno. Qualcos'altro si adatta meglio in questi casi:42Un progetto si adatta ancora quando solo alcune attività hanno bisogno della tua macchina. I thread cloud funzionano su repository GitHub e sui file, cartelle e cartelle Google Drive che carichi nel progetto, e per l'occasionale attività che ha bisogno di un database locale o di uno strumento sul tuo computer, puoi chiedere a Claude di [eseguire il thread di quell'attività sul tuo computer](#run-a-thread-on-your-own-computer). Qualcos'altro si adatta meglio in questi casi:

43 43

44* **Un'attività che rientra in una sessione**: "Correggi il test di login instabile." Avvia una [cloud session](/docs/it/claude-code-on-the-web) tu stesso.44* **Un'attività che rientra in una sessione**: "Correggi il test di login instabile." Avvia una [cloud session](/docs/it/claude-code-on-the-web) tu stesso.

45* **Lavoro dove ogni attività ha bisogno della tua macchina**: un database locale, un emulatore di dispositivo, o un'API dietro il tuo VPN. Usa una sessione locale, o [agent view](/docs/it/agent-view) per eseguirne diversi contemporaneamente. Se il lavoro ha bisogno solo di file locali, caricali nel progetto invece.45* **Lavoro dove ogni attività ha bisogno della tua macchina**: un database locale, un emulatore di dispositivo, o un'API dietro il tuo VPN. Usa una sessione locale, o [agent view](/docs/it/agent-view) per eseguirne diversi contemporaneamente. Se il lavoro ha bisogno solo di file locali, caricali nel progetto invece.

277 277

278Ogni approvazione copre quel prompt, o il resto di quel thread se scegli l'opzione più ampia. Per lasciare che ogni thread esegua determinati comandi senza chiedere, o per bloccarne alcuni, aggiungi [regole di permesso](/docs/it/permissions) al `.claude/settings.json` del repository. I thread le applicano solo in un project con un repository; vedi [Cosa i thread raccolgono dai tuoi repository](#what-threads-pick-up-from-your-repositories).278Ogni approvazione copre quel prompt, o il resto di quel thread se scegli l'opzione più ampia. Per lasciare che ogni thread esegua determinati comandi senza chiedere, o per bloccarne alcuni, aggiungi [regole di permesso](/docs/it/permissions) al `.claude/settings.json` del repository. I thread le applicano solo in un project con un repository; vedi [Cosa i thread raccolgono dai tuoi repository](#what-threads-pick-up-from-your-repositories).

279 279

280<h3 id="run-a-thread-on-your-own-computer">

281 Esegui un thread sul tuo computer

282</h3>

283

284Quando un compito ha bisogno di qualcosa che solo il tuo computer ha, come un database locale, un emulatore di dispositivo, o un'API dietro il tuo VPN, chiedi a Claude di eseguire il thread per quel compito sul tuo computer invece che nel cloud. Quando chiedi nella conversazione del project, il thread è una sessione Claude Code in una cartella sulla tua macchina, connessa attraverso [Remote Control](/docs/it/remote-control). Gli altri thread del project continuano a funzionare nel cloud. Rispetto a un thread cloud, un thread sul tuo computer:

285

286* Funziona con i file, gli strumenti, i server MCP e le impostazioni Claude Code su quella macchina invece dell'ambiente cloud del project

287* Inizia con le istruzioni del project, ma non con i suoi file di memoria caricati

288* Funziona solo mentre quel computer è sveglio con Remote Control attivato

289

290<Steps>

291 <Step title="Connetti la cartella">

292 Sul computer che ha la cartella di cui il compito ha bisogno, rendila disponibile attraverso Remote Control in uno di due modi. Entrambi hanno bisogno di Claude Code v2.1.280 o successivo su quel computer.

293

294 * **Nell'app desktop Claude**: apri **Settings > Claude Code**, attiva **Use this computer from your phone and claude.ai**, e aggiungi la cartella all'elenco sotto quel switch. I thread possono funzionare su questo computer mentre l'app è aperta.

295 * **In un terminale**: esegui `claude remote-control` nella cartella e lascialo funzionare.

296 </Step>

297

298 <Step title="Chiedi il compito con Work locally">

299 Nella conversazione del project, scegli **Work locally** dal menu **+** accanto alla casella di messaggio, che etichetta il tuo messaggio **Local**, e scrivi cosa vuoi che sia fatto. Dire nel messaggio che il compito dovrebbe funzionare sul tuo computer funziona anche.

300 </Step>

301

302 <Step title="Consentigli sulla carta">

303 Claude risponde con una carta **Allow Claude to work in a folder on your device**. Scegli la cartella se ne hai connesse più di una. Poi fai clic su **Allow once**.

304 </Step>

305</Steps>

306

307Il thread funziona in [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), quindi Claude esegue comandi e modifica file in quella cartella senza chiederti ogni volta. Se auto mode non è disponibile o è disattivato in Claude Code su quel computer, il thread funziona senza di esso, e qualsiasi prompt di permesso che solleva aspetta la tua risposta nel thread, come [Sblocca un thread in attesa di approvazione](#unblock-a-thread-waiting-on-approval) descrive.

308

309Mentre il thread funziona, un'icona di laptop nel suo intestazione mostra se il tuo computer è connesso. Fai clic su di essa per vedere quale cartella il thread sta usando o per disattivare la connessione. Il thread si mette in pausa mentre quel computer è addormentato, e si ferma se l'app desktop o `claude remote-control` esce. [Lost contact with your folder](#lost-contact-with-your-folder) copre come farlo funzionare di nuovo. Nell'app desktop, attiva **Keep this computer awake for Remote Control** sotto **Settings > Claude Code** per impedire al computer di addormentarsi da solo.

310

311Un project non può eseguire un thread sul tuo computer mentre [**Require trusted devices**](/docs/it/remote-control#trusted-devices) è attivato per il tuo account.

312

280<h2 id="give-a-project-standing-context">313<h2 id="give-a-project-standing-context">

281 Fornire contesto permanente al progetto314 Fornire contesto permanente al progetto

282</h2>315</h2>

441* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) è Claude nei canali Slack del tuo team, su piani Team e Enterprise. Chiunque in un canale può dargli lavoro, tutti nel canale lo vedono e lo guidano, e usa connessioni che un admin ha configurato per quel canale. Un project è solo tuo: sei l'unico che gli invia lavoro o vede i suoi thread, usa il tuo accesso GitHub e i tuoi connectors, ed è su Pro e Max. [Come Claude Tag differisce da Cowork e Claude Code](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) ha il confronto fianco a fianco.474* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) è Claude nei canali Slack del tuo team, su piani Team e Enterprise. Chiunque in un canale può dargli lavoro, tutti nel canale lo vedono e lo guidano, e usa connessioni che un admin ha configurato per quel canale. Un project è solo tuo: sei l'unico che gli invia lavoro o vede i suoi thread, usa il tuo accesso GitHub e i tuoi connectors, ed è su Pro e Max. [Come Claude Tag differisce da Cowork e Claude Code](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) ha il confronto fianco a fianco.

442* **Sessioni cloud**: ogni thread è una [sessione cloud](/docs/it/claude-code-on-the-web) a meno che non chiedi a Claude di eseguirla sulla tua macchina. In entrambi i casi, Claude la avvia e la traccia invece di te. Una sessione cloud che hai avviato da solo può diventare un project o alimentarne uno attraverso [**Continue as a project** o **Move to project**](#start-from-an-existing-cloud-session).475* **Sessioni cloud**: ogni thread è una [sessione cloud](/docs/it/claude-code-on-the-web) a meno che non chiedi a Claude di eseguirla sulla tua macchina. In entrambi i casi, Claude la avvia e la traccia invece di te. Una sessione cloud che hai avviato da solo può diventare un project o alimentarne uno attraverso [**Continue as a project** o **Move to project**](#start-from-an-existing-cloud-session).

443* **Routine**: quando chiedi il lavoro programmato in un project, Claude crea una [routine](/docs/it/routines) che viene eseguita come thread in quel project e appare sulla sua scheda **Routines**. Le routine che crei al di fuori di un project continuano a funzionare da sole.476* **Routine**: quando chiedi il lavoro programmato in un project, Claude crea una [routine](/docs/it/routines) che viene eseguita come thread in quel project e appare sulla sua scheda **Routines**. Le routine che crei al di fuori di un project continuano a funzionare da sole.

444* **Sessioni locali e agent view**: una sessione che avvii da solo nel tuo terminale, IDE o nell'ambiente locale dell'app desktop non può essere aggiunta a un project. Un project raggiunge la tua macchina solo eseguendo un thread lì attraverso [Remote Control](/docs/it/remote-control). [Agent view](/docs/it/agent-view) è una schermata per tracciare diverse sessioni locali che hai avviato da solo; non ha un coordinatore.477* **Remote Control**: [Remote Control](/docs/it/remote-control) connette claude.ai a una sessione Claude Code in esecuzione sulla tua macchina. Quando chiedi a Claude in un project di eseguire un thread sul tuo computer, il project [usa Remote Control per farlo](#run-a-thread-on-your-own-computer).

478* **Sessioni locali e agent view**: una sessione che avvii da solo nel tuo terminale, IDE o nell'ambiente locale dell'app desktop non può essere aggiunta a un project. [Agent view](/docs/it/agent-view) è una schermata per tracciare diverse sessioni locali fianco a fianco, e tu avvii ancora ognuna e le dai il suo compito da solo.

445* **Worktrees**: un [worktree](/docs/it/worktrees) dà a ogni sessione locale la sua copia di lavoro di un repository in modo che le sessioni parallele sulla tua macchina non si sovrascrivano a vicenda. I thread cloud non ne hanno bisogno: ognuno clona i suoi repository nella sua sandbox cloud e lavora sul suo branch.479* **Worktrees**: un [worktree](/docs/it/worktrees) dà a ogni sessione locale la sua copia di lavoro di un repository in modo che le sessioni parallele sulla tua macchina non si sovrascrivano a vicenda. I thread cloud non ne hanno bisogno: ognuno clona i suoi repository nella sua sandbox cloud e lavora sul suo branch.

446* **Agent teams**: un [agent team](/docs/it/agent-teams) è una sessione che avvia sessioni di compagno per un singolo compito, sulla tua macchina o dentro una sessione cloud, e finisce con quel compito.480* **Agent teams**: un [agent team](/docs/it/agent-teams) è una sessione che avvia sessioni di compagno per un singolo compito, sulla tua macchina o dentro una sessione cloud, e finisce con quel compito.

447* **Projects in claude.ai chat e Cowork**: l'[esperienza Projects precedente](https://support.claude.com/en/articles/9517075-what-are-projects), che raggruppa conversazioni e file di riferimento senza thread o un coordinatore. Questi project continuano a funzionare come fanno oggi fino a quando l'esperienza riprogettata li raggiunge.481* **Projects in claude.ai chat e Cowork**: l'[esperienza Projects precedente](https://support.claude.com/en/articles/9517075-what-are-projects), che raggruppa conversazioni e file di riferimento senza thread o un coordinatore. Questi project continuano a funzionare come fanno oggi fino a quando l'esperienza riprogettata li raggiunge.

454 488

455* I project sono disponibili su claude.ai/code, nell'app desktop e nell'app mobile di Claude, non nel CLI del terminale o attraverso Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Il comando [`claude project`](/docs/it/cli-reference) del CLI, che gestisce lo stato locale di Claude Code per una directory, non è correlato.489* I project sono disponibili su claude.ai/code, nell'app desktop e nell'app mobile di Claude, non nel CLI del terminale o attraverso Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Il comando [`claude project`](/docs/it/cli-reference) del CLI, che gestisce lo stato locale di Claude Code per una directory, non è correlato.

456* I thread del project sono [sessioni cloud](/docs/it/claude-code-on-the-web), o sessioni sulla vostra macchina attraverso [Remote Control](/docs/it/remote-control), con Anthropic come fornitore di modello in entrambi i casi. [Sicurezza](/docs/it/security) e [Utilizzo dei dati](/docs/it/data-usage) coprono come le sessioni cloud sono isolate e cosa viene conservato, e [Connessione e sicurezza](/docs/it/remote-control#connection-and-security) copre come un thread sulla vostra macchina si connette e cosa viene archiviato.490* I thread del project sono [sessioni cloud](/docs/it/claude-code-on-the-web), o sessioni sulla vostra macchina attraverso [Remote Control](/docs/it/remote-control), con Anthropic come fornitore di modello in entrambi i casi. [Sicurezza](/docs/it/security) e [Utilizzo dei dati](/docs/it/data-usage) coprono come le sessioni cloud sono isolate e cosa viene conservato, e [Connessione e sicurezza](/docs/it/remote-control#connection-and-security) copre come un thread sulla vostra macchina si connette e cosa viene archiviato.

457* Non potete aggiungere una sessione che avete avviato voi stessi sulla vostra macchina a un project. Per consentire a un project di eseguire un thread sulla vostra macchina, collegate la cartella su cui dovrebbe lavorare attraverso [Remote Control](/docs/it/remote-control#requirements): attivate Remote Control in **Settings > Claude Code** nell'app desktop di Claude, oppure eseguite `claude remote-control` nella cartella e lasciatela in esecuzione. Quella macchina ha bisogno di Claude Code v2.1.280 o successivo. Un project inoltre non può eseguire un thread sulla vostra macchina mentre **Require trusted devices** è attivato nelle vostre impostazioni di claude.ai.491* Non potete aggiungere una sessione che avete avviato voi stessi sulla vostra macchina a un project. Un project raggiunge la vostra macchina solo [eseguendo un thread lì attraverso Remote Control](#run-a-thread-on-your-own-computer), e quella sezione elenca di cosa ha bisogno.

458* La sandbox di un thread cloud si mette in pausa tra i turni e riprende quando il thread continua. Se la sandbox non può essere ripresa, il thread continua da un clone fresco, quindi i cambiamenti non committati possono essere persi. Su compiti lunghi, chiedete a Claude di committare e spingere il lavoro in corso.492* La sandbox di un thread cloud si mette in pausa tra i turni e riprende quando il thread continua. Se la sandbox non può essere ripresa, il thread continua da un clone fresco, quindi i cambiamenti non committati possono essere persi. Su compiti lunghi, chiedete a Claude di committare e spingere il lavoro in corso.

459* Un project appartiene a un utente. Non puoi condividere un project o i suoi thread con un altro utente, e le trascrizioni dei thread non hanno l'opzione di condivisione che hanno altre sessioni cloud. Non ci sono controlli a livello di organizzazione per i project durante la beta.493* Un project appartiene a un utente. Non puoi condividere un project o i suoi thread con un altro utente, e le trascrizioni dei thread non hanno l'opzione di condivisione che hanno altre sessioni cloud. Non ci sono controlli a livello di organizzazione per i project durante la beta.

460* Un thread appartiene all'unico project che l'ha avviato. Non puoi spostare o copiare un thread in un altro project, o spostarlo fuori per stare da solo. [**Move to project**](#start-from-an-existing-cloud-session) va solo nell'altro modo: porta il lavoro di una sessione cloud in un project.494* Un thread appartiene all'unico project che l'ha avviato. Non puoi spostare o copiare un thread in un altro project, o spostarlo fuori per stare da solo. [**Move to project**](#start-from-an-existing-cloud-session) va solo nell'altro modo: porta il lavoro di una sessione cloud in un project.

513 547

514Un thread o la conversazione del project ha fatto una richiesta che il tuo piano copre solo con crediti di utilizzo, come una a un modello o una dimensione di contesto che il tuo piano non include, e i crediti di utilizzo non sono attivati per il tuo account. [Aggiungi crediti di utilizzo al tuo abbonamento](/docs/it/costs#add-usage-credits-to-your-subscription) copre chi può attivarli o comprarli su ogni piano. Una volta che i crediti sono disponibili, invia un altro messaggio per riprovare.548Un thread o la conversazione del project ha fatto una richiesta che il tuo piano copre solo con crediti di utilizzo, come una a un modello o una dimensione di contesto che il tuo piano non include, e i crediti di utilizzo non sono attivati per il tuo account. [Aggiungi crediti di utilizzo al tuo abbonamento](/docs/it/costs#add-usage-credits-to-your-subscription) copre chi può attivarli o comprarli su ogni piano. Una volta che i crediti sono disponibili, invia un altro messaggio per riprovare.

515 549

550<h3 id="lost-contact-with-your-folder">

551 Contatto perso con la tua cartella

552</h3>

553

554Un thread in esecuzione sul tuo computer mostra questo quando la sessione Claude Code lì ha smesso di rispondere, di solito perché il computer è andato in sospensione o l'app desktop o `claude remote-control` è uscito. Riattiva il computer, e se l'app desktop o `claude remote-control` non è più in esecuzione lì, avvialo di nuovo: riapri l'app e conferma che **Use this computer from your phone and claude.ai** è ancora attivo in **Settings > Claude Code**, o esegui di nuovo `claude remote-control` nella stessa cartella.

555

516<h3 id="context-limit">556<h3 id="context-limit">

517 Altri messaggi557 Altri messaggi

518</h3>558</h3>

527| "The project's environment was removed" | Scegli un ambiente diverso in **Project settings > Environment**; il cambiamento si applica ai nuovi thread |567| "The project's environment was removed" | Scegli un ambiente diverso in **Project settings > Environment**; il cambiamento si applica ai nuovi thread |

528| "Setup script failed" | Fai clic su **Edit setup script** sull'errore, correggi lo script nell'ambiente, quindi invia un altro messaggio. [Setup script failed](/docs/it/web-quickstart#setup-script-failed) elenca le cause comuni |568| "Setup script failed" | Fai clic su **Edit setup script** sull'errore, correggi lo script nell'ambiente, quindi invia un altro messaggio. [Setup script failed](/docs/it/web-quickstart#setup-script-failed) elenca le cause comuni |

529| "Claude ran out of context on this turn" | Il thread ha riempito la sua finestra di contesto. Se il messaggio dice che il thread continua in una sessione fresca, continua da solo; altrimenti chiedi a Claude nella conversazione del project di avviare un nuovo thread per il lavoro rimanente |569| "Claude ran out of context on this turn" | Il thread ha riempito la sua finestra di contesto. Se il messaggio dice che il thread continua in una sessione fresca, continua da solo; altrimenti chiedi a Claude nella conversazione del project di avviare un nuovo thread per il lavoro rimanente |

570| "Couldn't start in" seguito dal nome della tua cartella | Hai permesso a un thread di eseguirsi sul tuo computer, ma la sessione non poteva iniziare lì. Quando una riga sotto il messaggio fornisce il motivo, correggilo, quindi chiedi a Claude di eseguire di nuovo l'attività |

571| "Claude is out of date on your device" | Il computer che hai scelto per eseguire un thread ha una versione di Claude Code più vecchia di v2.1.280. Aggiorna Claude Code lì, o aggiorna l'app desktop se è quello che connette la cartella, quindi chiedi a Claude di eseguire di nuovo l'attività |

530| "Reached the turn limit" | Il thread ha raggiunto il limite sui passaggi agentic che [`CLAUDE_CODE_MAX_TURNS`](/docs/it/env-vars) imposta. Invia un altro messaggio per continuare, o aumenta o rimuovi quella variabile dove è impostata |572| "Reached the turn limit" | Il thread ha raggiunto il limite sui passaggi agentic che [`CLAUDE_CODE_MAX_TURNS`](/docs/it/env-vars) imposta. Invia un altro messaggio per continuare, o aumenta o rimuovi quella variabile dove è impostata |

531 573

532<h2 id="related-resources">574<h2 id="related-resources">

cli-reference.md +5 −5

Details

26| `claude install [version]` | Installa o reinstalla il binario nativo. Accetta una versione come `2.1.118`, oppure `stable` o `latest`. Vedi [Installa una versione specifica](/docs/it/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Installa o reinstalla il binario nativo. Accetta una versione come `2.1.118`, oppure `stable` o `latest`. Vedi [Installa una versione specifica](/docs/it/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Accedi al tuo account Anthropic. Usa `--email` per pre-compilare il tuo indirizzo email, `--sso` per forzare l'autenticazione SSO e `--console` per accedere con Anthropic Console per la fatturazione dell'utilizzo dell'API invece di un abbonamento Claude | `claude auth login --console` |27| `claude auth login` | Accedi al tuo account Anthropic. Usa `--email` per pre-compilare il tuo indirizzo email, `--sso` per forzare l'autenticazione SSO e `--console` per accedere con Anthropic Console per la fatturazione dell'utilizzo dell'API invece di un abbonamento Claude | `claude auth login --console` |

~~29| `claude auth status` | Mostra lo stato di autenticazione come JSON. Usa `--text` per output leggibile dall'uomo. Esce con codice 0 se connesso, 1 se no | `claude auth status` |~~29| `claude auth status` | Mostra lo stato di autenticazione come JSON. Usa `--text` per output leggibile dall'uomo. Esce con codice 0 se connesso, 1 se no. Il JSON include un campo `configDirectory` che nomina la [directory di configurazione](/docs/it/claude-directory) che la CLI utilizza. Il campo richiede Claude Code v2.1.268 o successivo | `claude auth status` |

30| `claude agents` | Apri la [visualizzazione agente](/docs/it/agent-view) per monitorare e inviare sessioni parallele in background. Usa `--cwd <path>` per mostrare solo le sessioni avviate in quella directory, oppure `--json` per stampare le sessioni attive come un array JSON per gli script (`--json --all` include anche le sessioni in background completate). Passa `--permission-mode`, `--model`, `--effort` o `--agent` per impostare i [valori predefiniti per le sessioni inviate](/docs/it/agent-view#permission-mode-model-and-effort). Accetta `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` come il comando `claude` di livello superiore. L'apertura della visualizzazione agente richiede un terminale interattivo | `claude agents --json` |30| `claude agents` | Apri la [visualizzazione agente](/docs/it/agent-view) per monitorare e inviare sessioni parallele in background. Usa `--cwd <path>` per mostrare solo le sessioni avviate in quella directory, oppure `--json` per stampare le sessioni attive come un array JSON per gli script (`--json --all` include anche le sessioni in background completate). Passa `--permission-mode`, `--model`, `--effort` o `--agent` per impostare i [valori predefiniti per le sessioni inviate](/docs/it/agent-view#permission-mode-model-and-effort). Accetta `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` come il comando `claude` di livello superiore. L'apertura della visualizzazione agente richiede un terminale interattivo | `claude agents --json` |

32| `claude auto-mode defaults` | Stampa le regole del classificatore [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) integrate come JSON. Usa `claude auto-mode config` per visualizzare la tua configurazione effettiva con le impostazioni applicate. `--label <prefix>` stampa solo le regole la cui etichetta inizia con quel prefisso, con corrispondenza case-insensitive. Richiede Claude Code v2.1.208 o successivo | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Stampa le regole del classificatore [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) integrate come JSON. Usa `claude auto-mode config` per visualizzare la tua configurazione effettiva con le impostazioni applicate. `--label <prefix>` stampa solo le regole la cui etichetta inizia con quel prefisso, con corrispondenza case-insensitive. Richiede Claude Code v2.1.208 o successivo | `claude auto-mode defaults --label 'Git Destructive'` |

64| `--add-dir` | Aggiungi directory di lavoro aggiuntive per consentire a Claude di leggere e modificare file. Concede l'accesso ai file; Claude Code [non scopre](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) la maggior parte della configurazione `.claude/` da queste directory. Convalida che ogni percorso esista come directory. Non puoi aggiungere la maggior parte dei [percorsi di rete](/docs/it/errors#working-directory-is-a-network-path), come `\\server\share`. Per mantenere queste directory tra le sessioni, imposta [`permissions.additionalDirectories`](/docs/it/settings-reference#permissions-additionaldirectories) nelle impostazioni | `claude --add-dir ../apps ../lib` |64| `--add-dir` | Aggiungi directory di lavoro aggiuntive per consentire a Claude di leggere e modificare file. Concede l'accesso ai file; Claude Code [non scopre](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) la maggior parte della configurazione `.claude/` da queste directory. Convalida che ogni percorso esista come directory. Non puoi aggiungere la maggior parte dei [percorsi di rete](/docs/it/errors#working-directory-is-a-network-path), come `\\server\share`. Per mantenere queste directory tra le sessioni, imposta [`permissions.additionalDirectories`](/docs/it/settings-reference#permissions-additionaldirectories) nelle impostazioni | `claude --add-dir ../apps ../lib` |

65| `--advisor <model>` | Abilita lo [strumento advisor](/docs/it/advisor) lato server per questa sessione con un alias di modello, `fable`, `opus`, o `sonnet`, o un ID modello completo. Ha la precedenza sull'impostazione `advisorModel` per la sessione. `fable` richiede [accesso a Fable](/docs/it/advisor#choose-an-advisor-model) | `claude --advisor opus` |65| `--advisor <model>` | Abilita lo [strumento advisor](/docs/it/advisor) lato server per questa sessione con un alias di modello, `fable`, `opus`, o `sonnet`, o un ID modello completo. Ha la precedenza sull'impostazione `advisorModel` per la sessione. `fable` richiede [accesso a Fable](/docs/it/advisor#choose-an-advisor-model) | `claude --advisor opus` |

67| `--agents` | Definisci subagenti personalizzati dinamicamente tramite JSON. Accetta i [campi elencati per subagenti definiti da CLI](/docs/it/sub-agents#choose-the-subagent-scope). Claude Code convalida il JSON all'avvio e esce con un valore non valido; vedi [`Invalid --agents configuration`](/docs/it/errors#invalid-agents-configuration) per il messaggio e per i flag e la variabile di ambiente che saltano la convalida. La convalida richiede Claude Code v2.1.242 o successivo | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |67| `--agents` | Definisci subagenti personalizzati dinamicamente tramite JSON. Accetta i [campi elencati per subagenti definiti da CLI](/docs/it/sub-agents#choose-the-subagent-scope). Con `--print`, il valore può invece essere il percorso a un file JSON che contiene l'oggetto; la forma di file richiede Claude Code v2.1.281 o successivo. Claude Code convalida il valore all'avvio e esce con un valore non valido; vedi [`Invalid --agents configuration`](/docs/it/errors#invalid-agents-configuration) per il messaggio e per i flag e la variabile di ambiente che saltano la convalida. La convalida richiede Claude Code v2.1.242 o successivo | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

68| `--allow-dangerously-skip-permissions` | Aggiungi `bypassPermissions` al ciclo della modalità `Shift+Tab` senza iniziare in essa. Ti consente di iniziare in una modalità diversa come `plan` e passare a `bypassPermissions` in seguito. Vedi [modalità di permesso](/docs/it/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |68| `--allow-dangerously-skip-permissions` | Aggiungi `bypassPermissions` al ciclo della modalità `Shift+Tab` senza iniziare in essa. Ti consente di iniziare in una modalità diversa come `plan` e passare a `bypassPermissions` in seguito. Vedi [modalità di permesso](/docs/it/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

69| `--allowedTools`, `--allowed-tools` | Strumenti che si eseguono senza richiedere il permesso. Vedi [sintassi della regola di permesso](/docs/it/settings-reference#permission-rule-syntax) per la corrispondenza dei pattern. Per limitare quali strumenti sono disponibili, usa `--tools` invece. Se nomini uno degli [strumenti di tracciamento delle attività](/docs/it/tools-reference#task-tool-availability) qui, Claude Code opta anche la sessione in | `"Bash(git log *)" "Bash(git diff *)" "Read"` |69| `--allowedTools`, `--allowed-tools` | Strumenti che si eseguono senza richiedere il permesso. Vedi [sintassi della regola di permesso](/docs/it/settings-reference#permission-rule-syntax) per la corrispondenza dei pattern. Per limitare quali strumenti sono disponibili, usa `--tools` invece. Se nomini uno degli [strumenti di tracciamento delle attività](/docs/it/tools-reference#task-tool-availability) qui, Claude Code opta anche la sessione in | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

70| `--append-subagent-system-prompt` | Aggiungi testo personalizzato alla fine del prompt di sistema di ogni [subagente](/docs/it/sub-agents), inclusi i subagenti annidati, a parte un [subagente biforcato](/docs/it/sub-agents#fork-the-current-conversation), che riutilizza il prompt della conversazione. Si applica solo in modalità non interattiva con `-p`. Richiede Claude Code v2.1.205 o successivo | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |70| `--append-subagent-system-prompt` | Aggiungi testo personalizzato alla fine del prompt di sistema di ogni [subagente](/docs/it/sub-agents), inclusi i subagenti annidati, a parte un [subagente biforcato](/docs/it/sub-agents#fork-the-current-conversation), che riutilizza il prompt della conversazione. Si applica solo in modalità non interattiva con `-p`. Richiede Claude Code v2.1.205 o successivo | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

75| `--ax-screen-reader` | Renderizza l'output compatibile con lo screen reader: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione [`tui`](/docs/it/settings-reference#tui) non ha effetto; le [sessioni in background](/docs/it/agent-view) allegate ancora si rendono a schermo intero. Ha la precedenza su [`CLAUDE_AX_SCREEN_READER`](/docs/it/env-vars) e l'impostazione [`axScreenReader`](/docs/it/settings-reference#axscreenreader). Richiede Claude Code v2.1.181 o successivo | `claude --ax-screen-reader` |75| `--ax-screen-reader` | Renderizza l'output compatibile con lo screen reader: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione [`tui`](/docs/it/settings-reference#tui) non ha effetto; le [sessioni in background](/docs/it/agent-view) allegate ancora si rendono a schermo intero. Ha la precedenza su [`CLAUDE_AX_SCREEN_READER`](/docs/it/env-vars) e l'impostazione [`axScreenReader`](/docs/it/settings-reference#axscreenreader). Richiede Claude Code v2.1.181 o successivo | `claude --ax-screen-reader` |

76| `--bare` | Modalità minima: salta l'auto-scoperta di hooks, skills, comandi personalizzati, subagenti, plugin installati, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script inizino più velocemente. Le skills in una directory che passi con `--add-dir` si caricano comunque. Claude ha accesso agli strumenti Bash, lettura file e modifica file. Imposta [`CLAUDE_CODE_SIMPLE`](/docs/it/env-vars). Vedi [modalità bare](/docs/it/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |76| `--bare` | Modalità minima: salta l'auto-scoperta di hooks, skills, comandi personalizzati, subagenti, plugin installati, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script inizino più velocemente. Le skills in una directory che passi con `--add-dir` si caricano comunque. Claude ha accesso agli strumenti Bash, lettura file e modifica file. Imposta [`CLAUDE_CODE_SIMPLE`](/docs/it/env-vars). Vedi [modalità bare](/docs/it/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

78| `--bg`, `--background` | Avvia la sessione come [agente in background](/docs/it/agent-view) e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con `--exec` per eseguire un comando shell come lavoro in background invece di una sessione Claude, o con `--agent` per eseguire un subagente specifico. Non può essere combinato con `-p`/`--print`; vedi il [riferimento degli errori](/docs/it/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |78| `--bg`, `--background` | Avvia la sessione come [agente in background](/docs/it/agent-view) e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con `--exec` per eseguire un comando shell come lavoro in background invece di una sessione Claude, o con `--agent` per eseguire un subagente specifico. Controlla l'[affidabilità dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust) per la directory prima che inizi. Non può essere combinato con `-p`/`--print`; vedi il [riferimento degli errori](/docs/it/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

79| `--channels` | (Anteprima di ricerca) Server MCP le cui notifiche di [canale](/docs/it/channels) Claude dovrebbe ascoltare in questa sessione. Elenco separato da spazi di voci `plugin:<name>@<marketplace>`. Richiede l'autenticazione Anthropic tramite claude.ai o una chiave API Console | `claude --channels plugin:my-notifier@my-marketplace` |79| `--channels` | (Anteprima di ricerca) Server MCP le cui notifiche di [canale](/docs/it/channels) Claude dovrebbe ascoltare in questa sessione. Elenco separato da spazi di voci `plugin:<name>@<marketplace>`. Richiede l'autenticazione Anthropic tramite claude.ai o una chiave API Console | `claude --channels plugin:my-notifier@my-marketplace` |

81| `--cloud` | Con una descrizione di attività, crea una nuova [sessione cloud](/docs/it/claude-code-on-the-web). Con un ID di sessione (`session_...` o `cse_...`) o un URL claude.ai/code, accoda un messaggio in quella sessione esistente invece, con `-p`. Vedi [invia un messaggio di follow-up](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |81| `--cloud` | Con una descrizione di attività, crea una nuova [sessione cloud](/docs/it/claude-code-on-the-web). Con un ID di sessione (`session_...` o `cse_...`) o un URL claude.ai/code, accoda un messaggio in quella sessione esistente invece, con `-p`. Vedi [invia un messaggio di follow-up](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |

89| `--effort` | Imposta il [livello di sforzo](/docs/it/model-config#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`, o `ultracode`. I livelli disponibili dipendono dal modello. `ultracode` richiede uno sforzo `xhigh` con [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) attivato, e richiede Claude Code v2.1.203 o successivo. Sostituisce le impostazioni [`modelSettings`](/docs/it/settings-reference#modelsettings) e [`effortLevel`](/docs/it/settings-reference#effortlevel) per questa sessione e non persiste | `claude --effort high` |89| `--effort` | Imposta il [livello di sforzo](/docs/it/model-config#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`, o `ultracode`. I livelli disponibili dipendono dal modello. `ultracode` richiede uno sforzo `xhigh` con [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) attivato, e richiede Claude Code v2.1.203 o successivo. Sostituisce le impostazioni [`modelSettings`](/docs/it/settings-reference#modelsettings) e [`effortLevel`](/docs/it/settings-reference#effortlevel) per questa sessione e non persiste | `claude --effort high` |

90| `--enable-auto-mode` | Rimosso in v2.1.111. La modalità auto è ora nel ciclo `Shift+Tab` per impostazione predefinita; usa `--permission-mode auto` per iniziare in essa | `claude --permission-mode auto` |90| `--enable-auto-mode` | Rimosso in v2.1.111. La modalità auto è ora nel ciclo `Shift+Tab` per impostazione predefinita; usa `--permission-mode auto` per iniziare in essa | `claude --permission-mode auto` |

91| `--environment <environment-id>` | Crea una nuova sessione cloud che viene eseguita sull'[ambiente auto-ospitato](/docs/it/self-hosted-environments) con l'ID fornito. Gli ID ambiente iniziano con `ccpool_`. Vedi il [comportamento di dispatch di `--environment`](/docs/it/self-hosted-environments-testing#environment-dispatch-behavior) per il comportamento di dispatch e le combinazioni di flag che rifiuta. Richiede Claude Code v2.1.224 o successivo | `claude -p "Fix the login bug" --environment ccpool_abc123` |91| `--environment <environment-id>` | Crea una nuova sessione cloud che viene eseguita sull'[ambiente auto-ospitato](/docs/it/self-hosted-environments) con l'ID fornito. Gli ID ambiente iniziano con `ccpool_`. Vedi il [comportamento di dispatch di `--environment`](/docs/it/self-hosted-environments-testing#environment-dispatch-behavior) per il comportamento di dispatch e le combinazioni di flag che rifiuta. Richiede Claude Code v2.1.224 o successivo | `claude -p "Fix the login bug" --environment ccpool_abc123` |

92| `--exclude-dynamic-system-prompt-sections` | Sposta le sezioni per macchina dal prompt di sistema (directory di lavoro, informazioni sull'ambiente, percorsi di memoria, flag git-repo) nel primo messaggio dell'utente. Migliora il riutilizzo della cache dei prompt tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando `--system-prompt` o `--system-prompt-file` è impostato. Usa con `-p` per carichi di lavoro con script, multi-utente | `claude -p --exclude-dynamic-system-prompt-sections "query"` |92| `--exclude-dynamic-system-prompt-sections` | Sposta il contesto per utente, come la posizione della memoria automatica, fuori dal prompt di sistema e nel primo messaggio dell'utente. Migliora il riutilizzo della cache dei prompt tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando `--system-prompt` o `--system-prompt-file` è impostato. Usa con `-p` per carichi di lavoro con script, multi-utente | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

93| `--exec` | Esegui un comando shell come lavoro in background supportato da PTY invece di avviare una sessione Claude. Usa con `--bg` per lanciare dalla shell | `claude --bg --exec 'pytest -x'` |93| `--exec` | Esegui un comando shell come lavoro in background supportato da PTY invece di avviare una sessione Claude. Usa con `--bg` per lanciare dalla shell | `claude --bg --exec 'pytest -x'` |

94| `--fallback-model` | Abilita il fallback automatico al modello specificato quando il modello primario è sovraccarico o non disponibile, ad esempio un modello ritirato. Accetta un elenco separato da virgole provato in ordine. Vedi [Catene di modelli di fallback](/docs/it/model-config#fallback-model-chains). Per mantenere una catena tra le sessioni, usa l'impostazione [`fallbackModel`](/docs/it/settings-reference#fallbackmodel), che questo flag sostituisce | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | Abilita il fallback automatico al modello specificato quando il modello primario è sovraccarico o non disponibile, ad esempio un modello ritirato. Accetta un elenco separato da virgole provato in ordine. Vedi [Catene di modelli di fallback](/docs/it/model-config#fallback-model-chains). Per mantenere una catena tra le sessioni, usa l'impostazione [`fallbackModel`](/docs/it/settings-reference#fallbackmodel), che questo flag sostituisce | `claude --fallback-model sonnet,haiku` |

127| `--resume`, `-r` | Riprendi una sessione specifica per ID o nome, o mostra un selettore interattivo per scegliere una sessione. Al posto di un ID, puoi passare il percorso assoluto al file di [trascrizione](/docs/it/sessions#where-transcripts-are-stored) `.jsonl` di una sessione. Il selettore e la ricerca per nome includono le sessioni che hanno aggiunto questa directory con `/add-dir`. Quando passi un ID di sessione, Claude Code cerca nella directory del progetto corrente e nei suoi git worktrees, quindi in ogni altro progetto su questa macchina. Prima di v2.1.223, la ricerca per ID copriva solo la directory del progetto corrente e i suoi git worktrees. Le [sessioni in background](/docs/it/agent-view) appaiono nel selettore contrassegnate con `bg` | `claude --resume auth-refactor` |127| `--resume`, `-r` | Riprendi una sessione specifica per ID o nome, o mostra un selettore interattivo per scegliere una sessione. Al posto di un ID, puoi passare il percorso assoluto al file di [trascrizione](/docs/it/sessions#where-transcripts-are-stored) `.jsonl` di una sessione. Il selettore e la ricerca per nome includono le sessioni che hanno aggiunto questa directory con `/add-dir`. Quando passi un ID di sessione, Claude Code cerca nella directory del progetto corrente e nei suoi git worktrees, quindi in ogni altro progetto su questa macchina. Prima di v2.1.223, la ricerca per ID copriva solo la directory del progetto corrente e i suoi git worktrees. Le [sessioni in background](/docs/it/agent-view) appaiono nel selettore contrassegnate con `bg` | `claude --resume auth-refactor` |

128| `--safe-mode` | Inizia con tutte le personalizzazioni disabilitate per risolvere i problemi di una configurazione interrotta: CLAUDE.md, skills, plugins, hooks, server MCP, comandi e agenti personalizzati, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della barra di stato e suggerimento di file, server LSP, e memoria automatica non si caricano. L'autenticazione, la selezione del modello, gli strumenti integrati e i permessi funzionano normalmente, il che differisce da [`--bare`](/docs/it/headless#start-faster-with-bare-mode). La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la barra di stato e i comandi di suggerimento di file; i plugin gestiti, le skills gestite, CLAUDE.md gestito, e i server MCP configurati dalla politica non lo fanno. Utile per verificare se una personalizzazione è quello che attiva il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback). Imposta [`CLAUDE_CODE_SAFE_MODE`](/docs/it/env-vars) | `claude --safe-mode` |128| `--safe-mode` | Inizia con tutte le personalizzazioni disabilitate per risolvere i problemi di una configurazione interrotta: CLAUDE.md, skills, plugins, hooks, server MCP, comandi e agenti personalizzati, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della barra di stato e suggerimento di file, server LSP, e memoria automatica non si caricano. L'autenticazione, la selezione del modello, gli strumenti integrati e i permessi funzionano normalmente, il che differisce da [`--bare`](/docs/it/headless#start-faster-with-bare-mode). La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la barra di stato e i comandi di suggerimento di file; i plugin gestiti, le skills gestite, CLAUDE.md gestito, e i server MCP configurati dalla politica non lo fanno. Utile per verificare se una personalizzazione è quello che attiva il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback). Imposta [`CLAUDE_CODE_SAFE_MODE`](/docs/it/env-vars) | `claude --safe-mode` |

130| `--setting-sources` | Elenco separato da virgole delle fonti di impostazione da caricare (`user`, `project`, `local`) | `claude --setting-sources user,project` |130| `--setting-sources` | Elenco separato da virgole delle fonti di impostazione da caricare (`user`, `project`, `local`). Vedi [agent view](/docs/it/agent-view#what-carries-over-when-you-background) e [agent teams](/docs/it/agent-teams#context-and-communication) per le sessioni che avvii da questa che ereditano l'elenco | `claude --setting-sources user,project` |

131| `--settings` | Percorso a un file JSON di impostazioni o una stringa JSON inline. I valori che imposti qui sostituiscono le stesse chiavi nei tuoi file `settings.json` per questa sessione. Le chiavi che ometti mantengono i loro valori basati su file. Il file deve essere un file regolare non più grande di 2 MiB. Vedi [precedenza delle impostazioni](/docs/it/settings#settings-precedence) | `claude --settings ./settings.json` |131| `--settings` | Percorso a un file JSON di impostazioni o una stringa JSON inline. I valori che imposti qui sostituiscono le stesse chiavi nei tuoi file `settings.json` per questa sessione. Le chiavi che ometti mantengono i loro valori basati su file. Il file deve essere un file regolare non più grande di 2 MiB. Vedi [precedenza delle impostazioni](/docs/it/settings#settings-precedence) | `claude --settings ./settings.json` |

132| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando tutte le altre configurazioni MCP. Vedi [Controllo esclusivo con managed-mcp.json](/docs/it/managed-mcp#exclusive-control-with-managed-mcp-json) per quello che il flag fa sotto un file MCP gestito | `claude --strict-mcp-config --mcp-config ./mcp.json` |132| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando tutte le altre configurazioni MCP. Vedi [Controllo esclusivo con managed-mcp.json](/docs/it/managed-mcp#exclusive-control-with-managed-mcp-json) per quello che il flag fa sotto un file MCP gestito | `claude --strict-mcp-config --mcp-config ./mcp.json` |

cloud-environments.md +16 −3

Details

281 Cosa è disponibile nelle sessioni cloud281 Cosa è disponibile nelle sessioni cloud

282</h2>282</h2>

283 283

284Negli ambienti ospitati da Anthropic, ogni sessione ottiene una macchina virtuale (VM) fresca che esegue Ubuntu 24.04 su x86\_64, indipendentemente dal vostro sistema operativo e dall'architettura della CPU, con il vostro repository clonato e i toolchain comuni preinstallati. Quando una dipendenza fornisce binari precompilati, come gem Ruby con estensioni native o wheel Python precostruiti, utilizzate la sua build Linux x86\_64 per corrispondere alla VM. Questa sezione copre i default ospitati da Anthropic, gli strumenti GitHub integrati, come [eseguire test e servizi](#run-tests-start-services-and-add-packages), e i [limiti di risorse](#resource-limits) che ogni VM ottiene.284Negli ambienti ospitati da Anthropic, ogni sessione ottiene una macchina virtuale (VM) fresca che esegue Ubuntu 24.04 su x86\_64, indipendentemente dal vostro sistema operativo e dall'architettura della CPU, con il vostro repository clonato e i toolchain comuni preinstallati. Quando una dipendenza fornisce binari precompilati, come gem Ruby con estensioni native o wheel Python precostruiti, utilizzate la sua build Linux x86\_64 per corrispondere alla VM. Questa sezione copre i default ospitati da Anthropic, gli strumenti GitHub integrati, come [eseguire test e servizi](#run-tests-start-services-and-add-packages), i [limiti di risorse](#resource-limits) che ogni VM ottiene, e i [limiti di tempo](#time-limits) sul lavoro a lunga esecuzione.

285 285

286<Note>286<Note>

287 Le sessioni che la vostra organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sui vostri runner invece, con gli strumenti che la vostra immagine runner fornisce.287 Le sessioni che la vostra organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sui vostri runner invece, con gli strumenti che la vostra immagine runner fornisce.

421 421

422La VM può interrompere i compiti che necessitano di significativamente più memoria, come grandi lavori di build o test ad alta intensità di memoria. Per carichi di lavoro oltre questi limiti, utilizzate [Remote Control](/docs/it/remote-control) per eseguire Claude Code sul vostro hardware, o eseguite le sessioni cloud in un [ambiente self-hosted](/docs/it/self-hosted-environments) su compute che la vostra organizzazione gestisce.422La VM può interrompere i compiti che necessitano di significativamente più memoria, come grandi lavori di build o test ad alta intensità di memoria. Per carichi di lavoro oltre questi limiti, utilizzate [Remote Control](/docs/it/remote-control) per eseguire Claude Code sul vostro hardware, o eseguite le sessioni cloud in un [ambiente self-hosted](/docs/it/self-hosted-environments) su compute che la vostra organizzazione gestisce.

423 423

424<h3 id="time-limits">

425 Limiti di tempo

426</h3>

427

428Negli ambienti ospitati da Anthropic, questi limiti di tempo si applicano al lavoro a lunga esecuzione in una sessione cloud, come una build, un'installazione o un'esecuzione di test. Ogni voce si collega alla sezione che definisce il limite.

429

430* **Comandi che Claude esegue**: un ambiente cloud non imposta il suo proprio timeout di comando, quindi si applicano i default dello strumento Bash. Claude attende 2 minuti per un comando per impostazione predefinita e può chiedere fino a 10 minuti. Quando un comando raggiunge il suo [timeout](/docs/it/tools-reference#timeout-and-output-limits), Claude Code [lo sposta in background](/docs/it/tools-reference#background-commands) invece di fermarlo, a meno che il comando non inizi con `sleep`.

431* **Hook SessionStart**: Claude Code annulla un hook `command` dopo 600 secondi a meno che non impostiate [`timeout`](/docs/it/hooks#common-fields), in secondi, sulla voce dell'hook. Claude Code non applica il timeout su un hook che eseguite con [`async: true`](/docs/it/hooks#run-hooks-in-the-background).

432* **Script di configurazione**: uno script che richiede più di circa cinque minuti non viene memorizzato nella cache. [Requisiti dello script](#script-requirements) copre come rimanere sotto questo limite.

433* **Sessioni inattive**: una sessione si interrompe dopo un periodo di inattività e la sua VM viene recuperata. [Environment expired](/docs/it/claude-code-on-the-web#environment-expired) copre cosa conta come inattivo e come riaprire la sessione.

434

435Per aumentare i timeout dei comandi per le sessioni di un ambiente, aggiungete [`BASH_DEFAULT_TIMEOUT_MS` e `BASH_MAX_TIMEOUT_MS`](/docs/it/env-vars#variables) alle sue [variabili di ambiente](#set-environment-variables). Entrambi prendono millisecondi. Ad esempio, `BASH_DEFAULT_TIMEOUT_MS=600000` rende 10 minuti il default.

436

424<h2 id="setup-scripts">437<h2 id="setup-scripts">

425 Script di configurazione438 Script di configurazione

426</h2>439</h2>

445Uno script di configurazione ha tre vincoli da considerare:458Uno script di configurazione ha tre vincoli da considerare:

446 459

447* **Exit zero**: se lo script esce con un codice diverso da zero, la sessione non si avvia. Aggiungere `|| true` ai comandi non critici in modo che un errore di installazione intermittente non blocchi la sessione.460* **Exit zero**: se lo script esce con un codice diverso da zero, la sessione non si avvia. Aggiungere `|| true` ai comandi non critici in modo che un errore di installazione intermittente non blocchi la sessione.

448* **Completamento entro cinque minuti**: mantenere il tempo di esecuzione totale dello script sotto circa cinque minuti in modo che la [cache dell'ambiente](#environment-caching) possa essere costruita. Eseguire le installazioni indipendenti in parallelo con `&` e `wait`, e spostare qualsiasi singolo download che non rientra in un [hook SessionStart](#setup-scripts-vs-sessionstart-hooks) che lo avvia in background.461* **Completamento entro cinque minuti**: mantenere il tempo di esecuzione totale dello script sotto circa cinque minuti in modo che la [cache dell'ambiente](#environment-caching) possa essere costruita. Quando la configurazione richiede più tempo di quello, l'ambiente non viene memorizzato nella cache. Eseguire le installazioni indipendenti in parallelo con `&` e `wait`, e spostare qualsiasi singolo download che non rientra in un [hook SessionStart](#setup-scripts-vs-sessionstart-hooks) che lo avvia in background. Se le nuove sessioni si bloccano o si interrompono durante la configurazione, vedere [Le nuove sessioni si bloccano o scadono durante la configurazione](/docs/it/web-quickstart#new-sessions-hang-or-time-out-during-setup).

449* **Accesso di rete per le installazioni**: le installazioni di pacchetti devono raggiungere i registri. Il livello **Trusted** predefinito copre i [domini consentiti comuni](#default-allowed-domains) inclusi npm, PyPI, RubyGems e crates.io; con accesso di rete **None**, le installazioni non riescono.462* **Accesso di rete per le installazioni**: le installazioni di pacchetti devono raggiungere i registri. Il livello **Trusted** predefinito copre i [domini consentiti comuni](#default-allowed-domains) inclusi npm, PyPI, RubyGems e crates.io; con accesso di rete **None**, le installazioni non riescono.

450 463

451<h3 id="environment-caching">464<h3 id="environment-caching">

452 Cache dell'ambiente465 Cache dell'ambiente

453</h3>466</h3>

454 467

455Lo script di configurazione viene eseguito la prima volta che si avvia una sessione in un ambiente. Dopo il completamento, Anthropic crea uno snapshot del filesystem e riutilizza quello snapshot come punto di partenza per le sessioni successive. Le nuove sessioni iniziano con le dipendenze, gli strumenti e le immagini Docker già sul disco, e saltano il passaggio dello script di configurazione. Questo mantiene l'avvio veloce anche quando lo script installa grandi toolchain o estrae immagini di container.468Lo script di configurazione viene eseguito la prima volta che si avvia una sessione in un ambiente. Quando la configurazione si completa entro [circa cinque minuti](#script-requirements), Anthropic crea uno snapshot del filesystem e riutilizza quello snapshot come punto di partenza per le sessioni successive. Le nuove sessioni iniziano con le dipendenze, gli strumenti e le immagini Docker già sul disco, e saltano il passaggio dello script di configurazione. Questo mantiene l'avvio veloce anche quando lo script installa grandi toolchain o estrae immagini di container. Se la configurazione richiede più tempo di circa cinque minuti, l'ambiente non viene memorizzato nella cache.

456 469

457La cache è uno snapshot del filesystem, quindi mantiene ciò che lo script di configurazione scrive su disco e perde tutto ciò che era solo in esecuzione. I pacchetti installati, le immagini Docker estratte e i file scritti vengono tutti trasferiti. Un database avviato dallo script, uno stack `docker compose up` o qualsiasi altro processo in background no; avviare quelli per sessione chiedendo a Claude o con un [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).470La cache è uno snapshot del filesystem, quindi mantiene ciò che lo script di configurazione scrive su disco e perde tutto ciò che era solo in esecuzione. I pacchetti installati, le immagini Docker estratte e i file scritti vengono tutti trasferiti. Un database avviato dallo script, uno stack `docker compose up` o qualsiasi altro processo in background no; avviare quelli per sessione chiedendo a Claude o con un [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).

458 471

code-review.md +2 −2

Details

297 Risoluzione dei problemi297 Risoluzione dei problemi

298</h2>298</h2>

299 299

300Le esecuzioni di revisione sono best-effort. Un'esecuzione non riuscita non blocca mai il tuo PR, ma non si ritenta nemmeno automaticamente. Questa sezione copre come recuperare da un'esecuzione non riuscita e dove cercare quando il check run segnala problemi che non riesci a trovare.300Le esecuzioni di revisione sono best-effort, e un'esecuzione non riuscita non blocca mai il tuo PR. Code Review ritenta automaticamente alcune revisioni interrotte. Questa sezione copre come eseguire di nuovo una revisione e dove cercare quando il check run segnala problemi che non riesci a trovare.

301 301

302<h3 id="retrigger-a-failed-or-timed-out-review">302<h3 id="retrigger-a-failed-or-timed-out-review">

303 Riattiva una revisione non riuscita o scaduta303 Riattiva una revisione non riuscita o scaduta

304</h3>304</h3>

305 305

306Quando l'infrastruttura di revisione incontra un errore interno o supera il limite di tempo, il check run si completa con un titolo di **Code review encountered an error** o **Code review timed out**. La conclusione è ancora neutra, quindi nulla blocca il tuo merge, ma non vengono pubblicati risultati.306Quando una revisione non riesce o supera il limite di tempo, il check run si completa con un titolo come **Code review failed** o **Code review timed out**. La conclusione è ancora neutra, quindi nulla blocca il tuo merge. A meno che il riepilogo del check run non dica che una nuova revisione del commit è stata messa in coda automaticamente, esegui di nuovo la revisione tu stesso.

307 307

308Per eseguire di nuovo la revisione, commenta `@claude review` sul PR. Questo avvia una revisione nuova senza sottoscrivere il PR ai push futuri. Se il PR non è [da un fork](#review-pull-requests-from-forks), puoi invece fare clic su **Re-run** sul check **Claude Code Review** nella scheda Checks di GitHub. Un re-run avvia anche una revisione nuova senza sottoscrivere il PR.308Per eseguire di nuovo la revisione, commenta `@claude review` sul PR. Questo avvia una revisione nuova senza sottoscrivere il PR ai push futuri. Se il PR non è [da un fork](#review-pull-requests-from-forks), puoi invece fare clic su **Re-run** sul check **Claude Code Review** nella scheda Checks di GitHub. Un re-run avvia anche una revisione nuova senza sottoscrivere il PR.

309 309

commands.md +62 −61

Details

53 53

54| Comando | Scopo |54| Comando | Scopo |

55| :- | :- |55| :- | :- |

56| `/add-dir <path>` | Aggiungere una directory di lavoro per l'accesso ai file durante la sessione corrente. Digitate un percorso parziale per vedere i suggerimenti di directory corrispondenti; premete `Tab` per accettarne uno. La maggior parte della configurazione `.claude/` [non viene scoperta](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) dalla directory aggiunta. Non potete aggiungere la maggior parte dei [percorsi di rete](/docs/it/errors#working-directory-is-a-network-path), come `\\server\share`. Dopo un'aggiunta riuscita, i vostri [hook `DirectoryAdded`](/docs/it/hooks#directoryadded) vengono eseguiti. Quando lo eseguite mentre Claude sta rispondendo, Claude Code vi chiede di confermare la directory subito, e una volta confermata, la prossima chiamata di strumento di Claude nello stesso turno può accedervi. Prima della v2.1.234, Claude Code metteva in coda il comando fino al termine del turno |56| `/add-dir <path>` | Aggiungere una directory di lavoro per l'accesso ai file durante la sessione corrente. Digitate un percorso parziale per vedere i suggerimenti di directory corrispondenti; premete `Tab` per accettarne uno. La maggior parte della configurazione `.claude/` [non viene scoperta](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) dalla directory aggiunta. Non potete aggiungere la maggior parte dei [percorsi di rete](/docs/it/errors#working-directory-is-a-network-path), come `\\server\share`. Dopo un'aggiunta riuscita, vengono eseguiti i vostri [`DirectoryAdded` hooks](/docs/it/hooks#directoryadded). Quando lo eseguite mentre Claude sta rispondendo, Claude Code vi chiede di confermare la directory subito, e una volta confermata, la prossima chiamata di strumento di Claude nello stesso turno può accedervi. Prima della v2.1.234, Claude Code metteva in coda il comando fino al termine del turno |

57| `/advisor [model\|off]` | Abilitare o disabilitare lo [strumento advisor](/docs/it/advisor), che consulta un secondo modello per una guida nei momenti chiave durante un'attività. Accetta `fable`, `opus`, `sonnet`, o un ID modello completo. `fable` richiede l'[accesso a Fable](/docs/it/advisor#choose-an-advisor-model). Senza un argomento, apre un selettore. In una sessione senza un terminale interattivo, o su [Remote Control](/docs/it/remote-control#limitations), passate il modello o `off` come argomento; senza argomento lì, il comando stampa l'advisor corrente come testo. Questi moduli richiedono Claude Code v2.1.260 o successivo |57| `/advisor [model\|off]` | Abilitare o disabilitare lo [strumento advisor](/docs/it/advisor), che consulta un secondo modello per una guida nei momenti chiave durante un'attività. Accetta `fable`, `opus`, `sonnet`, o un ID modello completo. `fable` richiede l'[accesso a Fable](/docs/it/advisor#choose-an-advisor-model). Senza un argomento, apre un selettore. In una sessione senza un terminale interattivo, o su [Remote Control](/docs/it/remote-control#limitations), passate il modello o `off` come argomento; senza argomento lì, il comando stampa l'advisor corrente come testo. Questi moduli richiedono Claude Code v2.1.260 o successivo |

58| `/agents` | A partire dalla v2.1.198, l'esecuzione di `/agents` stampa un promemoria per chiedere a Claude di creare o gestire [subagent](/docs/it/sub-agents), o di modificare direttamente `.claude/agents/` o `~/.claude/agents/`. Nella v2.1.197 e precedenti, apre un'interfaccia interattiva per creare e gestire le configurazioni dei subagent |58| `/agents` | A partire dalla v2.1.198, l'esecuzione di `/agents` stampa un promemoria per chiedere a Claude di creare o gestire [subagent](/docs/it/sub-agents), o di modificare direttamente `.claude/agents/` o `~/.claude/agents/`. Sulla v2.1.197 e precedenti, apre un'interfaccia interattiva per creare e gestire configurazioni di subagent |

59| `/artifacts` | Elencare gli [artifact](/docs/it/artifacts#find-an-artifact-again) che possedete o che sono condivisi con voi, quindi allegarne uno alla sessione, aprirlo nel vostro browser, o copiarne il collegamento. Disponibile dove gli [artifact](/docs/it/artifacts#availability) sono disponibili. Richiede Claude Code v2.1.208 o successivo; l'allegamento con `Enter` richiede v2.1.216 |59| `/artifacts` | Elencare gli [artifact](/docs/it/artifacts#find-an-artifact-again) che possedete o che sono condivisi con voi, quindi allegarne uno alla sessione, aprirlo nel vostro browser, o copiarne il link. Disponibile dove gli [artifact](/docs/it/artifacts#availability) sono disponibili. Richiede Claude Code v2.1.208 o successivo; l'allegamento con `Enter` richiede v2.1.216 |

60| `/auto-mode-setup` | [Bozza di voci `autoMode.environment`](/docs/it/auto-mode-config#generate-environment-entries) dal vostro progetto e dalle sessioni recenti, quindi rivedete la bozza e salvatela nelle impostazioni utente. Richiede un piano Pro, Max o Team e Claude Code v2.1.228 o successivo. Su Windows nativo, richiede v2.1.233 o successivo |60| `/auto-mode-setup` | [Bozza di voci `autoMode.environment`](/docs/it/auto-mode-config#generate-environment-entries) dal vostro progetto e dalle sessioni recenti, quindi rivedete la bozza e salvatela nelle impostazioni utente. Richiede un piano Pro, Max o Team e Claude Code v2.1.228 o successivo. Su Windows nativo, richiede v2.1.233 o successivo |

61| `/autocompact [auto\|<tokens>]` | Impostare la finestra auto-compact: quanto piena diventa la finestra di contesto prima che Claude Code compatti automaticamente. Passate una dimensione come `500k`, o `auto` per tornare alla finestra ottimizzata per il vostro modello. Claude Code salva il valore nelle impostazioni utente e lo applica alla sessione corrente. Consultate [Impostare la finestra auto-compact](/docs/it/model-config#set-the-auto-compact-window) per i valori accettati e cosa lo sostituisce. Senza un argomento, apre una finestra di dialogo che mostra la finestra corrente. Richiede Claude Code v2.1.221 o successivo |61| `/autocompact [auto\|<tokens>]` | Impostare la finestra auto-compact: quanto piena diventa la finestra di contesto prima che Claude Code compatti automaticamente. Passate una dimensione come `500k`, o `auto` per tornare alla finestra ottimizzata per il vostro modello. Claude Code salva il valore nelle impostazioni utente e lo applica alla sessione corrente. Consultate [Impostare la finestra auto-compact](/docs/it/model-config#set-the-auto-compact-window) per i valori accettati e cosa lo sostituisce. Senza un argomento, apre una finestra di dialogo che mostra la finestra corrente. Richiede Claude Code v2.1.221 o successivo |

62| `/autofix-pr [prompt]` | Avviare una sessione di [Claude Code sul web](/docs/it/claude-code-on-the-web#auto-fix-pull-requests) che monitora il PR del ramo corrente e spinge correzioni quando CI fallisce o i revisori lasciano commenti. Rileva il PR aperto dal vostro ramo estratto con `gh pr view`; per monitorare un PR diverso, estraete prima il suo ramo. Per impostazione predefinita, la sessione cloud viene istruita a correggere ogni fallimento CI e commento di revisione; passate un prompt per darle istruzioni diverse, ad esempio `/autofix-pr only fix lint and type errors`. Richiede la CLI `gh` e l'accesso a [Claude Code sul web](/docs/it/claude-code-on-the-web) |62| `/autofix-pr [prompt]` | Avviare una [sessione cloud](/docs/it/claude-code-on-the-web#auto-fix-pull-requests) che monitora la PR del ramo corrente e spinge correzioni quando CI fallisce o i revisori lasciano commenti. Rileva la PR aperta dal vostro ramo estratto con `gh pr view`; per monitorare una PR diversa, estraete prima il suo ramo. Per impostazione predefinita, la sessione cloud viene istruita a correggere ogni fallimento CI e commento di revisione; passate un prompt per darle istruzioni diverse, ad esempio `/autofix-pr only fix lint and type errors`. Richiede la CLI `gh` e l'accesso alle [sessioni cloud](/docs/it/claude-code-on-the-web) |

63| `/background [prompt]` | Staccare la sessione corrente per eseguirla come [agente in background](/docs/it/agent-view) e liberare questo terminale. Passate un prompt per inviare un'istruzione in più prima di staccare. Monitorate la sessione con `claude agents`. Per copiare la conversazione in una nuova sessione in background mentre questa continua a funzionare, usate `/fork`. Alias: `/bg` |63| `/background [prompt]` | Staccare la sessione corrente per eseguirla come [agente background](/docs/it/agent-view) e liberare questo terminale. Passate un prompt per inviare un'istruzione in più prima di staccare. Monitorate la sessione con `claude agents`. Per copiare la conversazione in una nuova sessione background mentre questa continua a funzionare, usate `/fork`. Alias: `/bg` |

64| `/batch <instruction>` | **[Skill](/docs/it/skills#bundled-skills).** Orchestrare modifiche su larga scala in un codebase in parallelo. Ricerca il codebase, scompone il lavoro in 5-30 unità indipendenti e presenta un piano. Una volta approvato, avvia un [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) per unità in un [git worktree](/docs/it/worktrees) isolato. Ogni subagent implementa la sua unità, esegue i test e apre una pull request. Richiede un repository git o un [hook `WorktreeCreate`](/docs/it/worktrees#non-git-version-control) che crea i worktree. Al di fuori di un repository git, `/batch` richiede Claude Code v2.1.281 o successivo. Esempio: `/batch migrate src/ from JavaScript to TypeScript` |64| `/batch <instruction>` | **[Skill](/docs/it/skills#bundled-skills).** Orchestrare cambiamenti su larga scala in un codebase in parallelo. Ricerca il codebase, decompone il lavoro in 5-30 unità indipendenti e presenta un piano. Una volta approvato, avvia un [subagent background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) per unità in un [worktree](/docs/it/worktrees) isolato. Ogni subagent implementa la sua unità, esegue i test e pubblica il suo cambiamento. Richiede un repository git o un [`WorktreeCreate` hook](/docs/it/worktrees#non-git-version-control) che crea i worktree. Al di fuori di un repository git, `/batch` richiede Claude Code v2.1.281 o successivo. Esempio: `/batch migrate src/ from JavaScript to TypeScript` |

65| `/branch [name]` | Creare un ramo della conversazione corrente a questo punto, in modo da poter provare una direzione diversa senza perdere la conversazione così com'è. Vi sposta nel ramo e preserva l'originale, al quale potete tornare con `/resume`. Per eseguire una copia come [sessione in background](/docs/it/agent-view) separata invece di spostarvi in essa, usate `/fork`; per affidare un'attività laterale a un [subagent](/docs/it/sub-agents) che riporta di nuovo in questa conversazione, usate `/subtask` |65| `/branch [name]` | Creare un ramo della conversazione corrente a questo punto, in modo da poter provare una direzione diversa senza perdere la conversazione così com'è. Vi sposta nel ramo e preserva l'originale, al quale potete tornare con `/resume`. Per eseguire una copia come una [sessione background](/docs/it/agent-view) separata invece di spostarvi in essa, usate `/fork`; per affidare un'attività laterale a un [subagent](/docs/it/sub-agents) che riferisce di nuovo in questa conversazione, usate `/subtask` |

66| `/btw [question]` | Fare una [domanda laterale](/docs/it/interactive-mode#side-questions-with-%2Fbtw) sulla sessione corrente senza aggiungerla alla conversazione. Se eseguite `/btw` senza una domanda, Claude Code mostra la vostra domanda laterale più recente in modo da poter sfogliare le risposte precedenti; se non ne avete ancora fatta una, Claude Code stampa una riga di utilizzo. Prima della v2.1.212, `/btw` richiedeva una domanda |66| `/btw [question]` | Fare una [domanda laterale](/docs/it/interactive-mode#side-questions-with-%2Fbtw) sulla sessione corrente senza aggiungerla alla conversazione. Se eseguite `/btw` senza una domanda, Claude Code mostra la vostra domanda laterale più recente in modo da poter sfogliare le risposte precedenti; se non ne avete ancora fatta una, Claude Code stampa una riga di utilizzo. Prima della v2.1.212, `/btw` richiedeva una domanda |

67| `/bug [report]` | Segnalare un bug o condividere la vostra conversazione. Scegliete quanta cronologia della sessione includere e confermate su una schermata di consenso prima che qualsiasi cosa venga inviata. Quando siete connessi ad Anthropic su una connessione di prima parte, il rapporto va ad Anthropic; su un provider di terze parti, o senza credenziali Anthropic, Claude Code scrive il rapporto in un [archivio locale sotto `~/.claude/feedback-bundles/`](/docs/it/data-usage#telemetry-services) che inoltrate voi stessi. Nell'[estensione VS Code](/docs/it/vs-code#use-the-prompt-box), `/bug` apre invece la finestra di dialogo di feedback dell'estensione; richiede Claude Code v2.1.229 o successivo. Quando lo eseguite mentre Claude sta rispondendo, Claude Code apre la finestra di dialogo immediatamente. Prima della v2.1.232, Claude Code metteva in coda il comando fino al termine del turno. Alias: `/share`. Prima della v2.1.212, `/bug` e `/share` erano alias di `/feedback` |67| `/bug [report]` | Segnalare un bug o condividere la vostra conversazione. Scegliete quanto storico della sessione includere e confermate su una schermata di consenso prima che qualsiasi cosa venga inviata. Quando siete connessi ad Anthropic su una connessione di prima parte, il rapporto va ad Anthropic; su un provider di terze parti, o senza credenziali Anthropic, Claude Code scrive il rapporto in un [archivio locale sotto `~/.claude/feedback-bundles/`](/docs/it/data-usage#telemetry-services) che inoltrate voi stessi. Nell'[estensione VS Code](/docs/it/vs-code#use-the-prompt-box), `/bug` apre invece la finestra di dialogo di feedback dell'estensione; richiede Claude Code v2.1.229 o successivo. Quando lo eseguite mentre Claude sta rispondendo, Claude Code apre la finestra di dialogo immediatamente. Prima della v2.1.232, Claude Code metteva in coda il comando fino al termine del turno. Alias: `/share`. Prima della v2.1.212, `/bug` e `/share` erano alias di `/feedback` |

68| `/cd <path>` | Spostare questa sessione in una nuova directory di lavoro, mantenendo la conversazione. Digitate un percorso parziale per vedere i suggerimenti di directory corrispondenti; premete `Tab` per accettarne uno. I suggerimenti richiedono Claude Code v2.1.206 o successivo. Per quello che Claude Code applica dalla nuova directory non appena vi spostate, e come `/cd` differisce da `/add-dir`, consultate [Spostare la sessione in un'altra directory](/docs/it/permissions#move-the-session-to-another-directory) |68| `/cd <path>` | Spostare questa sessione in una nuova directory di lavoro, mantenendo la conversazione. Digitate un percorso parziale per vedere i suggerimenti di directory corrispondenti; premete `Tab` per accettarne uno. I suggerimenti richiedono Claude Code v2.1.206 o successivo. Per ciò che Claude Code applica dalla nuova directory non appena vi spostate, e come `/cd` differisce da `/add-dir`, consultate [Spostare la sessione in un'altra directory](/docs/it/permissions#move-the-session-to-another-directory) |

69| `/chrome` | Configurare le impostazioni di [Claude in Chrome](/docs/it/chrome) |69| `/chrome` | Configurare le impostazioni di [Claude in Chrome](/docs/it/chrome) |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/it/skills#bundled-skills).** Caricare il materiale di riferimento di [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) per il linguaggio del vostro progetto. Si attiva anche automaticamente quando il vostro codice importa `anthropic` o `@anthropic-ai/sdk`. Eseguite `migrate` per aggiornare il codice Claude API esistente a un modello più recente. Eseguite `upgrade` per spostare la dipendenza Anthropic SDK del vostro progetto attraverso una versione principale, attualmente il pacchetto Python `anthropic` da 0.x a 1.x. Eseguite `managed-agents-onboard` per una procedura guidata che crea un nuovo Managed Agent. Eseguite `prompt-audit` per contrassegnare le istruzioni scritte per modelli più vecchi nei vostri prompt, skill e descrizioni di strumenti e proporre correzioni come diff. Eseguite `cost-optimize` per profilare dove va la spesa Claude API del vostro progetto e proporre risparmi da opzioni come prompt caching, riduzione di token di input e output non necessari, elaborazione batch, sforzo e scelta del modello, una modifica alla volta. Eseguite `build-eval` per costruire un set di eval per la vostra app basata su Claude, e `hillclimb` per migliorare iterativamente l'app rispetto a un eval esistente. Il sottocomando `prompt-audit` richiede Claude Code v2.1.221 o successivo, `upgrade` richiede v2.1.236 o successivo, `cost-optimize` richiede v2.1.247 o successivo, e `build-eval` e `hillclimb` richiedono v2.1.259 o successivo |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/it/skills#bundled-skills).** Caricare il materiale di riferimento di [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) per il linguaggio del vostro progetto. Si attiva anche automaticamente quando il vostro codice importa `anthropic` o `@anthropic-ai/sdk`. Eseguite `migrate` per aggiornare il codice Claude API esistente a un modello più recente. Eseguite `upgrade` per spostare la dipendenza Anthropic SDK del vostro progetto attraverso una versione principale, attualmente il pacchetto Python `anthropic` da 0.x a 1.x. Eseguite `managed-agents-onboard` per una procedura guidata che crea un nuovo Managed Agent. Eseguite `prompt-audit` per contrassegnare le istruzioni scritte per modelli più vecchi nei vostri prompt, skill e descrizioni di strumenti e proporre correzioni come diff. Eseguite `cost-optimize` per profilare dove va la spesa Claude API del vostro progetto e proporre risparmi da opzioni come prompt caching, riduzione di token di input e output non necessari, elaborazione batch, sforzo e scelta del modello, una modifica alla volta. Eseguite `build-eval` per costruire un set di eval per la vostra app basata su Claude, e `hillclimb` per migliorare iterativamente l'app rispetto a un eval esistente. Il subcomando `prompt-audit` richiede Claude Code v2.1.221 o successivo, `upgrade` richiede v2.1.236 o successivo, `cost-optimize` richiede v2.1.247 o successivo, e `build-eval` e `hillclimb` richiedono v2.1.259 o successivo |

71| `/clear [name]` | Avviare una nuova conversazione con contesto vuoto. Passate un nome per etichettare la conversazione precedente nel selettore `/resume`. Per liberare contesto continuando la stessa conversazione, usate `/compact` invece. Riprendete la conversazione precedente con `/resume`, o, nello stesso processo Claude Code, ripristinatela dal [menu di rewind della voce sessione precedente](/docs/it/checkpointing#rewind-past-a-cleared-conversation). Alias: `/reset`, `/new` |71| `/clear [name]` | Avviare una nuova conversazione con contesto vuoto. Passate un nome per etichettare la conversazione precedente nel selettore `/resume`. Per liberare contesto continuando la stessa conversazione, usate `/compact` invece. Riprendete la conversazione precedente con `/resume`, o, nello stesso processo Claude Code, ripristinatela dal [menu rewind della voce sessione precedente](/docs/it/checkpointing#rewind-past-a-cleared-conversation). Alias: `/reset`, `/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/it/skills#bundled-skills).** Rivedere il diff corrente, o un numero PR, ramo o percorso che passate, per bug di correttezza. A seconda del vostro modello e livello di sforzo, la revisione copre anche opportunità di pulizia. Passate `--fix` per applicare i risultati, `--comment` per pubblicarli sulla PR GitHub o sulla merge request GitLab, o `ultra` per eseguire una profonda [revisione cloud](/docs/it/ultrareview). La pubblicazione su una merge request GitLab richiede Claude Code v2.1.257 o successivo. Con `ultra` su un target PR `github.com`, passate `--post` per preselezionare [la pubblicazione dei risultati finiti sulla PR](/docs/it/ultrareview#post-findings-to-the-pull-request) nella finestra di dialogo di avvio; `--post` richiede Claude Code v2.1.227 o successivo. Consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per i livelli di sforzo, il targeting e come si relaziona a `/simplify`. Alias: `/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/it/skills#bundled-skills).** Rivedere il diff corrente, o un numero PR, ramo o percorso che passate, per bug di correttezza. A seconda del vostro modello e livello di sforzo, la revisione copre anche opportunità di pulizia. Passate `--fix` per applicare i risultati, `--comment` per pubblicarli sulla PR GitHub o sulla richiesta di merge GitLab, o `ultra` per eseguire una [revisione cloud](/docs/it/ultrareview) profonda. La pubblicazione su una richiesta di merge GitLab richiede Claude Code v2.1.257 o successivo. Con `ultra` su un target PR `github.com`, passate `--post` per preselezionare la [pubblicazione dei risultati finiti sulla PR](/docs/it/ultrareview#post-findings-to-the-pull-request) nella finestra di dialogo di avvio; `--post` richiede Claude Code v2.1.227 o successivo. Consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per i livelli di sforzo, il targeting e come si relaziona a `/simplify`. Alias: `/review` |

73| `/color [color\|default]` | Impostare il colore della barra dei prompt per la sessione corrente. Colori disponibili: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Usate `default` per ripristinare, o eseguite senza argomento per scegliere un colore casuale. Quando [Remote Control](/docs/it/remote-control) è connesso, il colore si sincronizza con claude.ai/code. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo |73| `/color [color\|default]` | Impostare il colore della barra dei prompt per la sessione corrente. Colori disponibili: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Usate `default` per ripristinare, o eseguite senza argomento per scegliere un colore casuale. Quando [Remote Control](/docs/it/remote-control) è connesso, il colore si sincronizza con claude.ai/code. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo |

74| `/compact [instructions]` | Liberare contesto riassumendo la conversazione finora. Facoltativamente passate istruzioni di focus per il riassunto. Consultate [come la compattazione gestisce regole, skill e file di memoria](/docs/it/context-window#what-survives-compaction) |74| `/compact [instructions]` | Liberare contesto riassumendo la conversazione finora. Facoltativamente passate istruzioni di focus per il riassunto. Consultate [come la compattazione gestisce regole, skill e file di memoria](/docs/it/context-window#what-survives-compaction) |

75| `/config [key=value ...]` | Aprire l'interfaccia [Impostazioni](/docs/it/settings) per regolare tema, modello, [stile di output](/docs/it/output-styles) e altre preferenze. Passate una o più coppie `key=value` per impostare un'impostazione direttamente senza aprire l'interfaccia, ad esempio `/config thinking=false`, `/config theme=dark`, o `/config model=sonnet`. La forma `key=value` funziona anche in modalità non interattiva (`-p`) e dall'app mobile Claude tramite [Remote Control](/docs/it/remote-control). La forma `key=value` non può attivare un'impostazione che richiede la vostra conferma nel pannello, come [`autoContinueAtUsageLimit`](/docs/it/interactive-mode#turn-automatic-continue-off), anche se può disattivarla. Eseguite `/config --help` per elencare le chiavi che accetta. Alias: `/settings` |75| `/config [key=value ...]` | Aprire l'interfaccia [Impostazioni](/docs/it/settings) per regolare tema, modello, [stile di output](/docs/it/output-styles) e altre preferenze. Passate una o più coppie `key=value` per impostare un'impostazione direttamente senza aprire l'interfaccia, ad esempio `/config thinking=false`, `/config theme=dark`, o `/config model=sonnet`. La forma `key=value` funziona anche in modalità non interattiva (`-p`) e dall'app mobile Claude tramite [Remote Control](/docs/it/remote-control). La forma `key=value` non può attivare un'impostazione che richiede la vostra conferma nel pannello, come [`autoContinueAtUsageLimit`](/docs/it/interactive-mode#turn-automatic-continue-off), anche se può disattivarla. Eseguite `/config --help` per elencare le chiavi che accetta. Alias: `/settings` |

76| `/context [all]` | Visualizzare l'utilizzo del contesto corrente come una griglia colorata. Mostra suggerimenti di ottimizzazione per strumenti pesanti di contesto, gonfiore della memoria e avvisi di capacità. Quando la conversazione supera la finestra di contesto, l'output include un [avviso](/docs/it/errors#context-exceeds-the-token-limit) che mostra quanto siete oltre il limite e quale comando libera spazio. In [modalità schermo intero](/docs/it/fullscreen), `/context` comprime il breakdown per elemento per mantenere la griglia visibile. Passate `all` per espanderla |76| `/context [all]` | Visualizzare l'utilizzo del contesto corrente come una griglia colorata. Mostra suggerimenti di ottimizzazione per strumenti pesanti di contesto, gonfiore della memoria e avvisi di capacità. Quando la conversazione supera la finestra di contesto, l'output include un [avviso](/docs/it/errors#context-exceeds-the-token-limit) che mostra quanto siete oltre il limite e quale comando libera spazio. In [modalità fullscreen](/docs/it/fullscreen), `/context` comprime il breakdown per elemento per mantenere la griglia visibile. Passate `all` per espanderla |

77| `/copy [N]` | Copiare l'ultima risposta dell'assistente negli appunti. Passate un numero `N` per copiare la N-esima risposta più recente: `/copy 2` copia la penultima. Quando sono presenti blocchi di codice, mostra un selettore interattivo per selezionare blocchi individuali o la risposta completa. Premete `w` nel selettore per scrivere la selezione in un file invece degli appunti, il che è utile su SSH |77| `/copy [N]` | Copiare l'ultima risposta dell'assistente negli appunti. Passate un numero `N` per copiare la Nesima risposta più recente: `/copy 2` copia la penultima. Quando sono presenti blocchi di codice, mostra un selettore interattivo per selezionare blocchi individuali o la risposta completa. Premete `w` nel selettore per scrivere la selezione in un file invece degli appunti, il che è utile su SSH |

78| `/cost` | Alias per `/usage` |78| `/cost` | Alias per `/usage` |

79| `/dataviz [request]` | **[Skill](/docs/it/skills#bundled-skills).** Guida alla progettazione per grafici, grafici e dashboard. Claude sceglie la forma del grafico per i dati, assegna il colore per ruolo, convalida la tavolozza per la sicurezza daltonismo e il contrasto con uno script in bundle, e applica regole di marchio, interazione e accessibilità. Utilizza una tavolozza segnaposto neutrale dal punto di vista del marchio che sostituite con la vostra. Richiede Claude Code v2.1.198 o successivo |79| `/dataviz [request]` | **[Skill](/docs/it/skills#bundled-skills).** Guida alla progettazione per grafici, grafici e dashboard. Claude sceglie la forma del grafico per i dati, assegna il colore per ruolo, convalida la tavolozza per la sicurezza daltonismo e il contrasto con uno script in bundle, e applica regole di mark, interazione e accessibilità. Utilizza una tavolozza segnaposto neutrale dal punto di vista del marchio che voi sostituite con la vostra. Richiede Claude Code v2.1.198 o successivo |

80| `/debug [description]` | **[Skill](/docs/it/skills#bundled-skills).** Abilitare la registrazione di debug per la sessione corrente e risolvere i problemi leggendo il log di debug della sessione. La registrazione di debug è disattivata per impostazione predefinita a meno che non abbiate avviato con `claude --debug`, quindi l'esecuzione di `/debug` a metà sessione inizia a catturare i log da quel momento in poi. Facoltativamente descrivete il problema per focalizzare l'analisi |80| `/debug [description]` | **[Skill](/docs/it/skills#bundled-skills).** Abilitare la registrazione di debug per la sessione corrente e risolvere i problemi leggendo il log di debug della sessione. La registrazione di debug è disattivata per impostazione predefinita a meno che non abbiate avviato con `claude --debug`, quindi l'esecuzione di `/debug` a metà sessione inizia a catturare i log da quel momento in poi. Facoltativamente descrivete il problema per focalizzare l'analisi |

81| `/deep-research <question>` | **[Workflow](/docs/it/workflows#bundled-workflows).** Distribuire ricerche web su una domanda, recuperare e controllare incrociato le fonti e sintetizzare un rapporto citato |81| `/deep-research <question>` | **[Workflow](/docs/it/workflows#bundled-workflows).** Distribuire ricerche web su una domanda, recuperare e controllare incrociato le fonti, e sintetizzare un rapporto citato |

82| `/design [brief]` | **[Skill](/docs/it/skills#bundled-skills).** Bozza di mockup UI, flussi di schermata, pagine di destinazione o poster come tavole su una tela, pubblicati come [artifact](/docs/it/artifacts#draft-a-design-canvas) di Design, ad esempio `/design a settings screen for a mobile banking app`. Modificate le tavole in un browser desktop e i vostri modifica si salvano automaticamente. Potete esportare ogni tavola come PNG o PDF. Richiede una sessione dove gli [artifact sono disponibili](/docs/it/artifacts#availability) e Claude Code v2.1.265 o successivo. Disponibile sull'API Anthropic. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform su AWS, gli artifact non sono disponibili, quindi il comando non è disponibile lì |82| `/design [brief]` | **[Skill](/docs/it/skills#bundled-skills).** Bozza di mockup UI, flussi di schermata, pagine di destinazione o poster come artboard su una tela, pubblicati come un [artifact](/docs/it/artifacts#draft-a-design-canvas) Design, ad esempio `/design a settings screen for a mobile banking app`. Modificate gli artboard in un browser desktop e le vostre modifiche si salvano automaticamente. Potete esportare ogni artboard come PNG o PDF. Richiede Claude Code v2.1.265 o successivo, una sessione dove gli [artifact sono disponibili](/docs/it/artifacts#availability), e un account dove il [template Design è disponibile](/docs/it/artifacts#start-from-a-slides-design-or-docs-template); se la vostra organizzazione ha disattivato quel template, `/design` non fa bozze di design. Disponibile sull'API Anthropic. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform su AWS, gli artifact non sono disponibili, quindi il comando non è disponibile lì |

83| `/design-login` | Autorizzare l'accesso al sistema di progettazione per `/design-sync` con il vostro account claude.ai |83| `/design-login` | Autorizzare l'accesso al sistema di progettazione per `/design-sync` con il vostro account claude.ai |

84| `/design-sync [hint]` | **[Skill](/docs/it/skills#bundled-skills).** Convertire il sistema di progettazione React del vostro repo e caricarlo su [Claude Design](https://claude.ai/design), in modo che i progetti che produce utilizzino i vostri componenti reali. Facoltativamente nominate il sistema di progettazione, ad esempio `/design-sync Acme DS`. Una sincronizzazione per la prima volta verifica ogni componente e può richiedere alcune ore su un grande repo. Disponibile sull'API Anthropic. Ha bisogno di claude.ai, che la CLI non contatta su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o Claude Platform su AWS, o attraverso un [gateway di app Claude](/docs/it/claude-apps-gateway#availability-and-limitations), quindi il comando non è disponibile lì |84| `/design-sync [hint]` | **[Skill](/docs/it/skills#bundled-skills).** Convertire il sistema di progettazione React del vostro repo e caricarlo su [Claude Design](https://claude.ai/design), in modo che i progetti che produce utilizzino i vostri componenti reali. Facoltativamente nominate il sistema di progettazione, ad esempio `/design-sync Acme DS`. Una sincronizzazione per la prima volta verifica ogni componente e può richiedere alcune ore su un repository di grandi dimensioni. Disponibile sull'API Anthropic. Ha bisogno di claude.ai, che la CLI non contatta su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o Claude Platform su AWS, o attraverso un [gateway app Claude](/docs/it/claude-apps-gateway#availability-and-limitations), quindi il comando non è disponibile lì |

85| `/desktop` | Continuare la sessione corrente nell'app Claude Code Desktop. Richiede macOS o Windows x64 e un abbonamento Claude. Alias: `/app` |85| `/desktop` | Continuare la sessione corrente nell'app Claude Code Desktop. Richiede macOS o Windows x64 e un abbonamento Claude. Alias: `/app` |

86| `/diff` | Rivedere le modifiche nel vostro albero di lavoro, inclusi i modifica che Claude ha fatto finora. Consultate [Rivedere le modifiche con /diff](/docs/it/interactive-mode#review-changes-with-%2Fdiff) |86| `/diff` | Rivedere i cambiamenti nel vostro albero di lavoro, incluse le modifiche che Claude ha fatto finora. Consultate [Rivedere i cambiamenti con /diff](/docs/it/interactive-mode#review-changes-with-%2Fdiff) |

87| `/doctor` | **[Skill](/docs/it/skills#bundled-skills).** Eseguire un controllo di configurazione che diagnostica i problemi e può risolverli. Controlla la salute dell'installazione, incluse installazioni duplicate o rimaste, problemi di `PATH` e file di impostazioni non analizzabili. Trova skill inutilizzate, server MCP e plugin rispetto al loro costo di contesto, contrassegna [hook](/docs/it/hooks) lenti e controlla una versione più recente sul vostro [canale di rilascio](/docs/it/setup#configure-release-channel). Deduplica i file `CLAUDE.md` locali rispetto a quelli archiviati, taglia i file [`CLAUDE.md`](/docs/it/memory#my-claude-md-is-too-large) archiviati tagliando il contenuto che Claude potrebbe derivare dal codebase, e migra la guida sempre caricata che rimane in [skill](/docs/it/skills) e file `CLAUDE.md` annidati che si caricano su richiesta. Offre anche di rendere [auto mode](/docs/it/permissions#permission-modes) il vostro predefinito e di [pre-approvare](/docs/it/permissions) comandi di sola lettura frequentemente negati. Segnala i risultati per primo e chiede conferma prima di cambiare qualsiasi cosa. Dal terminale, `claude doctor` stampa diagnostica di installazione di sola lettura senza avviare una sessione. Alias: `/checkup`. Il controllo di ridimensionamento `CLAUDE.md` richiede Claude Code v2.1.206 o successivo. Prima della v2.1.205, `/doctor` apriva una schermata di diagnostica di sola lettura e premere `f` inviava il rapporto a Claude |87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/it/skills#bundled-skills).** Eseguire un controllo di configurazione che diagnostica i problemi e può risolverli. Controlla la salute dell'installazione, incluse installazioni duplicate o rimaste, problemi di `PATH` e file di impostazioni non analizzabili. Trova skill inutilizzate, server MCP e plugin rispetto al loro costo di contesto, contrassegna [hook](/docs/it/hooks) lenti e controlla una versione più recente sul vostro [canale di rilascio](/docs/it/setup#configure-release-channel). Deduplica i file `CLAUDE.md` locali rispetto a quelli archiviati, taglia i file [`CLAUDE.md`](/docs/it/memory#my-claude-md-is-too-large) archiviati tagliando il contenuto che Claude potrebbe derivare dal codebase, e migra la guida sempre caricata che rimane in [skill](/docs/it/skills) e file `CLAUDE.md` annidati che si caricano su richiesta. Offre anche di rendere [auto mode](/docs/it/permissions#permission-modes) il vostro predefinito e di [pre-approvare](/docs/it/permissions) comandi di sola lettura frequentemente negati. Segnala i risultati per primo e chiede conferma prima di cambiare qualsiasi cosa. Dal terminale, `claude doctor` stampa diagnostica di installazione di sola lettura senza avviare una sessione. Alias: `/checkup`. Eseguite `/doctor prompt-audit` per fare in modo che Claude [auditi i vostri file `CLAUDE.md`, skill e altre configurazioni](/docs/it/memory#write-effective-instructions) per istruzioni obsolete o conflittuali invece di eseguire il controllo. Il subcomando `prompt-audit` richiede Claude Code v2.1.283 o successivo. Il controllo di ridimensionamento `CLAUDE.md` richiede Claude Code v2.1.206 o successivo. Prima della v2.1.205, `/doctor` apriva una schermata di diagnostica di sola lettura e premere `f` inviava il rapporto a Claude |

88| `/effort [level\|auto\|status]` | Impostare il [livello di sforzo](/docs/it/model-config#adjust-effort-level): `low` a `xhigh`, `max`, [`ultracode`](/docs/it/workflows#let-claude-decide-with-ultracode), o `auto`; `status` lo stampa. `max` e `ultracode` sono solo per sessione; la chiave [`ultracode`](/docs/it/settings-reference#ultracode) persiste. Eseguitelo mentre Claude sta rispondendo e, una volta confermato l'[avviso di cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla prossima richiesta in quel turno. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Funziona in `-p` |88| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Impostare il [livello di sforzo](/docs/it/model-config#adjust-effort-level): da `low` a `xhigh`, `max`, o `auto`; `status` lo stampa. `ultracode` o `ultracode on` attiva [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) per la sessione al livello corrente, e `ultracode off` lo disattiva; la chiave [`ultracode`](/docs/it/settings-reference#ultracode) persiste. `max` è solo per sessione. Gli argomenti `on` e `off` e il mantenimento del livello corrente richiedono Claude Code v2.1.284 o successivo. Prima della v2.1.284, `/effort ultracode` impostava la sessione a `xhigh`, e `/effort ultracode off` falliva con `Invalid argument`. Eseguitelo mentre Claude sta rispondendo e, una volta confermato l'[avviso di cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla prossima richiesta in quel turno. Prima della v2.1.242, Claude Code decideva da un flag di funzionalità che recuperava da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo metteva sempre in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Funziona in `-p` |

~~89| `/exit` | Uscire dalla CLI. In una [sessione in background](/docs/it/agent-view#attach-to-a-session) allegata, questo stacca e la sessione continua a funzionare. Alias: `/quit` |~~89| `/exit` | Uscire dalla CLI. In una [sessione background](/docs/it/agent-view#attach-to-a-session) allegata, questo stacca e la sessione continua a funzionare. Alias: `/quit` |

90| `/export [filename]` | Esportare la conversazione corrente come testo semplice. Con un nome file, scrive direttamente in quel file. Senza, apre una finestra di dialogo per copiare negli appunti o salvare in un file |90| `/export [filename]` | Esportare la conversazione corrente come testo semplice. Con un nome file, scrive direttamente in quel file. Senza, apre una finestra di dialogo per copiare negli appunti o salvare in un file |

91| `/fast [on\|off]` | Attivare o disattivare la [modalità veloce](/docs/it/fast-mode). Eseguitelo mentre Claude sta rispondendo e Claude Code attiva la modalità veloce senza aspettare che il turno finisca, anche se il turno in esecuzione finisce alla sua velocità originale. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). La disponibilità in modalità non interattiva con `-p` è limitata; consultate [Attivare la modalità veloce](/docs/it/fast-mode#toggle-fast-mode). Richiede Claude Code v2.1.205 o successivo |91| `/fast [on\|off]` | Attivare o disattivare la [modalità veloce](/docs/it/fast-mode). Eseguitelo mentre Claude sta rispondendo e Claude Code attiva/disattiva la modalità veloce senza aspettare il termine del turno, anche se il turno in esecuzione finisce alla sua velocità originale. Prima della v2.1.242, Claude Code decideva da un flag di funzionalità che recuperava da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo metteva sempre in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). La disponibilità in modalità non interattiva con `-p` è limitata; consultate [Attivare/disattivare la modalità veloce](/docs/it/fast-mode#toggle-fast-mode). Richiede Claude Code v2.1.205 o successivo |

92| `/feedback [report]` | Inviare feedback sui prodotti su Claude Code. Apre la stessa finestra di dialogo di [`/bug`](#all-commands), con lo stesso passaggio di consenso, regole di invio e comportamento a metà turno. In sessioni con [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), `/feedback` senza argomento apre invece la coda di bozze, dove rivedete, modificate, inviate o scartate le bozze che Claude ha messo in coda; la coda include un'opzione per scrivere un nuovo rapporto nella finestra di dialogo. Con un argomento, e per `/bug` sempre, la finestra di dialogo si apre direttamente |92| `/feedback [report]` | Inviare feedback sui prodotti su Claude Code. Apre la stessa finestra di dialogo di [`/bug`](#all-commands), con lo stesso passaggio di consenso, regole di invio e comportamento a metà turno. In sessioni con [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), `/feedback` senza argomento apre invece la coda di bozze, dove rivedete, modificate, inviate o scartate le bozze che Claude ha messo in coda; la coda include un'opzione per scrivere un nuovo rapporto nella finestra di dialogo. Con un argomento, e per `/bug` sempre, la finestra di dialogo si apre direttamente |

93| `/fewer-permission-prompts` | **[Skill](/docs/it/skills#bundled-skills).** Scansionare i vostri trascritti per comuni chiamate di strumenti Bash e MCP di sola lettura, quindi aggiungere un elenco di autorizzazione prioritario al progetto `.claude/settings.json` per ridurre i prompt di autorizzazione |93| `/fewer-permission-prompts` | **[Skill](/docs/it/skills#bundled-skills).** Scansionare i vostri trascritti per comuni chiamate di strumenti Bash e MCP di sola lettura, quindi aggiungere un elenco di autorizzazioni prioritizzato al progetto `.claude/settings.json` per ridurre i prompt di autorizzazione |

94| `/focus` | Attivare la vista focus, che mostra solo il vostro ultimo prompt, un riassunto di una riga della chiamata di strumento con diffstat di modifica, e la risposta finale. Il riassunto della chiamata di strumento conta anche i subagent lanciati nel turno e comprime le notifiche di attività in background completate in un singolo conteggio. La selezione persiste tra le sessioni; impostare [`viewMode`](/docs/it/settings-reference#viewmode) nelle impostazioni per sostituirla. Disponibile solo nel [rendering schermo intero](/docs/it/fullscreen). L'[estensione VS Code](/docs/it/vs-code#use-the-prompt-box) offre la sua propria vista Focus come interruttore del menu di comando, archiviata come impostazione dell'estensione, indipendente da `viewMode` |94| `/focus` | Attivare/disattivare la vista focus, che mostra solo il vostro ultimo prompt, un riassunto di una riga della chiamata di strumento con diffstat di modifica, e la risposta finale. Il riassunto della chiamata di strumento conta anche i subagent lanciati nel turno e comprime le notifiche di attività background completate in un singolo conteggio. La selezione persiste tra le sessioni; impostare [`viewMode`](/docs/it/settings-reference#viewmode) nelle impostazioni per sostituirla. Disponibile solo nel [rendering fullscreen](/docs/it/fullscreen). L'[estensione VS Code](/docs/it/vs-code#use-the-prompt-box) offre la sua propria vista Focus come un toggle del menu dei comandi, archiviata come impostazione dell'estensione, indipendente da `viewMode` |

95| `/fork [prompt]` | [Copiare la conversazione corrente](/docs/it/agent-view#copy-the-session-with-%2Ffork) in una nuova sessione in background e continuare a lavorare qui. Passate un prompt e la copia inizia a lavorarvi immediatamente; senza uno aspetta in agent view per il suo primo prompt. Tranne quando la copia [modifica in place](/docs/it/agent-view#how-file-edits-are-isolated), Claude Code le istruisce di creare un worktree proprio prima di apportare modifiche al codice; l'istruzione di isolamento richiede Claude Code v2.1.221 o successivo. Per affidare un'attività laterale a un subagent il cui risultato torna in questa conversazione, usate `/subtask`; per spostarvi in una copia voi stessi, usate `/branch`. Richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211, e ogni volta che [agent view è disattivato](/docs/it/agent-view#turn-off-agent-view), `/fork` avvia un [subagent con fork](/docs/it/sub-agents#fork-the-current-conversation) invece |95| `/fork [prompt]` | [Copiare la conversazione corrente](/docs/it/agent-view#copy-the-session-with-%2Ffork) in una nuova sessione background e continuare a lavorare qui. Passate un prompt e la copia inizia a lavorarvi immediatamente; senza uno aspetta in agent view per il suo primo prompt. Tranne quando la copia [modifica in place](/docs/it/agent-view#how-file-edits-are-isolated), Claude Code le istruisce di creare un worktree proprio prima di apportare modifiche al codice; l'istruzione di isolamento richiede Claude Code v2.1.221 o successivo. Per affidare un'attività laterale a un subagent il cui risultato torna in questa conversazione, usate `/subtask`; per spostarvi in una copia voi stessi, usate `/branch`. Richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211, e ogni volta che [agent view è disattivato](/docs/it/agent-view#turn-off-agent-view), `/fork` avvia un [subagent con fork](/docs/it/sub-agents#fork-the-current-conversation) invece |

96| `/goal [condition\|clear]` | Impostare un [obiettivo](/docs/it/goal): Claude continua a lavorare tra i turni finché la condizione non è soddisfatta o l'obiettivo [si cancella per un altro motivo](/docs/it/goal#how-evaluation-works). Senza argomento, mostra l'obiettivo corrente o più recentemente raggiunto. `clear`, `stop`, `off`, `reset`, `none`, o `cancel` rimuove un obiettivo attivo in anticipo |96| `/goal [condition\|clear]` | Impostare un [goal](/docs/it/goal): Claude continua a lavorare tra i turni finché la condizione non è soddisfatta o il goal [si cancella per un altro motivo](/docs/it/goal#how-evaluation-works). Senza argomento, mostra il goal corrente o più recentemente raggiunto. `clear`, `stop`, `off`, `reset`, `none`, o `cancel` rimuove un goal attivo in anticipo |

97| `/heapdump` | Scrivere uno snapshot heap JavaScript e un breakdown della memoria su `~/Desktop`, o la vostra home directory su Linux senza una cartella Desktop, per diagnosticare un utilizzo elevato della memoria. Allegate solo il file `-diagnostics.json` quando segnalate un problema di memoria; il `.heapsnapshot` contiene la vostra conversazione completa e le credenziali, quindi non condividetelo. [Nascosto dal menu dei comandi](#how-the-command-menu-matches-what-you-type); digitate per intero. Consultate [cosa fare con l'output](/docs/it/troubleshooting#high-cpu-or-memory-usage) |97| `/heapdump` | Scrivere uno snapshot heap JavaScript e un breakdown della memoria su `~/Desktop`, o la vostra home directory su Linux senza una cartella Desktop, per diagnosticare un utilizzo elevato della memoria. Allegate solo il file `-diagnostics.json` quando segnalate un problema di memoria; il `.heapsnapshot` contiene la vostra conversazione completa e le credenziali, quindi non condividetelo. [Nascosto dal menu dei comandi](#how-the-command-menu-matches-what-you-type); digitate per intero. Consultate [cosa fare con l'output](/docs/it/troubleshooting#high-cpu-or-memory-usage) |

98| `/help` | Mostrare la guida e i comandi disponibili |98| `/help` | Mostrare la guida e i comandi disponibili |

99| `/hooks` | Visualizzare le configurazioni [hook](/docs/it/hooks) per gli eventi degli strumenti |99| `/hooks` | Visualizzare le configurazioni [hook](/docs/it/hooks) per gli eventi degli strumenti |

100| `/ide` | Gestire le integrazioni IDE e mostrare lo stato |100| `/ide` | Gestire le integrazioni IDE e mostrare lo stato |

101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Portare la configurazione da OpenAI Codex, Google Gemini CLI, o Cursor sulla vostra macchina in Claude Code, inclusi file di istruzioni, server MCP, comandi, subagent e skill. In [modalità non interattiva](/docs/it/headless) con `-p`, `/import` elenca quello che ha trovato e vi dà il comando che conferma l'importazione. Aggiungete `--dry-run` per visualizzare in anteprima senza scrivere nulla, o `--yes` per saltare il selettore interattivo. Non disponibile su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o Claude Platform su AWS, o attraverso un [gateway di app Claude](/docs/it/claude-apps-gateway#availability-and-limitations). Anche non disponibile quando disattivate il [recupero di flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). Richiede Claude Code v2.1.213 o successivo. L'importazione da Cursor richiede v2.1.265 o successivo |101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Portare la configurazione da OpenAI Codex, Google Gemini CLI, o Cursor sulla vostra macchina in Claude Code, inclusi file di istruzioni, server MCP, comandi, subagent e skill. In [modalità non interattiva](/docs/it/headless) con `-p`, `/import` elenca ciò che ha trovato e vi dà il comando che conferma l'importazione. Aggiungete `--dry-run` per visualizzare in anteprima senza scrivere nulla, o `--yes` per saltare il selettore interattivo. Non disponibile su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o Claude Platform su AWS, o attraverso un [gateway app Claude](/docs/it/claude-apps-gateway#availability-and-limitations). Anche non disponibile quando disattivate il [recupero di flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). Richiede Claude Code v2.1.213 o successivo. L'importazione da Cursor richiede v2.1.265 o successivo |

102| `/init` | Inizializzare il progetto con una guida `CLAUDE.md`. Impostare `CLAUDE_CODE_NEW_INIT=1` per un flusso interattivo che guida anche attraverso skill, hook e file di memoria personale. Se `/init` trova la configurazione da OpenAI Codex o Google Gemini CLI, offre di trasferirla con `/import` |102| `/init` | Inizializzare il progetto con una guida `CLAUDE.md`. Impostare `CLAUDE_CODE_NEW_INIT=1` per un flusso interattivo che guida anche attraverso skill, hook e file di memoria personale. Se `/init` trova la configurazione di OpenAI Codex o Google Gemini CLI, offre di portarla con `/import` |

103| `/insights` | Generare un rapporto HTML che analizza le vostre sessioni recenti su questa macchina: quali progetti in cui lavorate, come usate Claude Code, dove le cose vanno male e funzionalità da provare. Non disponibile in [sessioni cloud](/docs/it/claude-code-on-the-web). Consultate [Analizzare i vostri modelli di utilizzo](/docs/it/costs#analyze-your-usage-patterns) per la posizione del rapporto, la conservazione e il costo |103| `/insights` | Generare un rapporto HTML che analizza le vostre sessioni recenti su questa macchina: quali progetti in cui lavorate, come usate Claude Code, dove le cose vanno male e funzionalità da provare. Non disponibile in [sessioni cloud](/docs/it/claude-code-on-the-web). Consultate [Analizzare i vostri modelli di utilizzo](/docs/it/costs#analyze-your-usage-patterns) per la posizione del rapporto, la conservazione e il costo |

104| `/install-github-app` | Installare l'app Claude GitHub per un repository, con un passaggio facoltativo per configurare i flussi di lavoro [GitHub Actions](/docs/it/github-actions) e i segreti. Vi guida attraverso la selezione di un repo e la configurazione dell'integrazione. Funziona solo con repository github.com. Quando il git remote del vostro repository è su gitlab.com o bitbucket.org, il comando stampa un avviso ed esce invece di avviare la configurazione. Per eseguire Claude Code dalle pipeline GitLab, consultate [GitLab CI/CD](/docs/it/gitlab-ci-cd) |104| `/install-github-app` | Installare l'app Claude GitHub per un repository, con un passaggio facoltativo per configurare i flussi di lavoro [GitHub Actions](/docs/it/github-actions) e i segreti. Vi guida attraverso la selezione di un repo e la configurazione dell'integrazione. Funziona solo con repository github.com. Quando il git remote del vostro repository è su gitlab.com o bitbucket.org, il comando stampa un avviso ed esce invece di avviare la configurazione. Per eseguire Claude Code da pipeline GitLab, consultate [GitLab CI/CD](/docs/it/gitlab-ci-cd) |

107| `/list-agents` | Elencare i subagent, i compagni di [team di agenti](/docs/it/agent-teams) e altre sessioni Claude Code che Claude può contattare, con il nome da usare per ciascuno. Consultate [messaggistica tra sessioni](/docs/it/cross-session-messaging). Disponibile anche come `/peers`. Richiede Claude Code v2.1.224 o successivo; le versioni precedenti segnalano `Unknown command: /list-agents`. Le righe dei compagni di team e la prima riga che mostra il nome di questa sessione richiedono v2.1.239 o successivo. Disponibile solo in sessioni dove la [messaggistica tra sessioni è abilitata](/docs/it/cross-session-messaging#availability) |107| `/list-agents` | Elencare i subagent, i compagni di [team di agenti](/docs/it/agent-teams) e altre sessioni Claude Code che Claude può contattare, con il nome da usare per ciascuno. Consultate [messaggistica tra sessioni](/docs/it/cross-session-messaging). Disponibile anche come `/peers`. Richiede Claude Code v2.1.224 o successivo; le versioni precedenti segnalano `Unknown command: /list-agents`. Le righe dei compagni di team e la prima riga che mostra il nome della sessione richiedono v2.1.239 o successivo. Disponibile solo in sessioni dove la [messaggistica tra sessioni è abilitata](/docs/it/cross-session-messaging#availability) |

110| `/loop [interval] [prompt]` | **[Skill](/docs/it/skills#bundled-skills).** Eseguire un prompt ripetutamente mentre la sessione rimane aperta. Omettete l'intervallo e Claude [si auto-paced tra le iterazioni](/docs/it/scheduled-tasks#let-claude-choose-the-interval). Omettete il prompt e Claude esegue il [prompt di manutenzione integrato](/docs/it/scheduled-tasks#run-the-built-in-maintenance-prompt) o il vostro [`loop.md`](/docs/it/scheduled-tasks#customize-the-default-prompt-with-loop-md). Esempio: `/loop 5m check if the deploy finished`. Consultate [Eseguire prompt su un programma](/docs/it/scheduled-tasks). Alias: `/proactive` |110| `/loop [interval] [prompt]` | **[Skill](/docs/it/skills#bundled-skills).** Eseguire un prompt ripetutamente mentre la sessione rimane aperta. Omettete l'intervallo e Claude [si auto-paced tra le iterazioni](/docs/it/scheduled-tasks#let-claude-choose-the-interval). Omettete il prompt e Claude esegue il [prompt di manutenzione integrato](/docs/it/scheduled-tasks#run-the-built-in-maintenance-prompt) o il vostro [`loop.md`](/docs/it/scheduled-tasks#customize-the-default-prompt-with-loop-md). Esempio: `/loop 5m check if the deploy finished`. Consultate [Eseguire prompt su un programma](/docs/it/scheduled-tasks). Alias: `/proactive` |

111| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gestire le connessioni del server MCP e l'autenticazione OAuth. Eseguite senza argomento per aprire l'elenco interattivo, passate `reconnect <server>` per riconnettere un server disconnesso, o passate `enable`/`disable` con un nome di server o `all` per cambiare lo stato di connessione senza aprire la finestra di dialogo. Disponibile anche in modalità non interattiva (`-p`), dove eseguirlo senza argomento stampa un riassunto di testo dello stato del server invece di aprire l'elenco; richiede Claude Code v2.1.205 o successivo |111| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gestire le connessioni del server MCP e l'autenticazione OAuth. Eseguite senza argomento per aprire l'elenco interattivo, passate `reconnect <server>` per riconnettere un server disconnesso, o passate `enable`/`disable` con un nome di server o `all` per cambiare lo stato di connessione senza aprire la finestra di dialogo. Disponibile anche in modalità non interattiva (`-p`), dove eseguirlo senza argomento stampa un riassunto di testo dello stato del server invece di aprire l'elenco; richiede Claude Code v2.1.205 o successivo |

112| `/memory` | Modificare i file `CLAUDE.md`, abilitare o disabilitare la [memoria automatica](/docs/it/memory#auto-memory), e visualizzare le voci di memoria automatica |112| `/memory` | Modificare i file `CLAUDE.md`, abilitare o disabilitare la [memoria automatica](/docs/it/memory#auto-memory), e visualizzare le voci di memoria automatica |

114| `/model [model]` | Cambiare il modello AI e salvarlo come predefinito per le nuove sessioni. Per i modelli che lo supportano, usate le frecce sinistra/destra per [regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level). Senza argomento, apre un selettore; premete `s` su una riga per cambiare solo per la sessione corrente. Consultate [quando Claude Code vi chiede di confermare il cambio](/docs/it/prompt-caching#switching-models). Una volta confermato il cambio, se Claude Code lo chiede, Claude Code applica il cambio senza aspettare che la risposta corrente finisca. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Disponibile anche in modalità non interattiva (`-p`) con un argomento di modello invece del selettore, dove si applica solo alla sessione corrente e non viene salvato come predefinito; richiede Claude Code v2.1.205 o successivo |114| `/model [model]` | Cambiare il modello AI e salvarlo come predefinito per le nuove sessioni. Per i modelli che lo supportano, usate le frecce sinistra/destra per [regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level). Senza argomento, apre un selettore; premete `s` su una riga per cambiare solo per la sessione corrente. Consultate [quando Claude Code vi chiede di confermare il cambio](/docs/it/prompt-caching#switching-models). Una volta confermato il cambio, se Claude Code lo chiede, Claude Code applica il cambiamento senza aspettare il termine della risposta corrente. Prima della v2.1.242, Claude Code decideva da un flag di funzionalità che recuperava da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo metteva sempre in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Disponibile anche in modalità non interattiva (`-p`) con un argomento di modello invece del selettore, dove si applica solo alla sessione corrente e non viene salvato come predefinito; richiede Claude Code v2.1.205 o successivo |

115| `/output-style [style]` | Elencare gli [stili di output](/docs/it/output-styles) o passare a uno, ad esempio `/output-style concise`. Consultate [Cambiare il vostro stile di output](/docs/it/output-styles#change-your-output-style). Richiede Claude Code v2.1.269 o successivo |115| `/output-style [style]` | Elencare gli [stili di output](/docs/it/output-styles) o passare a uno, ad esempio `/output-style concise`. Consultate [Cambiare il vostro stile di output](/docs/it/output-styles#change-your-output-style). Richiede Claude Code v2.1.269 o successivo |

116| `/passes` | Condividere una settimana gratuita di Claude Code con gli amici. Visibile solo se il vostro account è idoneo |116| `/passes` | Condividere una settimana gratuita di Claude Code con gli amici. Visibile solo se il vostro account è idoneo |

117| `/permissions` | Gestire le regole di autorizzazione, chiedi e nega per i permessi degli strumenti. Apre una finestra di dialogo interattiva dove potete visualizzare le regole per ambito, aggiungere o rimuovere regole, gestire le directory di lavoro e rivedere i [rifiuti automatici recenti](/docs/it/auto-mode-config#review-denials). Potete anche visualizzare e modificare le [regole del classificatore auto mode](/docs/it/auto-mode-config#edit-rules-from-permissions) dalla scheda **Auto mode** della finestra di dialogo. Quando lo eseguite mentre Claude sta rispondendo, Claude Code apre la finestra di dialogo immediatamente e applica i vostri cambiamenti a partire dalla prossima chiamata di strumento di Claude nello stesso turno. Prima della v2.1.234, Claude Code metteva in coda il comando fino al termine del turno. Alias: `/allowed-tools` |117| `/permissions` | Gestire le regole di autorizzazione allow, ask e deny per i permessi degli strumenti. Apre una finestra di dialogo interattiva dove potete visualizzare le regole per ambito, aggiungere o rimuovere regole, gestire directory di lavoro e rivedere i [rifiuti di auto mode recenti](/docs/it/auto-mode-config#review-denials). Potete anche visualizzare e modificare le [regole del classificatore auto mode](/docs/it/auto-mode-config#edit-rules-from-permissions) dalla scheda **Auto mode** della finestra di dialogo. Quando lo eseguite mentre Claude sta rispondendo, Claude Code apre la finestra di dialogo immediatamente e applica le vostre modifiche a partire dalla prossima chiamata di strumento di Claude nello stesso turno. Prima della v2.1.234, Claude Code metteva in coda il comando fino al termine del turno. Alias: `/allowed-tools` |

118| `/plan [description]` | Entrare direttamente in plan mode dal prompt. Passate una descrizione facoltativa per entrare in plan mode e iniziare immediatamente con quel compito, ad esempio `/plan fix the auth bug` |118| `/plan [description]` | Entrare direttamente in plan mode dal prompt. Passate una descrizione facoltativa per entrare in plan mode e iniziare immediatamente con quel compito, ad esempio `/plan fix the auth bug` |

119| `/plugin [subcommand]` | Gestire i [plugin](/docs/it/plugins/overview) di Claude Code. Eseguite senza argomento per aprire il menu dei plugin, o passate un sottocomando come `list`, `install`, `enable`, o `disable` per agire direttamente. Claude Code può attivare un plugin durante l'installazione; il [riassunto dell'installazione](/docs/it/plugins/install#install-a-plugin) vi dice se lo ha fatto o se eseguire `/reload-plugins` |119| `/plugin [subcommand]` | Gestire i [plugin](/docs/it/plugins/overview) di Claude Code. Eseguite senza argomento per aprire il menu dei plugin, o passate un subcomando come `list`, `install`, `enable`, o `disable` per agire direttamente. Claude Code può attivare un plugin durante l'installazione; il [riassunto dell'installazione](/docs/it/plugins/install#install-a-plugin) vi dice se lo ha fatto o se dovete eseguire `/reload-plugins` |

121| `/pr-comments [PR]` | Rimosso nella v2.1.91. Chiedete direttamente a Claude di visualizzare i commenti della pull request invece. Nelle versioni precedenti, recupera e visualizza i commenti da una pull request GitHub; rileva automaticamente il PR per il ramo corrente, o passate un URL o numero PR. Richiede la CLI `gh` |121| `/pr-comments [PR]` | Rimosso nella v2.1.91. Chiedete direttamente a Claude di visualizzare i commenti della richiesta di pull. Sulle versioni precedenti, recupera e visualizza i commenti da una richiesta di pull GitHub; rileva automaticamente la PR per il ramo corrente, o passate un URL o numero di PR. Richiede la CLI `gh` |

122| `/privacy-settings` | Visualizzare e aggiornare le vostre impostazioni di privacy. Disponibile solo per gli abbonati ai piani Pro e Max |122| `/privacy-settings` | Visualizzare e aggiornare le vostre impostazioni di privacy. Disponibile solo per gli abbonati ai piani Pro e Max |

123| `/radio` | Aprire Claude FM lo-fi radio nel vostro browser. Stampa l'URL del flusso quando nessun browser è disponibile |123| `/radio` | Aprire Claude FM lo-fi radio nel vostro browser. Stampa l'URL del flusso quando nessun browser è disponibile |

124| `/rate-limit-options` | Mostrare i modi per continuare a lavorare quando un limite di utilizzo claude.ai blocca una richiesta: aspettare e [continuare automaticamente quando il limite si ripristina](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset), aggiungere [crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription), o aggiornare il vostro piano. Claude Code può anche aprire questo menu autonomamente quando raggiungete un limite al vostro terminale. Consultate [Disattivare la continuazione automatica](/docs/it/interactive-mode#turn-automatic-continue-off). Richiede un abbonamento claude.ai. Non appare nel menu dei comandi; digitate per intero. Le righe di attesa e continuazione richiedono Claude Code v2.1.234 o successivo |124| `/rate-limit-options` | Mostrare i modi per continuare a lavorare quando un limite di utilizzo claude.ai blocca una richiesta: aspettare e [continuare automaticamente quando il limite si ripristina](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset), aggiungere [crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription), o aggiornare il vostro piano. Claude Code può anche aprire questo menu autonomamente quando raggiungete un limite al vostro terminale. Consultate [Disattivare la continuazione automatica](/docs/it/interactive-mode#turn-automatic-continue-off). Richiede un abbonamento claude.ai. Non appare nel menu dei comandi; digitate per intero. Le righe di attesa e continuazione richiedono Claude Code v2.1.234 o successivo |

126| `/release-notes` | Visualizzare il changelog in un selettore di versione interattivo. Selezionate una versione specifica per vedere le sue note di rilascio, o scegliete di mostrare tutte le versioni. Le note appaiono nel vostro trascritto senza entrare nella conversazione che Claude vede |126| `/release-notes` | Visualizzare il changelog in un selettore di versione interattivo. Selezionate una versione specifica per vedere le sue note di rilascio, o scegliete di mostrare tutte le versioni. Le note appaiono nel vostro trascritto senza entrare nella conversazione che Claude vede |

127| `/reload-plugins [--force]` | Ricaricare tutti i [plugin](/docs/it/plugins/overview) attivi per applicare le modifiche in sospeso senza riavviare. Segnala i conteggi per ogni componente ricaricato e contrassegna eventuali errori di caricamento. Quando il ricaricamento cambierebbe quali strumenti MCP sono caricati e invaliderebbe la cache del prompt, il comando avverte e salta a meno che non passiate `--force`. Disponibile anche in modalità non interattiva (`-p`), l'Agent SDK e l'app desktop, dove viene eseguito solo su input digitato direttamente nella sessione e non applica le modifiche del server MCP del plugin; richiede Claude Code v2.1.260 o successivo. Consultate [Applicare le modifiche del plugin senza riavviare](/docs/it/plugins/cli-reference#reload-plugins) |127| `/reload-plugins [--force]` | Ricaricare tutti i [plugin](/docs/it/plugins/overview) attivi per applicare le modifiche in sospeso senza riavviare. Segnala i conteggi per ogni componente ricaricato e contrassegna eventuali errori di caricamento. Quando il ricaricamento cambierebbe quali strumenti MCP sono caricati e invaliderebbe la cache del prompt, il comando avverte e salta a meno che non passiate `--force`. Disponibile anche in modalità non interattiva (`-p`), l'Agent SDK e l'app desktop, dove viene eseguito solo su input digitato direttamente nella sessione e non applica le modifiche del server MCP del plugin; richiede Claude Code v2.1.260 o successivo. Consultate [Applicare le modifiche del plugin senza riavviare](/docs/it/plugins/cli-reference#reload-plugins) |

128| `/reload-skills` | Scansionare di nuovo le directory [skill](/docs/it/skills) e comandi in modo che le skill aggiunte o modificate su disco durante la sessione diventino disponibili senza riavviare. Segnala quante skill sono disponibili e quante sono state aggiunte o rimosse |128| `/reload-skills` | Scansionare di nuovo le directory [skill](/docs/it/skills) e comandi in modo che le skill aggiunte o modificate su disco durante la sessione diventino disponibili senza riavviare. Segnala quante skill sono disponibili e quante sono state aggiunte o rimosse |

129| `/remote-control` | Rendere questa sessione disponibile per [Remote Control](/docs/it/remote-control) da claude.ai. Eseguirlo mentre disconnessi stampa che Remote Control richiede un abbonamento claude.ai e vi dice come accedere; prima della v2.1.206 segnalava `Unknown command: /remote-control`. Alias: `/rc` |129| `/remote-control` | Rendere questa sessione disponibile per [Remote Control](/docs/it/remote-control) da claude.ai. L'esecuzione mentre siete disconnessi stampa che Remote Control richiede un abbonamento claude.ai e vi dice come accedere; prima della v2.1.206 segnalava `Unknown command: /remote-control`. Alias: `/rc` |

130| `/remote-env` | Scegliere l'ambiente predefinito per le [sessioni cloud](/docs/it/cloud-environments#select-an-environment-from-the-cli) che avviate dalla CLI |130| `/remote-env` | Scegliere l'[ambiente cloud](/docs/it/cloud-environments#select-an-environment-from-the-cli) predefinito per le sessioni cloud che avviate dalla CLI |

131| `/rename [name]` | Rinominare la sessione corrente e mostrare il nome sulla barra dei prompt. Senza un nome, genera automaticamente uno dalla cronologia della conversazione. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo. Da ogni superficie di rinomina, inclusi claude.ai e l'app desktop, Claude Code sostituisce i caratteri di controllo e invisibili nel nuovo nome con spazi e limita il nome a 200 caratteri. Se il nome è vuoto una volta rimossi i caratteri invisibili, Claude Code lo rifiuta e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. La sostituzione dei caratteri e il limite di lunghezza richiedono Claude Code v2.1.221 o successivo. Se un'altra sessione live su questa macchina utilizza già un nome che passate, Claude Code applica [una variante di esso](/docs/it/sessions#name-your-sessions) invece |131| `/rename [name]` | Rinominare la sessione corrente e mostrare il nome sulla barra dei prompt. Senza un nome, genera automaticamente uno dalla cronologia della conversazione. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo. Da ogni superficie di rinomina, inclusi claude.ai e l'app desktop, Claude Code sostituisce i caratteri di controllo e invisibili nel nuovo nome con spazi e limita il nome a 200 caratteri. Se il nome è vuoto una volta rimossi i caratteri invisibili, Claude Code lo rifiuta e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. La sostituzione dei caratteri e il limite di lunghezza richiedono Claude Code v2.1.221 o successivo. Se un'altra sessione live su questa macchina utilizza già un nome che passate, Claude Code applica [una variante di esso](/docs/it/sessions#name-your-sessions) invece |

132| `/resume [session]` | Riprendere una conversazione per ID o nome, o aprire il selettore di sessione. Le [sessioni in background](/docs/it/agent-view) appaiono nel selettore contrassegnate con `bg`; una che è ancora in esecuzione non può essere ripresa qui, quindi collegatevi da `claude agents` o fermatela lì per primo. Alias: `/continue` |132| `/resume [session]` | Riprendere una conversazione per ID o nome, o aprire il selettore di sessione. Le [sessioni background](/docs/it/agent-view) appaiono nel selettore contrassegnate con `bg`; una che è ancora in esecuzione non può essere ripresa qui, quindi collegatevi da `claude agents` o fermatela lì per primo. Alias: `/continue` |

133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias di [`/code-review`](/docs/it/code-review#review-a-diff-locally): rivede il diff corrente, o un numero PR, ramo o percorso che passate, come `/review 1234`, e accetta gli stessi livelli di sforzo e flag. Senza un livello dato, la revisione riusa l'ultimo livello `low` attraverso `max` che avete digitato; consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per le regole esatte. Per una profonda revisione cloud, usate [`/code-review ultra`](/docs/it/ultrareview). Prima della v2.1.223, `/review` era un comando separato che eseguiva una revisione di una singola passata, di sola lettura di una pull request GitHub per numero, elencando i PR aperti da cui scegliere quando eseguito senza argomento; da v2.1.186 attraverso v2.1.201, eseguiva lo stesso motore multi-agente di `/code-review medium` |133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias di [`/code-review`](/docs/it/code-review#review-a-diff-locally): rivede il diff corrente, o un numero PR, ramo o percorso che passate, come `/review 1234`, e accetta gli stessi livelli di sforzo e flag. Senza un livello dato, la revisione riusa l'ultimo livello `low` attraverso `max` che avete digitato; consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per le regole esatte. Per una revisione cloud profonda, usate [`/code-review ultra`](/docs/it/ultrareview). Prima della v2.1.223, `/review` era un comando separato che eseguiva una revisione di una singola passata, di sola lettura di una richiesta di pull GitHub per numero, elencando le PR aperte da cui scegliere quando eseguito senza argomento; da v2.1.186 attraverso v2.1.201, eseguiva lo stesso motore multi-agente di `/code-review medium` |

134| `/rewind` | Riavvolgere la conversazione e/o il codice a un punto precedente, o riassumere da un messaggio selezionato. Consultate [checkpointing](/docs/it/checkpointing). Alias: `/checkpoint`, `/undo` |134| `/rewind` | Riavvolgere la conversazione e/o il codice a un punto precedente, o riassumere da un messaggio selezionato. Consultate [checkpointing](/docs/it/checkpointing). Alias: `/checkpoint`, `/undo` |

135| `/run` | **[Skill](/docs/it/skills#bundled-skills).** Lanciare e guidare l'app del vostro progetto per vedere un cambiamento funzionante, non solo passare i test. Consultate [Eseguire e verificare la vostra app](/docs/it/skills#run-and-verify-your-app) |135| `/run` | **[Skill](/docs/it/skills#bundled-skills).** Lanciare e guidare l'app del vostro progetto per vedere un cambiamento funzionante, non solo passare i test. Consultate [Eseguire e verificare la vostra app](/docs/it/skills#run-and-verify-your-app) |

136| `/run-skill-generator` | **[Skill](/docs/it/skills#bundled-skills).** Insegnare a `/run` e `/verify` come costruire, lanciare e guidare l'app del vostro progetto da un ambiente pulito scrivendo una [skill](/docs/it/skills#run-and-verify-your-app) per progetto |136| `/run-skill-generator` | **[Skill](/docs/it/skills#bundled-skills).** Insegnare a `/run` e `/verify` come costruire, lanciare e guidare l'app del vostro progetto da un ambiente pulito scrivendo una [skill](/docs/it/skills#run-and-verify-your-app) per progetto |

138| `/schedule [description]` | Creare, aggiornare, elencare o eseguire [routine](/docs/it/routines), che vengono eseguite nel cloud. Claude vi guida attraverso la configurazione conversazionalmente. Potete anche chiedere informazioni sulle [esecuzioni recenti di una routine](/docs/it/routines#manage-routines-from-the-cli). Alias: `/routines` |138| `/schedule [description]` | Creare, aggiornare, elencare o eseguire [routine](/docs/it/routines), che vengono eseguite nel cloud. Claude vi guida attraverso la configurazione conversazionalmente. Potete anche chiedere informazioni sulle [esecuzioni recenti di una routine](/docs/it/routines#manage-routines-from-the-cli). Alias: `/routines` |

139| `/scroll-speed` | Regolare la [velocità di scorrimento](/docs/it/fullscreen#mouse-wheel-scrolling) della rotella del mouse in modo interattivo, con un righello che potete scorrere mentre la finestra di dialogo è aperta per visualizzare in anteprima il cambiamento. Disponibile solo nel [rendering schermo intero](/docs/it/fullscreen) e non nel terminale IDE JetBrains |139| `/scroll-speed` | Regolare la [velocità di scorrimento](/docs/it/fullscreen#mouse-wheel-scrolling) della rotella del mouse in modo interattivo, con un righello che potete scorrere mentre la finestra di dialogo è aperta per visualizzare in anteprima il cambiamento. Disponibile solo nel [rendering fullscreen](/docs/it/fullscreen) e non nel terminale IDE JetBrains |

140| `/security-review` | Analizzare le modifiche sul vostro ramo corrente per le vulnerabilità di sicurezza. Rivede il diff tra il vostro ramo e il ramo predefinito di origin, identificando i rischi come iniezione, problemi di autenticazione e esposizione dei dati. Ha bisogno di un remote `origin`; se la revisione fallisce con un errore `ambiguous argument`, consultate il [riferimento degli errori](/docs/it/errors#security-review-fails-without-origin-head) |140| `/security-review` | Analizzare i cambiamenti sul vostro ramo corrente per vulnerabilità di sicurezza. Rivede il diff tra il vostro ramo e il ramo predefinito dell'origin, identificando rischi come iniezione, problemi di autenticazione e esposizione dei dati. Ha bisogno di un remote `origin`; se la revisione fallisce con un errore `ambiguous argument`, consultate il [riferimento degli errori](/docs/it/errors#security-review-fails-without-origin-head) |

141| `/setup-bedrock` | Configurare l'autenticazione, la regione e i pin del modello di [Amazon Bedrock](/docs/it/amazon-bedrock) attraverso una procedura guidata interattiva. [Nascosto dal menu dei comandi](#how-the-command-menu-matches-what-you-type) fino a quando `CLAUDE_CODE_USE_BEDROCK=1` non è impostato; digitate per intero. Gli utenti di Amazon Bedrock per la prima volta possono anche accedere a questa procedura guidata dalla schermata di accesso |141| `/setup-bedrock` | Configurare l'autenticazione, la regione e i pin del modello di [Amazon Bedrock](/docs/it/amazon-bedrock) attraverso una procedura guidata interattiva. [Nascosto dal menu dei comandi](#how-the-command-menu-matches-what-you-type) fino a quando `CLAUDE_CODE_USE_BEDROCK=1` non è impostato; digitate per intero. Gli utenti di Amazon Bedrock per la prima volta possono anche accedere a questa procedura guidata dalla schermata di accesso |

142| `/setup-vertex` | Configurare l'autenticazione, il progetto, la regione e i pin del modello di [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) attraverso una procedura guidata interattiva. [Nascosto dal menu dei comandi](#how-the-command-menu-matches-what-you-type) fino a quando `CLAUDE_CODE_USE_VERTEX=1` non è impostato; digitate per intero. Gli utenti di Google Cloud's Agent Platform per la prima volta possono anche accedere a questa procedura guidata dalla schermata di accesso |142| `/setup-vertex` | Configurare l'autenticazione, il progetto, la regione e i pin del modello di [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) attraverso una procedura guidata interattiva. [Nascosto dal menu dei comandi](#how-the-command-menu-matches-what-you-type) fino a quando `CLAUDE_CODE_USE_VERTEX=1` non è impostato; digitate per intero. Gli utenti di Google Cloud's Agent Platform per la prima volta possono anche accedere a questa procedura guidata dalla schermata di accesso |

143| `/simplify [target]` | **[Skill](/docs/it/skills#bundled-skills).** Rivedere il codice modificato per opportunità di pulizia e applicare le correzioni. Quattro [agenti](/docs/it/sub-agents) di revisione vengono eseguiti in parallelo, coprendo il riutilizzo di helper esistenti, semplificazione, efficienza e se il cambiamento è al giusto livello di astrazione. La revisione non cerca bug di correttezza. Usate `/code-review` per trovare bug. Passate un percorso o un riferimento PR per rivedere un target specifico |143| `/simplify [target]` | **[Skill](/docs/it/skills#bundled-skills).** Rivedere il codice modificato per opportunità di pulizia e applicare le correzioni. Quattro [agenti](/docs/it/sub-agents) di revisione vengono eseguiti in parallelo, coprendo il riutilizzo di helper esistenti, semplificazione, efficienza e se il cambiamento è al livello giusto di astrazione. La revisione non cerca bug di correttezza. Usate `/code-review` per trovare bug. Passate un percorso o un riferimento PR per rivedere un target specifico |

144| `/skill-doctor` | Mostrare quanto costa ogni vostra [skill](/docs/it/skills) in contesto e quanto spesso viene utilizzata, in modo da poter [trovare skill da disattivare](/docs/it/skills#find-unused-skills). Richiede Claude Code v2.1.252 o successivo e il [recupero di flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching) |144| `/skill-doctor` | Mostrare quanto costa in contesto ogni vostra [skill](/docs/it/skills) e quanto spesso viene utilizzata, in modo da poter [trovare skill da disattivare](/docs/it/skills#find-unused-skills). Richiede Claude Code v2.1.252 o successivo e il [recupero di flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching) |

145| `/skills` | Elencare le [skill](/docs/it/skills) disponibili. Digitate per filtrare l'elenco per nome, descrizione o fonte. Premete `t` per ordinare per conteggio di token, `Space` o `Enter` per [ciclo la visibilità di una skill a Claude e al menu `/`](/docs/it/skills#override-skill-visibility-from-settings), e `Esc` per salvare e chiudere. Non potete ciclo le skill dei plugin, le skill la cui frontmatter imposta `disable-model-invocation: true`, o le skill con una voce `skillOverrides` nelle impostazioni gestite o il flag `--settings` |145| `/skills` | Elencare le [skill](/docs/it/skills) disponibili. Digitate per filtrare l'elenco per nome, descrizione o fonte. Premete `t` per ordinare per conteggio di token, `Space` o `Enter` per [ciclo della visibilità di una skill a Claude e al menu `/`](/docs/it/skills#override-skill-visibility-from-settings), e `Esc` per salvare e chiudere. Non potete ciclo le skill dei plugin, le skill la cui frontmatter imposta `disable-model-invocation: true`, o le skill con una voce `skillOverrides` nelle impostazioni gestite o il flag `--settings` |

146| `/stats` | Alias per `/usage`. Apre sulla scheda Stats |146| `/slides [brief]` | **[Skill](/docs/it/skills#bundled-skills).** Fare una nuova presentazione come un [artifact](/docs/it/artifacts#make-a-slide-deck) Claude Slides riempito dalla vostra breve descrizione, ad esempio `/slides a quarterly review of the platform team`. Richiede Claude Code v2.1.265 o successivo, una sessione dove gli [artifact sono disponibili](/docs/it/artifacts#availability), e un account dove il [template Slides è disponibile](/docs/it/artifacts#start-from-a-slides-design-or-docs-template); altrimenti il comando non appare. Disponibile sull'API Anthropic. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform su AWS, gli artifact non sono disponibili, quindi il comando non è disponibile lì |

147| `/status` | Aprire l'interfaccia Impostazioni sulla scheda Status, mostrando versione, modello, account e connettività. Una riga `Session kind` legge `background job · attached` o `background job · unattended` in una [sessione in background](/docs/it/agent-view), a seconda che un terminale sia collegato, e `interactive` in qualsiasi altra sessione. Prima della v2.1.221, `/status` non mostrava questa riga. Funziona mentre Claude sta rispondendo |147| `/stats` | Alias per `/usage`. Si apre sulla scheda Stats |

148| `/statusline` | Configurare la [linea di stato](/docs/it/statusline) di Claude Code. Descrivete quello che volete, o eseguite senza argomenti per auto-configurare dal vostro prompt di shell |148| `/status` | Aprire l'interfaccia Impostazioni sulla scheda Status, mostrando versione, modello, account e connettività. Una riga `Session kind` legge `background job · attached` o `background job · unattended` in una [sessione background](/docs/it/agent-view), a seconda che un terminale sia collegato, e `interactive` in qualsiasi altra sessione. Prima della v2.1.221, `/status` non mostrava questa riga. Funziona mentre Claude sta rispondendo |

149| `/statusline` | Configurare la [linea di stato](/docs/it/statusline) di Claude Code. Descrivete cosa volete, o eseguite senza argomenti per auto-configurare dal vostro prompt di shell |

150| `/stop` | Fermare la [sessione in background](/docs/it/agent-view) corrente. Disponibile solo mentre collegati a una sessione in background; il trascritto e qualsiasi worktree vengono mantenuti. Per staccare senza fermare, usate `/exit` o premete `←` |151| `/stop` | Fermare la [sessione background](/docs/it/agent-view) corrente. Disponibile solo mentre siete collegati a una sessione background; il trascritto e qualsiasi worktree vengono mantenuti. Per staccarvi senza fermare, usate `/exit` o premete `←` |

151| `/subtask <task>` | Avviare un [subagent con fork](/docs/it/sub-agents#fork-the-current-conversation): un subagent in background che eredita la conversazione completa e lavora sul compito mentre continuate a lavorare. Il suo risultato torna a questa conversazione quando finisce. Per copiare la conversazione in una sessione in background separata invece, usate `/fork`. Richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211 questo comando è `/fork`. Quando [agent view è disattivato](/docs/it/agent-view#turn-off-agent-view), `/subtask` non è disponibile e `/fork` mantiene il comportamento del subagent con fork |152| `/subtask <task>` | Avviare un [subagent con fork](/docs/it/sub-agents#fork-the-current-conversation): un subagent background che eredita la conversazione completa e lavora sul compito mentre continuate a lavorare. Il suo risultato torna a questa conversazione quando finisce. Per copiare la conversazione in una sessione background separata invece, usate `/fork`. Richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211 questo comando è `/fork`. Quando l'[agent view è disattivato](/docs/it/agent-view#turn-off-agent-view), `/subtask` non è disponibile e `/fork` mantiene il comportamento del subagent con fork |

152| `/tasks` | Visualizzare e gestire il lavoro in background nella sessione corrente, inclusi i subagent che hanno finito. Disponibile anche come `/bashes` |153| `/tasks` | Visualizzare e gestire il lavoro background nella sessione corrente, inclusi i subagent che hanno finito. Disponibile anche come `/bashes` |

153| `/team-onboarding` | Generare una guida di onboarding del team dalla vostra cronologia di utilizzo di Claude Code. Claude analizza le vostre sessioni, comandi e utilizzo del server MCP degli ultimi 30 giorni e produce una guida markdown che un compagno di team può incollare come primo messaggio per configurarsi rapidamente. Per gli abbonati a claude.ai sui piani Pro, Max, Team ed Enterprise, restituisce anche un link di condivisione che i compagni di team possono aprire direttamente in Claude Code |154| `/team-onboarding` | Generare una guida di onboarding del team dalla vostra cronologia di utilizzo di Claude Code. Claude analizza le vostre sessioni, comandi e utilizzo del server MCP degli ultimi 30 giorni e produce una guida markdown che un compagno di team può incollare come primo messaggio per configurarsi rapidamente. Per gli abbonati a claude.ai sui piani Pro, Max, Team ed Enterprise, restituisce anche un link di condivisione che i compagni di team possono aprire direttamente in Claude Code |

154| `/teleport` | Tirare una sessione di [Claude Code sul web](/docs/it/claude-code-on-the-web#from-cloud-to-terminal) in questo terminale. Apre un selettore, quindi recupera il ramo e la conversazione. Disponibile anche come `/tp`. Richiede un abbonamento claude.ai |155| `/teleport` | Tirare una [sessione cloud](/docs/it/claude-code-on-the-web#from-cloud-to-terminal) in questo terminale. Apre un selettore, quindi recupera il ramo e la conversazione. Disponibile anche come `/tp`. Richiede un abbonamento claude.ai |

155| `/terminal-setup` | [Installare una scorciatoia da tastiera Shift+Enter per le nuove righe](/docs/it/terminal-config#enter-multiline-prompts) in VS Code, Cursor, Devin Desktop, Alacritty, o Zed. In Apple Terminal, [abilitare Option+Enter per le nuove righe e disattivare il campanello udibile](/docs/it/terminal-config#enable-option-key-shortcuts-on-macos) invece. In iTerm2, [attivare l'accesso agli appunti in modo che `/copy` funzioni](/docs/it/terminal-config#enable-option-key-shortcuts-on-macos) |156| `/terminal-setup` | [Installare una scorciatoia da tastiera Shift+Enter per le nuove righe](/docs/it/terminal-config#enter-multiline-prompts) in VS Code, Cursor, Devin Desktop, Alacritty, o Zed. In Apple Terminal, [abilitare Option+Enter per le nuove righe e disattivare il campanello udibile](/docs/it/terminal-config#enable-option-key-shortcuts-on-macos) invece. In iTerm2, [attivare l'accesso agli appunti in modo che `/copy` funzioni](/docs/it/terminal-config#enable-option-key-shortcuts-on-macos) |

156| `/theme` | Cambiare il tema del colore. Include un'opzione `auto` che corrisponde allo sfondo chiaro o scuro del vostro terminale, varianti chiare e scure, temi accessibili ai daltonici (daltonizzati), temi ANSI che utilizzano la tavolozza dei colori del vostro terminale, e qualsiasi [tema personalizzato](/docs/it/terminal-config#create-a-custom-theme) da `~/.claude/themes/` o plugin. Selezionate **New custom theme…** per crearne uno |157| `/theme` | Cambiare il tema del colore. Include un'opzione `auto` che corrisponde allo sfondo chiaro o scuro del vostro terminale, varianti chiare e scure, temi accessibili ai daltonici (daltonizzati), temi ANSI che utilizzano la tavolozza dei colori del vostro terminale, e qualsiasi [tema personalizzato](/docs/it/terminal-config#create-a-custom-theme) da `~/.claude/themes/` o plugin. Selezionate **New custom theme…** per crearne uno |

157| `/tui [default\|fullscreen]` | Impostare il renderer dell'interfaccia utente del terminale e riavviare in esso con la vostra conversazione intatta. `fullscreen` abilita il [renderer alt-screen senza sfarfallio](/docs/it/fullscreen). Senza argomento, stampa il renderer attivo |158| `/tui [default\|fullscreen]` | Impostare il renderer dell'interfaccia utente del terminale e riavviare in esso con la vostra conversazione intatta. `fullscreen` abilita il [renderer alt-screen senza sfarfallio](/docs/it/fullscreen). Senza argomento, stampa il renderer attivo |

158| `/ultraplan <prompt>` | Rimosso. Usate [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) invece. In precedenza inviava un'attività di pianificazione a una sessione di [Claude Code sul web](/docs/it/claude-code-on-the-web) per la revisione nel vostro browser |159| `/ultraplan <prompt>` | Rimosso. Usate [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) invece. In precedenza inviava un'attività di pianificazione a una [sessione cloud](/docs/it/claude-code-on-the-web) per la revisione nel vostro browser |

159| `/ultrareview [PR or branch]` | Eseguire una profonda revisione del codice multi-agente in una sandbox cloud con [ultrareview](/docs/it/ultrareview). Passate un riferimento PR per rivedere quella pull request, o un nome di ramo o commit per cambiare la base di confronto. L'invocazione preferita è `/code-review ultra`, e `/ultrareview` è un alias. Include 3 esecuzioni gratuite su Pro e Max, quindi richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |160| `/ultrareview [PR or branch]` | Eseguire una revisione del codice profonda e multi-agente in una sandbox cloud con [ultrareview](/docs/it/ultrareview). Passate un riferimento PR per rivedere quella richiesta di pull, o un ramo base o commit per cambiare la base di confronto. L'invocazione preferita è `/code-review ultra`, e `/ultrareview` è un alias. Include 3 esecuzioni gratuite su Pro e Max, quindi richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

160| `/update-config [request]` | **[Skill](/docs/it/skills#bundled-skills).** Descrivere un cambiamento di impostazioni, come consentire un comando, impostare una variabile di ambiente, o aggiungere un [hook](/docs/it/hooks), e Claude modifica il file [`settings.json`](/docs/it/settings) corrispondente. Per opzioni come tema e modello, usate `/config` invece |161| `/update-config [request]` | **[Skill](/docs/it/skills#bundled-skills).** Descrivere un cambiamento di impostazioni, come consentire un comando, impostare una variabile di ambiente, o aggiungere un [hook](/docs/it/hooks), e Claude modifica il file [`settings.json`](/docs/it/settings) corrispondente. Per opzioni come tema e modello, usate `/config` invece |

161| `/upgrade` | Aprire la pagina di aggiornamento nel vostro browser per passare a un livello di piano superiore. Quando il browser non riesce ad aprirsi, il comando mostra un prompt di accesso senza stampare l'URL |162| `/upgrade` | Aprire la pagina di aggiornamento nel vostro browser per passare a un livello di piano superiore. Quando il browser non riesce ad aprirsi, il comando mostra un prompt di accesso senza stampare l'URL |

162| `/usage` | Mostrare il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Su un piano Pro, Max, Team o Enterprise, include un [breakdown di quello che conta rispetto ai vostri limiti di piano](/docs/it/costs#plan-usage-breakdown). `/cost` e `/stats` sono alias |163| `/usage` | Mostrare il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Su un piano Pro, Max, Team o Enterprise, include un [breakdown di ciò che conta rispetto ai vostri limiti di piano](/docs/it/costs#plan-usage-breakdown). `/cost` e `/stats` sono alias |

163| `/usage-credits` | Configurare i crediti di utilizzo, o richiederli dal vostro amministratore, quando raggiungete un limite. Apre le vostre [impostazioni di fatturazione dei crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription) nel browser, tranne che i membri di Team ed Enterprise senza accesso alla fatturazione inviano invece una richiesta di crediti di utilizzo al loro amministratore dalla CLI, dopo aver confermato in una finestra di dialogo che la richiesta notifica i loro amministratori. Quando nessun browser può aprire la pagina di fatturazione, ad esempio su SSH, il comando stampa l'URL da visitare invece; questo richiede Claude Code v2.1.205 o successivo, e le versioni precedenti non mostravano nulla in quel caso. In precedenza `/extra-usage` |164| `/usage-credits` | Configurare i crediti di utilizzo, o richiederli dal vostro amministratore, quando raggiungete un limite. Apre le vostre [impostazioni di fatturazione dei crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription) nel browser, tranne che i membri di Team ed Enterprise senza accesso alla fatturazione inviano invece una richiesta di crediti di utilizzo al loro amministratore dalla CLI, dopo aver confermato in una finestra di dialogo che la richiesta notifica i loro amministratori. Quando nessun browser può aprire la pagina di fatturazione, ad esempio su SSH, il comando stampa l'URL da visitare invece; questo richiede Claude Code v2.1.205 o successivo, e le versioni precedenti non mostravano nulla in quel caso. In precedenza `/extra-usage` |

164| `/verify` | **[Skill](/docs/it/skills#bundled-skills).** Confermare che un cambiamento di codice fa quello che dovrebbe costruendo l'app del vostro progetto, eseguendola e osservando il risultato, piuttosto che fare affidamento su test o controlli di tipo. Consultate [Eseguire e verificare la vostra app](/docs/it/skills#run-and-verify-your-app) |165| `/verify` | **[Skill](/docs/it/skills#bundled-skills).** Confermare che un cambiamento di codice fa quello che dovrebbe costruendo l'app del vostro progetto, eseguendola e osservando il risultato, piuttosto che affidarsi ai test o ai controlli di tipo. Consultate [Eseguire e verificare la vostra app](/docs/it/skills#run-and-verify-your-app) |

165| `/vim` | Rimosso nella v2.1.92. Per alternare tra le modalità di modifica Vim e Normale, usate `/config` → Editor mode |166| `/vim` | Rimosso nella v2.1.92. Per alternare tra le modalità di modifica Vim e Normal, usate `/config` → Editor mode |

166| `/voice [hold\|tap\|off]` | Attivare la [dettatura vocale](/docs/it/voice-dictation), o abilitarla in una modalità specifica. Richiede un account Claude.ai |167| `/voice [hold\|tap\|off]` | Attivare/disattivare la [dettatura vocale](/docs/it/voice-dictation), o abilitarla in una modalità specifica. Richiede un account Claude.ai |

167| `/web-setup` | Connettere il vostro account GitHub a [Claude Code sul web](/docs/it/web-quickstart#connect-from-your-terminal) usando le credenziali della CLI `gh` locale |168| `/web-setup` | Connettere il vostro account GitHub per le [sessioni cloud](/docs/it/web-quickstart#connect-from-your-terminal) usando le credenziali della CLI `gh` locale |

168| `/workflow-authoring` | **[Skill](/docs/it/skills#bundled-skills).** Caricare il riferimento per scrivere script di [workflow dinamico](/docs/it/workflows): l'API dello script, il comportamento di ripresa, i modelli di qualità e gli esempi elaborati. Claude normalmente lo carica autonomamente prima di scrivere uno script; eseguitelo voi stessi prima di [modificare uno script salvato a mano](/docs/it/workflows#edit-a-saved-script). Disponibile quando i workflow dinamici sono abilitati, e richiede Claude Code v2.1.248 o successivo |169| `/workflow-authoring` | **[Skill](/docs/it/skills#bundled-skills).** Caricare il riferimento per scrivere script di [workflow dinamico](/docs/it/workflows): l'API dello script, il comportamento di ripresa, i modelli di qualità e gli esempi elaborati. Claude normalmente lo carica autonomamente prima di scrivere uno script; eseguitelo voi stessi prima di [modificare uno script salvato a mano](/docs/it/workflows#edit-a-saved-script). Disponibile quando i workflow dinamici sono abilitati e richiede Claude Code v2.1.248 o successivo |

169| `/workflows` | Aprire la vista di [workflow](/docs/it/workflows#watch-the-run) per guardare, mettere in pausa, riprendere o salvare workflow in esecuzione e completati |170| `/workflows` | Aprire la [vista di progresso del workflow](/docs/it/workflows#watch-the-run) per guardare, mettere in pausa, riprendere o salvare workflow in esecuzione e completati |

170 171

171<h2 id="how-the-command-menu-matches-what-you-type">172<h2 id="how-the-command-menu-matches-what-you-type">

172 Come il menu dei comandi corrisponde a quello che digitate173 Come il menu dei comandi corrisponde a quello che digitate

communications-kit.md +2 −2

Details

232 232

233Claude Code funziona sugli stessi modelli dell'app Claude, e potete cambiare a metà sessione. *Sonnet* è il cavallo da lavoro predefinito per il lavoro di funzionalità quotidiana, bug, test e revisioni. Raggiungete *Opus* su refactor su larga scala, debug complicati o qualsiasi cosa ad alto rischio. Scendete a *Haiku* per domande rapide, formattazione e modifiche meccaniche dove la velocità vince.233Claude Code funziona sugli stessi modelli dell'app Claude, e potete cambiare a metà sessione. *Sonnet* è il cavallo da lavoro predefinito per il lavoro di funzionalità quotidiana, bug, test e revisioni. Raggiungete *Opus* su refactor su larga scala, debug complicati o qualsiasi cosa ad alto rischio. Scendete a *Haiku* per domande rapide, formattazione e modifiche meccaniche dove la velocità vince.

234 234

235*Fable* è il modello più capace per i vostri compiti più difficili e lunghi; non è il default, quindi selezionatelo con `/model fable`, e notate che i contenuti di cybersecurity e biologia ricadono automaticamente su Opus. Opus 5.5 e Opus 5 eseguono i loro stessi controlli: i contenuti contrassegnati di cybersecurity cambiano modello a un Opus precedente, tranne che i contenuti di biologia contrassegnati su Opus 5 vengono rifiutati.235*Fable* è il modello più capace per i vostri compiti più difficili e lunghi; non è il default, quindi selezionatelo con `/model fable`, e notate che i contenuti di cybersecurity e biologia ricadono automaticamente su Opus. Opus 5.5, Sonnet 5.5 e Opus 5 eseguono i loro stessi controlli: i contenuti contrassegnati cambiano modello a uno precedente nella stessa famiglia, tranne che i contenuti di biologia contrassegnati su Opus 5 o Sonnet 5.5 vengono rifiutati.

236 236

237*Provalo ora:* digitate `/model` e scegliete Sonnet se non l'avete già fatto. È il default giusto per la maggior parte dei compiti.237*Provalo ora:* digitate `/model` e scegliete Sonnet se non l'avete già fatto. È il default giusto per la maggior parte dei compiti.

238 238

243| - | - |243| - | - |

244| Fable | I compiti più difficili e lunghi. Solo opt-in: selezionatelo con `/model fable`. I contenuti di cybersecurity o biologia attivano [fallback automatico del modello a Opus](/docs/it/model-config#automatic-model-fallback) |244| Fable | I compiti più difficili e lunghi. Solo opt-in: selezionatelo con `/model fable`. I contenuti di cybersecurity o biologia attivano [fallback automatico del modello a Opus](/docs/it/model-config#automatic-model-fallback) |

245| Opus | Refactor su larga scala, debug complessi, decisioni architettoniche, cambiamenti ad alto rischio. Su Opus 5.5 e Opus 5, i contenuti di cybersecurity o biologia attivano [fallback automatico del modello o un rifiuto](/docs/it/model-config#automatic-model-fallback) |245| Opus | Refactor su larga scala, debug complessi, decisioni architettoniche, cambiamenti ad alto rischio. Su Opus 5.5 e Opus 5, i contenuti di cybersecurity o biologia attivano [fallback automatico del modello o un rifiuto](/docs/it/model-config#automatic-model-fallback) |

246| Sonnet | Lavoro di funzionalità quotidiana, correzioni di bug, test, documentazione, revisione del codice. Default consigliato. |246| Sonnet | Lavoro di funzionalità quotidiana, correzioni di bug, test, documentazione, revisione del codice. Default consigliato. Su Sonnet 5.5, i contenuti di cybersecurity o biologia attivano [fallback automatico del modello o un rifiuto](/docs/it/model-config#automatic-model-fallback) |

247| Haiku | Domande rapide, formattazione, modifiche meccaniche, iterazione rapida |247| Haiku | Domande rapide, formattazione, modifiche meccaniche, iterazione rapida |

248 248

249**Vittorie rapide da provare per prime**249**Vittorie rapide da provare per prime**

context-window.md +2 −2

Details

1632* **Cancella tra i compiti**: esegui `/clear` quando passi a un lavoro non correlato. La vecchia conversazione esclude i file di cui hai bisogno dopo e costa token su ogni messaggio.1632* **Cancella tra i compiti**: esegui `/clear` quando passi a un lavoro non correlato. La vecchia conversazione esclude i file di cui hai bisogno dopo e costa token su ogni messaggio.

1633* **Delega letture di grandi dimensioni**: invia la ricerca a un [subagent](/docs/it/sub-agents) in modo che i contenuti del file rimangono nella sua finestra di contesto, non nella tua.1633* **Delega letture di grandi dimensioni**: invia la ricerca a un [subagent](/docs/it/sub-agents) in modo che i contenuti del file rimangono nella sua finestra di contesto, non nella tua.

1634 1634

1635Se hai bisogno di una finestra più grande piuttosto che di una conversazione più piccola, i modelli Fable, Sonnet 5, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano una finestra di contesto di 1 milione di token. Vedi [Extended context](/docs/it/model-config#extended-context) per la disponibilità per piano e come selezionare una variante di modello `[1m]`. La compattazione funziona allo stesso modo al limite più grande.1635Se hai bisogno di una finestra più grande piuttosto che di una conversazione più piccola, i modelli Fable, Sonnet 5 e versioni successive, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano una finestra di contesto di 1 milione di token. Vedi [Extended context](/docs/it/model-config#extended-context) per la disponibilità per piano e come selezionare una variante di modello `[1m]`. La compattazione funziona allo stesso modo al limite più grande.

1636 1636

1637Sonnet 5 funziona con la finestra di contesto 1M e non ha alcuna variante `[1m]` da selezionare. Vedi [Sonnet 5 context window](/docs/it/model-config#sonnet-5-context-window) per le sue soglie di auto-compattazione e l'eccezione del gateway LLM.1637Sonnet 5.5 e Sonnet 5 funzionano con la finestra di contesto 1M e non hanno alcuna variante `[1m]` da selezionare. Vedi [Sonnet 5.5 and Sonnet 5 context window](/docs/it/model-config#sonnet-5-5-and-sonnet-5-context-window) per le loro soglie di auto-compattazione e l'eccezione del gateway LLM.

1638 1638

1639Il punto in cui viene eseguita la compattazione automatica dipende dal tuo modello e dalla configurazione. Vedi [Default auto-compact thresholds](/docs/it/model-config#default-auto-compact-thresholds) per i confini per modello, e [Correct the window for a gateway or custom model ID](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) se Claude Code assume la finestra sbagliata per il tuo ID modello, come un alias [LLM gateway](/docs/it/llm-gateway).1639Il punto in cui viene eseguita la compattazione automatica dipende dal tuo modello e dalla configurazione. Vedi [Default auto-compact thresholds](/docs/it/model-config#default-auto-compact-thresholds) per i confini per modello, e [Correct the window for a gateway or custom model ID](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) se Claude Code assume la finestra sbagliata per il tuo ID modello, come un alias [LLM gateway](/docs/it/llm-gateway).

1640 1640

costs.md +4 −1

Details

359 359

360Il pensiero esteso è abilitato per impostazione predefinita perché migliora significativamente le prestazioni su compiti complessi di pianificazione e ragionamento. I token di pensiero vengono fatturati come token di output, e il budget predefinito può essere decine di migliaia di token per richiesta a seconda del modello.360Il pensiero esteso è abilitato per impostazione predefinita perché migliora significativamente le prestazioni su compiti complessi di pianificazione e ragionamento. I token di pensiero vengono fatturati come token di output, e il budget predefinito può essere decine di migliaia di token per richiesta a seconda del modello.

361 361

362Per compiti più semplici dove il ragionamento profondo non è necessario, puoi ridurre i costi abbassando il [livello di sforzo](/docs/it/model-config#adjust-effort-level) con `/effort` o in `/model`, o disabilitando il pensiero in `/config`. Non puoi disattivare il pensiero su Opus 5.5 o sui modelli Fable, che utilizzano sempre il pensiero esteso.362Per compiti più semplici dove il ragionamento profondo non è necessario, puoi ridurre i costi abbassando il [livello di sforzo](/docs/it/model-config#adjust-effort-level) con `/effort` o in `/model`, o disabilitando il pensiero in `/config`. Non puoi disattivare il pensiero su Opus 5.5, Sonnet 5.5, o sui modelli Fable, che utilizzano sempre il pensiero esteso.

363 363

364Sui modelli con un [budget di pensiero fisso](/docs/it/model-config#adaptive-reasoning-and-fixed-thinking-budgets), puoi anche abbassare il budget impostando la [variabile di ambiente](/docs/it/env-vars) `MAX_THINKING_TOKENS`, ad esempio `MAX_THINKING_TOKENS=8000`. I modelli di ragionamento adattivo ignorano i budget diversi da zero, quindi utilizza i livelli di sforzo lì.364Sui modelli con un [budget di pensiero fisso](/docs/it/model-config#adaptive-reasoning-and-fixed-thinking-budgets), puoi anche abbassare il budget impostando la [variabile di ambiente](/docs/it/env-vars) `MAX_THINKING_TOKENS`, ad esempio `MAX_THINKING_TOKENS=8000`. I modelli di ragionamento adattivo ignorano i budget diversi da zero, quindi utilizza i livelli di sforzo lì.

365 365

369 369

370L'esecuzione di test, il recupero della documentazione o l'elaborazione di file di log possono consumare un contesto significativo. Delega questi ai [subagent](/docs/it/sub-agents#isolate-high-volume-operations) in modo che l'output dettagliato rimanga nel contesto del subagent mentre solo un riassunto ritorna alla tua conversazione principale.370L'esecuzione di test, il recupero della documentazione o l'elaborazione di file di log possono consumare un contesto significativo. Delega questi ai [subagent](/docs/it/sub-agents#isolate-high-volume-operations) in modo che l'output dettagliato rimanga nel contesto del subagent mentre solo un riassunto ritorna alla tua conversazione principale.

371 371

372L'utilizzo dei subagent stesso attinge ancora al tuo utilizzo. Per spendere meno su di essi, [scegli un modello più piccolo per un subagent](/docs/it/sub-agents#choose-a-model) o [esegui ogni subagent su un modello](/docs/it/sub-agents#run-every-subagent-on-one-model).

373

372<h3 id="manage-agent-team-costs">374<h3 id="manage-agent-team-costs">

373 Gestisci i costi del team di agenti375 Gestisci i costi del team di agenti

374</h3>376</h3>

416* **Scheduled tasks**: un [scheduled task](/docs/it/scheduled-tasks) si attiva al suo intervallo anche mentre la sessione è inattiva, inviando il vostro contesto completo ogni volta418* **Scheduled tasks**: un [scheduled task](/docs/it/scheduled-tasks) si attiva al suo intervallo anche mentre la sessione è inattiva, inviando il vostro contesto completo ogni volta

417* **Cross-session messages**: Claude Code consegna un [message from another of your sessions](/docs/it/cross-session-messaging) come un nuovo turno quando questa sessione rimane inattiva, inviando il vostro contesto completo ogni volta. Per trattenere i messaggi in entrata invece di consegnarli, impostate [`crossSessionInbound`](/docs/it/settings-reference#crosssessioninbound) su `hold`419* **Cross-session messages**: Claude Code consegna un [message from another of your sessions](/docs/it/cross-session-messaging) come un nuovo turno quando questa sessione rimane inattiva, inviando il vostro contesto completo ogni volta. Per trattenere i messaggi in entrata invece di consegnarli, impostate [`crossSessionInbound`](/docs/it/settings-reference#crosssessioninbound) su `hold`

418* **Goal check-ins**: mentre il lavoro in background mantiene un [goal](/docs/it/goal) attivo in attesa, Claude Code [chiede a Claude di controllare quel lavoro](/docs/it/goal#background-work-defers-evaluation) anche quando la sessione rimane inattiva, avviando un nuovo turno che invia il vostro contesto completo. Claude Code avvia al massimo tre check-in inattivi per goal tra i vostri prompt. Prima della v2.1.246, i check-in inattivi erano illimitati. Per disattivare i check-in, impostate [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/it/env-vars) su `0`. I check-in inattivi richiedono Claude Code v2.1.236 o successivo420* **Goal check-ins**: mentre il lavoro in background mantiene un [goal](/docs/it/goal) attivo in attesa, Claude Code [chiede a Claude di controllare quel lavoro](/docs/it/goal#background-work-defers-evaluation) anche quando la sessione rimane inattiva, avviando un nuovo turno che invia il vostro contesto completo. Claude Code avvia al massimo tre check-in inattivi per goal tra i vostri prompt. Prima della v2.1.246, i check-in inattivi erano illimitati. Per disattivare i check-in, impostate [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/it/env-vars) su `0`. I check-in inattivi richiedono Claude Code v2.1.236 o successivo

421* **Subagents and workflows**: ogni subagent, e ogni agent che un [dynamic workflow](/docs/it/workflows#cost) genera, invia le proprie richieste oltre a quelle della conversazione principale. Il [attribution breakdown](#plan-usage-breakdown) mostra la quota del subagent

419* **Agent teammates**: ogni [teammate](#agent-team-token-costs) attivo continua a consumare token fino a quando non esce422* **Agent teammates**: ogni [teammate](#agent-team-token-costs) attivo continua a consumare token fino a quando non esce

420* **Compaction**: `/compact` legge la conversazione che riassume, quindi [compacting a large context](/docs/it/prompt-caching#compacting-the-conversation) è essa stessa una richiesta grande. Quando volete un nuovo inizio invece della continuità, `/clear` non costa nulla423* **Compaction**: `/compact` legge la conversazione che riassume, quindi [compacting a large context](/docs/it/prompt-caching#compacting-the-conversation) è essa stessa una richiesta grande. Quando volete un nuovo inizio invece della continuità, `/clear` non costa nulla

421 424

cross-session-messaging.md +38 −75

Details

14 14

15Un messaggio è un pezzo di testo che un Claude scrive a un altro, mai la cronologia della conversazione del mittente o i file. Per spostare un'intera conversazione o il suo contesto, [riprendi la sessione](/docs/it/sessions#resume-a-session) invece.15Un messaggio è un pezzo di testo che un Claude scrive a un altro, mai la cronologia della conversazione del mittente o i file. Per spostare un'intera conversazione o il suo contesto, [riprendi la sessione](/docs/it/sessions#resume-a-session) invece.

16 16

17Claude utilizza due strumenti per questo: `ListAgents` per scoprire quali agenti può raggiungere, e `SendMessage` per consegnare un messaggio a uno di essi per nome. Con lo stesso strumento `SendMessage`, Claude può anche inviare messaggi a [subagenti](/docs/it/sub-agents#resume-subagents) e ai compagni di [team di agenti](/docs/it/agent-teams) all'interno di una singola sessione o team. Questa pagina copre i messaggi tra le tue sessioni indipendenti.

19<h2 id="when-to-use-cross-session-messaging">17<h2 id="when-to-use-cross-session-messaging">

20 Quando utilizzare la messaggistica tra sessioni18 Quando utilizzare la messaggistica tra sessioni

21</h2>19</h2>

27* **Ottieni lo stato dal lavoro a lunga esecuzione**: fai in modo che una migrazione o un'esecuzione di test riferisca alla sessione che stai osservando, oppure chiedilo tu stesso da lì. Se quella sessione è su questa macchina, Claude può anche [chiederle un avviso quando successivamente diventa inattiva o esce](#get-a-notice-when-another-session-goes-idle).25* **Ottieni lo stato dal lavoro a lunga esecuzione**: fai in modo che una migrazione o un'esecuzione di test riferisca alla sessione che stai osservando, oppure chiedilo tu stesso da lì. Se quella sessione è su questa macchina, Claude può anche [chiederle un avviso quando successivamente diventa inattiva o esce](#get-a-notice-when-another-session-goes-idle).

28* **Messaggi tra macchine**: raggiungi una delle tue sessioni su un'altra macchina o sul web.26* **Messaggi tra macchine**: raggiungi una delle tue sessioni su un'altra macchina o sul web.

29 27

30Utilizza la messaggistica tra sessioni indipendenti che avvii e dirigi tu stesso. Claude Code ha una funzione dedicata per ognuno degli altri modi di eseguire o raggiungere più sessioni, quindi utilizza quella costruita per quello che stai facendo:

~~32* Per continuare una conversazione in un altro terminale, o condividere il suo contesto con una nuova sessione, [riprendi la sessione](/docs/it/sessions#resume-a-session)~~

~~33* Per un team coordinato di sessioni che Claude genera e supervisiona, utilizza [team di agenti](/docs/it/agent-teams)~~

~~34* Per osservare e dirigere molte sessioni da un unico posto, utilizza [agent view](/docs/it/agent-view)~~

35* Per dirigere una sessione tu stesso dal tuo telefono o da un altro dispositivo, piuttosto che far inviare messaggi alle sessioni l'una all'altra, utilizza [Remote Control](/docs/it/remote-control)

~~36* Per spingere eventi esterni, come risultati CI o messaggi di chat, in una sessione, utilizza [channels](/docs/it/channels)~~

38<h2 id="message-another-session">28<h2 id="message-another-session">

39 Inviare un messaggio a un'altra sessione29 Inviare un messaggio a un'altra sessione

40</h2>30</h2>

41 31

42Quando una delle tue sessioni scopre qualcosa che un'altra sessione ha bisogno di sapere, come un risultato, uno stato o una decisione, Claude la trasmette invece di farti copiare e incollare tra i terminali. Claude scopre il destinatario con `ListAgents` e invia con `SendMessage`, quindi non chiami mai nessuno dei due strumenti tu stesso. Claude può decidere di inviare un messaggio senza essere chiesto, e puoi anche richiederne uno.32Quando una delle tue sessioni scopre qualcosa che un'altra sessione ha bisogno di sapere, come un risultato, uno stato o una decisione, Claude la passa invece di farti copiare e incollare tra i terminali. Claude scopre il destinatario con `ListAgents` e invia con `SendMessage`, quindi non chiami mai nessuno dei due strumenti tu stesso. Claude può decidere di inviare un messaggio senza essere chiesto, e puoi anche richiederne uno.

43 33

44Per richiederne uno tu stesso, dì a Claude cosa vuoi che l'altra sessione sappia o faccia. Questo esempio è un prompt che digiti, non un messaggio che Claude invia:34Per richiederne uno tu stesso, dì a Claude cosa vuoi che l'altra sessione sappia o faccia. Questo esempio è un prompt che digiti, non un messaggio che Claude invia:

45 35

53Spiega quello che abbiamo appena fatto alla sessione che sta lavorando all'API dei pagamenti43Spiega quello che abbiamo appena fatto alla sessione che sta lavorando all'API dei pagamenti

54```44```

55 45

56Per nominare il destinatario tu stesso, menziona la sessione nel tuo prompt: digita `@` seguito dalle prime lettere del nome della sessione e scegli la sessione dal typeahead, nello stesso modo in cui [@-menzioni un subagent](/docs/it/sub-agents#invoke-subagents-explicitly). Richiede Claude Code v2.1.232 o successivo. Claude Code inserisce la menzione, come `@api-worker`, e dice a Claude quale sessione nomina, quindi Claude può inviare un messaggio a quella sessione senza elencare prima le tue sessioni. Questo prompt nomina il destinatario con una menzione:46Per nominare il destinatario tu stesso, menziona la sessione nel tuo prompt: digita `@` seguito dalle prime lettere del nome della sessione e scegli la sessione dal typeahead, nello stesso modo in cui [@-menzioni un subagent](/docs/it/sub-agents#invoke-subagents-explicitly). Richiede Claude Code v2.1.232 o successivo. Claude Code inserisce la menzione, come `@api-worker`, e dice a Claude quale sessione nomina, così Claude può inviare un messaggio a quella sessione senza elencare prima le tue sessioni. Questo prompt nomina il destinatario con una menzione:

57 47

58```text wrap theme={null}48```text wrap theme={null}

59Fai sapere a @api-worker che la migrazione dello schema è terminata49Fai sapere a @api-worker che la migrazione dello schema è terminata

74 64

75Il Claude ricevente legge il messaggio tra le chiamate agli strumenti durante un turno attivo, quindi uno strumento in esecuzione non viene mai interrotto. Quando la sessione ricevente è inattiva, Claude Code avvia un nuovo turno con il messaggio.65Il Claude ricevente legge il messaggio tra le chiamate agli strumenti durante un turno attivo, quindi uno strumento in esecuzione non viene mai interrotto. Quando la sessione ricevente è inattiva, Claude Code avvia un nuovo turno con il messaggio.

76 66

77Un messaggio da un'altra sessione arriva come testo semplice. Se menziona un file o una [risorsa MCP](/docs/it/mcp#use-mcp-resources) con `@`, Claude vede la menzione come scritta e Claude Code non allega nulla, indipendentemente dal fatto che il messaggio avvii un nuovo turno o arrivi durante uno. Claude può comunque aprire un percorso menzionato sulla macchina ricevente con i suoi strumenti, soggetto alle autorizzazioni di quella sessione. Prima della v2.1.251, una menzione `@` in un messaggio che ha avviato un nuovo turno allegava il file o la risorsa MCP sul lato ricevente.67Un messaggio da un'altra sessione arriva come testo semplice. Se menziona un file o una [risorsa MCP](/docs/it/mcp#use-mcp-resources) con `@`, Claude vede la menzione come scritta e Claude Code non allega nulla, indipendentemente dal fatto che il messaggio avvii un nuovo turno o arrivi durante uno. Claude può comunque aprire un percorso menzionato sulla macchina ricevente con i suoi stessi strumenti, soggetto alle autorizzazioni di quella sessione.

78 68

79Claude Code rifiuta un messaggio nei seguenti casi:69Claude Code rifiuta un messaggio nei seguenti casi:

80 70

81* Il messaggio è [oltre il limite di dimensione](#limitations). Claude Code lo rifiuta nella sessione di invio, prima che parta.71* Il messaggio è [oltre il limite di dimensione](#limitations). Claude Code lo rifiuta nella sessione di invio, prima che parta.

~~82* Un rapido burst a una sessione su questa macchina ha raggiunto [quello che la posta in arrivo di quella sessione accetta](#limitations). Claude Code rifiuta ulteriori messaggi a quella sessione.~~72* Un rapido flusso a una sessione su questa macchina ha raggiunto [quello che la posta in arrivo di quella sessione accetta](#limitations). Claude Code rifiuta ulteriori messaggi a quella sessione.

83* Il destinatario della risposta su questa macchina non supera un controllo di sicurezza, come un destinatario con collegamento simbolico o un endpoint che non è il processo previsto. [Rifiuto di inviare un messaggio tra sessioni](/docs/it/errors#refusing-to-send-a-cross-session-message) elenca questi controlli.73* Il destinatario della risposta su questa macchina non supera un controllo di sicurezza, come un destinatario con collegamento simbolico o un endpoint che non è il processo previsto. [Rifiuto di inviare un messaggio tra sessioni](/docs/it/errors#refusing-to-send-a-cross-session-message) elenca questi controlli.

~~84* Claude indirizza il messaggio al nome della sessione stessa, come descritto in [Vedi quali sessioni Claude può raggiungere](#see-which-sessions-claude-can-reach).~~

85 74

86La sessione ricevente controlla ogni messaggio in arrivo rispetto ai suoi [controlli in entrata](#control-inbound-messages), e il controllo termina in uno di tre risultati:75La sessione ricevente controlla ogni messaggio in arrivo rispetto ai suoi [controlli in entrata](#control-inbound-messages), e il controllo termina in uno di tre risultati:

87 76

88* **Consegnato**: Claude Code passa il messaggio al Claude ricevente.77* **Consegnato**: Claude Code passa il messaggio al Claude ricevente.

89* **Trattenuto**: Claude Code mette da parte il messaggio senza consegnarlo. Un messaggio trattenuto raggiunge Claude solo quando lo approvi o un cambio di modalità o impostazioni successivo lo consente.78* **Trattenuto**: Claude Code mette da parte il messaggio non consegnato. Un messaggio trattenuto raggiunge Claude solo quando lo approvi o un cambio di modalità o impostazioni successivo lo consente.

90* **Rifiutato**: Claude Code scarta il messaggio senza consegnarlo.79* **Rifiutato**: Claude Code scarta il messaggio senza consegnarlo.

91 80

92Una volta consegnato, il messaggio conta verso [l'utilizzo](/docs/it/costs) come un prompt che digiti, e il Claude ricevente può rispondere al mittente nello stesso modo, tranne nel [caso cross-machine unidirezionale](#message-sessions-on-other-machines).81Una volta consegnato, il messaggio conta verso [l'utilizzo](/docs/it/costs) come un prompt che digiti, e il Claude ricevente può rispondere al mittente nello stesso modo, tranne nel [caso cross-machine unidirezionale](#message-sessions-on-other-machines).

93 82

94I confini delle autorizzazioni rimangono per sessione. Claude è istruito a non chiedere mai a un'altra sessione un'azione che è stata negata o bloccata nella sua sessione, o che le sue stesse impostazioni di autorizzazione bloccherebbero, e a instradare quel lavoro di nuovo a te. Sul lato ricevente, i [prompt di autorizzazione della sessione ricevente e le regole si applicano ancora](#how-a-session-treats-an-incoming-message) a qualsiasi cosa il messaggio chieda.83I confini delle autorizzazioni rimangono per sessione. Claude è istruito a non chiedere mai a un'altra sessione un'azione che è stata negata o bloccata nella sua stessa sessione, o che le sue stesse impostazioni di autorizzazione bloccherebbero, e a instradare quel lavoro di nuovo a te. Dal lato ricevente, i [prompt di autorizzazione e le regole della sessione ricevente si applicano ancora](#how-a-session-treats-an-incoming-message) a qualsiasi cosa il messaggio chieda.

95 84

96<h3 id="get-a-notice-when-another-session-goes-idle">85<h3 id="get-a-notice-when-another-session-goes-idle">

~~97 Ricevi una notifica quando un'altra sessione diventa inattiva~~86 Ricevere un avviso quando un'altra sessione diventa inattiva

98</h3>87</h3>

99 88

100Claude può chiedere a una delle tue sessioni su questa macchina di inviare indietro una notifica quando quella sessione successivamente diventa inattiva o esce. Inattivo qui significa che la sessione ha terminato un turno senza nulla in coda. Usalo quando stai aspettando un'attività lunga in un'altra sessione e vuoi sapere quando è finita invece di controllare. Richiede Claude Code v2.1.236 o successivo in entrambe le sessioni.89Claude può chiedere a una delle tue sessioni su questa macchina di inviare indietro un avviso quando quella sessione successivamente diventa inattiva o esce. Inattivo qui significa che la sessione ha terminato un turno senza nulla in coda. Usalo quando stai aspettando un'attività lunga in un'altra sessione e vuoi sapere quando è finita invece di controllare. Richiede Claude Code v2.1.236 o successivo in entrambe le sessioni.

101 90

102<h4 id="ask-for-a-notice">91<h4 id="ask-for-a-notice">

103 Richiedi una notifica92 Richiedere un avviso

104</h4>93</h4>

105 94

106Dì a Claude cosa stai aspettando. Questo prompt richiede una notifica dalla sessione di migrazione:95Dì a Claude cosa stai aspettando. Questo prompt richiede un avviso dalla sessione di migrazione:

107 96

108```text wrap theme={null}97```text wrap theme={null}

109Dimmi quando la sessione di migrazione finisce quello su cui sta lavorando98Dimmi quando la sessione di migrazione finisce quello su cui sta lavorando

110```99```

111 100

112Claude si iscrive con l'input `notify_when_idle` dello strumento `SendMessage`, allegato a un messaggio che sta inviando comunque o da solo. Da solo, Claude Code si iscrive senza avviare un turno o spendere token nella sessione osservata, e invia la notifica subito se quella sessione è già inattiva. Allegato a un messaggio, Claude Code consegna prima il messaggio e invia la notifica dopo.101Claude si iscrive con l'input `notify_when_idle` dello strumento `SendMessage`, allegato a un messaggio che sta inviando comunque o da solo. Da solo, Claude Code si iscrive senza avviare un turno o spendere token nella sessione osservata, e invia l'avviso subito se quella sessione è già inattiva. Allegato a un messaggio, Claude Code consegna il messaggio prima e invia l'avviso dopo.

113 102

114<h4 id="what-each-session-shows">103<h4 id="what-each-session-shows">

115 Cosa mostra ogni sessione104 Cosa mostra ogni sessione

116</h4>105</h4>

117 106

118La sessione osservata mostra una riga che dice che un altro processo ha chiesto di essere avvisato quando la sessione successivamente diventa inattiva. La sessione che chiede mostra la notifica come una riga che nomina la sessione osservata. La riga può includere l'ora in cui il turno di quella sessione è terminato e uno stato di una riga da quel turno. Se la sessione che chiede è inattiva, Claude Code avvia un nuovo turno con la notifica.107La sessione osservata mostra una riga che dice che un altro processo ha chiesto di essere avvisato quando la sessione è successivamente inattiva. La sessione che chiede mostra l'avviso come una riga che nomina la sessione osservata. La riga può includere l'ora in cui il turno di quella sessione è terminato e uno stato di una riga da quel turno. Se la sessione che chiede è inattiva, Claude Code avvia un nuovo turno con l'avviso.

119 108

120<h4 id="limits">109<h4 id="limits">

121 Limiti110 Limiti

122</h4>111</h4>

123 112

124La notifica è una tantum: Claude Code la invia una volta dalla sessione osservata, e nessuna delle due sessioni esegue il polling dell'altra. Se nessuna notifica arriva entro 12 ore, Claude Code abbandona l'iscrizione e lo dice a Claude, quindi non continua ad aspettare.113Se nessun avviso arriva entro 12 ore, Claude Code abbandona l'iscrizione e lo dice a Claude, così non continua ad aspettare.

125 114

126I [controlli in entrata](#control-inbound-messages) di ogni lato si applicano a una notifica come a un messaggio:115I [controlli in entrata](#control-inbound-messages) di ogni lato si applicano a un avviso come a un messaggio:

127 116

128* **`refuse` su uno dei due lati**: nulla arriva. La sessione osservata abbandona la richiesta senza registrarla o rispondere, quindi l'iscrizione scade senza risposta dopo 12 ore, e una sessione che chiede con `refuse` non si iscrive mai.117* **`refuse` su entrambi i lati**: nulla arriva. La sessione osservata abbandona la richiesta senza registrarla o rispondere, quindi l'iscrizione scade senza risposta dopo 12 ore, e una sessione che chiede con `refuse` non si iscrive mai.

129* **`hold` su uno dei due lati**: la notifica arriva con meno. La sessione osservata lascia fuori lo stato di una riga, e la sessione che chiede mostra la notifica nella tua trascrizione senza consegnarla a Claude.118* **`hold` su entrambi i lati**: l'avviso arriva con meno. La sessione osservata lascia fuori lo stato di una riga, e la sessione che chiede mostra l'avviso nella tua trascrizione senza consegnarlo a Claude.

130 119

131Solo il Claude nella tua conversazione principale può iscriversi, e solo alle tue sessioni su questa macchina. Quando un subagent o un compagno di squadra di un team di agenti imposta `notify_when_idle`, Claude Code non effettua alcuna iscrizione e glielo dice. Quando Claude chiede una notifica da qualsiasi altro agente, come un compagno di squadra, un subagent o una sessione oltre questa macchina, Claude Code rifiuta l'intera chiamata, incluso qualsiasi messaggio allegato, e segnala il rifiuto a Claude in modo che possa rinviare il messaggio senza la richiesta.120Solo il Claude nella tua conversazione principale può iscriversi, e solo alle tue sessioni su questa macchina. Quando Claude chiede un avviso da qualsiasi altro destinatario, come un compagno di squadra, un subagent o una sessione oltre questa macchina, Claude Code rifiuta l'intera chiamata, incluso qualsiasi messaggio allegato ad essa.

132 121

133<h3 id="see-which-sessions-claude-can-reach">122<h3 id="see-which-sessions-claude-can-reach">

134 Vedi quali sessioni Claude può raggiungere123 Vedere quali sessioni Claude può raggiungere

135</h3>124</h3>

136 125

137Claude trova il destinatario di un messaggio da solo, quindi non hai bisogno di eseguire nulla prima di chiedergli di inviare. Per vedere tu stesso quali sessioni Claude può raggiungere, esegui il comando `/list-agents`. La prima riga, quando presente, è il nome della sessione stessa, quello che le tue altre sessioni usano per inviarle messaggi. Le righe sottostanti sono le sessioni che Claude può raggiungere:126Claude trova il destinatario di un messaggio da solo, quindi non hai bisogno di eseguire nulla prima di chiedergli di inviare. Per vedere tu stesso quali sessioni Claude può raggiungere, esegui il comando `/list-agents`. La prima riga, quando presente, è il nome di questa sessione, quello che le tue altre sessioni usano per inviarle messaggi. Le righe sottostanti sono le sessioni che Claude può raggiungere:

138 127

139* **Subagent**: agenti in esecuzione all'interno della sessione corrente.128* **Subagent**: agenti in esecuzione all'interno della sessione corrente.

140* **Compagni di squadra**: i compagni di squadra del [team di agenti](/docs/it/agent-teams) della sessione stessa. Prima della v2.1.239, i compagni di squadra non apparivano nell'elenco, anche se Claude poteva già inviar loro messaggi per nome.129* **Compagni di squadra**: i compagni di squadra del [team di agenti](/docs/it/agent-teams) di questa sessione.

141* **Le tue altre sessioni locali**: sessioni Claude Code in esecuzione sulla stessa macchina, incluse [sessioni in background](/docs/it/agent-view). Una sessione appare solo quando associa un [socket della posta in arrivo](#the-sessions-inbox-socket).130* **Le tue altre sessioni locali**: sessioni Claude Code in esecuzione sulla stessa macchina, incluse [sessioni in background](/docs/it/agent-view). Una sessione appare solo quando associa un [socket della posta in arrivo](#the-sessions-inbox-socket).

142* **Le tue [sessioni cloud](/docs/it/claude-code-on-the-web)**: mostrate mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control). Claude Code le etichetta `cloud` nell'elenco.131* **Le tue [sessioni cloud](/docs/it/claude-code-on-the-web)**: mostrate mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control).

143* **Le tue sessioni Remote Control su altre macchine**: mostrate mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control), ed etichettate `Remote Control`. Claude Code mostra `offline` come lo stato di una sessione la cui connessione Remote Control è caduta.132* **Le tue sessioni Remote Control su altre macchine**: mostrate mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control), ed etichettate `Remote Control`. Claude Code mostra `offline` come lo stato di una sessione la cui connessione Remote Control è caduta.

144 133

145Questa sessione non è una delle righe. Se Claude indirizza un messaggio al nome della sessione stessa, Claude Code lo rifiuta e dice a Claude che il destinatario è la sessione corrente. Prima della v2.1.239, l'elenco non mostrava il nome di questa sessione, e Claude Code segnalava un messaggio inviato a essa come un agente che non poteva trovare.

~~146~~

147Mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control), Claude Code trattiene alcuni dettagli delle tue sessioni locali dall'output `/list-agents`, senza cambiare quello che Claude stesso vede quando cerca una sessione a cui inviare un messaggio:134Mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control), Claude Code trattiene alcuni dettagli delle tue sessioni locali dall'output `/list-agents`, senza cambiare quello che Claude stesso vede quando cerca una sessione a cui inviare un messaggio:

148 135

149* **Directory di lavoro**: lascia fuori la directory di lavoro di ogni sessione locale.136* **Directory di lavoro**: lascia fuori la directory di lavoro di ogni sessione locale.

150* **Nomi delle sessioni**: lascia fuori qualsiasi nome di sessione che non può attribuire a una persona, quindi una riga rimasta senza nome legge `(unnamed session)`.137* **Nomi delle sessioni**: lascia fuori qualsiasi nome di sessione che non può attribuire a una persona, quindi una riga rimasta senza nome legge `(unnamed session)`.

151* **La prima riga**: lascia fuori la riga con il nome della sessione stessa a meno che tu non abbia digitato quel nome a questo terminale, con `--name` o con `/rename` e il nome, da quando hai lanciato o ripreso l'ultima volta la sessione.138* **La prima riga**: lascia fuori la riga con il nome di questa sessione a meno che tu non abbia digitato quel nome a questo terminale, con `--name` o con `/rename` e il nome, da quando hai avviato o ripreso l'ultima volta la sessione.

152 139

153Quando l'output elenca qualcosa, termina con una nota che dice che i dettagli sono stati trattenuti. Eseguire `/rename` seguito da un nome inutilizzato al terminale della sessione stessa dà a quella sessione un nome che appare nell'output.140Quando l'output elenca qualcosa, termina con una nota che dice che i dettagli sono stati trattenuti. Eseguire `/rename` seguito da un nome inutilizzato a una tastiera di sessione propria dà a quella sessione un nome che appare nell'output.

154 141

155Claude Code legge i tuoi elenchi di sessioni cloud e Remote Control dal più recente al più vecchio e si ferma dopo un numero limitato di pagine per ciascuno. Se il tuo account ha più di quelle sessioni di quante ne stiano, Claude Code non elenca le più vecchie, e Claude non può inviar loro messaggi per nome. Quando ciò accade, Claude Code lo dice nell'elenco, e Claude vede la stessa nota quando invia un messaggio.142Una sessione risponde al nome che hai impostato con il comando [`/rename`](/docs/it/commands) o il flag [`--name`](/docs/it/cli-reference#cli-flags). Quando non ne imposti uno, Claude Code nomina la sessione stesso. Per una sessione interattiva, questo è il nome mostrato negli [elenchi di sessioni in esecuzione](/docs/it/sessions#name-your-sessions).

156 143

157Claude indirizza una sessione oltre questa macchina per nome, nello stesso modo di una sessione locale. Vedi [Inviare messaggi a sessioni su altre macchine](#message-sessions-on-other-machines) per come quei messaggi viaggiano.144Quando rinomini una sessione, o avvii o riprendi una interattiva, con un nome che un'altra sessione live su questa macchina già usa, Claude Code lascia il nome con la sessione che lo ha già e [rinomina il tuo a una variante](/docs/it/sessions#name-your-sessions). Le sessioni possono comunque condividere un nome, ad esempio quando una di loro esegue una versione precedente di Claude Code o il nome condiviso è uno che Claude Code ha generato. A meno che questa sessione non sia connessa a Remote Control, Claude Code mostra la directory di lavoro di ogni sessione locale nell'output `/list-agents`, così puoi distinguere sessioni con lo stesso nome quando vengono eseguite in directory diverse. Claude indirizza il messaggio in uno di due modi, a seconda di quante sessioni live rispondono al nome:

~~158~~

159Una sessione risponde al nome che imposti con il comando [`/rename`](/docs/it/commands) o il flag [`--name`](/docs/it/cli-reference#cli-flags). Quando non ne imposti uno, Claude Code nomina la sessione stessa. Per una sessione interattiva, questo è il nome mostrato negli [elenchi di sessioni in esecuzione](/docs/it/sessions#name-your-sessions).

~~160~~

161Quando rinomini una sessione, Claude Code aggiorna anche il record condiviso che le tue altre sessioni usano per cercare il nome della sessione. Se non riesce ad aggiornare quel record, ti avverte nell'output `/rename` che altre sessioni potrebbero ancora mostrare il nome vecchio. Esegui la sessione con [`--debug`](/docs/it/cli-reference#cli-flags), e Claude Code registra la causa dell'aggiornamento fallito.

~~162~~

163Quando rinomini una sessione, o avvii o riprendi una sessione interattiva, con un nome che un'altra sessione live su questa macchina già usa, Claude Code lascia il nome con la sessione che lo ha già e [rinomina il tuo a una variante](/docs/it/sessions#name-your-sessions). Le sessioni possono comunque condividere un nome, ad esempio quando una di loro esegue una versione precedente di Claude Code o il nome condiviso è uno che Claude Code ha generato. A meno che questa sessione non sia connessa a Remote Control, Claude Code mostra la directory di lavoro di ogni sessione locale nell'output `/list-agents`, quindi puoi distinguere le sessioni con lo stesso nome quando vengono eseguite in directory diverse. Claude indirizza il messaggio in uno di due modi, a seconda di quante sessioni live rispondono al nome:

164 145

165* **Una sessione risponde al nome**: Claude Code consegna il messaggio solo sul nome.146* **Una sessione risponde al nome**: Claude Code consegna il messaggio solo sul nome.

166* **Diverse sessioni condividono il nome, o Claude Code non poteva controllare ovunque vengono eseguite le tue sessioni**: Claude aggiunge un breve identificatore a ogni riga del suo elenco e usa l'identificatore nell'indirizzo.147* **Diverse sessioni condividono il nome, o Claude Code non ha potuto controllare ovunque vengono eseguite le tue sessioni**: Claude aggiunge un breve identificatore a ogni riga del suo elenco e usa l'identificatore nell'indirizzo.

167 148

168<h3 id="message-sessions-on-other-machines">149<h3 id="message-sessions-on-other-machines">

169 Inviare messaggi a sessioni su altre macchine150 Inviare messaggi a sessioni su altre macchine

171 152

172Come un messaggio viaggia, e se passa attraverso i server Anthropic, dipende da dove viene eseguita la sessione di destinazione:153Come un messaggio viaggia, e se passa attraverso i server Anthropic, dipende da dove viene eseguita la sessione di destinazione:

173 154

174| Dove viene eseguita l'altra sessione | Come il messaggio viaggia |155| Dove viene eseguita l'altra sessione | Come viaggia il messaggio |

175| :- | :- |156| :- | :- |

176| Su questa macchina | Su un socket per sessione su macOS e Linux, o una named pipe per sessione su Windows nativo, mai attraverso i server Anthropic |157| Su questa macchina | Su un socket per sessione su macOS e Linux, o una named pipe per sessione su Windows nativo, mai attraverso i server Anthropic |

177| Su un'altra delle tue macchine | Attraverso i server Anthropic, arrivando sulla connessione [Remote Control](/docs/it/remote-control) di quella macchina |158| Su un'altra delle tue macchine | Attraverso i server Anthropic, arrivando sulla connessione [Remote Control](/docs/it/remote-control) di quella macchina |

178| Nel [cloud](/docs/it/claude-code-on-the-web) | Attraverso i server Anthropic, direttamente alla sessione cloud |159| Nel [cloud](/docs/it/claude-code-on-the-web) | Attraverso i server Anthropic, direttamente alla sessione cloud |

179 160

180Avviare una conversazione con una sessione su un'altra delle tue macchine richiede Claude Code v2.1.225 o successivo e un destinatario che [appare nell'elenco](#see-which-sessions-claude-can-reach). Prima della v2.1.225, Claude poteva solo rispondere a un messaggio che arrivava da uno.161Avviare una conversazione con una sessione su un'altra delle tue macchine richiede Claude Code v2.1.225 o successivo e un destinatario che [appare nell'elenco](#see-which-sessions-claude-can-reach).

~~181~~

182Puoi inviare un messaggio a una sessione mostrata come `offline` nell'[elenco](#see-which-sessions-claude-can-reach), una la cui connessione Remote Control è caduta. L'invio va a buon fine, ma il messaggio arriva solo dopo che la macchina di quella sessione si riconnette. Claude viene informato di questo quando invia.

183 162

184La consegna sulla stessa macchina funziona ovunque la funzione sia abilitata. Ogni sessione si registra in file su disco. Quando Claude elenca o invia messaggi alle tue sessioni locali, Claude Code legge quei file per trovare le sessioni, quindi due sessioni possono raggiungersi solo quando possono vedere gli stessi file.163Puoi inviare un messaggio a una sessione mostrata come `offline` nell'[elenco](#see-which-sessions-claude-can-reach), una la cui connessione Remote Control è caduta. L'invio va a buon fine, ma il messaggio arriva solo dopo che la macchina di quella sessione si riconnette.

185 164

186Un contenitore ha il suo proprio filesystem, quindi una sessione all'interno e una sessione sull'host non possono raggiungersi. Due sessioni all'interno dello stesso contenitore possono comunque inviarsi messaggi, incluso su un [runner self-hosted](/docs/it/self-hosted-environments). Una sessione all'interno di WSL 2 e una sessione Windows nativa sullo stesso computer non possono raggiungersi neanche, perché si registrano sotto directory home diverse e ascoltano su tipi di socket diversi.165Una sessione all'interno di un contenitore e una sessione sull'host non possono raggiungersi a vicenda. Due sessioni all'interno dello stesso contenitore possono comunque inviarsi messaggi a vicenda, incluso su un [runner self-hosted](/docs/it/self-hosted-environments). Una sessione all'interno di WSL 2 e una sessione Windows nativa sullo stesso computer non possono raggiungersi a vicenda neanche.

187 166

188Mentre questa sessione è connessa a Remote Control, quando invii un messaggio a una sessione su un'altra delle tue macchine, Claude Code mostra il messaggio nella conversazione di quella sessione sotto il nome Remote Control di questa sessione. Il Claude su quella macchina può rispondere a quel nome. Ad esempio, quando questa sessione è connessa a Remote Control come `laptop-graceful-unicorn` e invii un messaggio al tuo desktop, vedi il messaggio nella sessione del desktop sotto `laptop-graceful-unicorn`.167Se questa sessione non è connessa a Remote Control quando Claude invia a una sessione oltre questa macchina, il messaggio comunque va a buon fine, ma senza un [indirizzo di risposta](#what-a-message-looks-like), quindi il Claude ricevente non può rispondere.

~~189~~

190Se questa sessione non è connessa a Remote Control quando Claude invia a una sessione oltre questa macchina, il messaggio comunque va a buon fine, ma senza un [indirizzo di risposta](#what-a-message-looks-like), quindi il Claude ricevente non può rispondere. Claude viene informato di questo quando invia.

191 168

192Per richiedere la tua approvazione prima che qualsiasi messaggio vada oltre questa macchina, imposta [`isolatePeerMachines`](#require-approval-for-cross-machine-messages).169Per richiedere la tua approvazione prima che qualsiasi messaggio vada oltre questa macchina, imposta [`isolatePeerMachines`](#require-approval-for-cross-machine-messages).

193 170

206 Come appare un messaggio183 Come appare un messaggio

207</h3>184</h3>

208 185

209Quando un messaggio arriva, Claude Code lo mostra nella conversazione come un'anteprima di una riga attenuata, e la riga di anteprima rimane nella conversazione dopo. L'anteprima porta il nome del mittente e la prima riga del messaggio, tagliata con `…` quando è lunga, come `› Message from @api-worker: Schema migration finished (ctrl+o to expand)`. Prima della v2.1.247, Claude Code mostrava il messaggio in arrivo per intero invece di un'anteprima.186Quando un messaggio arriva, Claude Code lo mostra nella conversazione come un'anteprima di una riga attenuata, e la riga di anteprima rimane nella conversazione dopo. L'anteprima porta il nome del mittente e la prima riga del messaggio, tagliata con `…` quando è lunga, come `› Message from @api-worker: Schema migration finished (ctrl+o to expand)`.

210 187

211Uno di questi mostra il testo completo:188Uno di questi mostra il testo completo:

212 189

215 192

216L'anteprima accorcia solo quello che vedi. Che tu lo espanda o no, Claude legge il messaggio completo.193L'anteprima accorcia solo quello che vedi. Che tu lo espanda o no, Claude legge il messaggio completo.

217 194

218Claude riceve il messaggio con il nome del mittente e un indirizzo di risposta, tranne per un [messaggio cross-machine unidirezionale](#message-sessions-on-other-machines), che non porta alcun indirizzo di risposta. Oltre al nome e all'indirizzo di risposta, il Claude ricevente ottiene il testo del messaggio, mai la cronologia della conversazione o i file del mittente. [Consegna del messaggio](#message-delivery) copre le menzioni `@` nel testo.195Claude riceve il messaggio con il nome del mittente e un indirizzo di risposta, tranne per un [messaggio cross-machine unidirezionale](#message-sessions-on-other-machines), che non porta alcun indirizzo di risposta.

~~219~~

220Un messaggio che un [subagente](/docs/it/sub-agents) ha scritto arriva sotto il nome della sessione di invio, con il subagente identificato nel testo del messaggio. Una risposta ad esso raggiunge la conversazione principale di quella sessione, non il subagente.

221 196

222Questo esempio è un messaggio che un Claude ha scritto a un altro, come il suo testo completo legge quando lo espandi:197Questo esempio è un messaggio che un Claude ha scritto a un altro, come il suo testo completo legge quando lo espandi:

223 198

254* Quando la finestra di dialogo rimane senza risposta oltre la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), Claude Code la chiude e elimina il messaggio. La scadenza predefinita è cinque minuti.229* Quando la finestra di dialogo rimane senza risposta oltre la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), Claude Code la chiude e elimina il messaggio. La scadenza predefinita è cinque minuti.

255* Mentre nessun terminale è collegato a una [sessione in background](/docs/it/agent-view), Claude Code lascia la finestra di dialogo aperta oltre la scadenza. Dopo che colleghi, se la finestra di dialogo rimane senza risposta per un intero periodo di scadenza, Claude Code la chiude e elimina il messaggio.230* Mentre nessun terminale è collegato a una [sessione in background](/docs/it/agent-view), Claude Code lascia la finestra di dialogo aperta oltre la scadenza. Dopo che colleghi, se la finestra di dialogo rimane senza risposta per un intero periodo di scadenza, Claude Code la chiude e elimina il messaggio.

256* Se la classe di modalità di autorizzazione di questa sessione cambia mentre i messaggi sono trattenuti, Claude Code riapplica le regole in entrata, consegna i messaggi che ora accetta, e mostra un avviso.231* Se la classe di modalità di autorizzazione di questa sessione cambia mentre i messaggi sono trattenuti, Claude Code riapplica le regole in entrata, consegna i messaggi che ora accetta, e mostra un avviso.

257* Se un cambio di impostazioni fa applicare `refuse` mentre i messaggi sono trattenuti, Claude Code elimina ogni messaggio trattenuto e segnala un rifiuto a ogni mittente che può raggiungere.

~~258~~

259Quando il mittente è una sessione sulla stessa macchina, Claude Code invia un avviso indietro ad essa quando il ricevente trattiene il messaggio, e un follow-up quando il ricevente successivamente consegna, nega o lo fa scadere. L'avviso raggiunge il Claude di invio, quindi sa di non continuare ad aspettare un messaggio che l'altra sessione non ha letto.

~~260~~

261In una sessione di invio interattiva, l'avviso appare nella trascrizione. Un mittente [`claude -p`](/docs/it/headless) riceve in [output in streaming](/docs/it/headless#stream-responses) come un [messaggio `system` informativo](/docs/it/agent-sdk/typescript#sdkinformationalmessage). Gli avvisi ai mittenti `claude -p` richiedono Claude Code v2.1.271 o successiva.

262 232

263Se il ricevente rifiuta il messaggio, l'avviso del mittente dice che il ricevente non sta accettando messaggi tra sessioni e dice al Claude del mittente di non aspettare o rinviare.233Claude Code trattiene al massimo 100 messaggi, e oltre quello elimina i più vecchi.

~~264~~

265Claude Code trattiene al massimo 100 messaggi, separatamente dalla coda di consegna, e oltre quello elimina i più vecchi.

266 234

267<h3 id="non-interactive-sessions">235<h3 id="non-interactive-sessions">

268 Sessioni non interattive236 Sessioni non interattive

277 245

278Imposta `dialogExpiry` su `"never"` per mantenere i messaggi trattenuti dal default fino alla fine della sessione. Un messaggio trattenuto da un'impostazione `hold` esplicita non scade; Claude Code lo consegna solo quando un `accept` successivamente si applica.246Imposta `dialogExpiry` su `"never"` per mantenere i messaggi trattenuti dal default fino alla fine della sessione. Un messaggio trattenuto da un'impostazione `hold` esplicita non scade; Claude Code lo consegna solo quando un `accept` successivamente si applica.

279 247

280Quando la sessione termina con messaggi ancora trattenuti, Claude Code li segnala come scaduti a ogni mittente che può raggiungere. Prima della v2.1.225, nessuna scadenza si applicava in una sessione `-p`: un messaggio trattenuto rimaneva trattenuto a meno che un cambio di modalità di autorizzazione durante l'esecuzione lo consegnasse, e una sessione che terminava con messaggi trattenuti non segnalava nulla ai loro mittenti.

~~281~~

282Per far sì che un worker `-p` accetti messaggi incustodito, avvialo con `crossSessionInbound` impostato su `accept` nel suo valore `--settings`. Un `accept` nelle tue impostazioni utente funziona anche ma si applica a ogni sessione che esegui.248Per far sì che un worker `-p` accetti messaggi incustodito, avvialo con `crossSessionInbound` impostato su `accept` nel suo valore `--settings`. Un `accept` nelle tue impostazioni utente funziona anche ma si applica a ogni sessione che esegui.

283 249

284<h3 id="the-sessions-inbox-socket">250<h3 id="the-sessions-inbox-socket">

294* `/status` lo mostra nella riga `Peer address`. Il percorso è prefissato con `uds:`.260* `/status` lo mostra nella riga `Peer address`. Il percorso è prefissato con `uds:`.

295* Claude Code lo esporta a [hooks](/docs/it/hooks) e comandi Bash come la variabile di ambiente [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/it/env-vars#variables):261* Claude Code lo esporta a [hooks](/docs/it/hooks) e comandi Bash come la variabile di ambiente [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/it/env-vars#variables):

296 * In una sessione che inizia con la messaggistica attiva, Claude Code esporta la variabile prima che qualsiasi hook venga eseguito, incluso `SessionStart`.262 * In una sessione che inizia con la messaggistica attiva, Claude Code esporta la variabile prima che qualsiasi hook venga eseguito, incluso `SessionStart`.

297 * Ogni sessione esporta il suo socket, mai uno ereditato da una sessione genitore.

298 263

299Su macOS e Linux, Claude Code limita il socket al tuo utente del sistema operativo. Su Windows nativo, richiede invece a ogni connessione di autenticarsi prima con una chiave che solo il tuo utente del sistema operativo può leggere. In entrambi i casi, su una macchina condivisa le sessioni di un altro utente non possono consegnare ad esso.264Su macOS e Linux, Claude Code limita il socket al tuo utente del sistema operativo. Su Windows nativo, richiede invece a ogni connessione di autenticarsi prima con una chiave che solo il tuo utente del sistema operativo può leggere. In entrambi i casi, su una macchina condivisa le sessioni di un altro utente non possono consegnare ad esso.

300 265

307 272

308Apri la connessione solo quando il messaggio che stai pubblicando è pronto. Claude Code chiude una connessione che non ha inviato una riga completa entro 30 secondi, quindi cattura prima l'output di un comando lento e poi apri la connessione per inviarlo.273Apri la connessione solo quando il messaggio che stai pubblicando è pronto. Claude Code chiude una connessione che non ha inviato una riga completa entro 30 secondi, quindi cattura prima l'output di un comando lento e poi apri la connessione per inviarlo.

309 274

310I [messaggi propri-figli](#own-child-messages) sottostanti dicono quando Claude Code consulta il token e come tratta un messaggio che non può verificare.

~~311~~

312<span id="own-child-messages" />Claude Code esegue i messaggi in arrivo sul socket attraverso gli stessi [controlli in entrata](#control-inbound-messages) di qualsiasi altro messaggio peer, con un'eccezione e un prerequisito:275<span id="own-child-messages" />Claude Code esegue i messaggi in arrivo sul socket attraverso gli stessi [controlli in entrata](#control-inbound-messages) di qualsiasi altro messaggio peer, con un'eccezione e un prerequisito:

313 276

314* **Messaggi propri-figli**: quando nessun valore `crossSessionInbound` si applica, Claude Code consegna un messaggio che verifica è venuto dai processi figli della sessione stessa, come un hook o un comando Bash che pubblica di nuovo nel socket della posta in arrivo della sua stessa sessione.277* **Messaggi propri-figli**: quando nessun valore `crossSessionInbound` si applica, Claude Code consegna un messaggio che verifica è venuto dai processi figli della sessione stessa, come un hook o un comando Bash che pubblica di nuovo nel socket della posta in arrivo della sua stessa sessione.

382 * **Sessione cloud mancante**: una sessione cloud appare solo mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control).345 * **Sessione cloud mancante**: una sessione cloud appare solo mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control).

383 * **Sessione su un'altra macchina mancante**: una sessione su un'altra delle tue macchine appare solo quando viene eseguita con [Remote Control](/docs/it/remote-control) e questa sessione è connessa anche.346 * **Sessione su un'altra macchina mancante**: una sessione su un'altra delle tue macchine appare solo quando viene eseguita con [Remote Control](/docs/it/remote-control) e questa sessione è connessa anche.

384 * **Sessione su un'altra macchina `offline`**: un messaggio a una sessione elencata come `offline` va a buon fine, ma [arriva solo dopo che la macchina di quella sessione si riconnette](#message-sessions-on-other-machines).347 * **Sessione su un'altra macchina `offline`**: un messaggio a una sessione elencata come `offline` va a buon fine, ma [arriva solo dopo che la macchina di quella sessione si riconnette](#message-sessions-on-other-machines).

385 * **Sessione cloud o su un'altra macchina più vecchia mancante**: Claude Code [legge quegli elenchi di sessioni dal più recente al più vecchio e si ferma dopo un numero limitato di pagine](#see-which-sessions-claude-can-reach), quindi Claude non può inviare un messaggio a una sessione che è caduta oltre di loro per nome.348 * **Sessione cloud o su un'altra macchina più vecchia mancante**: Claude Code legge quegli elenchi di sessioni dal più recente al più vecchio e si ferma dopo un numero limitato di pagine, quindi Claude non può inviare un messaggio a una sessione che è caduta oltre di loro per nome.

386 * **Avvio di una conversazione**: [Invia messaggi a sessioni su altre macchine](#message-sessions-on-other-machines) copre l'avvio di una conversazione con una sessione oltre questa macchina.

387 349

388In una sessione con messaggistica, `/status` mostra anche una riga `Peer address` con l'indirizzo della posta in arrivo della sessione stessa, o `unavailable` e il motivo quando Claude Code [non poteva impostare una posta in arrivo](#the-sessions-inbox-socket).350In una sessione con messaggistica, `/status` mostra anche una riga `Peer address` con l'indirizzo della posta in arrivo della sessione stessa, o `unavailable` e il motivo quando Claude Code [non poteva impostare una posta in arrivo](#the-sessions-inbox-socket).

389 351

395 357

396* **Solo testo semplice**: Claude invia solo testo semplice tra sessioni. I messaggi del protocollo [team di agenti](/docs/it/agent-teams) strutturati rimangono all'interno di un team.358* **Solo testo semplice**: Claude invia solo testo semplice tra sessioni. I messaggi del protocollo [team di agenti](/docs/it/agent-teams) strutturati rimangono all'interno di un team.

397* **La dimensione del messaggio sulla stessa macchina è limitata**: Claude Code rifiuta un messaggio a una sessione su questa macchina una volta che la sua forma serializzata supera circa un milione di caratteri. Il rifiuto [nomina le dimensioni esatte](/docs/it/errors#message-too-large-for-cross-session-delivery). Nulla raggiunge la sessione ricevente.359* **La dimensione del messaggio sulla stessa macchina è limitata**: Claude Code rifiuta un messaggio a una sessione su questa macchina una volta che la sua forma serializzata supera circa un milione di caratteri. Il rifiuto [nomina le dimensioni esatte](/docs/it/errors#message-too-large-for-cross-session-delivery). Nulla raggiunge la sessione ricevente.

398* **I burst rapidi a una sessione vengono rifiutati al mittente**: una volta che un burst rapido di messaggi a una sessione su questa macchina raggiunge quello che la posta in arrivo di quella sessione accetta, Claude Code rifiuta ulteriori invii nella sessione di invio. Il [rifiuto nomina il burst](/docs/it/errors#too-many-messages-to-this-session-just-now) e dice a Claude di raggruppare il resto in un messaggio o aspettare. Prima della v2.1.236, Claude Code segnalava quegli invii come inviati mentre la sessione ricevente li eliminava.360* **I burst rapidi a una sessione vengono rifiutati al mittente**: una volta che un burst rapido di messaggi a una sessione su questa macchina raggiunge quello che la posta in arrivo di quella sessione accetta, Claude Code rifiuta ulteriori invii nella sessione di invio. Il [rifiuto nomina il burst](/docs/it/errors#too-many-messages-to-this-session-just-now) e dice a Claude di raggruppare il resto in un messaggio o aspettare.

399* **I loop di messaggi sono limitati**: nella sessione ricevente, Claude Code limita la velocità dei messaggi ripetuti per mittente, elimina i ripetuti identici che arrivano entro una breve finestra, e mette in coda al massimo 50 messaggi accettati per Claude da leggere. Un loop di messaggi tra due sessioni quindi si ferma da solo. Quando il limite di velocità, il controllo di ripetizione o il limite di coda elimina un messaggio da una sessione interattiva su questa macchina, Claude Code dice a quella sessione quale lo ha eliminato e dice al suo Claude di non rinviare subito.361* **I loop di messaggi sono limitati**: nella sessione ricevente, Claude Code limita la velocità dei messaggi ripetuti per mittente, elimina i ripetuti identici che arrivano entro una breve finestra, e mette in coda al massimo 50 messaggi accettati per Claude da leggere. Un loop di messaggi tra due sessioni quindi si ferma da solo.

400 362

401<h2 id="related-resources">363<h2 id="related-resources">

402 Risorse correlate364 Risorse correlate

405* [Subagenti](/docs/it/sub-agents#resume-subagents) e [team di agenti](/docs/it/agent-teams#messages-between-agents): messaggistica all'interno di una singola sessione o team367* [Subagenti](/docs/it/sub-agents#resume-subagents) e [team di agenti](/docs/it/agent-teams#messages-between-agents): messaggistica all'interno di una singola sessione o team

406* [Agenti in background](/docs/it/agent-view): invia e monitora le sessioni parallele che potresti inviare messaggi368* [Agenti in background](/docs/it/agent-view): invia e monitora le sessioni parallele che potresti inviare messaggi

407* [Remote Control](/docs/it/remote-control): connetti questa sessione per raggiungere le tue sessioni su altre macchine369* [Remote Control](/docs/it/remote-control): connetti questa sessione per raggiungere le tue sessioni su altre macchine

370* [Canali](/docs/it/channels): invia eventi esterni, come risultati CI o messaggi di chat, in una sessione

408* [Impostazioni](/docs/it/settings-reference#all-settings): `crossSessionInbound`, `isolatePeerMachines` e `dialogExpiry`371* [Impostazioni](/docs/it/settings-reference#all-settings): `crossSessionInbound`, `isolatePeerMachines` e `dialogExpiry`

409* [Modalità di autorizzazione](/docs/it/permission-modes): le modalità dietro il default in entrata delle due classi372* [Modalità di autorizzazione](/docs/it/permission-modes): le modalità dietro il default in entrata delle due classi

410* [Riferimento degli strumenti](/docs/it/tools-reference): le righe `ListAgents` e `SendMessage` nella tabella degli strumenti373* [Riferimento degli strumenti](/docs/it/tools-reference): le righe `ListAgents` e `SendMessage` nella tabella degli strumenti

data-usage.md +3 −3

Details

110 110

111Le sessioni [Claude Code sul web](/docs/it/claude-code-on-the-web) vengono eseguite in macchine virtuali gestite da Anthropic per impostazione predefinita invece che localmente. Le sessioni che la vostra organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite su infrastrutture che controllate; per sapere cosa rimane sulle vostre macchine e cosa va ancora ad Anthropic, consultate [Cosa rimane sulla vostra infrastruttura](/docs/it/self-hosted-environments#what-stays-on-your-infrastructure). Nelle sessioni cloud ospitate da Anthropic:111Le sessioni [Claude Code sul web](/docs/it/claude-code-on-the-web) vengono eseguite in macchine virtuali gestite da Anthropic per impostazione predefinita invece che localmente. Le sessioni che la vostra organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite su infrastrutture che controllate; per sapere cosa rimane sulle vostre macchine e cosa va ancora ad Anthropic, consultate [Cosa rimane sulla vostra infrastruttura](/docs/it/self-hosted-environments#what-stays-on-your-infrastructure). Nelle sessioni cloud ospitate da Anthropic:

112 112

113* **Archiviazione di codice e dati:** Il vostro repository viene clonato su una VM isolata. Il codice e i dati della sessione sono soggetti alle politiche di conservazione e utilizzo per il vostro tipo di account (consultate la sezione Conservazione dei dati sopra)113* **Archiviazione di codice e dati:** Il vostro repository viene clonato su una VM isolata. Anthropic archivia la trascrizione della sessione in modo che possiate tornare alla sessione in seguito. Il codice e i dati della sessione sono soggetti alle [politiche di conservazione e utilizzo](#data-retention) per il vostro tipo di account

114* **Credenziali:** L'autenticazione GitHub viene gestita tramite un proxy sicuro; le vostre credenziali GitHub non entrano mai nella sandbox114* **Credenziali:** Le credenziali GitHub vengono archiviate crittografate sui server di Anthropic e non entrano mai nella VM. Il traffico GitHub dalla VM passa attraverso un proxy Anthropic che le allega dal lato server

115* **Traffico di rete:** Tutto il traffico in uscita passa attraverso un proxy di sicurezza per la registrazione di audit e la prevenzione degli abusi115* **Traffico di rete:** Tutto il traffico in uscita passa attraverso un proxy di sicurezza per la registrazione di audit e la prevenzione degli abusi

116* **Dati della sessione:** I prompt, le modifiche al codice e gli output seguono le stesse politiche sui dati dell'utilizzo locale di Claude Code116* **Dati della sessione:** I prompt, le modifiche al codice e gli output seguono le stesse politiche sui dati dell'utilizzo locale di Claude Code

117 117

121 Servizi di telemetria121 Servizi di telemetria

122</h2>122</h2>

123 123

124Claude Code invia due tipi di telemetria operativa: metriche di utilizzo e rapporti di errore. Potete disattivare ciascuno individualmente con le variabili di ambiente di seguito, oppure disabilitare tutto il traffico non essenziale contemporaneamente impostando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. L'impostazione di `DISABLE_TELEMETRY` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` disabilita anche la valutazione dei flag di funzionalità da cui dipende [Remote Control](/docs/it/remote-control#requirements); `DISABLE_ERROR_REPORTING` non lo fa.124Claude Code invia due tipi di telemetria operativa: metriche di utilizzo e rapporti di errore. Potete disattivare ciascuno individualmente con le variabili di ambiente di seguito, oppure disabilitare tutto il traffico non essenziale contemporaneamente impostando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. L'impostazione di `DISABLE_TELEMETRY` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` disabilita anche la valutazione dei flag di funzionalità, che può rendere [Remote Control](/docs/it/remote-control#requirements) non disponibile; `DISABLE_ERROR_REPORTING` non lo fa.

125 125

126**Metriche**: latenza, affidabilità e modelli di utilizzo, inviati ad Anthropic e all'infrastruttura di registrazione di terze parti su TLS. Le metriche non includono mai il vostro codice, i prompt o i percorsi dei file. Impostate `DISABLE_TELEMETRY=1` per rinunciare.126**Metriche**: latenza, affidabilità e modelli di utilizzo, inviati ad Anthropic e all'infrastruttura di registrazione di terze parti su TLS. Le metriche non includono mai il vostro codice, i prompt o i percorsi dei file. Impostate `DISABLE_TELEMETRY=1` per rinunciare.

127 127

desktop.md +2 −2

Details

735 735

736Per impostare variabili di ambiente per le sessioni locali e i server di sviluppo su qualsiasi piattaforma, apri il menu a discesa dell'ambiente nella casella del prompt, passa il mouse su **Local** e fai clic sull'icona dell'ingranaggio per aprire l'editor di ambiente locale. Le variabili che salvi qui vengono archiviate crittografate sulla tua macchina e si applicano a ogni sessione locale e server di anteprima che avvii. Puoi anche aggiungere variabili alla chiave `env` nel tuo file `~/.claude/settings.json`, anche se queste raggiungono solo le sessioni Claude e non i server di sviluppo. Vedi [variabili di ambiente](/docs/it/env-vars) per l'elenco completo delle variabili supportate.736Per impostare variabili di ambiente per le sessioni locali e i server di sviluppo su qualsiasi piattaforma, apri il menu a discesa dell'ambiente nella casella del prompt, passa il mouse su **Local** e fai clic sull'icona dell'ingranaggio per aprire l'editor di ambiente locale. Le variabili che salvi qui vengono archiviate crittografate sulla tua macchina e si applicano a ogni sessione locale e server di anteprima che avvii. Puoi anche aggiungere variabili alla chiave `env` nel tuo file `~/.claude/settings.json`, anche se queste raggiungono solo le sessioni Claude e non i server di sviluppo. Vedi [variabili di ambiente](/docs/it/env-vars) per l'elenco completo delle variabili supportate.

737 737

738[Extended thinking](/docs/it/model-config#extended-thinking) è abilitato per impostazione predefinita, il che migliora le prestazioni su compiti di ragionamento complesso ma utilizza token aggiuntivi. Su Anthropic API, imposta `MAX_THINKING_TOKENS` a `0` nell'editor di ambiente locale per disattivare il thinking; questo non ha effetto su Opus 5.5 o sui Fable models, che utilizzano sempre extended thinking. Con il thinking disattivato su Anthropic API, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.738[Extended thinking](/docs/it/model-config#extended-thinking) è abilitato per impostazione predefinita, il che migliora le prestazioni su compiti di ragionamento complesso ma utilizza token aggiuntivi. Su Anthropic API, imposta `MAX_THINKING_TOKENS` a `0` nell'editor di ambiente locale per disattivare il thinking; questo non ha effetto su Opus 5.5, Sonnet 5.5 o sui Fable models, che utilizzano sempre extended thinking. Con il thinking disattivato su Anthropic API, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

739 739

740Su modelli con [adaptive reasoning](/docs/it/model-config#adjust-effort-level), i valori `MAX_THINKING_TOKENS` diversi da `0` vengono ignorati perché il adaptive reasoning controlla la profondità del thinking. Su Opus 4.6 e Sonnet 4.6, imposta `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` a `1` per usare un budget di thinking fisso; Fable models, Sonnet 5, e Opus 4.7 e versioni successive utilizzano sempre il adaptive reasoning e non hanno una modalità di budget fisso.740Su modelli con [adaptive reasoning](/docs/it/model-config#adjust-effort-level), i valori `MAX_THINKING_TOKENS` diversi da `0` vengono ignorati perché il adaptive reasoning controlla la profondità del thinking. Su Opus 4.6 e Sonnet 4.6, imposta `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` a `1` per usare un budget di thinking fisso; Fable models, Sonnet 5 e versioni successive, e Opus 4.7 e versioni successive utilizzano sempre il adaptive reasoning e non hanno una modalità di budget fisso.

741 741

742<h4 id="local-sessions-on-managed-devices">742<h4 id="local-sessions-on-managed-devices">

743 Local sessions on managed devices743 Local sessions on managed devices

desktop-scheduled-tasks.md +1 −1

Details

61 61

62* **Manual**: nessuna pianificazione, viene eseguita solo quando fai clic su **Run now**. Utile per salvare un prompt che attivi su richiesta62* **Manual**: nessuna pianificazione, viene eseguita solo quando fai clic su **Run now**. Utile per salvare un prompt che attivi su richiesta

63* **Hourly**: viene eseguita ogni ora63* **Hourly**: viene eseguita ogni ora

~~64* **Daily**: mostra un selettore di ora, per impostazione predefinita alle 9:00 AM ora locale~~64* **Daily**: viene eseguita ogni giorno all'ora locale che scegli

65* **Weekdays**: come Daily ma salta sabato e domenica65* **Weekdays**: come Daily ma salta sabato e domenica

66* **Weekly**: mostra un selettore di ora e un selettore di giorno66* **Weekly**: mostra un selettore di ora e un selettore di giorno

67 67

env-vars.md +24 −21

Details

114 114

115In un file di impostazioni potete impostare una variabile ma non potete rimuoverne una. Per sovrascrivere una variabile che non potete annullare, come una `CLAUDE_CODE_USE_VERTEX` obsoleta esportata da un profilo di shell che non controllate, impostatela su una stringa vuota nel blocco `env`: `"CLAUDE_CODE_USE_VERTEX": ""`. Claude Code tratta il valore vuoto come non impostato per la selezione del provider. I sottoprocessi ereditano comunque il valore vuoto.115In un file di impostazioni potete impostare una variabile ma non potete rimuoverne una. Per sovrascrivere una variabile che non potete annullare, come una `CLAUDE_CODE_USE_VERTEX` obsoleta esportata da un profilo di shell che non controllate, impostatela su una stringa vuota nel blocco `env`: `"CLAUDE_CODE_USE_VERTEX": ""`. Claude Code tratta il valore vuoto come non impostato per la selezione del provider. I sottoprocessi ereditano comunque il valore vuoto.

116 116

117Tra i file di impostazioni, i valori `env` seguono la [precedenza delle impostazioni](/docs/it/settings#settings-precedence), quindi una voce di impostazioni gestite sovrascrive la stessa variabile nelle impostazioni utente o progetto.117Tra i file di impostazioni, i valori `env` seguono la [precedenza delle impostazioni](/docs/it/settings#settings-precedence), quindi una voce di impostazioni gestite sovrascrive la stessa variabile nelle impostazioni utente o progetto. Le impostazioni di progetto e locali non possono impostare alcune variabili, come `CLAUDE_CONFIG_DIR` e le variabili dell'esportatore OpenTelemetry. [Le variabili che Claude Code ignora in `env`](/docs/it/settings-reference#variables-claude-code-ignores-in-env) le elenca, insieme ai valori di disattivazione di OpenTelemetry che si applicano ancora.

118 118

119Il modo in cui una variabile di ambiente interagisce con i flag CLI e i comandi in-session varia per funzionalità: `--model` e `/model` sovrascrivono `ANTHROPIC_MODEL`, mentre `CLAUDE_CODE_EFFORT_LEVEL` sovrascrive `--effort` e `/effort`. Quando una variabile interagisce con un'altra fonte di configurazione, la sua riga nell'elenco [Variabili](#variables) dichiara la precedenza o rimanda alla pagina che la documenta.119Il modo in cui una variabile di ambiente interagisce con i flag CLI e i comandi in-session varia per funzionalità: `--model` e `/model` sovrascrivono `ANTHROPIC_MODEL`, mentre `CLAUDE_CODE_EFFORT_LEVEL` sovrascrive `--effort` e `/effort`. Quando una variabile interagisce con un'altra fonte di configurazione, la sua riga nell'elenco [Variabili](#variables) dichiara la precedenza o rimanda alla pagina che la documenta.

120 120

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Impostare su `1` per mantenere disponibili gli strumenti del browser [Claude in Chrome](/docs/it/chrome) mentre si omette la sezione Chrome del prompt di sistema e la skill [bundled](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono la loro guida del browser. Richiede Claude Code v2.1.257 o successivo |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Impostare su `1` per mantenere disponibili gli strumenti del browser [Claude in Chrome](/docs/it/chrome) mentre si omette la sezione Chrome del prompt di sistema e la skill [bundled](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono la loro guida del browser. Richiede Claude Code v2.1.257 o successivo |

256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Impostare su `1` per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di memoria utente, progetto e automatica |256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Impostare su `1` per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di memoria utente, progetto e automatica |

257| `CLAUDE_CODE_DISABLE_CRON` | Impostare su `1` per disabilitare i [compiti programmati](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e qualsiasi compito già programmato smette di attivarsi, inclusi i compiti che sono già in esecuzione a metà sessione |257| `CLAUDE_CODE_DISABLE_CRON` | Impostare su `1` per disabilitare i [compiti programmati](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e qualsiasi compito già programmato smette di attivarsi, inclusi i compiti che sono già in esecuzione a metà sessione |

258| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Impostare su `1` per disattivare il limite di tempo sui prompt di [rimozione del percorso critico](/docs/it/permission-modes#critical-paths). In modalità `auto` Claude Code invia quindi queste rimozioni al classificatore, e in modalità `bypassPermissions` il prompt aspetta la vostra risposta. Impostatelo nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia consegnata attraverso un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successivo |

258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Impostare su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema dello strumento beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizzare quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. [Ricerca strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitata e tutti gli strumenti MCP si caricano in anticipo, anche quando impostate `ENABLE_TOOL_SEARCH`. Su Claude Code v2.1.227 o successivo, le [impostazioni gestite](/docs/it/managed-settings) possono mantenere la ricerca degli strumenti attiva. [Disabilitare le capacità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) copre dove si applica l'override |259| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Impostare su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema dello strumento beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizzare quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. [Ricerca strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitata e tutti gli strumenti MCP si caricano in anticipo, anche quando impostate `ENABLE_TOOL_SEARCH`. Su Claude Code v2.1.227 o successivo, le [impostazioni gestite](/docs/it/managed-settings) possono mantenere la ricerca degli strumenti attiva. [Disabilitare le capacità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) copre dove si applica l'override |

259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Impostare su `1` per disabilitare i [subagent Explore e Plan](/docs/it/sub-agents#built-in-subagents) incorporati. Claude esplora con i suoi strumenti di ricerca o il subagent di uso generale, e la [modalità piano](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente piuttosto che lanciare agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent incorporato in Agent SDK o modalità non interattiva, utilizzare `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successivo |260| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Impostare su `1` per disabilitare i [subagent Explore e Plan](/docs/it/sub-agents#built-in-subagents) incorporati. Claude esplora con i suoi strumenti di ricerca o il subagent di uso generale, e la [modalità piano](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente piuttosto che lanciare agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent incorporato in Agent SDK o modalità non interattiva, utilizzare `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successivo |

265| `CLAUDE_CODE_DISABLE_MOUSE` | Impostare su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Utilizzare per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale |266| `CLAUDE_CODE_DISABLE_MOUSE` | Impostare su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Utilizzare per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale |

266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Impostare su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento della rotella del mouse. Utilizzare quando desiderate che lo scorrimento della rotella funzioni all'interno di Claude Code ma non desiderate che i clic posizionino il cursore, espandano l'output dello strumento o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambi sono impostati. Richiede Claude Code v2.1.195 o successivo |267| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Impostare su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento della rotella del mouse. Utilizzare quando desiderate che lo scorrimento della rotella funzioni all'interno di Claude Code ma non desiderate che i clic posizionino il cursore, espandano l'output dello strumento o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambi sono impostati. Richiede Claude Code v2.1.195 o successivo |

267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Impostare su `1` per impedire a Claude Code di rileggere il [certificato client mTLS e la chiave](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un ripristino della connessione o un errore di handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo quando applica successivamente le impostazioni o al prossimo avvio. Richiede Claude Code v2.1.232 o successivo |268| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Impostare su `1` per impedire a Claude Code di rileggere il [certificato client mTLS e la chiave](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un ripristino della connessione o un errore di handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo quando applica successivamente le impostazioni o al prossimo avvio. Richiede Claude Code v2.1.232 o successivo |

268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Impostare su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: auto-aggiornamenti, telemetria, segnalazione di errori, il comando `/feedback`, [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), note di rilascio, i controlli del [badge di stato PR e MR](/docs/it/interactive-mode#pr-review-status), e i controlli di disponibilità come il controllo della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni in background delle fonti di comando del plugin](/docs/it/plugin-marketplaces#when-claude-code-re-runs-the-command), che sono comandi locali piuttosto che traffico di rete, perché possono attivare installazioni di dipendenze. **L'impostazione su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per consentirlo di nuovo. Disabilita anche il recupero dei flag di funzionalità, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. L'auto-installazione del marketplace ufficiale dei plugin non è coperta; disabilitarla con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sulla [scoperta del modello gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha il suo opt-in |269| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Impostare su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: auto-aggiornamenti, telemetria, segnalazione di errori, il comando `/feedback`, [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), note di rilascio, i controlli del [badge di stato PR e MR](/docs/it/interactive-mode#pr-review-status), e i controlli di disponibilità come il controllo della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni in background delle fonti di comando del plugin](/docs/it/plugins/loading#when-a-command-source-re-runs), che sono comandi locali piuttosto che traffico di rete, perché possono attivare installazioni di dipendenze. **L'impostazione su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per consentirlo di nuovo. Disabilita anche il recupero dei flag di funzionalità, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. L'auto-installazione del marketplace ufficiale dei plugin non è coperta; disabilitarla con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sulla [scoperta del modello gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha il suo opt-in |

269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Impostare su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà flusso. Gli errori di streaming si propagano al livello di ripetizione. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione dello strumento duplicata |270| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Impostare su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà flusso. Gli errori di streaming si propagano al livello di ripetizione. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione dello strumento duplicata |

270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Impostare su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre state digitando nel terminale o siete focalizzati su di esso. Per impostazione predefinita lo strumento salta sia la notifica desktop che il [push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva un'attività di tastiera recente o la messa a fuoco del terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere il push mobile quando rileva che siete attivi. Richiede Claude Code v2.1.193 o successivo |271| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Impostare su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre state digitando nel terminale o siete focalizzati su di esso. Per impostazione predefinita lo strumento salta sia la notifica desktop che il [push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva un'attività di tastiera recente o la messa a fuoco del terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere il push mobile quando rileva che siete attivi. Richiede Claude Code v2.1.193 o successivo |

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Impostare su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo di una macchina. Se la variabile è impostata a quel punto, Claude Code salta la registrazione in modo permanente. L'annullamento dell'impostazione della variabile in seguito non annulla il salto. Eseguire `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |272| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Impostare su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo di una macchina. Se la variabile è impostata a quel punto, Claude Code salta la registrazione in modo permanente. L'annullamento dell'impostazione della variabile in seguito non annulla il salto. Eseguire `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Impostare su `1` per impedire a Claude Code di eseguire i vostri [hook `Notification` per le richieste di autorizzazione senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo |273| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Impostare su `1` per impedire a Claude Code di eseguire i vostri [hook `Notification` per le richieste di autorizzazione senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Impostare su `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per le sessioni di container o CI che non dovrebbero caricare le skill fornite dall'operatore |274| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Impostare su `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per le sessioni di container o CI che non dovrebbero caricare le skill fornite dall'operatore |

275| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Impostare su `1` per disattivare il controllo dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) che nega i comandi incorporati `cmd` `rd`, `rmdir`, `del` e `erase` su un [percorso di sistema](/docs/it/permission-modes#remove-item-in-powershell), come una radice di unità o la vostra home directory. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.283 o successivo |

276| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Impostare su `1` per disattivare il controllo del [percorso critico](/docs/it/permission-modes#critical-paths) per un `rm` ricorsivo il cui target è interamente l'output di una sostituzione di comando, come `rm -rf "$(pwd)"`. Gli altri controlli del percorso critico continuano a funzionare. Impostatelo nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia consegnata attraverso un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successivo |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Impostare su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta del modello piccolo/veloce in background che [genera un titolo di sessione](/docs/it/sessions#name-your-sessions) |277| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Impostare su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta del modello piccolo/veloce in background che [genera un titolo di sessione](/docs/it/sessions#name-your-sessions) |

275| `CLAUDE_CODE_DISABLE_THINKING` | Impostare su `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il pensiero su Opus 5.5 o sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì |278| `CLAUDE_CODE_DISABLE_THINKING` | Impostare su `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il pensiero su Opus 5.5 o sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Impostare su `1` per saltare la [auto-compattazione](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo |279| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Impostare su `1` per saltare la [auto-compattazione](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo |

287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimosso nella v2.1.142, quando il predefinito della [modalità veloce](/docs/it/fast-mode) si è spostato da Opus 4.6 a Opus 4.7 |290| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimosso nella v2.1.142, quando il predefinito della [modalità veloce](/docs/it/fast-mode) si è spostato da Opus 4.6 a Opus 4.7 |

288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Impostare su `false` per disattivare i suggerimenti di prompt, le previsioni grigie che appaiono nel vostro input di prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quello che l'interruttore **Suggerimenti di prompt** in `/config` scrive. Claude Code inoltre [mette in pausa i suggerimenti mentre il vostro account è vicino o al limite di utilizzo](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Impostare su `true` per mantenerli attivi fino a raggiungere il limite. Richiede Claude Code v2.1.238 o successivo. Vedere [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |291| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Impostare su `false` per disattivare i suggerimenti di prompt, le previsioni grigie che appaiono nel vostro input di prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quello che l'interruttore **Suggerimenti di prompt** in `/config` scrive. Claude Code inoltre [mette in pausa i suggerimenti mentre il vostro account è vicino o al limite di utilizzo](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Impostare su `true` per mantenerli attivi fino a raggiungere il limite. Richiede Claude Code v2.1.238 o successivo. Vedere [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |

289| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività Claude Code fornisce nelle [sessioni che li hanno](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Impostare su `0` per ottenere lo strumento legacy `TodoWrite`. Vedere [Elenco attività](/docs/it/interactive-mode#task-list) |292| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività Claude Code fornisce nelle [sessioni che li hanno](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Impostare su `0` per ottenere lo strumento legacy `TodoWrite`. Vedere [Elenco attività](/docs/it/interactive-mode#task-list) |

290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Impostare su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e registrazione. Obbligatorio prima di configurare gli esportatori OTel. Vedere [Monitoraggio](/docs/it/monitoring-usage) |293| `CLAUDE_CODE_ENABLE_TELEMETRY` | Impostare su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e registrazione. Obbligatorio prima di configurare gli esportatori OTel. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Impostare su `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di esso, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successivo |294| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Impostare su `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di esso, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successivo |

292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da aspettare dopo che il ciclo di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |295| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da aspettare dopo che il ciclo di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |

293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Impostare su `1` per abilitare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |296| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Impostare su `1` per abilitare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |

341| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Impostare su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando è disponibile una nuova versione. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedere [Auto-aggiornamenti](/docs/it/setup#auto-updates) |344| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Impostare su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando è disponibile una nuova versione. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedere [Auto-aggiornamenti](/docs/it/setup#auto-updates) |

342| `CLAUDE_CODE_PERFORCE_MODE` | Impostare su `1` per abilitare la protezione da scrittura consapevole di Perforce. Quando impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca il bit di proprietario-scrittura, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |345| `CLAUDE_CODE_PERFORCE_MODE` | Impostare su `1` per abilitare la protezione da scrittura consapevole di Perforce. Quando impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca il bit di proprietario-scrittura, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |

343| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sostituire la directory radice dei plugin. Nonostante il nome, questo imposta la directory genitore, non la cache stessa: i marketplace e la cache dei plugin vivono in sottodirectory sotto questo percorso. Impostazione predefinita: `~/.claude/plugins` |346| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sostituire la directory radice dei plugin. Nonostante il nome, questo imposta la directory genitore, non la cache stessa: i marketplace e la cache dei plugin vivono in sottodirectory sotto questo percorso. Impostazione predefinita: `~/.claude/plugins` |

344| `CLAUDE_CODE_PLUGIN_DIRS` | Directory dei plugin da caricare per la sessione, ognuna caricata nel modo in cui un flag [`--plugin-dir`](/docs/it/plugins#test-your-plugins-locally) la carica. Separare più percorsi con `:` su Unix o `;` su Windows. Fornire ogni percorso come percorso assoluto o iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successivo |347| `CLAUDE_CODE_PLUGIN_DIRS` | Directory dei plugin da caricare per la sessione, ognuna caricata nel modo in cui un flag [`--plugin-dir`](/docs/it/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) la carica. Separare più percorsi con `:` su Unix o `;` su Windows. Fornire ogni percorso come percorso assoluto o iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successivo. Vedere [Caricare un plugin per una sessione](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) |

345| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumentare questo valore per repository grandi o connessioni di rete lente. Vedere [Le operazioni Git scadono](/docs/it/plugin-marketplaces#git-operations-time-out) |348| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumentare questo valore per repository grandi o connessioni di rete lente. Vedere [Le operazioni Git scadono](/docs/it/plugins/troubleshooting#git-clone-timed-out-after-120s) |

346| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Impostare su `1` per saltare il tentativo di re-clone e continuare a utilizzare il checkout del marketplace esistente quando un aggiornamento del marketplace non riesce a raggiungere o autenticarsi al remoto. Utile negli ambienti offline o airgapped dove il re-cloning fallirebbe allo stesso modo. Vedere [Gli aggiornamenti del marketplace falliscono negli ambienti offline](/docs/it/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |349| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Impostare su `1` per saltare il tentativo di re-clone e continuare a utilizzare il checkout del marketplace esistente quando un aggiornamento del marketplace non riesce a raggiungere o autenticarsi al remoto. Utile negli ambienti offline o airgapped dove il re-cloning fallirebbe allo stesso modo. Vedere [Gli aggiornamenti del marketplace falliscono negli ambienti offline](/docs/it/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

347| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Impostare su `1` per clonare le fonti di scorciatoia GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |350| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Impostare su `1` per clonare le fonti di scorciatoia GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |

348| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso a una o più directory di seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizzare per raggruppare una directory di plugin pre-popolata in un'immagine di container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati in cache senza re-clonare. Vedere [Pre-popolare i plugin per i container](/docs/it/plugin-marketplaces#pre-populate-plugins-for-containers) |351| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso a una o più directory di seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizzare per raggruppare una directory di plugin pre-popolata in un'immagine di container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati in cache senza re-clonare. Vedere [Pre-popolare i plugin per i container](/docs/it/plugins/org#seed-containers-and-ci) |

349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Impostare su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumenti, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite-Restricted. Il bypass a livello di processo non sostituisce mai la `MachinePolicy` o la `UserPolicy` di Group Policy indipendentemente da questa impostazione |352| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Impostare su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumenti, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite-Restricted. Il bypass a livello di processo non sostituisce mai la `MachinePolicy` o la `UserPolicy` di Group Policy indipendentemente da questa impostazione |

350| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite in millisecondi sull'attesa inattiva per i subagent in background e i flussi di lavoro dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude prende un turno per gestire un risultato in background. Predefinito: `600000`, o 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di aspettare i compiti in background rimanenti e esce. Impostare su `0` per aspettare indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica alle shell in background semplici. Richiede Claude Code v2.1.182 o successivo |353| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite in millisecondi sull'attesa inattiva per i subagent in background e i flussi di lavoro dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude prende un turno per gestire un risultato in background. Predefinito: `600000`, o 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di aspettare i compiti in background rimanenti e esce. Impostare su `0` per aspettare indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica alle shell in background semplici. Richiede Claude Code v2.1.182 o successivo |

351| `CLAUDE_CODE_PROCESS_WRAPPER` | Avviare i processi che Claude Code avvia dal suo binario, come il servizio in background che ospita le sessioni di [visualizzazione agente](/docs/it/agent-view), attraverso un launcher aziendale fornito come prefisso argv come `/opt/corp/launcher`. Impostatelo nel blocco `env` delle impostazioni utente o [gestite](/docs/it/managed-settings), non come esportazione di shell, in modo che il servizio in background staccato lo erediti; le impostazioni di progetto e locali non possono impostarlo. Equivalente all'impostazione [`processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successivo; questa variabile ha la precedenza quando entrambi sono impostati. L'estensione VS Code configura il suo launcher separatamente attraverso la sua impostazione `claudeProcessWrapper`. Ignorato su Windows. Vedere [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, cosa copre il launcher e il contratto che il launcher deve soddisfare. Richiede Claude Code v2.1.208 o successivo |354| `CLAUDE_CODE_PROCESS_WRAPPER` | Avviare i processi che Claude Code avvia dal suo binario, come il servizio in background che ospita le sessioni di [visualizzazione agente](/docs/it/agent-view), attraverso un launcher aziendale fornito come prefisso argv come `/opt/corp/launcher`. Impostatelo nel blocco `env` delle impostazioni utente o [gestite](/docs/it/managed-settings), non come esportazione di shell, in modo che il servizio in background staccato lo erediti; le impostazioni di progetto e locali non possono impostarlo. Equivalente all'impostazione [`processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successivo; questa variabile ha la precedenza quando entrambi sono impostati. L'estensione VS Code configura il suo launcher separatamente attraverso la sua impostazione `claudeProcessWrapper`. Ignorato su Windows. Vedere [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, cosa copre il launcher e il contratto che il launcher deve soddisfare. Richiede Claude Code v2.1.208 o successivo |

360| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Impostare su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di inviare di nuovo il prompt. Per disattivare questo, annullare l'impostazione della variabile o impostarla su `0`. Prima della v2.1.221, Claude Code ignorava `0` e altri valori falsy, quindi l'impostazione di `0` attivava comunque la ripresa in modalità non interattiva e l'annullamento dell'impostazione della variabile era l'unico modo per disattivarla |363| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Impostare su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di inviare di nuovo il prompt. Per disattivare questo, annullare l'impostazione della variabile o impostarla su `0`. Prima della v2.1.221, Claude Code ignorava `0` e altri valori falsy, quindi l'impostazione di `0` attivava comunque la ripresa in modalità non interattiva e l'annullamento dell'impostazione della variabile era l'unico modo per disattivarla |

361| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione che è terminata a metà turno continui automaticamente al ripristino. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta sia la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` che il messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT` iniettato, e la sessione inizia inattiva in modo che continuiate esplicitamente. Non impostato o `0` significa nessun limite, tranne che un turno la cui ultima richiesta ha fallito con un errore API riprende solo mentre quell'errore è inferiore a sei ore. Un valore positivo limita ogni turno, inclusi quelli; un valore negativo o non numerico applica un limite di un'ora. Gli script di generazione per agenti a lunga esecuzione possono impostare questo in modo che un riavvio rispetto a una trascrizione vecchia non ri-esegua un prompt stantio. Claude Code imposta un limite di un'ora da solo quando riavvia una sessione di [visualizzazione agente](/docs/it/agent-view) bloccata che ha ereditato la sua conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successivo |364| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione che è terminata a metà turno continui automaticamente al ripristino. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta sia la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` che il messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT` iniettato, e la sessione inizia inattiva in modo che continuiate esplicitamente. Non impostato o `0` significa nessun limite, tranne che un turno la cui ultima richiesta ha fallito con un errore API riprende solo mentre quell'errore è inferiore a sei ore. Un valore positivo limita ogni turno, inclusi quelli; un valore negativo o non numerico applica un limite di un'ora. Gli script di generazione per agenti a lunga esecuzione possono impostare questo in modo che un riavvio rispetto a una trascrizione vecchia non ri-esegua un prompt stantio. Claude Code imposta un limite di un'ora da solo quando riavvia una sessione di [visualizzazione agente](/docs/it/agent-view) bloccata che ha ereditato la sua conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successivo |

362| `CLAUDE_CODE_RESUME_PROMPT` | Sostituire il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Impostazione predefinita: `Continue from where you left off.`. Gli script di generazione per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il predefinito |365| `CLAUDE_CODE_RESUME_PROMPT` | Sostituire il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Impostazione predefinita: `Continue from where you left off.`. Gli script di generazione per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il predefinito |

363| `CLAUDE_CODE_RETRY_WATCHDOG` | Impostare su `1` per le sessioni non presidiate come harness di valutazione, lavori CI o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429`che segnala un limite di spesa o crediti di utilizzo esauriti, anche uno da un [limite di spesa gateway](/docs/it/errors#spend-limit-reached) che si ripristina su un programma. Prima della v2.1.239, il watchdog ritentava questi indefinitamente. Per le richieste in modalità veloce, vedere [Gestire i limiti di velocità](/docs/it/fast-mode#handle-rate-limits). Il watchdog fa un backup fino a 5 minuti tra i tentativi, o fino al ripristino del limite quando la risposta trasporta un tempo di ripristino del limite di velocità, quindi una sessione che colpisce un limite di utilizzo aspetta la finestra rimanente. Su v2.1.199 o successivo aumenta anche il conteggio di ripetizione predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backup, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se impostate esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successivo |366| `CLAUDE_CODE_RETRY_WATCHDOG` | Impostare su `1` per le sessioni non presidiate come harness di valutazione, lavori CI o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche uno da un [limite di spesa gateway](/docs/it/errors#spend-limit-reached) che si ripristina su un programma. Prima della v2.1.239, il watchdog ritentava questi indefinitamente. Per le richieste in modalità veloce, vedere [Gestire i limiti di velocità](/docs/it/fast-mode#handle-rate-limits). Il watchdog fa un backup fino a 5 minuti tra i tentativi, o fino al ripristino del limite quando la risposta trasporta un tempo di ripristino del limite di velocità, quindi una sessione che colpisce un limite di utilizzo aspetta la finestra rimanente. Su v2.1.199 o successivo aumenta anche il conteggio di ripetizione predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backup, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se impostate esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successivo |

364| `CLAUDE_CODE_SAFE_MODE` | Impostare su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e suggerimento di file, server LSP e memoria automatica non si caricano, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la linea di stato e i comandi di suggerimento di file; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla politica non si caricano. Equivalente a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figlio generati direttamente ereditano la variabile |367| `CLAUDE_CODE_SAFE_MODE` | Impostare su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e suggerimento di file, server LSP e memoria automatica non si caricano, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la linea di stato e i comandi di suggerimento di file; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla politica non si caricano. Equivalente a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figlio generati direttamente ereditano la variabile |

365| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di conteggio di interi. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe in modo che i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contino comunque contro il limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità |368| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di conteggio di interi. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe in modo che i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contino comunque contro il limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità |

366| `CLAUDE_CODE_SCROLL_SPEED` | Impostare il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento del trackpad e della rotella accelerato nei terminali che già amplificano gli eventi della rotella. Impostare su `3` per corrispondere a `vim` se il vostro terminale invia un evento della rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza la sua gestione dello scorrimento |369| `CLAUDE_CODE_SCROLL_SPEED` | Impostare il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento del trackpad e della rotella accelerato nei terminali che già amplificano gli eventi della rotella. Impostare su `3` per corrispondere a `vim` se il vostro terminale invia un evento della rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza la sua gestione dello scorrimento |

441| `DISABLE_PROMPT_CACHING` | Impostare su `1` per disabilitare la [memorizzazione in cache del prompt](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |444| `DISABLE_PROMPT_CACHING` | Impostare su `1` per disabilitare la [memorizzazione in cache del prompt](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |

442| `DISABLE_PROMPT_CACHING_FABLE` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Fable |445| `DISABLE_PROMPT_CACHING_FABLE` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Fable |

443| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Haiku |446| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching), ovunque venga eseguito |

444| `DISABLE_PROMPT_CACHING_OPUS` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Opus |447| `DISABLE_PROMPT_CACHING_OPUS` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Opus |

445| `DISABLE_PROMPT_CACHING_SONNET` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Sonnet |448| `DISABLE_PROMPT_CACHING_SONNET` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Sonnet |

446| `DISABLE_TELEMETRY` | Impostare su qualsiasi valore non vuoto, come `1`, per rinunciare alla telemetria. **L'impostazione su `0` o `false` rinuncia comunque**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità con lo stesso effetto di `DISABLE_GROWTHBOOK`, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Vedere [Disattivare la telemetria per la vostra organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |449| `DISABLE_TELEMETRY` | Impostare su qualsiasi valore non vuoto, come `1`, per rinunciare alla telemetria. **L'impostazione su `0` o `false` rinuncia comunque**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Vedere [Disattivare la telemetria per la vostra organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |

447| `DISABLE_UPDATES` | Impostare su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizzare quando si distribuisce Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornare |450| `DISABLE_UPDATES` | Impostare su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizzare quando si distribuisce Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornare |

449| `DO_NOT_TRACK` | Impostare su `1` per rinunciare alla telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso il rendere [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Claude Code legge questa variabile come un booleano standard, quindi `0` lascia la telemetria attiva e la onora come la convenzione tra strumenti riconosciuta da molti CLI di sviluppatori |452| `DO_NOT_TRACK` | Impostare su `1` per rinunciare alla telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso il rendere [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Claude Code legge questa variabile come un booleano standard, quindi `0` lascia la telemetria attiva e la onora come la convenzione tra strumenti riconosciuta da molti CLI di sviluppatori |

461| `IS_DEMO` | Impostare su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. **L'impostazione su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione |464| `IS_DEMO` | Impostare su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. **L'impostazione su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione |

462| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da quei strumenti è comunque soggetto a questa variabile (predefinito: 25000) |465| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da quei strumenti è comunque soggetto a questa variabile (predefinito: 25000) |

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di [flusso di lavoro](/docs/it/workflows) non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro tentativi |466| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo [`--json-schema`](/docs/it/cli-reference#cli-flags) in modal non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di [flusso di lavoro](/docs/it/workflows) non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro tentativi |

464| `MAX_THINKING_TOKENS` | Budget di token fisso per il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token al di sotto dei token di output massimi della richiesta e mai al di sotto di 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il pensiero è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la loro profondità di pensiero e gli altri modelli utilizzano il limite. Impostare su `0` per disabilitare il pensiero sull'API Anthropic, tranne su Opus 5.5 e sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `0` omette il parametro `thinking`. Con il pensiero disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |467| `MAX_THINKING_TOKENS` | Budget di token fisso per il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token al di sotto dei token di output massimi della richiesta e mai al di sotto di 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il pensiero è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la loro profondità di pensiero e gli altri modelli utilizzano il limite. Impostare su `0` per disabilitare il pensiero sull'API Anthropic, tranne su Opus 5.5 e sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `0` omette il parametro `thinking`. Con il pensiero disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |

465| `MCP_CLIENT_SECRET` | Segreto client OAuth per i server MCP che richiedono [credenziali pre-configurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita il prompt interattivo quando si aggiunge un server con `--client-secret` |468| `MCP_CLIENT_SECRET` | Segreto client OAuth per i server MCP che richiedono [credenziali pre-configurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita il prompt interattivo quando si aggiunge un server con `--client-secret` |

466| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio aspetta i server MCP per connettersi prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare su `0` per fare in modo che Claude Code aspetti i server per connettersi prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla [cache di scoperta](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passate [`--mcp-config`](/docs/it/cli-reference#cli-flags) esplicitamente, l'attesa ha una scadenza più lunga; vedere la voce di quel flag per l'eccezione del server memorizzato in cache |469| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio aspetta i server MCP per connettersi prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare su `0` per fare in modo che Claude Code aspetti i server per connettersi prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla [cache di scoperta](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passate [`--mcp-config`](/docs/it/cli-reference#cli-flags) esplicitamente, l'attesa ha una scadenza più lunga; vedere la voce di quel flag per l'eccezione del server memorizzato in cache |

478| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade anche dopo 60 secondi per impostazione predefinita; impostare questa variabile o il `timeout` per server sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout di esecuzione dello strumento complessivo ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sostituisce questo per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate di strumento di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo floor richiede Claude Code v2.1.203 o successivo. Per la variabile env, i valori inferiori a 1000 sono limitati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |481| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade anche dopo 60 secondi per impostazione predefinita; impostare questa variabile o il `timeout` per server sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout di esecuzione dello strumento complessivo ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sostituisce questo per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate di strumento di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo floor richiede Claude Code v2.1.203 o successivo. Per la variabile env, i valori inferiori a 1000 sono limitati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |

480| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard OpenTelemetry SDK sulla lunghezza del valore dell'attributo. Claude Code limita gli attributi di telemetria che trasportano contenuto al minore di questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento rimanga entro il limite dell'SDK. Claude Code legge le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` allo stesso modo e il valore più piccolo impostato si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |483| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard OpenTelemetry SDK sulla lunghezza del valore dell'attributo. Claude Code limita gli attributi di telemetria che trasportano contenuto al minore di questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento rimanga entro il limite dell'SDK. Claude Code legge le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` allo stesso modo e il valore più piccolo impostato si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |

481| `OTEL_LOG_ASSISTANT_RESPONSES` | Impostare su `1` per includere il testo della risposta del modello sugli eventi di log OpenTelemetry `assistant_response`. Quando non impostato, viene utilizzato il valore di `OTEL_LOG_USER_PROMPTS`. Impostare su `0` per mantenere le risposte redatte anche quando `OTEL_LOG_USER_PROMPTS` è impostato. Richiede Claude Code v2.1.193 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |484| `OTEL_LOG_ASSISTANT_RESPONSES` | Impostare su `1` per includere il testo della risposta del modello sugli eventi di log OpenTelemetry `assistant_response`. Quando non impostato, viene utilizzato il valore di `OTEL_LOG_USER_PROMPTS`. Impostare su `0` per mantenere le risposte redatte anche quando `OTEL_LOG_USER_PROMPTS` è impostato. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori off che quella sezione descrive. Richiede Claude Code v2.1.193 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |

482| `OTEL_LOG_MANAGED_SETTINGS` | Impostare su `1` per aggiungere le impostazioni gestite redatte e un digest SHA-256 delle impostazioni prima della redazione agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitato per impostazione predefinita. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite; un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |485| `OTEL_LOG_MANAGED_SETTINGS` | Impostare su `1` per aggiungere le impostazioni gestite redatte e un digest SHA-256 delle impostazioni prima della redazione agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitato per impostazione predefinita. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite; un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |

483| `OTEL_LOG_RAW_API_BODIES` | Emettere il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Impostare su `1` per i corpi in linea troncati al limite di contenuto, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Vedere [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |486| `OTEL_LOG_RAW_API_BODIES` | Emettere il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Impostare su `1` per i corpi in linea troncati al limite di contenuto, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Vedere [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |

484| `OTEL_LOG_TOOL_CONTENT` | Impostare su `1` per includere il contenuto dello strumento nell'evento di intervallo OpenTelemetry `tool.output`. Gli attributi di intervallo trasportano il contenuto dello strumento sotto i [loro propri gate](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracciamento](/docs/it/monitoring-usage#traces-beta). Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedere [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |487| `OTEL_LOG_TOOL_CONTENT` | Impostare su `1` per includere il contenuto dello strumento nell'evento di intervallo OpenTelemetry `tool.output`. Gli attributi di intervallo trasportano il contenuto dello strumento sotto i [loro propri gate](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracciamento](/docs/it/monitoring-usage#traces-beta). Disabilitato per impostazione predefinita per proteggere i dati sensibili. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori off che quella sezione descrive. Vedere [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |

485| `OTEL_LOG_TOOL_DETAILS` | Impostare su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, i nomi dei flussi di lavoro creati dall'utente, le stringhe di errore grezze sui fallimenti degli strumenti, la `category` di rifiuto sugli eventi `api_refusal` e altri dettagli dello strumento nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le PII. Vedere [Monitoraggio](/docs/it/monitoring-usage) |488| `OTEL_LOG_TOOL_DETAILS` | Impostare su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, i nomi dei flussi di lavoro creati dall'utente, le stringhe di errore grezze sui fallimenti degli strumenti, la `category` di rifiuto sugli eventi `api_refusal` e altri dettagli dello strumento nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le PII. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori off che quella sezione descrive. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

486| `OTEL_LOG_USER_PROMPTS` | Impostare su `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedere [Monitoraggio](/docs/it/monitoring-usage) |489| `OTEL_LOG_USER_PROMPTS` | Impostare su `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori off che quella sezione descrive. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

487| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Impostare su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |490| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Impostare su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

488| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Impostare su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto nella v2.1.152. Vedere [Monitoraggio](/docs/it/monitoring-usage) |491| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Impostare su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto nella v2.1.152. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

489| `OTEL_METRICS_INCLUDE_REPOSITORY` | Impostare su `true` per taggare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Vedere [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |492| `OTEL_METRICS_INCLUDE_REPOSITORY` | Impostare su `true` per taggare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Vedere [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |

514 517

515Sono supportate anche le variabili dell'esportatore OpenTelemetry standard (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e varianti specifiche del segnale). Vedere [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.518Sono supportate anche le variabili dell'esportatore OpenTelemetry standard (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e varianti specifiche del segnale). Vedere [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.

516 519

520Impostare `CLAUDE_CODE_ENABLE_TELEMETRY` e le variabili OpenTelemetry che attivano l'esportazione, scelgono la sua destinazione o acquisiscono il contenuto nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignica questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora questi nella vostra shell, impostazioni utente o impostazioni gestite. Claude Code \[ignora

521

517<h2 id="features-that-need-feature-flag-fetching">522<h2 id="features-that-need-feature-flag-fetching">

518 Funzionalità che richiedono il recupero dei feature flag523 Funzionalità che richiedono il recupero dei feature flag

519</h2>524</h2>

526 531

527Con il recupero disattivato, non potete:532Con il recupero disattivato, non potete:

528 533

529* [Avviare sessioni in modalità auto per impostazione predefinita](/docs/it/permission-modes#which-mode-a-session-starts-in) sui piani Pro, Max e Team

530* Far [leggere all'estensione VS Code i file di impostazioni per la modalità di autorizzazione iniziale](/docs/it/permission-modes#switch-permission-modes)

531* Eseguire [`/auto-mode-setup`](/docs/it/auto-mode-config#generate-environment-entries) per elaborare le voci `autoMode.environment`534* Eseguire [`/auto-mode-setup`](/docs/it/auto-mode-config#generate-environment-entries) per elaborare le voci `autoMode.environment`

532* Utilizzare [Remote Control](/docs/it/remote-control#requirements)535* Utilizzare [Remote Control](/docs/it/remote-control) con `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK` impostati. Per `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consultate i [requisiti di Remote Control](/docs/it/remote-control#requirements)

533* [Inviare messaggi alle sessioni oltre questa macchina](/docs/it/cross-session-messaging#message-sessions-on-other-machines); la messaggistica tra sessioni su questa macchina funziona con il recupero disattivato536* [Inviare messaggi alle sessioni oltre questa macchina](/docs/it/cross-session-messaging#message-sessions-on-other-machines) quando [Remote Control](/docs/it/remote-control#requirements) non è disponibile. La messaggistica tra sessioni su questa macchina funziona con il recupero disattivato

534* Eseguire [`claude import` o il comando `/import`](/docs/it/cli-reference#cli-commands)537* Eseguire [`claude import` o il comando `/import`](/docs/it/cli-reference#cli-commands)

535* Eseguire [`/skill-doctor`](/docs/it/skills#find-unused-skills) o aprire il suo rapporto nella scheda **Stats** di `/plugin`538* Eseguire [`/skill-doctor`](/docs/it/skills#find-unused-skills) o aprire il suo rapporto nella scheda **Stats** di `/plugin`

536* Sincronizzare le [skill](/docs/it/skills#where-synced-skills-load) e i [plugin](/docs/it/plugins-reference#synced-plugins) abilitati per il vostro account claude.ai nelle vostre sessioni di terminale539* Sincronizzare le [skill](/docs/it/skills#where-synced-skills-load) e i [plugin](/docs/it/plugins/loading#synced-plugins) abilitati per il vostro account claude.ai nelle vostre sessioni di terminale

537* Utilizzare [lo strumento advisor](/docs/it/advisor#requirements)540* Utilizzare [lo strumento advisor](/docs/it/advisor#requirements)

538* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)541* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)

539* Avere Claude Code sondare i server del connettore claude.ai per [la revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes) a meno che non impostiate `MCP_PROTOCOL_NEGOTIATION=auto`542* Avere Claude Code sondare i server del connettore claude.ai per [la revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes) a meno che non impostiate `MCP_PROTOCOL_NEGOTIATION=auto`

546 Prima sessione dopo un'installazione o un aggiornamento549 Prima sessione dopo un'installazione o un aggiornamento

547</h3>550</h3>

548 551

549Nella vostra prima sessione dopo aver installato Claude Code, o aggiornato a una versione che aggiunge una funzionalità, una [funzionalità con gate flag](#features-that-need-feature-flag-fetching) può mancare, e la sessione può avviarsi in modalità Manual su un piano che altrimenti si avvia in modalità auto. Claude Code recupera i flag durante quella sessione, quindi entrambi sono presenti nella vostra sessione successiva.552Nella vostra prima sessione dopo aver installato Claude Code, o aggiornato a una versione che aggiunge una funzionalità, una [funzionalità con gate flag](#features-that-need-feature-flag-fetching) può mancare. Quella sessione può anche avviarsi in una diversa [modalità di autorizzazione](/docs/it/permission-modes#which-mode-a-session-starts-in) rispetto alle vostre sessioni successive. Claude Code recupera i flag durante quella sessione, quindi la vostra sessione successiva ha la funzionalità e la modalità di autorizzazione iniziale usuale.

550 553

551Dopo un'installazione pulita, in una sessione non interattiva come `claude -p`, l'Agent SDK, o l'estensione VS Code, Claude Code può comunque recuperare i flag prima di [scegliere la modalità di autorizzazione iniziale](/docs/it/permission-modes#which-mode-a-session-starts-in).554Dopo un'installazione pulita, in una sessione non interattiva come `claude -p`, l'Agent SDK, o l'estensione VS Code, Claude Code può comunque recuperare i flag prima di [scegliere la modalità di autorizzazione iniziale](/docs/it/permission-modes#which-mode-a-session-starts-in).

552 555

errors.md +460 −87

Details

4 4

5# Riferimento degli errori5# Riferimento degli errori

6 6

~~7> Consulta i messaggi di errore runtime di Claude Code con il significato di ciascuno e come risolverli.~~7> Consulta i messaggi di errore di runtime di Claude Code con il significato di ciascuno e come risolverli.

8 8

9Questa pagina elenca gli errori runtime che Claude Code visualizza e come recuperare da ciascuno, più cosa controllare quando le risposte sembrano non corrette senza un errore. Per gli errori di installazione come `command not found` o errori TLS durante la configurazione, vedi [Risoluzione dei problemi di installazione e accesso](/docs/it/troubleshoot-install).9Questa pagina elenca gli errori di runtime che Claude Code visualizza e come recuperare da ciascuno, oltre a cosa controllare quando le risposte sembrano non corrette senza un errore. Per gli errori di installazione come `command not found` o errori TLS durante la configurazione, vedi [Risoluzione dei problemi di installazione e accesso](/docs/it/troubleshoot-install).

10 10

11Ad eccezione degli [errori di Wrapper e IDE](#wrapper-and-ide-errors), che il programma di avvio stampa piuttosto che Claude Code stesso, questi errori e comandi di recupero si applicano su CLI, l'[app Desktop](/docs/it/desktop) e le [sessioni cloud](/docs/it/claude-code-on-the-web), poiché tutti e tre avvolgono lo stesso CLI di Claude Code. Per altri problemi specifici della superficie, vedi la sezione di risoluzione dei problemi nella pagina di quella superficie.11Ad eccezione degli [errori di Wrapper e IDE](#wrapper-and-ide-errors), che il programma di avvio stampa piuttosto che Claude Code stesso, questi errori e i comandi di recupero si applicano su CLI, l'[app Desktop](/docs/it/desktop) e le [sessioni cloud](/docs/it/claude-code-on-the-web), poiché tutti e tre avvolgono lo stesso CLI di Claude Code. Per altri problemi specifici della superficie, vedi la sezione di risoluzione dei problemi nella pagina di quella superficie.

12 12

13<Note>13<Note>

14 Claude Code chiama l'API Claude per le risposte del modello, quindi la maggior parte degli errori runtime si mappano a un codice di errore API sottostante. Questa pagina copre cosa significa ogni errore all'interno di Claude Code e come recuperare. Per le definizioni del codice di stato HTTP grezzo, vedi il [riferimento degli errori della piattaforma Claude](https://platform.claude.com/docs/en/api/errors).14 Claude Code chiama l'API Claude per le risposte del modello, quindi la maggior parte degli errori di runtime si mappano a un codice di errore API sottostante. Questa pagina copre cosa significa ogni errore all'interno di Claude Code e come recuperare. Per le definizioni del codice di stato HTTP grezzo, vedi il [riferimento degli errori della piattaforma Claude](https://platform.claude.com/docs/en/api/errors).

15</Note>15</Note>

16 16

17<h2 id="find-your-error">17<h2 id="find-your-error">

24| :- | :- |24| :- | :- |

25| `API Error: 500 Internal server error` | [Errori del server](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Errori del server](#api-error-500-internal-server-error) |

26| `API Error: Repeated 529 Overloaded errors` | [Errori del server](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Errori del server](#api-error-repeated-529-overloaded-errors) |

27| `Opus is experiencing high load` / `Fable is experiencing high load` | [Errori del server](#api-error-repeated-529-overloaded-errors) |

27| `Request timed out` | [Errori del server](#request-timed-out), oppure [Rete](#unable-to-connect-to-api) se il messaggio menziona la vostra connessione internet |28| `Request timed out` | [Errori del server](#request-timed-out), oppure [Rete](#unable-to-connect-to-api) se il messaggio menziona la vostra connessione internet |

28| `API Error: No response from API` | [Errori del server](#no-response-from-api) |29| `API Error: No response from API` | [Errori del server](#no-response-from-api) |

29| `Server error mid-response. The response above may be incomplete.` | [Errori del server](#the-response-above-may-be-incomplete) |30| `Server error mid-response. The response above may be incomplete.` | [Errori del server](#the-response-above-may-be-incomplete) |

30| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Errori del server](#the-response-above-may-be-incomplete) |31| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Errori del server](#the-response-above-may-be-incomplete) |

31| `Connection closed mid-response` / `Response stalled mid-stream` | [Errori del server](#the-response-above-may-be-incomplete) |32| `Connection closed mid-response` / `Response stalled mid-stream` | [Errori del server](#the-response-above-may-be-incomplete) |

33| `Part of the response never arrived` / `The response stream was malformed` | [Errori del server](#the-response-above-may-be-incomplete) |

34| `API Error: Content block not found` / `API Error: Content block already closed` / `API Error: Stream event unreadable` | [Errori del server](#the-response-above-may-be-incomplete) |

32| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Tentativi automatici](#automatic-retries) |35| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Tentativi automatici](#automatic-retries) |

33| `Connection closed while thinking` / `Response stalled while thinking` | [Tentativi automatici](#automatic-retries) |36| `Connection closed while thinking` / `Response stalled while thinking` | [Tentativi automatici](#automatic-retries) |

34| `Connection lost while your computer was asleep` | [Tentativi automatici](#automatic-retries) |37| `Connection lost while your computer was asleep` | [Tentativi automatici](#automatic-retries) |

49| `Could not update your spend limit` | [Limiti di utilizzo](#could-not-update-your-spend-limit) |52| `Could not update your spend limit` | [Limiti di utilizzo](#could-not-update-your-spend-limit) |

50| `spend limit reached` / `spend limit unavailable` | [Limiti di utilizzo](#spend-limit-reached) |53| `spend limit reached` / `spend limit unavailable` | [Limiti di utilizzo](#spend-limit-reached) |

51| `Not logged in · Please run /login` | [Autenticazione](#not-logged-in) |54| `Not logged in · Please run /login` | [Autenticazione](#not-logged-in) |

55| `Couldn't save your login` | [Autenticazione](#couldnt-save-your-login) |

56| `Authentication required · Sign in again to continue` | [Autenticazione](#not-logged-in) |

52| `Could not resolve authentication method` | [Autenticazione](#could-not-resolve-authentication-method) |57| `Could not resolve authentication method` | [Autenticazione](#could-not-resolve-authentication-method) |

53| `Invalid API key` | [Autenticazione](#invalid-api-key) |58| `Invalid API key` | [Autenticazione](#invalid-api-key) |

54| `Your apiKeyHelper script is failing` | [Autenticazione](#your-apikeyhelper-script-is-failing) |59| `Your apiKeyHelper script is failing` | [Autenticazione](#your-apikeyhelper-script-is-failing) |

69| `signed-in claude.ai account or organization changed on this machine` | [Autenticazione](#remote-control-stopped-because-the-signed-in-account-changed) |74| `signed-in claude.ai account or organization changed on this machine` | [Autenticazione](#remote-control-stopped-because-the-signed-in-account-changed) |

70| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Autenticazione](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Autenticazione](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

71| `Remote Control stopped — the app running this session is signed out of Claude` | [Autenticazione](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |76| `Remote Control stopped — the app running this session is signed out of Claude` | [Autenticazione](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

77| `Couldn't verify your organization's policy for remote control` | [Risoluzione dei problemi di Remote Control](/docs/it/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |

72| `OAuth token revoked` / `OAuth token has expired` | [Autenticazione](#oauth-token-revoked-or-expired) |78| `OAuth token revoked` / `OAuth token has expired` | [Autenticazione](#oauth-token-revoked-or-expired) |

73| `API Error: 401 Invalid authentication credentials` | [Autenticazione](#api-error-401-invalid-authentication-credentials) |79| `API Error: 401 Invalid authentication credentials` | [Autenticazione](#api-error-401-invalid-authentication-credentials) |

74| `Login expired · Please run /login` | [Autenticazione](#login-expired) |80| `Login expired · Please run /login` | [Autenticazione](#login-expired) |

77| `Not signed in to the Cloud gateway — run /login.` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |83| `Not signed in to the Cloud gateway — run /login.` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |

78| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |84| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |

79| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticazione](#login-expired) |85| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticazione](#login-expired) |

86| `Could not refresh your login because another Claude Code process is refreshing it` | [Autenticazione](#could-not-refresh-your-login) |

87| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Autenticazione](#could-not-refresh-your-login) |

80| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |88| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |

81| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |89| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |

82| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Autenticazione](#anthropic-profile-login-expired) |90| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Autenticazione](#anthropic-profile-login-expired) |

121| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Rete](#sessions-ended-while-this-machine-was-offline) |129| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Rete](#sessions-ended-while-this-machine-was-offline) |

131| `Couldn't send feedback` | [Rete](#couldnt-send-feedback) |

125| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Errori di richiesta](#prompt-is-too-long) |134| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Errori di richiesta](#prompt-is-too-long) |

141| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Errori di richiesta](#tool-input-schema-is-invalid) |150| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Errori di richiesta](#tool-input-schema-is-invalid) |

151| `tool_use.name: String should have at most 200 characters` | [Errori di richiesta](#tool-use-name-over-200-characters) |

155| `API error: ... · model not changed` | [Errori di richiesta](#api-error-model-not-changed) |

145| `Claude Opus is not available with the Claude Pro plan` | [Errori di richiesta](#claude-opus-is-not-available-with-the-claude-pro-plan) |156| `Claude Opus is not available with the Claude Pro plan` | [Errori di richiesta](#claude-opus-is-not-available-with-the-claude-pro-plan) |

146| `Claude Code ... does not support this model; version ... or newer is required` | [Errori di richiesta](#claude-code-does-not-support-this-model) |157| `Claude Code ... does not support this model; version ... or newer is required` | [Errori di richiesta](#claude-code-does-not-support-this-model) |

147| `Claude Code ... is older than the minimum version required by your organization's policy` | [Errori di richiesta](#claude-code-does-not-support-this-model) |158| `Claude Code ... is older than the minimum version required by your organization's policy` | [Errori di richiesta](#claude-code-does-not-support-this-model) |

148| `Model ... is restricted by your organization's settings` | [Errori di richiesta](#model-is-restricted-by-your-organizations-settings) |159| `Model ... is restricted by your organization's settings` | [Errori di richiesta](#model-is-restricted-by-your-organizations-settings) |

160| `Model ... is not available. Your organization restricts model selection.` | [Errori di richiesta](#model-is-restricted-by-your-organizations-settings) |

149| `Model switch ... blocked by a PreModelSwitch hook` | [Errori di richiesta](#model-switch-was-blocked-by-a-premodelswitch-hook) |161| `Model switch ... blocked by a PreModelSwitch hook` | [Errori di richiesta](#model-switch-was-blocked-by-a-premodelswitch-hook) |

150| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Errori di richiesta](#couldnt-save-it-as-your-default) |162| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Errori di richiesta](#couldnt-save-it-as-your-default) |

151| `thinking.type.enabled is not supported for this model` | [Errori di richiesta](#thinking-type-enabled-is-not-supported-for-this-model) |163| `thinking.type.enabled is not supported for this model` | [Errori di richiesta](#thinking-type-enabled-is-not-supported-for-this-model) |

156| `API Error: 400 orphaned tool_result in conversation history` | [Errori di richiesta](#tool-use-or-thinking-block-mismatch) |168| `API Error: 400 orphaned tool_result in conversation history` | [Errori di richiesta](#tool-use-or-thinking-block-mismatch) |

157| `API Error: 400 duplicate tool_use ID in conversation history` | [Errori di richiesta](#tool-use-or-thinking-block-mismatch) |169| `API Error: 400 duplicate tool_use ID in conversation history` | [Errori di richiesta](#tool-use-or-thinking-block-mismatch) |

170| `Invalid data in redacted_thinking block` | [Errori di richiesta](#invalid-data-in-redacted-thinking-block) |

159| `role 'system' must precede an 'assistant' message` | [Errori di richiesta](#role-system-must-precede-an-assistant-message) |172| `role 'system' must precede an 'assistant' message` | [Errori di richiesta](#role-system-must-precede-an-assistant-message) |

160| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Errori di richiesta](#invalid-encrypted-content-in-search-result-block) |173| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Errori di richiesta](#invalid-encrypted-content-in-search-result-block) |

174| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Errori di richiesta](#invalid-encrypted-content-in-search-result-block) |

161| `server_tool_use.name: Input should be` on every turn of a resumed session | [Errori di richiesta](#unsupported-tool-content-removed) |175| `server_tool_use.name: Input should be` on every turn of a resumed session | [Errori di richiesta](#unsupported-tool-content-removed) |

163| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Errori di richiesta](#usage-policy-refusal) |177| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Errori di richiesta](#usage-policy-refusal) |

166| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Errori di richiesta](#safety-measures-flagged-a-cybersecurity-topic) |180| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Errori di richiesta](#safety-measures-flagged-a-cybersecurity-topic) |

167| `Installation was killed before it could finish (exit code 137)` | [Errori di installazione](#installation-was-killed-before-it-could-finish) |181| `Installation was killed before it could finish (exit code 137)` | [Errori di installazione](#installation-was-killed-before-it-could-finish) |

168| `The connection dropped while downloading the update` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |182| `The connection dropped while downloading the update` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |

173| `Couldn't verify your organization's policy for cloud sessions` | [Errori della riga di comando](#cloud-sessions-are-disabled-by-your-organizations-policy) |187| `Couldn't verify your organization's policy for cloud sessions` | [Errori della riga di comando](#cloud-sessions-are-disabled-by-your-organizations-policy) |

190| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Errori della riga di comando](#invalid-agents-configuration) |

191| `Error: --agents file not found` | [Errori della riga di comando](#invalid-agents-configuration) |

177| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Errori della riga di comando](#the-current-directory-no-longer-exists) |193| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Errori della riga di comando](#the-current-directory-no-longer-exists) |

178| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Errori della riga di comando](#temp-directory-refused-or-cannot-be-created) |194| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Errori della riga di comando](#temp-directory-refused-or-cannot-be-created) |

209| `No conversation found with session ID: <session-id>` | [Errori della riga di comando](#no-conversation-found-with-the-session-id) |225| `No conversation found with session ID: <session-id>` | [Errori della riga di comando](#no-conversation-found-with-the-session-id) |

226| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [Errori della riga di comando](#windows-reported-an-error-ebadf) |

211| `Cannot switch renderers while work is running in the background` | [Errori della riga di comando](#cannot-switch-renderers-in-this-session) |228| `Cannot switch renderers while work is running in the background` | [Errori della riga di comando](#cannot-switch-renderers-in-this-session) |

218| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Errori della riga di comando](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |235| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Errori della riga di comando](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

219| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Errori dei plugin](#plugin-eval-is-currently-in-early-access) |236| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Errori dei plugin](#plugin-eval-is-currently-in-early-access) |

220| `Marketplace "<name>" is registered from an untrusted source` | [Errori dei plugin](#marketplace-is-registered-from-an-untrusted-source) |237| `Marketplace "<name>" is registered from an untrusted source` | [Errori dei plugin](#marketplace-is-registered-from-an-untrusted-source) |

238| `Claude Code refuses the marketplace name "<name>"` | [Errori dei plugin](#claude-code-refuses-the-marketplace-name) |

239| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Errori dei plugin](#claude-code-refuses-the-marketplace-name) |

221| `Marketplace "<name>" is already added from a different source` | [Errori dei plugin](#marketplace-is-already-added-from-a-different-source) |240| `Marketplace "<name>" is already added from a different source` | [Errori dei plugin](#marketplace-is-already-added-from-a-different-source) |

222| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Errori dei plugin](#marketplace-name-is-another-spelling-of-a-reserved-name) |241| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Errori dei plugin](#marketplace-name-is-another-spelling-of-a-reserved-name) |

223| `references ${user_config.*} in a shell-form command` | [Errori dei plugin](#plugin-command-references-user-config) |242| `references ${user_config.*} in a shell-form command` | [Errori dei plugin](#plugin-command-references-user-config) |

233| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Errori dei plugin](#plugin-is-required-by-your-organization) |252| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Errori dei plugin](#plugin-is-required-by-your-organization) |

253| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [Errori dei plugin](#plugin-was-not-uninstalled) |

254| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Errori dei plugin](#plugin-was-not-uninstalled) |

235| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |256| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |

257| `cannot contain null bytes (\0)` | [Errori degli strumenti](#path-cannot-contain-null-bytes) |

258| `Path contains null bytes` | [Errori degli strumenti](#path-cannot-contain-null-bytes) |

236| `subagent_type is required: the general-purpose agent is not available in this session` | [Errori degli strumenti](#subagent-type-is-required) |259| `subagent_type is required: the general-purpose agent is not available in this session` | [Errori degli strumenti](#subagent-type-is-required) |

237| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Errori degli strumenti](#memory-index-is-over-its-read-limit) |260| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Errori degli strumenti](#memory-index-is-over-its-read-limit) |

248| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |271| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |

249| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |272| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |

250| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |273| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |

274| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |

251| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |275| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |

252| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |276| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Errori degli strumenti](#refusing-after-a-symlink-changed) |

254| `Command killed: its output file was replaced or could no longer be verified` | [Errori degli strumenti](#task-output-swap-refused) |278| `Command killed: its output file was replaced or could no longer be verified` | [Errori degli strumenti](#task-output-swap-refused) |

279| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Errori degli strumenti](#disk-quota-or-temp-filesystem-is-full) |

280| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Errori degli strumenti](#disk-quota-or-temp-filesystem-is-full) |

281| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Errori degli strumenti](#disk-quota-or-temp-filesystem-is-full) |

255| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Errori degli strumenti](#the-source-file-is-not-valid-utf-8-text) |282| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Errori degli strumenti](#the-source-file-is-not-valid-utf-8-text) |

256| `the source file has the replacement character U+FFFD` | [Errori degli strumenti](#the-source-file-is-not-valid-utf-8-text) |283| `the source file has the replacement character U+FFFD` | [Errori degli strumenti](#the-source-file-is-not-valid-utf-8-text) |

257| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Errori degli strumenti](#reading-a-local-file-from-outside-the-connected-folders) |284| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Errori degli strumenti](#reading-a-local-file-from-outside-the-connected-folders) |

279| `EACCES: permission denied, posix_spawn` | [Errori della sessione in background](#eacces-when-starting-a-background-session) |306| `EACCES: permission denied, posix_spawn` | [Errori della sessione in background](#eacces-when-starting-a-background-session) |

280| `exited before it became reachable` | [Errori della sessione in background](#background-service-exited-before-it-became-reachable) |307| `exited before it became reachable` | [Errori della sessione in background](#background-service-exited-before-it-became-reachable) |

281| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Errori della sessione in background](#working-directory-no-longer-exists-when-starting-a-background-session) |308| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Errori della sessione in background](#working-directory-no-longer-exists-when-starting-a-background-session) |

309| `Workspace not trusted.` when starting or restarting a background session | [Errori della sessione in background](#workspace-not-trusted-when-dispatching-a-background-session) |

282| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Errori della sessione in background](#eacces-when-starting-a-background-session) |310| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Errori della sessione in background](#eacces-when-starting-a-background-session) |

284| `The connection to Claude Code ended before this message completed` | [Errori del wrapper e dell'IDE](#the-connection-to-claude-code-ended-before-this-message-completed) |312| `The connection to Claude Code ended before this message completed` | [Errori del wrapper e dell'IDE](#the-connection-to-claude-code-ended-before-this-message-completed) |

291| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Avvisi di configurazione](#fullscreen-failed-start-notice) |319| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Avvisi di configurazione](#fullscreen-failed-start-notice) |

292| `Claude Code exited after an unrecoverable interface error (...)` | [Avvisi di configurazione](#exited-after-an-unrecoverable-interface-error) |320| `Claude Code exited after an unrecoverable interface error (...)` | [Avvisi di configurazione](#exited-after-an-unrecoverable-interface-error) |

293| `Agent descriptions are over the 15.0k-token limit` | [Avvisi di configurazione](#agent-descriptions-are-over-the-15000-token-limit) |321| `Agent descriptions are over the 15.0k-token limit` | [Avvisi di configurazione](#agent-descriptions-are-over-the-15000-token-limit) |

322| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Avvisi di configurazione](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

294| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avvisi di configurazione](#workspace-has-not-been-trusted) |323| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avvisi di configurazione](#workspace-has-not-been-trusted) |

295| `is a network path, which cannot be added as a working directory` | [Avvisi di configurazione](#working-directory-is-a-network-path) |324| `is a network path, which cannot be added as a working directory` | [Avvisi di configurazione](#working-directory-is-a-network-path) |

296| `Remote managed settings failed to load (<cause>)` | [Avvisi di configurazione](#remote-managed-settings-failed-to-load) |325| `Remote managed settings failed to load (<cause>)` | [Avvisi di configurazione](#remote-managed-settings-failed-to-load) |

297| `Managed settings were not approved; exiting without applying them.` | [Avvisi di configurazione](#managed-settings-were-not-approved) |326| `Managed settings were not approved; exiting without applying them.` | [Avvisi di configurazione](#managed-settings-were-not-approved) |

327| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Avvisi di configurazione](#managed-settings-block-the-default-model) |

298| `MCP server <name> is blocked by enterprise managed policy` | [Avvisi di configurazione](#mcp-server-is-blocked-by-enterprise-managed-policy) |328| `MCP server <name> is blocked by enterprise managed policy` | [Avvisi di configurazione](#mcp-server-is-blocked-by-enterprise-managed-policy) |

299| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |329| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |

300| `Managed settings drop-in directory could not be read` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |330| `Managed settings drop-in directory could not be read` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |

390 420

391La frase finale indica dove controllare lo stato del servizio e varia in base al provider. Le configurazioni di Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry indicano lo stato del servizio di quel provider. Un `ANTHROPIC_BASE_URL` personalizzato indica l'host del gateway.421La frase finale indica dove controllare lo stato del servizio e varia in base al provider. Le configurazioni di Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry indicano lo stato del servizio di quel provider. Un `ANTHROPIC_BASE_URL` personalizzato indica l'host del gateway.

392 422

393Questo indica un errore imprevisto all'interno dell'API. Non è causato dal vostro prompt, dalle impostazioni o dall'account.423Un 5xx dall'API stessa indica un errore imprevisto all'interno dell'API. Non è causato dal vostro prompt, dalle impostazioni o dall'account.

424

425Quando un proxy, un load balancer o un gateway risponde con una pagina di errore HTML, il messaggio mostra il codice di stato e il titolo della pagina, come `API Error: 502 Bad Gateway`. Per una pagina senza titolo, il messaggio mostra il codice di stato e il suo nome standard. Prima della v2.1.281, il codice di stato veniva eliminato quando la pagina aveva un titolo e il markup grezzo della pagina veniva stampato quando non ne aveva uno.

394 426

395**Cosa fare:**427**Cosa fare:**

396 428

416 448

417* Controllate [status.claude.com](https://status.claude.com) o la pagina di stato del provider indicata nel messaggio per gli avvisi di capacità449* Controllate [status.claude.com](https://status.claude.com) o la pagina di stato del provider indicata nel messaggio per gli avvisi di capacità

418* Riprovate tra pochi minuti450* Riprovate tra pochi minuti

419* Eseguite `/model` e passate a un modello diverso per continuare a lavorare, poiché la capacità è tracciata per modello. Claude Code vi chiede di farlo quando un modello è sotto un carico particolarmente elevato, ad esempio `Opus is experiencing high load, please use /model to switch to Sonnet`.451* Eseguite `/model` e passate a un modello diverso per continuare a lavorare, poiché la capacità è tracciata per modello. Claude Code vi chiede di farlo quando un modello è sotto un carico particolarmente elevato, ad esempio `Opus is experiencing high load, please use /model to switch to Sonnet`. Su modelli Fable il messaggio nomina Fable.

452

453 In una sessione che l'app Claude Desktop esegue, come la scheda Code o Cowork, il messaggio legge `Opus is experiencing high load. Switch to Sonnet.` e cambiate i modelli con il selettore di modelli dell'app.

420 454

421<h3 id="request-timed-out">455<h3 id="request-timed-out">

422 Request timed out456 Request timed out

474API Error: Connection lost mid-response. The response above may be incomplete.508API Error: Connection lost mid-response. The response above may be incomplete.

475API Error: Your computer went to sleep mid-response. The response above may be incomplete.509API Error: Your computer went to sleep mid-response. The response above may be incomplete.

476API Error: The response stopped arriving. The response above may be incomplete.510API Error: The response stopped arriving. The response above may be incomplete.

511API Error: Part of the response never arrived. The response above may be incomplete.

512API Error: The response stream was malformed. The response above may be incomplete.

477```513```

478 514

479* `Server error mid-response`: un errore del server di sovraccarico o 5xx a metà flusso. Questa variante richiede Claude Code v2.1.199 o successivo; prima di allora quel caso scartava l'output parziale e segnalava l'intero turno come errore.515* `Server error mid-response`: un errore del server di sovraccarico o 5xx a metà flusso. Questa variante richiede Claude Code v2.1.199 o successivo; prima di allora quel caso scartava l'output parziale e segnalava l'intero turno come errore.

480* `Connection lost mid-response`: la connessione è stata interrotta.516* `Connection lost mid-response`: la connessione è stata interrotta. Vedete anche questa variante quando un proxy o gateway termina il corpo della risposta in modo pulito prima che la risposta sia terminata.

481* `Your computer went to sleep mid-response`: Claude Code ha rilevato che il vostro computer si è addormentato mentre la risposta era in streaming. Una volta che il vostro computer si sveglia, Claude Code tratta la connessione come interrotta e smette di leggerla.517* `Your computer went to sleep mid-response`: Claude Code ha rilevato che il vostro computer si è addormentato mentre la risposta era in streaming. Una volta che il vostro computer si sveglia, Claude Code tratta la connessione come interrotta e smette di leggerla.

518* `Part of the response never arrived`: un evento di flusso è stato perso tra l'API e Claude Code, quindi un evento successivo ha fatto riferimento a contenuto che non è mai arrivato. Prima della v2.1.281, questo caso ha terminato il turno con `API Error: Content block not found`.

519* `The response stream was malformed`: un evento è arrivato per un blocco di contenuto che era già terminato, o un evento è arrivato danneggiato. Un evento danneggiato è uno i cui dati non sono JSON valido, il cui contenuto è mancante o il cui contenuto non corrisponde al tipo dell'evento. Prima della v2.1.284, l'errore grezzo del parser, come uno che inizia con `API Error: JSON Parse error`, appariva invece quando un evento con JSON non valido arrivava dopo che Claude aveva completato il suo pensiero, un blocco di testo o una chiamata di strumento.

482* `The response stopped arriving`: la connessione è rimasta aperta ma ha smesso di consegnare dati, quindi il watchdog di inattività dello streaming l'ha interrotta. Prima della v2.1.222, Claude Code poteva anche segnalare questo errore su connessioni [gateway](/docs/it/gateways) raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL` mentre i ping keep-alive del server stavano ancora arrivando, perché contava solo gli eventi di risposta analizzati lì; l'aggiornamento interrompe quei timeout spuri su quelle rotte. I gateway raggiunti tramite un URL di base del provider come `ANTHROPIC_BEDROCK_BASE_URL` non sono avvolti dal watchdog di byte; vedete [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs).520* `The response stopped arriving`: la connessione è rimasta aperta ma ha smesso di consegnare dati, quindi il watchdog di inattività dello streaming l'ha interrotta. Prima della v2.1.222, Claude Code poteva anche segnalare questo errore su connessioni [gateway](/docs/it/gateways) raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL` mentre i ping keep-alive del server stavano ancora arrivando, perché contava solo gli eventi di risposta analizzati lì; l'aggiornamento interrompe quei timeout spuri su quelle rotte. I gateway raggiunti tramite un URL di base del provider come `ANTHROPIC_BEDROCK_BASE_URL` non sono avvolti dal watchdog di byte; vedete [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs).

483 521

484Prima della v2.1.227, `Connection lost mid-response` leggeva `Connection closed mid-response` e `The response stopped arriving` leggeva `Response stalled mid-stream`.522Prima della v2.1.227, `Connection lost mid-response` leggeva `Connection closed mid-response` e `The response stopped arriving` leggeva `Response stalled mid-stream`.

485 523

524Quando un evento di flusso perso, duplicato o danneggiato arriva prima che Claude abbia iniziato qualsiasi testo o chiamata di strumento, non vedete questo avviso:

525

526* Se Claude aveva completato solo il suo pensiero, Claude Code invia di nuovo la richiesta. Quando i flussi inviati di nuovo si rompono nello stesso modo, il turno termina con `Part of the response never arrived and no response was produced. Try again.` o `The response stream was malformed and no response was produced. Try again.`

527* Se nulla era stato completato, Claude Code invia di nuovo la richiesta senza streaming. Se avete disattivato quel fallback con [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/it/env-vars), il turno termina con `API Error: Content block not found` per un evento perso o `API Error: Content block already closed` per uno duplicato. Per un evento danneggiato con il fallback disattivato, il turno termina con `API Error: Stream event unreadable` o l'errore grezzo del parser.

528

486In quattro casi, Claude Code gestisce l'errore senza mostrare questo avviso subito:529In quattro casi, Claude Code gestisce l'errore senza mostrare questo avviso subito:

487 530

488* Più in alto nella risposta, Claude Code riprova l'errore o termina il turno con un errore diverso. Vedete [Automatic retries](#automatic-retries).531* Più in alto nella risposta, Claude Code riprova l'errore o termina il turno con un errore diverso. Vedete [Automatic retries](#automatic-retries).

668API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context711API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

669```712```

670 713

714In una sessione che l'app Claude Desktop esegue, il suggerimento non nomina alcun comando: punta alla pagina delle impostazioni di utilizzo di claude.ai, oppure sui piani Team ed Enterprise dice di attivare i crediti di utilizzo su claude.ai/admin-settings/usage o di chiedere al tuo amministratore.

715

671Questo è un controllo di diritto, non un esaurimento della quota. Si attiva anche quando le tue indennità di sessione e settimanali hanno capacità rimanente. Vedi [Extended context](/docs/it/model-config#extended-context) per quali piani includono il contesto 1M direttamente e quali richiedono crediti di utilizzo. Claude Code esegue questo controllo quando scegli il modello con `/model`, e solo su una connessione diretta all'API Anthropic; se punti `ANTHROPIC_BASE_URL` a un [gateway LLM](/docs/it/llm-gateway), `/model` consente la selezione `[1m]` e il gateway decide se la richiesta ha successo.716Questo è un controllo di diritto, non un esaurimento della quota. Si attiva anche quando le tue indennità di sessione e settimanali hanno capacità rimanente. Vedi [Extended context](/docs/it/model-config#extended-context) per quali piani includono il contesto 1M direttamente e quali richiedono crediti di utilizzo. Claude Code esegue questo controllo quando scegli il modello con `/model`, e solo su una connessione diretta all'API Anthropic; se punti `ANTHROPIC_BASE_URL` a un [gateway LLM](/docs/it/llm-gateway), `/model` consente la selezione `[1m]` e il gateway decide se la richiesta ha successo.

672 717

673Quando questo errore appare a metà conversazione perché il contesto è cresciuto oltre 200K token, Claude Code compatta automaticamente la conversazione al di sotto del limite di contesto standard e mantiene la sessione a quel limite in seguito, quindi non è necessaria alcuna azione. Nelle versioni precedenti alla v2.1.172, l'errore si ripeteva su ogni richiesta successiva incluso `/compact`; esegui `/clear` su quelle versioni per recuperare. I passaggi seguenti si applicano quando hai esplicitamente selezionato un modello `[1m]`.718Quando questo errore appare a metà conversazione perché il contesto è cresciuto oltre 200K token, Claude Code compatta automaticamente la conversazione al di sotto del limite di contesto standard e mantiene la sessione a quel limite in seguito, quindi non è necessaria alcuna azione. Nelle versioni precedenti alla v2.1.172, l'errore si ripeteva su ogni richiesta successiva incluso `/compact`; esegui `/clear` su quelle versioni per recuperare. I passaggi seguenti si applicano quando hai esplicitamente selezionato un modello `[1m]`.

733 778

734La frase finale nomina dove controllare l'integrità del servizio e varia in base al provider. Le configurazioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry nominano lo stato del servizio di quel provider invece della pagina di stato Anthropic. Un `ANTHROPIC_BASE_URL` personalizzato nomina l'host del gateway.779La frase finale nomina dove controllare l'integrità del servizio e varia in base al provider. Le configurazioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry nominano lo stato del servizio di quel provider invece della pagina di stato Anthropic. Un `ANTHROPIC_BASE_URL` personalizzato nomina l'host del gateway.

735 780

781Quando un proxy, un load balancer o un gateway tra Claude Code e l'API risponde con la propria pagina HTML 429, il testo dopo il `·` è il titolo di quella pagina quando ne ha uno, come `Too Many Requests`. Prima della v2.1.281, l'intero markup della pagina era stampato dopo il `·`.

782

736**Cosa fare:**783**Cosa fare:**

737 784

738* Esegui `/status` e conferma che la credenziale attiva è quella che ti aspetti. Un `ANTHROPIC_API_KEY` casuale nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.785* Esegui `/status` e conferma che la credenziale attiva è quella che ti aspetti. Un `ANTHROPIC_API_KEY` casuale nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.

839Not logged in · Please run /login886Not logged in · Please run /login

840```887```

841 888

889In una sessione che l'app Claude Desktop esegue, come la scheda Code o Cowork, il messaggio legge `Authentication required · Sign in again to continue`, e vi accedete di nuovo dall'app.

890

842**Cosa fare:**891**Cosa fare:**

843 892

844* Eseguite `/login` per autenticarvi con il Vostro abbonamento Claude o l'account Console893* Eseguite `/login` per autenticarvi con il Vostro abbonamento Claude o l'account Console

985Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead1034Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead

986Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account1035Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account

987Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account1036Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

1037Your organization has disabled API key authentication · Sign in again with your claude.ai account

988```1038```

989 1039

1040L'ultima forma appare in una sessione che l'app Claude Desktop esegue, come la scheda Code o Cowork, dove vi accedete di nuovo dall'app.

1041

990Le variabili d'ambiente e `apiKeyHelper` hanno la precedenza su `/login`, quindi eseguire `/login` da solo non aiuta mentre uno dei due sta ancora fornendo una chiave. Vedete [Precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence).1042Le variabili d'ambiente e `apiKeyHelper` hanno la precedenza su `/login`, quindi eseguire `/login` da solo non aiuta mentre uno dei due sta ancora fornendo una chiave. Vedete [Precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence).

991 1043

992**Cosa fare:**1044**Cosa fare:**

1203* In modalità non interattiva, eseguite `claude` nello stesso ambiente, completate `/login`, quindi rieseguite il Vostro comando. Per l'automazione che non può accedere in modo interattivo, autenticate con `ANTHROPIC_API_KEY` o [generate un token di lunga durata con `claude setup-token`](/docs/it/authentication#generate-a-long-lived-token).1255* In modalità non interattiva, eseguite `claude` nello stesso ambiente, completate `/login`, quindi rieseguite il Vostro comando. Per l'automazione che non può accedere in modo interattivo, autenticate con `ANTHROPIC_API_KEY` o [generate un token di lunga durata con `claude setup-token`](/docs/it/authentication#generate-a-long-lived-token).

1204* Se l'accesso continua a fallire, vedete [Login e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)1256* Se l'accesso continua a fallire, vedete [Login e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)

1205 1257

1258<h3 id="could-not-refresh-your-login">

1259 Impossibile aggiornare il Vostro login perché un altro processo Claude Code lo sta aggiornando

1260</h3>

1261

1262Questo messaggio non significa che il Vostro login sia stato rifiutato. Il Vostro login claude.ai salvato era scaduto e aveva bisogno di rinnovamento. Un altro processo Claude Code sulla stessa macchina teneva il blocco di aggiornamento condiviso, o è uscito e lo ha lasciato dietro, e l'aggiornamento non ha fatto progressi mentre questa sessione aspettava. Claude Code ferma la richiesta prima di inviarla:

1263

1264```text theme={null}

1265Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

1266```

1267

1268In [modalità non interattiva](/docs/it/headless) (`-p`) e [Agent SDK](/docs/it/agent-sdk/overview), il messaggio legge come segue, e il codice di errore strutturato è `server_error`:

1269

1270```text theme={null}

1271Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

1272```

1273

1274Le sessioni autenticate con una chiave API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars) o un provider di terze parti non utilizzano il login salvato e non vedono mai questo messaggio.

1275

1276**Cosa fare:**

1277

1278* Riprovate tra un minuto. Se un altro processo completa l'aggiornamento per primo, questa sessione utilizza il login rinnovato.

1279* Se il messaggio continua a ritornare, chiudete altri processi e finestre Claude Code, quindi riprovate.

1280* Se ritorna senza alcun altro processo Claude Code in esecuzione, eseguite `/login`. L'accesso di nuovo non aspetta il blocco di aggiornamento.

1281

1282<h3 id="couldnt-save-your-login">

1283 Impossibile salvare il Vostro login

1284</h3>

1285

1286Vi siete acceduti con claude.ai, ma Claude Code non ha potuto salvare il login nel suo archivio di credenziali, quindi l'accesso non è stato completato. Su macOS questo può accadere quando il keychain di login si blocca, ad esempio al sonno o inattività, dopo che Claude Code ha già letto o salvato credenziali in esso durante la stessa sessione.

1287

1288```text theme={null}

1289Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.

1290Couldn't save your login. Try logging in again.

1291```

1292

1293La prima forma appare su macOS e la seconda ovunque. Un errore transitorio dell'archivio di credenziali, come un timeout o un archivio illeggibile, produce lo stesso messaggio.

1294

1295**Cosa fare:**

1296

1297* Su macOS, sbloccare il keychain di login, quindi eseguire `/login` di nuovo

1298* Su altre piattaforme, eseguire `/login` di nuovo

1299* Se il login ancora non si salva, vedete [Non connesso o token scaduto](/docs/it/troubleshoot-install#not-logged-in-or-token-expired) per il comando di sblocco del keychain e altri passaggi di recupero dell'archiviazione delle credenziali

1300

1206<h3 id="claude-login-not-accepted">1301<h3 id="claude-login-not-accepted">

1207 Login Claude non accettato1302 Login Claude non accettato

1208</h3>1303</h3>

1677 1772

1678Se `curl` ha successo ma Claude Code continua a fallire, la causa è solitamente qualcosa tra il runtime e la rete piuttosto che la rete stessa:1773Se `curl` ha successo ma Claude Code continua a fallire, la causa è solitamente qualcosa tra il runtime e la rete piuttosto che la rete stessa:

1679 1774

1775* Controlla se `ANTHROPIC_BASE_URL` è impostato eseguendo `echo $ANTHROPIC_BASE_URL`, o `echo $env:ANTHROPIC_BASE_URL` in PowerShell, e cercalo nel blocco `env` dei tuoi [settings files](/docs/it/settings). Quando è impostato, Claude Code invia le richieste del modello a quell'indirizzo invece di `api.anthropic.com`, quindi un valore residuo che punta a un proxy locale o gateway che non è più in esecuzione produce `Connection refused` anche se `curl` raggiunge l'API. Rimuovilo dal tuo profilo shell o dalle impostazioni e avvia Claude Code da un nuovo terminale.

1680* Su Linux e WSL, controlla `/etc/resolv.conf` per un nameserver non raggiungibile. WSL in particolare può ereditare un resolver rotto dall'host.1776* Su Linux e WSL, controlla `/etc/resolv.conf` per un nameserver non raggiungibile. WSL in particolare può ereditare un resolver rotto dall'host.

1681* Su macOS, un client VPN che è stato disconnesso o disinstallato può lasciare dietro un'interfaccia tunnel o una regola di routing. Controlla `ifconfig` per interfacce `utun` stantie e rimuovi l'estensione di rete della VPN in Impostazioni di Sistema.1777* Su macOS, un client VPN che è stato disconnesso o disinstallato può lasciare dietro un'interfaccia tunnel o una regola di routing. Controlla `ifconfig` per interfacce `utun` stantie e rimuovi l'estensione di rete della VPN in Impostazioni di Sistema.

1682* Docker Desktop e runtime di container simili possono intercettare il traffico in uscita. Chiudili e riprova per escludere questa possibilità.1778* Docker Desktop e runtime di container simili possono intercettare il traffico in uscita. Chiudili e riprova per escludere questa possibilità.

1897* Avvia una nuova sessione con `claude --remote-control` per creare una nuova sessione Remote Control1993* Avvia una nuova sessione con `claude --remote-control` per creare una nuova sessione Remote Control

1898* Per altri messaggi di avvio di Remote Control, vedi [Troubleshoot Remote Control](/docs/it/remote-control#troubleshooting)1994* Per altri messaggi di avvio di Remote Control, vedi [Troubleshoot Remote Control](/docs/it/remote-control#troubleshooting)

1899 1995

1900Se il server segnala invece che la sessione precedente è scomparsa, non vedi questo messaggio. Claude Code avvia una nuova sessione al suo posto o mostra [`Previous session is unavailable — run /remote-control to start a new one`](/docs/it/remote-control#previous-session-is-unavailable), a seconda del [record di riconnessione della conversazione](/docs/it/remote-control#resume-outcomes). Dalla v2.1.227 alla v2.1.231, Claude Code mostrava un messaggio che inizia con `Remote Control could not resume the previous session under the current login` invece, e le [versioni precedenti si comportavano diversamente di nuovo](/docs/it/remote-control#reconnect-history).1996Se il server segnala invece che la sessione precedente è scomparsa, non vedi questo messaggio. Claude Code avvia una nuova sessione al suo posto o mostra [`Previous session is unavailable — run /remote-control to start a new one`](/docs/it/remote-control#previous-session-is-unavailable).

1901 1997

1902<h3 id="sessions-ended-while-this-machine-was-offline">1998<h3 id="sessions-ended-while-this-machine-was-offline">

1903 Sessions ended while this machine was offline1999 Sessions ended while this machine was offline

1931* Esegui `/feedback` per inviare la trascrizione con una descrizione di ciò che è accaduto. Vedi [Report an error](#report-an-error) se `/feedback` non è disponibile nel tuo ambiente2027* Esegui `/feedback` per inviare la trascrizione con una descrizione di ciò che è accaduto. Vedi [Report an error](#report-an-error) se `/feedback` non è disponibile nel tuo ambiente

1932* Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api)2028* Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api)

1933 2029

2030<h3 id="couldnt-send-feedback">

2031 Couldn't send feedback

2032</h3>

2033

2034Hai inviato un rapporto dalla finestra di dialogo [`/feedback`, `/bug`, o `/share`](/docs/it/commands#all-commands) e il caricamento su Anthropic è fallito. La finestra di dialogo mantiene il tuo testo in modo che tu possa ritentare.

2035

2036```text theme={null}

2037Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

2038```

2039

2040Il testo dopo il prefisso nomina ciò che è fallito:

2041

2042* **`: not signed in. Run /login, then retry.`**: la finestra di dialogo carica solo quando Claude Code ha trovato credenziali Anthropic mentre si apriva, e nessuna era utilizzabile al momento dell'invio. Ad esempio, hai effettuato il logout su questa macchina nel frattempo, o il tuo login non poteva più essere aggiornato.

2043* **Una parentesi**: `(server returned <status>)` è il codice di risposta del servizio; `(request timed out)` e `(couldn't reach the service)` sono guasti di rete. Quando Claude Code non riesce a nominare un motivo, la parentesi è assente.

2044

2045Nella [feedback drafts queue](/docs/it/tools-reference#sendfeedback-tool-behavior), lo stesso guasto termina con `The draft is still queued. Try again later.` invece, e la bozza rimane nella coda per un altro tentativo.

2046

2047**Cosa fare:**

2048

2049* Per la dicitura non-signed-in, esegui `/login` e invia di nuovo

2050* Altrimenti, invia di nuovo; se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api)

2051* Se continua a fallire, archivia il rapporto su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues), come dice il messaggio

2052

2053Prima della v2.1.281, ogni invio falliva con questo messaggio una volta che un Remote Control **Stop** o un messaggio urgente tra sessioni era arrivato mentre la finestra di dialogo era aperta. Su quelle versioni, chiudi la finestra di dialogo, riaprila e invia di nuovo.

2054

1934<h2 id="request-errors">2055<h2 id="request-errors">

1935 Errori di richiesta2056 Errori di richiesta

1936</h2>2057</h2>

2070Quando la richiesta è andata direttamente all'API Claude e l'API stessa l'ha rifiutata, Claude Code misura la conversazione e formula il messaggio in base al fatto che il recupero possa funzionare. Attraverso un proxy, gateway o provider cloud ottenete il messaggio generale. Le forme misurate:2191Quando la richiesta è andata direttamente all'API Claude e l'API stessa l'ha rifiutata, Claude Code misura la conversazione e formula il messaggio in base al fatto che il recupero possa funzionare. Attraverso un proxy, gateway o provider cloud ottenete il messaggio generale. Le forme misurate:

2071 2192

2072* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: le immagini o i documenti hanno spinto la richiesta oltre il limite. Claude Code ritenta con essi rimossi.2193* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: le immagini o i documenti hanno spinto la richiesta oltre il limite. Claude Code ritenta con essi rimossi.

2073* `Request too large for the API's 32MB request limit`: i messaggi da soli superano il limite, quindi il messaggio dice `compacting cannot make it fit` e Claude Code non ritenta. In [modalità non interattiva](/docs/it/headless), il messaggio vi dice di ridurre l'input o avviare una nuova sessione.2194* `Request too large for the API's 32MB request limit`: i messaggi da soli superano il limite, quindi il messaggio dice `compacting cannot make it fit` e Claude Code non ritenta. In [modalità non interattiva](/docs/it/headless), il messaggio vi dice di ridurre l'input o avviare una nuova sessione invece.

2074 2195

2075Prima della v2.1.212, le conversazioni con abbastanza immagini accumulate fallivano ad ogni turno con `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` Prima della v2.1.229, Claude Code mostrava il consiglio di allegato per ogni rifiuto, anche quando la compattazione non poteva aiutare.2196Prima della v2.1.212, le conversazioni con abbastanza immagini accumulate fallivano ad ogni turno con `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` Prima della v2.1.229, Claude Code mostrava il consiglio di allegato per ogni rifiuto, anche quando la compattazione non poteva aiutare.

2076 2197

2185* Rimuovete o [disabilitate](/docs/it/mcp#disable-a-server-without-removing-it) il server MCP che dichiara lo schema non valido. L'errore nomina lo strumento solo per posizione. Sulla v2.1.216 o successiva, controllate il log di ogni server per una riga che nomina uno strumento il cui schema di input verrebbe rifiutato. Se nessun log ne nomina uno, disabilitate i server uno alla volta.2306* Rimuovete o [disabilitate](/docs/it/mcp#disable-a-server-without-removing-it) il server MCP che dichiara lo schema non valido. L'errore nomina lo strumento solo per posizione. Sulla v2.1.216 o successiva, controllate il log di ogni server per una riga che nomina uno strumento il cui schema di input verrebbe rifiutato. Se nessun log ne nomina uno, disabilitate i server uno alla volta.

2186* Se mantenete il server, correggete l'`input_schema` dello strumento. Lo schema deve essere uno schema JSON valido, e i nomi delle proprietà di livello superiore devono essere da 1 a 64 caratteri e usare solo lettere ASCII e cifre, `_`, `.` e `-`. Vedete [Tools with invalid input schemas](/docs/it/mcp#tools-with-invalid-input-schemas).2307* Se mantenete il server, correggete l'`input_schema` dello strumento. Lo schema deve essere uno schema JSON valido, e i nomi delle proprietà di livello superiore devono essere da 1 a 64 caratteri e usare solo lettere ASCII e cifre, `_`, `.` e `-`. Vedete [Tools with invalid input schemas](/docs/it/mcp#tools-with-invalid-input-schemas).

2187 2308

2309<h3 id="tool-use-name-over-200-characters">

2310 tool\_use.name oltre 200 caratteri

2311</h3>

2312

2313Una chiamata di strumento nella cronologia della conversazione porta un nome più lungo dei 200 caratteri che l'API accetta in una richiesta:

2314

2315```text theme={null}

2316API Error: 400 ... tool_use.name: String should have at most 200 characters

2317```

2318

2319Claude Code taglia tale nome a 200 caratteri quando la risposta arriva e quando carica una conversazione salvata, quindi la chiamata fallisce con un ordinario errore di strumento `No such tool available` e la conversazione continua senza questo errore API.

2320

2321**Cosa fare:**

2322

2323* Eseguite `claude update`, quindi riprendete la conversazione. La versione aggiornata ripara il nome eccessivamente lungo quando carica la trascrizione, quindi una conversazione che era bloccata funziona di nuovo.

2324

2325Prima della v2.1.281, il nome eccessivamente lungo rimase nella cronologia e l'API rifiutò ogni richiesta che rinviasse la conversazione, inclusi `/compact` e `--resume`, quindi questo errore si ripetè e la conversazione rimase bloccata.

2326

2188<h3 id="theres-an-issue-with-the-selected-model">2327<h3 id="theres-an-issue-with-the-selected-model">

2189 C'è un problema con il modello selezionato2328 C'è un problema con il modello selezionato

2190</h3>2329</h3>

2216Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2355Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2217```2356```

2218 2357

2219L'hint finale nomina l'alias o l'ID modello più simile. Quando nulla è abbastanza simile, recita `Run /model to see available models.` invece.2358L'hint finale nomina l'alias o l'ID modello più simile. Quando nulla è abbastanza simile, recita `Run /model to see available models.` invece. In una sessione che l'[app Desktop](/docs/it/desktop) avvia per voi, l'hint senza corrispondenza recita `Switch to a different model.`

2220 2359

2221Claude Code produce questo errore localmente nel momento in cui il cambio è richiesto, prima che venga effettuata qualsiasi richiesta API. Si applica quando un modello è impostato attraverso il metodo [Agent SDK](/docs/it/agent-sdk/typescript) `setModel()`, da un'app come l'[app Desktop](/docs/it/desktop) che esegue la CLI di Claude Code per voi, o quando scegliete un modello da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control). Prima della v2.1.260, il controllo non copriva le scelte di Remote Control, quindi Claude Code applicava la scelta e la richiesta successiva falliva con [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).2360Claude Code produce questo errore localmente nel momento in cui il cambio è richiesto, prima che venga effettuata qualsiasi richiesta API. Si applica quando un modello è impostato attraverso il metodo [Agent SDK](/docs/it/agent-sdk/typescript) `setModel()`, da un'app come l'[app Desktop](/docs/it/desktop) che esegue la CLI di Claude Code per voi, o quando scegliete un modello da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control). Prima della v2.1.260, il controllo non copriva le scelte di Remote Control, quindi Claude Code applicava la scelta e la richiesta successiva falliva con [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).

2222 2361

2245* Se avete digitato un ID completo, controllarlo rispetto al catalogo dei modelli del Vostro provider. Un modello appena lanciato può essere disponibile sull'API Anthropic prima che il Vostro provider o regione lo offra.2384* Se avete digitato un ID completo, controllarlo rispetto al catalogo dei modelli del Vostro provider. Un modello appena lanciato può essere disponibile sull'API Anthropic prima che il Vostro provider o regione lo offra.

2246* Prima della v2.1.265, `/model` rifiutava anche l'ortografia dell'alias `opusplan[1m]` con questo errore. Su quelle versioni, aggiornate Claude Code, oppure impostate il modello in [settings](/docs/it/model-config#setting-your-model) o con `--model` invece.2385* Prima della v2.1.265, `/model` rifiutava anche l'ortografia dell'alias `opusplan[1m]` con questo errore. Su quelle versioni, aggiornate Claude Code, oppure impostate il modello in [settings](/docs/it/model-config#setting-your-model) o con `--model` invece.

2247 2386

2387<h3 id="api-error-model-not-changed">

2388 Errore API durante il controllo del modello scelto

2389</h3>

2390

2391Avete scelto un modello con `/model <name>`, oppure un'app connessa alla sessione ha richiesto il cambio. L'API ha rifiutato la richiesta minima che Claude Code invia per verificare il modello, per un motivo che non ha una voce propria, come un limite di velocità o un errore del server. La sessione mantiene il suo modello corrente, e il messaggio termina dicendo così:

2392

2393```text theme={null}

2394API error: 429 <the server's explanation> · model not changed

2395```

2396

2397Il mezzo del messaggio è lo stato HTTP e la spiegazione propria del server.

2398

2399**Cosa fare:**

2400

2401* Agite sulla spiegazione del server; per un limite di velocità o uno stato 5xx, aspettate e scegliete il modello di nuovo

2402* I rifiuti con la loro propria dicitura sono coperti dalle voci circostanti, come [Model not found](#model-not-found) e [Model is restricted by your organization's settings](#model-is-restricted-by-your-organizations-settings)

2403

2248<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">2404<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

2249 Claude Opus non è disponibile con il piano Claude Pro2405 Claude Opus non è disponibile con il piano Claude Pro

2250</h3>2406</h3>

2255Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.2411Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

2256```2412```

2257 2413

2414In una sessione che l'app Claude Desktop avvia, il messaggio dice di `sign out and sign in again` invece di nominare i comandi.

2415

2258**Cosa fare:**2416**Cosa fare:**

2259 2417

2260* Eseguite `/model` e selezionate un modello che il Vostro piano include2418* Eseguite `/model` e selezionate un modello che il Vostro piano include

2261* Se avete aggiornato il Vostro piano di recente e lo vedete ancora, eseguite `/logout` quindi `/login`. Il token memorizzato riflette il Vostro piano al momento in cui avete effettuato l'accesso, quindi l'aggiornamento sul web non ha effetto in una sessione esistente finché non vi autenticate di nuovo.2419* Se avete aggiornato il Vostro piano di recente e lo vedete ancora, eseguite `/logout` quindi `/login`. Il token memorizzato riflette il Vostro piano al momento in cui avete effettuato l'accesso, quindi l'aggiornamento su claude.ai non ha effetto in una sessione esistente finché non vi autenticate di nuovo.

2262* Vedete [claude.com/pricing](https://claude.com/pricing) per quali modelli ogni piano include2420* Vedete [claude.com/pricing](https://claude.com/pricing) per quali modelli ogni piano include

2263 2421

2264<h3 id="claude-code-does-not-support-this-model">2422<h3 id="claude-code-does-not-support-this-model">

2287 Il modello è limitato dalle impostazioni della Vostra organizzazione2445 Il modello è limitato dalle impostazioni della Vostra organizzazione

2288</h3>2446</h3>

2289 2447

2290L'amministratore della Vostra organizzazione ha disabilitato questo modello nella console di amministrazione claude.ai, oppure è escluso da un elenco di consentiti [`availableModels`](/docs/it/model-config#restrict-model-selection) nelle impostazioni gestite. Quando il modello limitato è stato impostato con `--model`, `ANTHROPIC_MODEL` o l'impostazione `model`, Claude Code sostituisce un modello consentito e continua. Digitare `/model <name>` per un modello limitato viene rifiutato con `Run /model to choose a different model.` e la sessione mantiene il suo modello corrente. L'avviso di sostituzione può anche apparire a metà sessione dopo che un amministratore disabilita il modello su cui una sessione è in esecuzione nella console di amministrazione claude.ai.2448L'amministratore della Vostra organizzazione ha disabilitato questo modello nella console di amministrazione claude.ai, oppure le impostazioni gestite lo escludono attraverso un elenco di consentiti [`availableModels`](/docs/it/model-config#restrict-model-selection) o un elenco [`deniedModels`](/docs/it/model-config#block-specific-models-or-versions). L'avviso appare all'avvio quando `--model`, `ANTHROPIC_MODEL` o l'impostazione `model` ha nominato il modello limitato, e nomina il modello che la sessione usa invece. Se le impostazioni gestite non lasciano alcun modello consentito per la sessione da usare, vedete [Managed settings block the default model](#managed-settings-block-the-default-model). L'avviso di sostituzione può anche apparire a metà sessione dopo che un amministratore disabilita il modello su cui una sessione è in esecuzione nella console di amministrazione claude.ai.

2291 2449

2292```text theme={null}2450```text theme={null}

2293Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.2451Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

2294```2452```

2295 2453

2454Digitare `/model <name>` per un modello limitato viene rifiutato e la sessione mantiene il suo modello corrente. Per un modello disabilitato nella console di amministrazione, il rifiuto recita `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` Per un modello che le impostazioni gestite escludono, recita `Model '<name>' is not available. Your organization restricts model selection.`

2455

2296Un avviso con prefisso un nome di agente, skill o comando significa che la restrizione si è applicata al [modello richiesto di quel subagent](/docs/it/sub-agents#choose-a-model): il subagent viene eseguito sul modello sostituito e il modello della Vostra sessione rimane invariato. Prima della v2.1.223, Claude Code mostrava l'avviso solo per i subagent lanciati con lo strumento Agent.2456Un avviso con prefisso un nome di agente, skill o comando significa che la restrizione si è applicata al [modello richiesto di quel subagent](/docs/it/sub-agents#choose-a-model): il subagent viene eseguito sul modello sostituito e il modello della Vostra sessione rimane invariato. Prima della v2.1.223, Claude Code mostrava l'avviso solo per i subagent lanciati con lo strumento Agent.

2297 2457

2298Claude Code tratta un alias di famiglia di modelli, uno di `opus`, `sonnet`, `haiku` o `fable`, come una richiesta per quella famiglia piuttosto che per la sua versione più recente. Sull'API Anthropic e su [Claude Platform on AWS](/docs/it/claude-platform-on-aws), un alias di famiglia limitato si risolve nella versione più recente della famiglia che la Vostra organizzazione e l'elenco di consentiti `availableModels` consentono, e l'avviso di sostituzione nomina quella versione. Claude Code rifiuta `/model <alias>` solo quando ogni versione della famiglia è limitata. Prima della v2.1.205, un alias di famiglia veniva sostituito o rifiutato in base alla sua versione più recente sola, anche quando una versione più vecchia della stessa famiglia era consentita.2458Claude Code tratta un alias di famiglia di modelli, uno di `opus`, `sonnet`, `haiku` o `fable`, come una richiesta per quella famiglia piuttosto che per la sua versione più recente. Sull'API Anthropic e su [Claude Platform on AWS](/docs/it/claude-platform-on-aws), un alias di famiglia limitato si risolve nella versione più recente della famiglia che le impostazioni gestite della Vostra organizzazione consentono, e l'avviso di sostituzione nomina quella versione. Claude Code rifiuta `/model <alias>` solo quando ogni versione della famiglia è limitata. Prima della v2.1.205, un alias di famiglia veniva sostituito o rifiutato in base alla sua versione più recente sola, anche quando una versione più vecchia della stessa famiglia era consentita.

2299 2459

2300**Cosa fare:**2460**Cosa fare:**

2301 2461

2354 2514

2355**Cosa fare:**2515**Cosa fare:**

2356 2516

2357* Eseguite `claude update` e riavviate Claude Code. Opus 4.7 ha bisogno della v2.1.111 o successiva. Opus 4.8 ha bisogno della v2.1.154 o successiva. Sonnet 5 ha bisogno della v2.1.197 o successiva. Opus 5 ha bisogno della v2.1.219 o successiva. Opus 5.5 ha bisogno della v2.1.280 o successiva2517* Eseguite `claude update` e riavviate Claude Code. Opus 4.7 ha bisogno della v2.1.111 o successiva. Opus 4.8 ha bisogno della v2.1.154 o successiva. Sonnet 5 ha bisogno della v2.1.197 o successiva. Opus 5 ha bisogno della v2.1.219 o successiva. Opus 5.5 ha bisogno della v2.1.280 o successiva. Sonnet 5.5 ha bisogno della v2.1.284 o successiva

2358* Se non potete aggiornare, eseguite `/model` e selezionate Opus 4.6 o Sonnet 4.6 invece2518* Se non potete aggiornare, eseguite `/model` e selezionate Opus 4.6 o Sonnet 4.6 invece

2359* Se lo incontrate nell'[Agent SDK](/docs/it/agent-sdk/overview), aggiornate il pacchetto SDK. Opus 4.8 ha bisogno di TypeScript SDK v0.3.154 o successiva e Python SDK v0.2.88 o successiva. Sonnet 5 ha bisogno di TypeScript SDK v0.3.197 o successiva. Opus 5 ha bisogno di TypeScript SDK v0.3.219 o successiva. Opus 5.5 ha bisogno di TypeScript SDK v0.3.280 o successiva2519* Se lo incontrate nell'[Agent SDK](/docs/it/agent-sdk/overview), aggiornate il pacchetto SDK. Opus 4.8 ha bisogno di TypeScript SDK v0.3.154 o successiva e Python SDK v0.2.88 o successiva. Sonnet 5 ha bisogno di TypeScript SDK v0.3.197 o successiva. Opus 5 ha bisogno di TypeScript SDK v0.3.219 o successiva. Opus 5.5 ha bisogno di TypeScript SDK v0.3.280 o successiva. Sonnet 5.5 ha bisogno di TypeScript SDK v0.3.284 o successiva

2360 2520

2361<h3 id="effort-isnt-available-with-thinking-turned-off">2521<h3 id="effort-isnt-available-with-thinking-turned-off">

2362 Effort non è disponibile con thinking disattivato2522 Effort non è disponibile con thinking disattivato

2368API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)2528API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

2369```2529```

2370 2530

2531L'hint dopo il `·` varia per sessione: in una sessione non interattiva recita `use --effort high (or the effortLevel setting)`, e in una sessione che l'app Claude Desktop avvia recita `you can lower effort to High`.

2532

2371**Cosa fare:**2533**Cosa fare:**

2372 2534

2373* [Abbassate il livello di effort](/docs/it/model-config#set-the-effort-level) a `high` o inferiore.2535* [Abbassate il livello di effort](/docs/it/model-config#set-the-effort-level) a `high` o inferiore.

2413* Se state usando Opus 4.7 o Opus 4.8, eseguite `claude update` prima. Le versioni precedenti alla v2.1.156 possono attivare questo errore durante il normale uso di strumenti, e `/rewind` non lo cancella.2575* Se state usando Opus 4.7 o Opus 4.8, eseguite `claude update` prima. Le versioni precedenti alla v2.1.156 possono attivare questo errore durante il normale uso di strumenti, e `/rewind` non lo cancella.

2414* Eseguite `/rewind`, oppure premete Esc due volte, per tornare indietro a un checkpoint prima del turno corrotto e continuare da lì. Vedete [Checkpointing](/docs/it/checkpointing) per come i checkpoint vengono creati e ripristinati.2576* Eseguite `/rewind`, oppure premete Esc due volte, per tornare indietro a un checkpoint prima del turno corrotto e continuare da lì. Vedete [Checkpointing](/docs/it/checkpointing) per come i checkpoint vengono creati e ripristinati.

2415 2577

2578<h3 id="invalid-data-in-redacted-thinking-block">

2579 Dati non validi nel blocco redacted\_thinking

2580</h3>

2581

2582L'API ha rifiutato la richiesta con un 400 perché non poteva accettare un blocco `redacted_thinking` che un turno precedente nella cronologia della conversazione porta.

2583

2584```text theme={null}

2585API Error: 400 ... Invalid `data` in `redacted_thinking` block

2586```

2587

2588Claude Code lascia il thinking precedente della conversazione fuori dalla richiesta e ritenta una volta, quindi la sessione continua senza mostrare l'errore. Prima della v2.1.282, Claude Code manteneva il blocco rifiutato, e ogni turno successivo falliva con lo stesso errore.

2589

2590**Cosa fare:**

2591

2592* Se siete sulla v2.1.281 o precedente e ogni turno fallisce con questo errore, eseguite `claude update` e riprendete la sessione

2593* Se l'errore persiste, eseguite `/clear` per avviare una conversazione che non porta il blocco

2594

2416<h3 id="unsupported-tool-content-removed">2595<h3 id="unsupported-tool-content-removed">

2417 Contenuto di strumento non supportato rimosso2596 Contenuto di strumento non supportato rimosso

2418</h3>2597</h3>

2458L'API ha rifiutato la richiesta con un 400 perché la cronologia della conversazione contiene contenuto di ricerca web ospitato che non può decrittare. La dicitura nomina il campo che non può leggere:2637L'API ha rifiutato la richiesta con un 400 perché la cronologia della conversazione contiene contenuto di ricerca web ospitato che non può decrittare. La dicitura nomina il campo che non può leggere:

2459 2638

2460```text theme={null}2639```text theme={null}

2461API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block2640API Error: 400 ... Invalid `encrypted_content` in `search_result` block

2462API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block2641API Error: 400 ... Invalid `encrypted_index` in `text` block

2463API Error: 400 Failed to decrypt web search result content2642API Error: 400 ... Failed to decrypt web search result content

2643API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block

2464```2644```

2465 2645

2466I risultati dallo [strumento di ricerca web](/docs/it/tools-reference#websearch-tool-behavior) ospitato dell'API portano campi crittografati che solo l'API può leggere. L'API rifiuta una richiesta che riproduce contenuto che non può decrittare, come contenuto prodotto per un'organizzazione diversa.2646I risultati dallo strumento di [ricerca web ospitato](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) dell'API portano campi crittografati che solo l'API può leggere. L'`encrypted_stdout` nomina l'output di un programma di esecuzione di codice ospitato che ha letto tali risultati, che l'API crittografa anche. L'API rifiuta una richiesta che riproduce contenuto che non può decrittare, come contenuto prodotto per un'organizzazione diversa.

2467 2647

2468Lo strumento [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) proprio di Claude Code registra i risultati di ricerca come testo semplice, quindi questi blocchi solitamente raggiungono una conversazione attraverso un proxy o [gateway LLM](/docs/it/llm-gateway) che ha eseguito la ricerca web ospitata stesso.2648Lo strumento [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) proprio di Claude Code registra i risultati di ricerca come testo semplice, quindi questi blocchi solitamente raggiungono una conversazione attraverso un proxy o [gateway LLM](/docs/it/llm-gateway) che ha eseguito la ricerca web ospitata stesso.

2469 2649

2470I blocchi rifiutati rimangono nella cronologia della conversazione, quindi ogni turno successivo e `/compact` falliscono allo stesso modo.2650Per le tre diciture di ricerca web, Claude Code lascia le chiamate di ricerca, i risultati e le citazioni fuori da ciò che invia e ritenta la richiesta una volta, quindi la sessione continua senza mostrare l'errore. La dicitura `encrypted_stdout` non ha tale recupero, quindi quel messaggio vi raggiunge ancora. Prima della v2.1.282, Claude Code manteneva anche i blocchi di ricerca web rifiutati, e ogni turno successivo e `/compact` falliva allo stesso modo.

2471 2651

2472**Cosa fare:**2652**Cosa fare:**

2473 2653

2474* Eseguite `/clear` o avviate una nuova sessione; la nuova conversazione non porta i blocchi rifiutati2654* Se siete sulla v2.1.281 o precedente e ogni turno fallisce con una delle diciture di ricerca web, eseguite `claude update` e riprendete la sessione

2655* Se l'errore persiste, oppure il messaggio nomina `encrypted_stdout`, eseguite `/rewind` per tornare indietro a un checkpoint prima del turno che ha aggiunto il contenuto, oppure eseguite `/clear` per avviare una conversazione che non lo porta

2475* Se eseguite Claude Code dietro un proxy o gateway, segnalate l'errore a chi lo gestisce2656* Se eseguite Claude Code dietro un proxy o gateway, segnalate l'errore a chi lo gestisce

2476 2657

2477<h3 id="usage-policy-refusal">2658<h3 id="usage-policy-refusal">

2478 Rifiuto della politica di utilizzo2659 Rifiuto della politica di utilizzo

2479</h3>2660</h3>

2480 2661

2481L'API ha rifiutato di rispondere perché il contenuto nella conversazione ha attivato un controllo della [Politica di utilizzo](https://www.anthropic.com/legal/aup). Il messaggio include un ID richiesta che potete citare al supporto se ritenete che il rifiuto sia scorretto.2662L'API ha rifiutato di rispondere perché il contenuto nella conversazione ha attivato un controllo della [Politica di utilizzo](https://www.anthropic.com/legal/aup).

2663

2664Il messaggio include un ID richiesta e un ID messaggio che potete citare al supporto se ritenete che il rifiuto sia scorretto.

2482 2665

2483```text theme={null}2666```text theme={null}

2484API Error: Opus 4.6 can't help with this. Start a new session to continue.2667API Error: Opus 4.6 can't help with this. Start a new session to continue.

2508API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2691API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2509```2692```

2510 2693

2511Il messaggio si collega al [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), che concede accesso per il lavoro di cibersicurezza legittimo. Su Opus 5.5, che richiede v2.1.280 o successiva, il messaggio si apre con `Opus 5.5's safeguards flagged this session` invece. Quando la categoria contrassegnata ha un modello di fallback disponibile, Claude Code [cambia modelli](/docs/it/model-config#automatic-model-fallback) piuttosto che mostrare questo errore.2694Il messaggio si collega al [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), che concede accesso per il lavoro di cibersicurezza legittimo. Su Opus 5.5 e Sonnet 5.5, il messaggio si apre con `<model>'s safeguards flagged this session` invece. Quando la categoria contrassegnata ha un modello di fallback disponibile, Claude Code [cambia modelli](/docs/it/model-config#automatic-model-fallback) piuttosto che mostrare questo errore.

2512 2695

2513Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), un contrassegno di cibersicurezza produce il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal) invece.2696Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), un contrassegno di cibersicurezza produce il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal) invece.

2514 2697

2594 Configurazione --agents non valida2777 Configurazione --agents non valida

2595</h3>2778</h3>

2596 2779

2597Il valore che hai passato a `--agents` non è valido, quindi `claude` esce con codice 1 invece di avviare la sessione. Quando passi `--safe-mode`, `--resume`, o `--continue`, o imposti [`CLAUDE_CODE_SAFE_MODE`](/docs/it/env-vars#variables), Claude Code non controlla il valore e avvia la sessione. Prima della v2.1.242, Claude Code avviava comunque la sessione e ometteva le definizioni che non poteva caricare.2780Il valore che hai passato a `--agents` non è valido, quindi `claude` esce con codice 1 invece di avviare la sessione. Quando passi `--safe-mode` o imposti [`CLAUDE_CODE_SAFE_MODE`](/docs/it/env-vars#variables), Claude Code ignora `--agents` completamente. Con `--resume` o `--continue`, un valore JSON inline non viene controllato e la sessione si avvia; un valore letto da un file viene controllato ad ogni avvio. Prima della v2.1.242, Claude Code avviava comunque la sessione e ometteva le definizioni che non poteva caricare.

2598 2781

2599```text theme={null}2782```text theme={null}

2600Error: Invalid --agents configuration:2783Error: Invalid --agents configuration:

2603 2786

2604Quello che segue la prima riga dipende da come il valore ha fallito. Claude Code esegue questi controlli in ordine e si ferma al primo che fallisce. Se il tuo valore ha due tipi di problema, vedi il secondo solo dopo aver corretto il primo:2787Quello che segue la prima riga dipende da come il valore ha fallito. Claude Code esegue questi controlli in ordine e si ferma al primo che fallisce. Se il tuo valore ha due tipi di problema, vedi il secondo solo dopo aver corretto il primo:

2605 2788

26061. Quando il valore non viene analizzato come JSON, Claude Code stampa una riga `invalid JSON:` con il messaggio del parser JSON stesso27891. Quando il valore inizia con `{` ma non viene analizzato come JSON, o il contenuto di un file `--agents` non viene analizzato, Claude Code stampa una riga `invalid JSON:` con il messaggio del parser JSON stesso

26072. Quando viene analizzato ma una definizione di agente non corrisponde allo schema per [subagenti definiti da CLI](/docs/it/sub-agents#choose-the-subagent-scope), Claude Code stampa una riga per problema27902. Quando viene analizzato ma una definizione di agente non corrisponde allo schema per [subagenti definiti da CLI](/docs/it/sub-agents#choose-the-subagent-scope), Claude Code stampa una riga per problema

26083. Quando un nome di agente inizia con `-`, Claude Code stampa `<name>: agent names must not start with '-'`27913. Quando un nome di agente inizia con `-`, Claude Code stampa `<name>: agent names must not start with '-'`

2609 2792

2610Quando ci sono più di 20 righe di problema, Claude Code stampa le prime 20 e sostituisce il resto con `…and N more`.2793Quando ci sono più di 20 righe di problema, Claude Code stampa le prime 20 e sostituisce il resto con `…and N more`.

2611 2794

2795Con `--print`, `--agents` accetta anche [il percorso a un file JSON](/docs/it/sub-agents#choose-the-subagent-scope) al posto dell'oggetto inline. Prima della v2.1.281, `--agents` accettava solo JSON inline e trattava un percorso di file come JSON non valido. La forma di file ha i suoi rifiuti, stampati al posto di questo messaggio, inclusi questi:

2796

2797* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code ha letto il valore come percorso di file in una sessione interattiva. Passa le definizioni come JSON inline, o aggiungi `-p` per leggerle da un file.

2798* **`Error: --agents file not found: <path>`**: nessun file esiste in quel percorso. Un valore che non inizia con `{` e non è JSON valido viene letto come percorso, quindi JSON inline che la tua shell ha rovinato può fallire in questo modo. Controlla il percorso o le virgolette e esegui di nuovo il comando.

2799

2612**Cosa fare:**2800**Cosa fare:**

2613 2801

2614* Correggi ogni problema che il messaggio elenca, quindi esegui di nuovo il comando. Vedi [i campi che un subagente definito da CLI accetta](/docs/it/sub-agents#choose-the-subagent-scope).2802* Correggi ogni problema che il messaggio elenca, quindi esegui di nuovo il comando. Vedi [i campi che un subagente definito da CLI accetta](/docs/it/sub-agents#choose-the-subagent-scope).

2756 Workspace non attendibile all'avvio di Remote Control2944 Workspace non attendibile all'avvio di Remote Control

2757</h3>2945</h3>

2758 2946

2759Hai avviato la modalità server [Remote Control](/docs/it/remote-control) con `claude remote-control` o il suo alias `claude rc` in una directory che non hai attendibile. Il comando non mostra il dialogo di attendibilità dell'area di lavoro stesso, quindi esce con codice 1 e nomina la correzione:2947Hai avviato la modalità server [Remote Control](/docs/it/remote-control) con `claude remote-control` o il suo alias `claude rc` in una directory che non hai attendibile, e il comando non potrebbe chiederti se fidarti di essa. Questo messaggio appare quando l'input standard o l'output standard del comando non è un terminale, ad esempio perché uno di essi è reindirizzato o piped. Il comando esce con codice 1:

2760 2948

2761```text theme={null}2949```text theme={null}

2762Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.2950Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

2763```2951```

2764 2952

2953Due varianti che iniziano anche con `Error: Workspace not trusted.` appaiono in un terminale anche troppo piccolo per mostrare cosa fidarsi della directory attiva, o uno che non ha segnalato la sua dimensione. Ingrandisci la finestra o passa a una finestra terminale normale, quindi esegui di nuovo `claude rc`.

2954

2765Nella tua home directory il messaggio è diverso, perché il dialogo di attendibilità dell'area di lavoro non salva mai l'attendibilità per la home directory, quindi accettarlo lì non può soddisfare questo controllo. Prima della v2.1.214, la home directory mostrava il messaggio sopra, il cui consiglio non può avere successo lì.2955Nella tua home directory il messaggio è diverso, perché il dialogo di attendibilità dell'area di lavoro non salva mai l'attendibilità per la home directory, quindi accettarlo lì non può soddisfare questo controllo. Prima della v2.1.214, la home directory mostrava il messaggio sopra, il cui consiglio non può avere successo lì.

2766 2956

2767```text theme={null}2957```text theme={null}

2768Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).2958Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

2769```2959```

2770 2960

2961Se rispondi `n` o premi Invio alla [domanda `Trust <directory>?`](/docs/it/remote-control#requirements), il comando stampa un messaggio `Remote Control did not start` che nomina la directory e esce con codice 1. Esegui di nuovo `claude rc` per rispondere `y`.

2962

2771**Cosa fare:**2963**Cosa fare:**

2772 2964

2773* Esegui `claude` nella directory, accetta il [dialogo di attendibilità dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi esegui di nuovo `claude remote-control`2965* Fidati della directory da un terminale per primo: esegui `claude rc` lì e rispondi `y`, o esegui `claude` lì e accetta il [dialogo di attendibilità dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi esegui di nuovo il tuo comando originale

2774* Nella tua home directory, cambia a una directory del progetto e avvia Remote Control lì2966* Nella tua home directory, cambia a una directory del progetto e avvia Remote Control lì

2775 2967

2968Prima della v2.1.284, il comando non chiedeva mai, nemmeno in un terminale.

2969

2776<h3 id="not-carried-over-to-the-sessions-remote-control-starts">2970<h3 id="not-carried-over-to-the-sessions-remote-control-starts">

2777 Non trasportato alle sessioni che Remote Control avvia2971 Non trasportato alle sessioni che Remote Control avvia

2778</h3>2972</h3>

3269* Per una sessione interattiva, apri il [picker della sessione](/docs/it/sessions#use-the-session-picker) con `claude --resume` e premi `Ctrl+A` per allargarlo a ogni progetto su questa macchina, quindi seleziona la sessione3463* Per una sessione interattiva, apri il [picker della sessione](/docs/it/sessions#use-the-session-picker) con `claude --resume` e premi `Ctrl+A` per allargarlo a ogni progetto su questa macchina, quindi seleziona la sessione

3270* Le sessioni create con `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/overview) non appaiono nel picker, quindi ri-controlla l'ID rispetto al `session_id` che la tua esecuzione originale ha stampato3464* Le sessioni create con `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/overview) non appaiono nel picker, quindi ri-controlla l'ID rispetto al `session_id` che la tua esecuzione originale ha stampato

3271 3465

3466<h3 id="windows-reported-an-error-ebadf">

3467 Windows ha segnalato un errore (EBADF) quando Claude Code ha letto il file di trascrizione di questa sessione

3468</h3>

3469

3470Hai ripreso una sessione su Windows, il suo file di [trascrizione](/docs/it/sessions#where-transcripts-are-stored) salvato si è aperto normalmente, e la lettura ha quindi fallito con l'errore di sistema EBADF. L'errore di sistema non dice perché la lettura ha fallito, quindi il messaggio suggerisce cause probabili e cosa provare:

3471

3472```text theme={null}

3473Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

3474```

3475

3476Il messaggio segue la riga di fallimento del comando stesso, come `Failed to resume session <session-id>`. Un comando `claude --resume` o [`claude -p`](/docs/it/headless) esce con codice 1 dopo averlo mostrato. Dopo `/resume` all'interno di una sessione, la tua sessione corrente continua a funzionare.

3477

3478**Cosa fare:**

3479

3480* Escludi la cartella che contiene le tue trascrizioni di sessione dal software che scansiona o intercetta le letture di file, come strumenti di sicurezza, crittografia o gestione degli endpoint. Le trascrizioni vivono sotto `%USERPROFILE%\.claude\projects` per impostazione predefinita, o sotto la directory che [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars) nomina

3481* Se non puoi aggiungere un'esclusione, aggiungi Claude Code alle applicazioni consentite di quel software invece

3482* Riprendi la sessione di nuovo

3483

3484Prima della v2.1.282, il fallimento veniva senza spiegazione: `claude --resume <session-id>` terminava a `Failed to resume session <session-id>`, e un'esecuzione `-p` stampava solo il testo di errore di sistema, come `Failed to resume session: EBADF: bad file descriptor, read`.

3485

3272<h3 id="cannot-switch-renderers-in-this-session">3486<h3 id="cannot-switch-renderers-in-this-session">

3273 Impossibile cambiare renderer in questa sessione3487 Impossibile cambiare renderer in questa sessione

3274</h3>3488</h3>

3296* In una sessione avviata senza quelle restrizioni, esegui `/tui fullscreen`, o `/tui default` per cambiare di nuovo. Claude Code salva l'impostazione [`tui`](/docs/it/settings-reference#tui) lì3510* In una sessione avviata senza quelle restrizioni, esegui `/tui fullscreen`, o `/tui default` per cambiare di nuovo. Claude Code salva l'impostazione [`tui`](/docs/it/settings-reference#tui) lì

3297 3511

3298<h3 id="couldnt-open-claude-desktop">3512<h3 id="couldnt-open-claude-desktop">

3299 Couldn't open Claude Desktop3513 Impossibile aprire Claude Desktop

3300</h3>3514</h3>

3301 3515

3302Hai eseguito [`/desktop`](/docs/it/desktop#coming-from-the-cli), o il suo alias `/app`, e il comando di sistema che Claude Code usa per aprire Claude Desktop ha fallito. La sessione rimane nel terminale.3516Hai eseguito [`/desktop`](/docs/it/desktop#coming-from-the-cli), o il suo alias `/app`, e il comando di sistema che Claude Code usa per aprire Claude Desktop ha fallito. La sessione rimane nel terminale.

3452* Rinominate il marketplace con un nome che non ortografia un nome riservato e aggiungetelo di nuovo3666* Rinominate il marketplace con un nome che non ortografia un nome riservato e aggiungetelo di nuovo

3453* Per l'avvertimento di voce ignorata, eseguite il comando `claude plugin marketplace remove` che fornisce, o rimuovete la voce da `~/.claude/plugins/known_marketplaces.json`3667* Per l'avvertimento di voce ignorata, eseguite il comando `claude plugin marketplace remove` che fornisce, o rimuovete la voce da `~/.claude/plugins/known_marketplaces.json`

3454 3668

3669<h3 id="claude-code-refuses-the-marketplace-name">

3670 Claude Code refuses the marketplace name

3671</h3>

3672

3673Un nome di marketplace registrato [impersona un marketplace ufficiale di Anthropic](/docs/it/plugins/marketplace-reference#reserved-names) secondo le regole che quella sezione elenca.

3674

3675Se un marketplace è stato registrato con tale nome prima che il controllo lo bloccasse, il marketplace e i plugin installati da esso smettono di caricarsi, perché Claude Code controlla il nome ogni volta che legge il catalogo del marketplace. Quando il nome imita uno ufficiale, `claude plugin list` e la scheda **Errors** di `/plugin` segnalano ogni plugin interessato con un messaggio che inizia:

3676

3677```text theme={null}

3678Claude Code refuses the marketplace name "anthropic-plugins-v2"

3679```

3680

3681Per un nome imitativo, l'errore del marketplace stesso recita `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` invece. `claude plugin marketplace add` rifiuta qualsiasi nome che impersona con `Marketplace name impersonates an official Anthropic/Claude marketplace`.

3682

3683Prima della v2.1.282, `claude plugin list` e `/plugin` segnalano i plugin di un nome imitativo come falliti a caricarsi anche, senza nominare il nome del marketplace come la causa.

3684

3685**Cosa fare:**

3686

3687* Eseguite `claude plugin marketplace remove <name>`. Questo disinstalla anche i plugin installati dal marketplace e cancella i loro dati salvati

3688* Per mantenere il marketplace invece, aspettate fino a quando il suo manutentore lo rinomina, quindi eseguite `claude plugin marketplace update <name>`

3689* Se pubblicate il marketplace, rinominatelo nel vostro `marketplace.json`; gli utenti aggiornano il marketplace invece di rimuoverlo

3690

3455<h3 id="marketplace-is-already-added-from-a-different-source">3691<h3 id="marketplace-is-already-added-from-a-different-source">

3456 Marketplace is already added from a different source3692 Marketplace is already added from a different source

3457</h3>3693</h3>

3654 3890

3655* Chiedete a un amministratore della vostra organizzazione claude.ai di cambiare lo stato obbligatorio del plugin su claude.ai3891* Chiedete a un amministratore della vostra organizzazione claude.ai di cambiare lo stato obbligatorio del plugin su claude.ai

3656 3892

3893<h3 id="plugin-was-not-uninstalled">

3894 Plugin was not uninstalled

3895</h3>

3896

3897Avete eseguito [`claude plugin uninstall`](/docs/it/plugins/cli-reference#plugin-uninstall), o scelto **Uninstall** nella scheda **Installed** di `/plugin`, e la disinstallazione si è fermata con un messaggio che inizia `"<plugin>" was not uninstalled:`.

3898

3899Quando Claude Code ha rimosso la voce del plugin da `enabledPlugins` e ha letto di nuovo i file delle impostazioni di quel scope, il plugin era ancora attivato lì, oppure un file che potrebbe attivarlo non poteva essere letto o controllato. Eliminare le opzioni salvate del plugin, i segreti e i dati mentre una voce delle impostazioni potrebbe riattivarlo comporterebbe la loro perdita, quindi la disinstallazione si ferma invece: il plugin rimane installato e nulla che ha salvato viene eliminato.

3900

3901```text theme={null}

3902✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.

3903```

3904

3905Il mezzo del messaggio nomina il file e la causa:

3906

3907* `it is still switched on in <file>, although the settings change reported no error`: la scrittura delle impostazioni ha segnalato il successo ma la voce è ancora lì quando il file viene letto di nuovo

3908* `it is still switched on in <file>, and the settings change failed (<error>)`: il file non poteva essere salvato, per il motivo tra parentesi

3909* `<file> is there and could not be read`: il file esiste ma non poteva essere letto come impostazioni, ad esempio perché non è JSON valido, quindi potrebbe ancora abilitare il plugin

3910* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code non ha letto il file delle impostazioni del progetto o locale perché il file, o la cartella `.claude` che lo contiene, è un link che porta a una posizione di rete, o perché non poteva esaminare quel percorso

3911

3912`claude plugin uninstall` esce con 1, e con `--json` il risultato porta `failureCode: "settings_still_on"`. `/plugin` mostra lo stesso messaggio.

3913

3914**Cosa fare:**

3915

3916* Seguite l'ultima frase del messaggio: riparate o sostituite il file delle impostazioni che nomina, o rimuovete la voce del plugin da `enabledPlugins` in quel file voi stessi, quindi eseguite di nuovo la disinstallazione

3917

3657<h2 id="tool-errors">3918<h2 id="tool-errors">

3658 Errori degli strumenti3919 Errori degli strumenti

3659</h2>3920</h2>

3660 3921

3661Questi errori provengono dagli strumenti integrati di Claude. Claude corregge la maggior parte degli errori degli strumenti autonomamente. Quando è necessario un cambiamento da parte vostra, l'elenco **Cosa fare** di quell'errore specifica cosa cambiare.3922Questi errori provengono dagli strumenti integrati di Claude. Claude corregge la maggior parte degli errori degli strumenti autonomamente. Quando uno richiede una modifica da parte vostra, l'elenco **Cosa fare** di quell'errore specifica cosa cambiare.

3662 3923

3663<h3 id="agent-would-be-spawned-with-zero-tools">3924<h3 id="agent-would-be-spawned-with-zero-tools">

3664 Agent would be spawned with zero tools3925 Agent would be spawned with zero tools

3700 3961

3701**Cosa fare:**3962**Cosa fare:**

3702 3963

3703* Se Claude dovrebbe essere in grado di cambiare il file, rimuovete o restringete la regola di negazione `Read` in `/permissions` o nelle [impostazioni](/docs/it/settings-reference#permission-settings)3964* Se Claude dovrebbe essere in grado di modificare il file, rimuovete o restringete la regola di negazione `Read` in `/permissions` o nelle [impostazioni](/docs/it/settings-reference#permission-settings)

3704* Se il file deve rimanere intatto, mantenete la regola e aggiungete una regola di negazione `Edit` per lo stesso percorso per bloccare anche lo strumento NotebookEdit3965* Se il file deve rimanere intatto, mantenete la regola e aggiungete una regola di negazione `Edit` per lo stesso percorso per bloccare anche lo strumento NotebookEdit

3705 3966

3967<h3 id="path-cannot-contain-null-bytes">

3968 Path cannot contain null bytes

3969</h3>

3970

3971Un argomento di percorso o pattern di una chiamata dello strumento file conteneva un byte null, che i file system e gli strumenti di ricerca non possono accettare. Read, Write, Edit, NotebookEdit, Glob e Grep controllano questo, e il messaggio nomina lo strumento e l'argomento:

3972

3973```text theme={null}

3974Read file_path cannot contain null bytes (\0). Remove the null byte and try again.

3975```

3976

3977La chiamata dello strumento fallisce, Claude vede l'errore, e il turno continua.

3978

3979**Cosa fare:**

3980

3981* Niente da parte vostra: l'errore viene restituito a Claude come risultato dello strumento, e il messaggio stesso dice a Claude di rimuovere il byte null e riprovare

3982

3983Prima della v2.1.281, un byte null in un percorso Read, Write, Edit o NotebookEdit terminava l'intero turno con un errore che nominava `Path contains null bytes`, e lo strumento non veniva mai eseguito.

3984

3706<h3 id="subagent-type-is-required">3985<h3 id="subagent-type-is-required">

3707 subagent\_type is required3986 subagent\_type is required

3708</h3>3987</h3>

3711subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...3990subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...

3712```3991```

3713 3992

3714Claude ha chiamato lo [strumento Agent](/docs/it/tools-reference#agent-tool-behavior) senza un `subagent_type`, e questa sessione non ha un [subagent per uso generale](/docs/it/sub-agents#built-in-subagents) su cui fare affidamento. Questo è il caso in due configurazioni:3993Claude ha chiamato lo [strumento Agent](/docs/it/tools-reference#agent-tool-behavior) senza un `subagent_type`, e questa sessione non ha un [subagent general-purpose](/docs/it/sub-agents#built-in-subagents) su cui ricadere. Questo è il caso in due configurazioni:

3715 3994

3716* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/it/env-vars) è impostato in modalità non interattiva, che rimuove ogni subagent integrato3995* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/it/env-vars) è impostato in modalità non interattiva, che rimuove ogni subagent integrato

3717* L'agent del thread principale della sessione ha una [lista di consentiti `tools: Agent(...)`](/docs/it/sub-agents#restrict-which-subagents-can-be-spawned) che esclude `general-purpose`3996* L'agent del thread principale della sessione ha una [lista di autorizzazione `tools: Agent(...)`](/docs/it/sub-agents#restrict-which-subagents-can-be-spawned) che esclude `general-purpose`

3718 3997

3719**Cosa fare:**3998**Cosa fare:**

3720 3999

3721* Di solito nulla: il messaggio elenca i subagent che la sessione ha, quindi Claude può riprovare con uno di essi4000* Di solito niente: il messaggio elenca i subagent che la sessione ha, quindi Claude può riprovare con uno di essi

3722* Se Claude continua a fallire, aggiungete `general-purpose` alla lista di consentiti `tools: Agent(...)`, o disattivate `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`4001* Se Claude continua a fallire, aggiungete `general-purpose` alla lista di autorizzazione `tools: Agent(...)`, o disattivate `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`

3723 4002

3724Prima della v2.1.235, la stessa chiamata falliva con `Agent type 'general-purpose' not found`.4003Prima della v2.1.235, la stessa chiamata falliva con `Agent type 'general-purpose' not found`.

3725 4004

3727 Memory index is over its read limit4006 Memory index is over its read limit

3728</h3>4007</h3>

3729 4008

3730Claude ha scritto nell'indice di [memoria automatica](/docs/it/memory#auto-memory) `MEMORY.md` e lo ha lasciato oltre uno dei suoi limiti di lettura: 200 righe o 25KB. La scrittura è riuscita, ma solo le prime 200 righe o 25KB, a seconda di quale viene raggiunto per primo, vengono caricate all'inizio di una sessione, quindi tutto ciò che supera il limite viene eliminato ogni volta che l'indice viene letto. Prima della v2.1.210, un indice oltre il limite veniva silenziosamente troncato al caricamento successivo senza segnale al momento della scrittura.4009Claude ha scritto nell'indice [memoria automatica](/docs/it/memory#auto-memory) `MEMORY.md` e l'ha lasciato oltre uno dei suoi limiti di lettura: 200 righe o 25KB. La scrittura è riuscita, ma solo le prime 200 righe o 25KB, a seconda di quale viene raggiunto per primo, vengono caricate all'inizio di una sessione, quindi tutto ciò che supera il limite viene eliminato ogni volta che l'indice viene letto. Prima della v2.1.210, un indice oltre il limite veniva silenziosamente troncato al caricamento successivo senza segnale al momento della scrittura.

3731 4010

3732```text theme={null}4011```text theme={null}

3733Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.4012Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.

3741 4020

3742**Cosa fare:**4021**Cosa fare:**

3743 4022

3744* Lasciate che Claude riscrivi `MEMORY.md`, o chiedetegli di farlo: mantenete una riga per voce, spostate i dettagli in file di argomenti e unite o eliminate le voci obsolete4023* Lasciate che Claude riscrivi `MEMORY.md`, o chiedetegli: mantenete una riga per voce, spostate i dettagli nei file di argomento, e unite o eliminate le voci obsolete

3745* Per ridurre l'indice voi stessi, vedete [Audit and edit your memory](/docs/it/memory#audit-and-edit-your-memory)4024* Per ridurre l'indice voi stessi, vedete [Audit and edit your memory](/docs/it/memory#audit-and-edit-your-memory)

3746 4025

3747<h3 id="pkill-pattern-matches-the-claude-code-process">4026<h3 id="pkill-pattern-matches-the-claude-code-process">

3748 pkill pattern matches the Claude Code process4027 pkill pattern matches the Claude Code process

3749</h3>4028</h3>

3750 4029

3751Un comando `pkill` in una chiamata dello strumento Bash ha usato un pattern, tipicamente con `-f`, che corrisponde al processo Claude Code stesso, quindi Claude Code rifiuta il comando invece di permettergli di terminare la sessione. Claude Code testa il pattern con `pgrep` prima di eseguire `pkill` e rifiuta quando il suo ID di processo è nel risultato. Il controllo viene eseguito solo su Linux; su macOS, `pkill` viene eseguito senza modifiche. Prima della v2.1.214, il comando veniva eseguito e un pattern corrispondente terminava la sessione Claude Code a metà turno.4030Un comando `pkill` in una chiamata dello strumento Bash ha usato un pattern, tipicamente con `-f`, che corrisponde al processo Claude Code stesso, quindi Claude Code rifiuta il comando invece di lasciarlo terminare la sessione. Claude Code testa il pattern con `pgrep` prima di eseguire `pkill` e rifiuta quando il suo ID di processo è nel risultato. Il controllo viene eseguito solo su Linux; su macOS, `pkill` viene eseguito senza modifiche. Prima della v2.1.214, il comando veniva eseguito, e un pattern corrispondente uccideva la sessione Claude Code a metà turno.

3752 4031

3753```text theme={null}4032```text theme={null}

3754pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.4033pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.

3759**Cosa fare:**4038**Cosa fare:**

3760 4039

3761* Restringete il pattern in modo che corrisponda solo al processo previsto, ad esempio il percorso completo del binario di destinazione piuttosto che una breve sottostringa4040* Restringete il pattern in modo che corrisponda solo al processo previsto, ad esempio il percorso completo del binario di destinazione piuttosto che una breve sottostringa

3762* Per arrestare i processi avviati dalla shell corrente, usate `pkill -P $$` con il pattern, che limita la corrispondenza ai processi figli della shell stessa4041* Per interrompere i processi avviati dalla shell corrente, usate `pkill -P $$` con il pattern, che limita la corrispondenza ai processi figli della shell stessa

3763 4042

3764<h3 id="failed-to-write-to-a-teammate-inbox">4043<h3 id="failed-to-write-to-a-teammate-inbox">

3765 Failed to write to a teammate's inbox4044 Failed to write to a teammate's inbox

3773Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.4052Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.

3774```4053```

3775 4054

3776I messaggi del protocollo strutturato del [team di agent](/docs/it/agent-teams) falliscono allo stesso modo, e l'errore nomina il messaggio non consegnato: quando Claude Code non può scrivere un'approvazione del piano, un rifiuto del piano, una richiesta di arresto o un rifiuto di arresto, l'errore recita `Failed to write the <message> to <name>'s inbox — nothing was sent`. L'`approvazione del piano` in quell'elenco è la decisione del lead che approva il piano di un compagno di squadra; la presentazione del piano del compagno di squadra è il messaggio separato `richiesta di approvazione del piano`. Quel messaggio e altri due messaggi del protocollo portano il loro testo di messaggio e conseguenza:4055I messaggi del protocollo strutturato del [team di agent](/docs/it/agent-teams) falliscono allo stesso modo, e l'errore nomina il messaggio non consegnato: quando Claude Code non può scrivere un'approvazione del piano, un rifiuto del piano, una richiesta di arresto, o un rifiuto di arresto, l'errore legge `Failed to write the <message> to <name>'s inbox — nothing was sent`. L'`approvazione del piano` in quell'elenco è la decisione del lead che approva il piano di un compagno di squadra; la presentazione del piano del compagno di squadra è il messaggio separato `richiesta di approvazione del piano`. Quel messaggio e altri due messaggi del protocollo portano il loro proprio testo di messaggio e conseguenza:

3777 4056

3778* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: il piano del compagno di squadra non ha mai raggiunto il lead, e il compagno di squadra rimane in modalità piano fino a quando una nuova presentazione non riesce4057* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: il piano del compagno di squadra non ha mai raggiunto il lead, e il compagno di squadra rimane in plan mode fino a quando una ritrasmissione riesce

3779* `The permission request could not be delivered to the team lead (mailbox write failed)`: la richiesta di autorizzazione del compagno di squadra non ha mai raggiunto il lead, quindi nessuno ha approvato la chiamata dello strumento4058* `The permission request could not be delivered to the team lead (mailbox write failed)`: la richiesta di permesso del compagno di squadra non ha mai raggiunto il lead, quindi nessuno ha approvato la chiamata dello strumento

3780* `The confirmation could not be written to team-lead's inbox.`: l'approvazione dell'arresto stesso ha avuto effetto e il compagno di squadra esce; solo la conferma al lead manca4059* `The confirmation could not be written to team-lead's inbox.`: l'approvazione dell'arresto stesso ha avuto effetto e il compagno di squadra esce; solo la conferma al lead manca

3781 4060

3782Quando voi stessi inviate un messaggio a un compagno di squadra, digitando `@name` seguito dal messaggio nella sessione del lead, lo stesso errore appare come notifica, `Couldn't write to @name's inbox — message not sent. Try again.`, e Claude Code mantiene il vostro testo nella casella del prompt in modo che possiate inviarlo di nuovo.4061Quando voi stessi mandate un messaggio a un compagno di squadra, digitando `@name` seguito dal messaggio nella sessione del lead, lo stesso fallimento appare come una notifica, `Couldn't write to @name's inbox — message not sent. Try again.`, e Claude Code mantiene il vostro testo nella casella del prompt in modo che possiate inviarlo di nuovo.

3783 4062

3784**Cosa fare:**4063**Cosa fare:**

3785 4064

3786* Chiedete al mittente di inviare di nuovo il messaggio; la contesa per il blocco della casella di posta è transitoria e si risolve al nuovo tentativo4065* Chiedete al mittente di rinviare il messaggio; la contesa per il blocco della casella di posta è transitoria e si risolve al nuovo tentativo

3787* Controllate lo spazio libero su disco e verificate che `~/.claude/teams` e i file sotto di esso siano scrivibili dal vostro utente4066* Controllate lo spazio libero su disco, e controllate che `~/.claude/teams` e i file sotto di esso siano scrivibili dal vostro utente

3788 4067

3789<h3 id="teammate-agent-definition-not-restored">4068<h3 id="teammate-agent-definition-not-restored">

3790 Teammate's agent definition was not restored4069 Teammate's agent definition was not restored

3791</h3>4070</h3>

3792 4071

3793Claude ha inviato un messaggio a un compagno di squadra del [team di agent](/docs/it/agent-teams) arrestato, e Claude Code lo ha riportato in vita senza riapplicare la [definizione del subagent](/docs/it/agent-teams#use-subagent-definitions-for-teammates) da cui era stato generato, perché il suo file di definizione proveniva da una cartella senza fiducia salvata. L'avviso segue il rapporto di ripresa nel risultato dello strumento dell'agent mittente:4072Claude ha mandato un messaggio a un compagno di squadra del [team di agent](/docs/it/agent-teams) fermato, e Claude Code l'ha riportato senza riapplicare la [definizione del subagent](/docs/it/agent-teams#use-subagent-definitions-for-teammates) da cui è stato generato, perché il suo file di definizione proveniva da una cartella senza fiducia salvata. L'avviso segue il rapporto di ripresa nel risultato dello strumento dell'agent mittente:

3794 4073

3795```text wrap theme={null}4074```text wrap theme={null}

3796Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.4075Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.

3800 4079

3801**Cosa fare:**4080**Cosa fare:**

3802 4081

3803* Eseguite `claude` nella cartella che il [log di debug](/docs/it/debug-your-config) nomina e accettate la finestra di dialogo di fiducia. La definizione viene riapplicata la prossima volta che Claude Code riporta in vita il compagno di squadra; non è necessario riavviare la sessione del lead4082* Eseguite `claude` nella cartella che il [debug log](/docs/it/debug-your-config) nomina e accettate la finestra di dialogo di fiducia. La definizione viene riapplicata la prossima volta che Claude Code riporta il compagno di squadra; non è necessario riavviare la sessione del lead

3804* Oppure impostate la voce `hasTrustDialogAccepted` su `true` in `~/.claude.json`, usando la chiave esatta `projects["<path>"]` che il log di debug stampa4083* Oppure impostate la voce `hasTrustDialogAccepted` su `true` in `~/.claude.json`, usando la chiave esatta `projects["<path>"]` che il debug log stampa

3805 4084

3806<h3 id="message-too-large-for-cross-session-delivery">4085<h3 id="message-too-large-for-cross-session-delivery">

3807 Message too large for cross-session delivery4086 Message too large for cross-session delivery

3808</h3>4087</h3>

3809 4088

3810Il [messaggio tra sessioni](/docs/it/cross-session-messaging) di Claude a un'altra delle vostre sessioni su questa macchina era troppo lungo per essere inviato. Claude Code lo ha rifiutato e la sessione ricevente non ha ricevuto nulla. Il rifiuto appare nel risultato dello strumento della sessione mittente, non come banner nel vostro terminale. Nomina entrambe le dimensioni e come fare in modo che il messaggio si adatti:4089Il [messaggio cross-session](/docs/it/cross-session-messaging) di Claude a un'altra delle vostre sessioni su questa macchina era troppo lungo per essere inviato. Claude Code l'ha rifiutato, e la sessione ricevente non ha ricevuto nulla. Il rifiuto appare nel risultato dello strumento della sessione mittente, non come banner nel vostro terminale. Nomina entrambe le dimensioni e come fare in modo che il messaggio si adatti:

3811 4090

3812```text wrap theme={null}4091```text wrap theme={null}

3813Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.4092Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.

3814```4093```

3815 4094

3816L'invio dello stesso testo fallisce allo stesso modo.4095Rinviare lo stesso testo fallisce allo stesso modo.

3817 4096

3818**Cosa fare:**4097**Cosa fare:**

3819 4098

3820* Chiedete a Claude di riassumere il messaggio, o di mettere il contenuto in massa in un file e inviare il percorso del file4099* Chiedete a Claude di riassumere il messaggio, o di mettere il contenuto in massa in un file e inviare il percorso del file

3821* Chiedete a Claude di dividere il contenuto in diversi messaggi più brevi4100* Chiedete a Claude di dividere il contenuto su diversi messaggi più brevi

3822 4101

3823Prima della v2.1.235, Claude Code segnalava un messaggio di dimensioni eccessive come inviato. La sessione ricevente lo eliminava senza leggerlo.4102Prima della v2.1.235, Claude Code segnalava un messaggio di dimensioni eccessive come inviato. La sessione ricevente lo eliminava senza leggerlo.

3824 4103

3826 Too many messages to this session just now4105 Too many messages to this session just now

3827</h3>4106</h3>

3828 4107

3829Claude ha inviato una raffica rapida di [messaggi tra sessioni](/docs/it/cross-session-messaging) a una delle vostre sessioni su questa macchina, e la raffica ha raggiunto ciò che quella casella di posta della sessione accetta. Claude Code ha rifiutato l'invio successivo e la sessione ricevente non ha ricevuto nulla da esso. Il rifiuto appare nel risultato dello strumento della sessione mittente, non come banner nel vostro terminale:4108Claude ha inviato una raffica rapida di [messaggi cross-session](/docs/it/cross-session-messaging) a una delle vostre sessioni su questa macchina, e la raffica ha raggiunto ciò che quella sessione accetta nella casella di posta. Claude Code ha rifiutato l'invio successivo, e la sessione ricevente non ha ricevuto nulla da esso. Il rifiuto appare nel risultato dello strumento della sessione mittente, non come banner nel vostro terminale:

3830 4109

3831```text wrap theme={null}4110```text wrap theme={null}

3832Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.4111Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.

3834 4113

3835**Cosa fare:**4114**Cosa fare:**

3836 4115

3837* Di solito nulla: Claude raggruppa il contenuto rimanente in un messaggio, o aspetta prima di inviare di più4116* Di solito niente: Claude raggruppa il contenuto rimanente in un messaggio, o aspetta prima di inviare di più

3838* Se avete voi stessi richiesto la raffica, chiedete a Claude di combinare ciò che rimane in un singolo messaggio4117* Se avete voi stessi richiesto la raffica, chiedete a Claude di combinare ciò che rimane in un singolo messaggio

3839 4118

3840Prima della v2.1.236, Claude Code segnalava questi invii come inviati. La sessione ricevente li eliminava senza leggerli.4119Prima della v2.1.236, Claude Code segnalava questi invii come inviati. La sessione ricevente li eliminava senza leggerli.

3843 Refusing to send a cross-session message4122 Refusing to send a cross-session message

3844</h3>4123</h3>

3845 4124

3846Prima che Claude Code scriva un [messaggio tra sessioni](/docs/it/cross-session-messaging) a un'altra delle vostre sessioni su questa macchina, verifica che la socket della casella di posta della sessione di destinazione sia l'endpoint a cui il messaggio era indirizzato. Quando un controllo fallisce, Claude Code rifiuta l'invio nella sessione mittente e la sessione di destinazione non riceve nulla. Per un messaggio che Claude invia, il rifiuto appare nel risultato dello strumento della sessione mittente:4125Prima che Claude Code scriva un [messaggio cross-session](/docs/it/cross-session-messaging) a un'altra delle vostre sessioni su questa macchina, controlla che la socket della casella di posta della sessione di destinazione sia l'endpoint a cui il messaggio era indirizzato. Quando un controllo fallisce, Claude Code rifiuta l'invio nella sessione mittente, e la sessione di destinazione non riceve nulla. Per un messaggio che Claude invia, il rifiuto appare nel risultato dello strumento della sessione mittente:

3847 4126

3848```text theme={null}4127```text theme={null}

3849Failed to send to api-worker: Refusing to send: reply target is a symlink4128Failed to send to api-worker: Refusing to send: reply target is a symlink

3852Il testo dopo `Refusing to send:` nomina il controllo che ha fallito:4131Il testo dopo `Refusing to send:` nomina il controllo che ha fallito:

3853 4132

3854* `reply target is a symlink`: un collegamento simbolico si trova nel percorso della socket della sessione di destinazione. Claude Code non consegna attraverso di esso, perché un collegamento lì potrebbe reindirizzare il messaggio a un endpoint che la sessione di destinazione non ha creato.4133* `reply target is a symlink`: un collegamento simbolico si trova nel percorso della socket della sessione di destinazione. Claude Code non consegna attraverso di esso, perché un collegamento lì potrebbe reindirizzare il messaggio a un endpoint che la sessione di destinazione non ha creato.

3855* `cannot vet reply target`: Claude Code non ha potuto ispezionare il percorso di destinazione affatto, ad esempio perché la lettura è fallita con un errore di autorizzazione.4134* `cannot vet reply target`: Claude Code non ha potuto ispezionare il percorso di destinazione affatto, ad esempio perché la lettura è fallita con un errore di permesso.

3856* `connected endpoint is not the expected process`: il processo che tiene la socket non è la sessione a cui il messaggio era indirizzato, quindi l'indirizzo è obsoleto o un altro processo ha sostituito la socket.4135* `connected endpoint is not the expected process`: il processo che tiene la socket non è la sessione a cui il messaggio era indirizzato, quindi l'indirizzo è obsoleto o un altro processo ha sostituito la socket.

3857* `connected endpoint identity could not be read`: Claude Code si è connesso ma non ha potuto leggere quale processo tiene l'altro capo, quindi non ha potuto confermare la destinazione. Questo può essere transitorio.4136* `connected endpoint identity could not be read`: Claude Code si è connesso ma non ha potuto leggere quale processo tiene l'altro capo, quindi non ha potuto confermare la destinazione. Questo può essere transitorio.

3858* `connected endpoint is not owned by this user`: il processo che tiene la socket viene eseguito con un account utente diverso, quindi non è una delle vostre sessioni.4137* `connected endpoint is not owned by this user`: il processo che tiene la socket viene eseguito come un account utente diverso, quindi non è una delle vostre sessioni.

3859* `connected endpoint owner could not be read`: Claude Code si è connesso ma non ha potuto leggere quale account utente possiede l'altro capo, quindi non ha potuto confermare che l'endpoint è vostro.4138* `connected endpoint owner could not be read`: Claude Code si è connesso ma non ha potuto leggere quale account utente possiede l'altro capo, quindi non ha potuto confermare che l'endpoint è vostro.

3860* `connected endpoint is a different process with the expected pid`: l'ID del processo corrisponde a quello a cui il messaggio era indirizzato, ma Claude Code non ha potuto confermare che è lo stesso processo. Di solito quella sessione è uscita e il sistema operativo ha riutilizzato il suo ID di processo, quindi l'indirizzo è obsoleto.4139* `connected endpoint is a different process with the expected pid`: l'ID del processo corrisponde a quello a cui il messaggio era indirizzato, ma Claude Code non ha potuto confermare che è lo stesso processo. Di solito quella sessione è uscita e il sistema operativo ha riutilizzato il suo ID di processo, quindi l'indirizzo è obsoleto.

3861 4140

3862**Cosa fare:**4141**Cosa fare:**

3863 4142

3864* Di solito nulla: i controlli impediscono a un messaggio di raggiungere un endpoint diverso dalla sessione a cui era indirizzato, e nulla è stato inviato4143* Di solito niente: i controlli impediscono a un messaggio di raggiungere un endpoint diverso dalla sessione a cui era indirizzato, e nulla è stato inviato

3865* Chiedete a Claude di elencare di nuovo le vostre sessioni e di inviare di nuovo; un rifiuto causato da un indirizzo obsoleto si risolve una volta che Claude invia a quello corrente4144* Chiedete a Claude di elencare di nuovo le vostre sessioni e rinviate; un rifiuto causato da un indirizzo obsoleto si risolve una volta che Claude invia a quello corrente

3866* Se `reply target is a symlink` si ripete per una sessione, controllate cosa ha creato un collegamento nel percorso della socket di quella sessione, mostrato nel suo `/status` sotto `Peer address`4145* Se `reply target is a symlink` si ripete per una sessione, controllate cosa ha creato un collegamento nel percorso della socket di quella sessione, mostrato nel suo `/status` sotto `Peer address`

3867* Per `connected endpoint identity could not be read`, inviate di nuovo; la condizione può essere transitoria4146* Per `connected endpoint identity could not be read`, rinviate; la condizione può essere transitoria

3868* Se `connected endpoint is not owned by this user` appare su una macchina condivisa, la sessione a quell'indirizzo viene eseguita con l'account di un altro utente, quindi Claude non può inviarle messaggi dal vostro4147* Se `connected endpoint is not owned by this user` appare su una macchina condivisa, la sessione a quell'indirizzo viene eseguita con l'account di un altro utente, quindi Claude non può mandarle messaggi dal vostro

3869 4148

3870Prima della v2.1.248, Claude Code non controllava l'utente proprietario dell'endpoint o l'ora di inizio del processo, quindi i rifiuti che nominano quei controlli non appaiono nelle versioni precedenti.4149Prima della v2.1.248, Claude Code non controllava l'utente proprietario dell'endpoint o l'ora di inizio del processo, quindi i rifiuti che nominano quei controlli non appaiono nelle versioni precedenti.

3871 4150

3873 Refusing to read, write, or search a path4152 Refusing to read, write, or search a path

3874</h3>4153</h3>

3875 4154

3876Claude Code controlla le [regole di autorizzazione](/docs/it/permissions#read-and-edit) di un percorso di file, quindi conferma di nuovo quella risoluzione quando lo strumento apre il file o avvia la ricerca. Quando non può confermare che il percorso conduce ancora alla posizione che il controllo ha approvato, Claude Code rifiuta l'operazione invece di seguirla. Il rifiuto appare nel risultato dello strumento:4155Claude Code controlla le [regole di permesso](/docs/it/permissions#read-and-edit) di un percorso file, quindi conferma di nuovo quella risoluzione quando lo strumento apre il file o avvia la ricerca. Quando non può confermare che il percorso conduce ancora alla posizione che il controllo ha approvato, Claude Code rifiuta l'operazione invece di seguirla. Il rifiuto appare nel risultato dello strumento:

3877 4156

3878```text wrap theme={null}4157```text wrap theme={null}

3879Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.4158Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.

3880```4159```

3881 4160

3882Ogni rifiuto nomina il suo motivo:4161Ogni rifiuto nomina la sua ragione:

3883 4162

3884* `its symlink resolution changed after permission was checked`: un collegamento simbolico lungo il percorso, o in una radice di ricerca Grep o Glob, è stato sostituito tra il controllo di autorizzazione e l'operazione. In un rifiuto di lettura, la frase tra parentesi nomina quale confronto è fallito.4163* `its symlink resolution changed after permission was checked`: un collegamento simbolico lungo il percorso, o in una radice di ricerca Grep o Glob, è stato sostituito tra il controllo di permesso e l'operazione. In un rifiuto di lettura, la frase tra parentesi nomina quale confronto ha fallito.

3885* `its parent-directory symlink resolution changed after permission was checked`: una directory attraverso cui passa il percorso di scrittura non si risolve più nella posizione approvata4164* `its parent-directory symlink resolution changed after permission was checked`: una directory che il percorso di scrittura attraversa non si risolve più nella posizione approvata

3886* `it is a symbolic link. Write to the link's target path instead`: un collegamento simbolico si trova nella posizione di scrittura approvata stessa, ad esempio un `CLAUDE.md` che è un collegamento simbolico a `AGENTS.md`; il messaggio dirige Claude al target del collegamento4165* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code non ha potuto seguire il percorso a una posizione finale su disco, ad esempio perché i collegamenti simbolici su di esso formano un ciclo

4166* `it is a symbolic link. Write to the link's target path instead`: un collegamento simbolico si trova nella posizione di scrittura richiesta stessa, ad esempio un `CLAUDE.md` che è un collegamento simbolico a `AGENTS.md`; il messaggio vi indirizza al target del collegamento

3887* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: la stessa condizione catturata quando un altro writer apre il file, come una scrittura a un `.mcp.json` collegato simbolicamente4167* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: la stessa condizione catturata quando un altro writer apre il file, come una scrittura a un `.mcp.json` collegato simbolicamente

3888* `Refusing to write into symlinked directory: <path>`: la directory che contiene il file è essa stessa un collegamento simbolico, ad esempio la directory `.claude/` di un progetto collegata a un'altra posizione4168* `Refusing to write into symlinked directory: <path>`: la directory che contiene il file è essa stessa un collegamento simbolico, ad esempio la directory `.claude/` di un progetto collegata a un'altra posizione

3889* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: una regola di negazione `Read` per la ricerca nomina un percorso che passa attraverso un collegamento simbolico, e quel collegamento è cambiato mentre Claude Code stava preparando la ricerca4169* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: una regola di negazione `Read` per la ricerca nomina un percorso che passa attraverso un collegamento simbolico, e quel collegamento è cambiato mentre Claude Code stava preparando la ricerca

3890* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: la radice di ricerca esiste ma non ha potuto essere aperta; il codice tra parentesi è l'errore del sistema operativo4170* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: la radice di ricerca esiste ma non ha potuto essere aperta; il codice tra parentesi è l'errore del sistema operativo

3891* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code ha eliminato il record di approvazione in molte operazioni di file simultanee prima che lo strumento lo usasse; riprovare esegue un controllo di autorizzazione fresco4171* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code ha eliminato il record di approvazione sotto molte operazioni file simultanee prima che lo strumento lo usasse; riprovare esegue un controllo di permesso fresco

3892* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code non ha potuto risolvere il binario `rg` a un percorso assoluto, quindi rifiuta le ricerche al di fuori della directory di lavoro piuttosto che eseguirne una che le vostre regole di negazione non coprono4172* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code non ha potuto risolvere il binario `rg` a un percorso assoluto, quindi rifiuta le ricerche al di fuori della directory di lavoro piuttosto che eseguirne una che le vostre regole di negazione non coprono

3893 4173

3894**Cosa fare:**4174**Cosa fare:**

3895 4175

3896* Di solito nulla: il rifiuto raggiunge Claude come risultato dello strumento, e l'operazione rifiutata non viene eseguita4176* Di solito niente: il rifiuto raggiunge Claude come risultato dello strumento, e l'operazione rifiutata non viene eseguita

3897* Se un rifiuto di collegamento simbolico si ripete su un percorso, trovate cosa continua a riscrivere un collegamento lì, come uno strumento di compilazione o un file watcher, o chiedete a Claude di usare il percorso risolto del file invece di quello collegato4177* Se un rifiuto di collegamento simbolico si ripete su un percorso, trovate cosa continua a riscrivere un collegamento lì, come uno strumento di build o un file watcher, o chiedete a Claude di usare il percorso risolto del file invece di quello collegato

3898* Se questo rifiuto appare per ogni file mentre Claude Code viene eseguito su Windows all'interno di un AppContainer o sandbox con token limitato, aggiornate alla v2.1.265 o successiva4178* Se questo rifiuto appare per ogni file mentre Claude Code viene eseguito su Windows all'interno di un AppContainer o sandbox con token limitato, aggiornate alla v2.1.265 o successiva

3899* Se un rifiuto di lettura appare su macOS per un file che nulla sta riscrivendo, come uno screenshot trascinato nel prompt, aggiornate alla v2.1.273 o successiva4179* Se un rifiuto di lettura appare su macOS per un file che nulla sta riscrivendo, come uno screenshot trascinato nel prompt, aggiornate alla v2.1.273 o successiva

3900* Per il rifiuto di ripgrep, installate ripgrep con il vostro gestore di pacchetti in modo che `rg` si risolva a un percorso assoluto su `PATH`, o mantenete le ricerche sotto la directory di lavoro4180* Per il rifiuto di ripgrep, installate ripgrep con il vostro gestore di pacchetti in modo che `rg` si risolva a un percorso assoluto su `PATH`, o mantenete le ricerche sotto la directory di lavoro

3901 4181

3902Prima della v2.1.251, Claude Code ri-controllava la risoluzione di un percorso solo per le scritture di file, quindi un collegamento sostituito dopo il controllo di autorizzazione poteva reindirizzare una lettura o una ricerca a una posizione diversa senza un messaggio. Di questi, solo il rifiuto di scrittura della directory padre, attraverso-collegamento e directory-collegata appaiono nelle versioni precedenti.4182Prima della v2.1.251, Claude Code ricontrollava la risoluzione di un percorso solo per le scritture di file, quindi un collegamento sostituito dopo il controllo di permesso potrebbe reindirizzare una lettura o una ricerca a una posizione diversa senza un messaggio. Di questi, solo i rifiuti di scrittura della directory padre, attraverso collegamento simbolico, e directory collegata simbolicamente appaiono nelle versioni precedenti.

4183

4184Prima della v2.1.280, il rifiuto `where it leads on disk could not be determined` non appariva.

3903 4185

3904<h3 id="task-output-swap-refused">4186<h3 id="task-output-swap-refused">

3905 Task output swap refused4187 Task output swap refused

3906</h3>4188</h3>

3907 4189

3908Claude Code salva l'output di ogni comando Bash in un file sotto la sua directory temporanea. Ogni volta che apre uno di questi file, controlla che il percorso conduca ancora al file che ha creato, senza collegamento simbolico, collegamento fisico aggiuntivo o directory spostata che lo reindirizza. Questo messaggio significa che quel controllo è fallito, quindi Claude Code ha rifiutato l'operazione piuttosto che scrivere o leggere l'output attraverso quel percorso. Il messaggio appare nel risultato dello strumento Bash:4190Claude Code salva l'output di ogni comando Bash in un file sotto la sua directory temporanea. Ogni volta che apre uno di questi file, controlla che il percorso conduca ancora al file che ha creato, senza collegamento simbolico, collegamento fisico aggiuntivo, o directory spostata che lo reindirizza. Questo messaggio significa che quel controllo è fallito, quindi Claude Code ha rifiutato l'operazione piuttosto che scrivere o leggere l'output attraverso quel percorso. Il messaggio appare nel risultato dello strumento Bash:

3909 4191

3910```text wrap theme={null}4192```text wrap theme={null}

3911task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.4193task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.

3912```4194```

3913 4195

3914Il testo tra parentesi nomina il controllo che ha fallito. Motivi come `output symlink was re-pointed`, `output file identity changed`, e `not a regular file` segnalano tutti la stessa condizione: qualcosa nel percorso di output o lungo di esso non è più il file che Claude Code ha creato. Solo alcuni motivi portano una frase `To recover:`.4196Il testo tra parentesi nomina il controllo che ha fallito. Ragioni come `output symlink was re-pointed`, `output file identity changed`, e `not a regular file` segnalano tutte la stessa condizione: qualcosa nel percorso dell'output o lungo di esso non è più il file che Claude Code ha creato. Solo alcune ragioni portano una frase `To recover:`.

3915 4197

3916Se il controllo fallisce mentre un comando è ancora in esecuzione, Claude Code arresta il comando e il suo risultato segnala:4198Se il controllo fallisce mentre un comando è ancora in esecuzione, Claude Code interrompe il comando, e il suo risultato segnala:

3917 4199

3918```text theme={null}4200```text theme={null}

3919Command killed: its output file was replaced or could no longer be verified4201Command killed: its output file was replaced or could no longer be verified

3922**Cosa fare:**4204**Cosa fare:**

3923 4205

3924* Aggiornate alla v2.1.260 o successiva. Le versioni precedenti a volte mostravano questo messaggio quando nessun collegamento o directory spostata era presente4206* Aggiornate alla v2.1.260 o successiva. Le versioni precedenti a volte mostravano questo messaggio quando nessun collegamento o directory spostata era presente

3925* Riavviate Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) impostato su una directory fresca4207* Riavviate Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) impostato a una directory fresca

3926* O controllate la directory del vostro progetto sotto la directory temporanea di Claude Code, `/private/tmp/claude-501/-Users-you-my-project` nel messaggio di esempio. Se quel percorso è un collegamento simbolico, o una directory che non dovrebbe essere lì, rimuovete il collegamento o la directory stessa piuttosto che la destinazione del collegamento, e riavviate Claude Code4208* Oppure controllate la directory del vostro progetto sotto la directory temporanea di Claude Code, `/private/tmp/claude-501/-Users-you-my-project` nel messaggio di esempio. Se quel percorso è un collegamento simbolico, o una directory che non dovrebbe essere lì, rimuovete il collegamento o la directory stessa piuttosto che il target del collegamento, e riavviate Claude Code

3927* Se il rifiuto si ripete, un processo sta sostituendo, collegando o rimuovendo voci sotto la directory temporanea di Claude Code mentre la sessione viene eseguita. Impostate [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) su una directory che nient'altro gestisce e riavviate4209* Se il rifiuto si ripete, un processo sta sostituendo, collegando, o rimuovendo voci sotto la directory temporanea di Claude Code mentre la sessione viene eseguita. Impostate [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) a una directory che nulla altro gestisce e riavviate

4210

4211<h3 id="disk-quota-or-temp-filesystem-is-full">

4212 Disk quota or temp filesystem is full

4213</h3>

4214

4215Claude Code salva l'output di ogni comando Bash e PowerShell in un file sotto la sua directory temporanea. Quando un comando esce con un codice diverso da zero e nessun output affatto, Claude Code controlla se il file system che contiene quel file è senza spazio o inode, o se la vostra quota di disco su di esso è esaurita. Se è così, una diagnostica appare nel risultato del comando al posto dell'output vuoto:

4216

4217```text wrap theme={null}

4218Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.

4219```

4220

4221Il messaggio nomina cosa è esaurito:

4222

4223* `Your disk quota is full ... (EDQUOT)`: la vostra quota su quel file system è esaurita. Una quota può essere piena mentre il file system mostra ancora spazio libero

4224* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: il file system, o la vostra quota su di esso, non ha spazio rimasto

4225* `Command output was lost: the temp filesystem at ... is full` o `... is out of inodes`: il file system ha quasi nessuno spazio libero rimasto, o sta esaurendo gli inode

4226

4227**Cosa fare:**

4228

4229* Eliminate i file che non vi servono più sul file system che contiene la directory temporanea di Claude Code. Per `EDQUOT`, eliminate i file che contano verso la vostra quota. Per `out of inodes`, eliminate molti file piuttosto che pochi file grandi, poiché ogni file occupa un inode indipendentemente dalla sua dimensione

4230* Oppure riavviate Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) impostato a una directory su un file system con spazio

4231* Quindi fate eseguire il comando di nuovo a Claude. L'output che ha stampato è stato perso, non troncato

3928 4232

3929<h3 id="the-source-file-is-not-valid-utf-8-text">4233<h3 id="the-source-file-is-not-valid-utf-8-text">

3930 The source file is not valid UTF-8 text4234 The source file is not valid UTF-8 text

3938file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.4242file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.

3939```4243```

3940 4244

3941Claude Code decodifica il file come UTF-8, o come UTF-16 quando inizia con un byte-order mark UTF-16 little-endian. Quando un file UTF-16 di questo tipo non si decodifica, il primo messaggio nomina `UTF-16` e vi dice comunque di riscrivere il file come UTF-8. Quando seguono più posizioni di quella nominata, il messaggio aggiunge un conteggio come `(+2 more)` dopo la posizione.4245Claude Code decodifica il file come UTF-8, o come UTF-16 quando inizia con un byte order mark UTF-16 little-endian. Quando un file UTF-16 di questo tipo non si decodifica, il primo messaggio nomina `UTF-16` e vi dice comunque di riscrivere il file come UTF-8. Quando più posizioni seguono quella nominata, il messaggio aggiunge un conteggio come `(+2 more)` dopo la posizione.

3942 4246

3943**Cosa fare:**4247**Cosa fare:**

3944 4248

3945* Di solito nulla: Claude riscrive il file e pubblica di nuovo4249* Di solito niente: Claude riscrivi il file e pubblica di nuovo

3946* Se il file è uno che avete scritto o esportato, salvatelo di nuovo come UTF-8, e sostituite ogni `U+FFFD` con il carattere che un'edizione, incolla o conversione precedente ha perso4250* Se il file è uno che avete scritto o esportato, salvatelo di nuovo come UTF-8, e sostituite ogni `U+FFFD` con il carattere che un'edizione, incolla, o conversione precedente ha perso

3947* Per mostrare un `U+FFFD` intenzionale sulla pagina, scrivetelo come `�` nell'HTML invece del carattere letterale4251* Per mostrare un `U+FFFD` intenzionale sulla pagina, scrivilo come `�` nell'HTML invece del carattere letterale

3948 4252

3949Prima della v2.1.267, Claude Code caricava un file di questo tipo senza controllarlo, e il server rifiutava la pubblicazione invece.4253Prima della v2.1.267, Claude Code caricava un file di questo tipo senza controllarlo, e il server rifiutava la pubblicazione invece.

3950 4254

3952 Reading a local file from outside the connected folders in a Cowork session4256 Reading a local file from outside the connected folders in a Cowork session

3953</h3>4257</h3>

3954 4258

3955In una sessione [Cowork](https://claude.com/docs/cowork/overview) in esecuzione sulla vostra macchina nell'app Claude Desktop, Claude ha nominato un file locale per un [artifact](/docs/it/artifacts). Claude Code non ha potuto confermare che il file è un file semplice all'interno delle cartelle connesse della sessione: il percorso si trova al di fuori di quelle cartelle, passa attraverso un collegamento simbolico, o è scritto in un modo che può nominare un file diverso da come appare. Leggere un file di questo tipo richiede la vostra approvazione, e in una sessione che non può mostrarvi la scheda di approvazione, come una impostata per saltare tutte le approvazioni, Claude Code rifiuta la lettura.4259In una sessione [Cowork](https://claude.com/docs/cowork/overview) in esecuzione sulla vostra macchina nell'app Claude Desktop, Claude ha nominato un file locale per un [artifact](/docs/it/artifacts). Claude Code non ha potuto confermare che il file è un file semplice all'interno delle cartelle connesse della sessione: il percorso si trova al di fuori di quelle cartelle, passa attraverso un collegamento simbolico, o è scritto in un modo che può nominare un file diverso da come appare. Leggere un file di questo tipo richiede la vostra approvazione, e in una sessione che non può mostrarvi la carta di approvazione, come una impostata per saltare tutte le approvazioni, Claude Code rifiuta la lettura.

3956 4260

3957Il rifiuto appare nel risultato dello strumento Artifact; quando il file non ha potuto essere esaminato affatto, nomina invece quel fallimento:4261Il rifiuto appare nel risultato dello strumento Artifact; quando il file non ha potuto essere esaminato affatto, nomina quel fallimento invece:

3958 4262

3959```text wrap theme={null}4263```text wrap theme={null}

3960Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.4264Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.

3964 4268

3965**Cosa fare:**4269**Cosa fare:**

3966 4270

3967* Di solito nulla: il messaggio dice a Claude di usare un file semplice all'interno delle cartelle connesse invece4271* Di solito niente: il messaggio dice a Claude di usare un file semplice all'interno delle cartelle connesse invece

3968* Per mettere quel file esatto nell'artifact, copiatelo in una delle cartelle connesse della sessione come file regolare, non un symlink, e chiedete di nuovo4272* Per mettere quel file esatto nell'artifact, copiatelo in una delle cartelle connesse della sessione come file regolare, non un collegamento simbolico, e chiedete di nuovo

3969 4273

3970<h3 id="webfetch-cannot-fetch-localhost">4274<h3 id="webfetch-cannot-fetch-localhost">

3971 WebFetch cannot fetch localhost4275 WebFetch cannot fetch localhost

3979 4283

3980**Cosa fare:**4284**Cosa fare:**

3981 4285

3982* Di solito nulla: il messaggio indica a Claude lo strumento `curl` attraverso Bash, che può raggiungere server locali e intranet4286* Di solito niente: il messaggio punta Claude a `curl` attraverso lo strumento Bash, che può raggiungere server locali e intranet

3983 4287

3984Prima della v2.1.268, WebFetch segnalava questi URL con un errore generico `Invalid URL`.4288Prima della v2.1.268, WebFetch segnalava questi URL con un errore generico `Invalid URL`.

3985 4289

4341 La directory di lavoro non esiste più quando si avvia una sessione in background4645 La directory di lavoro non esiste più quando si avvia una sessione in background

4342</h3>4646</h3>

4343 4647

4344Hai provato ad avviare una [sessione in background](/docs/it/agent-view) in una directory che non esiste più. Questo accade quando invii dalla vista agente o esegui `/background` dopo che la directory in cui stavi lavorando è stata eliminata o spostata. Accade anche quando ti colleghi a o riavvii una sessione il cui processo è uscito e la cui directory è scomparsa, perché il nuovo processo si avvierebbe in quella stessa directory. Claude Code non avvia la sessione, e il messaggio nomina la directory mancante:4648Hai provato ad avviare una [sessione in background](/docs/it/agent-view) in una directory che non esiste più. Claude Code non avvia la sessione, e il messaggio nomina la directory mancante:

4345 4649

4346```text theme={null}4650```text theme={null}

4347Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4651Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

4353 4657

4354* Ricrea la directory che il messaggio nomina, o invia da una directory che esiste, quindi riprova4658* Ricrea la directory che il messaggio nomina, o invia da una directory che esiste, quindi riprova

4355 4659

4660<h3 id="workspace-not-trusted-when-dispatching-a-background-session">

4661 Workspace non trusted quando si invia una sessione in background

4662</h3>

4663

4664Hai avviato o riavviato una [sessione in background](/docs/it/agent-view) in una directory che non hai [trusted](/docs/it/permissions#project-allow-rules-and-workspace-trust), e la finestra di dialogo di fiducia dell'area di lavoro non poteva apparire per chiedertelo. Claude Code non avvia la sessione:

4665

4666```text theme={null}

4667Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

4668```

4669

4670Da un terminale nella directory della sessione stessa, lo stesso comando mostra la finestra di dialogo di fiducia invece e avvia la sessione una volta che accetti. Questo messaggio appare dove nessuna finestra di dialogo può, come in uno script, o quando riavvii una sessione da una directory diversa dalla sua.

4671

4672Due varianti nominano una causa diversa:

4673

4674* **`The home directory is trusted one session at a time`**: la directory della sessione è la tua directory home. Claude Code non salva mai la fiducia per la directory home, quindi accettare la finestra di dialogo lì in una sessione precedente non conta.

4675* **`<path> could not be resolved on disk`**: Claude Code non poteva trovare la directory della sessione su disco.

4676

4677**Cosa fare:**

4678

4679* Esegui `claude` nella directory che il messaggio nomina e accetta la finestra di dialogo di fiducia, quindi esegui di nuovo il comando

4680* Per il messaggio della directory home, esegui il comando da un terminale nella tua directory home in modo che la finestra di dialogo possa apparire, o avvia la sessione da una directory di progetto invece

4681* Per il messaggio `could not be resolved on disk`, ricrea la directory, o avvia una nuova sessione da una directory che esiste

4682

4356<h2 id="wrapper-and-ide-errors">4683<h2 id="wrapper-and-ide-errors">

4357 Errori del wrapper e dell'IDE4684 Errori del wrapper e dell'IDE

4358</h2>4685</h2>

4585* Accorciare il frontmatter `description` dei vostri file di agente, o chiedere a Claude di tagliarli per voi.4912* Accorciare il frontmatter `description` dei vostri file di agente, o chiedere a Claude di tagliarli per voi.

4586* Rimuovere i file di agente che non usate più.4913* Rimuovere i file di agente che non usate più.

4587 4914

4915<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">

4916 Una skill, un comando o un workflow non è stato caricato perché il suo nome è riservato

4917</h3>

4918

4919Una cartella skill, un frontmatter `name`, un file o una sottocartella in `.claude/commands/`, o un [workflow salvato](/docs/it/workflows#save-the-workflow-for-reuse) usa il nome `anthropic-skills` o un nome che inizia con `anthropic-skills:`. Claude Code [riserva quel nome per le skills sincronizzate da claude.ai](/docs/it/skills#names-reserved-for-synced-skills) e non carica quell'elemento.

4920

4921Claude Code mostra questo avviso come avviso di avvio nella vista della conversazione piuttosto che su stderr:

4922

4923```text theme={null}

4924Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account

4925```

4926

4927L'avviso nomina cosa cambiare per il primo elemento che ha rifiutato: una cartella o un file da rinominare, una riga `name:` da modificare, o un workflow da rinominare. Quando più di un elemento è stato rifiutato, l'avviso termina con un conteggio come `· 2 more`, e il [log di debug](/docs/it/debug-your-config) nomina ognuno.

4928

4929**Cosa fare:**

4930

4931* Rinominare l'elemento che l'avviso nomina, o modificare la riga `name:` a cui punta, quindi riavviare la sessione.

4932

4933Prima della v2.1.282, Claude Code caricava skills e comandi con questi nomi.

4934

4588<h3 id="workspace-has-not-been-trusted">4935<h3 id="workspace-has-not-been-trusted">

4589 Lo spazio di lavoro non è stato considerato attendibile4936 Lo spazio di lavoro non è stato considerato attendibile

4590</h3>4937</h3>

4631 Le impostazioni gestite da remoto non hanno potuto essere caricate4978 Le impostazioni gestite da remoto non hanno potuto essere caricate

4632</h3>4979</h3>

4633 4980

4634La vostra sessione è idonea per [impostazioni gestite dal server](/docs/it/server-managed-settings), ma Claude Code non ha potuto recuperarle, quindi mostra questo avviso nelle sessioni interattive. La causa tra parentesi nomina cosa è fallito, come `network error`, `request timed out`, o `authentication rejected (401)`, e il resto della riga dice quale politica la sessione esegue:4981La vostra sessione è idonea per [impostazioni gestite dal server](/docs/it/server-managed-settings), ma Claude Code non ha potuto recuperarle o non ha potuto applicare quello che il server ha restituito, quindi mostra questo avviso nelle sessioni interattive.

4982

4983La causa tra parentesi nomina cosa è fallito, come `network error`, `request timed out`, o `authentication rejected (401)`. La causa `no setting in the server response could be applied as written` significa che il server ha risposto ma nessuna delle impostazioni che ha restituito ha superato la [validazione](/docs/it/server-managed-settings#invalid-entries-in-delivered-settings). Prima della v2.1.282, questa causa leggeva `server returned invalid settings`.

4984

4985Il resto della riga dice quale politica la sessione esegue:

4635 4986

4636* **Impostazioni memorizzate nella cache da un recupero precedente riuscito**: Claude Code esegue la sessione su quella politica memorizzata nella cache, ad eccezione delle [variabili di ambiente trattenute](/docs/it/server-managed-settings#fetch-and-caching-behavior), e la riga legge `using cached policy`.4987* **Impostazioni memorizzate nella cache da un recupero precedente riuscito**: Claude Code esegue la sessione su quella politica memorizzata nella cache, ad eccezione delle [variabili di ambiente trattenute](/docs/it/server-managed-settings#fetch-and-caching-behavior), e la riga legge `using cached policy`.

4637* **Nessuna cache**: Claude Code esegue la sessione senza impostazioni gestite dal server, e la riga legge `no remote policy applied`.4988* **Nessuna cache**: Claude Code esegue la sessione senza impostazioni gestite dal server, e la riga legge `no remote policy applied`.

4639**Cosa fare:**4990**Cosa fare:**

4640 4991

4641* Agire sulla causa che il messaggio nomina: per una causa di rete, verificare che questa macchina possa raggiungere `api.anthropic.com`; per una causa di autenticazione, controllare il vostro accesso con `/status`4992* Agire sulla causa che il messaggio nomina: per una causa di rete, verificare che questa macchina possa raggiungere `api.anthropic.com`; per una causa di autenticazione, controllare il vostro accesso con `/status`

4993* Per `no setting in the server response could be applied as written`, chiedere al vostro amministratore di correggere le impostazioni sul server

4642* Eseguire `/status` o `claude doctor` per la diagnostica completa4994* Eseguire `/status` o `claude doctor` per la diagnostica completa

4643 4995

4644Prima della v2.1.248, Claude Code segnalava un recupero di impostazioni fallito solo nel log di debug.4996Prima della v2.1.248, Claude Code segnalava un recupero di impostazioni fallito solo nel log di debug.

4658* Avviare di nuovo Claude Code e approvare la finestra di dialogo per continuare secondo le impostazioni della vostra organizzazione. Una finestra di dialogo rifiutata non viene ricordata, quindi appare di nuovo al prossimo avvio.5010* Avviare di nuovo Claude Code e approvare la finestra di dialogo per continuare secondo le impostazioni della vostra organizzazione. Una finestra di dialogo rifiutata non viene ricordata, quindi appare di nuovo al prossimo avvio.

4659* Se siete incerti su un'impostazione che la finestra di dialogo elenca, chiedete a chi mantiene le impostazioni gestite della vostra organizzazione prima di approvare5011* Se siete incerti su un'impostazione che la finestra di dialogo elenca, chiedete a chi mantiene le impostazioni gestite della vostra organizzazione prima di approvare

4660 5012

5013<h3 id="managed-settings-block-the-default-model">

5014 Le impostazioni gestite bloccano il modello predefinito

5015</h3>

5016

5017La vostra organizzazione [impostazioni gestite](/docs/it/managed-settings) bloccano il modello a cui l'opzione Predefinito si risolve e ogni modello a cui potrebbe scendere. Una sessione che inizierebbe sull'opzione Predefinita esce all'avvio invece di eseguire un modello bloccato. Quale messaggio vedete dipende dall'impostazione che lo blocca. Quando un elenco [`deniedModels`](/docs/it/model-config#block-specific-models-or-versions) lo blocca, il messaggio legge:

5018

5019```text theme={null}

5020Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

5021```

5022

5023Quando un elenco `availableModels` con [`availableModelsMatch`](/docs/it/settings-reference#availablemodelsmatch) impostato a `"exact"` lo omette, il messaggio legge:

5024

5025```text theme={null}

5026Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".

5027```

5028

5029**Cosa fare:**

5030

5031* Se amministrate le impostazioni, aggiungere un modello che i vostri utenti possono eseguire a `availableModels`, o restringere le voci `deniedModels` che bloccano ogni fallback. [Block specific models or versions](/docs/it/model-config#block-specific-models-or-versions) descrive come l'opzione Predefinito scende

5032* Se non le amministrate, inviare il messaggio al vostro amministratore. I vostri file di impostazioni non possono ampliare un elenco `availableModels` o `deniedModels` gestito

5033

4661<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5034<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

4662 Il server MCP è bloccato dalla politica gestita aziendale5035 Il server MCP è bloccato dalla politica gestita aziendale

4663</h3>5036</h3>

4927 5300

4928* Un [`--fallback-model`](/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione5301* Un [`--fallback-model`](/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione

4929* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile5302* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile

4930* Il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) su Fable 5.1, Fable 5, Opus 5.5 e Opus 5 sposta la sessione al modello di fallback della categoria contrassegnata, quando quella categoria ne ha uno, e mostra un avviso nella trascrizione5303* Il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) su Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 e Opus 5 sposta la sessione al modello di fallback della categoria contrassegnata, quando quella categoria ne ha uno, e mostra un avviso nella trascrizione

4931 5304

4932Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio `/model`. La [configurazione del modello](/docs/it/model-config) spiega quando si applica ogni fallback.5305Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio `/model`. La [configurazione del modello](/docs/it/model-config) spiega quando si applica ogni fallback.

4933 5306

feature-availability.md +5 −5

Details

219</table>219</table>

220 220

221<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Su Google Cloud's Agent Platform, la ricerca web è disponibile per i modelli Claude 4 e successivi.<br />221<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Su Google Cloud's Agent Platform, la ricerca web è disponibile per i modelli Claude 4 e successivi.<br />

222<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Su questi provider, auto mode supporta solo Claude Sonnet 5, Opus 4.7 o successivi, e i modelli Fable. Consulta [Configurazione Auto mode](/docs/it/auto-mode-config). La modalità di autorizzazione iniziale integrata su questi provider è Manual. Consulta [quale modalità inizia una sessione](/docs/it/permission-modes#which-mode-a-session-starts-in). Dalla v2.1.158 alla v2.1.206, auto mode su questi provider richiedeva anche l'impostazione di `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 ha rimosso il requisito.<br />222<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Su questi provider, auto mode supporta solo Claude Sonnet 5 o successivi, Opus 4.7 o successivi, e i modelli Fable. Consulta [Configurazione Auto mode](/docs/it/auto-mode-config). Per la modalità di autorizzazione in cui inizia una sessione su questi provider, consulta [Quale modalità inizia una sessione](/docs/it/permission-modes#which-mode-a-session-starts-in). Dalla v2.1.158 alla v2.1.206, auto mode su questi provider richiedeva anche l'impostazione di `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 ha rimosso il requisito.<br />

223<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Soggetto al tuo accordo con il provider cloud.<br />223<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Soggetto al tuo accordo con il provider cloud.<br />

224<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Solo dashboard e API. [Metriche di contribuzione](/docs/it/analytics#enable-contribution-metrics) richiede un'organizzazione Team o Enterprise su claude.ai.<br />224<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Solo dashboard e API. [Metriche di contribuzione](/docs/it/analytics#enable-contribution-metrics) richiede un'organizzazione Team o Enterprise su claude.ai.<br />

225<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Richiede Claude Code v2.1.224 o successivo su macOS e Linux, incluso Linux all'interno di WSL 2. Su Windows nativo, richiede Claude Code v2.1.234 o successivo. Con autenticazione tramite chiave API, la messaggistica è solo sulla stessa macchina. Su Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, la messaggistica è solo sulla stessa macchina e richiede Claude Code v2.1.248 o successivo. Claude può trovare le tue sessioni [Claude Code sul web](/docs/it/claude-code-on-the-web) e le tue sessioni su altre macchine solo da una sessione connessa a [Remote Control](/docs/it/remote-control). Per connetterti, hai bisogno di un accesso claude.ai e degli altri [requisiti di Remote Control](/docs/it/remote-control#requirements). Consulta [Messaggi alle sessioni su altre macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines).225<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Richiede Claude Code v2.1.224 o successivo su macOS e Linux, incluso Linux all'interno di WSL 2. Su Windows nativo, richiede Claude Code v2.1.234 o successivo. Con autenticazione tramite chiave API, la messaggistica è solo sulla stessa macchina. Su Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, la messaggistica è solo sulla stessa macchina e richiede Claude Code v2.1.248 o successivo. Claude può trovare le tue [sessioni Claude Code sul web](/docs/it/claude-code-on-the-web) e le tue sessioni su altre macchine solo da una sessione connessa a [Remote Control](/docs/it/remote-control). Per connetterti, hai bisogno di un accesso claude.ai e degli altri [requisiti di Remote Control](/docs/it/remote-control#requirements). Consulta [Messaggi alle sessioni su altre macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines).

226 226

227<Note>227<Note>

228 Se ti autentichi tramite un [gateway LLM](/docs/it/llm-gateway), la disponibilità delle funzionalità corrisponde al provider sottostante a cui il gateway inoltra, ad eccezione delle funzionalità che Claude Code stesso disattiva. Ogni volta che `ANTHROPIC_BASE_URL` punta a un host diverso da `api.anthropic.com`, Claude Code disattiva funzionalità come [Remote Control](/docs/it/remote-control#requirements) e [server-managed settings](/docs/it/server-managed-settings#platform-availability), indipendentemente da ciò che il gateway inoltra. Alcune funzionalità solo Anthropic come l'[Advisor](/docs/it/advisor) funzionano solo se il gateway inoltra le richieste intatte all'API Anthropic.228 Se ti autentichi tramite un [gateway LLM](/docs/it/llm-gateway), la disponibilità delle funzionalità corrisponde al provider sottostante a cui il gateway inoltra, ad eccezione delle funzionalità che Claude Code stesso disattiva. Ogni volta che `ANTHROPIC_BASE_URL` punta a un host diverso da `api.anthropic.com`, Claude Code disattiva funzionalità come [Remote Control](/docs/it/remote-control#requirements) e [server-managed settings](/docs/it/server-managed-settings#platform-availability), indipendentemente da ciò che il gateway inoltra. Alcune funzionalità solo Anthropic come l'[Advisor](/docs/it/advisor) funzionano solo se il gateway inoltra le richieste intatte all'API Anthropic.

243 **Supporto parziale:**243 **Supporto parziale:**

244 244

245 * [Desktop](/docs/it/desktop): solo tramite [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)245 * [Desktop](/docs/it/desktop): solo tramite [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

246 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5, Opus 4.7 o successivi, e modelli Fable soltanto246 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5 o successivi, Opus 4.7 o successivi, e modelli Fable soltanto

247 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>247 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>

248 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo AWS248 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo AWS

249 249

269 269

270 * [Desktop](/docs/it/desktop): tramite [impostazioni gestite](https://claude.com/docs/third-party/claude-desktop/configuration) o [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)270 * [Desktop](/docs/it/desktop): tramite [impostazioni gestite](https://claude.com/docs/third-party/claude-desktop/configuration) o [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

271 * [Web search](/docs/it/tools-reference#websearch-tool-behavior): modelli Claude 4 e successivi271 * [Web search](/docs/it/tools-reference#websearch-tool-behavior): modelli Claude 4 e successivi

272 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5, Opus 4.7 o successivi, e modelli Fable soltanto272 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5 o successivi, Opus 4.7 o successivi, e modelli Fable soltanto

273 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>273 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>

274 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo Google Cloud274 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo Google Cloud

275 275

283 283

284 * [Desktop](/docs/it/desktop): solo tramite [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)284 * [Desktop](/docs/it/desktop): solo tramite [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

285 * [Web search](/docs/it/tools-reference#websearch-tool-behavior): [distribuzioni ospitate su Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) soltanto285 * [Web search](/docs/it/tools-reference#websearch-tool-behavior): [distribuzioni ospitate su Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) soltanto

286 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5, Opus 4.7 o successivi, e modelli Fable soltanto286 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5 o successivi, Opus 4.7 o successivi, e modelli Fable soltanto

287 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>287 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>

288 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo Azure288 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo Azure

289 289

fullscreen.md +3 −1

Details

104* **Fare clic su un'opzione in un menu di selezione multipla** per attivarla/disattivarla, e fare clic sul pulsante di invio per confermare le scelte. Fare clic su una riga di testo libero, come la riga `Other` in una domanda a scelta multipla, mette a fuoco il suo campo di input in modo da poter digitare una risposta. Richiede Claude Code v2.1.208 o successivo.104* **Fare clic su un'opzione in un menu di selezione multipla** per attivarla/disattivarla, e fare clic sul pulsante di invio per confermare le scelte. Fare clic su una riga di testo libero, come la riga `Other` in una domanda a scelta multipla, mette a fuoco il suo campo di input in modo da poter digitare una risposta. Richiede Claude Code v2.1.208 o successivo.

105* **Fare clic sul valore di un'impostazione nel pannello `/config`** per modificarlo, e scorrere l'elenco delle impostazioni con la rotella del mouse. Richiede Claude Code v2.1.271 o successivo.105* **Fare clic sul valore di un'impostazione nel pannello `/config`** per modificarlo, e scorrere l'elenco delle impostazioni con la rotella del mouse. Richiede Claude Code v2.1.271 o successivo.

106* **Scorrere un menu di selezione o selezione multipla con la rotella del mouse** quando ha più opzioni di quante ne mostri contemporaneamente, come l'elenco `/model` in una finestra del terminale breve. La rotella scorre l'elenco mentre il puntatore si trova sopra le sue opzioni. Richiede Claude Code v2.1.280 o successivo.106* **Scorrere un menu di selezione o selezione multipla con la rotella del mouse** quando ha più opzioni di quante ne mostri contemporaneamente, come l'elenco `/model` in una finestra del terminale breve. La rotella scorre l'elenco mentre il puntatore si trova sopra le sue opzioni. Richiede Claude Code v2.1.280 o successivo.

107* **Scorrere un elenco in overflow con la sua barra di scorrimento.** In pannelli di elenco come `/skills`, `/mcp` e l'elenco Installed di `/plugin`, una barra di scorrimento appare accanto a un elenco con più righe di quante ne stiano mentre il puntatore si trova sopra di esso. Fare clic sulla traccia per saltare a quel punto, o trascinare il pollice. Richiede Claude Code v2.1.281 o successivo.

107* **Fare clic su un risultato dello strumento compresso** per espanderlo e vedere l'output completo. Fare clic di nuovo per comprimerlo. La chiamata dello strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.108* **Fare clic su un risultato dello strumento compresso** per espanderlo e vedere l'output completo. Fare clic di nuovo per comprimerlo. La chiamata dello strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.

108 * Fare clic espande anche l'output di un comando shell `!`, sia un risultato troncato più vecchio che la riga di progresso in tempo reale mentre il comando è in esecuzione. Richiede Claude Code v2.1.257 o successivo.109 * Fare clic espande anche l'output di un comando shell `!`, sia un risultato troncato più vecchio che la riga di progresso in tempo reale mentre il comando è in esecuzione. Richiede Claude Code v2.1.257 o successivo.

110 * Fare clic espande anche una riga `Message from @<sender>` attenuata quando il mittente è un [collega di squadra](/docs/it/agent-teams) o un altro agente in esecuzione nella vostra sessione. La riga per un messaggio da [una delle vostre altre sessioni](/docs/it/cross-session-messaging#what-a-message-looks-like) mostra anche la prima riga del messaggio e non è cliccabile, quindi premete `Ctrl+o` per leggere quella.

109* **Tenere premuto `Cmd` su macOS, o `Ctrl` su Linux e Windows, e fare clic su un URL o un percorso di file** per aprirlo. Gli URL semplici `http://` e `https://` si aprono nel browser, e i percorsi di file nell'output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell'applicazione predefinita. Un semplice clic senza il modificatore non apre i link, corrispondendo al comportamento nativo del terminale.111* **Tenere premuto `Cmd` su macOS, o `Ctrl` su Linux e Windows, e fare clic su un URL o un percorso di file** per aprirlo. Gli URL semplici `http://` e `https://` si aprono nel browser, e i percorsi di file nell'output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell'applicazione predefinita. Un semplice clic senza il modificatore non apre i link, corrispondendo al comportamento nativo del terminale.

110 * Claude Code esegue il rendering di un percorso di rete (UNC), come `\\server\share\file.ts`, come testo semplice senza link, perché aprire un percorso di rete può inviare le credenziali di Windows all'host che nomina.112 * Claude Code esegue il rendering di un percorso di rete (UNC), come `\\server\share\file.ts`, come testo semplice senza link, perché aprire un percorso di rete può inviare le credenziali di Windows all'host che nomina.

111 * Alcuni terminali macOS inoltrano `Cmd`+clic all'app in esecuzione invece di aprire il link da soli, e il protocollo del mouse del terminale non ha modo di codificare il tasto `Cmd`, quindi Claude Code riceve un semplice clic. In Ghostty, e in Warp su macOS, Claude Code lo rileva e consente a un semplice clic su un link di aprirlo, e tenere premuto `Cmd` funziona ancora.113 * Alcuni terminali macOS inoltrano `Cmd`+clic all'app in esecuzione invece di aprire il link da soli, e il protocollo del mouse del terminale non ha modo di codificare il tasto `Cmd`, quindi Claude Code riceve un semplice clic. In Ghostty, e in Warp su macOS, Claude Code lo rileva e consente a un semplice clic su un link di aprirlo, e tenere premuto `Cmd` funziona ancora.

290CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude292CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude

291```293```

292 294

293Con la cattura del mouse disabilitata, lo scorrimento da tastiera con `PgUp`, `PgDn`, `Ctrl+Home` e `Ctrl+End` funziona ancora, e il vostro terminale gestisce la selezione in modo nativo. Perdete il click-per-posizionare-il-cursore, il click-per-espandere-l'output-dello-strumento, il click-su-URL e lo scorrimento con la rotella all'interno di Claude Code.295Con la cattura del mouse disabilitata, lo scorrimento da tastiera con `PgUp`, `PgDn`, `Ctrl+Home` e `Ctrl+End` funziona ancora, e il vostro terminale gestisce la selezione in modo nativo. Perdete il click-per-posizionare-il-cursore, il click-per-espandere, il click-su-URL e lo scorrimento con la rotella all'interno di Claude Code.

294 296

295Per mantenere lo scorrimento con la rotella ma disattivare la gestione di click, trascinamento e hover, impostate invece `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1`. Richiede Claude Code v2.1.195 o successivo. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambe le variabili sono impostate.297Per mantenere lo scorrimento con la rotella ma disattivare la gestione di click, trascinamento e hover, impostate invece `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1`. Richiede Claude Code v2.1.195 o successivo. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambe le variabili sono impostate.

296 298

github-enterprise-server.md +1 −1

Details

252 L'avvio della sessione fallisce con `Unable to get organization UUID`252 L'avvio della sessione fallisce con `Unable to get organization UUID`

253</h3>253</h3>

254 254

255Le sessioni cloud richiedono un'organizzazione Team o Enterprise. Accedi con `/login` utilizzando il tuo account dell'organizzazione. Se ti autentichi con una chiave API, le sessioni cloud falliscono prima con un messaggio che ti chiede di eseguire `/login`.255Accedi con `/login` utilizzando il tuo account dell'organizzazione. Se ti autentichi con una chiave API, le sessioni cloud falliscono prima con un messaggio che ti chiede di eseguire `/login`.

256 256

257<h2 id="related-resources">257<h2 id="related-resources">

258 Risorse correlate258 Risorse correlate

glossary.md +28 −1

Details

72 Auto mode72 Auto mode

73</h3>73</h3>

74 74

75Una [permission mode](#permission-mode) in cui un modello classificatore separato esamina le azioni invece di te, così Claude Code esegue la maggior parte di esse senza chiederti. Claude Code ti chiede comunque prima delle azioni che corrispondono alle tue regole di richiesta esplicita. Su Pro, Max e Team, auto mode è la [permission mode di avvio integrata](/docs/it/permission-modes#which-mode-a-session-starts-in) per le sessioni di terminale interattivo e VS Code. Il classificatore blocca l'escalation dell'ambito, l'infrastruttura non attendibile e l'[prompt injection](#prompt-injection). I risultati degli strumenti vengono rimossi da ciò che vede, quindi il contenuto ostile in un file o una pagina web non può manipolarlo direttamente.75Una [permission mode](#permission-mode) in cui un modello classificatore separato esamina le azioni invece di te, così Claude Code esegue la maggior parte di esse senza chiederti. Claude Code ti chiede comunque prima delle azioni che corrispondono alle tue regole di richiesta esplicita. Con Claude Code v2.1.283 o successivo, auto mode è la [permission mode di avvio integrata](/docs/it/permission-modes#which-mode-a-session-starts-in) per le sessioni di terminale interattivo e VS Code, e nelle versioni precedenti solo su piani Pro, Max e Team. Il classificatore blocca l'escalation dell'ambito, l'infrastruttura non attendibile e l'[prompt injection](#prompt-injection). I risultati degli strumenti vengono rimossi da ciò che vede, quindi il contenuto ostile in un file o una pagina web non può manipolarlo direttamente.

76 76

77Scopri di più: [Eliminate prompts with auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode)77Scopri di più: [Eliminate prompts with auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode)

78 78

428 428

429Scopri di più: [Platforms and integrations](/docs/it/platforms)429Scopri di più: [Platforms and integrations](/docs/it/platforms)

430 430

431<h3 id="system-prompt">

432 System prompt

433</h3>

434

435Le istruzioni che Claude Code invia prima della tua conversazione ad ogni richiesta, coprendo come Claude utilizza gli strumenti, si comporta in modo sicuro e formatta le sue risposte. Puoi aggiungere al system prompt con `--append-system-prompt` o sostituirlo con `--system-prompt`. Il system prompt è il primo livello della [prompt cache](/docs/it/prompt-caching#how-the-cache-is-organized).

436

437I tuoi file [CLAUDE.md](#claude-md) e le istruzioni del tuo [output style](#output-style) non fanno parte del system prompt. Claude Code li fornisce nella conversazione come [system reminder](#system-reminder).

438

439Scopri di più: [System prompt flags](/docs/it/cli-reference#system-prompt-flags)

440

441<h3 id="system-reminder">

442 System reminder

443</h3>

444

445Un messaggio che Claude Code, come [harness](#agentic-harness), aggiunge alla conversazione per dare a Claude il contesto. Non invii tu stesso i system reminder. Claude Code li inserisce mentre una sessione viene eseguita, ad esempio quando la sessione inizia, quando un hook restituisce testo, o quando un file cambia su disco. Claude li legge insieme ai tuoi messaggi. I seguenti raggiungono tutti Claude come system reminder:

446

447* I tuoi file [CLAUDE.md](#claude-md)

448* Le istruzioni del tuo [output style](#output-style)

449* Testo che un [hook](#hook) restituisce come `additionalContext`

450* L'elenco delle [skills](#skill) disponibili

451* Una nota che un file che Claude ha letto in precedenza è cambiato su disco

452* Le righe di attribuzione del commit e della pull request

453

454In una richiesta API registrata, un system reminder appare racchiuso in tag `<system-reminder>` all'interno di un messaggio utente, o su alcuni modelli come un messaggio separato con il ruolo `system`.

455

456Scopri di più: [Context Claude Code adds outside the system prompt](/docs/it/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)

457

431<h2 id="t">458<h2 id="t">

432 T459 T

433</h2>460</h2>

goal.md +1 −1

Details

155 155

156Se un turno fallisce con un errore che non si cancellerà finché non lo correggi, Claude Code cancella l'obiettivo e stampa un avviso che nomina la causa. L'avviso inizia con `Goal cleared after an unrecoverable error` e termina con `Run /goal again to continue`. Correggi la causa, quindi [imposta di nuovo l'obiettivo](#set-a-goal) con `/goal <condition>`. Quattro tipi di errore cancellano l'obiettivo:156Se un turno fallisce con un errore che non si cancellerà finché non lo correggi, Claude Code cancella l'obiettivo e stampa un avviso che nomina la causa. L'avviso inizia con `Goal cleared after an unrecoverable error` e termina con `Run /goal again to continue`. Correggi la causa, quindi [imposta di nuovo l'obiettivo](#set-a-goal) con `/goal <condition>`. Quattro tipi di errore cancellano l'obiettivo:

157 157

158* Un errore di autenticazione, quando Claude Code gestisce le proprie credenziali. Quando un host le gestisce per te, come l'app desktop, l'estensione VS Code o una [sessione cloud](/docs/it/claude-code-on-the-web), Claude Code lascia l'obiettivo attivo perché l'host ripristina l'accesso da solo.158* Un errore di autenticazione, quando Claude Code gestisce le proprie credenziali. Quando un host le gestisce per te, come l'app desktop o una [sessione cloud](/docs/it/claude-code-on-the-web), Claude Code lascia l'obiettivo attivo perché l'host ripristina l'accesso da solo.

159* Un saldo di credito esaurito159* Un saldo di credito esaurito

160* Un overflow di contesto che [auto-compact](/docs/it/model-config#set-the-auto-compact-window) non poteva cancellare160* Un overflow di contesto che [auto-compact](/docs/it/model-config#set-the-auto-compact-window) non poteva cancellare

161* Un modello che non è disponibile161* Un modello che non è disponibile

headless.md +10 −2

Details

89* **Esecuzione di un comando**: Claude Code registra il comando come terminato nella sessione.89* **Esecuzione di un comando**: Claude Code registra il comando come terminato nella sessione.

90* **In attesa di una risposta a un prompt di autorizzazione**: se invii SIGTERM al processo, Claude Code lascia il prompt senza risposta. Se il tuo programma chiude la sessione tramite l'Agent SDK, l'SDK termina l'input di Claude Code prima di inviare qualsiasi segnale, e Claude Code annulla il prompt non appena l'input termina.90* **In attesa di una risposta a un prompt di autorizzazione**: se invii SIGTERM al processo, Claude Code lascia il prompt senza risposta. Se il tuo programma chiude la sessione tramite l'Agent SDK, l'SDK termina l'input di Claude Code prima di inviare qualsiasi segnale, e Claude Code annulla il prompt non appena l'input termina.

91 91

~~92Quando [riprendi la sessione](#continue-conversations), Claude Code continua il turno che SIGTERM ha lasciato non completato.~~92Quando [riprendi la sessione](#continue-conversations), Claude Code lascia il turno interrotto così com'è, e il tuo prossimo prompt guida la conversazione. Per fare in modo che Claude Code continui il turno interrotto al ripristino, imposta [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN=1`](/docs/it/env-vars).

94<h3 id="if-the-working-directory-is-deleted">

95 Se la directory di lavoro viene eliminata

96</h3>

98Se la directory di lavoro di una sessione `claude -p` o Agent SDK viene eliminata durante la sessione, la sessione continua a funzionare. Quando un turno inizia mentre la directory è mancante, Claude Code emette un [messaggio di avviso](/docs/it/agent-sdk/typescript#sdkinformationalmessage) nell'output `stream-json`, e i comandi shell falliscono fino a quando la directory non esiste di nuovo.

93 99

94<h2 id="examples">100<h2 id="examples">

95 Esempi101 Esempi

256| - | - | - |262| - | - | - |

258| `plugin_errors` | array | errori di caricamento del plugin, ognuno con `plugin`, `type` e `message`. Include versioni di dipendenza non soddisfatte e errori di caricamento di `--plugin-dir` come un percorso mancante o un archivio non valido. I plugin interessati vengono declassati e assenti da `plugins`. La chiave viene omessa quando non ci sono errori |264| `plugin_errors` | array | errori di caricamento del plugin, ognuno con `plugin`, `type` e `message`. Include versioni di dipendenza non soddisfatte e errori di caricamento di `--plugin-dir` come un percorso mancante o un archivio non valido. Un plugin che non è stato caricato è assente da `plugins`. La chiave viene omessa quando non ci sono errori |

265

266Quando una directory `--plugin-dir` o un archivio stesso non riesce a caricarsi, la sua voce `plugin_errors` include il percorso assoluto risolto come `path`. Usalo per dire quale dei vari valori `--plugin-dir` ha fallito. Il campo `path` richiede Claude Code v2.1.283 o successivo.

259 267

260Utilizza i campi del server MCP allo stesso modo. Quando passi [`--mcp-config`](/docs/it/cli-reference#cli-flags) con `-p`, Claude Code attende i server ancora in sospeso prima di eseguire il primo turno, fino al timeout di avvio [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita. Un server remoto con un [elenco di strumenti memorizzato nella cache](/docs/it/agent-sdk/mcp#connection-timing) salta l'attesa, mostra `pending` in `system/init` e si connette alla sua prima chiamata dello strumento. L'attesa richiede Claude Code v2.1.221 o successivo.268Utilizza i campi del server MCP allo stesso modo. Quando passi [`--mcp-config`](/docs/it/cli-reference#cli-flags) con `-p`, Claude Code attende i server ancora in sospeso prima di eseguire il primo turno, fino al timeout di avvio [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita. Un server remoto con un [elenco di strumenti memorizzato nella cache](/docs/it/agent-sdk/mcp#connection-timing) salta l'attesa, mostra `pending` in `system/init` e si connette alla sua prima chiamata dello strumento. L'attesa richiede Claude Code v2.1.221 o successivo.

261 269

hooks.md +30 −40

Details

421 421

422* **[Command hooks](#command-hook-fields)** (`type: "command"`): esegui un comando shell. Il tuo script riceve l'[input JSON](#hook-input-and-output) dell'evento su stdin e comunica i risultati indietro attraverso codici di uscita e stdout.422* **[Command hooks](#command-hook-fields)** (`type: "command"`): esegui un comando shell. Il tuo script riceve l'[input JSON](#hook-input-and-output) dell'evento su stdin e comunica i risultati indietro attraverso codici di uscita e stdout.

423* **[HTTP hooks](#http-hook-fields)** (`type: "http"`): invia l'input JSON dell'evento come richiesta HTTP POST a un URL. L'endpoint comunica i risultati indietro attraverso il corpo della risposta utilizzando lo stesso [formato di output JSON](#json-output) degli hook di comando.423* **[HTTP hooks](#http-hook-fields)** (`type: "http"`): invia l'input JSON dell'evento come richiesta HTTP POST a un URL. L'endpoint comunica i risultati indietro attraverso il corpo della risposta utilizzando lo stesso [formato di output JSON](#json-output) degli hook di comando.

424* **[MCP tool hooks](#mcp-tool-hook-fields)** (`type: "mcp_tool"`): chiama un tool su un server [MCP](/docs/it/mcp) già connesso. L'output di testo del tool viene trattato come stdout di hook di comando.424* **[MCP tool hooks](#mcp-tool-hook-fields)** (`type: "mcp_tool"`): chiama un tool su un server [MCP](/docs/it/mcp) configurato. L'output di testo del tool viene trattato come stdout di hook di comando.

425* **[Prompt hooks](#prompt-and-agent-hook-fields)** (`type: "prompt"`): invia un prompt a un modello Claude per la valutazione a turno singolo. Il modello restituisce la sua decisione come JSON. Vedi [Prompt-based hooks](#prompt-based-hooks).425* **[Prompt hooks](#prompt-and-agent-hook-fields)** (`type: "prompt"`): invia un prompt a un modello Claude per la valutazione a turno singolo. Il modello restituisce la sua decisione come JSON. Vedi [Prompt-based hooks](#prompt-based-hooks).

426* **[Agent hooks](#prompt-and-agent-hook-fields)** (`type: "agent"`): genera un subagent che può utilizzare tool come Read, Grep, e Glob per verificare le condizioni prima di restituire una decisione. Gli agent hook sono sperimentali e potrebbero cambiare. Vedi [Agent-based hooks](#agent-based-hooks).426* **[Agent hooks](#prompt-and-agent-hook-fields)** (`type: "agent"`): genera un subagent che può utilizzare tool come Read, Grep, e Glob per verificare le condizioni prima di restituire una decisione. Gli agent hook sono sperimentali e potrebbero cambiare. Vedi [Agent-based hooks](#agent-based-hooks).

427 427

474| `command` | sì | Comando shell da eseguire. Con `args`, l'eseguibile da generare direttamente. Vedi [Exec form e shell form](#exec-form-and-shell-form) |474| `command` | sì | Comando shell da eseguire. Con `args`, l'eseguibile da generare direttamente. Vedi [Exec form e shell form](#exec-form-and-shell-form) |

475| `args` | no | Lista di argomenti. Quando presente, `command` viene risolto come un eseguibile e generato direttamente con `args` come vettore di argomenti, senza shell coinvolto. Vedi [Exec form e shell form](#exec-form-and-shell-form) |475| `args` | no | Lista di argomenti. Quando presente, `command` viene risolto come un eseguibile e generato direttamente con `args` come vettore di argomenti, senza shell coinvolto. Vedi [Exec form e shell form](#exec-form-and-shell-form) |

476| `async` | no | Se `true`, viene eseguito in background senza bloccare. Vedi [Run hooks in the background](#run-hooks-in-the-background) |476| `async` | no | Se `true`, viene eseguito in background senza bloccare. Vedi [Run hooks in the background](#run-hooks-in-the-background) |

477| `asyncRewake` | no | Se `true`, viene eseguito in background e riattiva Claude al codice di uscita 2. Lo stderr dell'hook, o stdout se stderr è vuoto, viene mostrato a Claude come un promemoria di sistema in modo che possa reagire a un fallimento di background di lunga durata |477| `asyncRewake` | no | Se `true`, viene eseguito in background e riattiva Claude al codice di uscita 2. Lo stderr dell'hook, o stdout se stderr è vuoto, viene mostrato a Claude come un [promemoria di sistema](/docs/it/glossary#system-reminder) in modo che possa reagire a un fallimento di background di lunga durata |

478| `shell` | no | Shell da utilizzare per questo hook. Accetta `"bash"` o `"powershell"`. Impostazione predefinita `"bash"`, o `"powershell"` su Windows quando Git Bash non è installato. L'impostazione di `"powershell"` esegue il comando tramite PowerShell su Windows. Non richiede `CLAUDE_CODE_USE_POWERSHELL_TOOL` poiché gli hook generano PowerShell direttamente. Ignorato quando `args` è impostato |478| `shell` | no | Shell da utilizzare per questo hook. Accetta `"bash"` o `"powershell"`. Impostazione predefinita `"bash"`, o `"powershell"` su Windows quando Git Bash non è installato. L'impostazione di `"powershell"` esegue il comando tramite PowerShell su Windows. Non richiede `CLAUDE_CODE_USE_POWERSHELL_TOOL` poiché gli hook generano PowerShell direttamente. Ignorato quando `args` è impostato |

479 479

480<a id="exec-form-and-shell-form" />480<a id="exec-form-and-shell-form" />

571 571

573| :- | :- | :- |573| :- | :- | :- |

574| `server` | sì | Nome di un server MCP configurato. Per un [server fornito da plugin](/docs/it/mcp#plugin-provided-mcp-servers), questo è il nome con scope `plugin:<plugin-name>:<server-name>`, come `plugin:my-plugin:db`, non la chiave del server nudo. Il server deve essere già connesso; l'hook non attiva mai un flusso OAuth o di connessione |574| `server` | sì | Nome di un server MCP configurato. Per un [server fornito da plugin](/docs/it/mcp#plugin-provided-mcp-servers), questo è il nome con scope `plugin:<plugin-name>:<server-name>`, come `plugin:my-plugin:db`, non la chiave del server nudo |

575| `tool` | sì | Nome del tool da chiamare su quel server |575| `tool` | sì | Nome del tool da chiamare su quel server |

576| `input` | no | Argomenti passati al tool. I valori stringa supportano la sostituzione `${path}` dall'[input JSON](#hook-input-and-output) dell'hook, come `"${tool_input.file_path}"` |576| `input` | no | Argomenti passati al tool. I valori stringa supportano la sostituzione `${path}` dall'[input JSON](#hook-input-and-output) dell'hook, come `"${tool_input.file_path}"` |

577 577

578Claude Code legge il contenuto di testo del tool allo stesso modo in cui legge stdout di hook di comando, seguendo la [regola di analisi sotto il codice di uscita 0](#exit-code-0). Se il server denominato non è connesso, o il tool restituisce `isError: true`, l'hook produce un errore non bloccante e l'esecuzione continua.

~~579~~

580Questo esempio chiama il tool `security_scan` sul server MCP `my_server` dopo ogni `Write` o `Edit`, passando il percorso del file modificato:578Questo esempio chiama il tool `security_scan` sul server MCP `my_server` dopo ogni `Write` o `Edit`, passando il percorso del file modificato:

581 579

582```json theme={null}580```json theme={null}

599}597}

600```598```

601 599

602Un hook `mcp_tool` può essere eseguito solo dopo che Claude Code ha reso i server MCP della sessione disponibili agli hook. `SessionStart` e `Setup` possono attivarsi prima di quel punto:600<h5 id="how-the-tool’s-result-is-read">

601 Come viene letto il risultato del tool

602</h5>

603 603

604* **Al lancio**: `SessionStart` si attiva prima che i server siano disponibili, incluso quando avvii con `--continue` o `--resume`. Claude Code salta gli hook `mcp_tool` dell'evento senza chiamare i loro tool, e il [debug log](#debug-hooks) registra `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)`.604Claude Code legge il contenuto di testo del tool allo stesso modo in cui legge stdout di hook di comando, seguendo la [regola di analisi sotto il codice di uscita 0](#exit-code-0). Se il tool restituisce `isError: true`, l'hook produce un errore non bloccante e l'esecuzione continua.

605* **Più tardi in una sessione in esecuzione**: dopo `/clear` o una compattazione, `SessionStart` si attiva di nuovo con i server già disponibili, e i suoi hook `mcp_tool` vengono eseguiti.

606* **Su `Setup`**: `Setup` si attiva sempre prima che i server siano disponibili, quindi Claude Code salta i suoi hook `mcp_tool` ogni volta e registra lo stesso messaggio che nomina `Setup`.

607 605

608Ad esempio, questa configurazione chiama il tool `load_context` sul server MCP `my_server` da un hook `SessionStart` senza matcher, quindi si applica a ogni fonte `SessionStart`:606<h5 id="when-the-server-is-still-connecting">

607 Quando il server è ancora in connessione

608</h5>

609 609

610```json theme={null}610Su eventi dove un hook può bloccare o cambiare il risultato, come `PreToolUse` o `Stop`, Claude Code attende un server in connessione prima di chiamare il tool, per al massimo [`MCP_TIMEOUT`](/docs/it/env-vars) e entro il [`timeout`](#common-fields) dell'hook stesso. Su eventi osservazionali, come `Notification` o `SessionEnd`, non attende.

611{611

612 "hooks": {612Un server che mostra lo stato [`cached`](/docs/it/mcp#server-status-detail) si connette quando l'hook chiama il suo tool. Se il server non è connesso a quel punto, l'hook produce un errore non bloccante e l'esecuzione continua. L'hook non avvia mai un flusso OAuth, quindi [autentica il server da `/mcp`](/docs/it/mcp#authenticate-with-remote-mcp-servers) prima.

613 "SessionStart": [613

614 {614<h5 id="events-that-fire-before-mcp-servers-are-available">

615 "hooks": [615 Eventi che si attivano prima che i server MCP siano disponibili

616 {616</h5>

617 "type": "mcp_tool",

618 "server": "my_server",

619 "tool": "load_context"

620 }

621 ]

622 }

623 ]

624 }

625}

626```

627 617

628Quando esegui `claude`, Claude Code salta questo hook, non chiama mai `load_context`, e scrive il messaggio `no MCP client context` nel debug log. Esegui `/clear` in quella stessa sessione e l'hook viene eseguito e chiama `load_context`. Un hook `type: "command"` su `SessionStart` viene eseguito al lancio, quindi usane uno per qualsiasi cosa la sessione abbia bisogno dal suo primo turno.618`SessionStart` al lancio, incluso con `--continue` o `--resume`, e ogni evento `Setup` si attivano prima che i server MCP della sessione siano disponibili agli hook. Claude Code salta i loro hook `mcp_tool` senza chiamare il tool, e il [debug log](#debug-hooks) registra `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)`, o lo stesso messaggio che nomina `Setup`. Quando `SessionStart` si attiva di nuovo più tardi nella sessione, dopo `/clear` o una compattazione, i suoi hook `mcp_tool` vengono eseguiti. Per qualsiasi cosa la sessione abbia bisogno al lancio, utilizza un hook `type: "command"` su `SessionStart` invece.

629 619

630<h4 id="prompt-and-agent-hook-fields">620<h4 id="prompt-and-agent-hook-fields">

631 Campi prompt e agent hook621 Campi prompt e agent hook

637| :- | :- | :- |627| :- | :- | :- |

638| `prompt` | sì | Testo del prompt da inviare al modello. Utilizza `$ARGUMENTS` come placeholder per l'input JSON dell'hook. Sfuggi con una barra rovesciata per includere testo letterale: `\$1.00` viene renderizzato come `$1.00` |628| `prompt` | sì | Testo del prompt da inviare al modello. Utilizza `$ARGUMENTS` come placeholder per l'input JSON dell'hook. Sfuggi con una barra rovesciata per includere testo letterale: `\$1.00` viene renderizzato come `$1.00` |

639| `model` | no | Modello da utilizzare per la valutazione. Impostazione predefinita a un modello veloce |629| `model` | no | Modello da utilizzare per la valutazione. Impostazione predefinita al modello che Claude Code utilizza per la [funzionalità di background](/docs/it/costs#background-token-usage) |

640 630

641<h3 id="reference-scripts-by-path">631<h3 id="reference-scripts-by-path">

642 Riferisci gli script per percorso632 Riferisci gli script per percorso

791| `prompt_id` | UUID che identifica il prompt dell'utente attualmente in elaborazione. Corrisponde all'attributo [`prompt.id` sugli eventi OpenTelemetry](/docs/it/monitoring-usage#event-correlation-attributes), quindi è possibile correlare l'output del hook con la telemetria per un singolo prompt. Assente fino al primo input dell'utente. Richiede Claude Code v2.1.196 o successivo |781| `prompt_id` | UUID che identifica il prompt dell'utente attualmente in elaborazione. Corrisponde all'attributo [`prompt.id` sugli eventi OpenTelemetry](/docs/it/monitoring-usage#event-correlation-attributes), quindi è possibile correlare l'output del hook con la telemetria per un singolo prompt. Assente fino al primo input dell'utente. Richiede Claude Code v2.1.196 o successivo |

792| `transcript_path` | Percorso al JSON della conversazione. Il file della trascrizione viene scritto in modo asincrono e potrebbe rimanere indietro rispetto alla conversazione in memoria, quindi potrebbe non includere ancora i messaggi più recenti del turno corrente quando un hook si attiva. Gli hook che necessitano del testo dell'assistente finale del turno corrente dovrebbero utilizzare `last_assistant_message` su [Stop](#stop) e [SubagentStop](#subagentstop) invece di leggere la trascrizione |782| `transcript_path` | Percorso al JSON della conversazione. Il file della trascrizione viene scritto in modo asincrono e potrebbe rimanere indietro rispetto alla conversazione in memoria, quindi potrebbe non includere ancora i messaggi più recenti del turno corrente quando un hook si attiva. Gli hook che necessitano del testo dell'assistente finale del turno corrente dovrebbero utilizzare `last_assistant_message` su [Stop](#stop) e [SubagentStop](#subagentstop) invece di leggere la trascrizione |

793| `cwd` | Directory di lavoro corrente quando l'hook viene invocato |783| `cwd` | Directory di lavoro corrente quando l'hook viene invocato |

794| `scratchpad_dir` | Percorso alla directory scratchpad della sessione, dove Claude mantiene i file di lavoro temporanei. Assente quando la sessione non ha uno scratchpad o la directory temporanea non è disponibile. Richiede Claude Code v2.1.257 o successivo |784| `scratchpad_dir` | Percorso alla [directory scratchpad della sessione](/docs/it/claude-directory#session-scratchpad-directory), dove Claude mantiene i file di lavoro temporanei. Assente quando la sessione non ha uno scratchpad o la directory temporanea non è disponibile. Richiede Claude Code v2.1.257 o successivo |

795| `permission_mode` | [Modalità di autorizzazione](/docs/it/permissions#permission-modes) corrente: `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` o `"bypassPermissions"`. La modalità etichettata **Manual** arriva come `"default"`, mai come `"manual"`, quindi gli script che corrispondono a `"default"` continuano a funzionare. Non tutti gli eventi ricevono questo campo. Controllare l'esempio JSON in ogni sezione [hook event](#hook-events) |785| `permission_mode` | [Modalità di autorizzazione](/docs/it/permissions#permission-modes) corrente: `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` o `"bypassPermissions"`. La modalità etichettata **Manual** arriva come `"default"`, mai come `"manual"`, quindi gli script che corrispondono a `"default"` continuano a funzionare. Non tutti gli eventi ricevono questo campo. Controllare l'esempio JSON in ogni sezione [hook event](#hook-events) |

796| `effort` | Oggetto con un campo `level` che contiene il [livello di effort](/docs/it/model-config#adjust-effort-level) in vigore quando l'hook viene eseguito: `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"`. Se si imposta un livello che il modello attivo non supporta, `level` segnala il livello che Claude Code ha effettivamente eseguito; [Adjust effort level](/docs/it/model-config#adjust-effort-level) dice come lo sceglie. Ultracode non è un livello distinto e viene segnalato come `"xhigh"`. L'oggetto corrisponde al campo `effort` della [riga di stato](/docs/it/statusline#available-data). Presente per gli eventi che si attivano all'interno di un contesto di utilizzo dello strumento, come `PreToolUse`, `PostToolUse`, `Stop` e `SubagentStop`, quando il modello corrente supporta il parametro effort. Il livello è disponibile anche ai comandi hook e allo strumento Bash come variabile di ambiente `$CLAUDE_EFFORT`. |786| `effort` | Oggetto con un campo `level` che contiene il [livello di effort](/docs/it/model-config#adjust-effort-level) in vigore quando l'hook viene eseguito: `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"`. Se si imposta un livello che il modello attivo non supporta, `level` segnala il livello che Claude Code ha effettivamente eseguito; [Adjust effort level](/docs/it/model-config#adjust-effort-level) dice come lo sceglie. L'oggetto corrisponde al campo `effort` della [riga di stato](/docs/it/statusline#available-data). Presente per gli eventi che si attivano all'interno di un contesto di utilizzo dello strumento, come `PreToolUse`, `PostToolUse`, `Stop` e `SubagentStop`, quando il modello corrente supporta il parametro effort. Il livello è disponibile anche ai comandi hook e allo strumento Bash come variabile di ambiente `$CLAUDE_EFFORT`. |

798 788

799Quando si esegue con `--agent` o all'interno di un subagent, vengono inclusi due campi aggiuntivi:789Quando si esegue con `--agent` o all'interno di un subagent, vengono inclusi due campi aggiuntivi:

1057 Aggiungere contesto per Claude1047 Aggiungere contesto per Claude

1058</h4>1048</h4>

1059 1049

1060Il campo `additionalContext` passa una stringa dal tuo hook nel contesto della finestra di Claude. Claude Code avvolge la stringa in un promemoria di sistema e la inserisce nella conversazione nel punto in cui l'hook si è attivato. Claude legge il promemoria nella prossima richiesta del modello, ma non appare come messaggio di chat nell'interfaccia.1050Il campo `additionalContext` passa una stringa dal tuo hook nel contesto della finestra di Claude. Claude Code avvolge la stringa in un [promemoria di sistema](/docs/it/glossary#system-reminder) e la inserisce nella conversazione nel punto in cui l'hook si è attivato. Claude legge il promemoria nella prossima richiesta del modello, ma non appare come messaggio di chat nell'interfaccia.

1061 1051

1062Restituire `additionalContext` all'interno di `hookSpecificOutput` insieme al nome dell'evento:1052Restituire `additionalContext` all'interno di `hookSpecificOutput` insieme al nome dell'evento:

1063 1053

1938| Field | Description |1928| Field | Description |

1939| :- | :- |1929| :- | :- |

1940| `permissionDecision` | `"allow"` salta il prompt di permesso, tranne per le [azioni che nessuna modalità auto-approva](/docs/it/permission-modes#actions-no-mode-auto-approves) e per `AskUserQuestion` e `ExitPlanMode`, che hanno bisogno di [`updatedInput` accoppiato con esso](#allow-with-updatedinput). `"deny"` impedisce la chiamata dello strumento. `"ask"` chiede all'utente di confermare. `"defer"` esce correttamente in modo che lo strumento possa essere ripreso più tardi. Le [regole di negazione e richiesta](/docs/it/permissions#manage-permissions) vengono comunque valutate indipendentemente da ciò che l'hook restituisce |1930| `permissionDecision` | `"allow"` salta il prompt di permesso, tranne per le [azioni che nessuna modalità auto-approva](/docs/it/permission-modes#actions-no-mode-auto-approves) e per `AskUserQuestion` e `ExitPlanMode`, che hanno bisogno di [`updatedInput` accoppiato con esso](#allow-with-updatedinput). `"deny"` impedisce la chiamata dello strumento. `"ask"` chiede all'utente di confermare. `"defer"` esce correttamente in modo che lo strumento possa essere ripreso più tardi. Le [regole di negazione e richiesta](/docs/it/permissions#manage-permissions) vengono comunque valutate indipendentemente da ciò che l'hook restituisce |

1941| `permissionDecisionReason` | Per `"allow"` e `"ask"`, mostrato all'utente ma non a Claude. Per `"deny"`, mostrato a Claude. Per `"defer"`, ignorato |1931| `permissionDecisionReason` | Per `"deny"`, mostrato a Claude. Per `"ask"`, mostrato all'utente ma non a Claude. Per `"allow"` e `"defer"`, scritto nel [debug log](#debug-hooks) solo |

1942| `updatedInput` | Modifica i parametri di input dello strumento prima dell'esecuzione. Sostituisce l'intero oggetto di input, quindi includi i campi invariati insieme a quelli modificati. Claude Code valuta le regole di permesso e l'idoneità di [auto-background](/docs/it/tools-reference#background-commands) di un comando Bash rispetto all'input che il tuo hook restituisce, non l'input che Claude ha inviato. Combina con `"allow"` per auto-approvare, o `"ask"` per mostrare l'input modificato all'utente. Per `"defer"`, ignorato |1932| `updatedInput` | Modifica i parametri di input dello strumento prima dell'esecuzione. Sostituisce l'intero oggetto di input, quindi includi i campi invariati insieme a quelli modificati. Claude Code valuta le regole di permesso e l'idoneità di [auto-background](/docs/it/tools-reference#background-commands) di un comando Bash rispetto all'input che il tuo hook restituisce, non l'input che Claude ha inviato. Combina con `"allow"` per auto-approvare, o `"ask"` per mostrare l'input modificato all'utente. Per `"defer"`, ignorato |

1943| `additionalContext` | Stringa aggiunta al contesto di Claude insieme al risultato dello strumento. Ignorato quando `permissionDecision` è `"defer"`. Vedi [Add context for Claude](#add-context-for-claude) |1933| `additionalContext` | Stringa aggiunta al contesto di Claude insieme al risultato dello strumento. Ignorato quando `permissionDecision` è `"defer"`. Vedi [Add context for Claude](#add-context-for-claude) |

1944 1934

2011Se lo strumento rinviato non è più disponibile quando riprendi, il processo esce con `stop_reason: "tool_deferred_unavailable"` e `is_error: true` prima che l'hook si attivi. Questo accade quando un server MCP che ha fornito lo strumento non è connesso per la sessione ripresa. Il payload `deferred_tool_use` è comunque incluso in modo che tu possa identificare quale strumento è scomparso.2001Se lo strumento rinviato non è più disponibile quando riprendi, il processo esce con `stop_reason: "tool_deferred_unavailable"` e `is_error: true` prima che l'hook si attivi. Questo accade quando un server MCP che ha fornito lo strumento non è connesso per la sessione ripresa. Il payload `deferred_tool_use` è comunque incluso in modo che tu possa identificare quale strumento è scomparso.

2012 2002

2013<Note>2003<Note>

2014 Per riprendere una sessione rinviata in plan mode, passa [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) insieme a `--resume` in modo che Claude Code possa presentare il piano per l'approvazione. Senza di esso, Claude Code non ripristina la plan mode. Richiede Claude Code v2.1.246 o successivo.2004 Per riprendere una sessione rinviata in plan mode, passa [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) insieme a `--resume` in modo che Claude Code possa presentare il piano per l'approvazione. Se non passi certe altre flag di lancio, l'esecuzione ripresa non ritorna alla plan mode; vedi [Resume in plan mode with `-p`](/docs/it/sessions#resume-in-plan-mode-with-p). Richiede Claude Code v2.1.246 o successivo.

2015 2005

2016 Quando riprendi con `-p`, Claude Code non ripristina nessun altro modo di permesso archiviato. Avvia l'esecuzione nel modo di permesso che una nuova esecuzione `claude -p` avvierebbe, quindi passa `--permission-mode` o `--dangerously-skip-permissions` di nuovo se la sessione rinviata ne ha usato uno. Quando riprendi con `claude --resume <session-id>` senza `-p`, Claude Code ripristina il modo di permesso archiviato, con le eccezioni elencate in [permission mode on resume](/docs/it/sessions#permission-mode-on-resume).2006 Quando riprendi con `-p`, Claude Code non ripristina nessun altro modo di permesso archiviato. Avvia l'esecuzione nel modo di permesso che una nuova esecuzione `claude -p` avvierebbe, quindi passa `--permission-mode` o `--dangerously-skip-permissions` di nuovo se la sessione rinviata ne ha usato uno. Quando riprendi con `claude --resume <session-id>` senza `-p`, Claude Code ripristina il modo di permesso archiviato, con le eccezioni elencate in [permission mode on resume](/docs/it/sessions#permission-mode-on-resume).

2017</Note>2007</Note>

2331 "tool_name": "Read",2321 "tool_name": "Read",

2332 "tool_input": {"file_path": "/.../ledger/accounts.py"},2322 "tool_input": {"file_path": "/.../ledger/accounts.py"},

2333 "tool_use_id": "toolu_01...",2323 "tool_use_id": "toolu_01...",

2334 "tool_response": " 1\tfrom __future__ import annotations\n 2\t..."2324 "tool_response": "1\tfrom __future__ import annotations\n2\t..."

2335 },2325 },

2336 {2326 {

2337 "tool_name": "Read",2327 "tool_name": "Read",

2338 "tool_input": {"file_path": "/.../ledger/transactions.py"},2328 "tool_input": {"file_path": "/.../ledger/transactions.py"},

2339 "tool_use_id": "toolu_02...",2329 "tool_use_id": "toolu_02...",

2340 "tool_response": " 1\tfrom __future__ import annotations\n 2\t..."2330 "tool_response": "1\tfrom __future__ import annotations\n2\t..."

2341 }2331 }

2342 ]2332 ]

2343}2333}

2739 Stop input2729 Stop input

2740</h4>2730</h4>

2741 2731

2742Oltre ai [common input fields](#common-input-fields), gli hook Stop ricevono `stop_hook_active`, `last_assistant_message`, `background_tasks`, e `session_crons`. Il campo `stop_hook_active` è `true` quando Claude Code sta già continuando come risultato di un hook stop. Controlla questo valore o elabora la trascrizione per evitare di bloccarsi su una condizione che non si risolverà mai. Claude Code sovrascrive l'hook e termina il turno dopo 8 blocchi consecutivi.2732Oltre ai [common input fields](#common-input-fields), gli hook Stop ricevono `stop_hook_active`, `last_assistant_message`, `background_tasks`, e `session_crons`. Il campo `stop_hook_active` è `true` quando Claude Code sta già continuando come risultato di un hook stop. Controlla questo valore o elabora la trascrizione per evitare di bloccarsi su una condizione che non si risolverà mai. Claude Code sovrascrive l'hook e termina il turno dopo 8 blocchi consecutivi. Per aumentare il limite, imposta [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/it/env-vars).

2743 2733

2744Il campo `last_assistant_message` contiene il contenuto di testo della risposta finale di Claude, quindi gli hook possono accedervi senza analizzare il file della trascrizione. Per gli hook che agiscono sul turno appena completato, come gli hook di lettura ad alta voce o notifica, usa questo campo piuttosto che leggere `transcript_path`: il file della trascrizione non è garantito che includa il messaggio finale al momento di Stop su tutte le versioni.2734Il campo `last_assistant_message` contiene il contenuto di testo della risposta finale di Claude, quindi gli hook possono accedervi senza analizzare il file della trascrizione. Per gli hook che agiscono sul turno appena completato, come gli hook di lettura ad alta voce o notifica, usa questo campo piuttosto che leggere `transcript_path`: il file della trascrizione non è garantito che includa il messaggio finale al momento di Stop su tutte le versioni.

2745 2735

2765| :- | :- |2755| :- | :- |

2766| `id` | Identificatore del compito cron |2756| `id` | Identificatore del compito cron |

2768| `recurring` | `false` per i risvegli una tantum il cui programma codifica un sing olo tempo di attivazione, `true` per i compiti che si riattivano su ogni corrispondenza |2758| `recurring` | `false` per i risvegli una tantum il cui programma codifica un singolo tempo di attivazione, `true` per i compiti che si riattivano su ogni corrispondenza |

2770 2760

2771Questo esempio mostra un input Stop con un compito shell in volo e un cron ricorrente:2761Questo esempio mostra un input Stop con un compito shell in volo e un cron ricorrente:

3801 3791

3802Invece di eseguire un comando Bash, gli hook basati su prompt:3792Invece di eseguire un comando Bash, gli hook basati su prompt:

3803 3793

38041. Inviano l'input del hook e il prompt a un modello Claude, Haiku per impostazione predefinita37941. Inviano l'input del hook e il prompt a un modello Claude, per impostazione predefinita quello che Claude Code utilizza per la [funzionalità in background](/docs/it/costs#background-token-usage)

38052. L'LLM risponde con JSON strutturato contenente una decisione37952. L'LLM risponde con JSON strutturato contenente una decisione

38063. Claude Code elabora automaticamente la decisione37963. Claude Code elabora automaticamente la decisione

3807 3797

3834| :- | :- | :- |3824| :- | :- | :- |

3835| `type` | sì | Deve essere `"prompt"` |3825| `type` | sì | Deve essere `"prompt"` |

3836| `prompt` | sì | Il testo del prompt da inviare all'LLM. Utilizzare `$ARGUMENTS` come segnaposto per l'input JSON del hook. Se `$ARGUMENTS` non è presente, l'input JSON viene aggiunto al prompt |3826| `prompt` | sì | Il testo del prompt da inviare all'LLM. Utilizzare `$ARGUMENTS` come segnaposto per l'input JSON del hook. Se `$ARGUMENTS` non è presente, l'input JSON viene aggiunto al prompt |

3837| `model` | no | Modello da utilizzare per la valutazione. Impostazione predefinita: un modello veloce |3827| `model` | no | Modello da utilizzare per la valutazione. Impostazione predefinita: il modello che Claude Code utilizza per la [funzionalità in background](/docs/it/costs#background-token-usage) |

3838| `timeout` | no | Timeout in secondi. Impostazione predefinita: 30 |3828| `timeout` | no | Timeout in secondi. Impostazione predefinita: 30 |

3839| `continueOnBlock` | no | Sugli eventi a cui si applica, `true` reinvia un motivo `ok: false` a Claude e continua invece di terminare il turno. Impostazione predefinita: `false`. Vedere [Schema di risposta](#response-schema) per il comportamento per evento |3829| `continueOnBlock` | no | Sugli eventi a cui si applica, `true` reinvia un motivo `ok: false` a Claude e continua invece di terminare il turno. Impostazione predefinita: `false`. Vedere [Schema di risposta](#response-schema) per il comportamento per evento |

3840 3830

hooks-guide.md +3 −3

Details

538Ogni hook ha un `type` che determina come si esegue. La maggior parte degli hooks utilizza `"type": "command"`, che esegue un comando shell. Sono disponibili altri quattro tipi:538Ogni hook ha un `type` che determina come si esegue. La maggior parte degli hooks utilizza `"type": "command"`, che esegue un comando shell. Sono disponibili altri quattro tipi:

539 539

540* `"type": "http"`: POST dei dati dell'evento a un URL. Consultate [HTTP hooks](#http-hooks).540* `"type": "http"`: POST dei dati dell'evento a un URL. Consultate [HTTP hooks](#http-hooks).

541* `"type": "mcp_tool"`: chiama uno strumento su un server MCP già connesso. Consultate [MCP tool hooks](/docs/it/hooks#mcp-tool-hook-fields).541* `"type": "mcp_tool"`: chiama uno strumento su un server MCP già configurato. Consultate [MCP tool hooks](/docs/it/hooks#mcp-tool-hook-fields).

542* `"type": "prompt"`: valutazione LLM a turno singolo. Consultate [Prompt-based hooks](#prompt-based-hooks).542* `"type": "prompt"`: valutazione LLM a turno singolo. Consultate [Prompt-based hooks](#prompt-based-hooks).

543* `"type": "agent"`: verifica multi-turno con accesso agli strumenti. Gli agent hooks sono sperimentali e potrebbero cambiare. Consultate [Agent-based hooks](#agent-based-hooks).543* `"type": "agent"`: verifica multi-turno con accesso agli strumenti. Gli agent hooks sono sperimentali e potrebbero cambiare. Consultate [Agent-based hooks](#agent-based-hooks).

544 544

880 Hooks basati su prompt880 Hooks basati su prompt

881</h2>881</h2>

882 882

883Per decisioni che richiedono giudizio piuttosto che regole deterministiche, utilizzate gli hook `type: "prompt"`. Invece di eseguire un comando shell, Claude Code invia il vostro prompt e i dati di input dell'hook a un modello Claude (Haiku per impostazione predefinita) per prendere la decisione. Potete specificare un modello diverso con il campo `model` se avete bisogno di più capacità.883Per decisioni che richiedono giudizio piuttosto che regole deterministiche, utilizzate gli hook `type: "prompt"`. Invece di eseguire un comando shell, Claude Code invia il vostro prompt e i dati di input dell'hook a un modello Claude per prendere la decisione. Potete specificare un modello diverso con il campo `model` se avete bisogno di più capacità.

884 884

885L'unico lavoro del modello è restituire la sua decisione come JSON:885L'unico lavoro del modello è restituire la sua decisione come JSON:

886 886

995 995

996Tenete presenti questi vincoli quando progettate gli hook:996Tenete presenti questi vincoli quando progettate gli hook:

997 997

998* Gli hook di comando comunicano solo attraverso stdout, stderr e codici di uscita. Non possono attivare comandi `/` o chiamate di strumenti. Il testo restituito tramite `additionalContext` viene iniettato come un promemoria di sistema che Claude legge come testo semplice. Gli HTTP hooks comunicano attraverso il corpo della risposta invece.998* Gli hook di comando comunicano solo attraverso stdout, stderr e codici di uscita. Non possono attivare comandi `/` o chiamate di strumenti. Il testo restituito tramite `additionalContext` viene iniettato come un [promemoria di sistema](/docs/it/glossary#system-reminder) che Claude legge come testo semplice. Gli HTTP hooks comunicano attraverso il corpo della risposta invece.

999* I timeout dell'hook variano in base al tipo. Sovrascrivete per hook con il campo `timeout` in secondi.999* I timeout dell'hook variano in base al tipo. Sovrascrivete per hook con il campo `timeout` in secondi.

1000 * `command`, `http`, `mcp_tool`: 10 minuti. Claude Code riduce questo valore predefinito a 30 secondi per gli hook `UserPromptSubmit`, `PreModelSwitch` e `PostModelSwitch`, e a 10 secondi per `MessageDisplay`.1000 * `command`, `http`, `mcp_tool`: 10 minuti. Claude Code riduce questo valore predefinito a 30 secondi per gli hook `UserPromptSubmit`, `PreModelSwitch` e `PostModelSwitch`, e a 10 secondi per `MessageDisplay`.

1001 * `prompt`: 30 secondi.1001 * `prompt`: 30 secondi.

how-claude-code-works.md +15 −2

Details

144 144

145Per una procedura interattiva di quello che si carica e quando, consulta [Esplora la finestra di contesto](/docs/it/context-window).145Per una procedura interattiva di quello che si carica e quando, consulta [Esplora la finestra di contesto](/docs/it/context-window).

146 146

147<h4 id="context-claude-code-adds-on-its-own">

148 Contesto che Claude Code aggiunge da solo

149</h4>

150

151Se Claude segue una regola che non hai scritto, come aggiungere un trailer `Co-Authored-By` a un commit, la regola potrebbe provenire da un [system reminder](/docs/it/glossary#system-reminder). Man mano che lavori, Claude Code aggiunge il suo contesto alla conversazione insieme ai tuoi messaggi:

152

153* I tuoi file CLAUDE.md

154* Le istruzioni del tuo [output style](/docs/it/output-styles)

155* Una nota quando un file che Claude ha letto in precedenza cambia su disco

156* Le righe di attribuzione del commit e della pull request

157

158Per modificare o rimuovere le righe di attribuzione, imposta [`attribution`](/docs/it/settings-reference#attribution). Per rimuovere le istruzioni integrate di Claude Code per commit e pull request, imposta [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) su `false`. Per gli altri switch, consulta [Disattiva il contesto che il tuo agente sostituisce](/docs/it/agent-sdk/modifying-system-prompts#turn-off-the-context-your-agent-replaces).

159

147<h4 id="when-context-fills-up">160<h4 id="when-context-fills-up">

148 Quando il contesto si riempie161 Quando il contesto si riempie

149</h4>162</h4>

188 201

189Scegli una modalità di permesso per impostare cosa Claude può fare senza chiedere. Premi `Shift+Tab` per scorrere le modalità di permesso:202Scegli una modalità di permesso per impostare cosa Claude può fare senza chiedere. Premi `Shift+Tab` per scorrere le modalità di permesso:

190 203

191* **Auto**: un classificatore esamina la maggior parte delle azioni in background e blocca quelle rischiose invece di chiedere. Nei piani Pro, Max e Team, è la [modalità di permesso iniziale integrata](/docs/it/permission-modes#which-mode-a-session-starts-in) per le sessioni interattive di terminale e VS Code204* **Auto**: un classificatore esamina la maggior parte delle azioni in background e blocca quelle rischiose invece di chiedere. Con Claude Code v2.1.283 o successivo, è la [modalità di permesso iniziale integrata](/docs/it/permission-modes#which-mode-a-session-starts-in) per le sessioni interattive di terminale e VS Code, e nelle versioni precedenti solo nei piani Pro, Max e Team

192* **Manual**: Claude chiede prima delle modifiche ai file e dei comandi shell205* **Manual**: Claude chiede prima delle modifiche ai file e dei comandi shell

193* **Accept edits**: Claude modifica i file ed esegue comandi comuni del file system come `mkdir` e `mv` senza chiedere, chiede ancora per altri comandi206* **Accept edits**: Claude modifica i file ed esegue comandi comuni del file system come `mkdir` e `mv` senza chiedere, chiede ancora per altri comandi

194* **Plan**: Claude esplora e propone un piano senza modificare i tuoi file sorgente207* **Plan**: Claude esplora e propone un piano senza modificare i tuoi file sorgente

241Puoi reindirizzare Claude in qualsiasi momento senza ricominciare da capo. Fai una di queste cose:254Puoi reindirizzare Claude in qualsiasi momento senza ricominciare da capo. Fai una di queste cose:

242 255

243* **Premi `Esc`** per fermare Claude immediatamente. La chiamata dello strumento in esecuzione viene annullata e Claude attende la tua prossima istruzione. Se hai messaggi in coda, Claude Code [li invia successivamente](/docs/it/interactive-mode#queue-messages-while-claude-works).256* **Premi `Esc`** per fermare Claude immediatamente. La chiamata dello strumento in esecuzione viene annullata e Claude attende la tua prossima istruzione. Se hai messaggi in coda, Claude Code [li invia successivamente](/docs/it/interactive-mode#queue-messages-while-claude-works).

244* **Digita una correzione e premi `Invio`** senza fermare Claude. Il messaggio viene visualizzato come in coda sopra la casella di input. Se Claude sta eseguendo chiamate di strumenti, legge il messaggio non appena quelle chiamate si completano, nello stesso turno, e si adatta prima del suo prossimo passo. [Accoda messaggi mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works) copre quando altre voci in coda vengono inviate.257* **Digita una correzione e premi `Invio`** senza fermare Claude. Il messaggio viene visualizzato come in coda nella conversazione. Se Claude sta eseguendo chiamate di strumenti, legge il messaggio non appena quelle chiamate si completano, nello stesso turno, e si adatta prima del suo prossimo passo. [Accoda messaggi mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works) copre quando altre voci in coda vengono inviate.

245 258

246<h3 id="delegate-don’t-dictate">259<h3 id="delegate-don’t-dictate">

247 Delega, non dettare260 Delega, non dettare

interactive-mode.md +13 −5

Details

34| `Ctrl+T` | Attiva/disattiva la lista di controllo delle attività di Claude | Mostra o nascondi la [lista di controllo delle attività di Claude](#task-list) nell'area di stato. Questo non è il visualizzatore delle attività in background; usa [`/tasks`](/docs/it/commands) per vedere le shell e i subagent in esecuzione |34| `Ctrl+T` | Attiva/disattiva la lista di controllo delle attività di Claude | Mostra o nascondi la [lista di controllo delle attività di Claude](#task-list) nell'area di stato. Questo non è il visualizzatore delle attività in background; usa [`/tasks`](/docs/it/commands) per vedere le shell e i subagent in esecuzione |

35| `Ctrl+S` | Nascondi o ripristina il prompt | Con testo nell'input, lo nasconde e cancella il prompt. Premuto di nuovo su un prompt vuoto, ripristina il testo nascosto, la posizione del cursore, il contenuto incollato e la modalità di input, quindi un `!` nascosto [comando shell](#shell-mode-with-prefix) ritorna in modalità shell |35| `Ctrl+S` | Nascondi o ripristina il prompt | Con testo nell'input, lo nasconde e cancella il prompt. Premuto di nuovo su un prompt vuoto, ripristina il testo nascosto, la posizione del cursore, il contenuto incollato e la modalità di input, quindi un `!` nascosto [comando shell](#shell-mode-with-prefix) ritorna in modalità shell |

~~37| `Frecce sinistra/destra` | Cicla attraverso le schede della finestra di dialogo | Naviga tra le schede nelle finestre di dialogo dei permessi e nei menu |~~37| `Frecce sinistra/destra` | Cicla attraverso le schede della finestra di dialogo | Naviga tra le schede nelle finestre di dialogo dei permessi e nei menu. In una finestra di dialogo con schede, i tasti cambiano le schede mentre la riga delle schede ha il focus. Vedi [Azioni delle schede](/docs/it/keybindings#tabs-actions) per come si muove il focus |

38| `Tab` | Accetta un suggerimento di completamento automatico, o aggiungi un commento a una risposta di permesso | Mentre i suggerimenti di completamento automatico vengono visualizzati nell'input del prompt, accetta il suggerimento selezionato. Sulla maggior parte dei prompt di permesso, con **Sì** o **No** focalizzato, apre un campo di commento su quell'opzione e premendolo di nuovo chiude il campo. Vedi [aggiungi un commento quando rispondi a un prompt di permesso](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) |38| `Tab` | Accetta un suggerimento di completamento automatico, o aggiungi un commento a una risposta di permesso | Mentre i suggerimenti di completamento automatico vengono visualizzati nell'input del prompt, accetta il suggerimento selezionato. Sulla maggior parte dei prompt di permesso, con **Sì** o **No** focalizzato, apre un campo di commento su quell'opzione e premendolo di nuovo chiude il campo. Vedi [aggiungi un commento quando rispondi a un prompt di permesso](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

39| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Su` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |39| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Su` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |

40| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) |40| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Mentre un elemento del footer è selezionato, come una riga nel [pannello subagent](/docs/it/sub-agents#run-subagents-in-foreground-or-background) sotto il prompt, `Esc` [lo deseleziona](/docs/it/keybindings#footer-actions) invece di interrompere. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

41| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Su` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](/docs/it/checkpointing) per ripristinare o riassumere il codice e la conversazione da un punto precedente |41| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Su` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](/docs/it/checkpointing) per ripristinare o riassumere il codice e la conversazione da un punto precedente |

42| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Invia i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, subito. [Quando Claude Code invia quello che hai messo in coda](#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |42| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Invia i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, subito. [Quando Claude Code invia quello che hai messo in coda](#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |

43| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](/docs/it/permission-modes). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |43| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](/docs/it/permission-modes). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |

45| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il pensiero esteso | Abilita o disabilita la modalità di pensiero esteso. Non ha effetto su Opus 5.5 o i modelli Fable, che utilizzano sempre il pensiero esteso. Funziona su macOS senza configurare Option come Meta |45| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il pensiero esteso | Abilita o disabilita la modalità di pensiero esteso. Non ha effetto su Opus 5.5, Sonnet 5.5, o i modelli Fable, che utilizzano sempre il pensiero esteso. Funziona su macOS senza configurare Option come Meta |

47 47

48<h3 id="text-editing">48<h3 id="text-editing">

235| Comando | Azione |235| Comando | Azione |

236| :- | :- |236| :- | :- |

237| `x` | Elimina carattere |237| `x` | Elimina carattere |

238| `r{char}` | Sostituisci il carattere sotto il cursore con `{char}` |

238| `dd` | Elimina riga |239| `dd` | Elimina riga |

239| `D` | Elimina fino alla fine della riga |240| `D` | Elimina fino alla fine della riga |

241| `df{char}`/`dt{char}` | Elimina fino a e incluso, o fino a, la prossima occorrenza di un carattere |242| `df{char}`/`dt{char}` | Elimina fino a e incluso, o fino a, la prossima occorrenza di un carattere |

243| `dj`/`dk` | Elimina la riga corrente e la riga sotto o sopra |

244| `dgg`/`dG` | Elimina dalla riga corrente alla prima o all'ultima riga |

245| `d0`/`c0`/`y0` | Elimina, cambia o copia dal cursore all'inizio della riga. Richiede Claude Code v2.1.281 o successivo |

242| `cc` | Cambia riga |246| `cc` | Cambia riga |

243| `C` | Cambia fino alla fine della riga |247| `C` | Cambia fino alla fine della riga |

342* Chiedere a Claude Code di eseguire un comando in background346* Chiedere a Claude Code di eseguire un comando in background

343* Premere `Ctrl+B` per spostare una normale invocazione dello strumento Bash in background. Gli utenti di Tmux devono premere `Ctrl+B` due volte a causa della chiave di prefisso di tmux.347* Premere `Ctrl+B` per spostare una normale invocazione dello strumento Bash in background. Gli utenti di Tmux devono premere `Ctrl+B` due volte a causa della chiave di prefisso di tmux.

344 348

349Quando un comando raggiunge il timeout prima di terminare, Claude Code lo sposta automaticamente [in background](/docs/it/tools-reference#background-commands) invece di fermarlo, a meno che il comando non inizi con `sleep`. Per modificare il tempo di esecuzione dei comandi prima che ciò accada, impostare le [variabili di ambiente del timeout di Bash](/docs/it/tools-reference#timeout-and-output-limits).

350

345**Caratteristiche principali:**351**Caratteristiche principali:**

346 352

347* L'output viene scritto in un file e Claude può recuperarlo utilizzando lo strumento Read353* L'output viene scritto in un file e Claude può recuperarlo utilizzando lo strumento Read

349* Le attività in background vengono pulite automaticamente quando Claude Code esce. Su macOS e Linux, quando interrompete un'attività in background da [`/tasks`](/docs/it/commands) o Claude Code la interrompe all'uscita, i processi che si sono staccati dalla shell dell'attività, come quelli avviati con `setsid` o `timeout`, si fermano anche loro355* Le attività in background vengono pulite automaticamente quando Claude Code esce. Su macOS e Linux, quando interrompete un'attività in background da [`/tasks`](/docs/it/commands) o Claude Code la interrompe all'uscita, i processi che si sono staccati dalla shell dell'attività, come quelli avviati con `setsid` o `timeout`, si fermano anche loro

350* Se mettete in background la sessione invece di uscire, le vostre attività in background continuano a essere eseguite nella sessione in background. Vedere [mettere in background una sessione in esecuzione](/docs/it/agent-view#from-inside-a-session)356* Se mettete in background la sessione invece di uscire, le vostre attività in background continuano a essere eseguite nella sessione in background. Vedere [mettere in background una sessione in esecuzione](/docs/it/agent-view#from-inside-a-session)

351* Le attività in background vengono terminate automaticamente se l'output supera 5GB, con una nota in stderr che spiega il motivo357* Le attività in background vengono terminate automaticamente se l'output supera 5GB, con una nota in stderr che spiega il motivo

352* Su macOS e Linux, Claude Code termina le attività in background in esecuzione quando il sistema operativo segnala pressione della memoria, a condizione che la sessione sia stata inattiva per almeno 30 minuti e nessun turno o subagent sia in esecuzione. Richiede Claude Code v2.1.193 o successivo358* Su macOS e Linux, Claude Code termina le attività in background in esecuzione quando il sistema operativo segnala pressione della memoria critica, a condizione che la sessione sia stata inattiva per almeno 30 minuti e nessun turno o subagent sia in esecuzione. Richiede Claude Code v2.1.193 o successivo

353 * Il [log di debug](/docs/it/debug-your-config) spiega perché le attività sono state interrotte, o perché un evento di pressione le ha lasciate in esecuzione359 * Il [log di debug](/docs/it/debug-your-config) spiega perché le attività sono state interrotte, o perché un evento di pressione le ha lasciate in esecuzione

354 * Impostare [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/it/env-vars) a `1` per disattivare gli arresti dovuti alla pressione della memoria360 * Impostare [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/it/env-vars) a `1` per disattivare gli arresti dovuti alla pressione della memoria

355* I comandi in background di proprietà di un [subagent](/docs/it/sub-agents) non hanno limite di tempo, tranne che un comando di proprietà di un subagent in esecuzione in foreground termina quando quel subagent fornisce la sua risposta finale; vedere [Comandi in background](/docs/it/tools-reference#background-commands) nel riferimento degli strumenti. Prima della v2.1.218, né il reap della pressione della memoria né il precedente limite di 60 minuti sui comandi del subagent coprivano i comandi spostati in background con `Ctrl+B`361* I comandi in background di proprietà di un [subagent](/docs/it/sub-agents) non hanno limite di tempo, tranne che un comando di proprietà di un subagent in esecuzione in foreground termina quando quel subagent fornisce la sua risposta finale; vedere [Comandi in background](/docs/it/tools-reference#background-commands) nel riferimento degli strumenti. Prima della v2.1.218, né il reap della pressione della memoria né il precedente limite di 60 minuti sui comandi del subagent coprivano i comandi spostati in background con `Ctrl+B`

395 Accodare messaggi mentre Claude lavora401 Accodare messaggi mentre Claude lavora

396</h2>402</h2>

397 403

398Digitate un messaggio e premete `Enter` mentre Claude sta lavorando. Claude Code accoda il messaggio invece di interrompere il turno, e elenca le voci in coda sopra la casella di input finché non le invia. Potete accodare i comandi `!` [shell](#shell-mode-with-prefix) e la maggior parte dei [comandi](/docs/it/commands) allo stesso modo, ad eccezione dei comandi, come `/status`, che Claude Code esegue non appena li inviate.404Digitate un messaggio e premete `Enter` mentre Claude sta lavorando. Claude Code accoda il messaggio invece di interrompere il turno, e elenca le voci in coda nella conversazione finché non le invia. Potete accodare i comandi `!` [shell](#shell-mode-with-prefix) e la maggior parte dei [comandi](/docs/it/commands) allo stesso modo, ad eccezione dei comandi, come `/status`, che Claude Code esegue non appena li inviate.

399 405

400I messaggi inviati e accodati vengono visualizzati in grigio finché Claude non inizia a rispondere, quindi potete capire quali messaggi Claude non ha ancora iniziato.406I messaggi inviati e accodati vengono visualizzati in grigio finché Claude non inizia a rispondere, quindi potete capire quali messaggi Claude non ha ancora iniziato.

401 407

408Se accodate un messaggio con una selezione allegata da un [IDE connesso](/docs/it/vs-code#the-built-in-ide-mcp-server) o dal [pannello diff](#diff-panel), mantiene la selezione che avevate quando avete premuto `Enter`, indipendentemente da ciò che selezionate in seguito.

409

402<h3 id="when-claude-code-sends-what-you-queued">410<h3 id="when-claude-code-sends-what-you-queued">

403 Quando Claude Code invia ciò che avete accodato411 Quando Claude Code invia ciò che avete accodato

404</h3>412</h3>

jetbrains.md +5 −1

Details

249 249

250Il server è denominato `ide` ed è nascosto da `/mcp` perché non c'è nulla da configurare. Se la vostra organizzazione utilizza un [hook `PreToolUse`](/docs/it/hooks#pretooluse) per creare un elenco di strumenti MCP consentiti, tuttavia, dovrete sapere che esiste.250Il server è denominato `ide` ed è nascosto da `/mcp` perché non c'è nulla da configurare. Se la vostra organizzazione utilizza un [hook `PreToolUse`](/docs/it/hooks#pretooluse) per creare un elenco di strumenti MCP consentiti, tuttavia, dovrete sapere che esiste.

251 251

252**Contesto di selezione e file aperto.** Mentre è connesso, la CLI include la selezione dell'editor corrente e il percorso del file attivo come contesto su ogni prompt che inviate. La trascrizione mostra una riga `⧉ Selected N lines from <file>` quando ciò accade. Per escludere un file sensibile come `.env`, aggiungete una [regola di negazione `Read`](/docs/it/permissions#read-and-edit) per il suo percorso. Una regola di negazione corrispondente impedisce sia il testo selezionato che l'avviso di file aperto per quel file di raggiungere Claude.252**Contesto di selezione e file aperto.** Mentre è connesso, la CLI include la selezione dell'editor corrente e il percorso del file attivo come contesto su ogni prompt che inviate. La trascrizione mostra una riga `⧉ Selected N lines from <file>` quando ciò accade.

253

254Se [accodate un messaggio mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works), mantiene la selezione che avevate quando avete premuto `Enter`, indipendentemente da ciò che selezionate in seguito.

255

256Per escludere un file sensibile come `.env`, aggiungete una [regola di negazione `Read`](/docs/it/permissions#read-and-edit) per il suo percorso. Una regola di negazione corrispondente impedisce sia il testo selezionato che l'avviso di file aperto per quel file di raggiungere Claude.

253 257

254**Trasporto e autenticazione.** Il server ascolta su una porta effimera assegnata dal sistema operativo e la porta non è configurabile. Il trasporto è `ws://` non crittografato; sul loopback, qualsiasi processo che potrebbe catturare il traffico può anche leggere il token dal file di blocco, quindi TLS non aggiungerebbe protezione contro un attaccante locale. Ogni avvio dell'IDE genera un token di autenticazione casuale fresco, lo scrive in un file di blocco in `~/.claude/ide/<port>.lock` e la CLI deve presentarlo come intestazione `X-Claude-Code-Ide-Authorization` per connettersi. Se `CLAUDE_CONFIG_DIR` è impostato, il file di blocco viene scritto in `$CLAUDE_CONFIG_DIR/ide/` invece.258**Trasporto e autenticazione.** Il server ascolta su una porta effimera assegnata dal sistema operativo e la porta non è configurabile. Il trasporto è `ws://` non crittografato; sul loopback, qualsiasi processo che potrebbe catturare il traffico può anche leggere il token dal file di blocco, quindi TLS non aggiungerebbe protezione contro un attaccante locale. Ogni avvio dell'IDE genera un token di autenticazione casuale fresco, lo scrive in un file di blocco in `~/.claude/ide/<port>.lock` e la CLI deve presentarlo come intestazione `X-Claude-Code-Ide-Authorization` per connettersi. Se `CLAUDE_CONFIG_DIR` è impostato, il file di blocco viene scritto in `$CLAUDE_CONFIG_DIR/ide/` invece.

255 259

keybindings.md +88 −67

Details

~~93| `app:toggleTodos` | Ctrl+T | Attiva/disattiva la visibilità dell'elenco delle attività di Claude. Questo non è il [`/tasks`](/docs/it/commands) background-task view |~~93| `app:toggleTodos` | Ctrl+T | Attiva/disattiva la visibilità della lista di controllo delle attività di Claude. Questo non è il [`/tasks`](/docs/it/commands) background-task view |

95 95

96<h3 id="history-actions">96<h3 id="history-actions">

97 Azioni della cronologia97 Azioni della cronologia

103| :- | :- | :- |103| :- | :- | :- |

105| `history:previous` | Su | Elemento della cronologia precedente |105| `history:previous` | Su | Elemento precedente della cronologia |

106| `history:next` | Giù | Elemento della cronologia successivo |106| `history:next` | Giù | Elemento successivo della cronologia |

107 107

108<h3 id="chat-actions">108<h3 id="chat-actions">

109 Azioni della chat109 Azioni della chat

115| :- | :- | :- |115| :- | :- | :- |

118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |

119| `chat:killAgents` | Ctrl+X Ctrl+K | Termina tutti gli [agenti in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in esecuzione in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione |119| `chat:killAgents` | Ctrl+X Ctrl+K | Interrompi tutti i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione |

125| `chat:queueSubmit` | Ctrl+X Invio | Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo [mette in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche mentre i suggerimenti di autocompletamento sono aperti. Richiede v2.1.247 o successiva |125| `chat:queueSubmit` | Ctrl+X Invio | Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo [mette in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche quando un suggerimento di completamento automatico è evidenziato. Richiede v2.1.247 o successiva |

126| `chat:sendNow` | Ctrl+Invio, Ctrl+X Ctrl+S | Invia i tuoi [messaggi in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e la tua bozza con essi subito. [Quando Claude Code invia quello che hai messo in coda](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Quando non è in esecuzione nulla, il tasto invia la bozza, e nella [modalità shell](/docs/it/interactive-mode#shell-mode-with-prefix) mette in coda solo il comando. I terminali che non segnalano tasti estesi consegnano `Ctrl+Invio` come semplice `Invio`, quindi `Ctrl+X Ctrl+S` è il binding che funziona in qualsiasi terminale. Richiede v2.1.275 o successiva |126| `chat:sendNow` | Ctrl+Invio, Ctrl+X Ctrl+S | Invia i tuoi [messaggi in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e la tua bozza insieme a loro, subito. [Quando Claude Code invia quello che hai messo in coda](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Quando nulla è in esecuzione, il tasto invia la bozza, e in [shell mode](/docs/it/interactive-mode#shell-mode-with-prefix) mette in coda solo il comando. I terminali che non segnalano tasti estesi consegnano `Ctrl+Invio` come semplice `Invio`, quindi `Ctrl+X Ctrl+S` è l'associazione che funziona in qualsiasi terminale. Richiede v2.1.275 o successiva |

129| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Apri nell'editor esterno. Il [dispatch input della visualizzazione dell'agente](/docs/it/agent-view#keyboard-shortcuts) segue anche i binding a singola pressione di tasto di questa azione |129| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Apri nell'editor esterno. Il [dispatch input della vista agente](/docs/it/agent-view#keyboard-shortcuts) segue anche le associazioni a singolo tasto di questa azione |

132 132

133\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.133\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.

134 134

135<h3 id="autocomplete-actions">135<h3 id="autocomplete-actions">

136 Azioni di autocompletamento136 Azioni di completamento automatico

137</h3>137</h3>

138 138

139Azioni disponibili nel contesto `Autocomplete`:139Azioni disponibili nel contesto `Autocomplete`:

160| `confirm:nextField` | Tab | Campo successivo |160| `confirm:nextField` | Tab | Campo successivo |

163| `confirm:cycleMode` | Shift+Tab\* | Cicla le modalità di permesso. Su un prompt di permesso file, chiude un [campo commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto; senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre tale opzione |163| `confirm:cycleMode` | Shift+Tab\* | Cicla le modalità di autorizzazione. Su un prompt di autorizzazione file, chiude un [campo commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto; senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre tale opzione |

164 164

165\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.165\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.

166 166

167Prima della v2.1.257, un'azione `confirm:toggleExplanation`, associata a `Ctrl+E` per impostazione predefinita, mostrava una spiegazione generata dal modello del comando sui prompt di permesso Bash e PowerShell.167Prima della v2.1.257, un'azione `confirm:toggleExplanation`, associata a `Ctrl+E` per impostazione predefinita, mostrava una spiegazione generata dal modello del comando su prompt di autorizzazione Bash e PowerShell.

168 168

169I dialoghi utilizzano `confirm:yes` e `confirm:no` per accettare e annullare anche quando non pongono una domanda sì o no. Se associ una lettera semplice come `y` o `n` in questo contesto, la lettera agisce anche su dialoghi che non la mostrano mai come tasto. Un dialogo che mostra `y` e `n` come suoi tasti legge quelle lettere stesso e non ha bisogno di alcun binding.169I dialoghi utilizzano `confirm:yes` e `confirm:no` per accettare e annullare anche quando non pongono una domanda sì-o-no. Se associ una lettera semplice come `y` o `n` in questo contesto, la lettera agisce anche su dialoghi che non la mostrano mai come tasto. Un dialogo che mostra `y` e `n` come suoi tasti legge quelle lettere stesso e non ha bisogno di alcuna associazione.

170

171Nella maggior parte dei dialoghi, premere `Ctrl+C` o `Ctrl+D` due volte chiude il dialogo invece di uscire da Claude Code. L'hint dopo il primo pressione dice se il secondo pressione chiude il dialogo o esce. Entrambi i tasti sono [riservati](#reserved-shortcuts) e non possono essere riassociati.

170 172

171Questo esempio associa `y` a `confirm:yes` e `n` a `confirm:no`:173Questo esempio associa `y` a `confirm:yes` e `n` a `confirm:no`:

172 174

184}186}

185```187```

186 188

187Con questi binding, `y` e `n` continuano a digitarsi come lettere mentre un [campo di testo](#text-fields) ha il focus.189Con queste associazioni, `y` e `n` continuano a digitare come lettere mentre un [campo di testo](#text-fields) ha il focus.

188 190

189Prima della v2.1.280, `y` era anche associato a `confirm:yes` e `n` a `confirm:no` per impostazione predefinita. Se hai creato il tuo `keybindings.json` con `/keybindings` prima della v2.1.280, il file elenca entrambi i binding e rimangono in vigore finché non elimini quelle due righe.191Prima della v2.1.280, `y` era anche associato a `confirm:yes` e `n` a `confirm:no` per impostazione predefinita. Se hai creato il tuo `keybindings.json` con `/keybindings` prima della v2.1.280, il file elenca entrambe le associazioni e rimangono in vigore finché non elimini quelle due righe.

190 192

191<h3 id="permission-actions">193<h3 id="permission-actions">

192 Azioni di permesso194 Azioni di autorizzazione

193</h3>195</h3>

194 196

195Azioni disponibili nel contesto `Confirmation` per i dialoghi di permesso:197Azioni disponibili nel contesto `Confirmation` per i dialoghi di autorizzazione:

196 198

198| :- | :- | :- |200| :- | :- | :- |

199| `permission:toggleDebug` | (non associato) | Attiva/disattiva le informazioni di debug del permesso. Il valore predefinito precedente di Ctrl+D è stato rimosso nella v2.1.146 perché oscurava `app:exit` |201| `permission:toggleDebug` | (non associato) | Attiva/disattiva le informazioni di debug dell'autorizzazione. Il valore predefinito precedente di Ctrl+D è stato rimosso nella v2.1.146 perché oscurava `app:exit` |

200 202

201<h3 id="transcript-actions">203<h3 id="transcript-actions">

202 Azioni di trascrizione204 Azioni del trascritto

203</h3>205</h3>

204 206

205Azioni disponibili nel contesto `Transcript`:207Azioni disponibili nel contesto `Transcript`:

206 208

208| :- | :- | :- |210| :- | :- | :- |

211 213

212`transcript:toggleShowAll` si applica solo nel renderer classico; nel [rendering a schermo intero](/docs/it/fullscreen), il visualizzatore di trascrizione non offre un'opzione di visualizzazione completa.214`transcript:toggleShowAll` si applica solo nel renderer classico; nel [rendering a schermo intero](/docs/it/fullscreen), il visualizzatore di trascritti non offre un'opzione di mostra tutto.

213 215

214<h3 id="history-search-actions">216<h3 id="history-search-actions">

215 Azioni di ricerca nella cronologia217 Azioni di ricerca nella cronologia

235 237

237| :- | :- | :- |239| :- | :- | :- |

239 241

240<h3 id="theme-actions">242<h3 id="theme-actions">

241 Azioni del tema243 Azioni del tema

270 272

273In una finestra di dialogo con schede, `tabs:next` e `tabs:previous` cambiano le schede mentre la riga delle schede ha il focus. In alcuni dialoghi, come `/help` e `/sandbox`, i tasti di cambio scheda funzionano anche dall'interno del contenuto della scheda.

274

275`Su` e `Giù` spostano il focus tra la riga delle schede e il contenuto della scheda, e un elenco nel contenuto risponde ai tasti solo mentre ha il focus.

276

271<h3 id="attachments-actions">277<h3 id="attachments-actions">

272 Azioni degli allegati278 Azioni degli allegati

273</h3>279</h3>

295| `footer:down` | Giù | Naviga verso il basso nel piè di pagina |301| `footer:down` | Giù | Naviga verso il basso nel piè di pagina |

298| `footer:dismiss` | Backspace, Canc | Chiudi il collegamento [artefatto](/docs/it/artifacts) selezionato dal piè di pagina; l'artefatto pubblicato stesso non è interessato. Su altre righe del piè di pagina, questi tasti non hanno effetto. Richiede v2.1.217 o successiva |304| `footer:dismiss` | (non associato) | Rimosso nella v2.1.281. Un `keybindings.json` che nomina ancora l'azione rimane valido e l'associazione non fa nulla. Prima della v2.1.281, Backspace e Canc chiudevano il collegamento dell'artefatto selezionato dal piè di pagina |

299 305

300Mentre un elemento del piè di pagina è selezionato, come una riga nel pannello dell'agente sotto il prompt, `Invio` lo apre anche quando riassoci `Invio` nel contesto `Chat` a `chat:queueSubmit` o `chat:newline`.306Mentre un elemento del piè di pagina è selezionato, come una riga nel pannello dell'agente sotto il prompt, `Invio` lo apre anche quando riassoci `Invio` nel contesto `Chat` a `chat:queueSubmit` o `chat:newline`.

301 307

302I binding `Chat` su tasti che il contesto `Footer` non associa, come `Shift+Tab` per `chat:cycleMode`, continuano a funzionare mentre un elemento è selezionato.308Le associazioni `Chat` sui tasti che il contesto `Footer` non associa, come `Shift+Tab` per `chat:cycleMode`, continuano a funzionare mentre un elemento è selezionato.

303 309

304<h3 id="message-selector-actions">310<h3 id="message-selector-actions">

305 Azioni del selezionatore di messaggi311 Azioni del selezionatore di messaggi

306</h3>312</h3>

307 313

308Azioni disponibili nel contesto `MessageSelector`:314Nel messaggio elenco del [menu di rewind](/docs/it/checkpointing), ti muovi attraverso i messaggi e ne scegli uno con le [azioni di selezione](#select-actions) e i loro tasti predefiniti. Le tue associazioni `Select` per quelle azioni si applicano anche lì. Il contesto `MessageSelector` non ha azioni o associazioni predefinite proprie. Usalo per cambiare un tasto per questo elenco solo, associando un'azione Select come `select:accept` in un blocco `MessageSelector`.

309 315

310| Azione | Predefinito | Descrizione |316Questo esempio associa `o` per scegliere il messaggio evidenziato nel menu di rewind, senza cambiare nessun altro elenco:

311| :- | :- | :- |317

312| `messageSelector:up` | Su, K, Ctrl+P | Sposta verso l'alto nell'elenco |318```json theme={null}

313| `messageSelector:down` | Giù, J, Ctrl+N | Sposta verso il basso nell'elenco |319{

314| `messageSelector:top` | Ctrl+Su, Shift+Su, Meta+Su, Shift+K | Salta all'inizio |320 "bindings": [

315| `messageSelector:bottom` | Ctrl+Giù, Shift+Giù, Meta+Giù, Shift+J | Salta alla fine |321 {

316| `messageSelector:select` | Invio | Seleziona il messaggio |322 "context": "MessageSelector",

323 "bindings": {

324 "o": "select:accept"

325 }

326 }

327 ]

328}

329```

330

331Prima della v2.1.283, questo elenco ignorava le associazioni `Select` e aveva le sue azioni: `messageSelector:up`, `messageSelector:down`, `messageSelector:top`, `messageSelector:bottom` e `messageSelector:select`. Se il tuo `keybindings.json` associa uno di quei nomi, l'associazione continua a funzionare in questo elenco come l'azione Select che fa la stessa cosa. `Home` e `End` saltano a entrambe le estremità dell'elenco; prima della v2.1.283, tasti come `Shift+K` e `Shift+J` lo facevano per impostazione predefinita.

317 332

318<h3 id="diff-actions">333<h3 id="diff-actions">

319 Azioni diff334 Azioni diff

323 338

325| :- | :- | :- |340| :- | :- | :- |

329| `diff:previousFile` | Su, K | File precedente nell'elenco dei file; scorri verso l'alto di una riga nella visualizzazione dei dettagli |344| `diff:previousFile` | Su, K | File precedente nell'elenco dei file; scorri verso l'alto di una riga nella vista dettagli |

332| `diff:back` | (non associato) | Torna indietro nel visualizzatore diff. Escape esegue l'azione indietro tramite `diff:dismiss`. Il valore predefinito precedente di Sinistra nella visualizzazione dei dettagli è stato rimosso nella v2.1.203 |347

348L'elenco dei file risponde anche alle [azioni di selezione](#select-actions), attraverso i loro tasti predefiniti e le tue associazioni `Select`. `select:previous` e `select:next` si spostano al file precedente e successivo, e `Invio` apre il diff del file selezionato tramite `select:accept`. Per cambiare uno di quei tasti per l'elenco dei file solo, associa l'azione Select in un blocco `DiffDialog`.

349

350Prima della v2.1.283, l'elenco dei file ignorava le associazioni `Select`, e `Invio` apriva il diff del file selezionato tramite un'azione `diff:viewDetails` separata. Se il tuo `keybindings.json` associa `diff:viewDetails`, l'associazione continua a funzionare nell'elenco dei file come `select:accept`.

333 351

334La visualizzazione dei dettagli diff associa anche i tasti in stile pager alle [azioni di scorrimento](#scroll-actions) standard. Questi binding fanno parte del contesto `DiffDialog` e si applicano solo nella visualizzazione dei dettagli; i valori predefiniti del contesto `Scroll` elencati in [Azioni di scorrimento](#scroll-actions) rimangono invariati.352La vista dettagli diff associa anche i tasti in stile pager alle [azioni di scorrimento](#scroll-actions) standard. Queste associazioni fanno parte del contesto `DiffDialog` e si applicano solo nella vista dettagli; i valori predefiniti del contesto `Scroll` elencati in [Azioni di scorrimento](#scroll-actions) rimangono invariati.

335 353

337| :- | :- | :- |355| :- | :- | :- |

344 362

345<h3 id="diff-panel-actions">363<h3 id="diff-panel-actions">

346 Azioni del pannello diff364 Azioni del pannello diff

373 Azioni del cursore di sforzo391 Azioni del cursore di sforzo

374</h3>392</h3>

375 393

376Azioni disponibili nel contesto `EffortSlider`, il cursore che si apre quando esegui `/effort` senza argomenti. I tasti Sinistra, Destra, Invio ed Escape del cursore non possono essere riassociati.394Azioni disponibili nel contesto `EffortSlider`, il cursore che si apre quando esegui `/effort` senza argomenti. I tasti Invio ed Escape del cursore non possono essere riassociati.

377 395

379| :- | :- | :- |397| :- | :- | :- |

398| `effortSlider:decreaseEffort` | Sinistra | Sposta il cursore al livello di sforzo successivo inferiore. Richiede v2.1.284 o successiva |

399| `effortSlider:increaseEffort` | Destra | Sposta il cursore al livello di sforzo successivo superiore. Richiede v2.1.284 o successiva |

400| `effortSlider:toggleUltracode` | Tab | Attiva/disattiva [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) per questa sessione, quando il cursore lo [offre](/docs/it/model-config#when-ultracode-is-available). Richiede v2.1.284 o successiva |

380| `effortSlider:thisSessionOnly` | s | Applica il [livello di sforzo](/docs/it/model-config#adjust-effort-level) focalizzato solo a questa sessione. Richiede v2.1.257 o successiva |401| `effortSlider:thisSessionOnly` | s | Applica il [livello di sforzo](/docs/it/model-config#adjust-effort-level) focalizzato solo a questa sessione. Richiede v2.1.257 o successiva |

381 402

382<h3 id="select-actions">403<h3 id="select-actions">

398 419

399Claude Code applica i tuoi binding `select:pageUp`, `select:pageDown`, `select:first` e `select:last` nel menu `/skills`. Nella maggior parte degli altri elenchi, come il selezionatore `/model`, i tuoi binding `select:first` e `select:last` si applicano. PagSu e PagGiù scorrono le opzioni in quegli elenchi indipendentemente dai tuoi binding.420Nei pannelli elenco come `/skills` e `/mcp`, Claude Code applica le tue associazioni `select:pageUp`, `select:pageDown`, `select:first` e `select:last`. Nella maggior parte degli altri elenchi, come il selezionatore `/model`, si applicano le tue associazioni `select:first` e `select:last`. PagSu e PagGiù scorrono le opzioni in quegli elenchi indipendentemente dalle tue associazioni.

400 421

401Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e i tuoi binding `select:first` e `select:last`.422Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e le tue associazioni `select:first` e `select:last`.

402 423

403<h3 id="plugin-actions">424<h3 id="plugin-actions">

404 Azioni dei plugin425 Azioni dei plugin

410| :- | :- | :- |431| :- | :- | :- |

412| `plugin:install` | I | Installa i plugin selezionati |433| `plugin:install` | I | Installa i plugin selezionati |

413| `plugin:favorite` | F | Aggiungi ai preferiti il plugin selezionato in modo che si ordini vicino alla parte superiore della scheda Installati |434| `plugin:favorite` | F | Contrassegna il plugin selezionato come preferito in modo che si ordini vicino alla parte superiore della scheda Installato |

414 435

415<h3 id="settings-actions">436<h3 id="settings-actions">

416 Azioni delle impostazioni437 Azioni delle impostazioni

417</h3>438</h3>

418 439

419Azioni disponibili nel contesto `Settings`. Le azioni `select:accept` e `confirm:no` vengono riutilizzate dai contesti [Select](#select-actions) e [Confirmation](#confirmation-actions) con comportamento specifico delle impostazioni: le modifiche si applicano a ogni impostazione non appena la modifichi, quindi Escape chiude il pannello con le modifiche salvate piuttosto che rifiutarle.440Azioni disponibili nel contesto `Settings`. Le azioni `select:accept` e `confirm:no` vengono riutilizzate dai contesti [Select](#select-actions) e [Confirmation](#confirmation-actions) con comportamento specifico delle impostazioni: le modifiche si applicano a ogni impostazione non appena la modifichi, quindi Escape chiude il pannello con le tue modifiche salvate piuttosto che rifiutare.

420 441

422| :- | :- | :- |443| :- | :- | :- |

429 Azioni degli agenti450 Azioni degli agenti

430</h3>451</h3>

431 452

432Azioni disponibili nel contesto `Agents`, che si applica nella [visualizzazione dell'agente](/docs/it/agent-view), aperta con `claude agents`. Richiede v2.1.257 o successiva.453Azioni disponibili nel contesto `Agents`, che si applica nella [vista agente](/docs/it/agent-view), aperta con `claude agents`. Richiede v2.1.257 o successiva.

433 454

435| :- | :- | :- |456| :- | :- | :- |

438 459

439Mentre la visualizzazione dell'agente è aperta, Claude Code utilizza il binding `Agents` per qualsiasi tasto che il contesto `Agents` associa, e ignora un binding `Chat` o `Global` sulla stessa chiave. Ad esempio, premendo Ctrl+S nella visualizzazione dell'agente si cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito `chat:stash`.460Mentre la vista agente è aperta, Claude Code utilizza l'associazione `Agents` per qualsiasi tasto che il contesto `Agents` associa, e ignora un'associazione `Chat` o `Global` sulla stessa chiave. Ad esempio, premere Ctrl+S nella vista agente cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito `chat:stash`.

440 461

441La scorciatoia dell'editor esterno dell'input di dispatch non è un'azione `Agents`. La visualizzazione dell'agente segue il binding `chat:externalEditor` del contesto `Chat`, Ctrl+G per impostazione predefinita.462La scorciatoia dell'editor esterno dell'input di dispatch non è un'azione `Agents`. La vista agente segue l'associazione `chat:externalEditor` del contesto `Chat`, Ctrl+G per impostazione predefinita.

442 463

443I binding si attivano su singole pressioni di tasto nella visualizzazione dell'agente, quindi l'accordo Ctrl+X Ctrl+E associato a `chat:externalEditor` non apre l'editor lì.464Le associazioni si attivano su singoli tasti nella vista agente, quindi l'accordo Ctrl+X Ctrl+E associato a `chat:externalEditor` non apre l'editor lì.

444 465

445<h3 id="voice-actions">466<h3 id="voice-actions">

446 Azioni vocali467 Azioni vocali

450 471

452| :- | :- | :- |473| :- | :- | :- |

454 475

455<h3 id="scroll-actions">476<h3 id="scroll-actions">

456 Azioni di scorrimento477 Azioni di scorrimento

460 481

462| :- | :- | :- |483| :- | :- | :- |

469| `scroll:halfPageUp` | (non associato) | Scorri verso l'alto della metà dell'altezza del viewport. Stesso comportamento di `scroll:pageUp`, fornito per i rebind in stile vi |490| `scroll:halfPageUp` | (non associato) | Scorri verso l'alto di mezza altezza della finestra. Stesso comportamento di `scroll:pageUp`, fornito per riassociazioni in stile vi |

470| `scroll:halfPageDown` | (non associato) | Scorri verso il basso della metà dell'altezza del viewport. Stesso comportamento di `scroll:pageDown`, fornito per i rebind in stile vi |491| `scroll:halfPageDown` | (non associato) | Scorri verso il basso di mezza altezza della finestra. Stesso comportamento di `scroll:pageDown`, fornito per riassociazioni in stile vi |

481 502

llm-gateway.md +1 −1

Details

49 Abbonamenti e gateway49 Abbonamenti e gateway

50</h2>50</h2>

51 51

52Mentre una [variabile di credenziale del gateway](/docs/it/llm-gateway-connect#set-the-credential-variable) o `apiKeyHelper` è attiva, l'abbonamento a claude.ai di uno sviluppatore non viene utilizzato: la credenziale sostituisce l'accesso all'abbonamento per quella sessione, e i limiti di utilizzo dell'abbonamento non si applicano. Quel traffico viene fatturato per token a chiunque possieda la credenziale che il gateway inoltra, come l'account Anthropic Console della tua organizzazione, o il tuo account Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry quando il gateway instrada lì.52Mentre una [variabile di credenziale del gateway](/docs/it/llm-gateway-connect#set-the-credential-variable) o `apiKeyHelper` è attiva, le richieste portano quella credenziale al posto dell'accesso all'abbonamento claude.ai di uno sviluppatore, e i limiti di utilizzo dell'abbonamento non si applicano a loro. Claude Code mantiene un accesso claude.ai salvato sulla macchina ma non lo invia con quelle richieste. Quel traffico viene fatturato per token a chiunque possieda la credenziale che il gateway inoltra, come l'account Anthropic Console della tua organizzazione, o il tuo account Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry quando il gateway instrada lì.

53 53

54[`ANTHROPIC_BASE_URL`](/docs/it/llm-gateway-connect#set-the-base-url-and-credential) è la variabile che punta Claude Code al gateway. Impostare solo quella variabile, senza una credenziale del gateway, non sostituisce l'abbonamento. Le richieste vengono comunque instradate attraverso il gateway, ma un accesso a claude.ai salvato rimane la credenziale attiva, quindi i suoi limiti di utilizzo e la fatturazione si applicano. I gateway che passano questo traffico ad Anthropic devono inoltrare la capacità OAuth in `anthropic-beta`; vedi il [riferimento delle intestazioni della richiesta](/docs/it/llm-gateway-protocol#request-headers).54[`ANTHROPIC_BASE_URL`](/docs/it/llm-gateway-connect#set-the-base-url-and-credential) è la variabile che punta Claude Code al gateway. Impostare solo quella variabile, senza una credenziale del gateway, non sostituisce l'abbonamento. Le richieste vengono comunque instradate attraverso il gateway, ma un accesso a claude.ai salvato rimane la credenziale attiva, quindi i suoi limiti di utilizzo e la fatturazione si applicano. I gateway che passano questo traffico ad Anthropic devono inoltrare la capacità OAuth in `anthropic-beta`; vedi il [riferimento delle intestazioni della richiesta](/docs/it/llm-gateway-protocol#request-headers).

55 55

llm-gateway-connect.md +17 −17

Details

140<Tabs>140<Tabs>

141 <Tab title="Bash o Zsh">141 <Tab title="Bash o Zsh">

142 ```bash theme={null}142 ```bash theme={null}

143 curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \143 curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \

144 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \144 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \

145 -H "anthropic-version: 2023-06-01" \145 -H "anthropic-version: 2023-06-01" \

146 -H "content-type: application/json" \146 -H "content-type: application/json" \

579 579

581| :- | :- | :- |581| :- | :- | :- |

582| Un avviso di avvio che nomina due fonti di credenziale e termina con `auth may not work as expected`. Le versioni più vecchie mostrano `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` invece. | Una credenziale del gateway e un accesso salvato sono entrambi attivi; la variabile viene utilizzata per le richieste, ma l'accesso stantio può causare un comportamento di autenticazione inaspettato | Annulla l'impostazione della variabile per usare l'accesso salvato, o esegui `/logout` per usare la credenziale del gateway |582| Un avviso di avvio che nomina due fonti di credenziali e termina con `auth may not work as expected`. Le versioni precedenti mostrano invece `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` | Una credenziale del gateway e un accesso salvato sono entrambi attivi; la variabile viene utilizzata per le richieste, ma l'accesso obsoleto può causare un comportamento di autenticazione inaspettato | Annulla l'impostazione della variabile per utilizzare l'accesso salvato, oppure esegui `/logout` per utilizzare la credenziale del gateway |

583| Errori `401` che nominano un token non valido o non riconosciuto | La credenziale non è una che il gateway ha emesso, o è in un'intestazione che il gateway non legge | Conferma che la variabile corrisponde al tuo tipo di credenziale nella [tabella di credenziale](#set-the-credential-variable), e rigenera la chiave al gateway se è stata revocata |583| Errori `401` che nominano un token non valido o non riconosciuto | La credenziale non è una che il gateway ha emesso, oppure si trova in un'intestazione che il gateway non legge | Conferma che la variabile corrisponda al tuo tipo di credenziale nella [tabella delle credenziali](#set-the-credential-variable), e rigenera la chiave al gateway se è stata revocata |

584| `Your apiKeyHelper script is failing`, o `apiKeyHelper failed:` su stderr in modalità non interattiva | Il comando nell'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) non ha prodotto una chiave utilizzabile, quindi le richieste portano una chiave segnaposto | Esegui il comando direttamente per vedere perché fallisce, e ri-autentica con il tuo provider di credenziali se segnala una sessione scaduta; vedi [il riferimento dell'errore](/docs/it/errors#your-apikeyhelper-script-is-failing) |584| `Your apiKeyHelper script is failing`, oppure `apiKeyHelper failed:` su stderr in modalità non interattiva | Il comando nell'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) non ha prodotto una chiave utilizzabile, quindi le richieste portano una chiave segnaposto | Esegui il comando direttamente per vedere perché non riesce, e autentica di nuovo con il tuo provider di credenziali se segnala una sessione scaduta; vedi [il riferimento degli errori](/docs/it/errors#your-apikeyhelper-script-is-failing) |

585| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` quando nulla risponde all'indirizzo, o `Can't reach the API server — check your internet or DNS (ENOTFOUND)` quando il nome host non si risolve, spesso dopo una pausa silenziosa mentre Claude Code [riprova con backoff](/docs/it/errors#automatic-retries). Il codice tra parentesi varia; [Unable to connect to API](/docs/it/errors#unable-to-connect-to-api) copre i codici e la formulazione precedente | Nulla ha risposto all'URL di base: l'indirizzo è sbagliato, o una VPN o firewall blocca il percorso al gateway | Esegui il [test curl di cui sopra](#verify-the-connection), che fallisce immediatamente con la stessa causa, e conferma l'URL e il percorso di rete con il tuo team del gateway |585| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` quando nulla risponde all'indirizzo, oppure `Can't reach the API server — check your internet or DNS (ENOTFOUND)` quando il nome host non si risolve, spesso dopo una pausa silenziosa mentre Claude Code [ritenta con backoff](/docs/it/errors#automatic-retries). Il codice tra parentesi varia; [Unable to connect to API](/docs/it/errors#unable-to-connect-to-api) copre i codici e la formulazione precedente | Nulla ha risposto all'URL di base: l'indirizzo è sbagliato, oppure una VPN o un firewall blocca il percorso verso il gateway | Esegui il [test curl sopra](#verify-the-connection), che non riesce immediatamente con la stessa causa, e conferma l'URL e il percorso di rete con il tuo team del gateway |

586| `API returned an empty or malformed response (HTTP 200)` | Il gateway o un proxy intermedio ha restituito una risposta non-API, spesso una pagina di errore HTML o di accesso | Testa con la [richiesta curl di cui sopra](#verify-the-connection); correggi il percorso del gateway che restituisce qualcosa di diverso da una risposta API Claude. [Il riferimento dell'errore](/docs/it/errors#api-returned-an-empty-or-malformed-response) spiega il dettaglio che il messaggio segnala |586| `API returned an empty or malformed response (HTTP 200)` | Il gateway o un proxy intermedio ha restituito una risposta non API, spesso una pagina di errore HTML o di accesso | Testa con la [richiesta curl sopra](#verify-the-connection); correggi il percorso del gateway che risponde con qualcosa di diverso da una risposta API di Claude. [Il riferimento degli errori](/docs/it/errors#api-returned-an-empty-or-malformed-response) spiega il dettaglio che il messaggio segnala |

587| Errori `400` che nominano `context_management`, `Extra inputs are not permitted`, o altri campi non riconosciuti | Il gateway invia le richieste a un upstream che rifiuta i campi che Claude Code invia agli endpoint in formato Anthropic | Imposta `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, che sopprime la maggior parte dei campi pre-release; vedi [feature pass-through](/docs/it/llm-gateway-protocol#feature-pass-through). Alcuni beta non sono controllati da questo flag; per quelli, imposta la variabile provider `CLAUDE_CODE_USE_*` corrispondente in modo che Claude Code invii solo quello che quel provider accetta |587| Errori `400` che nominano `context_management`, `Extra inputs are not permitted`, o altri campi non riconosciuti | Il gateway inoltra le richieste a un upstream che rifiuta i campi che Claude Code invia agli endpoint in formato Anthropic | Imposta `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, che sopprime la maggior parte dei campi pre-release; vedi [feature pass-through](/docs/it/llm-gateway-protocol#feature-pass-through). Alcuni beta non sono controllati da questo flag; per quelli, imposta la variabile del provider `CLAUDE_CODE_USE_*` corrispondente in modo che Claude Code invii solo ciò che quel provider accetta |

588| Errori `400` che nominano `thinking` o `adaptive`, come `Input tag 'adaptive' found` | La build del modello upstream non accetta il ragionamento adattivo, che Claude Code richiede per i modelli Claude 4.6 e successivi | Aggiorna l'upstream del gateway. Su Opus 4.6 e Sonnet 4.6, `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` funziona invece. Le variabili di capacità della [configurazione del modello](/docs/it/model-config) si applicano solo alle configurazioni del provider, come `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, non dietro un gateway `ANTHROPIC_BASE_URL` |588| Errori `400` che nominano `thinking` o `adaptive`, come `Input tag 'adaptive' found` | La build del modello upstream non accetta il ragionamento adattivo, che Claude Code richiede per i modelli Claude 4.6 e successivi | Aggiorna l'upstream del gateway. Su Opus 4.6 e Sonnet 4.6, `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` funziona invece. Le variabili di capacità della [configurazione del modello](/docs/it/model-config) si applicano solo alle configurazioni del provider, come `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, non dietro un gateway `ANTHROPIC_BASE_URL` |

589| Errori `400` che indicano un contesto o limite di token nelle parole del gateway stesso, come `ContextWindowExceededError` o `prompt token count of N exceeds the limit of M` | Il gateway applica un contesto più piccolo della finestra nativa del modello e riscrive l'errore upstream, quindi Claude Code non lo riconosce come un [errore troppo lungo](/docs/it/errors#prompt-is-too-long) e non compatta e riprova automaticamente | Esegui `/compact` per recuperare la sessione. Per prevenirlo, imposta `CLAUDE_CODE_AUTO_COMPACT_WINDOW` al limite del gateway; Claude Code blocca il valore ad almeno 100.000 token e al massimo la finestra di contesto del modello, quindi non puoi abbinare un limite del gateway inferiore a 100.000, e `/compact` rimane il recupero lì. Imposta anche `CLAUDE_CODE_MAX_OUTPUT_TOKENS` sotto il limite di output del modello del gateway |589| Errori `400` che indicano un limite di contesto o token nelle parole proprie del gateway, come `ContextWindowExceededError` o `prompt token count of N exceeds the limit of M` | Il gateway applica un contesto più piccolo della finestra nativa del modello e riscrive l'errore upstream, quindi Claude Code non lo riconosce come [errore troppo lungo](/docs/it/errors#prompt-is-too-long) e non compatta e ritenta automaticamente | Esegui `/compact` per recuperare la sessione. Per prevenirlo, imposta `CLAUDE_CODE_AUTO_COMPACT_WINDOW` al limite del gateway; Claude Code fissa il valore ad almeno 100.000 token e al massimo la finestra di contesto del modello, quindi non puoi corrispondere a un limite del gateway inferiore a 100.000, e `/compact` rimane il recupero lì. Imposta anche `CLAUDE_CODE_MAX_OUTPUT_TOKENS` al di sotto del limite di output del modello del gateway |

590| Errori `400` su ogni richiesta, nelle parole del gateway stesso che rifiutano lo schema di input di uno strumento o il suo `pattern`, su Claude Code v2.1.265 attraverso v2.1.267 | In un rollout graduale su quelle versioni, lo schema dello [strumento Artifact](/docs/it/artifacts#availability) contiene un'espressione regolare con classi di caratteri Unicode `\p{...}`. L'API Anthropic l'accetta, ma un gateway o upstream che controlla il `pattern` dello schema di ogni strumento con il proprio motore regex rifiuta l'intera richiesta | Aggiorna a v2.1.268 o successivo, che non invia l'espressione regolare. Su una versione interessata, [disattiva gli artifact](/docs/it/artifacts#disable-artifacts), che rimuove lo strumento e il suo schema dalle richieste |590| Errori `400` su ogni richiesta, nelle parole proprie del gateway che rifiutano lo schema di input di uno strumento o il suo `pattern`, su Claude Code v2.1.265 attraverso v2.1.267 | In un rollout graduale su quelle versioni, lo schema dello [strumento Artifact](/docs/it/artifacts#availability) porta un'espressione regolare con classi di caratteri Unicode `\p{...}`. L'API Anthropic l'accetta, ma un gateway o upstream che controlla il `pattern` dello schema di ogni strumento con il suo motore regex rifiuta l'intera richiesta | Aggiorna a v2.1.268 o successivo, che non invia l'espressione regolare. Su una versione interessata, [disattiva gli artifact](/docs/it/artifacts#disable-artifacts), che rimuove lo strumento e il suo schema dalle richieste |

591| Errori `400` su ogni richiesta, nelle parole del gateway stesso che rifiutano un tipo di strumento non riconosciuto, come `Input tag 'advisor_20260301'`, su Claude Code v2.1.275 | In un rollout graduale su quella versione, le richieste portano una voce dello [strumento advisor](/docs/it/advisor) anche con l'advisor disattivato. L'API Anthropic l'accetta, ma un gateway o upstream che convalida i tipi di strumento rifiuta l'intera richiesta; uno che [invia i campi del corpo della richiesta invariati](/docs/it/llm-gateway-protocol#forward-as-open-lists) lo passa attraverso senza effetti. La voce è una dichiarazione che non porta alcun contenuto di conversazione | Aggiorna a v2.1.276 o successivo, che non invia la voce dietro un gateway `ANTHROPIC_BASE_URL` a meno che tu non attivi l'advisor. Su v2.1.275, imposta [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](/docs/it/env-vars), che rimuove la voce dalle richieste |591| Errori `400` su ogni richiesta, nelle parole proprie del gateway che rifiutano un tipo di strumento non riconosciuto, come `Input tag 'advisor_20260301'`, su Claude Code v2.1.275 | In un rollout graduale su quella versione, le richieste portano una voce dello [strumento advisor](/docs/it/advisor) anche con l'advisor disattivato. L'API Anthropic l'accetta, ma un gateway o upstream che convalida i tipi di strumento rifiuta l'intera richiesta; uno che [inoltra i campi del corpo della richiesta invariati](/docs/it/llm-gateway-protocol#forward-as-open-lists) lo passa attraverso senza essere interessato. La voce è una dichiarazione che non porta contenuto di conversazione | Aggiorna a v2.1.276 o successivo, che non invia la voce dietro un gateway `ANTHROPIC_BASE_URL` a meno che tu non attivi l'advisor. Su v2.1.275, imposta [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](/docs/it/env-vars), che rimuove la voce dalle richieste |

592| Modelli mancanti dal selettore `/model` | I nomi dei modelli del gateway non sono nell'elenco integrato di Claude Code, o Claude Code sta mostrando un [`modelPicker`](/docs/it/settings-reference#modelpicker) che sostituisce le opzioni integrate | Abilita la [scoperta di modelli del gateway](#add-gateway-models-to-the-model-picker) o aggiungi nomi con le variabili della [configurazione del modello](/docs/it/model-config). Se Claude Code mostra un `modelPicker` che sostituisce, aggiungi i modelli del gateway ad esso, o chiedi al tuo amministratore di aggiungerli quando le impostazioni gestite lo forniscono |592| Modelli mancanti dal selettore `/model` | I nomi dei modelli del gateway non sono nell'elenco integrato di Claude Code, oppure Claude Code sta mostrando un [`modelPicker`](/docs/it/settings-reference#modelpicker) che sostituisce le opzioni integrate | Abilita la [scoperta dei modelli del gateway](#add-gateway-models-to-the-model-picker) o aggiungi nomi con le variabili di [configurazione del modello](/docs/it/model-config). Se Claude Code mostra un `modelPicker` che sostituisce, aggiungi i modelli del gateway ad esso, oppure chiedi al tuo amministratore di aggiungerli quando le impostazioni gestite lo forniscono |

593| `/fast` segnala `Fast mode unavailable due to network connectivity issues` mentre le richieste di inferenza funzionano | Il controllo di disponibilità della [modalità veloce](/docs/it/fast-mode) va direttamente a `api.anthropic.com` e non segue `ANTHROPIC_BASE_URL`, quindi l'uscita diretta bloccata fallisce il controllo. Lo stesso messaggio appare su una rete aperta quando il controllo presenta una chiave emessa dal gateway da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` e Anthropic la rifiuta | Consenti `api.anthropic.com` se l'uscita è bloccata, o imposta una variabile di salto; per una chiave del gateway rifiutata solo le variabili di salto aiutano. Vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |593| `/fast` segnala `Fast mode unavailable due to network connectivity issues` mentre le richieste di inferenza funzionano | Il controllo della disponibilità della [modalità veloce](/docs/it/fast-mode) va direttamente a `api.anthropic.com` e non segue `ANTHROPIC_BASE_URL`, quindi l'uscita diretta bloccata non riesce il controllo. Lo stesso messaggio appare su una rete aperta quando il controllo presenta una chiave emessa dal gateway da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` e Anthropic la rifiuta | Consenti `api.anthropic.com` se l'uscita è bloccata, oppure imposta una variabile di skip; per una chiave del gateway rifiutata solo le variabili di skip aiutano. Vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

594| `/fast` segnala `Fast mode has been disabled by your organization` in una sessione autenticata con `ANTHROPIC_AUTH_TOKEN`, anche se l'organizzazione ha la modalità veloce abilitata | Il controllo di disponibilità richiede un accesso claude.ai o una chiave API Anthropic; con solo un token bearer, Claude Code tratta la modalità veloce come disabilitata senza inviare il controllo | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |594| `/fast` segnala `Fast mode has been disabled by your organization` in una sessione autenticata con `ANTHROPIC_AUTH_TOKEN`, anche se l'organizzazione ha la modalità veloce abilitata | Il controllo della disponibilità richiede un accesso a claude.ai o una chiave API Anthropic; con solo un token bearer, Claude Code tratta la modalità veloce come disabilitata senza inviare il controllo | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

595| Claude Code ti chiede di accedere anche se il [test curl](#verify-the-connection) ha successo | La CLI non ha una credenziale propria: un URL di base raggiungibile non è uno, e in una sessione interattiva un blocco `env` nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto si applica solo dopo la procedura guidata di primo avvio e il [prompt di fiducia](/docs/it/permissions#what-runs-before-you-trust-a-folder) | Imposta `ANTHROPIC_AUTH_TOKEN` da qualche parte Claude Code legge prima della configurazione di primo avvio: un'esportazione di shell, il blocco `env` in `~/.claude/settings.json`, o impostazioni gestite |595| Claude Code ti chiede di accedere anche se il [test curl](#verify-the-connection) ha successo | La CLI non ha una credenziale propria: un URL di base raggiungibile non è uno, e in una sessione interattiva un blocco `env` nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto si applica solo dopo la procedura guidata di primo avvio e il [prompt di fiducia](/docs/it/permissions#what-runs-before-you-trust-a-folder) | Imposta `ANTHROPIC_AUTH_TOKEN` da qualche parte che Claude Code legge prima della configurazione di primo avvio: un'esportazione shell, il blocco `env` in `~/.claude/settings.json`, o impostazioni gestite |

596| `ANTHROPIC_API_KEY` è impostato ma ignorato, senza prompt | La chiave ha bisogno di un'approvazione una tantum nelle sessioni interattive, e una chiave precedentemente rifiutata viene ignorata senza chiedere di nuovo | Abilitala sotto `/config` con l'opzione `Use custom API key` |596| `ANTHROPIC_API_KEY` è impostato ma ignorato, senza prompt | La chiave ha bisogno di un'approvazione una tantum nelle sessioni interattive, e una chiave precedentemente rifiutata viene ignorata senza chiedere di nuovo | Abilitala sotto `/config` con l'opzione `Use custom API key` |

597| `This machine's managed settings require a first-party login` | Le impostazioni gestite includono `forceLoginMethod` o `forceLoginOrgUUID`, che non possono coesistere con `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper` | Il tuo amministratore deve rimuovere `forceLoginMethod` e `forceLoginOrgUUID` dalle impostazioni gestite per usare le credenziali del gateway, o rimuovere la credenziale del gateway per usare l'accesso di prima parte. I due non possono essere combinati |597| `This machine's managed settings require a first-party login`, oppure [`Administrator policy requires a Cloud gateway sign-in`](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) quando le impostazioni gestite impostano `forceLoginMethod` a `"gateway"` o impostano anche `forceLoginGatewayUrl` | Le impostazioni gestite includono `forceLoginMethod` o `forceLoginOrgUUID`, che non possono coesistere con `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper` | Il tuo amministratore deve rimuovere `forceLoginMethod`, `forceLoginOrgUUID`, e `forceLoginGatewayUrl` dalle impostazioni gestite per utilizzare le credenziali del gateway, oppure rimuovere la credenziale del gateway e utilizzare l'accesso che le impostazioni gestite richiedono. I due non possono essere combinati |

598| `403` con un corpo HTML come `403 Forbidden`, quando i log del gateway stesso non mostrano alcuna richiesta ricevuta | Un web application firewall o reverse proxy davanti al gateway ha bloccato il corpo della richiesta prima che raggiungesse il gateway. I prompt di Claude Code includono tag di stile XML e codice sorgente che corrispondono alle regole del corpo dello scripting tra siti, quindi un breve test curl passa mentre una sessione reale no | Esenta il percorso `/v1/messages` del gateway dall'ispezione del corpo della richiesta. Su AWS WAF questa è la regola gestita `CrossSiteScripting_Body`; su nginx con ModSecurity è la regola del corpo OWASP CRS equivalente |598| `403` con un corpo HTML come `403 Forbidden`, quando i log propri del gateway non mostrano alcuna richiesta ricevuta | Un web application firewall o reverse proxy davanti al gateway ha bloccato il corpo della richiesta prima che raggiungesse il gateway. I prompt di Claude Code includono tag in stile XML e codice sorgente che corrispondono alle regole del corpo dello scripting tra siti, quindi un breve test curl passa mentre una sessione reale no | Esenta il percorso `/v1/messages` del gateway dall'ispezione del corpo della richiesta. Su AWS WAF questa è la regola gestita `CrossSiteScripting_Body`; su nginx con ModSecurity è la regola del corpo OWASP CRS equivalente |

599| Errori di certificato o TLS come `SSL certificate verification failed` o `Self-signed certificate detected`, quando il [test curl](#verify-the-connection) ha successo | Il runtime di Claude Code non sta fidando della stessa autorità di certificazione che `curl` usa. Comune dietro proxy di ispezione TLS aziendale | Imposta `NODE_EXTRA_CA_CERTS` al percorso del bundle CA; vedi [archivio di certificati CA](/docs/it/network-config#ca-certificate-store) |599| Errori di certificato o TLS come `SSL certificate verification failed` o `Self-signed certificate detected`, quando il [test curl](#verify-the-connection) ha successo | Il runtime di Claude Code non sta fidando della stessa autorità di certificazione che `curl` utilizza. Comune dietro proxy di ispezione TLS aziendale | Imposta `NODE_EXTRA_CA_CERTS` al percorso del bundle CA; vedi [archivio certificati CA](/docs/it/network-config#ca-certificate-store) |

600 600

601Se Claude Code ti chiede di accedere ripetutamente dopo aver rimosso la configurazione del gateway, la causa è solitamente l'archiviazione delle credenziali piuttosto che il gateway; vedi [errori di autenticazione](/docs/it/errors#authentication-errors).601Se Claude Code ti chiede di accedere ripetutamente dopo aver rimosso la configurazione del gateway, la causa è solitamente l'archiviazione delle credenziali piuttosto che il gateway; vedi [errori di autenticazione](/docs/it/errors#authentication-errors).

602 602

llm-gateway-protocol.md +10 −3

Details

73 73

74Trasmettete in streaming le risposte di inferenza. Claude Code legge il flusso mentre arriva, quindi se il vostro gateway memorizza nel buffer le risposte complete prima di inoltrarle, Claude Code si blocca.74Trasmettete in streaming le risposte di inferenza. Claude Code legge il flusso mentre arriva, quindi se il vostro gateway memorizza nel buffer le risposte complete prima di inoltrarle, Claude Code si blocca.

75 75

76Consegnate la sequenza di eventi completa di ogni risposta senza eliminare, duplicare o riordinare gli eventi. Quando un evento fa riferimento a un blocco di contenuto il cui `content_block_start` non è mai arrivato, o a un blocco il cui `content_block_stop` è già arrivato, Claude Code smette di leggere il flusso a quell'evento invece di applicarlo, quindi un `content_block_stop` duplicato non può eseguire la stessa chiamata di strumento due volte. [La risposta sopra potrebbe essere incompleta](/docs/it/errors#the-response-above-may-be-incomplete) descrive ciò che l'utente vede, secondo le varianti `Parte della risposta non è mai arrivata` e `Il flusso di risposta era malformato`.

78Inoltrate ogni risposta attraverso i suoi eventi finali `message_delta` e `message_stop` prima di terminare il corpo. Un corpo che termina dopo un `message_delta` che trasporta un `stop_reason`, senza blocco di contenuto ancora aperto e nessun evento di blocco di contenuto dopo quel frame, conta come completo anche quando `message_stop` è mancante. Un corpo che il vostro gateway termina in modo pulito prima, una volta che un blocco di contenuto ha iniziato, viene trattato come una connessione interrotta: [Tentativi automatici](/docs/it/errors#automatic-retries) dice quando Claude Code ri-emette la richiesta, e [La risposta sopra potrebbe essere incompleta](/docs/it/errors#the-response-above-may-be-incomplete) copre ciò che mantiene una volta che il contenuto visibile è arrivato. Claude Code mantiene il `stop_reason` che un `message_delta` consegna, quindi un successivo `message_delta` solo per l'utilizzo il cui `delta` ha `stop_reason: null` o nessuna chiave `stop_reason` non lo cancella.

76Quando il client parla il formato Amazon Bedrock, inoltrate il corpo della risposta `InvokeModelWithResponseStream` e il suo header `Content-Type: application/vnd.amazon.eventstream` senza modifiche, e non convertite il flusso in server-sent events. Vedete [Errori di streaming dietro un gateway o proxy](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).80Quando il client parla il formato Amazon Bedrock, inoltrate il corpo della risposta `InvokeModelWithResponseStream` e il suo header `Content-Type: application/vnd.amazon.eventstream` senza modifiche, e non convertite il flusso in server-sent events. Vedete [Errori di streaming dietro un gateway o proxy](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

77 81

78Inoltrate anche i ping keep-alive. Sulle connessioni attraverso `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`, Claude Code conta ogni byte che il vostro gateway inoltra, inclusi gli eventi SSE `ping` e le righe di commento, e interrompe un flusso che rimane silenzioso per 300 secondi per impostazione predefinita. I ping dell'upstream sono l'unico traffico durante le pause di pensiero lunghe, quindi se il vostro gateway li elimina o li memorizza nel buffer, Claude Code interrompe il flusso durante quelle pause; [Tentativi automatici](/docs/it/errors#automatic-retries) copre ciò che un flusso interrotto segnala in base a quanto la risposta era progredita. Un upstream che non invia affatto ping, come l'event-stream binario di Amazon Bedrock, lascia quelle pause senza nulla da inoltrare. Quando si traduce da un tale upstream, emettete i vostri stessi eventi `ping` durante i gap silenziosi. I gateway raggiunti attraverso `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, o `ANTHROPIC_FOUNDRY_BASE_URL` non sono avvolti da questo watchdog a livello di byte, anche quando inoltrano il formato Anthropic Messages; lì, un [timeout di inattività di 5 minuti](/docs/it/env-vars) interrompe un flusso silenzioso invece, e sulle connessioni `ANTHROPIC_BEDROCK_BASE_URL` potete aggiungere il watchdog di byte con [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/it/env-vars).82Inoltrate anche i ping keep-alive. Sulle connessioni attraverso `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`, Claude Code conta ogni byte che il vostro gateway inoltra, inclusi gli eventi SSE `ping` e le righe di commento, e interrompe un flusso che rimane silenzioso per 300 secondi per impostazione predefinita. I ping dell'upstream sono l'unico traffico durante le pause di pensiero lunghe, quindi se il vostro gateway li elimina o li memorizza nel buffer, Claude Code interrompe il flusso durante quelle pause; [Tentativi automatici](/docs/it/errors#automatic-retries) copre ciò che un flusso interrotto segnala in base a quanto la risposta era progredita. Un upstream che non invia affatto ping, come l'event-stream binario di Amazon Bedrock, lascia quelle pause senza nulla da inoltrare. Quando si traduce da un tale upstream, emettete i vostri stessi eventi `ping` durante i gap silenziosi. I gateway raggiunti attraverso `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, o `ANTHROPIC_FOUNDRY_BASE_URL` non sono avvolti da questo watchdog a livello di byte, anche quando inoltrano il formato Anthropic Messages; lì, un [timeout di inattività di 5 minuti](/docs/it/env-vars) interrompe un flusso silenzioso invece, e sulle connessioni `ANTHROPIC_BEDROCK_BASE_URL` potete aggiungere il watchdog di byte con [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/it/env-vars).

158 162

159Impostare `CLAUDE_CODE_GATEWAY_HINT_HEADERS` su `0` interrompe le intestazioni su ogni connessione.163Impostare `CLAUDE_CODE_GATEWAY_HINT_HEADERS` su `0` interrompe le intestazioni su ogni connessione.

160 164

161Le intestazioni portano solo ciò che le righe sottostanti elencano: vocabolari fissi, nomi di strumenti e durate, mai testo del prompt o contenuti di file. Ogni valore è ASCII stampabile.165Le intestazioni portano solo ciò che le righe sottostanti elencano: vocabolari fissi, nomi di strumenti, durate e un identificatore di prompt casuale, mai testo del prompt o contenuti di file. Ogni valore è ASCII stampabile.

162 166

163| Intestazione | Descrizione |167| Intestazione | Descrizione |

164| :- | :- |168| :- | :- |

167| `x-claude-code-compaction` | Presente sulla richiesta che riepiloga la conversazione durante una [compattazione](/docs/it/prompt-caching#compacting-the-conversation). Il valore dice cosa l'ha attivata: `auto` quando la finestra di contesto si avvicinava alla capacità, `manual` per `/compact`, o `reactive` quando l'API ha rifiutato una richiesta come troppo lunga. Assente su ogni altra richiesta |171| `x-claude-code-compaction` | Presente sulla richiesta che riepiloga la conversazione durante una [compattazione](/docs/it/prompt-caching#compacting-the-conversation). Il valore dice cosa l'ha attivata: `auto` quando la finestra di contesto si avvicinava alla capacità, `manual` per `/compact`, o `reactive` quando l'API ha rifiutato una richiesta come troppo lunga. Assente su ogni altra richiesta |

168| `x-claude-code-context-compacted` | Presente una volta, sulla prima richiesta di conversazione principale dopo una compattazione, con gli stessi valori di `x-claude-code-compaction`. Il prefisso della conversazione prima di questa richiesta non viene più utilizzato, quindi una cache basata su di esso può essere eliminata |172| `x-claude-code-context-compacted` | Presente una volta, sulla prima richiesta di conversazione principale dopo una compattazione, con gli stessi valori di `x-claude-code-compaction`. Il prefisso della conversazione prima di questa richiesta non viene più utilizzato, quindi una cache basata su di esso può essere eliminata |

169| `x-claude-code-prev-tool-durations` | Tempo di esecuzione misurato delle chiamate di strumento i cui risultati questa richiesta porta, come `<name>=<ms>;<name>=<ms>`, ad esempio `Bash=742;Read=9`. Inviato sulla richiesta successiva della stessa conversazione dopo un batch di chiamate di strumento, dalla sessione principale o da un subagent |173| `x-claude-code-prev-tool-durations` | Tempo di esecuzione misurato delle chiamate di strumento i cui risultati questa richiesta porta, come `<name>=<ms>;<name>=<ms>`, ad esempio `Bash=742;Read=9`. Inviato sulla richiesta successiva della stessa conversazione dopo un batch di chiamate di strumento, dalla sessione principale o da un subagent |

174| `x-claude-code-prompt-id` | UUID casuale che identifica il prompt dell'utente a cui una richiesta serve. Le richieste che servono un prompt condividono il valore, inclusi i turni dei subagent che il prompt ha avviato. Le richieste non attribuite a un prompt lo omettono. Usarlo per raggruppare le richieste di una sessione per prompt. Richiede Claude Code v2.1.283 o successivo |

170 175

171Prima di analizzare `x-claude-code-prev-tool-durations`, controllare come Claude Code costruisce il valore e cosa lascia fuori:176Prima di analizzare `x-claude-code-prev-tool-durations`, controllare come Claude Code costruisce il valore e cosa lascia fuori:

172 177

265 Disabilitare le capacità pre-release270 Disabilitare le capacità pre-release

266</h3>271</h3>

267 272

268`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` impedisce a Claude Code di inviare capacità pre-release e i loro campi del corpo su ogni provider, inclusa la gestione del contesto e i campi dello strumento beta. La variabile non influisce sul ragionamento adattivo, che è selezionato dal modello piuttosto che da beta. Non sopprime mai la capacità OAuth che l'autenticazione della sottoscrizione richiede.273`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` impedisce a Claude Code di inviare capacità pre-release e i loro campi del corpo, inclusa la gestione del contesto e i campi dello strumento beta. La variabile non influisce sul ragionamento adattivo, che è selezionato dal modello piuttosto che da beta. Non sopprime mai la capacità OAuth che l'autenticazione della sottoscrizione richiede.

274

275Quando una piattaforma host che incorpora Claude Code imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` non impedisce alle sessioni in modalità auto su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o un [gateway delle app Claude](/docs/it/claude-apps-gateway) di chiedere al server una [revisione del classificatore](/docs/it/permission-modes#server-side-classifier-review). Quella revisione aggiunge un valore `anthropic-beta` e un campo di richiesta `safeguards`. Impostare `CLAUDE_CODE_AUTO_MODE_SERVER=0` per fermarlo lì.

269 276

270Su Claude Code v2.1.227 o successivo, la vostra organizzazione può mantenere [MCP tool search](/docs/it/mcp#scale-with-mcp-tool-search) attivo sotto questa variabile attraverso [managed settings](/docs/it/managed-settings). Ciò che Claude Code invia con questo override in atto dipende da come vi connettete:277Su Claude Code v2.1.227 o successivo, la vostra organizzazione può mantenere [MCP tool search](/docs/it/mcp#scale-with-mcp-tool-search) attivo sotto questa variabile attraverso [managed settings](/docs/it/managed-settings). Ciò che Claude Code invia con questo override in atto dipende da come vi connettete:

271 278

340Un ID scoperto non ottiene la sua propria riga quando corrisponde a una riga già nel selettore:347Un ID scoperto non ottiene la sua propria riga quando corrisponde a una riga già nel selettore:

341 348

342* Stesso ID: l'ID scoperto corrisponde esattamente all'ID di una riga esistente, oppure i due ID sono ortografie della stessa versione [Fable](/docs/it/model-config#work-with-fable).349* Stesso ID: l'ID scoperto corrisponde esattamente all'ID di una riga esistente, oppure i due ID sono ortografie della stessa versione [Fable](/docs/it/model-config#work-with-fable).

343* Stesso modello di un alias integrato: quando un ID esplicito scoperto nomina il modello a cui un alias integrato attualmente si risolve, il selettore mostra solo la riga dell'alias. Ad esempio, mentre `sonnet` si risolve in `claude-sonnet-5`, un `claude-sonnet-5` scoperto si comprime nella riga `sonnet`, e un `claude-sonnet-4-6` scoperto ottiene comunque la sua propria riga. Prima della v2.1.197, Claude Code non piegava questi ID nelle righe integrate, quindi `claude-sonnet-5` otteneva anche la sua propria riga "From gateway".350* Stesso modello di un alias integrato: quando un ID esplicito scoperto nomina il modello a cui un alias integrato attualmente si risolve, il selettore mostra solo la riga dell'alias. Ad esempio, mentre `sonnet` si risolve in `claude-sonnet-5-5`, un `claude-sonnet-5-5` scoperto si comprime nella riga `sonnet`, e un `claude-sonnet-5` scoperto ottiene comunque la sua propria riga. Prima della v2.1.197, Claude Code non piegava questi ID nelle righe integrate, quindi l'ID a cui un alias si risolveva otteneva anche la sua propria riga "From gateway".

344 351

345I risultati vengono memorizzati nella cache in `~/.claude/cache/gateway-models.json`, o `%USERPROFILE%\.claude\cache\gateway-models.json` su Windows, e aggiornati ad ogni avvio. Se impostate [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars), la cache si trova invece in quella directory. Se la richiesta fallisce o il gateway non implementa `/v1/models`, il selettore ricade all'elenco memorizzato nella cache dall'avvio precedente o all'elenco dei modelli integrati. Se il vostro gateway serve modelli Claude con alias che non corrispondono al filtro di scoperta, gli sviluppatori possono aggiungere quegli alias manualmente con le [variabili di configurazione del modello](/docs/it/model-config).352I risultati vengono memorizzati nella cache in `~/.claude/cache/gateway-models.json`, o `%USERPROFILE%\.claude\cache\gateway-models.json` su Windows, e aggiornati ad ogni avvio. Se impostate [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars), la cache si trova invece in quella directory. Se la richiesta fallisce o il gateway non implementa `/v1/models`, il selettore ricade all'elenco memorizzato nella cache dall'avvio precedente o all'elenco dei modelli integrati. Se il vostro gateway serve modelli Claude con alias che non corrispondono al filtro di scoperta, gli sviluppatori possono aggiungere quegli alias manualmente con le [variabili di configurazione del modello](/docs/it/model-config).

346 353

llm-gateway-rollout.md +1 −1

Details

208 208

209Aggiungete le variabili condizionali dalla tabella allo stesso blocco `env`. Un `ANTHROPIC_BASE_URL` gestito è applicato e non può essere sovrascritto da un'esportazione di shell di uno sviluppatore, poiché Claude Code lo applica sopra l'ambiente del processo e le impostazioni di priorità inferiore.209Aggiungete le variabili condizionali dalla tabella allo stesso blocco `env`. Un `ANTHROPIC_BASE_URL` gestito è applicato e non può essere sovrascritto da un'esportazione di shell di uno sviluppatore, poiché Claude Code lo applica sopra l'ambiente del processo e le impostazioni di priorità inferiore.

210 210

211Non includete `forceLoginMethod` o `forceLoginOrgUUID` nelle impostazioni gestite insieme a una credenziale gateway. Una delle due chiavi, con qualsiasi valore, blocca `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` e `apiKeyHelper` all'avvio, e gli sviluppatori non possono procedere. Vedono `This machine's managed settings require a first-party login`, o [`Administrator policy requires a Cloud gateway sign-in`](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) sotto un valore `"gateway"`.211Non includete `forceLoginMethod`, `forceLoginOrgUUID`, o `forceLoginGatewayUrl` nelle impostazioni gestite insieme a una credenziale gateway. `forceLoginMethod` o `forceLoginOrgUUID`, con qualsiasi valore, blocca `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, e `apiKeyHelper` all'avvio, e gli sviluppatori non possono procedere. Vedono `This machine's managed settings require a first-party login`, o [`Administrator policy requires a Cloud gateway sign-in`](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) quando il file imposta `forceLoginMethod` a `"gateway"` o imposta `forceLoginGatewayUrl`.

212 212

213La consegna di [impostazioni gestite dal server](/docs/it/server-managed-settings#platform-availability) richiede una connessione diretta a `api.anthropic.com`, quindi non raggiunge le sessioni instradate dal gateway. Le distribuzioni gateway utilizzano questo percorso di impostazioni gestite basato su file, che applica le stesse chiavi.213La consegna di [impostazioni gestite dal server](/docs/it/server-managed-settings#platform-availability) richiede una connessione diretta a `api.anthropic.com`, quindi non raggiunge le sessioni instradate dal gateway. Le distribuzioni gateway utilizzano questo percorso di impostazioni gestite basato su file, che applica le stesse chiavi.

214 214

managed-mcp.md +1 −1

Details

526 Monitorare l'utilizzo di MCP526 Monitorare l'utilizzo di MCP

527</h2>527</h2>

528 528

529Quando [l'esportazione OpenTelemetry](/docs/it/monitoring-usage) è configurata, Claude Code può registrare quali server MCP e strumenti gli utenti invocano. Impostate `OTEL_LOG_TOOL_DETAILS=1` per includere i nomi dei server MCP e degli strumenti negli eventi degli strumenti, quindi aggregateli nel vostro collector per vedere quali server i vostri utenti effettivamente connettono. Vedere [Monitoraggio](/docs/it/monitoring-usage) per configurare l'esportatore e per lo schema completo degli eventi.529Quando configurate [l'esportazione OpenTelemetry](/docs/it/monitoring-usage), Claude Code può registrare quali server MCP e strumenti gli utenti invocano. Impostate `OTEL_LOG_TOOL_DETAILS=1` per includere i nomi dei server MCP e degli strumenti negli eventi degli strumenti e nei [contatori di costi e token](/docs/it/monitoring-usage#cost-counter), quindi aggregateli nel vostro collector per vedere quali server i vostri utenti effettivamente connettono. Vedere [Monitoraggio](/docs/it/monitoring-usage) per configurare l'esportatore e per lo schema completo degli eventi.

530 530

531<h2 id="configuration-summary">531<h2 id="configuration-summary">

532 Riepilogo della configurazione532 Riepilogo della configurazione

managed-settings.md +86 −51

Details

75| [Server-managed settings](/docs/it/server-managed-settings) | Nella console admin claude.ai, o su un [Claude apps gateway](/docs/it/claude-apps-gateway) auto-ospitato | Recuperato all'avvio e sottoposto a polling ogni ora; vedi [changes that need approval](#where-and-when-a-policy-applies) | Vuoi un posto per cambiare la policy per un'organizzazione claude.ai senza toccare ogni macchina |75| [Server-managed settings](/docs/it/server-managed-settings) | Nella console admin claude.ai, o su un [Claude apps gateway](/docs/it/claude-apps-gateway) auto-ospitato | Recuperato all'avvio e sottoposto a polling ogni ora; vedi [changes that need approval](#where-and-when-a-policy-applies) | Vuoi un posto per cambiare la policy per un'organizzazione claude.ai senza toccare ogni macchina |

76| MDM o policy a livello di sistema operativo | Come profilo di configurazione macOS o valore di registro Windows `HKLM`, tramite Jamf, Intune, Group Policy, o uno strumento simile; vedi [where each mechanism stores the policy](#where-each-mechanism-stores-the-policy) | Letto all'avvio e controllato per modifiche ogni 30 minuti | Gestisci già i dispositivi con MDM o Group Policy |76| MDM o policy a livello di sistema operativo | Come profilo di configurazione macOS o valore di registro Windows `HKLM`, tramite Jamf, Intune, Group Policy, o uno strumento simile; vedi [where each mechanism stores the policy](#where-each-mechanism-stores-the-policy) | Letto all'avvio e controllato per modifiche ogni 30 minuti | Gestisci già i dispositivi con MDM o Group Policy |

77| Basato su file | Come `managed-settings.json` in una directory di sistema su ogni macchina; vedi [where each mechanism stores the policy](#where-each-mechanism-stores-the-policy) | Letto all'avvio e ricaricato quando un file cambia | Macchine senza MDM, host Linux, o immagini che costruisci tu stesso |77| Basato su file | Come `managed-settings.json` in una directory di sistema su ogni macchina; vedi [where each mechanism stores the policy](#where-each-mechanism-stores-the-policy) | Letto all'avvio e ricaricato quando un file cambia | Macchine senza MDM, host Linux, o immagini che costruisci tu stesso |

78| HKCU registry, Windows e WSL | Come valore di registro Windows `HKCU`; vedi [where each mechanism stores the policy](#where-each-mechanism-stores-the-policy) | Letto all'avvio e controllato per modifiche ogni 30 minuti; Claude Code lo usa solo quando nessun'altra fonte gestita distribuisce una chiave di policy e nessuna [host-supplied parent settings](#let-an-embedding-host-add-policy) fornisce una chiave restrittiva | Non puoi scrivere la chiave a livello di macchina `HKLM` |78| HKCU registry, Windows e WSL | Come valore di registro Windows `HKCU`; vedi [where each mechanism stores the policy](#where-each-mechanism-stores-the-policy) | Letto all'avvio e controllato per modifiche ogni 30 minuti; Claude Code lo usa solo quando [nessun documento admin è presente sopra di esso](#present-admin-documents) e nessuna [host-supplied parent settings](#let-an-embedding-host-add-policy) fornisce una chiave restrittiva | Non puoi scrivere la chiave a livello di macchina `HKLM` |

79 79

80I modelli di avvio per Jamf, Iru, Intune e Group Policy si trovano nel [MDM examples repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm).80I modelli di avvio per Jamf, Iru, Intune e Group Policy si trovano nel [MDM examples repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm).

81 81

141 Come Claude Code combina le fonti gestite141 Come Claude Code combina le fonti gestite

142</h2>142</h2>

143 143

144Quando la vostra organizzazione fornisce più di una fonte gestita alla stessa macchina, la chiave [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) decide cosa Claude Code fa con le altre:144Quando la tua organizzazione fornisce più di una fonte gestita alla stessa macchina, la chiave [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) decide cosa Claude Code fa con le altre:

145 145

146* **`"first-wins"`, l'impostazione predefinita**: Claude Code utilizza la fonte con il ranking più alto che fornisce almeno una chiave di policy e ignora il resto piuttosto che unirle, a parte le chiavi in [Chiavi lette da ogni fonte admin](#keys-read-from-every-admin-source). Claude Code non mostra alcun avviso per le fonti che salta; `/status` [nomina la fonte che ha utilizzato e quelle che ha saltato](#read-the-source-in-/status).146* **`"first-wins"`, l'impostazione predefinita**: Claude Code utilizza la fonte con il ranking più alto che fornisce almeno una chiave di policy e ignora il resto piuttosto che unirle, a parte le chiavi in [Chiavi lette da ogni fonte admin](#keys-read-from-every-admin-source). Claude Code non mostra alcun avviso per le fonti che salta; `/status` [nomina la fonte che ha utilizzato e quelle che ha saltato](#read-the-source-in-/status).

147* **`"merge"`**: Claude Code applica ogni fonte admin che fornisce una chiave di policy e le combina per tipo di chiave: sulla maggior parte delle chiavi il valore della fonte con ranking più alto si applica, gli elenchi si uniscono e i blocchi assumono il valore più restrittivo. [Componi ogni fonte gestita](#compose-every-managed-source) dice dove impostare la chiave e come ogni tipo di chiave si combina. Richiede Claude Code v2.1.242 o successivo.147* **`"merge"`**: Claude Code applica ogni fonte admin che fornisce una chiave di policy e le combina per tipo di chiave: sulla maggior parte delle chiavi il valore della fonte con ranking più alto si applica, gli elenchi si uniscono e i blocchi prendono il valore più restrittivo. [Componi ogni fonte gestita](#compose-every-managed-source) dice dove impostare la chiave e come ogni tipo di chiave si combina. Richiede Claude Code v2.1.242 o successivo.

148 148

149Entrambe le impostazioni classificano le fonti nello stesso modo. Questi termini ricorrono in questa sezione:149Entrambe le impostazioni classificano le fonti nello stesso modo. Questi termini ricorrono in questa sezione:

150 150

153 153

154Claude Code controlla le fonti in questo ordine, dalla priorità più alta alla più bassa:154Claude Code controlla le fonti in questo ordine, dalla priorità più alta alla più bassa:

155 155

1561. Impostazioni remote, fornite da claude.ai come [impostazioni gestite dal server](/docs/it/server-managed-settings) o da un [gateway di app Claude](/docs/it/claude-apps-gateway). Claude Code recupera questa fonte solo quando la sessione si autentica direttamente all'API di Anthropic con un [accesso o una chiave idonei](/docs/it/server-managed-settings#platform-availability), o accede a un gateway con `/login`. Su altri provider, o quando `ANTHROPIC_BASE_URL` punta da qualche parte diversa dall'API di Anthropic, inizia dalla fonte successiva1561. Impostazioni remote, fornite da claude.ai come [impostazioni gestite dal server](/docs/it/server-managed-settings) o da un [gateway di app Claude](/docs/it/claude-apps-gateway). Claude Code recupera questa fonte solo quando la sessione si autentica direttamente all'API di Anthropic con un [login o chiave idonei](/docs/it/server-managed-settings#platform-availability), o accede a un gateway con `/login`. Su altri provider, o quando `ANTHROPIC_BASE_URL` punta da qualche parte diversa dall'API di Anthropic, inizia dalla fonte successiva

1572. Policy MDM o a livello di sistema operativo: la plist di macOS o la chiave del registro HKLM1572. Policy MDM o a livello di OS: la plist di macOS o la chiave del registro HKLM

1583. File di impostazioni gestite, `managed-settings.d/*.json` e `managed-settings.json` uniti insieme1583. File di impostazioni gestite, `managed-settings.d/*.json` e `managed-settings.json` uniti insieme

1594. Il registro HKCU, su Windows, e su WSL una volta che il registro HKLM o il file di impostazioni gestite di Windows attiva [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) e il valore HKCU lo imposta anche. Claude Code lo legge solo quando nessuna fonte sopra di esso fornisce una chiave di policy e nessuna [impostazione padre fornita dall'host](#let-an-embedding-host-add-policy) fornisce una chiave restrittiva1594. Il registro HKCU, su Windows, e su WSL una volta che il registro HKLM o il file di impostazioni gestite di Windows attiva [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) e il valore HKCU lo imposta anche. Claude Code lo legge solo quando nessun documento admin è presente sopra di esso e nessuna [impostazione padre fornita dall'host](#let-an-embedding-host-add-policy) fornisce una chiave restrittiva

160 160

161Questo diagramma mostra la classificazione, con esempi delle chiavi cross-source che Claude Code legge dalle prime tre fonti con entrambe le impostazioni:161<span id="present-admin-documents" />

162

163Claude Code non applica mai il registro HKCU scrivibile dall'utente sotto un documento admin che è presente. Un documento è presente quando imposta qualsiasi chiave di policy su un valore diverso da `null`, anche un valore che Claude Code non può leggere. Un valore HKLM, un file di impostazioni gestite, o una directory `managed-settings.d` che esiste ma non può essere letta è presente anche. Su WSL, `/etc/claude-code` è scrivibile dall'utente anche, e la voce [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) dice quando i documenti Windows stanno sopra di esso.

164

165Questo diagramma mostra la classificazione, con esempi delle chiavi cross-source che Claude Code legge dalle prime tre fonti in entrambe le impostazioni:

162 166

163<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=53f6be49f06eff48e01422c8ae1bc2e6" className="dark:hidden" alt="Diagram showing the four managed settings sources ranked from remote settings at the top through MDM, managed settings files, and the HKCU registry at the bottom. By default the first source with a policy key supplies the policy and the rest are skipped; with managedSourcesBehavior set to merge, every admin source with a policy key contributes, combined by kind of key, and the HKCU registry stays out. A side panel shows that cross-source keys such as the sandbox locks, forceRemoteSettingsRefresh, and the per-variable env merge are read from every admin source, which excludes the HKCU registry." width="680" height="330" data-path="images/managed-source-precedence.svg" />167<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=53f6be49f06eff48e01422c8ae1bc2e6" className="dark:hidden" alt="Diagram showing the four managed settings sources ranked from remote settings at the top through MDM, managed settings files, and the HKCU registry at the bottom. By default the first source with a policy key supplies the policy and the rest are skipped; with managedSourcesBehavior set to merge, every admin source with a policy key contributes, combined by kind of key, and the HKCU registry stays out. A side panel shows that cross-source keys such as the sandbox locks, forceRemoteSettingsRefresh, and the per-variable env merge are read from every admin source, which excludes the HKCU registry." width="680" height="330" data-path="images/managed-source-precedence.svg" />

164 168

174 178

175Le chiavi cross-source includono:179Le chiavi cross-source includono:

176 180

177* `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`: un `true` in qualsiasi fonte admin attiva il blocco. Mentre un blocco è attivo, Claude Code unisce l'elenco di autorizzazione che blocca, `sandbox.network.allowedDomains` insieme alle regole di autorizzazione `WebFetch(domain:...)`, o `sandbox.filesystem.allowRead`, su ogni fonte admin. Senza il blocco, Claude Code tratta l'elenco di autorizzazione come qualsiasi altra chiave, quindi sotto `"first-wins"` l'elenco di autorizzazione di una fonte admin non selezionata viene ignorato181* `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`: un `true` in qualsiasi fonte admin attiva il blocco. Mentre un blocco è attivo, Claude Code unisce l'allowlist che blocca, `sandbox.network.allowedDomains` insieme alle regole di autorizzazione `WebFetch(domain:...)`, o `sandbox.filesystem.allowRead`, attraverso ogni fonte admin. Senza il blocco, Claude Code tratta l'allowlist come qualsiasi altra chiave, quindi sotto `"first-wins"` l'allowlist di una fonte admin non selezionata viene ignorata

178* `allowAllClaudeAiMcps`182* `allowAllClaudeAiMcps`

179* `allowManagedMcpServersOnly`: un `true` in qualsiasi fonte admin attiva il blocco dell'elenco di autorizzazione MCP. Mentre il blocco è attivo, l'elenco `allowedMcpServers` gestito proviene dalla fonte admin con ranking più alto che ne imposta uno. Un elenco gestito dal server sostituisce l'elenco di una fonte inferiore piuttosto che combinarsi con esso.183* `allowManagedMcpServersOnly`: un `true` in qualsiasi fonte admin attiva il blocco dell'allowlist MCP. Mentre il blocco è attivo, l'elenco `allowedMcpServers` gestito proviene dalla fonte admin con ranking più alto che ne imposta uno. Un elenco gestito dal server sostituisce l'elenco di una fonte inferiore piuttosto che combinarsi con esso.

180 184

181 Se nessuna fonte admin imposta un elenco, ogni server che supera l'elenco di negazione si carica, a meno che [le impostazioni padre](#let-an-embedding-host-add-policy) forniscano un elenco.185 Se nessuna fonte admin imposta un elenco, ogni server che supera la denylist si carica, a meno che [le impostazioni padre](#let-an-embedding-host-add-policy) forniscano un elenco.

182 186

183 Senza il blocco, Claude Code legge `allowedMcpServers` dalla fonte gestita che applica, quindi sotto `"first-wins"` l'elenco di una fonte admin non selezionata viene ignorato. Richiede Claude Code v2.1.273 o successivo187 Senza il blocco, Claude Code legge `allowedMcpServers` dalla fonte gestita che applica, quindi sotto `"first-wins"` l'elenco di una fonte admin non selezionata viene ignorato. Richiede Claude Code v2.1.273 o successivo

184* `deniedMcpServers` e [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors): una voce o un `true` in qualsiasi fonte admin si applica. Richiede Claude Code v2.1.273 o successivo188* `deniedMcpServers` e [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors): una voce o un `true` in qualsiasi fonte admin si applica. Richiede Claude Code v2.1.273 o successivo

186* Il binario sandbox `ripgrep`, [`sandbox.ripgrep`](/docs/it/settings-reference#sandbox-ripgrep)190* Il binario sandbox `ripgrep`, [`sandbox.ripgrep`](/docs/it/settings-reference#sandbox-ripgrep)

187* `sandbox.filesystem.disabled` e `sandbox.network.strictAllowlist`191* `sandbox.filesystem.disabled` e `sandbox.network.strictAllowlist`

188* [`useAutoModeDuringPlan`](/docs/it/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](/docs/it/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](/docs/it/settings-reference#syncclaudeaiplugins), dove un `false` da qualsiasi fonte admin disattiva il comportamento. Un `false` nelle impostazioni utente o locali dello sviluppatore lo disattiva anche; ogni chiave può solo negare192* [`useAutoModeDuringPlan`](/docs/it/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](/docs/it/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](/docs/it/settings-reference#syncclaudeaiplugins), dove un `false` da qualsiasi fonte admin disattiva il comportamento. Un `false` nelle impostazioni utente o locali dello sviluppatore lo disattiva anche; ogni chiave può solo negare

189* [`enableArtifact`](/docs/it/settings-reference#enableartifact), dove un `false` da qualsiasi fonte admin disattiva lo [strumento Artifact](/docs/it/artifacts). Un `false` nelle impostazioni utente, progetto o locali dello sviluppatore lo disattiva anche, e nessuna fonte lo riattiva; vedere [quali valori di livello inferiore contano ancora](/docs/it/settings#exceptions-to-managed-settings-precedence). Richiede Claude Code v2.1.242 o successivo193* [`enableArtifact`](/docs/it/settings-reference#enableartifact), dove un `false` da qualsiasi fonte admin disattiva lo [strumento Artifact](/docs/it/artifacts). Un `false` nelle impostazioni utente, progetto o locali dello sviluppatore lo disattiva anche, e nessuna fonte lo riattiva; vedi [quali valori di livello inferiore contano ancora](/docs/it/settings#exceptions-to-managed-settings-precedence). Richiede Claude Code v2.1.242 o successivo

190* [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel), dove il limite più basso in qualsiasi fonte admin si applica. Se uno sviluppatore imposta un limite più basso nelle proprie impostazioni o con `--settings`, Claude Code applica quello; nessuna fonte può aumentare il limite. Richiede Claude Code v2.1.267 o successivo194* [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel), dove il limite più basso in qualsiasi fonte admin si applica. Se uno sviluppatore imposta un limite più basso nelle proprie impostazioni o con `--settings`, Claude Code applica quello; nessuna fonte può aumentare il limite. Richiede Claude Code v2.1.267 o successivo

191* Un opt-out del trailer di commit in `attribution`, o nel deprecato `includeCoAuthoredBy`, da qualsiasi livello195* Un opt-out del trailer di commit in `attribution`, o nel deprecato `includeCoAuthoredBy`, da qualsiasi livello

192* [`forceRemoteSettingsRefresh`](/docs/it/server-managed-settings)196* [`forceRemoteSettingsRefresh`](/docs/it/server-managed-settings)

193* `env`, unito per variabile su tutte le fonti admin: ogni variabile proviene dalla fonte con priorità più alta che la definisce, quindi le fonti inferiori riempiono le variabili che quelle superiori lasciano non impostate. Alcune variabili seguono le proprie regole; [Eccezioni per chiave su fonti gestite](/docs/it/server-managed-settings#per-key-exceptions-across-managed-sources) nomina ognuna. Richiede Claude Code v2.1.223 o successivo. Prima della v2.1.223, Claude Code applicava solo l'intero blocco `env` della fonte selezionata197* `env`, unito per variabile attraverso le fonti admin: ogni variabile proviene dalla fonte con priorità più alta che la definisce, quindi le fonti inferiori riempiono le variabili che quelle superiori lasciano non impostate. Alcune variabili seguono le proprie regole; [Eccezioni per chiave attraverso le fonti gestite](/docs/it/server-managed-settings#per-key-exceptions-across-managed-sources) nomina ognuna. Richiede Claude Code v2.1.223 o successivo. Prima della v2.1.223, Claude Code applicava solo l'intero blocco `env` della fonte selezionata

194 198

195Le [chiavi di accesso al gateway](#choose-a-delivery-mechanism) seguono una regola separata. Claude Code non le legge mai dalle impostazioni gestite dal server, quindi mentre le impostazioni gestite dal server sono la fonte selezionata, la fonte admin con ranking più alto sulla macchina che porta una chiave di policy le fornisce comunque. Un valore in una fonte admin classificata al di sotto di quella, o nel registro HKCU, viene ignorato.199Le [chiavi di accesso al gateway](#choose-a-delivery-mechanism) seguono una regola separata. Claude Code non le legge mai dalle impostazioni gestite dal server, quindi mentre le impostazioni gestite dal server sono la fonte selezionata, la fonte admin con ranking più alto sulla macchina che porta una chiave di policy le fornisce comunque. Un valore in una fonte admin classificata al di sotto di quella, o nel registro HKCU, viene ignorato.

196 200

200 Componi ogni fonte gestita204 Componi ogni fonte gestita

201</h3>205</h3>

202 206

203Per fare in modo che Claude Code applichi ogni fonte admin che la vostra organizzazione fornisce, impostare [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) su `"merge"` nella fonte con ranking più alto che distribuite. Claude Code legge la chiave solo dalla fonte con ranking più alto che porta la chiave o una chiave di policy, quindi una fonte inferiore non può optare per l'unione con la fonte sopra di essa, e una macchina che non riceve mai impostazioni gestite dal server ha bisogno della chiave anche nel suo profilo MDM. Il registro HKCU scrivibile dall'utente non si unisce mai con un'altra fonte. Richiede Claude Code v2.1.242 o successivo.207Per fare in modo che Claude Code applichi ogni fonte admin che la tua organizzazione fornisce, imposta [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) su `"merge"` nella fonte con ranking più alto che distribuisci. Claude Code legge la chiave solo dalla fonte con ranking più alto che porta la chiave o una chiave di policy, quindi una fonte inferiore non può optare per l'unione con la fonte sopra di essa, e una macchina che non riceve mai impostazioni gestite dal server ha bisogno della chiave anche nel suo profilo MDM. Il registro HKCU scrivibile dall'utente non si unisce mai con un'altra fonte. Richiede Claude Code v2.1.242 o successivo.

204 208

205Sotto `"merge"`, Claude Code aggiunge le voci dell'elenco di una fonte inferiore, come le regole `permissions.allow` e gli hooks, alla policy, quindi attivarlo solo quando ogni fonte classificata al di sotto di quella più alta è sotto il controllo di un amministratore.209Sotto `"merge"`, Claude Code aggiunge le voci di elenco di una fonte inferiore, come le regole `permissions.allow` e gli hook, alla policy, quindi attivalo solo quando ogni fonte classificata al di sotto di quella più alta è sotto il controllo di un amministratore.

206 210

207Questa tabella mostra come Claude Code combina ogni tipo di chiave sotto `"merge"`. La [voce `managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) nomina ogni chiave in tre delle righe: elenchi di autorizzazione restrittivi, valori presi nel complesso e chiavi lette solo dalla fonte con ranking più alto.211Questa tabella mostra come Claude Code combina ogni tipo di chiave sotto `"merge"`. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) nomina ogni chiave in tre delle righe: allowlist di restrizione, valori presi interi e chiavi lette solo dalla fonte con ranking più alto.

208 212

210| :- | :- | :- |214| :- | :- | :- |

212| Blocchi | Applica il valore più restrittivo che qualsiasi fonte imposta; un valore meno restrittivo si applica solo dalla fonte con ranking più alto | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound` |216| Blocchi | Applica il valore più restrittivo che qualsiasi fonte imposta; un valore più permissivo si applica solo dalla fonte con ranking più alto | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound`, `availableModelsMatch` |

213| Elenchi di autorizzazione restrittivi | Prende l'elenco nel complesso dalla fonte con ranking più alto che lo imposta, senza aggiungere voci da fonti inferiori | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins`, e la catena `fallbackModel` |217| Allowlist di restrizione | Prende l'elenco intero dalla fonte con ranking più alto che lo imposta, senza aggiungere voci da fonti inferiori | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins`, e la catena `fallbackModel` |

214| Valori presi nel complesso | Prende il valore nel complesso dalla fonte con ranking più alto che lo imposta, senza combinare voci o campi da fonti inferiori | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |218| Valori presi interi | Prende il valore intero dalla fonte con ranking più alto che lo imposta, senza combinare voci o campi da fonti inferiori | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |

215| Server MCP forniti | Combina i nomi dei server da ogni fonte; quando due fonti impostano lo stesso nome, applica l'intera voce della fonte con ranking più alto | `managedMcpServers` |219| Server MCP forniti | Combina i nomi dei server da ogni fonte; quando due fonti impostano lo stesso nome, applica la voce intera della fonte con ranking più alto | `managedMcpServers` |

216| Chiavi lette solo dalla fonte con ranking più alto | Ignora la chiave in ogni fonte inferiore, anche quando la fonte con ranking più alto la lascia non impostata | Helper di credenziali come `apiKeyHelper`, pin di accesso come `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |220| Chiavi lette solo dalla fonte con ranking più alto | Ignora la chiave in ogni fonte inferiore, anche quando la fonte con ranking più alto la lascia non impostata | Helper di credenziali come `apiKeyHelper`, pin di accesso come `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |

217| `env` | Si unisce per variabile su fonti admin con entrambe le impostazioni, come [Chiavi lette da ogni fonte admin](#keys-read-from-every-admin-source) descrive | |221| `env` | Si unisce per variabile attraverso le fonti admin in entrambe le impostazioni, come [Chiavi lette da ogni fonte admin](#keys-read-from-every-admin-source) descrive | |

219 223

220Per confermare quali fonti si sono combinate su una macchina, [leggere la riga `Setting sources` in `/status`](#read-the-source-in-/status); quella sezione dice cosa significa ogni etichetta.224Per confermare quali fonti si sono combinate su una macchina, [leggi la riga `Setting sources` in `/status`](#read-the-source-in-/status); quella sezione dice cosa significa ogni etichetta.

221 225

222<h3 id="compute-the-policy-with-a-helper-program">226<h3 id="compute-the-policy-with-a-helper-program">

223 Calcola la policy con un programma helper227 Calcola la policy con un programma helper

224</h3>228</h3>

225 229

226Un [`policyHelper`](/docs/it/settings-reference#policyhelper) è un eseguibile che la vostra policy MDM o il file di impostazioni gestite nomina, e Claude Code lo esegue per calcolare le impostazioni gestite all'avvio. Quando la fonte selezionata ne configura uno e l'helper emette un oggetto `managedSettings`, quell'output cambia cosa Claude Code legge:230Un [`policyHelper`](/docs/it/settings-reference#policyhelper) è un eseguibile che la tua policy MDM o il file di impostazioni gestite nomina, e Claude Code lo esegue per calcolare le impostazioni gestite all'avvio. Quando la fonte selezionata ne configura uno e l'helper emette un oggetto `managedSettings`, quell'output cambia cosa Claude Code legge:

227 231

228* **L'oggetto `managedSettings` emesso è l'unica impostazione gestita per la sessione**, incluso per le [chiavi che altrimenti legge da ogni fonte admin](#keys-read-from-every-admin-source), a parte [`forceRemoteSettingsRefresh`, che ha la sua propria regola di avvio](/docs/it/settings-reference#forceremotesettingsrefresh)232* **L'oggetto `managedSettings` emesso è l'unica impostazione gestita per la sessione**, incluso per le [chiavi che altrimenti legge da ogni fonte admin](#keys-read-from-every-admin-source), a parte [`forceRemoteSettingsRefresh`, che ha la sua propria regola di avvio](/docs/it/settings-reference#forceremotesettingsrefresh)

229 233

230Per quali esecuzioni di helper falliscono, e cosa Claude Code fa quando una lo fa, vedere [Errori dell'helper](/docs/it/settings-reference#helper-failures).234Per quali esecuzioni di helper falliscono, e cosa Claude Code fa quando una lo fa, vedi [Helper failures](/docs/it/settings-reference#helper-failures).

231 235

232<span id="parent-settings-from-embedding-hosts" />236<span id="parent-settings-from-embedding-hosts" />

233 237

236<span id="merge-policy-from-an-embedding-host" />240<span id="merge-policy-from-an-embedding-host" />

237 241

238<h3 id="let-an-embedding-host-add-policy">242<h3 id="let-an-embedding-host-add-policy">

239 Lasciare che un host di embedding aggiunga policy243 Consenti a un host di embedding di aggiungere policy

240</h3>244</h3>

241 245

242Quando un'altra applicazione avvia Claude Code, come Claude Desktop, un'estensione IDE o un'app Agent SDK, quell'host può passare le proprie impostazioni gestite attraverso l'opzione SDK `managedSettings`. Claude Code chiama queste impostazioni padre.246Quando un'altra applicazione avvia Claude Code, come Claude Desktop, un'estensione IDE, o un'app Agent SDK, quell'host può passare le proprie impostazioni gestite attraverso l'opzione SDK `managedSettings`. Claude Code chiama queste impostazioni padre.

243 247

244Per impostazione predefinita, Claude Code ignora le impostazioni padre ogni volta che una fonte admin è presente: impostazioni gestite dal server, una policy MDM o a livello di sistema operativo, o un file di impostazioni gestite.248Per impostazione predefinita, Claude Code ignora le impostazioni padre ogni volta che una fonte admin è presente: impostazioni gestite dal server, una policy MDM o a livello di OS, o un file di impostazioni gestite.

245 249

246Per fare in modo che Claude Code unisca le impostazioni padre insieme a una fonte admin, impostare [`parentSettingsBehavior`](/docs/it/settings-reference#parentsettingsbehavior) su `"merge"` nella fonte gestita con priorità più alta; Claude Code legge la chiave solo da quella fonte.250Per fare in modo che Claude Code unisca le impostazioni padre insieme a una fonte admin, imposta [`parentSettingsBehavior`](/docs/it/settings-reference#parentsettingsbehavior) su `"merge"` nella fonte gestita con priorità più alta; Claude Code legge la chiave solo da quella fonte.

247 251

248Claude Code quindi mantiene solo i valori dell'host che limitano quello che Claude può fare, con un gap da conoscere: a meno che non impostiate anche i blocchi `allowManaged*Only`, le regole di autorizzazione di permesso dell'host e gli elenchi di autorizzazione sandbox si applicano comunque. Vedere [Limitare le impostazioni padre](/docs/it/claude-apps-gateway#restrict-parent-settings) per i blocchi.252Claude Code quindi mantiene solo i valori dell'host che limitano quello che Claude può fare, con un gap da conoscere: a meno che tu non imposti anche i blocchi `allowManaged*Only`, le regole di autorizzazione dell'host e gli allowlist sandbox si applicano ancora. Vedi [Limita le impostazioni padre](/docs/it/claude-apps-gateway#restrict-parent-settings) per i blocchi.

249 253

250Un [`policyHelper`](/docs/it/settings-reference#policyhelper) può disattivare l'unione padre indipendentemente da questa chiave; la sua voce dice quando.254Un [`policyHelper`](/docs/it/settings-reference#policyhelper) può disattivare l'unione padre indipendentemente da questa chiave; la sua voce dice quando.

251 255

252Claude Code applica anche questi controlli ai valori forniti dal padre da soli:256Claude Code applica anche questi controlli ai valori forniti dal padre da soli:

253 257

254* Quando qualsiasi fonte admin imposta `allowManagedPermissionRulesOnly`, Claude Code elimina le [regole di autorizzazione di permesso fornite dal padre](/docs/it/claude-apps-gateway#restrict-parent-settings) e `additionalDirectories` mentre le legge, anche quando una fonte con priorità più alta lascia la chiave non impostata. L'effetto della chiave sulle vostre proprie regole di permesso proviene dalle impostazioni gestite che Claude Code applica, o dalle impostazioni padre che avete scelto di unire258* Quando qualsiasi fonte admin imposta `allowManagedPermissionRulesOnly`, Claude Code elimina le [regole di autorizzazione fornite dal padre](/docs/it/claude-apps-gateway#restrict-parent-settings) e `additionalDirectories` mentre le legge, anche quando una fonte con priorità più alta lascia la chiave non impostata. L'effetto della chiave sulle tue stesse regole di autorizzazione proviene dalle impostazioni gestite che Claude Code applica, o dalle impostazioni padre che hai scelto di unire

255* Claude Code applica il valore `forceLoginOrgUUID` o `allowedMcpServers` nelle impostazioni gestite che applica e blocca uno fornito dal padre. Al di fuori del blocco dell'elenco di autorizzazione MCP, un valore in una fonte admin inferiore che Claude Code non applica né si applica né blocca quello del padre. Fuori dal blocco dell'elenco di autorizzazione MCP, un valore in una fonte admin inferiore che Claude Code non applica né si applica né blocca quello del padre.259* Claude Code applica il valore `forceLoginOrgUUID` o `allowedMcpServers` nelle impostazioni gestite che applica e blocca uno fornito dal padre. Al di fuori del blocco dell'allowlist MCP, un valore in una fonte admin inferiore che Claude Code non applica né si applica né blocca quello del padre.

256 260

257 Su Claude Code v2.1.273 o successivo, mentre `allowManagedMcpServersOnly` è attivo, l'elenco `allowedMcpServers` dalla fonte admin con ranking più alto che ne imposta uno si applica e blocca quello del padre, come una [chiave cross-source](#keys-read-from-every-admin-source). L'elenco del padre si applica solo quando nessuna fonte admin ne imposta uno. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte fornisce ogni chiave sotto `"merge"`. Prima della v2.1.223, un valore in qualsiasi fonte admin bloccava quello del padre261 Su Claude Code v2.1.273 o successivo, mentre `allowManagedMcpServersOnly` è attivo, l'elenco `allowedMcpServers` dalla fonte admin con ranking più alto che ne imposta uno si applica e blocca quello del padre, come una [chiave cross-source](#keys-read-from-every-admin-source). L'elenco del padre si applica solo quando nessuna fonte admin ne imposta uno. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte fornisce ogni chiave sotto `"merge"`. Prima della v2.1.223, un valore in qualsiasi fonte admin bloccava quello del padre

258* Per `availableModels`, Claude Code applica il valore nelle impostazioni gestite che applica e blocca un elenco fornito dal padre262* Per `availableModels`, Claude Code applica il valore nelle impostazioni gestite che applica e blocca un elenco fornito dal padre

259* Per `strictKnownMarketplaces`, Claude Code applica allo stesso modo l'elenco nelle impostazioni gestite che applica e blocca uno fornito dal padre. L'elenco del padre si applica solo quando nessuna fonte gestita applicata ne imposta uno. Richiede Claude Code v2.1.282 o successivo263* Per `strictKnownMarketplaces`, Claude Code allo stesso modo applica l'elenco nelle impostazioni gestite che applica e blocca uno fornito dal padre. L'elenco del padre si applica solo quando nessuna fonte gestita applicata ne imposta uno. Richiede Claude Code v2.1.282 o successivo

260* Un `blockedMarketplaces` fornito dal padre si applica in aggiunta a qualsiasi blocklist che una fonte gestita imposta. Richiede Claude Code v2.1.282 o successivo264* Un `blockedMarketplaces` fornito dal padre si applica in aggiunta a qualsiasi blocklist che una fonte gestita imposta. Richiede Claude Code v2.1.282 o successivo

261 265

262<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">266<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">

263 Mantenere l'accesso alla cartella Cowork quando si applicano solo regole gestite267 Mantieni l'accesso alla cartella Cowork quando si applicano solo regole gestite

264</h4>268</h4>

265 269

266[Cowork](https://claude.com/docs/cowork/overview) nell'app Claude Desktop esegue le sue sessioni su Claude Code e concede a ogni sessione l'accesso alle sue cartelle di lavoro, come la cartella che l'utente connette, attraverso regole di autorizzazione che fornisce quando avvia la sessione. Quando la vostra policy gestita imposta [`allowManagedPermissionRulesOnly`](/docs/it/settings-reference#allowmanagedpermissionrulesonly), Claude Code mantiene solo le regole di autorizzazione nella policy gestita: elimina le regole di autorizzazione che un host fornisce come impostazioni padre, come `--allowedTools`, o in un file di impostazioni, quindi le scritture in quelle cartelle perdono la loro pre-approvazione. In una sessione Cowork che chiede prima delle modifiche, Cowork non può mostrare il prompt, e Claude segnala ogni scrittura come bloccata perché il percorso si risolve in una posizione protetta o in un percorso al di fuori della cartella connessa.270[Cowork](https://claude.com/docs/cowork/overview) nell'app Claude Desktop esegue le sue sessioni su Claude Code e concede a ogni sessione l'accesso alle sue cartelle di lavoro, come la cartella che l'utente connette, attraverso le regole di autorizzazione che fornisce quando avvia la sessione. Quando la tua policy gestita imposta [`allowManagedPermissionRulesOnly`](/docs/it/settings-reference#allowmanagedpermissionrulesonly), Claude Code mantiene solo le regole di autorizzazione nella policy gestita: elimina le regole di autorizzazione che un host fornisce come impostazioni padre, come `--allowedTools`, o in un file di impostazioni, quindi le scritture in quelle cartelle perdono la loro pre-approvazione. In una sessione Cowork che chiede prima delle modifiche, Cowork non può mostrare il prompt, e Claude segnala ogni scrittura come bloccata perché il percorso si risolve in una posizione protetta o in un percorso al di fuori della cartella connessa.

267 271

268Per ripristinare le scritture, aggiungere regole di autorizzazione per quelle cartelle alla fonte gestita che Claude Code [seleziona](#precedence-within-the-managed-tier) su quelle macchine: su una flotta gestita da MDM, è la policy MDM piuttosto che un file di impostazioni gestite separato. Questo esempio utilizza il modulo file, e una policy MDM prende le stesse chiavi. Mantiene `allowManagedPermissionRulesOnly` impostato e consente modifiche sotto una cartella `CoworkProjects` nella directory home di ogni utente; sostituire il percorso con le cartelle che i vostri utenti connettono:272Per ripristinare le scritture, aggiungi regole di autorizzazione per quelle cartelle alla fonte gestita che Claude Code [seleziona](#precedence-within-the-managed-tier) su quelle macchine: su una flotta gestita da MDM, è la policy MDM piuttosto che un file di impostazioni gestite separato. Questo esempio utilizza il modulo file, e una policy MDM prende le stesse chiavi. Mantiene `allowManagedPermissionRulesOnly` impostato e consente le modifiche sotto una cartella `CoworkProjects` nella directory home di ogni utente; sostituisci il percorso con le cartelle che i tuoi utenti connettono:

269 273

270```json managed-settings.json theme={null}274```json managed-settings.json theme={null}

271{275{

278}282}

279```283```

280 284

281Dopo aver distribuito la policy, Claude può salvare file sotto quella cartella in una nuova sessione Cowork. [Leggere e modificare le regole](/docs/it/permissions#read-and-edit) coprono la sintassi del percorso, incluso il modulo `//` per i percorsi assoluti.285Dopo aver distribuito la policy, Claude può salvare i file sotto quella cartella in una nuova sessione Cowork. [Leggi e modifica le regole](/docs/it/permissions#read-and-edit) coprono la sintassi del percorso, incluso il modulo `//` per i percorsi assoluti.

282 286

283<h3 id="what-a-developer-can-change">287<h3 id="what-a-developer-can-change">

284 Cosa uno sviluppatore può cambiare288 Cosa uno sviluppatore può cambiare

285</h3>289</h3>

286 290

287I file di impostazioni propri di uno sviluppatore, i valori `--settings` e i file di progetto non sostituiscono mai un valore gestito; le [eccezioni](/docs/it/settings#exceptions-to-managed-settings-precedence) permettono solo a un valore di livello inferiore più restrittivo di contare. Questi casi si trovano al di fuori di quella regola:291I file di impostazioni propri di uno sviluppatore, i valori `--settings` e i file di progetto non sostituiscono mai un valore gestito; le [eccezioni](/docs/it/settings#exceptions-to-managed-settings-precedence) permettono solo a un valore di livello inferiore più restrittivo di contare. Questi casi stanno al di fuori di quella regola:

288 292

289* **Il modello per una sessione**: un `model` gestito è un predefinito, non un blocco. `--model` e `ANTHROPIC_MODEL` scelgono comunque il modello per quella sessione, quindi distribuire [`availableModels`](/docs/it/settings-reference#availablemodels) per limitare la scelta.293* **Il modello per una sessione**: un `model` gestito è un predefinito, non un blocco. `--model` e `ANTHROPIC_MODEL` scelgono ancora il modello per quella sessione, quindi distribuisci [`availableModels`](/docs/it/settings-reference#availablemodels) per limitare la scelta.

290* **Diritti admin locali**: uno sviluppatore che è un amministratore sulla macchina può modificare la fonte gestita stessa, motivo per cui gli strumenti MDM possono ridistribuire il profilo o il file su una pianificazione e motivo per cui il registro HKLM e il dominio delle preferenze gestite di macOS esistono.294* **Diritti admin locali**: uno sviluppatore che è un amministratore sulla macchina può modificare la fonte gestita stessa, motivo per cui gli strumenti MDM possono ridistribuire il profilo o il file su una pianificazione e motivo per cui il registro HKLM e il dominio delle preferenze gestite di macOS esistono.

291* **La cache gestita dal server**: le impostazioni gestite dal server provengono dai server di Anthropic, e una modifica alla cache locale [dura solo fino al prossimo recupero riuscito](/docs/it/server-managed-settings#security-considerations).295* **La cache gestita dal server**: le impostazioni gestite dal server provengono dai server di Anthropic, e una modifica alla cache locale [dura solo fino al prossimo recupero riuscito](/docs/it/server-managed-settings#security-considerations).

292* **Altri strumenti**: le impostazioni gestite vincolano solo Claude Code. Uno sviluppatore che chiama l'API da un altro strumento non è sotto di esse.296* **Altri strumenti**: le impostazioni gestite vincolano solo Claude Code. Uno sviluppatore che chiama l'API da un altro strumento non è sotto di esse.

332 Trova voci che Claude Code ha eliminato336 Trova voci che Claude Code ha eliminato

333</h3>337</h3>

334 338

335Quando un file di impostazioni gestite, un profilo MDM, un valore di registro, o un payload server-managed non supera la convalida dello schema, Claude Code prima salta le singole voci che può riparare, come una regola di autorizzazione non valida, con un avviso per ognuna, quindi elimina qualsiasi chiave di livello superiore il cui valore ancora non supera e continua a applicare ogni chiave valida rimanente.339Se il tuo file di impostazioni gestite, profilo MDM, valore di registro, o payload server-managed non supera la convalida dello schema, Claude Code prima salta le singole voci che può riparare, come una regola di autorizzazione non valida, e avvisa di ognuna. Claude Code quindi elimina qualsiasi valore che ancora non supera, a meno che il valore appartenga a una delle chiavi che [falliscono chiuse](#keys-that-fail-closed) invece.

336 340

337Claude Code è più rigoroso con il `managedSettings` che un [`policyHelper`](/docs/it/settings-reference#policyhelper) emette: fa le stesse riparazioni di voce, ma qualsiasi violazione dello schema che sopravvive fa fallire l'intera esecuzione dell'helper, e all'avvio Claude Code rifiuta di avviarsi, lo stesso che per un helper che esce con non-zero.341Claude Code è più rigoroso con il `managedSettings` che un [`policyHelper`](/docs/it/settings-reference#policyhelper) emette: fa le stesse riparazioni di voce, ma qualsiasi violazione dello schema che sopravvive fa fallire l'intera esecuzione dell'helper, e all'avvio Claude Code rifiuta di avviarsi, lo stesso che per un helper che esce con non-zero.

338 342

360 Chiavi che falliscono chiuse364 Chiavi che falliscono chiuse

361</h4>365</h4>

362 366

363Poche chiavi di applicazione non vengono eliminate quando non valide. Claude Code applica un fallback più restrittivo fino a quando il valore non viene corretto; la tabella mostra cosa applica per ogni chiave:367Quando una fonte gestita imposta una chiave di livello superiore che ha un singolo valore restrittivo, come `allowManagedPermissionRulesOnly`, `disableAutoMode`, o `skipDangerousModePermissionPrompt`, a qualcosa che Claude Code non può leggere, la chiave legge come quel valore fino a quando non lo correggi. Il rapporto dice che la chiave `was present but invalid` e nomina il valore che Claude Code la tratta come. Per una chiave all'interno di `sandbox`, vedi [Invalid values inside `sandbox`](#invalid-values-inside-sandbox).

368

369Questi casi non falliscono chiusi:

370

371* Un `null` rimuove la chiave.

372* Un `disableAllHooks` non valido, anche un booleano tra virgolette, viene eliminato con un avviso, perché applicare `true` scaricherebbe anche gli hook che le tue stesse impostazioni gestite distribuiscono.

373* Per ogni altra chiave booleana che la regola copre, la stringa `"true"` o `"false"` legge come quel booleano, con un avviso in `/status` chiedendoti di rimuovere le virgolette.

374

375Claude Code ripara i blocchi `permissions`, `autoMode`, `worktree`, e `attribution` per campo invece di eliminarli completamente:

376

377* Un lock all'interno di uno, come `permissions.disableBypassPermissionsMode`, legge come il suo valore restrittivo.

378* Un `permissions.defaultMode` non valido legge come `default`.

379* Mentre un elenco `deny` o `ask` in `permissions` non può essere letto affatto, Claude Code trattiene `allow` e `additionalDirectories`, quindi le concessioni non si applicano senza le restrizioni scritte accanto ad esse. Il rapporto nomina ogni concessione trattenuta e l'elenco che non poteva essere letto.

380* In `autoMode`, un elenco `soft_deny` o `hard_deny` che non può essere letto, o che ha perso una voce non valida, trattiene `allow` e `environment` allo stesso modo.

381

382La regola fail-closed per le chiavi con un singolo valore restrittivo e le riparazioni per campo richiedono Claude Code v2.1.282 o successivo.

383

384Queste chiavi hanno il loro proprio fallback:

364 385

365| Campo | Comportamento quando presente ma non valido |386| Campo | Comportamento quando presente ma non valido |

366| :- | :- |387| :- | :- |

369| `httpHookAllowedEnvVars` | Claude Code applica un [allowlist](/docs/it/settings-reference#httphookallowedenvvars) gestito vuoto fino a quando non correggi il valore, quindi una variabile di intestazione viene interpolata solo se un altro file di impostazioni la nomina. Se solo una voce individuale non è valida, Claude Code rimuove quella voce e applica il resto. |390| `httpHookAllowedEnvVars` | Claude Code applica un [allowlist](/docs/it/settings-reference#httphookallowedenvvars) gestito vuoto fino a quando non correggi il valore, quindi una variabile di intestazione viene interpolata solo se un altro file di impostazioni la nomina. Se solo una voce individuale non è valida, Claude Code rimuove quella voce e applica il resto. |

370| `allowedChannelPlugins` | Claude Code applica un allowlist vuoto fino a quando non correggi il valore, quindi nessun plugin di canale passato a `--channels` viene ammesso. Se solo una voce individuale non è valida, rimuove quella voce e applica il resto. |391| `allowedChannelPlugins` | Claude Code applica un allowlist vuoto fino a quando non correggi il valore, quindi nessun plugin di canale passato a `--channels` viene ammesso. Se solo una voce individuale non è valida, rimuove quella voce e applica il resto. |

371| `strictKnownMarketplaces` | Applicato come un allowlist vuoto fino a quando il valore non viene corretto, quindi nessuna [fonte marketplace](/docs/it/plugins/org#restrict-what-users-can-install) viene ammessa. Una voce individuale che non è valida o non può essere applicata, come una regex `hostPattern` che non si compila, viene rimossa e il sottoinsieme valido viene applicato. |392| `strictKnownMarketplaces` | Applicato come un allowlist vuoto fino a quando il valore non viene corretto, quindi nessuna [fonte marketplace](/docs/it/plugins/org#restrict-what-users-can-install) viene ammessa. Una voce individuale che non è valida o non può essere applicata, come una regex `hostPattern` che non si compila, viene rimossa e il sottoinsieme valido viene applicato. |

372| `allowManagedHooksOnly` | Trattato come `true` fino a quando non viene corretto: le [restrizioni hook](/docs/it/settings-reference#allowmanagedhooksonly) si applicano e, a meno che `disableCommandPluginSources` non sia esplicitamente `false`, i plugin sourced da comando sono disabilitati. |

373| `allowManagedMcpServersOnly` | Trattato come `true`. |

374| `disableCommandPluginSources` | Trattato come `true`, quindi i plugin sourced da comando rimangono disabilitati fino a quando il valore non viene corretto. |

375| `disableSideloadFlags` | Trattato come `true` fino a quando il valore non viene corretto, con gli effetti elencati per [`disableSideloadFlags`](/docs/it/settings-reference#disablesideloadflags). |

376| `availableModels` | Applicato come un allowlist vuoto fino a quando non viene corretto, quindi solo il modello Default è disponibile; una voce non stringa viene rimossa e il sottoinsieme valido viene applicato. |393| `availableModels` | Applicato come un allowlist vuoto fino a quando non viene corretto, quindi solo il modello Default è disponibile; una voce non stringa viene rimossa e il sottoinsieme valido viene applicato. |

378| `syncClaudeAiPlugins` | Trattato come `false`, quindi la sincronizzazione dei [plugin claude.ai](/docs/it/settings-reference#syncclaudeaiplugins) è disattivata fino a quando il valore non viene corretto. |

380| `gatewayInternalNetworks` | Quando il valore non valido proviene dalla fonte gestita più alta sulla macchina, `/login` rifiuta ogni nuovo accesso [cloud gateway](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) su quella macchina fino a quando il valore non viene corretto. |396| `gatewayInternalNetworks` | Quando il valore non valido proviene dalla fonte gestita più alta sulla macchina, `/login` rifiuta ogni nuovo accesso [cloud gateway](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) su quella macchina fino a quando il valore non viene corretto. |

381| `crossSessionInbound` | Trattato come `refuse`, il valore più restrittivo, quindi i [messaggi cross-session](/docs/it/cross-session-messaging#control-inbound-messages) in entrata vengono rifiutati fino a quando il valore non viene corretto. Lo sviluppatore vede [un avviso](/docs/it/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |397| `crossSessionInbound` | Trattato come `refuse`, il valore più restrittivo, quindi i [messaggi cross-session](/docs/it/cross-session-messaging#control-inbound-messages) in entrata vengono rifiutati fino a quando il valore non viene corretto. Lo sviluppatore vede [un avviso](/docs/it/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

382| `deniedMcpServers` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Un valore completamente non valido viene eliminato con un avviso, poiché negare ogni server bloccherebbe i server che la policy non ha mai nominato. |398| `deniedMcpServers` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Un valore completamente non valido viene eliminato con un avviso, poiché negare ogni server bloccherebbe i server che la policy non ha mai nominato. |

399| [`deniedModels`](/docs/it/settings-reference#deniedmodels) | Una voce non stringa viene rimossa e il resto dell'elenco viene applicato. Un valore completamente non valido viene eliminato con un avviso e non blocca alcun modello fino a quando non viene corretto. |

383| `blockedMarketplaces` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Una voce che si analizza ma non può mai corrispondere, come una regex `hostPattern` che non si compila, viene mantenuta con un avviso. Non blocca nulla fino a quando non viene corretto, ma le [restrizioni marketplace](/docs/it/plugins/org#restrict-what-users-can-install) rimangono attive. Un valore completamente non valido viene eliminato con un avviso, poiché bloccare ogni marketplace bloccherebbe le fonti che la policy non ha mai nominato. |400| `blockedMarketplaces` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Una voce che si analizza ma non può mai corrispondere, come una regex `hostPattern` che non si compila, viene mantenuta con un avviso. Non blocca nulla fino a quando non viene corretto, ma le [restrizioni marketplace](/docs/it/plugins/org#restrict-what-users-can-install) rimangono attive. Un valore completamente non valido viene eliminato con un avviso, poiché bloccare ogni marketplace bloccherebbe le fonti che la policy non ha mai nominato. |

384| `sandbox.credentials` | Una voce non valida recuperabile viene degradata a `mode: "deny"` con un avviso; una non recuperabile viene rimossa; le voci valide rimangono applicate. Vedi [invalid credential entries](/docs/it/settings-reference#invalid-credential-entries-in-managed-settings) |401| `sandbox` | Quando un valore all'interno del blocco non è valido, Claude Code non elimina l'intero blocco. Per quello che accade a ogni tipo di campo non valido, vedi [Invalid values inside `sandbox`](#invalid-values-inside-sandbox). |

402| `sandbox.credentials` | Una voce non valida recuperabile viene degradata a `mode: "deny"` con un avviso; una non recuperabile viene rimossa; le voci valide rimangono applicate. Vedi [invalid credential entries](/docs/it/settings-reference#invalid-credential-entries-in-managed-settings). |

403| `strictPluginOnlyCustomization` | Trattato come `true`, bloccando tutte e quattro le superfici, quando il valore non è né un booleano né un array. Una voce di array che questa versione non riconosce come una superficie non blocca nulla; una nota di stato conta tali voci in modo che tu possa controllarle per errori di battitura. |

404| `enabledPlugins` | Una voce non valida viene eliminata con un avviso e le altre voci rimangono applicate. Un valore che non è una mappa di ID plugin, o il cui ogni voce non è valida, viene eliminato completamente con un avviso. |

385 405

386`allowedHttpHookUrls` e `httpHookAllowedEnvVars` si uniscono tra i file di impostazioni, quindi le voci nelle tue impostazioni utente, progetto o locale si applicano ancora mentre l'elenco gestito è vuoto.406`allowedHttpHookUrls` e `httpHookAllowedEnvVars` si uniscono tra i file di impostazioni, quindi le voci nelle tue impostazioni utente, progetto o locale si applicano ancora mentre l'elenco gestito è vuoto.

387 407

388I fallback per queste due chiavi e per `allowedChannelPlugins` richiedono Claude Code v2.1.267 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictKnownMarketplaces`, `blockedMarketplaces`, e `disableSideloadFlags` richiedono Claude Code v2.1.277 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida.408I fallback per queste due chiavi e per `allowedChannelPlugins` richiedono Claude Code v2.1.267 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictKnownMarketplaces` e `blockedMarketplaces` richiedono Claude Code v2.1.277 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictPluginOnlyCustomization` e `enabledPlugins` richiedono Claude Code v2.1.282 o successivo.

389 409

390`requiredMinimumVersion` e `requiredMaximumVersion` falliscono aperti per design: un valore non valido viene eliminato piuttosto che applicato.410`requiredMinimumVersion` e `requiredMaximumVersion` falliscono aperti per design: un valore non valido viene eliminato piuttosto che applicato.

391 411

392Questa tolleranza si applica solo alle impostazioni gestite. I file di impostazioni utente, progetto e locale rimangono rigorosi: un file il cui JSON o forma di livello superiore non supera la convalida viene rifiutato completamente e segnalato, e una voce individuale che fallisce, come una regola di autorizzazione malformata, viene saltata con un avviso mentre il resto del file si applica.412Questa tolleranza si applica solo alle impostazioni gestite. I file di impostazioni utente, progetto e locale rimangono rigorosi: un file il cui JSON o forma di livello superiore non supera la convalida viene rifiutato completamente e segnalato, e una voce individuale che fallisce, come una regola di autorizzazione malformata, viene saltata con un avviso mentre il resto del file si applica.

393 413

414<h4 id="invalid-values-inside-sandbox">

415 Invalid values inside `sandbox`

416</h4>

417

418Quando un valore nel tuo blocco `sandbox` gestito non è valido, Claude Code non elimina l'intero blocco, perché convalida ogni campo per conto suo. Questo trattamento per campo richiede Claude Code v2.1.283 o successivo. Nelle versioni precedenti a v2.1.283, Claude Code elimina ogni campo `sandbox` tranne [`credentials`](/docs/it/settings-reference#invalid-credential-entries-in-managed-settings) quando un valore al di fuori di `credentials` non è valido.

419

420L'avviso che ricevi per un campo non valido nomina il campo e ti dice cosa accade ad esso. Quello che accade dipende da cosa controlla il campo:

421

422* Se imposti una chiave booleana su un `"true"` o `"false"` tra virgolette, il valore conta come quel booleano. Invece di un avviso, `/status` mostra un avviso chiedendoti di rimuovere le virgolette.

423* Se `failIfUnavailable` non è valido, Claude Code elimina il valore piuttosto che trattarlo come `true`, quindi un valore illeggibile non ferma mai le sessioni dall'avviarsi in tutta la tua flotta.

424* Claude Code tratta ogni altro booleano non valido come il valore che mantiene la sandbox più rigorosa fino a quando non lo correggi. Una chiave che attiva la sandbox o una delle sue restrizioni, come `enabled` o `network.allowManagedDomainsOnly`, conta come `true`. Una chiave che la allenta, come `allowUnsandboxedCommands`, conta come `false`.

425* In un elenco al di fuori di `credentials`, come `excludedCommands` o `network.allowedDomains`, Claude Code elimina una voce non valida e mantiene il resto dell'elenco. Un elenco che non è un array, o che non ha alcuna voce valida, non si applica affatto.

426* Mentre `network.deniedDomains` o qualsiasi voce in esso non è valido, Claude Code inoltre trattiene `network.allowedDomains`, quindi l'allowlist gestito non concede nulla fino a quando non correggi l'elenco di negazione.

427* Mentre `filesystem.denyRead`, `filesystem.denyWrite`, o qualsiasi voce in uno di essi non è valido, Claude Code inoltre trattiene sia `filesystem.allowRead` che `filesystem.allowWrite` fino a quando non correggi l'elenco di negazione.

428

394<span id="managed-only-settings" />429<span id="managed-only-settings" />

395 430

396<h2 id="keys-only-a-managed-source-can-set">431<h2 id="keys-only-a-managed-source-can-set">

401 436

402La maggior parte di loro sono lock: il valore che un lock governa, come regole di autorizzazione o `sandbox.network.allowedDomains`, è una chiave ordinaria che qualsiasi livello può impostare, e il lock dice a Claude Code di onorare solo il valore gestito.437La maggior parte di loro sono lock: il valore che un lock governa, come regole di autorizzazione o `sandbox.network.allowedDomains`, è una chiave ordinaria che qualsiasi livello può impostare, e il lock dice a Claude Code di onorare solo il valore gestito.

403 438

404La tabella copre i controlli di autorizzazione, plugin e consegna. Per qualsiasi chiave non elencata qui, la colonna Scope del [settings reference](/docs/it/settings-reference#all-settings) index dice se è managed-only; le chiavi managed-only rimanenti lì includono l'URL di accesso al gateway, versione, browser, mobile-simulator, host SSH, Desktop local-session, percorso binario sandbox, prezzo del modello, e controlli CLAUDE.md.439La tabella copre i controlli di autorizzazione, plugin e consegna. Per qualsiasi chiave non elencata qui, la colonna Scope del [settings reference](/docs/it/settings-reference#all-settings) index dice se è managed-only; le chiavi managed-only rimanenti lì includono l'URL di accesso al gateway, versione, browser, mobile-simulator, host SSH, Desktop local-session, percorso binario sandbox, prezzo del modello, restrizione del modello, e controlli CLAUDE.md.

405 440

406| Impostazione | Descrizione |441| Impostazione | Descrizione |

407| :- | :- |442| :- | :- |

425| [`sandbox.network.allowManagedDomainsOnly`](/docs/it/settings-reference#sandbox-network-allowmanageddomainsonly) | Onora solo le regole di autorizzazione `allowedDomains` e `WebFetch(domain:...)` gestite; blocca altri domini senza chiedere |460| [`sandbox.network.allowManagedDomainsOnly`](/docs/it/settings-reference#sandbox-network-allowmanageddomainsonly) | Onora solo le regole di autorizzazione `allowedDomains` e `WebFetch(domain:...)` gestite; blocca altri domini senza chiedere |

426| [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces) | Controlla quali fonti di marketplace di plugin gli utenti possono aggiungere e installare plugin da. Vedi [managed marketplace restrictions](/docs/it/plugins/org#restrict-what-users-can-install) |461| [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces) | Controlla quali fonti di marketplace di plugin gli utenti possono aggiungere e installare plugin da. Vedi [managed marketplace restrictions](/docs/it/plugins/org#restrict-what-users-can-install) |

427| [`strictPluginOnlyCustomization`](/docs/it/settings-reference#strictpluginonlycustomization) | Blocca skills, agents, hooks e server MCP da fonti utente e progetto; `true` blocca tutti e quattro, un array nomina quale |462| [`strictPluginOnlyCustomization`](/docs/it/settings-reference#strictpluginonlycustomization) | Blocca skills, agents, hooks e server MCP da fonti utente e progetto; `true` blocca tutti e quattro, un array nomina quale |

428| [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) | Quando impostato nel registro HKLM o in un file sotto `C:\Program Files\ClaudeCode`, fai leggere a WSL la catena di policy Windows, e leggi `/etc/claude-code` solo quando nessun file di impostazioni gestite o drop-in sotto quella directory distribuisce una [chiave di policy](#how-claude-code-combines-managed-sources); la voce fornisce l'ordine |463| [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) | Quando impostato nel registro HKLM o in un file sotto `C:\Program Files\ClaudeCode`, fai leggere a WSL la catena di policy Windows, e leggi `/etc/claude-code` solo quando [nessun documento admin Windows è presente](#present-admin-documents); la voce fornisce l'ordine |

429 464

430<Note>465<Note>

431 Sui piani Team e Enterprise, un Owner abilita o disabilita [Remote Control](/docs/it/remote-control) e [cloud sessions](/docs/it/claude-code-on-the-web) a livello di organizzazione nelle [Claude Code admin settings](https://claude.ai/admin-settings/claude-code). Remote Control può inoltre essere disabilitato per dispositivo con l'impostazione [`disableRemoteControl`](/docs/it/settings-reference#disableremotecontrol). Le sessioni cloud non hanno chiave di impostazioni gestite per dispositivo.466 Sui piani Team e Enterprise, un Owner abilita o disabilita [Remote Control](/docs/it/remote-control) e [cloud sessions](/docs/it/claude-code-on-the-web) a livello di organizzazione nelle [Claude Code admin settings](https://claude.ai/admin-settings/claude-code). Remote Control può inoltre essere disabilitato per dispositivo con l'impostazione [`disableRemoteControl`](/docs/it/settings-reference#disableremotecontrol). Le sessioni cloud non hanno chiave di impostazioni gestite per dispositivo.

449 484

450Claude Code applica un valore di `1` senza mostrare all'utente la [finestra di dialogo di approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog).485Claude Code applica un valore di `1` senza mostrare all'utente la [finestra di dialogo di approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog).

451 486

452Se disattivate la telemetria, Claude Code smette di inviare i dati di utilizzo che alimentano la [dashboard di analitiche](/docs/it/analytics) della vostra organizzazione per gli sviluppatori raggiunti dalla policy. La variabile disattiva anche il recupero dei feature flag, il che rende Remote Control, la modalità auto predefinita e le altre [funzionalità che richiedono il recupero dei feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching) non disponibili per quegli sviluppatori.487Se disattivate la telemetria, Claude Code smette di inviare i dati di utilizzo che alimentano la [dashboard di analitiche](/docs/it/analytics) della vostra organizzazione per gli sviluppatori raggiunti dalla policy. La variabile disattiva anche il [recupero dei feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching) per quegli sviluppatori. Per Remote Control, consultate i [requisiti di Remote Control](/docs/it/remote-control#requirements).

453 488

454[Where and when a policy applies](#where-and-when-a-policy-applies) indica quale meccanismo di distribuzione raggiunge ogni superficie, e [Platform availability](/docs/it/server-managed-settings#platform-availability) indica quali sessioni saltano il recupero delle impostazioni gestite dal server.489[Where and when a policy applies](#where-and-when-a-policy-applies) indica quale meccanismo di distribuzione raggiunge ogni superficie, e [Platform availability](/docs/it/server-managed-settings#platform-availability) indica quali sessioni saltano il recupero delle impostazioni gestite dal server.

455 490

mcp.md +30 −13

Details

92 92

93Una voce JSON che ha un `url` ma nessun `type` è un errore di configurazione, perché Claude Code legge una voce senza `type` come server stdio. Claude Code salta quel server e segnala `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. Prima della v2.1.202, Claude Code segnalava questa configurazione errata come `command: expected string, received undefined`.93Una voce JSON che ha un `url` ma nessun `type` è un errore di configurazione, perché Claude Code legge una voce senza `type` come server stdio. Claude Code salta quel server e segnala `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. Prima della v2.1.202, Claude Code segnalava questa configurazione errata come `command: expected string, received undefined`.

94 94

95Solo un'applicazione host SDK, come un'applicazione [Agent SDK](/docs/it/agent-sdk/mcp) o l'[app desktop](/docs/it/desktop), può registrare un server in-process `"type": "sdk"`. Claude Code salta una voce `"type": "sdk"` in `.mcp.json`, `~/.claude.json`, o impostazioni e segnala `Skipped — MCP server "<name>" declares type "sdk", which only an SDK host application can register`.

95Nelle esecuzioni `--output-format stream-json`, Claude Code segnala anche una voce `--mcp-config` saltata nell'evento `system/init` nel campo [`mcp_server_errors`](/docs/it/headless#stream-responses), in modo che gli script possano rilevare che il server non è mai stato caricato. Questo richiede Claude Code v2.1.219 o successivo.97Nelle esecuzioni `--output-format stream-json`, Claude Code segnala anche una voce `--mcp-config` saltata nell'evento `system/init` nel campo [`mcp_server_errors`](/docs/it/headless#stream-responses), in modo che gli script possano rilevare che il server non è mai stato caricato. Questo richiede Claude Code v2.1.219 o successivo.

96 98

97<h3 id="option-2-add-a-remote-sse-server">99<h3 id="option-2-add-a-remote-sse-server">

297 299

298La cache di scoperta è disattivata per impostazione predefinita a meno che un rollout graduale non l'abbia abilitata per il vostro account. Impostate [`MCP_DISCOVERY_CACHE=1`](/docs/it/env-vars) per attivarla, o `0` per mantenerla disattivata anche quando il rollout l'ha abilitata. Prima della v2.1.238, la cache era attivata per impostazione predefinita.300La cache di scoperta è disattivata per impostazione predefinita a meno che un rollout graduale non l'abbia abilitata per il vostro account. Impostate [`MCP_DISCOVERY_CACHE=1`](/docs/it/env-vars) per attivarla, o `0` per mantenerla disattivata anche quando il rollout l'ha abilitata. Prima della v2.1.238, la cache era attivata per impostazione predefinita.

299 301

300Due azioni nel menu di un server in `/mcp` influenzano anche la voce della cache di quel server:302Quando selezionate **Disable** o **Clear authentication** dal menu di un server in `/mcp`, Claude Code scarta anche la voce della cache di quel server. **Reconnect** la scarta anche su un server connesso o fallito; su un server `cached`, **Reconnect** connette il server ora e mantiene la voce. La prossima volta che Claude Code si connette al server dopo aver scartato la voce, recupera l'elenco degli strumenti dal server invece che dalla cache.

~~301~~

302* **Riconnetti**: su un server `cached`, Claude Code lo connette ora piuttosto che alla sua prima chiamata di strumento e mantiene la voce. Su un server connesso o fallito, Claude Code lo riconnette e scarta anche la voce.

303* **Cancella autenticazione**: Claude Code revoca l'autenticazione del server e scarta anche la voce.

~~304~~

305Dopo aver scartato la voce, Claude Code recupera l'elenco degli strumenti del server dal server invece che dalla cache.

306 303

307Quando lo stato di un server è `✘ Failed to connect`, `claude mcp list` aggiunge il dettaglio del fallimento a quella riga di stato, e `claude mcp get <name>` lo mostra su una riga `Issue:`: il codice di stato HTTP o il codice di errore, più qualsiasi testo di errore che il server ha restituito. La vista dei dettagli del server in `/mcp` include lo stesso testo segnalato dal server nella sua riga `Issue:`. Claude Code redige il testo simile a credenziali da questo dettaglio e non include mai l'URL del server espanso, che può contenere segreti. Claude Code non aggiunge dettagli a uno stato `✘ Connection error`, perché il testo dell'eccezione che stamperebbe lì può incorporare quell'URL. Prima della v2.1.219, entrambi i comandi mostravano solo lo stato di fallimento nudo, senza il codice di stato o il testo di errore del server.304Quando lo stato di un server è `✘ Failed to connect`, `claude mcp list` aggiunge il dettaglio del fallimento a quella riga di stato, e `claude mcp get <name>` lo mostra su una riga `Issue:`: il codice di stato HTTP o il codice di errore, più qualsiasi testo di errore che il server ha restituito. La vista dei dettagli del server in `/mcp` include lo stesso testo segnalato dal server nella sua riga `Issue:`. Claude Code redige il testo simile a credenziali da questo dettaglio e non include mai l'URL del server espanso, che può contenere segreti. Claude Code non aggiunge dettagli a uno stato `✘ Connection error`, perché il testo dell'eccezione che stamperebbe lì può incorporare quell'URL. Prima della v2.1.219, entrambi i comandi mostravano solo lo stato di fallimento nudo, senza il codice di stato o il testo di errore del server.

308 305

6694. [Server forniti da plugin](/docs/it/plugins/components#mcp-servers)6664. [Server forniti da plugin](/docs/it/plugins/components#mcp-servers)

6705. [Connettori claude.ai](#use-mcp-servers-from-claude-ai)6675. [Connettori claude.ai](#use-mcp-servers-from-claude-ai)

671 668

672I tre ambiti corrispondono ai duplicati per nome. I plugin e i connettori corrispondono per endpoint, quindi uno che punta allo stesso URL o comando di un server sopra è trattato come un duplicato.669Claude Code corrisponde ai duplicati nei tre ambiti per nome. Corrisponde ai plugin e ai connettori per endpoint, quindi uno che punta allo stesso URL o comando di un server sopra è trattato come un duplicato.

670

671Due ortografie di URL contano come lo stesso endpoint quando differiscono solo nella lettera maiuscola/minuscola dello schema o dell'host, la porta predefinita dello schema, come `:443` su `https`, o una barra finale. Un percorso diverso, una stringa di query, userinfo o una porta non predefinita rendono due server diversi.

673 672

674Un server che la tua organizzazione fornisce tramite l'impostazione gestita [`managedMcpServers`](/docs/it/managed-mcp#provide-servers-through-managed-settings) si classifica al di sopra di tutti questi, quindi quando uno di loro lo duplica, Claude Code si connette alla definizione dell'organizzazione. Richiede Claude Code v2.1.259 o successivo.673Un server che la tua organizzazione fornisce tramite l'impostazione gestita [`managedMcpServers`](/docs/it/managed-mcp#provide-servers-through-managed-settings) si classifica al di sopra di tutti questi, quindi quando uno di loro lo duplica, Claude Code si connette alla definizione dell'organizzazione. Richiede Claude Code v2.1.259 o successivo.

675 674

746 Come i riferimenti appaiono in `/mcp` e nell'output CLI745 Come i riferimenti appaiono in `/mcp` e nell'output CLI

747</h4>746</h4>

748 747

749Per un server negli ambiti [locale, progetto o utente](#mcp-installation-scopes), le seguenti superfici mostrano un riferimento `${VAR}` per nome piuttosto che come valore risolto:748Per un server negli [ambiti locale, progetto o utente](#mcp-installation-scopes), le seguenti superfici mostrano un riferimento `${VAR}` per nome piuttosto che come valore risolto:

750 749

751* L'URL o la riga di comando nella vista dettagli `/mcp` di un server750* L'URL o la riga di comando nella vista dettagli `/mcp` di un server

752* Output di `claude mcp list` e `claude mcp get`751* Output di `claude mcp list` e `claude mcp get`

915 <Step title="Registra un'app OAuth con il server">914 <Step title="Registra un'app OAuth con il server">

916 Crea un'app tramite il portale degli sviluppatori del server e annota il tuo ID client e il segreto client.915 Crea un'app tramite il portale degli sviluppatori del server e annota il tuo ID client e il segreto client.

917 916

918 Molti server richiedono anche un URI di reindirizzamento. Se è così, scegli una porta e registra un URI di reindirizzamento nel formato `http://localhost:PORT/callback`. Utilizza quella stessa porta con `--callback-port` nel passaggio successivo.917 Se il modulo di registrazione chiede un URI di reindirizzamento, scegli una porta disponibile e inserisci `http://localhost:PORT/callback` con quella porta. Utilizzerai la stessa porta nel passaggio successivo.

919 918

920 In v2.1.229, Claude Code ha inviato `http://127.0.0.1:PORT/callback` invece, e i server che corrispondevano esattamente all'URI di reindirizzamento registrato hanno rifiutato l'accesso con una mancata corrispondenza dell'URI di reindirizzamento. Claude Code v2.1.231 ha ripristinato il modulo `localhost`. Per recuperare su v2.1.229, aggiorna Claude Code, oppure aggiungi temporaneamente il modulo `http://127.0.0.1:PORT/callback` agli URI di reindirizzamento registrati del server.919 In v2.1.229, Claude Code ha inviato `http://127.0.0.1:PORT/callback` invece, e i server che corrispondevano esattamente all'URI di reindirizzamento registrato hanno rifiutato l'accesso con una mancata corrispondenza dell'URI di reindirizzamento. Claude Code v2.1.231 ha ripristinato il modulo `localhost`. Per recuperare su v2.1.229, aggiorna Claude Code, oppure aggiungi temporaneamente il modulo `http://127.0.0.1:PORT/callback` agli URI di reindirizzamento registrati del server.

921 </Step>920 </Step>

922 921

923 <Step title="Aggiungi il server con le tue credenziali">922 <Step title="Aggiungi il server con le tue credenziali">

924 Scegli uno dei seguenti metodi. La porta utilizzata per `--callback-port` può essere qualsiasi porta disponibile. Deve corrispondere all'URI di reindirizzamento che hai registrato nel passaggio precedente.923 Le schede coprono entrambi i comandi: `claude mcp add` accetta il tuo ID client e la porta di callback come flag, e `claude mcp add-json` li accetta in un oggetto `oauth`. Se hai registrato un URI di reindirizzamento, imposta la porta di callback sulla porta in quell'URI.

925 924

926 <Tabs>925 <Tabs>

927 <Tab title="claude mcp add">926 <Tab title="claude mcp add">

945 </Tab>944 </Tab>

946 945

947 <Tab title="claude mcp add-json (solo porta di callback)">946 <Tab title="claude mcp add-json (solo porta di callback)">

948 Utilizza `--callback-port` senza un ID client per fissare la porta mentre utilizzi la registrazione dinamica del client:947 Per fissare solo la porta di callback e consentire a Claude Code di registrare il client automaticamente, imposta `callbackPort` da solo:

949 948

950 ```bash theme={null}949 ```bash theme={null}

951 claude mcp add-json my-server \950 claude mcp add-json my-server \

1235 </Step>1234 </Step>

1236</Steps>1235</Steps>

1237 1236

1237Anthropic fornisce anche alcuni connettori da sola, senza che tu o un amministratore li aggiunga. Negli account in cui [Claude Docs](/docs/it/artifacts#write-a-document-with-claude-docs) è disponibile, `/mcp` elenca `claude.ai Claude Docs` senza configurazione, e Claude lo utilizza quando chiedi un documento destinato ad altre persone. Per disattivarlo, aggiungi una voce `serverName` di `"claude.ai Claude Docs"` a `deniedMcpServers` o utilizza l'interruttore `/mcp`, entrambi descritti in [Disabilitare i connettori claude.ai](#disable-claude-ai-connectors).

1238

1238Claude Code contrassegna un connettore come `managed` in `/mcp` e nel gestore [`/plugin`](/docs/it/plugins/install) quando la tua organizzazione gestisce la sua autenticazione in claude.ai. Lo stato managed non cambia il modo in cui Claude Code si connette al connettore o applica i [controlli degli strumenti](#organization-controls-on-connector-tools) della tua organizzazione.1239Claude Code contrassegna un connettore come `managed` in `/mcp` e nel gestore [`/plugin`](/docs/it/plugins/install) quando la tua organizzazione gestisce la sua autenticazione in claude.ai. Lo stato managed non cambia il modo in cui Claude Code si connette al connettore o applica i [controlli degli strumenti](#organization-controls-on-connector-tools) della tua organizzazione.

1239 1240

1240I connettori a cui non hai mai effettuato l'accesso sono compressi dietro una riga `Show unused connectors` alla fine della sezione claude.ai, in modo che un elenco fornito dall'organizzazione non riempia il pannello. Seleziona la riga per espanderli. Un connettore a cui hai effettuato l'accesso in precedenza rimane visibile anche quando attualmente necessita di una nuova autenticazione.1241I connettori a cui non hai mai effettuato l'accesso sono compressi dietro una riga `Show unused connectors` alla fine della sezione claude.ai, in modo che un elenco fornito dall'organizzazione non riempia il pannello. Seleziona la riga per espanderli. Un connettore a cui hai effettuato l'accesso in precedenza rimane visibile anche quando attualmente necessita di una nuova autenticazione.

1250 1251

1251Se un problema di rete temporaneo impedisce il caricamento dell'elenco dei connettori all'avvio della sessione, Claude Code ritenta il recupero fino a tre volte in background, e i connettori vengono visualizzati una volta che un tentativo ha successo. Se ancora non sono apparsi, riavvia Claude Code per recuperare di nuovo l'elenco.1252Se un problema di rete temporaneo impedisce il caricamento dell'elenco dei connettori all'avvio della sessione, Claude Code ritenta il recupero fino a tre volte in background, e i connettori vengono visualizzati una volta che un tentativo ha successo. Se ancora non sono apparsi, riavvia Claude Code per recuperare di nuovo l'elenco.

1252 1253

1253Se `/mcp` mostra un connettore come `connected · session token rejected`, o la sua vista dettagliata mostra [`claude.ai rejected the session token`](/docs/it/errors#claude-ai-rejected-the-session-token), claude.ai ha rifiutato il token dalla tua accesso a Claude Code, di solito perché l'accesso è scaduto e non poteva essere aggiornato. Autorizzare di nuovo il connettore non cancella questo stato, perché l'autorizzazione propria del connettore in claude.ai non è quello che è stato rifiutato. Per cancellarlo:1254Se `/mcp` mostra un connettore come `connected · session token rejected`, o la sua vista dettagliata mostra [`claude.ai rejected the session token`](/docs/it/errors#claude-ai-rejected-the-session-token), claude.ai ha rifiutato il token dal tuo accesso a Claude Code, di solito perché l'accesso è scaduto e non poteva essere aggiornato. Autorizzare di nuovo il connettore non cancella questo stato, perché l'autorizzazione propria del connettore in claude.ai non è quello che è stato rifiutato. Per cancellarlo:

1254 1255

12551. Esegui `/login` per accedere di nuovo.12561. Esegui `/login` per accedere di nuovo.

12562. Ricollega il connettore da `/mcp`.12572. Ricollega il connettore da `/mcp`.

1416 Se incontrate frequentemente avvisi di output con server MCP specifici che non controllate, considerate di aumentare il limite `MAX_MCP_OUTPUT_TOKENS`. Potete anche chiedere all'autore del server di aggiungere l'annotazione `anthropic/maxResultSizeChars` o di impaginare le loro risposte. L'annotazione non ha effetto sugli strumenti che restituiscono contenuto di immagine; per quelli, aumentare `MAX_MCP_OUTPUT_TOKENS` è l'unica opzione.1417 Se incontrate frequentemente avvisi di output con server MCP specifici che non controllate, considerate di aumentare il limite `MAX_MCP_OUTPUT_TOKENS`. Potete anche chiedere all'autore del server di aggiungere l'annotazione `anthropic/maxResultSizeChars` o di impaginare le loro risposte. L'annotazione non ha effetto sugli strumenti che restituiscono contenuto di immagine; per quelli, aumentare `MAX_MCP_OUTPUT_TOKENS` è l'unica opzione.

1417</Warning>1418</Warning>

1418 1419

1420<h3 id="images-in-tool-results">

1421 Immagini nei risultati degli strumenti

1422</h3>

1423

1424Quando uno strumento MCP restituisce un'immagine PNG, JPEG, GIF o WebP, Claude vede l'immagine inline nella conversazione. La copia inline può essere ridimensionata o compressa per adattarsi ai limiti di dimensione dell'immagine del modello. Claude Code salva anche i byte originali in un file nella directory `tool-results` della sessione sotto [`~/.claude/projects/`](/docs/it/claude-directory#cleaned-up-automatically) e fornisce a Claude il percorso. Claude può quindi ritagliare, convertire o riutilizzare il file a risoluzione completa con strumenti come Bash.

1425

1426Se disabilitate la persistenza della sessione con [`--no-session-persistence`](/docs/it/cli-reference#cli-flags) o [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/it/env-vars), Claude Code non scrive alcun file di immagine e Claude riceve solo la copia inline.

1427

1428Il salvataggio dei risultati delle immagini MCP in un file richiede Claude Code v2.1.283 o versioni successive.

1429

1419<h2 id="tool-input-schemas-with-a-root-level-combinator">1430<h2 id="tool-input-schemas-with-a-root-level-combinator">

1420 Tool input schemas con un combinatore a livello radice1431 Tool input schemas con un combinatore a livello radice

1421</h2>1432</h2>

1487I server possono richiedere input in due modi:1498I server possono richiedere input in due modi:

1488 1499

1489* **Modalità modulo**: Claude Code mostra una finestra di dialogo con campi modulo definiti dal server (ad esempio, un prompt di nome utente e password). Compilate i campi e inviate.1500* **Modalità modulo**: Claude Code mostra una finestra di dialogo con campi modulo definiti dal server (ad esempio, un prompt di nome utente e password). Compilate i campi e inviate.

1490* **Modalità URL**: Claude Code apre un URL del browser per l'autenticazione o l'approvazione. Completate il flusso nel browser, quindi confermate nella CLI.1501* **Modalità URL**: Claude Code chiede se aprire un collegamento nel vostro browser e lo apre quando accettate. I server utilizzano questa modalità per un flusso che si conclude al di fuori del terminale, come l'accesso.

1491 1502

1492In modalità URL, Claude Code trasmette l'URL come argomento della riga di comando al gestore URL del vostro sistema e limita la lunghezza di tale argomento. Quando l'URL, una volta sottoposto a escape per la riga di comando, supera tale limite, potete solo rifiutare la richiesta. Ogni carattere che necessita di escape, come `%` o `&`, conta quattro volte verso il limite: il suo carattere più tre caratteri di escape. Un URL senza nessuno di essi raggiunge il limite a circa 8.000 caratteri. Un URL costruito principalmente con escape percentuali, dove ogni terzo carattere è un `%`, lo raggiunge a circa 4.000.1503In modalità URL, Claude Code trasmette l'URL come argomento della riga di comando al gestore URL del vostro sistema e limita la lunghezza di tale argomento. Quando l'URL, una volta sottoposto a escape per la riga di comando, supera tale limite, potete solo rifiutare la richiesta. Ogni carattere che necessita di escape, come `%` o `&`, conta quattro volte verso il limite: il suo carattere più tre caratteri di escape. Un URL senza nessuno di essi raggiunge il limite a circa 8.000 caratteri. Un URL costruito principalmente con escape percentuali, dove ogni terzo carattere è un `%`, lo raggiunge a circa 4.000.

1493 1504

1495 1506

1496Se state creando un server MCP che utilizza l'elicitazione, consultate la [specifica di elicitazione MCP](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) per i dettagli del protocollo e gli esempi di schema.1507Se state creando un server MCP che utilizza l'elicitazione, consultate la [specifica di elicitazione MCP](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) per i dettagli del protocollo e gli esempi di schema.

1497 1508

1509Sulle connessioni che utilizzano [revisione del protocollo 2026-07-28](#mcp-client-runtimes), Claude Code dichiara `elicitation: {form: {}, url: {}}` nelle sue capacità client, quindi un server lì può richiedere entrambe le modalità attraverso la richiesta di elicitazione standard del protocollo.

1510

1498<h2 id="use-mcp-resources">1511<h2 id="use-mcp-resources">

1499 Utilizzare le risorse MCP1512 Utilizzare le risorse MCP

1500</h2>1513</h2>

1540 * Le risorse possono contenere qualsiasi tipo di contenuto fornito dal server MCP (testo, JSON, dati strutturati, ecc.)1553 * Le risorse possono contenere qualsiasi tipo di contenuto fornito dal server MCP (testo, JSON, dati strutturati, ecc.)

1541</Tip>1554</Tip>

1542 1555

1556Le risorse dell'interfaccia utente delle app MCP sono voci con un URI `ui://` o il tipo di media `text/html;profile=mcp-app`: pagine per un'applicazione host da renderizzare piuttosto che contenuti per Claude da leggere. Non vengono visualizzate nei suggerimenti `@` o nei risultati dello strumento di elenco delle risorse, e un server che offre solo risorse dell'interfaccia utente mostra un elenco di risorse vuoto. La lettura di una risorsa dell'interfaccia utente tramite il suo URI funziona comunque.

1557

1543<h2 id="scale-with-mcp-tool-search">1558<h2 id="scale-with-mcp-tool-search">

1544 Scalare con la ricerca di strumenti MCP1559 Scalare con la ricerca di strumenti MCP

1545</h2>1560</h2>

1643 1658

1644I server MCP possono esporre prompt che diventano disponibili come comandi in Claude Code.1659I server MCP possono esporre prompt che diventano disponibili come comandi in Claude Code.

1645 1660

1661I prompt da un server denominato `anthropic-skills` non vengono visualizzati, perché Claude Code [riserva quel nome](/docs/it/skills#names-reserved-for-synced-skills) per le skills sincronizzate da claude.ai. Gli strumenti del server funzionano comunque. Rinomina il server nella tua configurazione MCP per elencare i suoi prompt.

1662

1646<h3 id="execute-mcp-prompts">1663<h3 id="execute-mcp-prompts">

1647 Esegui i prompt MCP1664 Esegui i prompt MCP

1648</h3>1665</h3>

memory.md +9 −0

Details

103 103

104**Coerenza**: se due regole si contraddicono a vicenda, Claude potrebbe sceglierne una arbitrariamente. Rivedete periodicamente i vostri file CLAUDE.md, i file CLAUDE.md annidati nelle sottodirectory e [`.claude/rules/`](#organize-rules-with-claude/rules/) per rimuovere istruzioni obsolete o conflittuali. Nei monorepo, utilizzate [`claudeMdExcludes`](#exclude-specific-claude-md-files) per saltare i file CLAUDE.md di altri team che non sono rilevanti per il vostro lavoro.104**Coerenza**: se due regole si contraddicono a vicenda, Claude potrebbe sceglierne una arbitrariamente. Rivedete periodicamente i vostri file CLAUDE.md, i file CLAUDE.md annidati nelle sottodirectory e [`.claude/rules/`](#organize-rules-with-claude/rules/) per rimuovere istruzioni obsolete o conflittuali. Nei monorepo, utilizzate [`claudeMdExcludes`](#exclude-specific-claude-md-files) per saltare i file CLAUDE.md di altri team che non sono rilevanti per il vostro lavoro.

105 105

106Per fare in modo che Claude controlli questi file per istruzioni obsolete o conflittuali, eseguite `/doctor prompt-audit` in una sessione. Claude legge i vostri file CLAUDE.md, CLAUDE.local.md e AGENTS.md, più le regole, skills, comandi, subagent e stili di output sotto `.claude/` e `~/.claude/`. Cerca problemi come istruzioni scritte per modelli più vecchi, riferimenti a file o comandi che non esistono e file che si contraddicono a vicenda. Ricevete un rapporto dei risultati e un set di modifiche proposte, e nulla nei vostri file cambia finché non chiedete a Claude di applicarle.

107

108Per controllare un file o una directory invece, passate il suo percorso, ad esempio `/doctor prompt-audit .claude/skills/deploy`. L'audit viene eseguito attraverso la skill `/claude-api` in bundle, quindi non è disponibile mentre quella skill è disattivata in [`skillOverrides`](/docs/it/skills#override-skill-visibility-from-settings) o con [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills). `/doctor prompt-audit` richiede Claude Code v2.1.283 o successivo.

109

106<h3 id="import-additional-files">110<h3 id="import-additional-files">

107 Importate file aggiuntivi111 Importate file aggiuntivi

108</h3>112</h3>

273ln -s ~/company-standards/security.md .claude/rules/security.md277ln -s ~/company-standards/security.md .claude/rules/security.md

274```278```

275 279

280Se puntate un symlink `.claude/rules/` o `CLAUDE.md` a un percorso di rete come la condivisione UNC `\\server\share` o un percorso sotto `/net` o `/Network`, le istruzioni collegate non si caricano. Claude Code non segue il link, perché cercare un tale percorso può contattare l'host che nomina. I percorsi `\\wsl$` non contano come percorsi di rete.

281

276<h4 id="user-level-rules">282<h4 id="user-level-rules">

277 Regole a livello di utente283 Regole a livello di utente

278</h4>284</h4>

620* Verifica che il CLAUDE.md rilevante si trovi in una posizione che viene caricata per la tua sessione (vedi [Scegli dove mettere i file CLAUDE.md](#choose-where-to-put-claude-md-files)).626* Verifica che il CLAUDE.md rilevante si trovi in una posizione che viene caricata per la tua sessione (vedi [Scegli dove mettere i file CLAUDE.md](#choose-where-to-put-claude-md-files)).

621* Rendi le istruzioni più specifiche. "Usa indentazione a 2 spazi" funziona meglio di "formatta il codice bene".627* Rendi le istruzioni più specifiche. "Usa indentazione a 2 spazi" funziona meglio di "formatta il codice bene".

622* Cerca istruzioni conflittuali tra i file CLAUDE.md. Se due file danno una guida diversa per lo stesso comportamento, Claude potrebbe sceglierne una arbitrariamente.628* Cerca istruzioni conflittuali tra i file CLAUDE.md. Se due file danno una guida diversa per lo stesso comportamento, Claude potrebbe sceglierne una arbitrariamente.

629* Verifica se la tua istruzione compete con la guida che Claude Code aggiunge di per sé. Se il tuo CLAUDE.md imposta regole di commit o pull request, disattiva quelle integrate con [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) e imposta il testo di attribuzione con [`attribution`](/docs/it/settings-reference#attribution).

623 630

624Se l'istruzione è qualcosa che deve essere eseguito in un punto specifico, come prima di ogni commit o dopo ogni modifica di file, scrivila come un [hook](/docs/it/hooks-guide). Gli hook vengono eseguiti come comandi shell in eventi del ciclo di vita fissi e si applicano indipendentemente da ciò che Claude decide di fare.631Se l'istruzione è qualcosa che deve essere eseguito in un punto specifico, come prima di ogni commit o dopo ogni modifica di file, scrivila come un [hook](/docs/it/hooks-guide). Gli hook vengono eseguiti come comandi shell in eventi del ciclo di vita fissi e si applicano indipendentemente da ciò che Claude decide di fare.

625 632

657 664

658I file con più di 200 righe consumano più contesto e possono ridurre l'aderenza. Claude Code salta un file superiore a 4 MiB. Usa [regole con ambito di percorso](#path-specific-rules) per caricare istruzioni solo quando Claude lavora con file corrispondenti, oppure riduci il contenuto che non è necessario in ogni sessione. La divisione in [importazioni `@path`](#import-additional-files) aiuta l'organizzazione ma non riduce il contesto, poiché i file importati vengono caricati all'avvio.665I file con più di 200 righe consumano più contesto e possono ridurre l'aderenza. Claude Code salta un file superiore a 4 MiB. Usa [regole con ambito di percorso](#path-specific-rules) per caricare istruzioni solo quando Claude lavora con file corrispondenti, oppure riduci il contenuto che non è necessario in ogni sessione. La divisione in [importazioni `@path`](#import-additional-files) aiuta l'organizzazione ma non riduce il contesto, poiché i file importati vengono caricati all'avvio.

659 666

667Se uno dei tuoi file di istruzioni supera la lunghezza consigliata, vedrai un avviso all'avvio e quando esegui `/status`. Vedrai anche un avviso quando i file che sono ciascuno entro quella lunghezza si sommano oltre un limite combinato all'inizio della sessione. Ogni CLAUDE.md, file di regole e importazione `@path` conta come un file separato.

668

660Il controllo [`/doctor`](/docs/it/commands#all-commands) propone riduzioni per un CLAUDE.md archiviato: taglia il contenuto che Claude può derivare dalla base di codice, come layout di directory, elenchi di dipendenze e panoramiche dell'architettura, e mantiene i rischi, la logica e le convenzioni che differiscono dai valori predefiniti dello strumento. Il controllo di riduzione richiede Claude Code v2.1.206 o successivo.669Il controllo [`/doctor`](/docs/it/commands#all-commands) propone riduzioni per un CLAUDE.md archiviato: taglia il contenuto che Claude può derivare dalla base di codice, come layout di directory, elenchi di dipendenze e panoramiche dell'architettura, e mantiene i rischi, la logica e le convenzioni che differiscono dai valori predefiniti dello strumento. Il controllo di riduzione richiede Claude Code v2.1.206 o successivo.

661 670

662<h3 id="instructions-seem-lost-after-/compact">671<h3 id="instructions-seem-lost-after-/compact">

mobile.md +1 −1

Details

44| :- | :- | :- |44| :- | :- | :- |

45| [Cloud sessions](/docs/it/claude-code-on-the-web) | Una sessione su infrastruttura cloud, gestita da Anthropic per impostazione predefinita | Il tuo repository è su GitHub e il task dovrebbe continuare a essere eseguito dopo aver messo il telefono via. Vedi la [guida rapida cloud](/docs/it/web-quickstart) per configurare. |45| [Cloud sessions](/docs/it/claude-code-on-the-web) | Una sessione su infrastruttura cloud, gestita da Anthropic per impostazione predefinita | Il tuo repository è su GitHub e il task dovrebbe continuare a essere eseguito dopo aver messo il telefono via. Vedi la [guida rapida cloud](/docs/it/web-quickstart) per configurare. |

46| [Projects](/docs/it/claude-projects) | Una conversazione dove Claude coordina sessioni cloud parallele come thread | Hai un flusso di lavoro correlato piuttosto che un singolo task e vuoi vedere quali thread sono terminati o hanno bisogno di te. |46| [Projects](/docs/it/claude-projects) | Una conversazione dove Claude coordina thread paralleli di lavoro e riferisce i risultati | Hai un flusso di lavoro correlato piuttosto che un singolo task e vuoi vedere quali thread sono terminati o hanno bisogno di te. |

48| [Dispatch](/docs/it/desktop#sessions-from-dispatch) | L'app Desktop sul tuo computer | Vuoi inviare un task tramite messaggio e lasciare che Dispatch decida come eseguirlo. Richiede un piano Pro o Max. |48| [Dispatch](/docs/it/desktop#sessions-from-dispatch) | L'app Desktop sul tuo computer | Vuoi inviare un task tramite messaggio e lasciare che Dispatch decida come eseguirlo. Richiede un piano Pro o Max. |

49 49

model-config.md +209 −138

Details

10 Modelli disponibili10 Modelli disponibili

11</h2>11</h2>

12 12

~~13Per l'impostazione `model` in Claude Code, puoi configurare:~~13Per l'impostazione `model` in Claude Code, è possibile configurare:

14 14

15* Un **alias del modello**15* Un **alias del modello**

16* Un **nome del modello**16* Un **nome del modello**

~~17 * Anthropic API: un **[nome del modello](https://platform.claude.com/docs/en/about-claude/models/overview)** completo~~17 * API Anthropic: un **[nome del modello](https://platform.claude.com/docs/en/about-claude/models/overview)** completo

18 * Amazon Bedrock: un ARN del profilo di inferenza18 * Amazon Bedrock: un ARN del profilo di inferenza

19 * Microsoft Foundry: un nome di distribuzione19 * Microsoft Foundry: un nome di distribuzione

~~20 * Google Cloud's Agent Platform: un nome di versione~~20 * Agent Platform di Google Cloud: un nome di versione

21 21

22Per indicazioni su quale modello e livello di impegno si adattano a diversi tipi di lavoro, consulta [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) sul blog.22Per indicazioni su quale modello e livello di impegno si adattano a diversi tipi di lavoro, consultare [Scelta di un modello Claude e livello di impegno in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) sul blog.

23 23

24<Note>24<Note>

~~25 `ANTHROPIC_BASE_URL` cambia dove vengono inviate le richieste, non quale modello le risponde. Per instradare Claude attraverso un gateway LLM, consulta [LLM gateways](/docs/it/llm-gateway).~~25 `ANTHROPIC_BASE_URL` cambia dove vengono inviate le richieste, non quale modello le risponde. Per instradare Claude attraverso un gateway LLM, consultare [Gateway LLM](/docs/it/llm-gateway).

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

~~29 Alias del modello~~29 Alias dei modelli

30</h3>30</h3>

31 31

~~32Usa un alias del modello per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:~~32Utilizzare un alias del modello per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:

33 33

34| Alias del modello | Comportamento |34| Alias del modello | Comportamento |

35| - | - |35| - | - |

36| **`default`** | Valore speciale che cancella qualsiasi override del modello e ripristina il [valore predefinito di runtime per il tuo account](#default-model-setting). Non è di per sé un alias del modello |36| **`default`** | Valore speciale che cancella qualsiasi override del modello e ripristina il [valore predefinito di runtime per il vostro account](#default-model-setting). Non è di per sé un alias del modello |

~~37| **`best`** | Utilizza il modello a cui si risolve l'alias [`fable`](#fable-alias-resolution) dove Fable è disponibile per te, altrimenti lo stesso modello di `opus` |~~37| **`best`** | Utilizza il modello a cui si risolve l'alias [`fable`](#fable-alias-resolution) dove Fable è disponibile per voi, altrimenti lo stesso modello di `opus` |

~~38| **`fable`** | Utilizza il [modello Fable per il tuo provider](#fable-alias-resolution) per i tuoi compiti più difficili e lunghi |~~38| **`fable`** | Utilizza il [modello Fable per il vostro provider](#fable-alias-resolution) per i vostri compiti più difficili e lunghi |

39| **`sonnet`** | Utilizza il modello Sonnet più recente per i compiti di codifica quotidiani |39| **`sonnet`** | Utilizza il modello Sonnet più recente per i compiti di codifica quotidiani |

40| **`opus`** | Utilizza il modello Opus più recente per i compiti di ragionamento complesso |40| **`opus`** | Utilizza il modello Opus più recente per i compiti di ragionamento complesso |

42| **`sonnet[1m]`** | Utilizza Sonnet con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `sonnet` si risolve già in Sonnet 5 con la sua finestra nativa di 1M; dietro un [gateway LLM](/docs/it/llm-gateway), seleziona la finestra di 1M per Sonnet 5 |42| **`sonnet[1m]`** | Utilizza Sonnet con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `sonnet` si risolve già in Sonnet 5.5 o Sonnet 5 con la sua finestra nativa di 1M; dietro un [gateway LLM](/docs/it/llm-gateway), seleziona la finestra di 1M per quel modello |

43| **`opus[1m]`** | Utilizza Opus con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe |43| **`opus[1m]`** | Utilizza Opus con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe |

44| **`opusplan`** | Modalità speciale che utilizza `opus` durante la modalità piano, quindi passa a `sonnet` per l'esecuzione |44| **`opusplan`** | Modalità speciale che utilizza `opus` durante la modalità piano, quindi passa a `sonnet` per l'esecuzione |

45 45

47 47

49| :- | :- | :- |49| :- | :- | :- |

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56

57A meno che non imposti `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5.1, tranne nelle sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) dove `fable` e `best` si risolvono in Fable 5. Prima della v2.1.257, `fable` si risolveva in Fable 5 su ogni provider.57A meno che non impostiate `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5.1, tranne nelle sessioni di [gateway delle app Claude](/docs/it/claude-apps-gateway), dove `fable` e `best` si risolvono in Fable 5.

58 58

59Un gateway non configurato per servire `claude-fable-5-1` rifiuta le richieste per quel modello. Per utilizzare Fable 5.1 attraverso un gateway che lo serve, selezionalo con `/model claude-fable-5-1`.59Un gateway non configurato per servire `claude-fable-5-1` rifiuta le richieste per quel modello. Per utilizzare Fable 5.1 attraverso un gateway che lo serve, selezionarlo con `/model claude-fable-5-1`.

60 60

61Dove un alias si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando il nome del modello completo esplicitamente o impostando `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Dove un alias si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando il nome completo del modello esplicitamente o impostando `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62

63Prima della v2.1.280, `opus` si risolveva in Opus 5 su Anthropic API, Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform dalla v2.1.219. Prima della v2.1.219, `opus` si risolveva in Opus 4.8 su Anthropic API dalla v2.1.154, e su Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform dalla v2.1.207. Prima della v2.1.207, `opus` si risolveva in Opus 4.7 su Claude Platform on AWS e in Opus 4.6 su Amazon Bedrock e Google Cloud's Agent Platform.63Le versioni precedenti risolvono questi alias a modelli più vecchi. Per la versione in cui ogni alias è cambiato, consultare [Cronologia delle versioni](#version-history).

64 64

65Gli alias puntano alla versione consigliata per il tuo provider e si aggiornano nel tempo. Per fissare una versione specifica, utilizza il nome del modello completo, ad esempio `claude-opus-5-5`, o imposta la variabile di ambiente corrispondente come `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Gli alias puntano alla versione consigliata per il vostro provider e si aggiornano nel tempo. Per fissare una versione specifica, utilizzare il nome completo del modello, ad esempio `claude-opus-5-5`, o impostare la variabile di ambiente corrispondente come `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66

67<Note>67<Note>

~~68 Opus 5.5 richiede Claude Code v2.1.280 o successiva. Opus 5 richiede v2.1.219 o successiva. Sonnet 5 richiede v2.1.197 o successiva. Esegui `claude update` per aggiornare.~~68 Sonnet 5.5 richiede Claude Code v2.1.284 o successiva, e Opus 5.5 richiede v2.1.280 o successiva. Eseguire `claude update` per aggiornare.

69</Note>69</Note>

70 70

71<h3 id="work-with-fable">71<h3 id="work-with-fable">

~~72 Lavora con Fable~~72 Lavorare con Fable

73</h3>73</h3>

74 74

75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione. Sostengono lunghe sessioni autonome, investigano prima di agire e verificano il loro lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione. Sostengono lunghe sessioni autonome, investigano prima di agire e verificano il loro lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.

76 76

~~77Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionane uno esplicitamente:~~77Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionarne uno esplicitamente:

78 78

79* **Fable 5.1**: esegui `/model fable`, o avvia con `claude --model fable`. Nelle sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) dove l'alias si risolve in Fable 5, esegui `/model claude-fable-5-1` invece.79* **Fable 5.1**: eseguire `/model fable`, o avviare con `claude --model fable`. Nelle sessioni di [gateway delle app Claude](/docs/it/claude-apps-gateway), dove l'alias si risolve in Fable 5, eseguire invece `/model claude-fable-5-1`.

80* **Fable 5**: selezionalo per ID del modello. Su Anthropic API, esegui `/model claude-fable-5` o avvia con `claude --model claude-fable-5`. Su altri provider, utilizza l'ID del modello Fable 5 del tuo provider o [fissalo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.80* **Fable 5**: selezionarlo per ID del modello. Sull'API Anthropic, eseguire `/model claude-fable-5` o avviare con `claude --model claude-fable-5`. Su altri provider, utilizzare l'ID del modello Fable 5 del vostro provider o [fissarlo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.

81 81

82Se ti connetti direttamente a Anthropic API e le tue impostazioni utente contengono `claude-fable-5` o `claude-fable-5[1m]` come modello, ad esempio perché hai selezionato Fable nel selettore `/model` prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias `fable` o `fable[1m]` la prima volta che esegui v2.1.257 o successiva. La riga del modello di avvio mostra `(auto-updated)` una volta. Un valore `claude-fable-5` nelle impostazioni di progetto, locali o gestite rimane come è.82Se vi connettete direttamente all'API Anthropic e le impostazioni dell'utente contengono `claude-fable-5` o `claude-fable-5[1m]` come modello, ad esempio perché avete selezionato Fable nel selettore `/model` prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias `fable` o `fable[1m]` la prima volta che eseguite v2.1.257 o successiva. La riga del modello di avvio mostra `(auto-updated)` una volta. Un valore `claude-fable-5` nelle impostazioni di progetto, locali o gestite rimane come è.

83 83

84Le richieste che i classificatori di sicurezza di un modello Fable contrassegnano, il più delle volte nei domini della sicurezza informatica e della biologia, attivano il [fallback automatico del modello](#automatic-model-fallback).84Le richieste che i classificatori di sicurezza di un modello Fable contrassegnano, più spesso nei domini della sicurezza informatica e della biologia, attivano il [fallback automatico del modello](#automatic-model-fallback).

85 85

86Per ottenere il massimo da Fable:86Per ottenere il massimo da Fable:

87 87

88* **Descrivi il risultato, non i passaggi**: dagli il risultato che desideri e lascia che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, [imposta un obiettivo](/docs/it/goal).88* **Descrivere il risultato, non i passaggi**: fornitegli il risultato che desiderate e lasciate che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, [impostare un obiettivo](/docs/it/goal).

~~89* **Dagli problemi ambigui**: le indagini sulla causa principale, il debug delle interruzioni e le decisioni architettoniche sono dove l'indagine e la verifica extra ripagano.~~89* **Fornitegli problemi ambigui**: le indagini sulla causa principale, il debug dei disservizi e le decisioni architettoniche sono dove l'investigazione e la verifica aggiuntive ripagano.

~~90* **Salta i promemoria di verifica**: verifica il suo lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare sono solitamente non necessari.~~90* **Saltate i promemoria di verifica**: verifica il suo lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare sono solitamente non necessari.

~~91* **Dimensiona compiti più grandi**: dagli lavoro che normalmente divideresti in pezzi. Sostiene lunghe sessioni senza perdere il filo.~~91* **Dimensionate i compiti più grandi**: fornitegli il lavoro che normalmente dividereste in pezzi. Sostiene lunghe sessioni senza perdere il filo.

92 92

93<Note>93<Note>

94 Fable 5.1 richiede Claude Code v2.1.257 o successiva. Se una richiesta per essa da una versione precedente fallisce, consulta [Claude Code does not support this model](/docs/it/errors#claude-code-does-not-support-this-model). Esegui `claude update` per aggiornare. Per la disponibilità con zero data retention, consulta [Model availability under ZDR](/docs/it/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 richiede Claude Code v2.1.257 o successiva. Se una richiesta da una versione precedente non riesce, consultare [Claude Code non supporta questo modello](/docs/it/errors#claude-code-does-not-support-this-model). Eseguire `claude update` per aggiornare. Per la disponibilità con conservazione dati zero, consultare [Disponibilità del modello con ZDR](/docs/it/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96

97Su Anthropic API, un modello Fable appare nel selettore `/model` a meno che [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) lo escludano. Quando la tua organizzazione non può utilizzare Fable affatto, ad esempio con [zero data retention](/docs/it/zero-data-retention#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.97Sull'API Anthropic, un modello Fable appare nel selettore `/model` a meno che [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) lo escludano. Quando la vostra organizzazione non può utilizzare Fable affatto, ad esempio con [conservazione dati zero](/docs/it/zero-data-retention#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.

98 98

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable e crediti di utilizzo100 Fable e crediti di utilizzo

101</h4>101</h4>

102 102

103A seconda del tuo piano e del livello di posto, l'utilizzo di Fable può fatturare ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) invece di attingere ai limiti inclusi nel tuo piano. Quando lo fa, il selettore `/model` mostra "Requires usage credits" sulla riga Fable. Per gestire i crediti di utilizzo, consulta [Add usage credits to your subscription](/docs/it/costs#add-usage-credits-to-your-subscription).103A seconda del vostro piano e livello di posto, l'utilizzo di Fable può fatturare ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) invece di attingere ai limiti inclusi nel vostro piano. Quando lo fa, il selettore `/model` mostra "Richiede crediti di utilizzo" sulla riga Fable. Per gestire i crediti di utilizzo, consultare [Aggiungere crediti di utilizzo al vostro abbonamento](/docs/it/costs#add-usage-credits-to-your-subscription).

104 104

105Nelle sessioni interattive, Claude Code mostra un prompt di consenso prima che una richiesta Fable fatturi crediti di utilizzo. I membri dei piani Enterprise con fatturazione organizzativa non vedono il prompt. Puoi continuare su Fable utilizzando crediti di utilizzo o passare al tuo modello predefinito. Puoi anche chiudere il prompt:105Nelle sessioni interattive, Claude Code mostra un prompt di consenso prima che una richiesta Fable fatturi i crediti di utilizzo. I membri dei piani Enterprise con fatturazione organizzativa non vedono il prompt. Potete continuare su Fable utilizzando i crediti di utilizzo o passare al vostro modello predefinito. Potete anche chiudere il prompt:

106 106

107* Nel selettore `/model`, mantieni il tuo modello attuale.107* Nel selettore `/model`, mantenete il vostro modello attuale.

108* A metà sessione, Claude Code continua il turno sul tuo modello predefinito.108* A metà sessione, Claude Code continua il turno sul vostro modello predefinito.

109 109

110Dopo aver scelto di continuare su Fable utilizzando crediti di utilizzo, Claude Code non mostra più il prompt.110Dopo aver scelto di continuare su Fable utilizzando i crediti di utilizzo, Claude Code non mostra più il prompt.

111 111

112In una sessione con [Remote Control](/docs/it/remote-control) connesso, una [sessione in background](/docs/it/agent-view), o una sessione del compagno di un [team di agenti](/docs/it/agent-teams), nessuno potrebbe essere al terminale, quindi Claude Code tiene il prompt di consenso a metà sessione per la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che il client Remote Control mostra anche. La tua selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al tuo prossimo messaggio.112In una sessione con [Remote Control](/docs/it/remote-control) connesso, una [sessione in background](/docs/it/agent-view), o una sessione di un compagno di [team di agenti](/docs/it/agent-teams), nessuno potrebbe essere al terminale, quindi Claude Code tiene il prompt di consenso a metà sessione per la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che il client Remote Control mostra anche. La vostra selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al vostro prossimo messaggio.

113 113

114Quello che puoi fare mentre il prompt è in attesa dipende dalla sessione:114Quello che potete fare mentre il prompt è in attesa dipende dalla sessione:

115 115

116* Con Remote Control connesso o nella sessione di un compagno, premi un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la tua risposta.116* Con Remote Control connesso o in una sessione di un compagno, premete un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la vostra risposta.

117* In una sessione in background, rispondi prima della scadenza.117* In una sessione in background, rispondete prima della scadenza.

118* Se invii un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il tuo nuovo messaggio inizia il turno successivo. Dopo che qualcuno digita al terminale, Claude Code continua ad aspettare la risposta e mette in coda il tuo nuovo messaggio dietro di essa.118* Se inviate un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il vostro nuovo messaggio inizia il turno successivo. Dopo che qualcuno digita al terminale, Claude Code continua ad aspettare la risposta e mette in coda il vostro nuovo messaggio dietro di essa.

119 119

120In [modalità non interattiva](/docs/it/headless) con il flag `-p` e attraverso Agent SDK, Claude Code non mostra mai il prompt di consenso. Quando una richiesta Fable lì fatturasse crediti di utilizzo, Claude Code la fattura senza chiedere.120In [modalità non interattiva](/docs/it/headless) con il flag `-p` e attraverso l'Agent SDK, Claude Code non mostra mai il prompt di consenso. Quando una richiesta Fable lì fatturasse ai crediti di utilizzo, Claude Code la fattura senza chiedere.

121 121

122<h3 id="setting-your-model">122<h3 id="setting-your-model">

123 Impostazione del tuo modello123 Impostazione del vostro modello

124</h3>124</h3>

125 125

126Puoi configurare il tuo modello in diversi modi, elencati in ordine di priorità:126Potete configurare il vostro modello in diversi modi, elencati in ordine di priorità:

127 127

1281. **Durante la sessione**: usa `/model <alias|name>` per passare immediatamente, o esegui `/model` senza argomenti per aprire il selettore. Consulta [quando Claude Code ti chiede di confermare il passaggio](/docs/it/prompt-caching#switching-models)1281. **Durante la sessione**: utilizzare `/model <alias|name>` per passare immediatamente, o eseguire `/model` senza argomenti per aprire il selettore. Consultare [quando Claude Code vi chiede di confermare il passaggio](/docs/it/prompt-caching#switching-models)

1292. **All'avvio**: avvia con `claude --model <alias|name>`1292. **All'avvio**: avviare con `claude --model <alias|name>`

1303. **Variabile di ambiente**: imposta `ANTHROPIC_MODEL=<alias|name>`1303. **Variabile di ambiente**: impostare `ANTHROPIC_MODEL=<alias|name>`

1314. **Impostazioni**: configura permanentemente nel tuo file di impostazioni usando il campo `model`1314. **Impostazioni**: configurare permanentemente nel vostro file di impostazioni utilizzando il campo `model`

1325. **[Predefinito per le nuove sessioni](#set-a-default-model-for-new-sessions)**: imposta `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1325. **[Valore predefinito per le nuove sessioni](#set-a-default-model-for-new-sessions)**: impostare `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

133 133

134`/model` salva la tua scelta come predefinita per le nuove sessioni scrivendo il campo `model` nelle tue impostazioni utente. Nel selettore:134`/model` salva la vostra scelta come valore predefinito per le nuove sessioni scrivendo il campo `model` nelle impostazioni dell'utente. Nel selettore:

135 135

136* `Enter`: cambia modello e salva come predefinito136* `Enter`: passa il modello e salva come vostro valore predefinito

137* `s`: cambia modello solo per questa sessione e lascia il tuo predefinito invariato. Per utilizzare un tasto diverso, riassegna [`modelPicker:thisSessionOnly`](/docs/it/keybindings#model-picker-actions)137* `s`: passa il modello solo per questa sessione e lascia il vostro valore predefinito invariato. Per utilizzare un tasto diverso, riassegnare [`modelPicker:thisSessionOnly`](/docs/it/keybindings#model-picker-actions)

138 138

139Digitare `/model <name>` direttamente si comporta come `Enter`. Per cambiare solo per questa sessione, apri il selettore con `/model` e premi `s` sulla riga del modello.139Digitare `/model <name>` direttamente si comporta come `Enter`. Per passare solo per questa sessione, aprire il selettore con `/model` e premere `s` sulla riga del modello.

140 140

141Se cambi modelli con `/model`, il cambio raggiunge anche i [subagenti che ereditano il modello della conversazione principale](/docs/it/sub-agents#choose-a-model), perché Claude Code risolve il loro modello da quello che la tua sessione sta utilizzando quando Claude li avvia. Passa a Opus prima che Claude deleghi ricerche o esecuzioni di test a uno di loro, e quel lavoro viene eseguito su Opus anche. Per mantenere un subagente personalizzato su un modello più piccolo, imposta `model` nella sua definizione.141Su un piano Enterprise, quando siete connessi con il vostro account claude.ai e salvate un valore predefinito con `/model`, Claude Code registra anche la scelta su quell'account. Questo richiede Claude Code v2.1.280 o successiva.

142 142

143Se imposti un modello con `/model` in [modalità non interattiva](/docs/it/headless), con il flag `-p`, la tua scelta si applica solo alla sessione corrente e non viene salvata come predefinita; `/model` in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite hanno ancora la precedenza e si riapplicano al prossimo avvio. Un [modello predefinito dell'organizzazione](#organization-default-model) che il tuo amministratore ha configurato per ignorare la selezione dell'utente si riapplica anche al prossimo avvio.143* Quando il vostro amministratore non ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), l'opzione [Predefinito](#default-model-setting) può risolversi al modello registrato, e quando lo fa, la riga Predefinito del selettore mostra il nome di quel modello.

144* Se le [restrizioni del modello](#restrict-model-selection) escludono il modello registrato o non è disponibile per il vostro account, e il vostro amministratore non ha impostato un modello predefinito dell'organizzazione, l'opzione Predefinito si risolve come se nulla fosse stato registrato.

145* Se scegliete Predefinito o `opusplan` in `/model`, la scelta registrata non cambia.

144 146

145Nella v2.1.144 attraverso v2.1.152, `/model` si applicava solo alla sessione corrente e `d` nel selettore salvava un predefinito.147Se passate i modelli con `/model`, il passaggio raggiunge anche i [subagenti che ereditano il modello della conversazione principale](/docs/it/sub-agents#choose-a-model), perché Claude Code risolve il loro modello da quello che la vostra sessione sta utilizzando quando Claude li avvia. Passate a Opus prima che Claude deleghi ricerche o esecuzioni di test a uno di loro, e quel lavoro viene eseguito su Opus anche. Per mantenere un subagente personalizzato su un modello più piccolo, impostare `model` nella sua definizione.

146 148

147Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avvii con loro. Per eseguire modelli diversi in terminali diversi contemporaneamente, avvia ognuno con il suo flag `--model` piuttosto che cambiare con `/model`.149Se impostate un modello con `/model` in [modalità non interattiva](/docs/it/headless), con il flag `-p`, la vostra scelta si applica solo alla sessione corrente e non viene salvata come vostro valore predefinito; `/model` in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite hanno ancora la precedenza e si riapplicano al prossimo avvio. Un [modello predefinito dell'organizzazione](#organization-default-model) che il vostro amministratore ha configurato per ignorare la selezione dell'utente si riapplica anche al prossimo avvio.

148 150

149I prezzi nel selettore `/model` appaiono quando Claude Code parla con Anthropic API, direttamente o attraverso un [gateway LLM](/docs/it/llm-gateway) che lo proxies, e il prezzo su una riga è il prezzo del modello che quella riga seleziona. Su [provider di terze parti](/docs/it/third-party-integrations) come Amazon Bedrock e sul [gateway delle app Claude](/docs/it/claude-apps-gateway), il tuo provider o gateway determina quello che paghi, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello una riga seleziona o su cosa il tuo provider fattura. Prima della v2.1.206, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e le sessioni del gateway mostravano i prezzi di listino di Anthropic, e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.151Nella v2.1.144 attraverso v2.1.152, `/model` si applicava solo alla sessione corrente e `d` nel selettore salvava un valore predefinito.

150 152

151Le sessioni riprese avviate con `claude --resume`, `--continue`, o il selettore `/resume` mantengono il modello che stavano utilizzando quando la trascrizione è stata salvata, indipendentemente dall'impostazione `model` corrente. Se il modello ripristinato è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta `/model` di un'altra sessione cambi il modello al ripristino. Su provider che utilizzano ID di distribuzione specifici del provider piuttosto che ID di modello Anthropic, come Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, il modello della trascrizione non viene affatto ripristinato e la sessione risolve il suo modello attraverso l'ordine di precedenza normale.153Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avviate con loro. Per eseguire modelli diversi in terminali diversi contemporaneamente, avviate ciascuno con il suo flag `--model` piuttosto che passare con `/model`.

152 154

153Un modello che scegli per il nuovo avvio con `--model` o `ANTHROPIC_MODEL` ha ancora la precedenza sul modello ripristinato. A partire dalla v2.1.195, così fa una variabile della famiglia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) può farlo anche, secondo le condizioni elencate nella sua sezione.155I prezzi nel selettore `/model` appaiono quando Claude Code parla all'API Anthropic, direttamente o attraverso un [gateway LLM](/docs/it/llm-gateway) che lo fa da proxy, e il prezzo su una riga è il prezzo del modello che quella riga seleziona. Su [provider di terze parti](/docs/it/third-party-integrations) come Amazon Bedrock e sul [gateway delle app Claude](/docs/it/claude-apps-gateway), il vostro provider o gateway determina quello che pagate, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello una riga seleziona o su quello che il vostro provider fattura. Prima della v2.1.206, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e le sessioni del gateway mostravano i prezzi di listino di Anthropic, e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.

154 156

155Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite piuttosto che dalla tua selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Esegui `/model` per ignorare; l'impostazione di progetto o gestita si riapplica al prossimo avvio. Su piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un elenco di autorizzazione `availableModels` gestito rimane in vigore a meno che l'host non fornisca il suo; [Exceptions to managed settings precedence](/docs/it/settings#exceptions-to-managed-settings-precedence) dice quali chiavi e variabili l'host ignora.157Le sessioni riprese avviate con `claude --resume`, `--continue`, o il selettore `/resume` mantengono il modello che stavano utilizzando quando la trascrizione è stata salvata, indipendentemente dall'impostazione `model` corrente. Se il modello ripristinato è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta `/model` di un'altra sessione cambi il modello al ripristino. Su provider che utilizzano ID di distribuzione specifici del provider piuttosto che ID di modello Anthropic, come Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, il modello della trascrizione non viene affatto ripristinato e la sessione risolve il suo modello attraverso l'ordine di precedenza normale.

156 158

157Se tu o la tua organizzazione configurate [hook PreModelSwitch](/docs/it/hooks#premodelswitch), vengono eseguiti prima che un cambio richiesto si applichi e possono bloccarlo o chiederti di confermare.159Un modello che scegliete per il nuovo avvio con `--model` o `ANTHROPIC_MODEL` ha ancora la precedenza sul modello ripristinato. A partire dalla v2.1.195, così come una variabile della famiglia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) può anche, secondo le condizioni elencate nella sua sezione.

158 160

159Quando Claude Code non riesce a dire quali hook PreModelSwitch i [plugin gestiti](/docs/it/settings-reference#enabledplugins) della tua organizzazione forniscono, ad esempio perché un plugin gestito non è riuscito a caricarsi, rifiuta il cambio piuttosto che applicarlo senza controllo, e controlla di nuovo ad ogni nuovo tentativo. Consulta [Model switch was blocked by a PreModelSwitch hook](/docs/it/errors#model-switch-was-blocked-by-a-premodelswitch-hook) per il messaggio e il recupero.161Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite piuttosto che dalla vostra selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per ignorare; l'impostazione di progetto o gestita si riapplica al prossimo avvio. Su piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un elenco di consentiti `availableModels` gestito rimane in vigore a meno che l'host non fornisca il suo; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) dice quali chiavi e variabili l'host ignora.

160 162

161Quando cambi modelli attraverso il metodo `setModel()` dell'[Agent SDK](/docs/it/agent-sdk/overview) o da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control), o un'app come l'[app Desktop](/docs/it/desktop) che esegue il CLI di Claude Code cambia per te, Claude Code controlla che la stringa sia una che riconosce prima di salvarla. Questo controllo richiede Claude Code v2.1.200 o successiva. Controllare una scelta Remote Control richiede Claude Code v2.1.260 o successiva sulla tua macchina. Su Anthropic API, Claude Code riconosce:163Se voi o la vostra organizzazione configurate [hook PreModelSwitch](/docs/it/hooks#premodelswitch), vengono eseguiti prima che un passaggio richiesto si applichi e possono bloccarlo o chiedervi di confermare.

164

165Quando Claude Code non può dire quali hook PreModelSwitch i [plugin gestiti](/docs/it/settings-reference#enabledplugins) della vostra organizzazione forniscono, ad esempio perché un plugin gestito non è riuscito a caricarsi, rifiuta il passaggio piuttosto che applicarlo senza controllo, e controlla di nuovo ad ogni nuovo tentativo. Consultare [Il passaggio del modello è stato bloccato da un hook PreModelSwitch](/docs/it/errors#model-switch-was-blocked-by-a-premodelswitch-hook) per il messaggio e il recupero.

166

167Quando passate i modelli attraverso il metodo [`setModel()`](/docs/it/agent-sdk/overview) dell'Agent SDK o da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control), o un'app come l'[app Desktop](/docs/it/desktop) che esegue il CLI di Claude Code passa per voi, Claude Code controlla che la stringa sia una che riconosce prima di salvarla. Questo controllo richiede Claude Code v2.1.200 o successiva. Controllare una scelta di Remote Control richiede Claude Code v2.1.260 o successiva sulla vostra macchina. Sull'API Anthropic, Claude Code riconosce:

162 168

163* un alias del modello169* un alias del modello

164* una voce dal selettore `/model`170* una voce dal selettore `/model`

165* qualsiasi nome che inizia con `claude-`171* qualsiasi nome che inizia con `claude-`

166* un valore che hai configurato tu stesso come [opzione di modello personalizzato](#add-a-custom-model-option) o in [`modelOverrides`](#override-model-ids-per-version)172* un valore che avete configurato voi stessi come [opzione di modello personalizzato](#add-a-custom-model-option) o in [`modelOverrides`](#override-model-ids-per-version)

167 173

168Claude Code rifiuta una stringa non riconosciuta con `Model "<name>" is not a recognized model id.` e la sessione mantiene il suo modello attuale, invece di salvare la stringa e fallire alla prossima richiesta. Consulta [il riferimento dell'errore](/docs/it/errors#model-is-not-a-recognized-model-id) per i passaggi di recupero.174Claude Code rifiuta una stringa non riconosciuta con `Model "<name>" is not a recognized model id.` e la sessione mantiene il suo modello attuale, invece di salvare la stringa e fallire alla prossima richiesta. Consultare [il riferimento dell'errore](/docs/it/errors#model-is-not-a-recognized-model-id) per i passaggi di recupero.

169 175

170Il controllo viene eseguito solo su Anthropic API. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e dietro un [gateway LLM](/docs/it/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizzato, il tuo provider o gateway definisce i nomi dei modelli, quindi Claude Code passa qualsiasi stringa senza controllarla. Il controllo non copre nemmeno il flag `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, o l'impostazione `model`; un valore digitato male lì produce [There's an issue with the selected model](/docs/it/errors#theres-an-issue-with-the-selected-model) alla prima richiesta invece. Claude Code può comunque scrivere la [riga diagnostica del modello non riconosciuto](/docs/it/errors#unrecognized-model-id-on-a-request) al momento della richiesta, su ogni provider.176Il controllo viene eseguito solo sull'API Anthropic. Su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e dietro un [gateway LLM](/docs/it/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizzato, il vostro provider o gateway definisce i nomi dei modelli, quindi Claude Code passa qualsiasi stringa senza controllarla. Il controllo non copre nemmeno il flag `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, o l'impostazione `model`; un valore digitato male lì produce [C'è un problema con il modello selezionato](/docs/it/errors#theres-an-issue-with-the-selected-model) alla prima richiesta. Claude Code può comunque scrivere la [riga diagnostica del modello non riconosciuto](/docs/it/errors#unrecognized-model-id-on-a-request) al momento della richiesta, su ogni provider.

171 177

172Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che nomina il modello richiesto. Le sessioni interattive lo mostrano come un avviso di avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](/docs/it/headless) quando si utilizza il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter del subagente](/docs/it/sub-agents). L'avviso stderr è soppresso per `--output-format json` e `stream-json`; leggi il modello effettivo dal campo `modelUsage` del [messaggio di risultato](/docs/it/headless#get-structured-output) invece.178Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che nomina il modello richiesto. Le sessioni interattive lo mostrano come un avviso di avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](/docs/it/headless) quando si utilizza il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter del subagente](/docs/it/sub-agents). L'avviso su stderr è soppresso per `--output-format json` e `stream-json`; leggere il modello effettivo dal campo `modelUsage` del [messaggio di risultato](/docs/it/headless#get-structured-output) invece.

173 179

174Ad esempio, avvia una sessione su Opus:180Ad esempio, avviare una sessione su Opus:

175 181

176```bash theme={null}182```bash theme={null}

177claude --model opus183claude --model opus

178```184```

179 185

180Quindi cambia modelli dalla sessione:186Quindi passare i modelli dalla sessione:

181 187

182```text theme={null}188```text theme={null}

183/model sonnet189/model sonnet

195```201```

196 202

197<h4 id="set-a-default-model-for-new-sessions">203<h4 id="set-a-default-model-for-new-sessions">

198 Imposta un modello predefinito per le nuove sessioni204 Impostare un modello predefinito per le nuove sessioni

199</h4>205</h4>

200 206

201Imposta `ANTHROPIC_DEFAULT_MODEL=<alias|name>` per scegliere il modello su cui le tue sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.207Impostare `ANTHROPIC_DEFAULT_MODEL=<alias|name>` per scegliere il modello su cui le vostre sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.

202 208

203Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi seleziona un modello:209Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi seleziona un modello:

204 210

205* Il flag `--model`211* Il flag `--model`

206* `ANTHROPIC_MODEL`212* `ANTHROPIC_MODEL`

207* Un valore `model` in qualsiasi file di impostazioni, inclusa la scelta che salvi con `/model`213* Un valore `model` in qualsiasi file di impostazioni, inclusa la scelta che salvate con `/model`

208* Un [modello predefinito dell'organizzazione](#organization-default-model)214* Un [modello predefinito dell'organizzazione](#organization-default-model)

209 215

210Una scelta che salvi con `/model` ha la precedenza sulla variabile anche nei lanci successivi. Con `ANTHROPIC_MODEL` impostato invece, Claude Code ritorna al modello della variabile al prossimo lancio, qualunque cosa tu abbia salvato con `/model`.216Una scelta che salvate con `/model` ha la precedenza sulla variabile anche ai prossimi avvii. Con `ANTHROPIC_MODEL` impostato invece, Claude Code ritorna al modello della variabile al prossimo avvio, qualunque cosa abbiate salvato con `/model`.

211 217

212Claude Code risolve anche l'opzione Predefinito al modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Predefinito si risolve nel modello della variabile, la riga Predefinito nel selettore `/model` mostra l'etichetta Set by ANTHROPIC\_DEFAULT\_MODEL.218Claude Code risolve anche l'opzione Predefinito al modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Predefinito si risolve al modello della variabile, la riga Predefinito nel selettore `/model` mostra l'etichetta Impostato da ANTHROPIC\_DEFAULT\_MODEL.

213 219

214Claude Code ignora la variabile in questi casi e l'opzione Predefinito si risolve come se non l'avessi impostata:220Claude Code ignora la variabile in questi casi, e l'opzione Predefinito si risolve come se non l'aveste impostata:

215 221

216* L'hai impostata su `default`, `inherit`, `opusplan`, o `haiku`222* L'avete impostata a `default`, `inherit`, `opusplan`, o `haiku`

217* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è attivo223* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è attivo

218* [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) escludono il modello224* Le [restrizioni del modello](#restrict-model-selection) della vostra organizzazione escludono il modello

219* Il modello non è disponibile per il tuo account225* Il modello non è disponibile per il vostro account

220 226

221Quando una nuova sessione si avvierebbe sul modello della variabile, una sessione che riprendi con `claude --resume`, `--continue`, o il selettore `/resume` si avvia su di esso anche. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Altrimenti Claude Code non utilizza la variabile quando [riprendi una sessione](#setting-your-model).227Quando una nuova sessione si avvierebbe sul modello della variabile, una sessione che riprendete con `claude --resume`, `--continue`, o il selettore `/resume` si avvia su di esso anche. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Altrimenti Claude Code non utilizza la variabile quando [riprendete una sessione](#setting-your-model).

222 228

223<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">229<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

224 Una nuova sessione si avvia su un modello diverso da quello che hai scelto230 Una nuova sessione si avvia su un modello diverso da quello che avete scelto

225</h4>231</h4>

226 232

227Quando scegli un modello con `/model` e la tua prossima sessione si avvia su qualcos'altro, queste sono le cause solite:233Quando scegliete un modello con `/model` e la vostra prossima sessione si avvia su qualcos'altro, queste sono le cause solite:

228 234

229* **L'hai scelto per una sessione.** Premere `s` nel selettore, avviare con `--model`, e eseguire `/model` in modalità non interattiva si applicano tutti alla sessione corrente e lasciano il tuo predefinito salvato da solo.235* **L'avete scelto per una sessione.** Premere `s` nel selettore, avviare con `--model`, e eseguire `/model` in modalità non interattiva si applicano tutti alla sessione corrente e lasciano il vostro valore predefinito salvato da solo.

230* **Qualcosa con priorità più alta imposta il modello.** Un valore `model` nelle impostazioni di progetto o gestite, `ANTHROPIC_MODEL` nella tua shell, o un [modello predefinito dell'organizzazione](#organization-default-model) che il tuo amministratore ha impostato per ignorare le scelte dell'utente si applica di nuovo ad ogni lancio. La tua scelta `/model` è ancora salvata; è superata. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio nomina il file.236* **Qualcosa con priorità più alta imposta il modello.** Un valore `model` nelle impostazioni di progetto o gestite, `ANTHROPIC_MODEL` nella vostra shell, o un [modello predefinito dell'organizzazione](#organization-default-model) che il vostro amministratore ha impostato per ignorare le scelte dell'utente si applica di nuovo ad ogni avvio. La vostra scelta `/model` è ancora salvata; è superata. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio nomina il file.

231* **Claude Code non ha potuto salvare la tua scelta.** `/model` scrive `model` in `~/.claude/settings.json`. Se non puoi scrivere in quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, il modello che hai scelto dura per la sessione e il prossimo lancio legge il valore vecchio. Imposta `model` nello strumento che genera il file, o rendi il file scrivibile. Consulta [A change you made in Claude Code is lost in new sessions](/docs/it/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).237* **Claude Code non poteva salvare la vostra scelta.** `/model` scrive `model` a `~/.claude/settings.json`. Se non potete scrivere su quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, il modello che avete scelto dura per la sessione e il prossimo avvio legge il valore vecchio. Impostare `model` nello strumento che genera il file, o rendere il file scrivibile. Consultare [Una modifica che avete fatto in Claude Code viene persa nelle nuove sessioni](/docs/it/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

232* **Hai ripreso una sessione.** Una sessione che riprendi con `claude --resume` o `--continue` di solito [mantiene il modello che stava utilizzando](#setting-your-model) piuttosto che il tuo predefinito attuale.238* **Avete ripreso una sessione.** Una sessione che riprendete con `claude --resume` o `--continue` solitamente [mantiene il modello che stava utilizzando](#setting-your-model) piuttosto che il vostro valore predefinito attuale.

233 239

234<h2 id="restrict-model-selection">240<h2 id="restrict-model-selection">

235 Limitare la selezione del modello241 Limitare la selezione del modello

236</h2>242</h2>

237 243

238Gli amministratori aziendali possono utilizzare `availableModels` nelle [impostazioni gestite o di policy](/docs/it/managed-settings) per limitare quali modelli gli utenti possono selezionare. Le voci corrispondono a una famiglia di modelli come `sonnet`, un prefisso di versione come `claude-sonnet-4-5`, o un ID modello completo come `claude-sonnet-4-5-20250929`. Un prefisso di versione corrisponde anche a ID modello successivi che lo estendono con un altro segmento, quindi `claude-fable-5` consente sia Fable 5 che Fable 5.1, mentre `claude-fable-5-1` consente solo Fable 5.1.244Gli amministratori aziendali possono utilizzare `availableModels` nelle [impostazioni gestite o di policy](/docs/it/managed-settings) per limitare quali modelli gli utenti possono selezionare. Le voci corrispondono a una famiglia di modelli come `sonnet`, un prefisso di versione come `claude-sonnet-4-5`, o un ID modello completo come `claude-sonnet-4-5-20250929`. Un prefisso di versione corrisponde anche a ID modello successivi che lo estendono con un altro segmento, quindi `claude-fable-5` consente sia Fable 5 che Fable 5.1, mentre `claude-fable-5-1` consente solo Fable 5.1. Per bloccare un modello che l'elenco consente, o per fare in modo che ogni voce di ID modello consenta solo la versione che nomina, vedere [Bloccare modelli o versioni specifici](#block-specific-models-or-versions).

239 245

240Sulle piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza rispetto alle impostazioni del modello gestito, mentre un allowlist `availableModels` gestito rimane in vigore a meno che l'host non fornisca il proprio; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) indica quali chiavi e variabili l'host sostituisce.246Sulle piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza rispetto alle impostazioni del modello gestito, mentre un allowlist `availableModels` gestito rimane in vigore a meno che l'host non fornisca il proprio; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) indica quali chiavi e variabili l'host sostituisce.

241 247

305 Comportamento del modello predefinito311 Comportamento del modello predefinito

306</h3>312</h3>

307 313

308Da solo, `availableModels` lascia l'opzione Predefinito sul [valore predefinito di runtime](#default-model-setting) del sistema per l'account fino a quando non imposti anche [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Se quel valore predefinito è un modello che intendi limitare, imposta anche `enforceAvailableModels`.314Con la corrispondenza del prefisso predefinita, `availableModels` da solo lascia l'opzione Predefinito sul [valore predefinito di runtime](#default-model-setting) del sistema per l'account fino a quando non imposti anche [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Se quel valore predefinito è un modello che intendi limitare, imposta anche `enforceAvailableModels`, o [blocca quel modello](#block-specific-models-or-versions).

309 315

310Un array `availableModels` vuoto non attiva mai l'applicazione del modello Predefinito: con `availableModels: []`, le selezioni di modelli denominati vengono bloccate ma il modello Predefinito per il tipo di account rimane utilizzabile indipendentemente da `enforceAvailableModels`.316Con `availableModels: []`, le selezioni di modelli denominati vengono bloccate e `enforceAvailableModels` non ha alcun effetto.

311 317

312<h3 id="enforce-the-allowlist-for-the-default-model">318<h3 id="enforce-the-allowlist-for-the-default-model">

313 Applicare l'allowlist per il modello Predefinito319 Applicare l'allowlist per il modello Predefinito

322}328}

323```329```

324 330

325L'opzione Predefinito si risolve nel valore predefinito del tipo di account, o nel [modello predefinito dell'organizzazione](#organization-default-model) quando un amministratore ne ha impostato uno. Quando quel modello non è nell'allowlist, l'opzione Predefinito si risolve invece nella prima voce `availableModels` che nomina un modello consentito e disponibile, e la riga Predefinito del selezionatore `/model` mostra quel modello. Questo si applica ovunque il valore predefinito sia raggiunto: avvio della sessione, selezione di Predefinito in `/model`, la parola chiave `"default"` nelle [catene di modelli di fallback](#fallback-model-chains), e il fallback utilizzato quando una selezione esclusa viene eliminata.331Per un membro senza un modello [registrato sul suo account](#setting-your-model), l'opzione Predefinito si risolve nel valore predefinito del tipo di account, o nel [modello predefinito dell'organizzazione](#organization-default-model) quando un amministratore ne ha impostato uno. Quando quel modello non è nell'allowlist, l'opzione Predefinito si risolve invece nella prima voce `availableModels` che nomina un modello consentito e disponibile, e la riga Predefinito del selezionatore `/model` mostra quel modello. Questo si applica ovunque il valore predefinito sia raggiunto: avvio della sessione, selezione di Predefinito in `/model`, la parola chiave `"default"` nelle [catene di modelli di fallback](#fallback-model-chains), e il fallback utilizzato quando una selezione esclusa viene eliminata. Un modello registrato sul account di un membro viene controllato anche rispetto a `availableModels`; [Setting your model](#setting-your-model) descrive come l'opzione Predefinito lo tratta.

326 332

327`enforceAvailableModels` rimappa l'opzione Predefinito solo quando `availableModels` è non vuoto. Con `availableModels: []`, il modello Predefinito per il tipo di account rimane utilizzabile, quindi l'impostazione non può bloccare gli utenti da ogni modello. Quando `availableModels` è non vuoto ma nessuna voce si risolve in un modello consentito e disponibile, l'applicazione viene saltata e Predefinito si risolve nel valore predefinito del tipo di account, con un avviso visibile solo sotto `--debug`. Mantieni almeno una voce garantita disponibile nell'elenco per evitare questo.333`enforceAvailableModels` rimappa l'opzione Predefinito solo quando `availableModels` è non vuoto. Quando `availableModels` è non vuoto ma nessuna voce si risolve in un modello consentito e disponibile, l'applicazione viene saltata con un avviso visibile solo sotto `--debug`. Mantieni almeno una voce garantita disponibile nell'elenco per evitare questo.

328 334

329Distribuisci entrambe le chiavi insieme nella fonte gestita con il ranking più alto che consegni. Per impostazione predefinita Claude Code legge solo quella fonte, quindi una coppia posizionata in un file di impostazioni gestite viene ignorata quando la console di amministrazione consegna qualsiasi impostazione; secondo il merge opt-in in [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources), Claude Code ignora comunque una mappa `modelOverrides` da una fonte classificata al di sotto di quella che imposta `availableModels`.335Distribuisci entrambe le chiavi insieme nella fonte gestita con il ranking più alto che consegni. Per impostazione predefinita Claude Code legge solo quella fonte, quindi una coppia posizionata in un file di impostazioni gestite viene ignorata quando la console di amministrazione consegna qualsiasi impostazione; secondo il merge opt-in in [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources), Claude Code ignora comunque una mappa `modelOverrides` da una fonte classificata al di sotto di quella che imposta `availableModels`.

330 336

332 Controllare il modello su cui gli utenti vengono eseguiti338 Controllare il modello su cui gli utenti vengono eseguiti

333</h3>339</h3>

334 340

335L'impostazione `model` è una selezione iniziale, non un'applicazione. Imposta quale modello è attivo quando una sessione inizia, ma gli utenti possono comunque aprire `/model` e scegliere Predefinito, che si risolve nel [valore predefinito di runtime](#default-model-setting) del sistema indipendentemente da cosa sia impostato `model`, a meno che [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) non lo reindizzi.341L'impostazione `model` è una selezione iniziale, non un'applicazione. Imposta quale modello è attivo quando una sessione inizia, ma gli utenti possono comunque aprire `/model` e scegliere Predefinito, che si risolve nel [valore predefinito di runtime](#default-model-setting) del sistema indipendentemente da cosa sia impostato `model`, a meno che [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) o le [chiavi che bloccano versioni specifiche](#block-specific-models-or-versions) non si applichino a esso.

336 342

337Per controllare completamente l'esperienza del modello, combina queste impostazioni:343Per controllare completamente l'esperienza del modello, combina queste impostazioni:

338 344

339* **`availableModels`**: limita quali modelli denominati gli utenti possono passare a345* **`availableModels`**: limita quali modelli denominati gli utenti possono passare a

340* **`enforceAvailableModels`**: estende l'allowlist `availableModels` all'opzione Predefinito, quindi Predefinito non può risolversi in un modello al di fuori dell'elenco346* **`enforceAvailableModels`**: estende l'allowlist `availableModels` all'opzione Predefinito, quindi Predefinito non può risolversi in un modello al di fuori dell'elenco

347* **`deniedModels`** e **`availableModelsMatch`**: [blocca versioni specifiche](#block-specific-models-or-versions) che una voce `availableModels` altrimenti consentirebbe

341* **`model`**: imposta la selezione del modello iniziale quando una sessione inizia348* **`model`**: imposta la selezione del modello iniziale quando una sessione inizia

342* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: controllano a cosa si risolvono gli alias `sonnet`, `opus`, `haiku`, e `fable`, e quale versione utilizza il [valore predefinito del tipo di account](#default-model-setting)349* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: controllano a cosa si risolvono gli alias `sonnet`, `opus`, `haiku`, e `fable`, e quale versione utilizza il [valore predefinito del tipo di account](#default-model-setting)

343 350

370 377

371Quando l'[endpoint Amazon Bedrock Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) è abilitato, le voci in `availableModels` che iniziano con `anthropic.` vengono aggiunte al selezionatore `/model` come opzioni personalizzate e instradate all'endpoint Mantle. Questa è un'eccezione alla corrispondenza dell'alias descritta in [Fissare modelli per distribuzioni di terze parti](#pin-models-for-third-party-deployments). L'impostazione limita comunque il selezionatore alle voci elencate, e un ID Mantle incorpora un nome di famiglia, quindi conta come una voce specifica e disabilita il wildcard della famiglia: insieme a qualsiasi ID Mantle, elenca i prefissi di versione o gli ID completi che desideri mantenere selezionabili. Vedere [Comportamento di merge](#merge-behavior).378Quando l'[endpoint Amazon Bedrock Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) è abilitato, le voci in `availableModels` che iniziano con `anthropic.` vengono aggiunte al selezionatore `/model` come opzioni personalizzate e instradate all'endpoint Mantle. Questa è un'eccezione alla corrispondenza dell'alias descritta in [Fissare modelli per distribuzioni di terze parti](#pin-models-for-third-party-deployments). L'impostazione limita comunque il selezionatore alle voci elencate, e un ID Mantle incorpora un nome di famiglia, quindi conta come una voce specifica e disabilita il wildcard della famiglia: insieme a qualsiasi ID Mantle, elenca i prefissi di versione o gli ID completi che desideri mantenere selezionabili. Vedere [Comportamento di merge](#merge-behavior).

372 379

380<h3 id="block-specific-models-or-versions">

381 Bloccare modelli o versioni specifici

382</h3>

383

384Una voce `availableModels` come `claude-opus-5` consente anche rilasci successivi che la estendono, come Opus 5.5, non appena Claude Code li supporta. Due impostazioni gestite ti permettono di trattenere un rilascio, e entrambe richiedono Claude Code v2.1.283 o successivo:

385

386* [`deniedModels`](/docs/it/settings-reference#deniedmodels): elenca i modelli da bloccare. Un modello elencato viene bloccato anche quando `availableModels` lo consente, e la chiave funziona anche senza alcun allowlist. Un rilascio che nessuna voce blocca rimane consentito

387* [`availableModelsMatch`](/docs/it/settings-reference#availablemodelsmatch): impostalo su `"exact"` in modo che ogni ID modello in `availableModels` consenta solo la versione che nomina. Una versione più recente di un ID modello elencato rimane quindi bloccata fino a quando non la aggiungi all'elenco

388

389Le versioni precedenti ignorano entrambe le chiavi, quindi imposta anche [`requiredMinimumVersion`](/docs/it/settings-reference#requiredminimumversion) per impedire a quelle versioni di avviarsi.

390

391Questo esempio consente modelli Opus e Sonnet e blocca Opus 5.5 in ogni ortografia, inclusi ID datati e specifici del provider:

392

393```json theme={null}

394{

395 "availableModels": ["opus", "sonnet"],

396 "deniedModels": ["claude-opus-5-5"]

397}

398```

399

400Un modello bloccato, sia che `deniedModels` lo nomini o che un elenco `"exact"` lo ometta, viene trattato come una selezione bloccata ovunque [l'allowlist si applica](#restrict-model-selection). È nascosto dal selezionatore `/model`, e `/model <name>` lo rifiuta. Se nomini un ID modello bloccato con `--model`, `ANTHROPIC_MODEL`, o l'impostazione `model`, Claude Code lo elimina all'avvio e risolve l'opzione Predefinito invece. Se un [hook](/docs/it/hooks) o una richiesta in background nomina un modello che `deniedModels` blocca, come il campo `model` di un hook di agent, quella richiesta viene eseguita sul modello della sessione invece.

401

402L'opzione Predefinito segue entrambe le chiavi anche, indipendentemente dal fatto che tu imposti [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Se lo imposti con un `availableModels` non vuoto, un valore predefinito bloccato conta come un modello al di fuori dell'allowlist. Altrimenti, un'opzione Predefinito che si risolverebbe in un modello bloccato scende in questo ordine:

403

4041. La versione più recente consentita della stessa famiglia

4052. Il modello più recente consentito di ogni famiglia di costo inferiore a turno: Sonnet, poi Haiku

4063. La prima voce `availableModels` che nomina un modello consentito

407

408Se nessuno di questi è consentito, una sessione che inizia sull'opzione Predefinito [rifiuta di avviarsi](/docs/it/errors#managed-settings-block-the-default-model) con un errore che nomina la chiave da correggere. Un elenco `"exact"` influisce sull'opzione Predefinito solo quando l'elenco `availableModels` gestito nomina almeno un modello o una famiglia.

409

410Claude Code legge entrambe le chiavi solo dalle impostazioni gestite. Se imposti una di esse nelle impostazioni utente, progetto o locale o con `--settings`, Claude Code la ignora con un avviso.

411

373<h3 id="organization-model-restrictions">412<h3 id="organization-model-restrictions">

374 Restrizioni del modello dell'organizzazione413 Restrizioni del modello dell'organizzazione

375</h3>414</h3>

417 456

418Il modello predefinito dell'organizzazione passa attraverso questi controlli di restrizione prima di essere adottato:457Il modello predefinito dell'organizzazione passa attraverso questi controlli di restrizione prima di essere adottato:

419 458

420* [`availableModels`](#restrict-model-selection) da solo non si applica al modello predefinito dell'organizzazione, quindi un modello predefinito dell'organizzazione al di fuori della lista di autorizzazione si applica comunque. Quando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è anche impostato, un modello predefinito dell'organizzazione al di fuori della lista di autorizzazione viene rimappato alla prima voce della lista di autorizzazione, come qualsiasi altro Predefinito459* Con la corrispondenza del prefisso predefinito, [`availableModels`](#restrict-model-selection) da solo non si applica al modello predefinito dell'organizzazione, quindi un modello predefinito dell'organizzazione al di fuori della lista di autorizzazione si applica comunque. Quando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è anche impostato, un modello predefinito dell'organizzazione al di fuori della lista di autorizzazione viene rimappato alla prima voce della lista di autorizzazione come pure

421* un modello predefinito dell'organizzazione che [restrizioni del modello dell'organizzazione](#organization-model-restrictions) negano per il vostro account viene sostituito dal modello più recente consentito nella sua famiglia, o da una famiglia a costo inferiore quando ogni versione di essa è limitata460* un modello predefinito dell'organizzazione che [restrizioni del modello dell'organizzazione](#organization-model-restrictions) negano per il vostro account viene sostituito dal modello più recente consentito nella sua famiglia, o da una famiglia a costo inferiore quando ogni versione di essa è limitata

461* per un modello predefinito dell'organizzazione che `deniedModels` o un elenco `"exact"` blocca, vedere [Bloccare modelli o versioni specifiche](#block-specific-models-or-versions)

422* un modello predefinito dell'organizzazione che non è disponibile per il vostro account affatto viene saltato, e l'opzione Predefinito si risolve come farebbe [senza un modello predefinito dell'organizzazione](#default-model-setting)462* un modello predefinito dell'organizzazione che non è disponibile per il vostro account affatto viene saltato, e l'opzione Predefinito si risolve come farebbe [senza un modello predefinito dell'organizzazione](#default-model-setting)

423 463

424A partire dalla v2.1.199, quando il modello predefinito dell'organizzazione è una famiglia di modelli diversa dal modello predefinito usuale del tipo di account vostro, il selettore `/model` mantiene una riga separata per quella famiglia usuale, in modo che possiate comunque passare ad essa per una sessione. Dalla v2.1.196 alla v2.1.198 quella riga manca dal selettore.464A partire dalla v2.1.199, quando il modello predefinito dell'organizzazione è una famiglia di modelli diversa dal modello predefinito usuale del tipo di account vostro, il selettore `/model` mantiene una riga separata per quella famiglia usuale, in modo che possiate comunque passare ad essa per una sessione. Dalla v2.1.196 alla v2.1.198 quella riga manca dal selettore.

451 491

452Prima della v2.1.280, `default` si risolveva in Sonnet 5 su Pro e Team Standard, e in Opus 5 su Max, Team Premium, Enterprise, Anthropic API, Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.219. Prima della v2.1.219, `default` si risolveva in Opus 4.8 su Anthropic API, Max, Team Premium e Enterprise con pagamento a consumo da v2.1.154, e su Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.207. Prima della v2.1.207, `default` si risolveva in Opus 4.7 su Claude Platform su AWS e in Sonnet 4.5 su Amazon Bedrock e Google Cloud's Agent Platform.492Prima della v2.1.280, `default` si risolveva in Sonnet 5 su Pro e Team Standard, e in Opus 5 su Max, Team Premium, Enterprise, Anthropic API, Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.219. Prima della v2.1.219, `default` si risolveva in Opus 4.8 su Anthropic API, Max, Team Premium e Enterprise con pagamento a consumo da v2.1.154, e su Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.207. Prima della v2.1.207, `default` si risolveva in Opus 4.7 su Claude Platform su AWS e in Sonnet 4.5 su Amazon Bedrock e Google Cloud's Agent Platform.

453 493

454Quando un amministratore ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), `default` si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. `default` può anche risolversi nel modello impostato con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), secondo le condizioni elencate nella relativa sezione.494Quando un amministratore ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), `default` si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. `default` può anche risolversi nel modello impostato con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), secondo le condizioni elencate nella relativa sezione, o nel modello [registrato sul tuo account](#setting-your-model).

455 495

456Quando le impostazioni gestite [applicano l'elenco consentito per il modello predefinito](#enforce-the-allowlist-for-the-default-model) e il valore predefinito del tipo di account non è in `availableModels`, `default` si risolve nel valore predefinito applicato invece del valore predefinito del tipo di account sopra indicato. Quando entrambi si applicano, il valore predefinito dell'organizzazione sostituisce prima il valore predefinito del tipo di account e l'applicazione si applica quindi ad esso: un valore predefinito dell'organizzazione nell'elenco consentito viene mantenuto, mentre uno al di fuori dell'elenco si risolve nel valore predefinito applicato.496Quando nulla è registrato sul tuo account, le impostazioni gestite [applicano l'elenco consentito per il modello predefinito](#enforce-the-allowlist-for-the-default-model), e il valore predefinito del tipo di account non è in `availableModels`, `default` si risolve nel valore predefinito applicato invece del valore predefinito del tipo di account sopra indicato. Quando entrambi si applicano, il valore predefinito dell'organizzazione sostituisce prima il valore predefinito del tipo di account e l'applicazione si applica quindi ad esso: un valore predefinito dell'organizzazione nell'elenco consentito viene mantenuto, mentre uno al di fuori dell'elenco si risolve nel valore predefinito applicato.

457 497

458I modelli Fable non sono il valore predefinito del tipo di account su nessun piano o provider. Sceglierne uno con `/model` lo salva come modello selezionato nelle impostazioni utente, in modo che le sessioni successive inizino su di esso. Per il cambio una tantum che Claude Code apporta a una selezione Fable 5 salvata nella v2.1.257, vedere [Lavorare con Fable](#work-with-fable).498I modelli Fable non sono il valore predefinito del tipo di account su nessun piano o provider. Sceglierne uno con `/model` lo salva come modello selezionato nelle impostazioni utente, in modo che le sessioni successive inizino su di esso. Per il cambio una tantum che Claude Code apporta a una selezione Fable 5 salvata nella v2.1.257, vedere [Lavorare con Fable](#work-with-fable).

459 499

463 503

464L'alias del modello `opusplan` fornisce un approccio ibrido automatizzato:504L'alias del modello `opusplan` fornisce un approccio ibrido automatizzato:

465 505

466* **In modalità piano**: utilizza `opus` per il ragionamento complesso e le decisioni architettoniche506* **In Plan Mode**: utilizza `opus` per il ragionamento complesso e le decisioni architettoniche

467* **In modalità esecuzione**: passa automaticamente a `sonnet` per la generazione del codice e l'implementazione507* **In modalità esecuzione**: passa automaticamente a `sonnet` per la generazione del codice e l'implementazione

468 508

469Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.509Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.

470 510

471La fase Opus in modalità piano utilizza la stessa finestra di contesto dell'impostazione del modello `opus`, e la fase di esecuzione utilizza la stessa finestra di `sonnet`. Quando `opus` e `sonnet` si risolvono in modelli che vengono eseguiti con la [finestra di contesto 1M](#extended-context) per impostazione predefinita, come i modelli attuali su Anthropic API, entrambe le fasi vengono eseguite con essa. Per richiedere il contesto 1M per entrambe le fasi dove non lo fanno, [imposta il modello](#setting-your-model) su `opusplan[1m]`, ad esempio con `/model opusplan[1m]`. Impostarlo con `/model` richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag `--model` o l'impostazione `model`.511La fase Opus in Plan Mode utilizza la stessa finestra di contesto dell'impostazione del modello `opus`, e la fase di esecuzione utilizza la stessa finestra di `sonnet`. Quando `opus` e `sonnet` si risolvono in modelli che vengono eseguiti con la [finestra di contesto 1M](#extended-context) per impostazione predefinita, come i modelli attuali su Anthropic API, entrambe le fasi vengono eseguite con essa. Per richiedere il contesto 1M per entrambe le fasi dove non lo fanno, [imposta il modello](#setting-your-model) su `opusplan[1m]`, ad esempio con `/model opusplan[1m]`. Impostarlo con `/model` richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag `--model` o l'impostazione `model`.

472 512

473Quando [`availableModels`](#restrict-model-selection) esclude l'Opus più recente ma consente una versione precedente, ad esempio `["sonnet", "claude-opus-4-6"]`, `opusplan` utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente si aggiornerebbe a Sonnet in modalità piano utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, la modalità piano rimase sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'elenco consentito ne consentiva una precedente.513Quando [`availableModels`](#restrict-model-selection) esclude l'Opus più recente ma consente una versione precedente, ad esempio `["sonnet", "claude-opus-4-6"]`, `opusplan` utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente si aggiornerebbe a Sonnet in Plan Mode utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, Plan Mode rimase sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'elenco consentito ne consentiva una precedente.

474 514

475La sostituzione di una versione precedente consentita si applica su Anthropic API e [Claude Platform su AWS](/docs/it/claude-platform-on-aws). Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, i cui deployment utilizzano ID modello specifici del provider, la modalità piano rimane sul modello della sessione ogni volta che il modello di aggiornamento è escluso.515La sostituzione di una versione precedente consentita si applica su Anthropic API e [Claude Platform su AWS](/docs/it/claude-platform-on-aws). Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, i cui deployment utilizzano ID modello specifici del provider, Plan Mode rimane sul modello della sessione ogni volta che il modello di aggiornamento è escluso.

476 516

477Per un approccio ibrido in cui Claude decide a metà attività quando consultare un secondo modello piuttosto che passare al confine del piano, vedere lo [strumento advisor](/docs/it/advisor).517Per un approccio ibrido in cui Claude decide a metà attività quando consultare un secondo modello piuttosto che passare al confine del piano, vedere lo [strumento advisor](/docs/it/advisor).

478 518

513 Fallback automatico del modello553 Fallback automatico del modello

514</h3>554</h3>

515 555

516Questa sezione copre il fallback basato sul contenuto dai modelli Fable, Opus 5.5 e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, vedere [Catene di modelli di fallback](#fallback-model-chains).556Questa sezione copre il fallback basato sul contenuto dai modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, vedere [Catene di modelli di fallback](#fallback-model-chains).

517 557

518I modelli Fable, Opus 5.5 e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte contrassegnano il contenuto di sicurezza informatica e biologia. Quando un classificatore contrassegna una richiesta e la categoria contrassegnata ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e mostra un avviso nella trascrizione. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:558I modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte contrassegnano il contenuto di sicurezza informatica e biologia. Quando un classificatore contrassegna una richiesta e la categoria contrassegnata ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e mostra un avviso nella trascrizione. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:

519 559

520* **Fable 5.1, Fable 5 e Opus 5.5**: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.560* **Fable 5.1, Fable 5 e Opus 5.5**: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.

561* **Sonnet 5.5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Sonnet 5. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Sonnet 5.5 non ha un modello di fallback biologico.

521* **Opus 5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.562* **Opus 5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.

522 563

523Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve questi target attraverso il tuo deployment, e se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le categorie che hanno un fallback vengono rieseguite sul modello bloccato; vedere [Abilitare il fallback su Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).564Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve questi target attraverso il tuo deployment's model IDs. Vedere [Abilitare il fallback su Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

524 565

525Dopo un fallback, la sessione continua sul modello di fallback. Per tornare al tuo modello originale, esegui [`/model`](#setting-your-model).566Dopo un fallback, la sessione continua sul modello di fallback. Per tornare al tuo modello originale, esegui [`/model`](#setting-your-model).

526 567

544 585

545Alcuni casi si comportano diversamente:586Alcuni casi si comportano diversamente:

546 587

547* Quando la categoria contrassegnata non ha un modello di fallback, come un flag di biologia su Opus 5, Claude Code non mostra il prompt e la richiesta termina con il rifiuto.588* Quando la categoria contrassegnata non ha un modello di fallback, come un flag di biologia su Opus 5 o Sonnet 5.5, Claude Code non mostra il prompt e la richiesta termina con il rifiuto.

548* Se entrambi i modelli contrassegnano la stessa richiesta, puoi modificare il prompt e riprovare, o avviare una nuova sessione.589* Se entrambi i modelli contrassegnano la stessa richiesta, puoi modificare il prompt e riprovare, o avviare una nuova sessione.

549* Su sessioni mobili [Claude Code sul web](/docs/it/claude-code-on-the-web), la modifica e il retry non sono supportati. Cambia modelli o continua la sessione da un browser desktop o dall'app desktop.590* Su sessioni mobili [Claude Code sul web](/docs/it/claude-code-on-the-web), la modifica e il retry non sono supportati. Cambia modelli o continua la sessione da un browser desktop o dall'app desktop.

550* In [modalità non interattiva](/docs/it/cli-reference#cli-flags) e integrazioni SDK che non possono mostrare il prompt, una richiesta contrassegnata termina il turno con un rifiuto.591* In [modalità non interattiva](/docs/it/cli-reference#cli-flags) e integrazioni SDK che non possono mostrare il prompt, una richiesta contrassegnata termina il turno con un rifiuto.

556 597

557Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare entrambi i modelli coinvolti:598Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare entrambi i modelli coinvolti:

558 599

559* Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene `claude-fable-5`, corrisponde al valore di `ANTHROPIC_DEFAULT_FABLE_MODEL` o è mappato con [`modelOverrides`](#override-model-ids-per-version). Opus 5.5 e Opus 5 vengono riconosciuti dal loro ID modello del provider o da un mapping [`modelOverrides`](#override-model-ids-per-version).600* Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene `claude-fable-5`, corrisponde al valore di `ANTHROPIC_DEFAULT_FABLE_MODEL` o è mappato con [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 e Opus 5 vengono riconosciuti dal loro ID modello del provider o da un mapping [`modelOverrides`](#override-model-ids-per-version).

560* Il modello di fallback deve risolversi nel tuo deployment. Se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le richieste contrassegnate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste contrassegnate per sicurezza informatica vengono rieseguite su una voce Opus 4.8 nell'elenco dei modelli del provider, e le richieste contrassegnate per biologia da un modello Fable o Opus 5.5 su una voce Opus 5.601* Un target Opus deve risolversi nel tuo deployment, indipendentemente da quale modello ha rifiutato: imposta `ANTHROPIC_DEFAULT_OPUS_MODEL`, o mantieni una voce Opus 4.8 nell'elenco dei modelli del provider. Senza uno, il fallback rimane disattivato per ogni modello sorgente, incluso Sonnet 5.5, e le richieste contrassegnate terminano con un rifiuto.

602* Il modello di fallback della categoria contrassegnata deve risolversi nel tuo deployment. Da un modello Fable, Opus 5.5 o Opus 5, se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le richieste contrassegnate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste contrassegnate per sicurezza informatica vengono rieseguite sulla voce Opus 4.8, e le richieste contrassegnate per biologia da un modello Fable o Opus 5.5 su una voce Opus 5. Da Sonnet 5.5, le richieste contrassegnate per sicurezza informatica vengono rieseguite sul modello che imposti in `ANTHROPIC_DEFAULT_SONNET_MODEL`, o su una voce Sonnet 5 nell'elenco dei modelli del provider se non lo imposti.

603

604Se uno dei modelli non può essere identificato, Claude Code non passa. La richiesta contrassegnata termina con un messaggio di rifiuto e puoi cambiare modelli con [`/model`](#setting-your-model) e riprovare. Per rendere entrambi i modelli identificabili, imposta i pin per il tuo modello sorgente:

561 605

562Se uno dei modelli non può essere identificato, Claude Code non passa automaticamente. La richiesta contrassegnata termina con un messaggio di rifiuto e puoi cambiare modelli con [`/model`](#setting-your-model) e riprovare. Impostare `ANTHROPIC_DEFAULT_FABLE_MODEL` sul tuo ID modello Fable abilita il riconoscimento di Fable. Impostare `ANTHROPIC_DEFAULT_OPUS_MODEL` su un ID modello Opus fornisce alle categorie contrassegnate un target di fallback, a meno che il pin non nomini un modello al di fuori della famiglia Opus o il modello che ha rifiutato; quindi Claude Code non passa e il rifiuto rimane.606* **Modelli Fable**: imposta `ANTHROPIC_DEFAULT_FABLE_MODEL` sul tuo ID modello Fable in modo che Claude Code lo riconosca come fonte di fallback.

607* **Ogni modello sorgente**: imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` su un ID modello Opus per attivare il fallback e fornire alle categorie contrassegnate un target. Un pin che nomina un modello al di fuori della famiglia Opus, o il modello che ha rifiutato, lascia il rifiuto in piedi.

608* **Sonnet 5.5**: oltre al pin Opus, imposta `ANTHROPIC_DEFAULT_SONNET_MODEL` o mantieni una voce Sonnet 5 nell'elenco dei modelli del provider per fornire il modello su cui la richiesta viene rieseguita. Un pin Sonnet che nomina un modello al di fuori della famiglia Sonnet, o Sonnet 5.5 stesso, lascia il rifiuto in piedi.

563 609

564<h4 id="security-research-and-biology-workloads">610<h4 id="security-research-and-biology-workloads">

565 Ricerca sulla sicurezza e carichi di lavoro biologici611 Ricerca sulla sicurezza e carichi di lavoro biologici

566</h4>612</h4>

567 613

568I carichi di lavoro in sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e basi di codice adiacenti alla biologia, attivano il fallback frequentemente, spesso alla prima richiesta. Per un lavoro biologico sostanziale su Fable 5.1, Fable 5 o Opus 5.5, Claude Code sposta la sessione a Opus 5 alla prima richiesta contrassegnata, e le successive richieste contrassegnate per biologia terminano in rifiuti lì, perché Opus 5 non ha fallback biologico. Su Opus 5, ricevi quei rifiuti dalla prima richiesta contrassegnata.614I carichi di lavoro in sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e basi di codice adiacenti alla biologia, attivano il fallback frequentemente, spesso alla prima richiesta. Per un lavoro biologico sostanziale su Fable 5.1, Fable 5 o Opus 5.5, Claude Code sposta la sessione a Opus 5 alla prima richiesta contrassegnata, e le successive richieste contrassegnate per biologia terminano in rifiuti lì, perché Opus 5 non ha fallback biologico. Su Opus 5 e Sonnet 5.5, ricevi quei rifiuti dalla prima richiesta contrassegnata.

569 615

570Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.616Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.

571 617

580| Modello | Livelli |626| Modello | Livelli |

581| :- | :- |627| :- | :- |

585 631

586Se imposti un livello che il modello attivo non supporta, Claude Code fallback al livello supportato più alto pari o inferiore a quello impostato. Ad esempio, `xhigh` viene eseguito come `high` su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; vedere [Limiti di sforzo dell'organizzazione](#organization-effort-limits).632Se imposti un livello che il modello attivo non supporta, Claude Code fallback al livello supportato più alto pari o inferiore a quello impostato. Ad esempio, `xhigh` viene eseguito come `high` su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; vedere [Limiti di sforzo dell'organizzazione](#organization-effort-limits).

587 633

588Con l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode) disattivata, Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:634Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:

589 635

5901. Una scelta esplicita: la variabile di ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars#variables), l'avvio con `--effort`, o `/effort` nella sessione ([un `/effort` non interattivo ha effetto più ristretto](#non-interactive-effort))6361. Una scelta esplicita: la variabile di ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars#variables), l'avvio con `--effort`, o `/effort` nella sessione ([un `/effort` non interattivo ha effetto più ristretto](#non-interactive-effort))

5912. Le tue impostazioni: il livello che hai salvato per il modello o una chiave [`effortLevel`](/docs/it/settings-reference#effortlevel), con la precedenza tra loro e tra i file di impostazioni indicata in [`modelSettings`](/docs/it/settings-reference#modelsettings)6372. Le tue impostazioni: il livello che hai salvato per il modello o una chiave [`effortLevel`](/docs/it/settings-reference#effortlevel), con la precedenza tra loro e tra i file di impostazioni indicata in [`modelSettings`](/docs/it/settings-reference#modelsettings)

5923. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne che Opus 5.5 predefinito a `medium`, Opus 4.7 predefinito a `xhigh` e, quando la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello6383. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne che Opus 5.5 e Sonnet 5.5 predefinito a `medium`, Opus 4.7 predefinito a `xhigh` e, quando la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello

593 639

594Opus 5.5 inizia a `medium` a meno che una delle fonti sopra non imposti un livello per esso, e un `effortLevel` di livello superiore nel tuo file di impostazioni utente non conta per Opus 5.5. Quella chiave è la forma più vecchia che `/effort` ha scritto prima che Claude Code salvasse i livelli per modello: continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti, mentre Opus 5.5 e i modelli rilasciati dopo di esso iniziano al loro predefinito fino a quando non scegli un livello per loro con `/effort` o il selettore `/model`. Un `effortLevel` di livello superiore nelle impostazioni di progetto, locale o gestite, o uno passato con `--settings`, si applica a ogni modello.640Opus 5.5 inizia a `medium` a meno che una delle fonti sopra non imposti un livello per esso, e un `effortLevel` di livello superiore nel tuo file di impostazioni utente non conta per Opus 5.5. Quella chiave è la forma più vecchia che `/effort` ha scritto prima che Claude Code salvasse i livelli per modello: continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti, mentre Opus 5.5 e i modelli rilasciati dopo di esso iniziano al loro predefinito fino a quando non scegli un livello per loro con `/effort` o il selettore `/model`. Un `effortLevel` di livello superiore nelle impostazioni di progetto, locale o gestite, o uno passato con `--settings`, si applica a ogni modello.

595 641

610 656

611Quando imposti un livello con `/effort` in un'esecuzione [`-p`](/docs/it/headless), Claude Code lo applica solo a quella sessione e non lo salva come predefinito.657Quando imposti un livello con `/effort` in un'esecuzione [`-p`](/docs/it/headless), Claude Code lo applica solo a quella sessione e non lo salva come predefinito.

612 658

613Il menu `/effort` offre anche `ultracode`. Ultracode è un'impostazione di Claude Code piuttosto che un livello di sforzo del modello: invia `xhigh` al modello e inoltre ha Claude orchestrare [flussi di lavoro dinamici](/docs/it/workflows) per attività sostanziali. Per dove può essere impostato in modo persistente, vedere l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode).659Il cursore `/effort` ha anche un'opzione **Ultracode**. Ultracode è un'impostazione di Claude Code piuttosto che un livello di sforzo del modello: con essa attivata, Claude orchestra [flussi di lavoro dinamici](/docs/it/workflows) per attività sostanziali, a qualsiasi livello di sforzo la sessione viene eseguita. Per dove può essere impostato in modo persistente, vedere l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode).

660

661Attivare o disattivare ultracode con `/effort` o l'impostazione `ultracode` lascia il livello di sforzo invariato. Il flag `--effort ultracode` e il valore Agent SDK `effortLevel: "ultracode"` lo attivano e impostano anche il livello a `xhigh`. Scegliere un livello nel cursore `/effort` o nel selettore `/model` lascia ultracode come era.

614 662

615Puoi attivare ultracode attraverso uno dei seguenti:663Puoi attivare ultracode attraverso uno dei seguenti:

616 664

617* **`/effort`**: esegui `/effort ultracode`, o selezionalo dal menu665* **`/effort`**: esegui `/effort ultracode` per attivarlo per la sessione corrente o `/effort ultracode off` per disattivarlo. Nel cursore `/effort`, premi `Tab` per capovolgere l'opzione **Ultracode**, quindi `Enter` per applicarla

618* **Flag `--effort`**: avvia con `claude --effort ultracode`, che avvia la sessione a sforzo `xhigh` con ultracode attivato666* **Flag `--effort`**: avvia con `claude --effort ultracode`, che avvia la sessione a sforzo `xhigh` con ultracode attivato

619* **Impostazione `ultracode`**: imposta [`"ultracode": true`](/docs/it/settings-reference#ultracode) in un file di impostazioni, con `--settings`, o in una richiesta di controllo Agent SDK. Una richiesta [`applyFlagSettings()`](/docs/it/agent-sdk/typescript#applyflagsettings) accetta anche `effortLevel: "ultracode"`667* **Impostazione `ultracode`**: imposta [`"ultracode": true`](/docs/it/settings-reference#ultracode) in un file di impostazioni, con `--settings`, o in una richiesta di controllo Agent SDK. Una richiesta [`applyFlagSettings()`](/docs/it/agent-sdk/typescript#applyflagsettings) accetta anche `effortLevel: "ultracode"`, che lo attiva e imposta il livello di sforzo a `xhigh`

620* **Selettore `/model`**: sposta il cursore dello sforzo su `ultracode` con i tasti freccia mentre scegli un modello. Claude Code lo attiva per la sessione corrente, anche quando salvi quel modello come predefinito668

669La forma `/effort ultracode off`, il cursore toggle e mantenere ultracode attivato a livelli di sforzo diversi da `xhigh` richiedono Claude Code v2.1.284 o successiva. Prima della v2.1.284, attivare ultracode impostava la sessione a sforzo `xhigh`, scegliere un altro livello lo disattivava, e un limite di sforzo inferiore a `xhigh` lo rendeva non disponibile.

621 670

622Passare `ultracode` al flag `--effort` o al valore Agent SDK `effortLevel` richiede Claude Code v2.1.203 o successiva. Prima della v2.1.203, `--effort ultracode` stampava `Unknown --effort value 'ultracode'` e la sessione iniziava allo sforzo predefinito.671Passare `ultracode` al flag `--effort` o al valore Agent SDK `effortLevel` richiede Claude Code v2.1.203 o successiva. Prima della v2.1.203, `--effort ultracode` stampava `Unknown --effort value 'ultracode'` e la sessione iniziava allo sforzo predefinito.

623 672

624L'impostazione `effortLevel` persistente e la variabile di ambiente `CLAUDE_CODE_EFFORT_LEVEL` non accettano `ultracode`. Quando `CLAUDE_CODE_EFFORT_LEVEL` è impostato su un livello diverso da `xhigh`, le richieste vengono eseguite a quel livello e l'orchestrazione del flusso di lavoro di ultracode rimane inattiva. Selezionare ultracode mostra quindi un avviso che la variabile di ambiente sostituisce lo sforzo per la sessione.673L'impostazione `effortLevel` persistente e la variabile di ambiente `CLAUDE_CODE_EFFORT_LEVEL` non accettano `ultracode`. Se `CLAUDE_CODE_EFFORT_LEVEL` o un [limite di sforzo](#organization-effort-limits) imposta il livello della sessione, ultracode rimane attivato a quel livello.

625 674

626<span id="when-ultracode-is-available" />675<span id="when-ultracode-is-available" />

627 676

629 678

630* [I flussi di lavoro sono disattivati](/docs/it/workflows#turn-workflows-off)679* [I flussi di lavoro sono disattivati](/docs/it/workflows#turn-workflows-off)

631* Il modello non supporta lo sforzo `xhigh`680* Il modello non supporta lo sforzo `xhigh`

632* Un [limite di sforzo](#organization-effort-limits) inferiore a `xhigh` si applica al modello

633 681

634In questi casi `--effort ultracode` avvia la sessione con ultracode disattivato, al livello di sforzo più alto che il modello e qualsiasi limite consentono, fino a `xhigh`.682In questi casi `--effort ultracode` avvia la sessione con ultracode disattivato, al livello di sforzo più alto che il modello e qualsiasi limite consentono, fino a `xhigh`.

635 683

641 689

642| Livello | Quando usarlo |690| Livello | Quando usarlo |

643| :- | :- |691| :- | :- |

644| `low` | Riservato per attività brevi, circoscritte e sensibili alla latenza che non sono sensibili all'intelligenza |692| `low` | Scambi rapidi dove rivedi ogni risultato, come brainstorming, uno schizzo iniziale o un piccolo cambio come una ridenominazione |

645| `medium` | Riduce l'utilizzo di token per il lavoro sensibile ai costi che può scambiare un po' di intelligenza. Il predefinito su Opus 5.5 |693| `medium` | Il predefinito su Opus 5.5 e Sonnet 5.5, dove si adatta al lavoro di ingegneria quotidiana con un ambito chiaro, come l'implementazione di una nuova funzionalità. Su altri modelli, riduce l'utilizzo di token per il lavoro sensibile ai costi che può scambiare un po' di intelligenza |

646| `high` | Bilancia l'utilizzo di token e l'intelligenza. Il predefinito su ogni modello tranne Opus 5.5 e Opus 4.7 |694| `high` | Lavoro dove la verifica è importante o i casi limite sono probabili, come la correzione di un bug in una base di codice esistente. Il predefinito su ogni modello tranne Opus 5.5, Sonnet 5.5 e Opus 4.7 |

648| `max` | Può migliorare le prestazioni su attività impegnative ma può mostrare rendimenti decrescenti ed è soggetto a eccesso di riflessione. Prova prima di adottare ampiamente |696| `max` | Problemi difficili che desideri che Claude risolva senza di te, come trovare vulnerabilità di sicurezza. `max` può mostrare rendimenti decrescenti ed è soggetto a eccesso di riflessione, quindi prova prima di adottare ampiamente |

649| `ultracode` | Un'impostazione di Claude Code che pianifica un [flusso di lavoro dinamico](/docs/it/workflows) per ogni attività sostanziale con ragionamento `xhigh` per messaggio |697| `ultracode` | Un'impostazione di Claude Code piuttosto che un livello: pianifica un [flusso di lavoro dinamico](/docs/it/workflows) per ogni attività sostanziale a qualsiasi livello di sforzo |

698

699Nei test su Opus 5.5 e Fable 5.1, Claude a un livello superiore ha testato più casi limite e ha verificato più del suo lavoro prima di rispondere. Ha anche fatto più scelte da solo. A un livello inferiore, Claude ha restituito un punto di partenza più velocemente, che si adatta al lavoro dove rivedi ogni risultato e guidi il passo successivo. Per vedere gli stessi compiti eseguiti a ogni livello, leggi [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) sul blog.

650 700

651La scala dello sforzo è calibrata per modello, quindi lo stesso nome di livello non rappresenta lo stesso valore sottostante tra i modelli.701La scala dello sforzo è calibrata per modello, quindi lo stesso nome di livello non rappresenta lo stesso valore sottostante tra i modelli.

652 702

703Opus 5.5 [predefinito a `medium`](#adjust-effort-level), un livello sotto il predefinito di Opus 5 di `high`. Nei test di Anthropic, Opus 5.5 a `medium` corrisponde o supera Opus 5 a `high` su valutazioni di codifica e lavoro di conoscenza. A un dato livello, Opus 5.5 tende a pensare più per turno rispetto a Opus 5. Quando passi da Opus 5 a Opus 5.5, inizia a `medium` piuttosto che portare il livello che hai usato su Opus 5. Per testare i livelli rispetto al tuo lavoro, vedere [Calibra lo sforzo](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) nella guida al prompting di Opus 5.5.

704

653<h4 id="use-ultrathink-for-one-off-deep-reasoning">705<h4 id="use-ultrathink-for-one-off-deep-reasoning">

654 Usa ultrathink per il ragionamento profondo una tantum706 Usa ultrathink per il ragionamento profondo una tantum

655</h4>707</h4>

682 734

683Il ragionamento adattivo rende il pensiero opzionale ad ogni passo, quindi Claude può rispondere più velocemente ai prompt di routine e riservare il pensiero più profondo ai passi che ne traggono beneficio. Se desideri che Claude pensi più o meno spesso di quanto il livello corrente produce, puoi dirlo direttamente nel tuo prompt o in `CLAUDE.md`; il modello risponde a quella guida entro la sua impostazione di sforzo.735Il ragionamento adattivo rende il pensiero opzionale ad ogni passo, quindi Claude può rispondere più velocemente ai prompt di routine e riservare il pensiero più profondo ai passi che ne traggono beneficio. Se desideri che Claude pensi più o meno spesso di quanto il livello corrente produce, puoi dirlo direttamente nel tuo prompt o in `CLAUDE.md`; il modello risponde a quella guida entro la sua impostazione di sforzo.

684 736

685I modelli Fable, Sonnet 5 e Opus 4.7 e successivi utilizzano sempre il ragionamento adattivo. La modalità di budget di pensiero fisso e `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` non si applicano a loro.737I modelli Fable, Sonnet 5 e successivi, e Opus 4.7 e successivi utilizzano sempre il ragionamento adattivo. La modalità di budget di pensiero fisso e `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` non si applicano a loro.

686 738

687Su Opus 4.6 e Sonnet 4.6, puoi impostare `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` per tornare al precedente budget di pensiero fisso controllato da `MAX_THINKING_TOKENS`. Vedere [variabili di ambiente](/docs/it/env-vars).739Su Opus 4.6 e Sonnet 4.6, puoi impostare `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` per tornare al precedente budget di pensiero fisso controllato da `MAX_THINKING_TOKENS`. Vedere [variabili di ambiente](/docs/it/env-vars).

688 740

689<h3 id="extended-thinking">741<h3 id="extended-thinking">

690 Pensiero esteso742 Extended thinking

691</h3>743</h3>

692 744

693Il pensiero esteso è il ragionamento che Claude emette prima di rispondere. Sui modelli che supportano il [ragionamento adattivo](#adjust-effort-level), il livello di sforzo è il controllo primario per quanto pensiero accade; le impostazioni di seguito attivano o disattivano il pensiero e controllano come viene visualizzato. Con il pensiero disattivato su Anthropic API, Claude Code invia sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.745Extended thinking è il ragionamento che Claude emette prima di rispondere. Sui modelli che supportano il [ragionamento adattivo](#adjust-effort-level), il livello di sforzo è il controllo primario per quanto pensiero accade; le impostazioni di seguito attivano o disattivano il pensiero e controllano come viene visualizzato. Con il pensiero disattivato su Anthropic API, Claude Code invia sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

694 746

695| Controllo | Come impostarlo |747| Controllo | Come impostarlo |

696| :- | :- |748| :- | :- |

698| Imposta il predefinito globale | Esegui `/config` e attiva/disattiva la modalità di pensiero. Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json` |750| Imposta il predefinito globale | Esegui `/config` e attiva/disattiva la modalità di pensiero. Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json` |

699| Disabilita tramite una variabile di ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il pensiero su Anthropic API tranne sui modelli Opus 5.5 e Fable. Su [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette il parametro `thinking`, e i modelli di ragionamento adattivo potrebbero comunque pensare. Altri valori si applicano solo con un [budget di pensiero fisso](#adaptive-reasoning-and-fixed-thinking-budgets) |751| Disabilita tramite una variabile di ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il pensiero su Anthropic API tranne sui modelli Opus 5.5, Sonnet 5.5 e Fable. Su [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette il parametro `thinking`, e i modelli di ragionamento adattivo potrebbero comunque pensare. Altri valori si applicano solo con un [budget di pensiero fisso](#adaptive-reasoning-and-fixed-thinking-budgets) |

700 752

701Non puoi disattivare il pensiero sui modelli Opus 5.5 o Fable. L'attivazione/disattivazione della sessione, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` non hanno effetto lì, e il modello decide per passo quanto pensare in base al livello di sforzo.753Non puoi disattivare il pensiero sui modelli Opus 5.5, Sonnet 5.5 o Fable. L'attivazione/disattivazione della sessione, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` non hanno effetto lì, e il modello decide per passo quanto pensare in base al livello di sforzo.

702 754

703Claude Code comprime l'output di pensiero per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedi il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di pensiero redatti per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](/docs/it/settings) se desideri i riassunti completi disponibili quando espandi. Ti viene addebitato per tutti i token di pensiero generati, anche quando compressi o redatti.755Claude Code comprime l'output di pensiero per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedi il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di pensiero redatti per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](/docs/it/settings) se desideri i riassunti completi disponibili quando espandi. Ti viene addebitato per tutti i token di pensiero generati, anche quando compressi o redatti.

704 756

705<h3 id="extended-context">757<h3 id="extended-context">

706 Contesto esteso758 Extended context

707</h3>759</h3>

708 760

709Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 e successivi e Sonnet 4.6 supportano una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe con basi di codice di grandi dimensioni.761Fable 5.1, Fable 5, Sonnet 5 e successivi, Opus 4.6 e successivi, e Sonnet 4.6 supportano una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe con basi di codice di grandi dimensioni.

710 762

711Su Anthropic API, Fable 5.1, Fable 5, Sonnet 5 e Opus 4.7 e successivi vengono eseguiti con la finestra 1M su ogni piano, incluso Pro. Non selezioni una variante `[1m]` o attivi crediti di utilizzo per la finestra 1M su questi modelli. L'utilizzo di Fable stesso può fatturare ai crediti di utilizzo su alcuni piani; vedere [Fable e crediti di utilizzo](#fable-and-usage-credits).763Su Anthropic API, Fable 5.1, Fable 5, Sonnet 5 e successivi, e Opus 4.7 e successivi vengono eseguiti con la finestra 1M su ogni piano, incluso Pro. Non selezioni una variante `[1m]` o attivi crediti di utilizzo per la finestra 1M su questi modelli. L'utilizzo di Fable stesso può fatturare ai crediti di utilizzo su alcuni piani; vedere [Fable e crediti di utilizzo](#fable-and-usage-credits).

712 764

713Opus 4.6 e Sonnet 4.6 raggiungono 1M solo attraverso la loro variante `[1m]`, e l'accesso a quella variante dipende dal tuo piano. Su piani Max, Team ed Enterprise, inclusi sia i posti Team Standard che Team Premium, Opus 4.6 con contesto 1M è incluso nel tuo abbonamento. Sonnet 4.6 con contesto 1M richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) su ogni piano di abbonamento, incluso Max.765Opus 4.6 e Sonnet 4.6 raggiungono 1M solo attraverso la loro variante `[1m]`, e l'accesso a quella variante dipende dal tuo piano. Su piani Max, Team ed Enterprise, inclusi sia i posti Team Standard che Team Premium, Opus 4.6 con contesto 1M è incluso nel tuo abbonamento. Sonnet 4.6 con contesto 1M richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) su ogni piano di abbonamento, incluso Max.

714 766

742/model claude-opus-4-8[1m]794/model claude-opus-4-8[1m]

743```795```

744 796

745<h4 id="sonnet-5-context-window">797<h4 id="sonnet-5-5-and-sonnet-5-context-window">

746 Finestra di contesto di Sonnet 5798 Finestra di contesto di Sonnet 5.5 e Sonnet 5

747</h4>799</h4>

748 800

749Su Anthropic API, Sonnet 5 viene sempre eseguito con la finestra di contesto 1M. Non c'è variante 200K, nessun suffisso `[1m]` da selezionare e nessun credito di utilizzo richiesto su nessun piano. Le sessioni si compattano automaticamente prima che la finestra si riempia, a circa 967K token per impostazione predefinita; imposta [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars) per scegliere una soglia diversa.801Su Anthropic API, Sonnet 5.5 e Sonnet 5 vengono sempre eseguiti con la finestra di contesto 1M. Non c'è variante 200K, nessun suffisso `[1m]` da selezionare e nessun credito di utilizzo richiesto su nessun piano. Le sessioni si compattano automaticamente prima che la finestra si riempia, a circa 967K token per impostazione predefinita; imposta [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars) per scegliere una soglia diversa.

750 802

751Due configurazioni limitano la finestra a 200K:803Due configurazioni limitano la finestra a 200K:

752 804

753* **Gateway LLM**: quando `ANTHROPIC_BASE_URL` punta a un [gateway](/docs/it/llm-gateway), Claude Code non può verificare il supporto 1M. Per usare la finestra completa, seleziona Sonnet 5 (1M context) nel selettore di modelli, che mappa a `sonnet[1m]`.805* **Gateway LLM**: quando `ANTHROPIC_BASE_URL` punta a un [gateway](/docs/it/llm-gateway), Claude Code non può verificare il supporto 1M. Per usare la finestra completa, seleziona Sonnet 5.5 (1M context) nel selettore di modelli, che mappa a `sonnet[1m]`, o esegui `/model claude-sonnet-5[1m]` per Sonnet 5.

754* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: mantiene le sessioni su ogni modello con una finestra 1M nativa a una finestra 200K; vedere [Contesto esteso](#extended-context) per come il mantenimento viene applicato. Utile per i deployment che devono limitare il contesto.806* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: mantiene le sessioni su ogni modello con una finestra 1M nativa a una finestra 200K; vedere [Extended context](#extended-context) per come il mantenimento viene applicato. Utile per i deployment che devono limitare il contesto.

755 807

756<h2 id="context-window-and-auto-compaction">808<h2 id="context-window-and-auto-compaction">

757 Finestra di contesto e auto-compattazione809 Finestra di contesto e auto-compattazione

786* Le [sessioni cloud](/docs/it/claude-code-on-the-web) si compattano mentre la conversazione si avvicina al limite del modello838* Le [sessioni cloud](/docs/it/claude-code-on-the-web) si compattano mentre la conversazione si avvicina al limite del modello

787* Sonnet 4.6 e Opus 4.6 senza [contesto esteso](#extended-context) si compattano al limite di 200K, così come Opus 4.8 e versioni successive quando vengono eseguiti con una finestra di contesto di 200K, come su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry839* Sonnet 4.6 e Opus 4.6 senza [contesto esteso](#extended-context) si compattano al limite di 200K, così come Opus 4.8 e versioni successive quando vengono eseguiti con una finestra di contesto di 200K, come su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry

788* Quando si imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars), i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K840* Quando si imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars), i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K

789* I modelli in esecuzione con una finestra nativa di 1M, come Sonnet 5, i modelli Fable e Opus 4.7 e versioni successive su Anthropic API, si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, [Pin models for third-party deployments](#pin-models-for-third-party-deployments) indica quali modelli vengono eseguiti con quella finestra; per le configurazioni che assegnano a Sonnet 5 200K, vedere [Sonnet 5 context window](#sonnet-5-context-window)841* I modelli in esecuzione con una finestra nativa di 1M, come Sonnet 5, i modelli Fable e Opus 4.7 e versioni successive su Anthropic API, si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, [Pin models for third-party deployments](#pin-models-for-third-party-deployments) indica quali modelli vengono eseguiti con quella finestra; per le configurazioni che assegnano a Sonnet 5.5 e Sonnet 5 200K, vedere [Sonnet 5.5 and Sonnet 5 context window](#sonnet-5-5-and-sonnet-5-context-window)

790* Le sessioni su un ID modello che Claude Code non riconosce, come un alias [LLM gateway](/docs/it/llm-gateway), si compattano alla finestra di contesto che Claude Code assume per l'ID; vedere [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)842* Le sessioni su un ID modello che Claude Code non riconosce, come un alias [LLM gateway](/docs/it/llm-gateway), si compattano alla finestra di contesto che Claude Code assume per l'ID; vedere [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

791 843

792<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">844<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

861| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Il modello da utilizzare per `haiku`, o [funzionalità in background](/docs/it/costs#background-token-usage) |913| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Il modello da utilizzare per `haiku`, o [funzionalità in background](/docs/it/costs#background-token-usage) |

862| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per [subagents](/docs/it/sub-agents#choose-a-model), [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) compagni di squadra, e agenti [workflow](/docs/it/workflows) che non sono assegnati a un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Un modello per invocazione o il campo `model` di una definizione, incluso `inherit`, ha la precedenza. Per modificare questo, impostare [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model) |914| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per [subagents](/docs/it/sub-agents#choose-a-model), [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) compagni di squadra, e agenti [workflow](/docs/it/workflows) che non sono assegnati a un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Un modello per invocazione o il campo `model` di una definizione, incluso `inherit`, ha la precedenza. Per modificare questo, impostare [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model) |

863 915

916Su provider di terze parti, [Personalizzare la visualizzazione e le capacità del modello fissato](#customize-pinned-model-display-and-capabilities) descrive cosa mostra la riga di un modello fissato nel selettore `/model`.

917

864Nota: `ANTHROPIC_SMALL_FAST_MODEL` è deprecato a favore di `ANTHROPIC_DEFAULT_HAIKU_MODEL`.918Nota: `ANTHROPIC_SMALL_FAST_MODEL` è deprecato a favore di `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

865 919

866<h3 id="pin-models-for-third-party-deployments">920<h3 id="pin-models-for-third-party-deployments">

902<Note>956<Note>

903 Un elenco di autorizzazione `availableModels` fornito tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) si applica comunque quando si utilizzano provider di terze parti; [le impostazioni gestite dal server non vengono fornite lì](/docs/it/server-managed-settings#platform-availability).957 Un elenco di autorizzazione `availableModels` fornito tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) si applica comunque quando si utilizzano provider di terze parti; [le impostazioni gestite dal server non vengono fornite lì](/docs/it/server-managed-settings#platform-availability).

904 958

905 Il filtraggio corrisponde a un alias di modello come `opus`, a un prefisso di versione come `claude-opus-4-8`, o all'ID di modello completo in forma di provider. I prefissi specifici del provider come `us.anthropic.` non vengono rimossi, quindi per consentire un modello specifico, elencare il suo ID completo in forma di provider, o mapparlo tramite [`modelOverrides`](#override-model-ids-per-version). Qualsiasi suffisso `[1m]` viene rimosso sia dalla voce dell'elenco di autorizzazione che dal modello richiesto prima della corrispondenza.959 Il filtraggio corrisponde a un alias di modello come `opus`, a un prefisso di versione come `claude-opus-4-8`, o all'ID di modello completo in forma di provider. I prefissi specifici del provider come `us.anthropic.` non vengono rimossi, quindi per consentire un modello specifico, elencare il suo ID completo in forma di provider, o mapparlo tramite [`modelOverrides`](#override-model-ids-per-version). Per un modello fissato, quell'ID è il valore impostato nella sua variabile `ANTHROPIC_DEFAULT_*_MODEL`. Qualsiasi suffisso `[1m]` viene rimosso sia dalla voce dell'elenco di autorizzazione che dal modello richiesto prima della corrispondenza.

906</Note>960</Note>

907 961

908<h3 id="customize-pinned-model-display-and-capabilities">962<h3 id="customize-pinned-model-display-and-capabilities">

995| Variabile di ambiente | Descrizione |1049| Variabile di ambiente | Descrizione |

996| - | - |1050| - | - |

997| `DISABLE_PROMPT_CACHING` | Impostare su `1` per disabilitare la prompt caching per tutti i modelli. Ha la precedenza sulle impostazioni per modello |1051| `DISABLE_PROMPT_CACHING` | Impostare su `1` per disabilitare la prompt caching per tutti i modelli. Ha la precedenza sulle impostazioni per modello |

998| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare su `1` per disabilitare la prompt caching solo per i modelli Haiku |1052| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare su `1` per disabilitare la prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

1002 1056

1003Per scegliere il TTL della cache per la conversazione principale e per i subagents separatamente, vedere [scegliere il TTL da soli](/docs/it/prompt-caching#choose-the-ttl-yourself). Per cosa attiva un cache miss, vedere [Come Claude Code utilizza la prompt caching](/docs/it/prompt-caching).1057Per scegliere il TTL della cache per la conversazione principale e per i subagents separatamente, vedere [scegliere il TTL da soli](/docs/it/prompt-caching#choose-the-ttl-yourself). Per cosa attiva un cache miss, vedere [Come Claude Code utilizza la prompt caching](/docs/it/prompt-caching).

1058

1059<h2 id="version-history">

1060 Cronologia delle versioni

1061</h2>

1062

1063Questa tabella elenca la versione di Claude Code in cui ogni alias di modello ha modificato il modello a cui si risolve, dal più recente al meno recente.

1064

1065| Versione | Modifica |

1066| :- | :- |

1067| v2.1.284 | `sonnet` si risolve a Sonnet 5.5 su Anthropic API |

1068| v2.1.280 | `opus` si risolve a Opus 5.5 su Anthropic API, Claude Platform su AWS, Amazon Bedrock e Agent Platform di Google Cloud |

1069| v2.1.257 | `fable` si risolve a Fable 5.1, tranne nelle sessioni del gateway delle app Claude |

1070| v2.1.219 | `opus` si risolve a Opus 5 su Anthropic API, Claude Platform su AWS, Amazon Bedrock e Agent Platform |

1071| v2.1.207 | `opus` si risolve a Opus 4.8 su Claude Platform su AWS, Amazon Bedrock e Agent Platform |

1072| v2.1.197 | `sonnet` si risolve a Sonnet 5 su Anthropic API |

1073| v2.1.154 | `opus` si risolve a Opus 4.8 su Anthropic API |

1074| Precedenti | `opus` si risolve a Opus 4.7 su Claude Platform su AWS e a Opus 4.6 su Amazon Bedrock e Agent Platform. `fable` si risolve a Fable 5 su ogni provider |

monitoring-usage.md +34 −21

Details

39 39

40Per verificare una configurazione che esporta metriche, controlla il tuo backend per la metrica `claude_code.session.count`, che Claude Code emette quando inizia una sessione. Per verificare una configurazione solo log, invia un prompt e controlla l'evento `claude_code.user_prompt`.40Per verificare una configurazione che esporta metriche, controlla il tuo backend per la metrica `claude_code.session.count`, che Claude Code emette quando inizia una sessione. Per verificare una configurazione solo log, invia un prompt e controlla l'evento `claude_code.user_prompt`.

41 41

42Se non arriva nulla, esegui `claude --debug` e controlla il log di debug. Claude Code segnala i guasti degli esportatori che configuri come errori `[3P telemetry]`, dove 3P significa third-party. Le righe con prefisso `[Anthropic telemetry]` descrivono la [telemetria operativa separata di Anthropic](/docs/it/data-usage#telemetry-services) e non indicano un problema con la tua configurazione.42Se non arriva nulla, avvia Claude Code con `claude --debug-file <path>` e controlla il log che scrive in quel percorso. Claude Code segnala i guasti degli esportatori che configuri come errori `[3P telemetry]`, dove 3P significa third-party. Le righe con prefisso `[Anthropic telemetry]` descrivono la [telemetria operativa separata di Anthropic](/docs/it/data-usage#telemetry-services) e non indicano un problema con la tua configurazione.

43 43

44Per le opzioni di configurazione complete, consulta la [specifica OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).44Per le opzioni di configurazione complete, consulta la [specifica OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).

45 45

72 Come le impostazioni gestite bloccano la destinazione OTLP72 Come le impostazioni gestite bloccano la destinazione OTLP

73</h3>73</h3>

74 74

75Quando imposti una variabile `OTEL_EXPORTER_OTLP_*` nelle impostazioni gestite, Claude Code rimuove le variabili conflittuali impostate dagli sviluppatori all'avvio e registra un avviso che puoi visualizzare con `claude --debug`. Ciò che rimuove dipende da quale variabile imposti:75Quando imposti una variabile `OTEL_EXPORTER_OTLP_*` nelle impostazioni gestite, Claude Code rimuove le variabili conflittuali impostate dagli sviluppatori all'avvio e registra un avviso nel log di debug. Ciò che rimuove dipende da quale variabile imposti:

76 76

77* **Endpoint**: quando imposti `OTEL_EXPORTER_OTLP_ENDPOINT`, Claude Code rimuove ogni endpoint per segnale impostato dagli sviluppatori. Gli sviluppatori non possono puntare un segnale a un collector diverso, quindi non è necessario impostare anche le variabili di endpoint per segnale nelle impostazioni gestite.77* **Endpoint**: quando imposti `OTEL_EXPORTER_OTLP_ENDPOINT`, Claude Code rimuove ogni endpoint per segnale impostato dagli sviluppatori. Gli sviluppatori non possono puntare un segnale a un collector diverso, quindi non è necessario impostare anche le variabili di endpoint per segnale nelle impostazioni gestite.

78* **Protocolli**: quando imposti `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code rimuove ogni protocollo per segnale impostato dagli sviluppatori.78* **Protocolli**: quando imposti `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code rimuove ogni protocollo per segnale impostato dagli sviluppatori.

103 Variabili di configurazione comuni103 Variabili di configurazione comuni

104</h3>104</h3>

105 105

106Queste variabili configurano esportatori, endpoint e comportamento di esportazione per tutti i deployment. Se imposti una variabile di endpoint o protocollo per segnale specifico, come `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code la utilizza al posto della variabile generica per quel segnale. Se imposti una variabile di intestazioni per segnale specifico, come `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code la unisce con la generica `OTEL_EXPORTER_OTLP_HEADERS` per quel segnale.106Queste variabili configurano esportatori, endpoint e comportamento di esportazione per tutti i deployment.

107

108Se imposti una variabile di endpoint o protocollo per segnale specifico, come `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code la utilizza al posto della variabile generica per quel segnale. Se imposti una variabile di intestazioni per segnale specifico, come `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code la unisce con la generica `OTEL_EXPORTER_OTLP_HEADERS` per quel segnale.

107 109

108Su macchine con impostazioni gestite, vedi [Come le impostazioni gestite bloccano la destinazione OTLP](#how-managed-settings-lock-the-otlp-destination) per sapere cosa Claude Code rimuove.110Su macchine con impostazioni gestite, vedi [Come le impostazioni gestite bloccano la destinazione OTLP](#how-managed-settings-lock-the-otlp-destination) per sapere cosa Claude Code rimuove.

109 111

125| `OTEL_LOGS_EXPORT_INTERVAL` | Intervallo di esportazione dei log in millisecondi (predefinito: 5000) | `1000`, `10000` |127| `OTEL_LOGS_EXPORT_INTERVAL` | Intervallo di esportazione dei log in millisecondi (predefinito: 5000) | `1000`, `10000` |

127| `OTEL_LOG_ASSISTANT_RESPONSES` | Abilita la registrazione del testo della risposta dell'assistente negli eventi `assistant_response` (predefinito: disabilitato). Se non impostato, ricade al valore di `OTEL_LOG_USER_PROMPTS`. Richiede Claude Code v2.1.193 o successivo | `1` per abilitare, `0` per mantenerlo oscurato |129| `OTEL_LOG_ASSISTANT_RESPONSES` | Abilita la registrazione del testo della risposta dell'assistente negli eventi `assistant_response` (predefinito: disabilitato). Se non impostato, ricade al valore di `OTEL_LOG_USER_PROMPTS`. Richiede Claude Code v2.1.193 o successivo | `1` per abilitare, `0` per mantenerlo oscurato |

128| `OTEL_LOG_TOOL_DETAILS` | Abilita la registrazione dei parametri dello strumento e degli argomenti di input negli eventi dello strumento e negli attributi di span di traccia: comandi Bash, nomi dei server e degli strumenti MCP, nomi delle skill, nomi dei workflow creati dall'utente e input degli strumenti. Abilita anche i nomi dei comandi personalizzati, plugin e MCP negli eventi `user_prompt` (predefinito: disabilitato). Per i server integrati di Claude Desktop, nelle sessioni di proprietà di Claude Desktop, `mcp_server_name`/`mcp_tool_name` vengono emessi su `tool_decision`/`tool_result` anche con il flag disattivato. L'eccezione richiede Claude Code v2.1.214 o successivo | `1` per abilitare |130| `OTEL_LOG_TOOL_DETAILS` | Abilita la registrazione dei parametri dello strumento e degli argomenti di input negli eventi dello strumento e negli attributi di span di traccia: comandi Bash, nomi dei server e degli strumenti MCP, nomi delle skill, nomi dei workflow creati dall'utente e input degli strumenti. Abilita anche i nomi dei comandi personalizzati, plugin e MCP negli eventi `user_prompt`, e nomi reali di agente, skill, plugin e server e strumenti MCP sui [contatori di costo e token](#cost-counter) (predefinito: disabilitato). Per i server integrati di Claude Desktop, nelle sessioni di proprietà di Claude Desktop, `mcp_server_name`/`mcp_tool_name` vengono emessi su `tool_decision`/`tool_result` anche con il flag disattivato. L'eccezione richiede Claude Code v2.1.214 o successivo | `1` per abilitare |

129| `OTEL_LOG_TOOL_CONTENT` | Abilita la registrazione del contenuto dello strumento nell'evento di span [`tool.output`](#tool-output-span-event) (predefinito: disabilitato). Gli attributi di span portano il contenuto dello strumento secondo i loro [gate specifici](#new-context-gates). Richiede [tracce](#traces-beta). Il contenuto viene troncato al limite di contenuto (60 KB per impostazione predefinita) | `1` per abilitare |131| `OTEL_LOG_TOOL_CONTENT` | Abilita la registrazione del contenuto dello strumento nell'evento di span [`tool.output`](#tool-output-span-event) (predefinito: disabilitato). Gli attributi di span portano il contenuto dello strumento secondo i loro [gate specifici](#new-context-gates). Richiede [tracce](#traces-beta). Il contenuto viene troncato al limite di contenuto (60 KB per impostazione predefinita) | `1` per abilitare |

130| `OTEL_LOG_MANAGED_SETTINGS` | Aggiungi le impostazioni gestite oscurate e un digest SHA-256 delle impostazioni prima dell'oscuramento agli eventi [managed settings resolved](#managed-settings-resolved-event) (predefinito: disabilitato). Un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo | `1` per abilitare |132| `OTEL_LOG_MANAGED_SETTINGS` | Aggiungi le impostazioni gestite oscurate e un digest SHA-256 delle impostazioni prima dell'oscuramento agli eventi [managed settings resolved](#managed-settings-resolved-event) (predefinito: disabilitato). Un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo | `1` per abilitare |

131| `OTEL_LOG_RAW_API_BODIES` | Emetti il corpo completo della richiesta e della risposta JSON dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body` (predefinito: disabilitato). I corpi includono l'intera cronologia della conversazione. L'abilitazione di questa opzione implica il consenso a tutto ciò che `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, e `OTEL_LOG_TOOL_CONTENT` rivelerebbero | `1` per corpi inline troncati al limite di contenuto (60 KB per impostazione predefinita), o `file:<dir>` per corpi non troncati su disco con un puntatore `body_ref` nell'evento |133| `OTEL_LOG_RAW_API_BODIES` | Emetti il corpo completo della richiesta e della risposta JSON dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body` (predefinito: disabilitato). I corpi includono l'intera cronologia della conversazione. L'abilitazione di questa opzione implica il consenso a tutto ciò che `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, e `OTEL_LOG_TOOL_CONTENT` rivelerebbero | `1` per corpi inline troncati al limite di contenuto (60 KB per impostazione predefinita), o `file:<dir>` per corpi non troncati su disco con un puntatore `body_ref` nell'evento |

294 296

295Se imposti `OTEL_LOG_TOOL_CONTENT=1`, le chiamate Read e Bash possono registrare un evento di span `tool.output` sullo span `claude_code.tool`. Le chiamate Edit e Write registrano uno solo quando imposti anche `OTEL_LOG_TOOL_DETAILS=1`. Quella variabile non è limitata a questi due strumenti, quindi controlla la sua [riga nella tabella di configurazione](#common-configuration-variables) per gli argomenti che aggiunge altrove.297Se imposti `OTEL_LOG_TOOL_CONTENT=1`, le chiamate Read e Bash possono registrare un evento di span `tool.output` sullo span `claude_code.tool`. Le chiamate Edit e Write registrano uno solo quando imposti anche `OTEL_LOG_TOOL_DETAILS=1`. Quella variabile non è limitata a questi due strumenti, quindi controlla la sua [riga nella tabella di configurazione](#common-configuration-variables) per gli argomenti che aggiunge altrove.

296 298

299Gli strumenti MCP, WebFetch e WebSearch registrano questo evento anche su Claude Code v2.1.283 o successivo.

300

297Claude Code scrive questo evento dal ritorno riuscito di una chiamata dello strumento, quindi una chiamata che genera un errore non registra nulla, qualunque sia lo strumento. Tra le chiamate che ritornano, non registra alcun evento `tool.output` per:301Claude Code scrive questo evento dal ritorno riuscito di una chiamata dello strumento, quindi una chiamata che genera un errore non registra nulla, qualunque sia lo strumento. Tra le chiamate che ritornano, non registra alcun evento `tool.output` per:

298 302

299* Una chiamata a qualsiasi strumento diverso da Read, Edit, Write e Bash, inclusi gli strumenti MCP e WebFetch303* Una chiamata a qualsiasi strumento diverso da Read, Edit, Write, Bash, WebFetch, WebSearch e strumenti MCP

300* Un Read che ritorna qualcosa di diverso dal testo del file, come un'immagine, un PDF o una ri-lettura di un file il cui contenuto non è cambiato304* Un Read che ritorna qualcosa di diverso dal testo del file, come un'immagine, un PDF o una ri-lettura di un file il cui contenuto non è cambiato

301* Una chiamata Edit o Write, a meno che non imposti anche `OTEL_LOG_TOOL_DETAILS=1`305* Una chiamata Edit o Write, a meno che non imposti anche `OTEL_LOG_TOOL_DETAILS=1`

306* Una chiamata WebFetch o WebSearch che Claude Code ha spostato in background perché hai interrotto il turno per [inviare i tuoi messaggi in coda subito](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued) mentre la chiamata era in esecuzione. Claude riceve quel risultato in seguito, dopo che lo span dello strumento è terminato

302 307

303L'evento porta questi attributi, ciascuno troncato al limite di contenuto (60 KB per impostazione predefinita). `Controllato da` nomina la variabile di cui un attributo ha bisogno oltre a `OTEL_LOG_TOOL_CONTENT=1`, e per Edit e Write quella variabile controlla l'evento stesso piuttosto che l'attributo.308L'evento porta questi attributi, ciascuno troncato al limite di contenuto (60 KB per impostazione predefinita). `Controllato da` nomina la variabile di cui un attributo ha bisogno oltre a `OTEL_LOG_TOOL_CONTENT=1`, e per Edit e Write quella variabile controlla l'evento stesso piuttosto che l'attributo.

304 309

306| - | - | - |311| - | - | - |

307| `content` | Testo che lo strumento Read ha restituito, o il testo che una chiamata Write è stata chiesta di scrivere | `OTEL_LOG_TOOL_DETAILS` per lo strumento Write |312| `content` | Testo che lo strumento Read ha restituito, o il testo che una chiamata Write è stata chiesta di scrivere | `OTEL_LOG_TOOL_DETAILS` per lo strumento Write |

308| `output` | Output combinato di un comando Bash, con stderr intercalato in stdout | |313| `output` | Per lo strumento Bash, l'output combinato del comando, con stderr intercalato in stdout. Per uno strumento MCP, WebFetch o WebSearch, il risultato che lo strumento ha restituito: blocchi di testo uniti da newline, con un'immagine o un documento sostituito da un segnaposto come `[image]` | |

559 564

560Imposta `OTEL_METRICS_INCLUDE_REPOSITORY=true` per etichettare metriche ed eventi con l'identità del repository della sessione, in modo che un collector condiviso possa attribuire l'utilizzo per repository. Richiede Claude Code v2.1.269 o successivo.565Imposta `OTEL_METRICS_INCLUDE_REPOSITORY=true` per etichettare metriche ed eventi con l'identità del repository della sessione, in modo che un collector condiviso possa attribuire l'utilizzo per repository. Richiede Claude Code v2.1.269 o successivo.

561 566

562Claude Code deriva questi attributi una volta per sessione dal remote `origin` del repository. I remote HTTPS e SSH di un repository producono valori identici:567Claude Code deriva questi attributi una volta per sessione dal remote `origin` del repository. Quando i remote HTTPS e SSH di un repository denominano lo stesso host e lo stesso percorso, come fanno su GitHub, GitLab e Bitbucket Cloud, entrambi producono valori identici:

563 568

564| Attributo | Valore |569| Attributo | Valore |

565| - | - |570| - | - |

570 575

571I valori sono in minuscolo e le credenziali, le stringhe di query e i frammenti dall'URL remoto non compaiono mai in essi. Gli attributi vengono omessi quando la sessione non ha un remote `origin`, quando il remote non ha forma di URL, o quando l'unico repository che lo racchiude è la tua directory home.576I valori sono in minuscolo e le credenziali, le stringhe di query e i frammenti dall'URL remoto non compaiono mai in essi. Gli attributi vengono omessi quando la sessione non ha un remote `origin`, quando il remote non ha forma di URL, o quando l'unico repository che lo racchiude è la tua directory home.

572 577

578Per ottenere questi attributi da una [sessione cloud](/docs/it/claude-code-on-the-web), imposta le variabili di telemetria, incluso `OTEL_METRICS_INCLUDE_REPOSITORY`, sul suo [ambiente cloud](/docs/it/cloud-environments#set-environment-variables). Consenti anche il dominio del tuo collector nell'[accesso alla rete](/docs/it/cloud-environments#network-access) dell'ambiente.

579

573Una chiave `vcs.*` che dichiari in [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) sostituisce il valore derivato per quella chiave. Se dichiari `vcs.repository.url.full`, Claude Code non legge mai il remote e riporta solo le chiavi che dichiari.580Una chiave `vcs.*` che dichiari in [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) sostituisce il valore derivato per quella chiave. Se dichiari `vcs.repository.url.full`, Claude Code non legge mai il remote e riporta solo le chiavi che dichiari.

574 581

582Se i cloni HTTPS e SSH di un repository riportano valori diversi, ad esempio su un'installazione self-hosted il cui URL di clone HTTPS porta un prefisso di percorso che l'URL SSH non ha, dichiara `vcs.repository.url.full` in `OTEL_RESOURCE_ATTRIBUTES` insieme a ogni altra chiave `vcs.*` che vuoi riportata. Ogni clone riporta quindi l'identità che dichiari.

583

575Gli attributi fluiscono solo ai tuoi esportatori; la telemetria di Anthropic elimina ogni chiave `vcs.*`.584Gli attributi fluiscono solo ai tuoi esportatori; la telemetria di Anthropic elimina ogni chiave `vcs.*`.

576 585

577<h3 id="metrics">586<h3 id="metrics">

648 657

649Incrementato dopo ogni richiesta API.658Incrementato dopo ogni richiesta API.

650 659

660Gli attributi `agent.name`, `skill.name`, `plugin.name`, `mcp_server.name`, e `mcp_tool.name` ciascuno redige alcuni nomi a un placeholder `"custom"` o `"third-party"` per impostazione predefinita. Se imposti `OTEL_LOG_TOOL_DETAILS=1`, portano invece i nomi reali. Prima della v2.1.273, i contatori di costo e token e gli eventi `api_request`, `api_error`, e `api_refusal` portavano i valori redatti anche con `OTEL_LOG_TOOL_DETAILS=1` impostato.

661

651**Attributi**:662**Attributi**:

652 663

653* Tutti gli [attributi standard](#standard-attributes)664* Tutti gli [attributi standard](#standard-attributes)

655* `query_source`: Categoria del sottosistema che ha emesso la richiesta. Uno di `"main"`, `"subagent"`, o `"auxiliary"`666* `query_source`: Categoria del sottosistema che ha emesso la richiesta. Uno di `"main"`, `"subagent"`, o `"auxiliary"`

656* `speed`: `"fast"` quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti667* `speed`: `"fast"` quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti

657* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo.668* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo.

658* `agent.name`: Tipo di subagent che ha emesso la richiesta. I nomi degli agenti incorporati e gli agenti dai plugin del marketplace ufficiale vengono visualizzati letteralmente. Gli altri nomi di agenti definiti dall'utente vengono sostituiti con `"custom"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato. Assente quando la richiesta non è stata emessa da un tipo di subagent denominato.669* `agent.name`: Tipo di subagent che ha emesso la richiesta. I nomi degli agenti incorporati e gli agenti dai plugin del marketplace ufficiale vengono visualizzati letteralmente. Gli altri nomi di agenti definiti dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non è stata emessa da un tipo di subagent denominato.

659* `skill.name`: Skill attiva per la richiesta, impostata dallo strumento Skill, da un comando `/`, o ereditata da un subagent generato. I nomi delle skill incorporati, in bundle, definiti dall'utente e dai plugin del marketplace ufficiale vengono visualizzati letteralmente. I nomi delle skill dei plugin di terze parti vengono sostituiti con `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato. Assente quando nessuna skill è attiva.670* `skill.name`: Skill attiva per la richiesta, impostata dallo strumento Skill, da un comando `/`, o ereditata da un subagent generato. I nomi delle skill incorporati, in bundle, definiti dall'utente e dai plugin del marketplace ufficiale vengono visualizzati letteralmente. I nomi delle skill dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando nessuna skill è attiva.

660* `plugin.name`: Plugin proprietario quando la skill attiva o il subagent è fornito da un plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati letteralmente. I nomi dei plugin di terze parti vengono sostituiti con `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato. Assente quando né la skill né il subagent hanno un plugin proprietario.671* `plugin.name`: Plugin proprietario quando la skill attiva o il subagent è fornito da un plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati letteralmente. I nomi dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando né la skill né il subagent hanno un plugin proprietario.

661* `marketplace.name`: Marketplace da cui è stato installato il plugin proprietario. Emesso solo per i plugin del marketplace ufficiale. Assente altrimenti.672* `marketplace.name`: Marketplace da cui è stato installato il plugin proprietario. Emesso solo per i plugin del marketplace ufficiale, anche con `OTEL_LOG_TOOL_DETAILS=1` impostato. Assente altrimenti.

662* `mcp_server.name`: Server MCP il cui risultato dello strumento questa richiesta ha consumato. I nomi dei server incorporati, proxy di claude.ai e del registro ufficiale vengono visualizzati letteralmente. I nomi dei server configurati dall'utente vengono sostituiti con `"custom"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP. Prima della v2.1.222, Claude Code impostava questo attributo su ogni richiesta dopo una chiamata dello strumento MCP, non solo su richieste che consumavano un risultato dello strumento, quindi i dashboard che lo aggregano mostrano un calo dopo l'aggiornamento.673* `mcp_server.name`: Server MCP il cui risultato dello strumento questa richiesta ha consumato. I nomi dei server incorporati, proxy di claude.ai e del registro ufficiale vengono visualizzati letteralmente. I nomi dei server configurati dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP. Prima della v2.1.222, Claude Code impostava questo attributo su ogni richiesta dopo una chiamata dello strumento MCP, non solo su richieste che consumavano un risultato dello strumento, quindi i dashboard che lo aggregano mostrano un calo dopo l'aggiornamento.

663* `mcp_tool.name`: Strumento MCP il cui risultato questa richiesta ha consumato, con lo stesso comportamento di redazione e versione di `mcp_server.name`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP.674* `mcp_tool.name`: Strumento MCP il cui risultato questa richiesta ha consumato, con lo stesso comportamento di redazione e versione di `mcp_server.name`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP.

664 675

665<h4 id="token-counter">676<h4 id="token-counter">

720| `prompt.id` | Identificatore UUID v4 che collega tutti gli eventi prodotti durante l'elaborazione di un singolo prompt dell'utente |731| `prompt.id` | Identificatore UUID v4 che collega tutti gli eventi prodotti durante l'elaborazione di un singolo prompt dell'utente |

721| `event.sequence` | Contatore a base 0 per ordinare gli eventi, conteggiato per processo Claude Code piuttosto che per sessione |732| `event.sequence` | Contatore a base 0 per ordinare gli eventi, conteggiato per processo Claude Code piuttosto che per sessione |

722| `message.uuid` | UUID del messaggio come persistente nella trascrizione della sessione, i file `~/.claude/projects/*/*.jsonl`. Presente su `assistant_response`, su `api_response_body`, e su `user_prompt` eccetto per i dispatching dei comandi, che possono produrre zero o molti messaggi. Su `assistant_response` e `api_response_body`, questo è il messaggio finale della trascrizione della risposta, da cui il `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo, o v2.1.274 o successivo su `api_response_body` |733| `message.uuid` | UUID del messaggio come persistente nella trascrizione della sessione, i file `~/.claude/projects/*/*.jsonl`. Presente su `assistant_response`, su `api_response_body`, e su `user_prompt` eccetto per i dispatching dei comandi, che possono produrre zero o molti messaggi. Su `assistant_response` e `api_response_body`, questo è il messaggio finale della trascrizione della risposta, da cui il `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo, o v2.1.274 o successivo su `api_response_body` |

734| `request_id` | ID della richiesta assegnato dal server, letto dall'intestazione della risposta `request-id`, ad esempio `req_011...`. Su una risposta senza intestazione `request-id`, come su [Amazon Bedrock](/docs/it/amazon-bedrock), il valore proviene dall'intestazione `x-amzn-requestid` invece. Presente su `api_request`, `api_error`, `api_refusal`, `assistant_response`, e `api_response_body` quando la risposta contiene una delle due intestazioni. Corrisponde allo stesso attributo sullo span di traccia `llm_request`. La fonte `x-amzn-requestid` richiede Claude Code v2.1.282 o successivo |

723| `client_request_id` | UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Presente su `api_request` e `api_error` su connessioni API di prima parte; assente su backend di provider di terze parti e quando la richiesta è stata ritentata tramite il fallback non in streaming. Accoppia una richiesta con la sua risposta e rimane disponibile per i guasti come i timeout che non hanno mai prodotto un `request_id` del server. Corrisponde allo stesso attributo sul span di traccia `llm_request`. Richiede Claude Code v2.1.214 o successivo |735| `client_request_id` | UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Presente su `api_request` e `api_error` su connessioni API di prima parte; assente su backend di provider di terze parti e quando la richiesta è stata ritentata tramite il fallback non in streaming. Accoppia una richiesta con la sua risposta e rimane disponibile per i guasti come i timeout che non hanno mai prodotto un `request_id` del server. Corrisponde allo stesso attributo sul span di traccia `llm_request`. Richiede Claude Code v2.1.214 o successivo |

724 736

725Per tracciare tutta l'attività attivata da un singolo prompt, filtra i tuoi eventi per un valore specifico di `prompt.id`. Questo restituisce l'evento user\_prompt, tutti gli eventi api\_request, e tutti gli eventi tool\_result che si sono verificati durante l'elaborazione di quel prompt.737Per tracciare tutta l'attività attivata da un singolo prompt, filtra i tuoi eventi per un valore specifico di `prompt.id`. Questo restituisce l'evento user\_prompt, tutti gli eventi api\_request, e tutti gli eventi tool\_result che si sono verificati durante l'elaborazione di quel prompt.

769* `response_length`: Lunghezza del testo della risposta in caratteri781* `response_length`: Lunghezza del testo della risposta in caratteri

770* `response`: Testo della risposta, troncato al limite di contenuto (60 KB per impostazione predefinita). Redatto a `<REDACTED>` per impostazione predefinita. Imposta `OTEL_LOG_ASSISTANT_RESPONSES=1` per includerlo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` non è impostato, `OTEL_LOG_USER_PROMPTS` lo controlla invece, quindi imposta `OTEL_LOG_ASSISTANT_RESPONSES=0` per mantenere le risposte redatte mentre la registrazione dei prompt è attiva782* `response`: Testo della risposta, troncato al limite di contenuto (60 KB per impostazione predefinita). Redatto a `<REDACTED>` per impostazione predefinita. Imposta `OTEL_LOG_ASSISTANT_RESPONSES=1` per includerlo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` non è impostato, `OTEL_LOG_USER_PROMPTS` lo controlla invece, quindi imposta `OTEL_LOG_ASSISTANT_RESPONSES=0` per mantenere le risposte redatte mentre la registrazione dei prompt è attiva

771* `model`: Identificatore del modello (ad esempio, "claude-sonnet-5")783* `model`: Identificatore del modello (ad esempio, "claude-sonnet-5")

772* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta. Presente solo quando l'API ne restituisce uno784* `request_id`: ID della richiesta API, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

773* `message.uuid`: UUID della voce di trascrizione finale della risposta. Una risposta API viene persistita come una voce di trascrizione per blocco di contenuto; questa è l'ultima, da cui il `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo785* `message.uuid`: UUID della voce di trascrizione finale della risposta. Una risposta API viene persistita come una voce di trascrizione per blocco di contenuto; questa è l'ultima, da cui il `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo

774* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent786* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent

775 787

829* `output_tokens`: Numero di token di output841* `output_tokens`: Numero di token di output

830* `cache_read_tokens`: Numero di token letti dalla cache842* `cache_read_tokens`: Numero di token letti dalla cache

831* `cache_creation_tokens`: Numero di token utilizzati per la creazione della cache843* `cache_creation_tokens`: Numero di token utilizzati per la creazione della cache

832* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.844* `request_id`: ID della richiesta API, ad esempio `"req_011..."`, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes).

833* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo845* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo

834* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva846* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva

835* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent847* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent

855* `status_code`: Codice di stato HTTP come numero. Assente per errori non HTTP come i guasti di connessione.867* `status_code`: Codice di stato HTTP come numero. Assente per errori non HTTP come i guasti di connessione.

856* `duration_ms`: Durata della richiesta in millisecondi868* `duration_ms`: Durata della richiesta in millisecondi

857* `attempt`: Numero totale di tentativi effettuati, inclusa la richiesta iniziale (`1` significa che non si sono verificati tentativi)869* `attempt`: Numero totale di tentativi effettuati, inclusa la richiesta iniziale (`1` significa che non si sono verificati tentativi)

858* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.870* `request_id`: ID della richiesta API, ad esempio `"req_011..."`, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes).

859* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Disponibile anche quando un guasto come un timeout o un errore di connessione non ha mai prodotto un `request_id` del server; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo871* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Disponibile anche quando un guasto come un timeout o un errore di connessione non ha mai prodotto un `request_id` del server; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo

860* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva872* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva

861* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent873* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent

877* `event.timestamp`: Timestamp ISO 8601889* `event.timestamp`: Timestamp ISO 8601

878* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)890* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

879* `model`: Identificatore del modello dalla richiesta891* `model`: Identificatore del modello dalla richiesta

880* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.892* `request_id`: ID della richiesta API, ad esempio `"req_011..."`, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes).

881* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent. Vedi [`api_request`](#api-request-event) per le definizioni.893* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent. Vedi [`api_request`](#api-request-event) per le definizioni.

882* `speed`: `"fast"` quando la [modalità veloce](/docs/it/fast-mode) è attiva, o `"normal"`894* `speed`: `"fast"` quando la [modalità veloce](/docs/it/fast-mode) è attiva, o `"normal"`

883* `attempt`: Numero del tentativo di ripetizione. Il primo tentativo è `1`.895* `attempt`: Numero del tentativo di ripetizione. Il primo tentativo è `1`.

932* `body_truncated`: `"true"` quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.944* `body_truncated`: `"true"` quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.

933* `model`: Identificatore del modello945* `model`: Identificatore del modello

934* `query_source`: Sottosistema che ha emesso la richiesta946* `query_source`: Sottosistema che ha emesso la richiesta

935* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.947* `request_id`: ID della richiesta API, ad esempio `"req_011..."`, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes).

936* `request_body_id`: Il `request_body_id` dell'[evento `api_request_body`](#api-request-body-event) a cui questa risposta risponde. Richiede Claude Code v2.1.274 o successivo948* `request_body_id`: Il `request_body_id` dell'[evento `api_request_body`](#api-request-body-event) a cui questa risposta risponde. Richiede Claude Code v2.1.274 o successivo

937* `message.id`: ID del messaggio che l'API ha assegnato alla risposta, il campo `id` del corpo della risposta. Richiede Claude Code v2.1.274 o successivo949* `message.id`: ID del messaggio che l'API ha assegnato alla risposta, il campo `id` del corpo della risposta. Richiede Claude Code v2.1.274 o successivo

938* `message.uuid`: UUID della voce di trascrizione finale della risposta. Insieme a `request_body_id`, collega un messaggio di trascrizione ai corpi di richiesta e risposta dietro di esso. Richiede Claude Code v2.1.274 o successivo950* `message.uuid`: UUID della voce di trascrizione finale della risposta. Insieme a `request_body_id`, collega un messaggio di trascrizione ai corpi di richiesta e risposta dietro di esso. Richiede Claude Code v2.1.274 o successivo

1561}1573}

1562```1574```

1563 1575

1564Per confermare che gli eventi arrivano, inviate un prompt in una sessione in esecuzione con questa configurazione e controllate il vostro SIEM per l'evento `claude_code.user_prompt`. Se nulla arriva, eseguite `claude --debug` e controllate il log di debug per gli errori di esportazione `[3P telemetry]`.1576Per confermare che gli eventi arrivano, inviate un prompt in una sessione in esecuzione con questa configurazione e controllate il vostro SIEM per l'evento `claude_code.user_prompt`. Se nulla arriva, avviate Claude Code con `claude --debug-file <path>` e controllate il log per gli errori di esportazione `[3P telemetry]`.

1565 1577

1566<h2 id="backend-considerations">1578<h2 id="backend-considerations">

1567 Considerazioni sul backend1579 Considerazioni sul backend

1631 * Gli eventi `tool_result` e `tool_decision` includono un attributo `tool_parameters` con comandi Bash, nomi dei server MCP e dello strumento, e nomi delle skill. I campi come `full_command` vengono emessi non troncati1643 * Gli eventi `tool_result` e `tool_decision` includono un attributo `tool_parameters` con comandi Bash, nomi dei server MCP e dello strumento, e nomi delle skill. I campi come `full_command` vengono emessi non troncati

1632 * Gli eventi `tool_result` includono inoltre un attributo `tool_input` con percorsi di file, URL, modelli di ricerca e altri argomenti. I singoli valori superiori a 512 caratteri vengono troncati e il totale è limitato a circa 4 K caratteri1644 * Gli eventi `tool_result` includono inoltre un attributo `tool_input` con percorsi di file, URL, modelli di ricerca e altri argomenti. I singoli valori superiori a 512 caratteri vengono troncati e il totale è limitato a circa 4 K caratteri

1633 * Gli eventi `user_prompt` includono il `command_name` verbatim per i comandi personalizzati, plugin e MCP1645 * Gli eventi `user_prompt` includono il `command_name` verbatim per i comandi personalizzati, plugin e MCP

1646 * Gli [contatori di costo e token](#cost-counter) e gli eventi `api_request`, `api_error` e `api_refusal` portano nomi reali di agente, skill, plugin e server MCP e strumento nei loro attributi di attribuzione

1634 * Gli span di traccia includono lo stesso attributo `tool_input` e attributi derivati dall'input come `file_path`, con lo stesso troncamento di `tool_input`1647 * Gli span di traccia includono lo stesso attributo `tool_input` e attributi derivati dall'input come `file_path`, con lo stesso troncamento di `tool_input`

1635* Il contenuto dello strumento non viene registrato negli span di traccia per impostazione predefinita. Per includerlo, imposta `OTEL_LOG_TOOL_CONTENT=1`. Lo span `claude_code.tool` quindi porta un [evento span `tool.output`](#tool-output-span-event) con contenuti di file grezzi e output dei comandi Bash, troncato al limite di contenuto (60 KB per impostazione predefinita) per attributo. Il contenuto dello strumento raggiunge anche gli span attraverso [`new_context`, il cui gate differisce per span](#new-context-gates). Configura il tuo backend di telemetria per filtrare o oscurare questi attributi secondo necessità1648* Il contenuto dello strumento non viene registrato negli span di traccia per impostazione predefinita. Per includerlo, imposta `OTEL_LOG_TOOL_CONTENT=1`. Lo span `claude_code.tool` quindi porta un [evento span `tool.output`](#tool-output-span-event) con contenuti di file grezzi, output dei comandi Bash e ciò che restituiscono gli strumenti MCP, WebFetch e WebSearch, troncato al limite di contenuto (60 KB per impostazione predefinita) per attributo. I risultati degli strumenti MCP, WebFetch e WebSearch richiedono Claude Code v2.1.283 o successivo. Il contenuto dello strumento raggiunge anche gli span attraverso [`new_context`, il cui gate differisce per span](#new-context-gates). Configura il tuo backend di telemetria per filtrare o oscurare questi attributi secondo necessità

1636* I corpi grezzi della richiesta e della risposta dell'API Anthropic Messages non vengono registrati per impostazione predefinita. Per includerli, imposta `OTEL_LOG_RAW_API_BODIES` nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Viene ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). I corpi contengono l'intera cronologia della conversazione, incluso il prompt di sistema, ogni turno precedente dell'utente e dell'assistente, e risultati degli strumenti, quindi l'abilitazione di questa opzione implica il consenso a tutto ciò che gli altri flag di contenuto `OTEL_LOG_*` rivelerebbero. Claude Code oscura sempre il contenuto del pensiero esteso di Claude in questi corpi, indipendentemente da altre impostazioni. Il valore che imposti determina come Claude Code fornisce i corpi:1649* I corpi grezzi della richiesta e della risposta dell'API Anthropic Messages non vengono registrati per impostazione predefinita. Per includerli, imposta `OTEL_LOG_RAW_API_BODIES` nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Viene ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). I corpi contengono l'intera cronologia della conversazione, incluso il prompt di sistema, ogni turno precedente dell'utente e dell'assistente, e risultati degli strumenti, quindi l'abilitazione di questa opzione implica il consenso a tutto ciò che gli altri flag di contenuto `OTEL_LOG_*` rivelerebbero. Claude Code oscura sempre il contenuto del pensiero esteso di Claude in questi corpi, indipendentemente da altre impostazioni. Il valore che imposti determina come Claude Code fornisce i corpi:

1637 * Con `=1`, Claude Code emette eventi di log `api_request_body` e `api_response_body` per ogni chiamata API. L'attributo `body` degli eventi porta il payload serializzato in JSON, troncato al limite di contenuto (60 KB per impostazione predefinita)1650 * Con `=1`, Claude Code emette eventi di log `api_request_body` e `api_response_body` per ogni chiamata API. L'attributo `body` degli eventi porta il payload serializzato in JSON, troncato al limite di contenuto (60 KB per impostazione predefinita)

1638 * Con `=file:<dir>`, Claude Code scrive i corpi non troncati nei file `.request.json` e `.response.json` in quella directory, e gli eventi portano un percorso `body_ref` invece del corpo inline. Spedisci la directory con un log collector o sidecar piuttosto che attraverso il flusso di telemetria1651 * Con `=file:<dir>`, Claude Code scrive i corpi non troncati nei file `.request.json` e `.response.json` in quella directory, e gli eventi portano un percorso `body_ref` invece del corpo inline. Spedisci la directory con un log collector o sidecar piuttosto che attraverso il flusso di telemetria.

1639 1652

1640 Per ogni risposta riuscita, Claude Code aggiunge anche una riga a `index.jsonl` in quella directory, collegando il file di risposta al file di richiesta che lo ha prodotto e al messaggio di trascrizione in cui è diventato. Ogni riga non contiene contenuto di messaggio, e la sezione [evento corpo della risposta API](#api-response-body-event) elenca i suoi campi. Il file di indice richiede Claude Code v2.1.274 o successivo1653 Per ogni risposta riuscita, Claude Code aggiunge anche una riga a `index.jsonl` in quella directory, collegando il file di risposta al file di richiesta che lo ha prodotto e al messaggio di trascrizione in cui è diventato. Ogni riga non contiene contenuto di messaggio, e la sezione [evento corpo della risposta API](#api-response-body-event) elenca i suoi campi. Il file di indice richiede Claude Code v2.1.274 o successivo

1641 1654

overview.md +3 −1

Details

18 <Tab title="Terminal">18 <Tab title="Terminal">

19 Il CLI completo per lavorare con Claude Code direttamente nel tuo terminale. Modifica file, esegui comandi e gestisci l'intero progetto dalla riga di comando.19 Il CLI completo per lavorare con Claude Code direttamente nel tuo terminale. Modifica file, esegui comandi e gestisci l'intero progetto dalla riga di comando.

20 20

~~21 Per installare Claude Code, utilizza uno dei seguenti metodi:~~21 Per installare Claude Code, apri un terminale ed esegui il comando per il tuo sistema. Se non hai mai utilizzato un terminale prima, la [guida al terminale](/docs/it/terminal-guide) mostra come aprirne uno e incollare il comando.

22 22

23 <Tabs>23 <Tabs>

24 <Tab title="Installazione nativa (consigliata)">24 <Tab title="Installazione nativa (consigliata)">

40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41 ```41 ```

42 42

43 Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).

43 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell. Il tuo prompt mostra `PS C:\` quando sei in PowerShell e `C:\` senza il `PS` quando sei in CMD.45 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell. Il tuo prompt mostra `PS C:\` quando sei in PowerShell e `C:\` senza il `PS` quando sei in CMD.

44 46

45 Se il comando di installazione non riesce con `syntax error near unexpected token '<'`, un `403`, o un altro errore curl, consulta [Troubleshoot installation](/docs/it/troubleshoot-install#find-your-error) per abbinare l'errore a una soluzione e per metodi di installazione alternativi.47 Se il comando di installazione non riesce con `syntax error near unexpected token '<'`, un `403`, o un altro errore curl, consulta [Troubleshoot installation](/docs/it/troubleshoot-install#find-your-error) per abbinare l'errore a una soluzione e per metodi di installazione alternativi.

permission-modes.md +78 −40

Details

4 4

5# Scegli una modalità di autorizzazione5# Scegli una modalità di autorizzazione

6 6

~~7> Controlla se Claude chiede prima di agire. Cambia le modalità di autorizzazione con Shift+Tab nella CLI, l'indicatore di modalità in VS Code, o il selettore di modalità in Desktop.~~7> Controlla se Claude chiede prima di agire. Cambia le modalità di autorizzazione con Shift+Tab nella CLI, l'indicatore di modalità in VS Code o il selettore di modalità in Desktop.

8 8

9Una modalità di autorizzazione imposta quali azioni Claude può intraprendere in una sessione senza chiederti prima. In modalità Manual, Claude Code si ferma e ti chiede prima della maggior parte delle azioni che modificano file, eseguono comandi shell, o raggiungono la rete. In [modalità auto](#eliminate-prompts-with-auto-mode), un secondo modello, il classificatore, esamina le azioni al tuo posto; [come il classificatore valuta le azioni](#how-the-classifier-evaluates-actions) elenca quali azioni esamina e quali le saltano.9Una modalità di autorizzazione imposta quali azioni Claude può intraprendere in una sessione senza chiederti prima. In modalità manuale, Claude Code si ferma e ti chiede prima della maggior parte delle azioni che modificano file, eseguono comandi shell o raggiungono la rete. In [auto mode](#eliminate-prompts-with-auto-mode), un secondo modello, il classificatore, esamina le azioni al tuo posto; [come il classificatore valuta le azioni](#how-the-classifier-evaluates-actions) elenca quali azioni esamina e quali le salta.

10 10

11Sui piani Pro, Max e Team, la modalità di autorizzazione iniziale integrata è la modalità auto. [Quale modalità inizia una sessione](#which-mode-a-session-starts-in) copre le superfici e le impostazioni che cambiano la modalità di autorizzazione iniziale. Puoi anche cambiare la modalità di autorizzazione di una sessione in esecuzione in qualsiasi momento.11Con Claude Code v2.1.283 o successivo, la modalità auto è la modalità di autorizzazione predefinita integrata per le sessioni di terminale interattivo e VS Code. Nelle versioni precedenti, è la modalità di autorizzazione predefinita integrata solo nei piani Pro, Max e Team. [Quale modalità inizia una sessione](#which-mode-a-session-starts-in) copre le superfici e le impostazioni che cambiano la modalità di autorizzazione iniziale. Puoi anche cambiare la modalità di autorizzazione di una sessione in esecuzione in qualsiasi momento.

12 12

13<h2 id="available-modes">13<h2 id="available-modes">

14 Modalità disponibili14 Modalità disponibili

58| Iterare localmente con meno prompt, senza un classificatore | Modalità Manual più la sandbox Bash in [modalità auto-allow](/docs/it/sandboxing#sandbox-modes): `claude --permission-mode default`, quindi esegui `/sandbox` e seleziona auto-allow | La sandbox Bash integrata, su macOS, Linux e WSL2 | Le regole di negazione si applicano comunque, e le regole di richiesta che nominano un comando, come `Bash(git push *)`, richiedono comunque un prompt. Per attivare la sandbox da un file di impostazioni, imposta [`sandbox.enabled`](/docs/it/settings-reference#sandbox-enabled) su `true` |58| Iterare localmente con meno prompt, senza un classificatore | Modalità Manual più la sandbox Bash in [modalità auto-allow](/docs/it/sandboxing#sandbox-modes): `claude --permission-mode default`, quindi esegui `/sandbox` e seleziona auto-allow | La sandbox Bash integrata, su macOS, Linux e WSL2 | Le regole di negazione si applicano comunque, e le regole di richiesta che nominano un comando, come `Bash(git push *)`, richiedono comunque un prompt. Per attivare la sandbox da un file di impostazioni, imposta [`sandbox.enabled`](/docs/it/settings-reference#sandbox-enabled) su `true` |

60| Lavorare senza intervento in modalità auto | `claude --permission-mode auto`, la [modalità di autorizzazione iniziale integrata](#which-mode-a-session-starts-in) su Pro, Max e Team | Nessuno; una sandbox o un container aggiunge difesa in profondità | Richiede un [modello supportato](#eliminate-prompts-with-auto-mode), e la tua organizzazione può [disattivare la modalità auto](#eliminate-prompts-with-auto-mode) |60| Lavorare senza intervento in modalità auto | `claude --permission-mode auto`, la [modalità di autorizzazione iniziale integrata](#which-mode-a-session-starts-in) con v2.1.283 o successivo | Nessuno; una sandbox o un container aggiunge difesa in profondità | Richiede un [modello supportato](#eliminate-prompts-with-auto-mode), e la tua organizzazione può [disattivare la modalità auto](#eliminate-prompts-with-auto-mode) |

61| Eseguire in CI con una lista di autorizzazione esatta | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Nessuno oltre a quello che il tuo runner CI fornisce | [Cloud sessions](/docs/it/claude-code-on-the-web) ignora `dontAsk` dai file di impostazioni |61| Eseguire in CI con una lista di autorizzazione esatta | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Nessuno oltre a quello che il tuo runner CI fornisce | [Cloud sessions](/docs/it/claude-code-on-the-web) ignora `dontAsk` dai file di impostazioni |

62| Eseguire completamente senza intervento dentro un container | `claude -p "<prompt>" --dangerously-skip-permissions` | Richiesto: un container, VM, o il [runtime sandbox](/docs/it/sandbox-environments#sandbox-runtime); su Linux e macOS, eseguilo come [utente non root](#skip-all-checks-with-bypasspermissions-mode) | Cloud sessions ignora questa modalità dai file di impostazioni. In questa esecuzione `-p`, le [poche chiamate che richiederebbero comunque un prompt](#skip-all-checks-with-bypasspermissions-mode) vengono negate invece |62| Eseguire completamente senza intervento dentro un container | `claude -p "<prompt>" --dangerously-skip-permissions` | Richiesto: un container, VM, o il [runtime sandbox](/docs/it/sandbox-environments#sandbox-runtime); su Linux e macOS, eseguilo come [utente non root](#skip-all-checks-with-bypasspermissions-mode) | Cloud sessions ignora questa modalità dai file di impostazioni. In questa esecuzione `-p`, le [poche chiamate che richiederebbero comunque un prompt](#skip-all-checks-with-bypasspermissions-mode) vengono negate invece |

63 63

81 81

82L'impostazione predefinita integrata `auto` richiede Claude Code v2.1.228 o successivo su macOS, Linux e WSL, e v2.1.233 o successivo su Windows nativo. Su versioni precedenti, l'impostazione predefinita integrata è Manual.82L'impostazione predefinita integrata `auto` richiede Claude Code v2.1.228 o successivo su macOS, Linux e WSL, e v2.1.233 o successivo su Windows nativo. Su versioni precedenti, l'impostazione predefinita integrata è Manual.

83 83

84L'impostazione predefinita integrata dipende da come esegui Claude Code, dal tuo piano, e da se Claude Code potrebbe recuperare i suoi flag di funzionalità. La prima riga che corrisponde alla tua sessione si applica. La tabella copre le sessioni che avvii in un terminale o tramite l'estensione VS Code; per l'app desktop e claude.ai, vedi le schede Desktop e Web in [Cambia modalità di autorizzazione](#switch-permission-modes).84L'impostazione predefinita integrata dipende da come esegui Claude Code. La prima riga che corrisponde alla tua sessione si applica. La tabella copre le sessioni che avvii in un terminale o tramite l'estensione VS Code; per l'app desktop e claude.ai, vedi le schede Desktop e Web in [Cambia modalità di autorizzazione](#switch-permission-modes).

85 85

86| Come esegui Claude Code | Modalità di autorizzazione iniziale integrata |86| Come esegui Claude Code | Modalità di autorizzazione iniziale integrata |

87| :- | :- |87| :- | :- |

88| Un file di impostazioni imposta `disableAutoMode` su `"disable"` | `default` |88| Un file di impostazioni imposta `disableAutoMode` su `"disable"` | `default` |

~~89| Il [recupero dei flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching) è disattivato | `default` |~~

90| La tua [prima sessione dopo aver installato Claude Code o aggiornato](/docs/it/env-vars#first-session-after-an-install-or-upgrade) a una versione che aggiunge questa impostazione predefinita, a meno che, dopo un'installazione pulita, Claude Code recuperi i flag in tempo | `default` |

91| `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/permissions) | `default` |89| `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/permissions) | `default` |

92| Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform su AWS](/docs/it/claude-platform-on-aws), o una sessione [gateway app Claude](/docs/it/claude-apps-gateway) con accesso | `default` |90| In un terminale o tramite l'[estensione VS Code](/docs/it/vs-code) | `auto` con Claude Code v2.1.283 o successivo; su versioni precedenti, `auto` su piani Pro, Max, o Team in sessioni che [recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), e `default` altrimenti |

~~93| Un piano Pro, Max o Team, in un terminale o tramite l'[estensione VS Code](/docs/it/vs-code) | `auto` |~~

~~94| Un piano Enterprise o una chiave API Claude Console | `default` |~~

95 91

96Quando il recupero dei flag di funzionalità è disattivato, o in una [prima sessione dopo un'installazione o aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade) dove i flag non sono ancora arrivati, l'estensione VS Code ignora ogni file di impostazioni quando sceglie la modalità di autorizzazione iniziale.92Nella tua [prima sessione dopo un'installazione o aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade), Claude Code può scegliere la modalità di autorizzazione iniziale prima che arrivino i suoi flag di funzionalità. Quella sessione può iniziare in una modalità di autorizzazione diversa da quella che la tabella fornisce, e la tua sessione successiva corrisponde alla tabella.

97 93

98Quando il flag, un file di impostazioni, o l'impostazione predefinita integrata seleziona `auto` ma la modalità auto non è disponibile per la sessione, Claude Code avvia la sessione in Manual invece. La modalità auto non è disponibile quando la sessione non soddisfa i [requisiti di disponibilità](#eliminate-prompts-with-auto-mode), come un file di impostazioni che la disattiva o un modello che non la supporta, o quando Anthropic l'ha temporaneamente disattivata lato server.94Quando il flag, un file di impostazioni, o l'impostazione predefinita integrata seleziona `auto` ma la modalità auto non è disponibile per la sessione, Claude Code avvia la sessione in Manual invece. La modalità auto non è disponibile quando la sessione non soddisfa i [requisiti di disponibilità](#eliminate-prompts-with-auto-mode), come un file di impostazioni che la disattiva o un modello che non la supporta, o quando Anthropic l'ha temporaneamente disattivata lato server.

99 95

102* In un terminale, una volta, in cima alla sessione98* In un terminale, una volta, in cima alla sessione

103* Nell'estensione VS Code, come una scheda nella schermata di nuova conversazione che rimane finché non la chiudi99* Nell'estensione VS Code, come una scheda nella schermata di nuova conversazione che rimane finché non la chiudi

104 100

105Sui piani Pro, Max e Team, se il tuo `~/.claude/settings.json` imposta un `defaultMode` diverso da `auto` e nessun altro file di impostazioni ne imposta uno, le tue sessioni continuano a iniziare in quella modalità. Claude Code chiede una volta, nel terminale o nell'estensione VS Code, se cambiare l'impostazione in modalità auto. Se rifiuti, la tua impostazione rimane come è.101Su piani Pro, Max e Team, se il tuo `~/.claude/settings.json` imposta un `defaultMode` diverso da `auto` e nessun altro file di impostazioni ne imposta uno, le tue sessioni continuano a iniziare in quella modalità. Claude Code chiede una volta, nel terminale o nell'estensione VS Code, se cambiare l'impostazione in modalità auto. Se rifiuti, la tua impostazione rimane come è.

106 102

107<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

108 Inizia in una modalità di autorizzazione diversa104 Inizia in una modalità di autorizzazione diversa

177 173

178 1. `claudeCode.initialPermissionMode`174 1. `claudeCode.initialPermissionMode`

179 2. La modalità che hai selezionato per ultimo dall'indicatore di modalità, se era Manual, Edit automatically, o Auto. Selezionare Plan o Bypass permissions si applica solo a quella conversazione175 2. La modalità che hai selezionato per ultimo dall'indicatore di modalità, se era Manual, Edit automatically, o Auto. Selezionare Plan o Bypass permissions si applica solo a quella conversazione

180 3. `permissions.defaultMode` da [impostazioni gestite](/docs/it/managed-settings) o `~/.claude/settings.json`, su piani Pro, Max e Team con [feature-flag fetching](#which-mode-a-session-starts-in) disponibile176 3. `permissions.defaultMode` da [impostazioni gestite](/docs/it/managed-settings) o `~/.claude/settings.json`

181 4. Il [predefinito incorporato](#which-mode-a-session-starts-in) per il tuo piano, provider e impostazioni dell'organizzazione177 4. Il [predefinito incorporato](#which-mode-a-session-starts-in) per il tuo piano, provider e impostazioni dell'organizzazione

182 178

183 L'estensione non legge mai il `.claude/settings.json` o `.claude/settings.local.json` di un progetto per la modalità di autorizzazione iniziale, e nelle conversazioni che non soddisfano le condizioni dell'elemento 3 non legge alcun file di impostazioni. Quando `claudeCode.claudeProcessWrapper` è impostato, gli elementi 3 e 4 non si applicano nemmeno: quelle conversazioni iniziano in Manual a meno che l'elemento 1 o l'elemento 2 non imposti una modalità di autorizzazione.179 L'estensione non legge mai il `.claude/settings.json` o `.claude/settings.local.json` di un progetto per la modalità di autorizzazione iniziale. Quando `claudeCode.claudeProcessWrapper` è impostato, gli elementi 3 e 4 non si applicano: quelle conversazioni iniziano in Manual a meno che l'elemento 1 o l'elemento 2 non imposti una modalità di autorizzazione.

180

181 Prima di v2.1.283, l'elemento 3 si applicava solo su piani Pro, Max e Team in sessioni che [recuperano feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching).

184 182

185 Auto appare nell'indicatore di modalità quando [auto mode è disponibile](#eliminate-prompts-with-auto-mode).183 Auto appare nell'indicatore di modalità quando [auto mode è disponibile](#eliminate-prompts-with-auto-mode).

186 184

214 Utilizza il menu a discesa della modalità accanto alla casella del prompt su [claude.ai/code](https://claude.ai/code) o nell'app mobile. I prompt di autorizzazione appaiono in claude.ai per l'approvazione. Quali modalità appaiono dipende da dove viene eseguita la sessione:212 Utilizza il menu a discesa della modalità accanto alla casella del prompt su [claude.ai/code](https://claude.ai/code) o nell'app mobile. I prompt di autorizzazione appaiono in claude.ai per l'approvazione. Quali modalità appaiono dipende da dove viene eseguita la sessione:

215 213

216 * **[Sessioni cloud](/docs/it/claude-code-on-the-web)**: Accept edits, Plan e Auto. Accept edits corrisponde alla modalità `default`: le sessioni cloud pre-approvano le modifiche ai file indipendentemente dalla modalità, quindi il menu a discesa mostra Accept edits invece di Manual. Le sessioni cloud rispettano comunque `defaultMode: "acceptEdits"` dalle impostazioni. La modalità Auto appare solo quando la tua organizzazione la consente e il modello selezionato la supporta. Bypass permissions non è disponibile.214 * **[Sessioni cloud](/docs/it/claude-code-on-the-web)**: Accept edits, Plan e Auto. Accept edits corrisponde alla modalità `default`: le sessioni cloud pre-approvano le modifiche ai file indipendentemente dalla modalità, quindi il menu a discesa mostra Accept edits invece di Manual. Le sessioni cloud rispettano comunque `defaultMode: "acceptEdits"` dalle impostazioni. La modalità Auto appare solo quando la tua organizzazione la consente e il modello selezionato la supporta. Bypass permissions non è disponibile.

217 * **[Sessioni Remote Control](/docs/it/remote-control)** sulla tua macchina locale: Manual, Accept edits e Plan. Non puoi selezionare Auto o Bypass permissions dall'app.215 * **[Sessioni Remote Control](/docs/it/remote-control)** sulla tua macchina locale: Manual, Accept edits e Plan per una sessione che hai avviato tu stesso, e non puoi selezionare Auto o Bypass permissions dall'app. Per un thread di progetto in esecuzione sul tuo computer, vedi [Esegui un thread sul tuo computer](/docs/it/claude-projects#run-a-thread-on-your-own-computer).

218 * Ad eccezione di Bypass permissions, il menu a discesa mostra la modalità di autorizzazione in cui si trova la sessione locale, inclusa una impostata dal terminale. Si aggiorna quando la modalità di autorizzazione cambia nell'app o nel terminale. La sessione non segnala mai Bypass permissions a claude.ai, quindi il passaggio ad essa dal terminale non cambia quello che il menu a discesa mostra.216 * Ad eccezione di Bypass permissions, il menu a discesa mostra la modalità di autorizzazione in cui si trova la sessione locale, inclusa una impostata dal terminale. Si aggiorna quando la modalità di autorizzazione cambia nell'app o nel terminale. La sessione non segnala mai Bypass permissions a claude.ai, quindi il passaggio ad essa dal terminale non cambia quello che il menu a discesa mostra.

219 * Le sessioni ospitate dall'[app desktop](/docs/it/desktop) o dall'[estensione VS Code](/docs/it/vs-code) segnalano i cambiamenti della modalità di autorizzazione a claude.ai mentre accadono, come le sessioni ospitate in un terminale.217 * Le sessioni ospitate dall'[app desktop](/docs/it/desktop) o dall'[estensione VS Code](/docs/it/vs-code) segnalano i cambiamenti della modalità di autorizzazione a claude.ai mentre accadono, come le sessioni ospitate in un terminale.

220 * Prima di v2.1.202, le sessioni connesse con `/remote-control` o `claude --remote-control` non segnalarono affatto la loro modalità di autorizzazione, quindi claude.ai e l'app mobile potevano mostrare una modalità di autorizzazione in cui la sessione non era. La discrepanza ha interessato solo l'etichetta. Claude Code ha generato prompt di autorizzazione dalla modalità di autorizzazione effettiva della sessione, e hanno comunque apparso nell'app per l'approvazione.218 * Prima di v2.1.202, le sessioni connesse con `/remote-control` o `claude --remote-control` non segnalarono affatto la loro modalità di autorizzazione, quindi claude.ai e l'app mobile potevano mostrare una modalità di autorizzazione in cui la sessione non era. La discrepanza ha interessato solo l'etichetta. Claude Code ha generato prompt di autorizzazione dalla modalità di autorizzazione effettiva della sessione, e hanno comunque apparso nell'app per l'approvazione.

233 231

234La modalità `acceptEdits` consente a Claude di creare e modificare file nella tua directory di lavoro senza richiedere conferma. La barra di stato mostra `⏵⏵ accept edits on` mentre questa modalità è attiva.232La modalità `acceptEdits` consente a Claude di creare e modificare file nella tua directory di lavoro senza richiedere conferma. La barra di stato mostra `⏵⏵ accept edits on` mentre questa modalità è attiva.

235 233

236Oltre alle modifiche ai file, la modalità `acceptEdits` auto-approva i comuni comandi Bash del filesystem: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` e `sed`. Questi comandi vengono anche auto-approvati quando preceduti da variabili di ambiente sicure come `LANG=C` o `NO_COLOR=1`, o da wrapper di processi come `timeout`, `nice` o `nohup`. Come per le modifiche ai file, l'auto-approvazione si applica solo ai percorsi all'interno della tua directory di lavoro o `additionalDirectories`. I percorsi al di fuori di questo ambito, le scritture su [percorsi protetti](#protected-paths), le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths), e tutti gli altri comandi Bash tranne il [set di sola lettura integrato](/docs/it/permissions#read-only-commands) richiedono comunque conferma.234Oltre alle modifiche ai file, la modalità `acceptEdits` auto-approva i comuni comandi Bash del filesystem: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` e `sed`. Questi comandi vengono anche auto-approvati quando preceduti da variabili di ambiente sicure come `LANG=C` o `NO_COLOR=1`, o da wrapper di processi come `timeout`, `nice` o `nohup`. Come per le modifiche ai file, l'auto-approvazione si applica solo ai percorsi all'interno della tua directory di lavoro o `additionalDirectories`.

235

236Ogni percorso passa anche attraverso il [controllo dei symlink](/docs/it/permissions#symlinks), quindi una scrittura che si risolve al di fuori di tale ambito non viene auto-approvata nemmeno. I percorsi al di fuori di tale ambito, le scritture su [percorsi protetti](#protected-paths), le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths), e tutti gli altri comandi Bash tranne il [set di sola lettura integrato](/docs/it/permissions#read-only-commands) richiedono comunque conferma.

237 237

238Quando lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) è abilitato, la modalità `acceptEdits` auto-approva anche `Set-Content`, `Add-Content`, `Clear-Content` e `Remove-Item` su percorsi nell'ambito, insieme ai loro alias comuni. Si applicano le stesse regole di ambito e percorsi protetti, e `Remove-Item` ottiene [il suo proprio controllo](#remove-item-in-powershell). Un argomento posizionale che contiene un carattere di virgolette, come l'apostrofo in `Set-Content .\notes.txt "It's done"`, richiede comunque conferma anche su percorsi nell'ambito, perché Claude Code non può convalidare staticamente un argomento le cui letture tra virgolette e non virgolette differiscono. Passa il contenuto attraverso un parametro denominato come `-Value` per evitare il prompt.238Quando lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) è abilitato, la modalità `acceptEdits` auto-approva anche `Set-Content`, `Add-Content`, `Clear-Content` e `Remove-Item` su percorsi nell'ambito, insieme ai loro alias comuni. Si applicano le stesse regole di ambito e percorsi protetti, e `Remove-Item` ottiene [il suo proprio controllo](#remove-item-in-powershell). Un argomento posizionale che contiene un carattere di virgolette, come l'apostrofo in `Set-Content .\notes.txt "It's done"`, richiede comunque conferma anche su percorsi nell'ambito, perché Claude Code non può convalidare staticamente un argomento le cui letture tra virgolette e non virgolette differiscono. Passa il contenuto attraverso un parametro denominato come `-Value` per evitare il prompt.

239 239

251 251

252La modalità plan dice a Claude di ricercare e proporre modifiche senza apportarle. Claude legge i file, esegue comandi shell per esplorare e scrive un piano, ma non modifica il tuo codice sorgente. Ad eccezione delle sessioni con [autorizzazioni di bypass disponibili](#skip-all-checks-with-bypasspermissions-mode), le modifiche rimangono bloccate finché non approvi il piano.252La modalità plan dice a Claude di ricercare e proporre modifiche senza apportarle. Claude legge i file, esegue comandi shell per esplorare e scrive un piano, ma non modifica il tuo codice sorgente. Ad eccezione delle sessioni con [autorizzazioni di bypass disponibili](#skip-all-checks-with-bypasspermissions-mode), le modifiche rimangono bloccate finché non approvi il piano.

253 253

254Quando [la modalità auto](/docs/it/auto-mode-config) è disponibile e l'impostazione `useAutoModeDuringPlan` è attiva, che è l'impostazione predefinita, il classificatore esamina i comandi shell durante la pianificazione invece di richiedere conferma. I comandi approvati vengono eseguiti, e quelli rifiutati vengono bloccati. Altrimenti, i comandi al di fuori del [set di sola lettura integrato](/docs/it/permissions#read-only-commands) richiedono approvazione, incluso quando la modalità [auto-allow](/docs/it/sandboxing#sandbox-modes) della sandbox è abilitata. Nelle sessioni con autorizzazioni di bypass disponibili, né il classificatore né un prompt si applica ai comandi di pianificazione; [Ignora tutti i controlli con la modalità bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) copre le poche cose che richiedono comunque prompt lì. Nella v2.1.212 attraverso v2.1.217, le sessioni senza autorizzazioni di bypass richiedevano conferma per ogni comando al di fuori del set di sola lettura, indipendentemente dal fatto che la modalità auto fosse disponibile.254Cosa accade a un comando shell durante la pianificazione dipende dalla sessione, e il primo di questi casi che corrisponde si applica:

255

256* **Sessioni di terminale interattive con autorizzazioni di bypass disponibili**: né il classificatore né un prompt si applica ai comandi di pianificazione. [Ignora tutti i controlli con la modalità bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) copre le poche cose che richiedono comunque prompt lì.

257* **[Modalità auto](/docs/it/auto-mode-config) disponibile e l'impostazione `useAutoModeDuringPlan` attiva**, che è l'impostazione predefinita: il classificatore esamina i comandi shell diversi da [rimozioni critiche](#critical-paths) invece di richiedere conferma. I comandi approvati vengono eseguiti, e quelli rifiutati vengono bloccati.

258* **Modalità auto non disponibile, o `useAutoModeDuringPlan` disattivata**: i comandi al di fuori del [set di sola lettura integrato](/docs/it/permissions#read-only-commands) richiedono approvazione, incluso quando la modalità [auto-allow](/docs/it/sandboxing#sandbox-modes) della sandbox è abilitata.

255 259

256Accedi alla modalità plan premendo `Shift+Tab` o anteponendo un singolo prompt con `/plan`. Puoi anche iniziare in modalità plan dalla CLI:260Accedi alla modalità plan premendo `Shift+Tab` o anteponendo un singolo prompt con `/plan`. Puoi anche iniziare in modalità plan dalla CLI:

257 261

289 293

290La modalità auto consente a Claude di eseguire senza prompt di autorizzazione di routine. Un modello classificatore separato esamina le azioni prima che vengano eseguite, bloccando qualsiasi cosa che vada oltre la vostra richiesta, che prenda di mira un'infrastruttura non riconosciuta, o che sembri guidata da contenuti ostili che Claude ha letto. Le [regole di richiesta](/docs/it/permissions#manage-permissions) esplicite forzano comunque un prompt.294La modalità auto consente a Claude di eseguire senza prompt di autorizzazione di routine. Un modello classificatore separato esamina le azioni prima che vengano eseguite, bloccando qualsiasi cosa che vada oltre la vostra richiesta, che prenda di mira un'infrastruttura non riconosciuta, o che sembri guidata da contenuti ostili che Claude ha letto. Le [regole di richiesta](/docs/it/permissions#manage-permissions) esplicite forzano comunque un prompt.

291 295

292Nei piani Pro, Max e Team, la modalità auto è la [modalità di autorizzazione predefinita della sessione](#which-mode-a-session-starts-in).296Con Claude Code v2.1.283 o successivo, la modalità auto è la [modalità di autorizzazione predefinita della sessione](#which-mode-a-session-starts-in) per le sessioni di terminale interattivo e VS Code su ogni piano e provider. Nelle versioni precedenti, è la modalità di autorizzazione predefinita della sessione solo sui piani Pro, Max e Team.

293 297

294Il classificatore esamina anche ogni messaggio che Claude invia a un altro agente con [`SendMessage`](/docs/it/tools-reference), sia testo semplice che un messaggio strutturato di [team di agenti](/docs/it/agent-teams), prima che Claude Code lo consegni, sia in modalità auto che in [modalità piano mentre il classificatore esamina i comandi](#analyze-before-you-edit-with-plan-mode); la revisione dell'invio richiede Claude Code v2.1.222 o successivo.298Il classificatore esamina anche ogni messaggio che Claude invia a un altro agente con [`SendMessage`](/docs/it/tools-reference), sia testo semplice che un messaggio strutturato di [team di agenti](/docs/it/agent-teams), prima che Claude Code lo consegni, sia in modalità auto che in [modalità piano mentre il classificatore esamina i comandi](#analyze-before-you-edit-with-plan-mode); la revisione dell'invio richiede Claude Code v2.1.222 o successivo.

295 299

296Il classificatore esamina e approva o blocca anche le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths), come `rm -rf /` e `rm -rf ~`, incluso quando la rimozione si trova all'interno della sostituzione di comando o processo.300Per impostazione predefinita, il classificatore non esamina le rimozioni `rm` e `rmdir` che prendono di mira un percorso critico, come `rm -rf /` o `rm -rf ~`. [Percorsi critici](#critical-paths) copre cosa accade loro in ogni modalità di autorizzazione.

297 301

298La modalità auto incoraggia anche Claude a continuare a lavorare senza fermarsi per domande di chiarimento, anche se Claude chiede comunque quando la vostra richiesta o un'abilità si basa esplicitamente su di essa. Per un comportamento più autonomo in una modalità che vi chiede comunque, impostate invece lo [stile di output proattivo](/docs/it/output-styles).302La modalità auto incoraggia anche Claude a continuare a lavorare senza fermarsi per domande di chiarimento, anche se Claude chiede comunque quando la vostra richiesta o un'abilità si basa esplicitamente su di essa. Per un comportamento più autonomo in una modalità che vi chiede comunque, impostate invece lo [stile di output proattivo](/docs/it/output-styles).

299 303

305 309

306* **Piano**: Tutti i piani.310* **Piano**: Tutti i piani.

307* **Organizzazione**: su Team ed Enterprise, la modalità auto è disponibile per impostazione predefinita. Gli amministratori possono disattivarla per l'organizzazione impostando `permissions.disableAutoMode` su `"disable"` nelle [impostazioni gestite](/docs/it/managed-settings).311* **Organizzazione**: su Team ed Enterprise, la modalità auto è disponibile per impostazione predefinita. Gli amministratori possono disattivarla per l'organizzazione impostando `permissions.disableAutoMode` su `"disable"` nelle [impostazioni gestite](/docs/it/managed-settings).

308* **Modello**: sull'API Anthropic e su [Claude Platform su AWS](/docs/it/claude-platform-on-aws), Claude Opus 4.6 o successivo, Sonnet 4.6 o successivo, o un [modello Fable](/docs/it/model-config#work-with-fable). Su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni [gateway di app Claude](/docs/it/claude-apps-gateway) con accesso, solo Claude Sonnet 5, Opus 4.7 o successivo e i modelli Fable. I modelli più vecchi, inclusi Sonnet 4.5, Opus 4.5, Haiku e modelli claude-3, non sono supportati su nessun provider.312* **Modello**: sull'API Anthropic e su [Claude Platform su AWS](/docs/it/claude-platform-on-aws), Claude Opus 4.6 o successivo, Sonnet 4.6 o successivo, o un [modello Fable](/docs/it/model-config#work-with-fable). Su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni [gateway di app Claude](/docs/it/claude-apps-gateway) con accesso, solo Claude Sonnet 5 o successivo, Opus 4.7 o successivo e i modelli Fable. I modelli più vecchi, inclusi Sonnet 4.5, Opus 4.5, Haiku e modelli claude-3, non sono supportati su nessun provider.

309* **Provider**: disponibile per impostazione predefinita sull'API Anthropic, Claude Platform su AWS, Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni gateway di app Claude con accesso.313* **Provider**: disponibile per impostazione predefinita sull'API Anthropic, Claude Platform su AWS, Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e sessioni gateway di app Claude con accesso.

310 314

311Se Claude Code segnala che la modalità auto non è disponibile, controllate prima questi requisiti e se un file di impostazioni imposta [`disableAutoMode`](/docs/it/settings-reference#disableautomode). Anthropic potrebbe anche aver disattivato la modalità auto lato server, oppure il server potrebbe aver rifiutato la modalità auto per il vostro account. Una sessione che ha ricevuto una di queste risposte mantiene la modalità auto disattivata fino al termine della sessione, quindi avviate una nuova sessione in seguito.315Se Claude Code segnala che la modalità auto non è disponibile, controllate prima questi requisiti e se un file di impostazioni imposta [`disableAutoMode`](/docs/it/settings-reference#disableautomode). Anthropic potrebbe anche aver disattivato la modalità auto lato server, oppure il server potrebbe aver rifiutato la modalità auto per il vostro account. Una sessione che ha ricevuto una di queste risposte mantiene la modalità auto disattivata fino al termine della sessione, quindi avviate una nuova sessione in seguito.

318 Modalità auto su Bedrock, Agent Platform o Foundry322 Modalità auto su Bedrock, Agent Platform o Foundry

319</h3>323</h3>

320 324

321Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Agent Platform di Google Cloud](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) e sessioni [gateway di app Claude](/docs/it/claude-apps-gateway) con accesso, la modalità auto appare nel ciclo `Shift+Tab` per impostazione predefinita. L'apparizione nel ciclo non cambia la modalità di autorizzazione in cui una sessione inizia: su questi provider, le sessioni di terminale iniziano nella vostra [`defaultMode`](/docs/it/settings-reference#permissions-defaultmode), che è Manuale a meno che non la cambiate, e le conversazioni nell'[estensione VS Code](/docs/it/vs-code) iniziano in Manuale a meno che `claudeCode.initialPermissionMode` o una modalità che avete scelto nell'estensione ne imposti una. Solo Claude Sonnet 5, Opus 4.7 o successivo e i modelli Fable sono supportati su questi provider.325Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Agent Platform di Google Cloud](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) e sessioni [gateway di app Claude](/docs/it/claude-apps-gateway) con accesso, la modalità auto è disponibile per impostazione predefinita. Con Claude Code v2.1.283 o successivo, è anche la [modalità di autorizzazione predefinita della sessione](#which-mode-a-session-starts-in) per le sessioni di terminale interattivo e [VS Code](/docs/it/vs-code). Per scegliere voi stessi la modalità di autorizzazione iniziale, impostate `permissions.defaultMode` come [Inizia in una modalità di autorizzazione diversa](#start-in-a-different-mode) descrive, o scegliete una modalità di autorizzazione dall'indicatore di modalità dell'estensione VS Code.

322 326

323Per rendere la modalità auto la modalità di autorizzazione predefinita all'avvio, impostate `"permissions": {"defaultMode": "auto"}` nelle impostazioni utente o gestite. Nelle sessioni avviate dall'estensione VS Code, selezionate invece **Auto** dall'indicatore di modalità. [Cambia modalità di autorizzazione](#switch-permission-modes) copre cosa ha la precedenza su quella scelta.327Solo Claude Sonnet 5 o successivo, Opus 4.7 o successivo e i modelli Fable sono supportati su questi provider. Su qualsiasi altro modello, la sessione inizia in Manuale.

~~324~~

325Il checkup [`/doctor`](/docs/it/commands#all-commands) propone questa impostazione predefinita delle impostazioni utente su questi provider nello stesso modo in cui lo fa sull'API Anthropic.

326 328

327Per impedire agli sviluppatori di utilizzare la modalità auto, impostate `disableAutoMode` su `"disable"` nelle [impostazioni gestite](/docs/it/managed-settings). Questo rimuove `auto` dal ciclo `Shift+Tab` e una sessione avviata con `--permission-mode auto` inizia in Manuale. Una sessione già in esecuzione in modalità auto la abbandona quando l'impostazione la raggiunge da un'[origine distribuita da amministratore](/docs/it/managed-settings#which-managed-source-claude-code-uses) e mostra `auto mode disabled by settings`. Prima della v2.1.251, una sessione in esecuzione manteneva la modalità auto fino al termine.329Per impedire agli sviluppatori di utilizzare la modalità auto, impostate `disableAutoMode` su `"disable"` nelle [impostazioni gestite](/docs/it/managed-settings). Questo rimuove `auto` dal ciclo `Shift+Tab` e una sessione avviata con `--permission-mode auto` inizia in Manuale. Una sessione già in esecuzione in modalità auto la abbandona quando l'impostazione la raggiunge da un'[origine distribuita da amministratore](/docs/it/managed-settings#which-managed-source-claude-code-uses) e mostra `auto mode disabled by settings`. Prima della v2.1.251, una sessione in esecuzione manteneva la modalità auto fino al termine.

328 330

343* **Il server non esamina la sessione**: una risposta si completa senza risultati di revisione, oppure il server risponde che non esamina questa sessione. Le cause più comuni sono un gateway LLM o un proxy che scarta la richiesta di revisione o i risultati, e una piattaforma, una regione o una credenziale che non ha ancora controlli lato server. Claude Code ricade alle proprie richieste del classificatore. Una volta che questo fallback vale per il resto della sessione, mostra un [avviso sugli addebiti delle richieste del classificatore](/docs/it/auto-mode-classifier-billing) su account in cui queste richieste vengono fatturate.345* **Il server non esamina la sessione**: una risposta si completa senza risultati di revisione, oppure il server risponde che non esamina questa sessione. Le cause più comuni sono un gateway LLM o un proxy che scarta la richiesta di revisione o i risultati, e una piattaforma, una regione o una credenziale che non ha ancora controlli lato server. Claude Code ricade alle proprie richieste del classificatore. Una volta che questo fallback vale per il resto della sessione, mostra un [avviso sugli addebiti delle richieste del classificatore](/docs/it/auto-mode-classifier-billing) su account in cui queste richieste vengono fatturate.

344* **Il server non fornisce un verdetto per un'azione**: Claude Code nega l'azione piuttosto che eseguirla senza revisione. Su qualsiasi connessione, questo accade quando la risposta termina prima che i risultati della revisione arrivino o i risultati arrivano in una forma che Claude Code non può leggere. Un gateway LLM o un proxy che taglia le risposte corte o riscrive i risultati può causare entrambi. Su una connessione diretta all'API Anthropic, accade anche quando il controllo del server non riesce per l'azione, ad esempio per timeout. [Il server non ha restituito un verdetto di sicurezza](/docs/it/errors#the-server-returned-no-safety-verdict) copre il messaggio di negazione, cosa accade quando le negazioni si ripetono e cosa fare.346* **Il server non fornisce un verdetto per un'azione**: Claude Code nega l'azione piuttosto che eseguirla senza revisione. Su qualsiasi connessione, questo accade quando la risposta termina prima che i risultati della revisione arrivino o i risultati arrivano in una forma che Claude Code non può leggere. Un gateway LLM o un proxy che taglia le risposte corte o riscrive i risultati può causare entrambi. Su una connessione diretta all'API Anthropic, accade anche quando il controllo del server non riesce per l'azione, ad esempio per timeout. [Il server non ha restituito un verdetto di sicurezza](/docs/it/errors#the-server-returned-no-safety-verdict) copre il messaggio di negazione, cosa accade quando le negazioni si ripetono e cosa fare.

345 347

346Per saltare la richiesta al server e utilizzare sempre le proprie richieste del classificatore di Claude Code, impostate [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/it/env-vars). Su una connessione diretta all'API Anthropic, la variabile richiede Claude Code v2.1.281 o successivo. Impostarla su `1` lì attiva la revisione del server in una sessione che non ce l'ha ancora, come una sessione `-p` o Agent SDK, a meno che non abbiate anche impostato `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Se impostate `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e lasciate `CLAUDE_CODE_AUTO_MODE_SERVER` non impostato, Claude Code smette anche di chiedere al server.348Per saltare la richiesta al server e utilizzare sempre le proprie richieste del classificatore di Claude Code, impostate [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/it/env-vars). Su una connessione diretta all'API Anthropic, la variabile richiede Claude Code v2.1.281 o successivo. Impostarla su `1` lì attiva la revisione del server in una sessione che non ce l'ha ancora, come una sessione `-p` o Agent SDK, a meno che non abbiate anche impostato `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Se impostate `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e lasciate `CLAUDE_CODE_AUTO_MODE_SERVER` non impostato, Claude Code smette anche di chiedere al server, eccetto come [Disabilita le capacità di pre-rilascio](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) descrive.

347 349

348<h3 id="what-the-classifier-blocks-by-default">350<h3 id="what-the-classifier-blocks-by-default">

349 Cosa blocca il classificatore per impostazione predefinita351 Cosa blocca il classificatore per impostazione predefinita

407Claude Code v2.1.205 e successivo bloccano anche questi per impostazione predefinita:409Claude Code v2.1.205 e successivo bloccano anche questi per impostazione predefinita:

408 410

409* Scrittura nelle trascrizioni di sessione di Claude Code, i file di cronologia `.jsonl` sotto `~/.claude/projects/` o la vostra directory di configurazione configurata, direttamente o tramite un comando di shell. La regola copre anche le righe di metadati che Claude Code aggiunge a ogni voce di trascrizione per i propri controlli. La lettura di una trascrizione non è bloccata411* Scrittura nelle trascrizioni di sessione di Claude Code, i file di cronologia `.jsonl` sotto `~/.claude/projects/` o la vostra directory di configurazione configurata, direttamente o tramite un comando di shell. La regola copre anche le righe di metadati che Claude Code aggiunge a ogni voce di trascrizione per i propri controlli. La lettura di una trascrizione non è bloccata

410* Un'eliminazione forzata ricorsiva come `rm -rf "$VAR"` o `Remove-Item -Recurse -Force $dir` il cui target è una variabile di shell, o un glob radicato in una, che non è assegnato da nessuna parte nella conversazione che il classificatore vede. Il valore proveniva solo dall'output di comando precedente, che il classificatore non riceve mai, quindi il classificatore non può verificare il target di eliminazione rispetto alle altre regole di eliminazione. Il blocco si cancella quando nominate il percorso esatto che viene eliminato, o quando Claude riesegue l'eliminazione con il percorso letterale risolto scritto nel comando. Le eliminazioni il cui target il classificatore può risolvere non sono interessate. I target `Remove-Item` che sono un `*` nudo o terminano in `/*` o `\*` non raggiungono mai il classificatore: Claude Code [li nega direttamente](#remove-item-in-powershell)412* Un'eliminazione forzata ricorsiva come `rm -rf "$VAR"` o `Remove-Item -Recurse -Force $dir` il cui target è una variabile di shell che non è assegnata da nessuna parte nella conversazione che il classificatore vede, o un glob radicato in una. Il valore proveniva solo dall'output di comando precedente, che il classificatore non riceve mai, quindi il classificatore non può verificare il target di eliminazione rispetto alle altre regole di eliminazione. Il blocco si cancella quando nominate il percorso esatto che viene eliminato, o quando Claude riesegue l'eliminazione con il percorso letterale risolto scritto nel comando. Le eliminazioni il cui target il classificatore può risolvere non sono interessate.

413

414 Un glob direttamente sotto la variabile, come in `rm -rf "$VAR"/*`, è un [percorso critico](#critical-paths) invece. I target `Remove-Item` che sono un `*` nudo o terminano in `/*` o `\*` non raggiungono mai il classificatore: Claude Code [li nega direttamente](#remove-item-in-powershell).

411 415

412Claude Code v2.1.257 e successivo bloccano anche questi per impostazione predefinita:416Claude Code v2.1.257 e successivo bloccano anche questi per impostazione predefinita:

413 417

454 458

455Qualunque sia la vostra risposta, Claude continua a lavorare:459Qualunque sia la vostra risposta, Claude continua a lavorare:

456 460

457* **Continua a consentire**: la lettura viene eseguita, le letture successive al di fuori delle directory di lavoro vengono eseguite come prima, e Claude Code registra la vostra risposta in modo che il prompt non appaia di nuovo461* **Sì, e continua a consentire qualsiasi lettura al di fuori delle directory di lavoro**: la lettura viene eseguita, le letture successive al di fuori delle directory di lavoro vengono eseguite come prima, e Claude Code registra la vostra risposta in modo che il prompt non appaia di nuovo

458* **Blocca da ora in poi**: la lettura viene rifiutata e Claude Code imposta [`permissions.blockReadsOutsideWorkingDirectories`](/docs/it/settings-reference#permissions-blockreadsoutsideworkingdirectories) su `true` nelle vostre impostazioni utente, il che fa sì che gli strumenti di file rifiutino tali letture in ogni sessione successiva e in ogni modalità di autorizzazione. Per consentire a Claude di leggere tale percorso in seguito, aggiungete la sua directory con `/add-dir` o rimuovete l'impostazione.462* **No, e blocca le letture al di fuori delle directory di lavoro da ora in poi**: la lettura viene rifiutata, e Claude Code imposta [`permissions.blockReadsOutsideWorkingDirectories`](/docs/it/settings-reference#permissions-blockreadsoutsideworkingdirectories) su `true` nelle vostre impostazioni utente, il che fa sì che gli strumenti di file rifiutino tali letture in ogni sessione successiva e in ogni modalità di autorizzazione. Per consentire a Claude di leggere tale percorso in seguito, aggiungete la sua directory con `/add-dir` o rimuovete l'impostazione.

459* **Chiedi di nuovo la prossima volta**: la lettura viene rifiutata e la prossima lettura al di fuori delle directory di lavoro chiede di nuovo463* **No, e chiedi di nuovo la prossima volta**: la lettura viene rifiutata, e la prossima lettura al di fuori delle directory di lavoro chiede di nuovo

464* **Sì, ma chiedi di nuovo la prossima volta**: la lettura viene eseguita, nulla viene salvato, e la prossima lettura al di fuori delle directory di lavoro chiede di nuovo

460 465

461<h3 id="boundaries-you-state-in-conversation">466<h3 id="boundaries-you-state-in-conversation">

462 Confini che dichiarate nella conversazione467 Confini che dichiarate nella conversazione

497 Ogni azione passa attraverso un ordine decisionale fisso. Il primo passaggio corrispondente vince:502 Ogni azione passa attraverso un ordine decisionale fisso. Il primo passaggio corrispondente vince:

498 503

499 1. Le azioni che corrispondono alle vostre [regole di consentimento, richiesta o negazione](/docs/it/permissions#manage-permissions) si risolvono immediatamente, con queste eccezioni:504 1. Le azioni che corrispondono alle vostre [regole di consentimento, richiesta o negazione](/docs/it/permissions#manage-permissions) si risolvono immediatamente, con queste eccezioni:

500 * Le scritture su [percorsi protetti](#protected-paths) vengono instradate al classificatore anche quando una regola di consentimento corrisponde, e così anche le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths) in Claude Code v2.1.218 e successivo505 * Le scritture su [percorsi protetti](#protected-paths) vengono instradate al classificatore anche quando una regola di consentimento corrisponde

506 * Nessuna regola di consentimento approva le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths)

501 * Gli strumenti MCP contrassegnati [`requiresUserInteraction`](/docs/it/mcp#require-approval-for-a-specific-tool) vi chiedono direttamente anche quando una regola di consentimento corrisponde, e così anche gli strumenti connettore [che la vostra organizzazione ha impostato su `ask`](/docs/it/mcp#organization-controls-on-connector-tools) nelle sessioni in cui quella impostazione raggiunge Claude Code507 * Gli strumenti MCP contrassegnati [`requiresUserInteraction`](/docs/it/mcp#require-approval-for-a-specific-tool) vi chiedono direttamente anche quando una regola di consentimento corrisponde, e così anche gli strumenti connettore [che la vostra organizzazione ha impostato su `ask`](/docs/it/mcp#organization-controls-on-connector-tools) nelle sessioni in cui quella impostazione raggiunge Claude Code

502 * Un comando di shell che contiene [domini consentiti per comando](/docs/it/sandboxing#per-command-allowed-domains-in-auto-mode) viene anche instradato al classificatore anche quando una regola di consentimento corrisponde, perché una regola approva il comando, non i suoi host508 * Un comando di shell che contiene [domini consentiti per comando](/docs/it/sandboxing#per-command-allowed-domains-in-auto-mode) viene anche instradato al classificatore anche quando una regola di consentimento corrisponde, perché una regola approva il comando, non i suoi host

503 * Le regole di richiesta che corrispondono al contenuto di un comando, come `Bash(git push *)`, ricadono a un prompt di autorizzazione509 * Le regole di richiesta che corrispondono al contenuto di un comando, come `Bash(git push *)`, ricadono a un prompt di autorizzazione

510 * Una scrittura che il [controllo symlink](/docs/it/permissions#symlinks) risolve a un percorso protetto vi chiede quando il percorso che Claude ha richiesto non è esso stesso protetto

504 2. Le azioni di sola lettura e le modifiche di file nella vostra directory di lavoro vengono approvate automaticamente, eccetto le scritture su [percorsi protetti](#protected-paths) e [la prima lettura al di fuori delle directory di lavoro](#first-read-outside-the-working-directories), che vi chiede511 2. Le azioni di sola lettura e le modifiche di file nella vostra directory di lavoro vengono approvate automaticamente, eccetto le scritture su [percorsi protetti](#protected-paths) e [la prima lettura al di fuori delle directory di lavoro](#first-read-outside-the-working-directories), che vi chiede

505 * In una sessione con [revisione del classificatore lato server](#server-side-classifier-review), le azioni di sola lettura e i comandi di shell [in sandbox](/docs/it/sandboxing#sandbox-modes) attendono quella revisione e vengono bloccati se la contrassegna512 * In una sessione con [revisione del classificatore lato server](#server-side-classifier-review), le azioni di sola lettura e i comandi di shell [in sandbox](/docs/it/sandboxing#sandbox-modes) attendono quella revisione e vengono bloccati se la contrassegna

506 3. Tutto il resto va al classificatore. Gli strumenti connettore e gli strumenti MCP `requiresUserInteraction` che vi chiedono direttamente nel passaggio 1 non raggiungono mai il classificatore, quindi né un'approvazione richiesta dall'organizzazione né un passaggio di consenso viene approvato automaticamente513 * Una scrittura dentro la vostra directory di lavoro che il [controllo symlink](/docs/it/permissions#symlinks) risolve a una posizione al di fuori di essa vi chiede

514 3. Tutto il resto va al classificatore, a parte le [rimozioni di percorsi critici](#critical-paths) sotto il loro trattamento predefinito. Gli strumenti connettore e gli strumenti MCP `requiresUserInteraction` che vi chiedono direttamente nel passaggio 1 non raggiungono mai il classificatore, quindi né un'approvazione richiesta dall'organizzazione né un passaggio di consenso viene approvato automaticamente

507 4. Se il classificatore blocca, Claude riceve il motivo e prova un'alternativa. Nella maggior parte delle sessioni il motivo nomina la regola che il classificatore ha abbinato, come `[Data Exfiltration]`, piuttosto che dare una spiegazione scritta; consultate [Rivedi negazioni](/docs/it/auto-mode-config#review-denials)515 4. Se il classificatore blocca, Claude riceve il motivo e prova un'alternativa. Nella maggior parte delle sessioni il motivo nomina la regola che il classificatore ha abbinato, come `[Data Exfiltration]`, piuttosto che dare una spiegazione scritta; consultate [Rivedi negazioni](/docs/it/auto-mode-config#review-denials)

508 516

509 Entrando in modalità auto, le regole di consentimento ampie che concedono l'esecuzione arbitraria di codice vengono eliminate:517 Entrando in modalità auto, le regole di consentimento ampie che concedono l'esecuzione arbitraria di codice vengono eliminate:

568 576

569La modalità `bypassPermissions` disabilita i prompt di autorizzazione e i controlli di sicurezza in modo che le chiamate agli strumenti vengono eseguite immediatamente, incluse le scritture su [percorsi protetti](#protected-paths).577La modalità `bypassPermissions` disabilita i prompt di autorizzazione e i controlli di sicurezza in modo che le chiamate agli strumenti vengono eseguite immediatamente, incluse le scritture su [percorsi protetti](#protected-paths).

570 578

571Le [azioni che nessuna modalità auto-approva](#actions-no-mode-auto-approves) richiedono comunque un prompt in questa modalità.579Le [azioni che nessuna modalità auto-approva](#actions-no-mode-auto-approves) richiedono comunque un prompt in questa modalità. I [Remove-Item in PowerShell](#remove-item-in-powershell) negano anche si applicano in questa modalità.

572 580

573Due [protezioni di messaggistica cross-sessione](/docs/it/cross-session-messaging) si applicano comunque in questa modalità, e in sessioni in modalità plan interattive dove le autorizzazioni di bypass sono disponibili:581Due [protezioni di messaggistica cross-sessione](/docs/it/cross-session-messaging) si applicano comunque in questa modalità, e in sessioni in modalità plan interattive dove le autorizzazioni di bypass sono disponibili:

574 582

603 611

604Il controllo viene saltato automaticamente all'interno di una sandbox riconosciuta. Per eseguire in modo autonomo in un container, utilizza la configurazione [dev container](/docs/it/devcontainer), che esegue Claude Code come utente non root.612Il controllo viene saltato automaticamente all'interno di una sandbox riconosciuta. Per eseguire in modo autonomo in un container, utilizza la configurazione [dev container](/docs/it/devcontainer), che esegue Claude Code come utente non root.

605 613

606[Claude Code sul web](/docs/it/claude-code-on-the-web) non rispetta `defaultMode: "bypassPermissions"` o `"dontAsk"` dai file di impostazioni, quindi le impostazioni archiviate di un repository non possono avviare una sessione cloud in modalità bypass-permissions. L'impostazione viene ignorata silenziosamente e la sessione si avvia nella modalità mostrata nel menu a discesa della modalità. Vedi [Cambia modalità di autorizzazione](#switch-permission-modes) per le modalità offerte dalle sessioni cloud.614[Cloud sessions](/docs/it/claude-code-on-the-web) non rispettano `defaultMode: "bypassPermissions"` o `"dontAsk"` dai file di impostazioni, quindi le impostazioni archiviate di un repository non possono avviare una sessione cloud in modalità bypass-permissions. L'impostazione viene ignorata silenziosamente e la sessione si avvia nella modalità mostrata nel menu a discesa della modalità. Vedi [Cambia modalità di autorizzazione](#switch-permission-modes) per le modalità offerte dalle sessioni cloud.

607 615

608<Warning>616<Warning>

609 `bypassPermissions` non offre protezione contro l'iniezione di prompt o azioni indesiderate. Per i controlli di sicurezza di background con molti meno prompt di autorizzazione, utilizza invece la [modalità auto](#eliminate-prompts-with-auto-mode). Gli amministratori possono bloccare questa modalità impostando `permissions.disableBypassPermissionsMode` su `"disable"` nelle [impostazioni gestite](/docs/it/managed-settings).617 `bypassPermissions` non offre protezione contro l'iniezione di prompt o azioni indesiderate. Per i controlli di sicurezza di background con molti meno prompt di autorizzazione, utilizza invece la [modalità auto](#eliminate-prompts-with-auto-mode). Gli amministratori possono bloccare questa modalità impostando `permissions.disableBypassPermissionsMode` su `"disable"` nelle [impostazioni gestite](/docs/it/managed-settings).

625 633

626In una sessione avviata con [`--restricted`](/docs/it/cli-reference#cli-flags), che richiede Claude Code v2.1.248 o successivo, il classificatore non può approvare le scritture su percorsi protetti.634In una sessione avviata con [`--restricted`](/docs/it/cli-reference#cli-flags), che richiede Claude Code v2.1.248 o successivo, il classificatore non può approvare le scritture su percorsi protetti.

627 635

628Le regole [`permissions.allow`](/docs/it/permissions#manage-permissions) nei file di impostazioni non pre-approvano le scritture su percorsi protetti. Il controllo di sicurezza viene eseguito prima che Claude Code valuti le regole allow dalle impostazioni, quindi una voce come `Edit(.claude/**)` in `~/.claude/settings.json` o `.claude/settings.json` non modifica il risultato per modalità nella tabella precedente. Nelle modalità che richiedono conferma, il prompt per una scrittura `.claude/` offre **Sì, e consenti a Claude di modificare le proprie impostazioni per questa sessione**, che approva le successive scritture `.claude/` in quella sessione senza richiedere di nuovo la conferma.636Nelle modalità che instradano le scritture su percorsi protetti al classificatore, una scrittura che il [controllo dei symlink](/docs/it/permissions#symlinks) risolve in un percorso protetto richiede conferma quando il percorso richiesto da Claude non è esso stesso protetto.

637

638Le regole [`permissions.allow`](/docs/it/permissions#manage-permissions) nei file di impostazioni non pre-approvano le scritture su percorsi protetti. Il controllo di sicurezza viene eseguito prima che Claude Code valuti le regole allow dalle impostazioni, quindi una voce come `Edit(.claude/**)` in `~/.claude/settings.json` o `.claude/settings.json` non modifica il risultato per modalità nella tabella precedente. Nelle modalità che richiedono conferma, il prompt per una scrittura nella cartella `.claude/` del progetto o in `~/.claude/` può offrire una di queste opzioni con ambito di sessione:

639

640* Per la cartella `.claude/` del progetto: **Sì, e consenti a Claude di modificare i file nella cartella .claude di questo progetto per questa sessione**

641* Per `~/.claude/`: **Sì, e consenti a Claude di modificare i file nella sua cartella \~/.claude per questa sessione**

629 642

630Directory protette:643Directory protette:

631 644

663| Modalità | Cosa Claude Code fa con una rimozione di percorso critico |676| Modalità | Cosa Claude Code fa con una rimozione di percorso critico |

664| :- | :- |677| :- | :- |

666| `plan` | Ti chiede di approvarlo. Con [la modalità auto disponibile durante la pianificazione](#analyze-before-you-edit-with-plan-mode) e nessuna autorizzazione di bypass disponibile, lo invia al classificatore invece |679| `plan` | Ti chiede di approvarlo. Quando [il classificatore esamina i comandi durante la pianificazione](#analyze-before-you-edit-with-plan-mode) e nessuna autorizzazione di bypass è disponibile, lo gestisce come in modalità `auto` |

683

684Se una [regola ask](/docs/it/permissions#manage-permissions) esplicita corrisponde al comando, Claude Code ti chiede invece, anche in modalità `auto` e senza un limite di tempo. Nelle modalità che chiedono, un hook [`PermissionRequest`](/docs/it/hooks#permissionrequest) può rispondere al prompt.

685

686La gestione di `auto` e `bypassPermissions` richiede Claude Code v2.1.281 o successivo. Per disattivarla, imposta [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1`](/docs/it/env-vars#variables) nell'ambiente che avvia Claude Code. In modalità `auto`, le rimozioni di percorsi critici vanno al classificatore invece, e in modalità `bypassPermissions` il prompt non ha un limite di tempo.

670 687

671Se una [regola ask](/docs/it/permissions#manage-permissions) esplicita corrisponde al comando, Claude Code ti chiede anche in modalità `auto`. Nelle modalità che chiedono, un hook [`PermissionRequest`](/docs/it/hooks#permissionrequest) può rispondere al prompt come risponde a qualsiasi altro.688Nelle modalità `auto` e `bypassPermissions`, il prompt del terminale mostra un conto alla rovescia di due minuti:

689

690* Se il conto alla rovescia scade prima che tu rispondi, Claude Code nega il comando e dice a Claude cosa fare invece, in modo che una sessione incustodita continui a funzionare.

691* Premi un tasto qualsiasi mentre il prompt è aperto per fermare il conto alla rovescia e mantenere il prompt in attesa della tua risposta.

692* Dopo tre di questi prompt scaduti senza risposta in una sessione, Claude Code smette di mostrarli e nega ulteriori rimozioni di percorsi critici immediatamente. L'invio di un nuovo messaggio ricomincia il conteggio.

693

694In modalità `auto`, ovunque Claude Code non possa mostrarti un prompt del terminale, nega il comando immediatamente, ad esempio in [esecuzioni non interattive](/docs/it/headless) con `-p`, in sessioni [Agent SDK](/docs/it/agent-sdk/permissions), e nel pannello chat dell'estensione VS Code e nell'app Desktop. La negazione dice a Claude di segnalare cosa voleva eliminare e lasciare la rimozione a te.

672 695

673Claude Code tratta un target `rm` o `rmdir` come un percorso critico quando è uno dei seguenti:696Claude Code tratta un target `rm` o `rmdir` come un percorso critico quando è uno dei seguenti:

674 697

686* Per una variabile come `$DIR`, proteggi ogni espansione in modo che la shell si fermi con un errore quando la variabile non è impostata o è vuota, come in `rm -rf "${DIR:?}"/*`, oppure usa un percorso letterale709* Per una variabile come `$DIR`, proteggi ogni espansione in modo che la shell si fermi con un errore quando la variabile non è impostata o è vuota, come in `rm -rf "${DIR:?}"/*`, oppure usa un percorso letterale

687* Per una variabile che è normalmente impostata, come `$HOME`, usa un percorso letterale710* Per una variabile che è normalmente impostata, come `$HOME`, usa un percorso letterale

688 711

689Una rimozione le cui espansioni sono tutte protette in questo modo non è una rimozione di percorso critico, quindi in modalità `bypassPermissions` viene eseguita senza un prompt.712Una rimozione le cui espansioni sono tutte protette in questo modo passa questo controllo, quindi in modalità `bypassPermissions` viene eseguita senza un prompt a meno che un altro controllo in questa sezione non la contrassegni.

713

714Claude Code tratta anche questi target come percorsi critici:

715

716* **Una variabile shell seguita da un nome di directory di primo livello**, come `rm -rf "$TMPDIR/mnt"`: quando la variabile si espande vuota, il comando rimuove `/mnt`. Questo copre nomi di primo livello comuni come `mnt`, `tmp`, `usr`, e `Users`.

717* **Una variabile che lo stesso comando assegna da una sostituzione di stampa di directory**, come `D=$(pwd); rm -rf "$D"` o un'assegnazione da `$(git rev-parse --show-toplevel)`: il valore può nominare la tua directory di lavoro o la radice del repository. Una protezione `"${D:?}"` non cancella questo controllo, perché la variabile non è vuota; usa un percorso letterale invece.

718* **Un target solo backslash**, come `rm -rf "\\"`: Git Bash su Windows legge un singolo backslash come la radice dell'unità corrente, quindi il controllo si applica su ogni piattaforma.

719* **Solo l'output di una sostituzione di comando**, come `rm -rf "$(pwd)"`, quando `rm` è ricorsivo: Claude Code non può controllare il target prima che il comando venga eseguito, quindi il prompt dice a Claude di eseguire la sostituzione da sola per prima e poi rimuovere i percorsi letterali che stampa. Per disattivare questo controllo, imposta [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/it/env-vars#variables) nell'ambiente che avvia Claude Code.

720

721Quando una sostituzione di comando finale può espandersi vuota, come in `rm -rf ~/$(cmd)`, Claude Code controlla il percorso che rimarrebbe, la tua directory home in questo esempio.

690 722

691Nascondere la rimozione dentro una subshell con `(...)`, un gruppo di parentesi graffe con `{ ...; }`, la sostituzione di comando con `$(...)` o backtick, o la sostituzione di processo con `<(...)`, non salta il controllo. Claude Code trova una rimozione di percorso critico indipendentemente dal fatto che si trovi dentro la forma annidata, come in `(rm -rf ~)` o `echo "$(rm -rf ~)"`, o altrove nello stesso comando.723Nascondere la rimozione dentro una subshell con `(...)`, un gruppo di parentesi graffe con `{ ...; }`, la sostituzione di comando con `$(...)` o backtick, o la sostituzione di processo con `<(...)`, non salta il controllo. Claude Code trova una rimozione di percorso critico indipendentemente dal fatto che si trovi dentro la forma annidata, come in `(rm -rf ~)` o `echo "$(rm -rf ~)"`, o altrove nello stesso comando.

692 724

694 Remove-Item in PowerShell726 Remove-Item in PowerShell

695</h3>727</h3>

696 728

697Quando abiliti lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool), Claude Code dà a `Remove-Item` il suo proprio controllo, separato dall'elenco di percorsi critici `rm`. Il risultato dipende dal target, e il primo caso corrispondente si applica:729Quando abiliti lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool), Claude Code dà a `Remove-Item` e ai built-in `cmd` `rd`, `rmdir`, `del`, e `erase` i loro propri controlli, separati dall'elenco di percorsi critici `rm`. Per `Remove-Item`, il risultato dipende dal target, e il primo caso corrispondente si applica:

698 730

699* **Percorsi di sistema**: la radice del filesystem e le sue directory di primo livello, le radici di unità e le loro directory di primo livello, e la tua directory home. Claude Code nega il comando in ogni modalità, senza chiederti.731* **Percorsi di sistema**: la radice del filesystem e le sue directory di primo livello, le radici di unità e le loro directory di primo livello, e la tua directory home. Claude Code nega il comando in ogni modalità, senza chiederti.

700* **Wildcard**: un `*` nudo, o qualsiasi target che termina in `/*` o `\*`, incluso un glob sotto una variabile shell come `$dir/*`. Claude Code nega il comando in ogni modalità, senza chiederti, prima che il [classificatore](#eliminate-prompts-with-auto-mode) lo veda.732* **Wildcard**: un `*` nudo, o qualsiasi target che termina in `/*` o `\*`, incluso un glob sotto una variabile shell come `$dir/*`. Claude Code nega il comando in ogni modalità, senza chiederti, prima che il [classificatore](#eliminate-prompts-with-auto-mode) lo veda.

701* **La tua directory di lavoro o uno dei suoi genitori, con `-Recurse`**: Claude Code tratta il comando come qualsiasi altro che necessita di approvazione nella tua modalità di autorizzazione, quindi ti chiede nelle modalità che chiedono, lo invia al classificatore in modalità `auto`, e lo nega in modalità `dontAsk`. La modalità `bypassPermissions` salta questo controllo.733* **La tua directory di lavoro o uno dei suoi genitori, con `-Recurse`**: Claude Code tratta il comando come qualsiasi altro che necessita di approvazione nella tua modalità di autorizzazione, quindi ti chiede nelle modalità che chiedono, lo invia al classificatore in modalità `auto`, e lo nega in modalità `dontAsk`. La modalità `bypassPermissions` salta questo controllo.

702 734

735Il caso dei percorsi di sistema si applica anche a `rd`, `rmdir`, `del`, e `erase` quando Claude li esegue attraverso `cmd`, come in `cmd /c rd /s /q C:\Users`. Per impostazione predefinita, Claude Code nega tale comando in ogni modalità, senza chiederti. Questo controllo `cmd` richiede Claude Code v2.1.283 o successivo.

736

737Nel giudicare un target `cmd`, Claude Code tratta una variabile PowerShell che segue testo letterale come vuota. Questo rende `cmd /c rd /s /q "C:\$name"` una rimozione di `C:\`, quindi viene negata anche. Un wildcard finale conta come la cartella che svuota, quindi `cmd /c del /q C:\*` viene negato e `cmd /c del /q dist\*` nel tuo progetto non lo è.

738

739Per disattivare il controllo `cmd`, imposta [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY=1`](/docs/it/env-vars#variables) nell'ambiente che avvia Claude Code. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. `Remove-Item` su un percorso di sistema rimane negato comunque.

740

703<h2 id="see-also">741<h2 id="see-also">

704 Vedi anche742 Vedi anche

705</h2>743</h2>

permissions.md +34 −5

Details

457* Claude Code legge un modello `!` relativo alla directory corrente anche quando `/`, `~/` o `//` segue il `!`, quindi il modello non può raggiungere una regola ancorata con uno di questi prefissi. `Read(!~/notes/public/**)` non scava nulla da `Read(~/notes/**)`.457* Claude Code legge un modello `!` relativo alla directory corrente anche quando `/`, `~/` o `//` segue il `!`, quindi il modello non può raggiungere una regola ancorata con uno di questi prefissi. `Read(!~/notes/public/**)` non scava nulla da `Read(~/notes/**)`.

458* Uno scavo non può riaprire un file all'interno di una directory che una regola blocca nel complesso. Con `Read(secrets/**)` e `Read(!secrets/public/**)`, Claude Code blocca comunque `secrets/public` insieme al resto di `secrets`.458* Uno scavo non può riaprire un file all'interno di una directory che una regola blocca nel complesso. Con `Read(secrets/**)` e `Read(!secrets/public/**)`, Claude Code blocca comunque `secrets/public` insieme al resto di `secrets`.

459 459

460Quando Claude accede a un symlink, le regole di autorizzazione controllano due percorsi: il symlink stesso e il file a cui si risolve. Le regole allow e deny trattano quella coppia diversamente: le regole allow ricadono nel richiedere un prompt, mentre le regole deny bloccano completamente.460<h4 id="symlinks">

461 Symlink

462</h4>

461 463

462* **Regole allow**: si applicano solo quando sia il percorso del symlink che il suo target corrispondono. Un symlink all'interno di una directory consentita che punta al di fuori di essa richiede comunque un prompt.464Quando un percorso di file che Claude richiede passa attraverso un symlink, il controllo di autorizzazione copre due percorsi: quello che Claude ha richiesto e il file a cui si risolve. Questo si applica ai link simbolici su macOS, Linux e Windows, e alle giunzioni di directory su Windows.

463* **Regole deny**: si applicano quando il percorso del symlink o il suo target corrisponde. Un symlink che punta a un file negato è esso stesso negato. Ad esempio, con `Read(./project/**)` consentito e `Read(~/.ssh/**)` negato, un symlink in `./project/key` che punta a `~/.ssh/id_rsa` viene bloccato: il target non supera la regola allow e corrisponde alla regola deny.

464 465

465Su macOS e Linux, una regola deny o ask scritta attraverso una directory con symlink con un modello `//`, `~/` o `/` si applica anche alla posizione reale della directory. Ad esempio, su macOS, dove `/etc` si risolve a `/private/etc`, `Read(//etc/**)` blocca anche `/private/etc/hosts`. Prima della v2.1.268, una regola deny o ask scritta attraverso una directory con symlink non si applicava a un percorso dato dalla sua posizione reale.466<h5 id="how-rules-match-a-symlinked-path">

467 Come le regole corrispondono a un percorso con symlink

468</h5>

466 469

467Quando uno strumento apre un file approvato, Claude Code [conferma che il percorso si risolve ancora alla posizione che il controllo di autorizzazione ha approvato](/docs/it/errors#refusing-after-a-symlink-changed).470Le regole allow e deny trattano il percorso richiesto e il file a cui si risolve diversamente:

471

472* **Regole allow**: si applicano solo quando sia il percorso richiesto che il file a cui si risolve corrispondono. Una lettura attraverso un symlink all'interno di una directory consentita che punta al di fuori di essa non corrisponde alla regola.

473* **Regole deny**: si applicano quando il percorso richiesto o il file a cui si risolve corrisponde. Un symlink che punta a un file negato è esso stesso negato. Ad esempio, con `Read(./project/**)` consentito e `Read(~/.ssh/**)` negato, un symlink in `./project/key` che punta a `~/.ssh/id_rsa` viene bloccato: il target non supera la regola allow e corrisponde alla regola deny.

474

475Su macOS e Linux, una regola deny o ask scritta attraverso una directory con symlink con un modello `//`, `~/` o `/` si applica anche alla posizione reale della directory. Ad esempio, su macOS, dove `/etc` si risolve a `/private/etc`, `Read(//etc/**)` blocca anche `/private/etc/hosts`. Prima della v2.1.268, una regola deny o ask scritta attraverso una directory con symlink non si applicava a un percorso dato dalla sua posizione reale.

468 476

469Grep e Glob cercano la directory a cui l'argomento `path` si risolve. Claude Code applica le regole deny `Read` a quella directory.477Grep e Glob cercano la directory a cui l'argomento `path` si risolve. Claude Code applica le regole deny `Read` a quella directory.

470 478

479<h5 id="writes-through-a-symlink">

480 Scritture attraverso un symlink

481</h5>

482

483Se il percorso che Claude chiede di modificare o scrivere è esso stesso un symlink, gli strumenti Edit e Write [rifiutano la scrittura e indirizzano Claude al target del link](/docs/it/errors#refusing-after-a-symlink-changed).

484

485Una scrittura può comunque passare attraverso un symlink quando una directory sulla strada verso il file è un symlink, o quando un comando Bash o PowerShell fa la scrittura. Per quelle scritture, quello che succede dipende da dove il file a cui la scrittura si risolve si trova rispetto alle vostre [directory di lavoro](#working-directories) e ai [percorsi protetti](/docs/it/permission-modes#protected-paths):

486

487* **Si risolve al di fuori delle directory di lavoro**: quando il percorso richiesto è all'interno delle vostre directory di lavoro e il file a cui si risolve non lo è, la scrittura non viene auto-approvata in modalità [`acceptEdits`](/docs/it/permission-modes#auto-approve-file-edits-with-acceptedits-mode). In [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), a meno che una regola allow non approvi la scrittura, vi viene chiesto un prompt invece che il classificatore decida. Il prompt nomina il percorso a cui la scrittura si risolve.

488* **Si risolve a un percorso protetto che il percorso richiesto non nomina**: la [tabella dei percorsi protetti](/docs/it/permission-modes#protected-paths) fornisce il risultato per ogni modalità di autorizzazione, tranne che dove la tabella instrada la scrittura al classificatore, questa scrittura vi chiede un prompt invece.

489

490<h5 id="paths-that-can’t-be-resolved-or-that-change">

491 Percorsi che non possono essere risolti o che cambiano

492</h5>

493

494Quando Claude Code non riesce a determinare dove un percorso conduce su disco, ad esempio perché i symlink su di esso formano un ciclo, gli strumenti Read, Edit e Write [rifiutano l'operazione](/docs/it/errors#refusing-after-a-symlink-changed).

495

496Quando uno strumento quindi apre il file approvato, [conferma che il percorso si risolve ancora alla posizione che il controllo di autorizzazione ha approvato](/docs/it/errors#refusing-after-a-symlink-changed).

497

471<h3 id="webfetch">498<h3 id="webfetch">

472 WebFetch499 WebFetch

473</h3>500</h3>

705 732

706Claude Code mostra la finestra di dialogo di trust solo in sessioni interattive. Un'esecuzione `claude -p` o una sessione SDK non la mostra mai, e fidarsi di una cartella genitore non conta per queste regole, quindi [Cosa viene eseguito prima di fidarsi di una cartella](#what-runs-before-you-trust-a-folder) dice quale contenuto del repository Claude Code utilizza ancora in ognuna di quelle due situazioni.733Claude Code mostra la finestra di dialogo di trust solo in sessioni interattive. Un'esecuzione `claude -p` o una sessione SDK non la mostra mai, e fidarsi di una cartella genitore non conta per queste regole, quindi [Cosa viene eseguito prima di fidarsi di una cartella](#what-runs-before-you-trust-a-folder) dice quale contenuto del repository Claude Code utilizza ancora in ognuna di quelle due situazioni.

707 734

735Prima di avviare o riavviare una [sessione in background](/docs/it/agent-view), Claude Code controlla anche il trust dell'area di lavoro per la directory in cui viene eseguita la sessione. Se eseguite `claude --bg` da un terminale in una directory che non avete fidata, la finestra di dialogo di trust appare prima e la sessione si avvia una volta che l'accettate. Dove nessuna finestra di dialogo può apparire, come in uno script, il comando esce invece con un errore [`Workspace not trusted`](/docs/it/errors#workspace-not-trusted-when-dispatching-a-background-session).

736

708<h3 id="when-your-local-settings-file-needs-trust">737<h3 id="when-your-local-settings-file-needs-trust">

709 Quando il vostro file di impostazioni locali ha bisogno di trust738 Quando il vostro file di impostazioni locali ha bisogno di trust

710</h3>739</h3>

platforms.md +1 −1

Details

54| :- | :- | :- | :- | :- |54| :- | :- | :- | :- | :- |

56| [Remote Control](/docs/it/remote-control) | Guida una sessione in esecuzione da [claude.ai/code](https://claude.ai/code) o dall'app mobile Claude | La tua macchina (CLI o VS Code) | Esegui `claude remote-control` | Guidare il lavoro in corso da un altro dispositivo |56| [Remote Control](/docs/it/remote-control) | Guida una sessione in esecuzione da [claude.ai/code](https://claude.ai/code) o dall'app mobile Claude | La tua macchina (CLI, Desktop, o VS Code) | Esegui [`claude remote-control` o `/remote-control`](/docs/it/remote-control#start-a-remote-control-session) | Guidare il lavoro in corso da un altro dispositivo |

57| [Channels](/docs/it/channels) | Invia eventi da un'app di chat come Telegram o Discord, o dal tuo server | La tua macchina (CLI) | [Installa un plugin channel](/docs/it/channels#quickstart) o [crea il tuo](/docs/it/channels-reference) | Reagire a eventi esterni come errori CI o messaggi di chat |57| [Channels](/docs/it/channels) | Invia eventi da un'app di chat come Telegram o Discord, o dal tuo server | La tua macchina (CLI) | [Installa un plugin channel](/docs/it/channels#quickstart) o [crea il tuo](/docs/it/channels-reference) | Reagire a eventi esterni come errori CI o messaggi di chat |

58| [Slack](/docs/it/slack) | Menziona `@Claude` in un canale del team | Cloud Anthropic | [Installa l'app Slack](/docs/it/slack#setting-up-claude-code-in-slack) con [Claude Code sul web](/docs/it/claude-code-on-the-web) abilitato | PR e revisioni dalla chat del team |58| [Slack](/docs/it/slack) | Menziona `@Claude` in un canale del team | Cloud Anthropic | [Installa l'app Slack](/docs/it/slack#setting-up-claude-code-in-slack) con [Claude Code sul web](/docs/it/claude-code-on-the-web) abilitato | PR e revisioni dalla chat del team |

59| [Self-hosted environments](/docs/it/self-hosted-environments) | Avvia una [sessione cloud](/docs/it/claude-code-on-the-web) e scegli l'ambiente della tua organizzazione | L'infrastruttura della tua organizzazione | [Distribuisci runner](/docs/it/self-hosted-environments-quickstart), su piani Team e Enterprise | Sessioni cloud che devono essere eseguite all'interno della tua rete |59| [Self-hosted environments](/docs/it/self-hosted-environments) | Avvia una [sessione cloud](/docs/it/claude-code-on-the-web) e scegli l'ambiente della tua organizzazione | L'infrastruttura della tua organizzazione | [Distribuisci runner](/docs/it/self-hosted-environments-quickstart), su piani Team e Enterprise | Sessioni cloud che devono essere eseguite all'interno della tua rete |

plugin-evals.md +20 −3

Details

16* Rilevare regressioni quando modifichi il plugin o viene rilasciato un nuovo modello16* Rilevare regressioni quando modifichi il plugin o viene rilasciato un nuovo modello

17* Vedere quale contributo apporta il plugin rispetto a nessun plugin17* Vedere quale contributo apporta il plugin rispetto a nessun plugin

18 18

19Questa pagina è per gli autori di plugin e skill che hanno un plugin funzionante e desiderano testarne il comportamento, e per i team che bloccano i cambiamenti dei plugin nella CI. Il suo formato di caso è separato dal file `evals/evals.json` che il [plugin skill-creator](/docs/it/skills#run-evals-with-skill-creator) utilizza. Per creare un plugin, vedi [Creare un plugin](/docs/it/plugins/create); per controllare i file di un plugin per errori di sintassi e schema piuttosto che il suo comportamento, usa [`claude plugin validate`](/docs/it/plugins/cli-reference#plugin-validate).19Questa pagina è per gli autori di plugin e skill che hanno un plugin funzionante e desiderano testarne il comportamento, e per i team che bloccano i cambiamenti dei plugin nella CI. Per iterare su una singola skill all'interno di una conversazione Claude Code, il [plugin skill-creator](/docs/it/skills#run-evals-with-skill-creator) esegue un confronto simile con il suo proprio formato `evals/evals.json`, e nessuno dei due strumenti legge i file di caso dell'altro. Per creare un plugin, vedi [Creare un plugin](/docs/it/plugins/create); per controllare i file di un plugin per errori di sintassi e schema piuttosto che il suo comportamento, usa [`claude plugin validate`](/docs/it/plugins/cli-reference#plugin-validate).

20 20

21<Note>21<Note>

22 Ogni esecuzione di eval e ogni valutatore giudice è una vera chiamata al modello sul tuo account, conteggiata rispetto all'utilizzo del tuo piano o alla tua fattura API, quindi controlla prima i [requisiti](#requirements). Quindi [crea la tua prima suite di eval](#create-your-first-eval-suite), oppure vai a [Eseguire evals nella CI](#run-evals-in-ci) se ne hai già una.22 Ogni esecuzione di eval e ogni valutatore giudice è una vera chiamata al modello sul tuo account, conteggiata rispetto all'utilizzo del tuo piano o alla tua fattura API, quindi controlla prima i [requisiti](#requirements). Quindi [crea la tua prima suite di eval](#create-your-first-eval-suite), oppure vai a [Eseguire evals nella CI](#run-evals-in-ci) se ne hai già una.

29Per eseguire plugin evals hai bisogno di:29Per eseguire plugin evals hai bisogno di:

30 30

31* Claude Code v2.1.269 o successivo. Esegui `claude --version` per controllare e `claude update` per aggiornare.31* Claude Code v2.1.269 o successivo. Esegui `claude --version` per controllare e `claude update` per aggiornare.

32* Git 2.31 o successivo, se git è installato. Esegui `git --version` per controllare. Con una versione più vecchia di git, `claude plugin eval` [si ferma prima di eseguire qualsiasi caso](#git-is-too-old-for-claude-plugin-eval). Senza git, viene eseguito normalmente.

32* Una directory di plugin con un manifesto `plugin.json` o `.claude-plugin/plugin.json`, o un [plugin skills-directory](/docs/it/plugins/loading#plugins-shared-through-a-repository).33* Una directory di plugin con un manifesto `plugin.json` o `.claude-plugin/plugin.json`, o un [plugin skills-directory](/docs/it/plugins/loading#plugins-shared-through-a-repository).

33* La stessa autenticazione e provider di modello che le tue normali sessioni Claude Code utilizzano. Le esecuzioni di eval, i grader valutati da judge, e `claude plugin eval init` chiamano il modello con le tue credenziali, quindi contano rispetto ai tuoi limiti di utilizzo del piano o alla tua fattura API. Quando il comando riporta un costo, la cifra è una [stima del prezzo di listino](/docs/it/costs) di quelle chiamate.34* La stessa autenticazione e provider di modello che le tue normali sessioni Claude Code utilizzano. Le esecuzioni di eval, i grader valutati da judge, e `claude plugin eval init` chiamano il modello con le tue credenziali, quindi contano rispetto ai tuoi limiti di utilizzo del piano o alla tua fattura API. Quando il comando riporta un costo, la cifra è una [stima del prezzo di listino](/docs/it/costs) di quelle chiamate.

34 35

361| `name@skills-dir` | Lo stesso, per un [plugin skills-directory](/docs/it/plugins/loading#plugins-shared-through-a-repository) |362| `name@skills-dir` | Lo stesso, per un [plugin skills-directory](/docs/it/plugins/loading#plugins-shared-through-a-repository) |

362| Omesso | La directory corrente come percorso |363| Omesso | La directory corrente come percorso |

363 364

364Aggiungi `--case <glob>` per filtrare per nome di caso e `--tag <tag>` per mantenere i casi con uno qualsiasi dei tag dati. Metti il target prima di `--tag`, `--allow-tools`, e `--json`. I primi due prendono un elenco e `--json` prende un percorso opzionale, quindi ognuno di loro legge un target che segue come il suo valore proprio.365Aggiungi `--case <glob>` per filtrare per nome di caso e `--tag <tag>` per mantenere i casi con uno qualsiasi dei tag dati.

366

367Metti il target prima di `--tag`, `--allow-tools`, e `--json`. I primi due prendono un elenco e `--json` prende un percorso opzionale, quindi ognuno di loro legge un target che segue come il suo valore proprio.

365 368

366<h3 id="grant-tools">369<h3 id="grant-tools">

367 Concedi strumenti370 Concedi strumenti

432| 130 | Interrotto. I risultati parziali sono scritti |435| 130 | Interrotto. I risultati parziali sono scritti |

433| 143 | Terminato, come da un timeout CI |436| 143 | Terminato, come da un timeout CI |

434 437

435I problemi di scrittura o pubblicazione del rapporto HTML non cambiano mai il codice di uscita.438Il delta with-minus-without è segnalato ma non cambia mai il codice di uscita, e nemmeno i problemi di scrittura o pubblicazione del rapporto HTML.

436 439

437Per vedere perché un caso ha ottenuto un punteggio basso, eseguilo localmente senza `--json` in modo che le linee di progresso per caso e per grader vengano stampate.440Per vedere perché un caso ha ottenuto un punteggio basso, eseguilo localmente senza `--json` in modo che le linee di progresso per caso e per grader vengano stampate.

438 441

678 681

679Questa è la prima esecuzione rispetto a una directory di cui Claude Code non ha ancora fiducia, e non può chiedere perché stdin o stdout non è un terminale, hai passato `--json`, o la variabile di ambiente `CI` è impostata su un valore vero come `true`. Esegui `claude plugin eval <dir>` una volta in un terminale e rispondi al prompt, o passa `--trust-plugin` se ti fidi del codice e della suite del plugin. Vedi [Cosa un'esecuzione può accedere](#security).682Questa è la prima esecuzione rispetto a una directory di cui Claude Code non ha ancora fiducia, e non può chiedere perché stdin o stdout non è un terminale, hai passato `--json`, o la variabile di ambiente `CI` è impostata su un valore vero come `true`. Esegui `claude plugin eval <dir>` una volta in un terminale e rispondi al prompt, o passa `--trust-plugin` se ti fidi del codice e della suite del plugin. Vedi [Cosa un'esecuzione può accedere](#security).

680 683

684<h3 id="git-is-too-old-for-claude-plugin-eval">

685 "is too old for claude plugin eval"

686</h3>

687

688Il `git` sul tuo `PATH` è più vecchio di 2.31, quindi `claude plugin eval` si è fermato prima di eseguire qualsiasi caso e è uscito 1 con un messaggio che nomina la tua versione:

689

690```text theme={null}

691git 2.30 is too old for claude plugin eval: it ignores the environment configuration (GIT_CONFIG_COUNT, added in git 2.31) that switches off the repository's git hooks and helper programs for the run. Install git 2.31 or newer.

692```

693

694Per ogni esecuzione, Claude Code disattiva i git hook, gli helper di credenziali e altri programmi che la configurazione git di un repository può avviare. Lo fa attraverso la configurazione dell'ambiente che git legge solo dalla versione 2.31. Un git più vecchio ignora quella configurazione, quindi la suite si ferma piuttosto che valutare le esecuzioni in cui quei programmi potrebbero essere eseguiti. Installa git 2.31 o successivo e esegui di nuovo la suite.

695

696Prima di v2.1.283, `claude plugin eval` non controllava la versione di git, e su un git più vecchio la suite veniva eseguita con quei programmi lasciati attivi.

697

681<h3 id="no-eval-cases-found">698<h3 id="no-eval-cases-found">

682 "No eval cases found"699 "No eval cases found"

683</h3>700</h3>

plugins/cli-hints.md +1 −1

Details

132 Passaggi successivi132 Passaggi successivi

133</h2>133</h2>

134 134

135* [Pubblica e distribuisci un plugin](/docs/it/plugins/publish): i percorsi in ogni marketplace, incluso il marketplace ufficiale, che l'hint richiede135* [Pubblica e distribuisci un plugin](/docs/it/plugins/publish): i percorsi per distribuire un plugin, incluso il marketplace ufficiale, che l'hint richiede

136* [Riferimento dei comandi dei plugin](/docs/it/plugins/cli-reference#plugin-install): il comando shell che installa lo stesso plugin al di fuori di una sessione136* [Riferimento dei comandi dei plugin](/docs/it/plugins/cli-reference#plugin-install): il comando shell che installa lo stesso plugin al di fuori di una sessione

plugins/cli-reference.md +19 −1

Details

163 163

164Claude Code stampa `Successfully uninstalled plugin: formatter (scope: project)`. Quando il plugin non è installato a quell'ambito, il comando stampa una riga che inizia con `Failed to uninstall plugin "formatter@my-marketplace":` ed esce con `1`.164Claude Code stampa `Successfully uninstalled plugin: formatter (scope: project)`. Quando il plugin non è installato a quell'ambito, il comando stampa una riga che inizia con `Failed to uninstall plugin "formatter@my-marketplace":` ed esce con `1`.

165 165

166Se la riga di errore continua con `"formatter" was not uninstalled:`, Claude Code non ha potuto confermare che le impostazioni dell'ambito non attivano più il plugin, quindi il plugin rimane installato con tutto ciò che ha salvato. Con `--json`, il risultato porta `failureCode: "settings_still_on"`. Questo controllo delle impostazioni richiede Claude Code v2.1.282 o successivo.

167

168<h4 id="what-an-uninstall-deletes-and-keeps">

169 Cosa un'disinstallazione elimina e conserva

170</h4>

171

172Quando disinstalli un plugin dall'ultimo ambito in cui è installato, Claude Code elimina anche le [opzioni e i segreti](/docs/it/plugins/manifest-reference#user-configuration) memorizzati del plugin e la sua directory di dati, `~/.claude/plugins/data/<id>/`. Ci sono tre eccezioni:

173

174* Con `--keep-data`, la directory di dati rimane

175* Quando un altro plugin installato usa la stessa cartella, come uno il cui ID differisce da questo solo per maiuscole/minuscole, la directory di dati rimane

176* Quando Claude Code non può leggere l'elenco dei plugin installati dopo che rimuove il plugin da quell'ambito, le opzioni, i segreti e la directory di dati rimangono tutti, perché il plugin potrebbe essere ancora installato a un altro ambito. La disinstallazione ha comunque successo. Il messaggio elenca cosa è rimasto e come eliminarlo, e con `--json` il risultato porta `savedKept: "install_records_unreadable"`

177

178Con `--json`, `keptData` riporta se la directory è rimasta, e `/plugin` mostra `· data preserved` quando lo ha fatto. Per una directory che rimane senza `--keep-data`, questo rapporto richiede Claude Code v2.1.281 o successivo. Il campo `savedKept` richiede Claude Code v2.1.282 o successivo.

179

166<h3 id="plugin-enable">180<h3 id="plugin-enable">

167 plugin enable181 plugin enable

168</h3>182</h3>

246 260

247| Flag | Descrizione |261| Flag | Descrizione |

248| :- | :- |262| :- | :- |

249| `-s, --scope <scope>` | Ambito da aggiornare: `user`, `project`, `local` o `managed`. Predefinito all'ambito in cui il plugin è installato |263| `-s, --scope <scope>` | Ambito da aggiornare: `user`, `project`, `local` o `managed`. Auto-rilevato quando omesso |

250| `-y, --yes` | Accetta un comando di installazione modificato da un plugin [command-source](/docs/it/plugins/host-marketplace), senza il prompt. Richiesto quando stdin o stdout non è un TTY, a meno che non passi `--accept-command`. Richiede Claude Code v2.1.229 o successivo |264| `-y, --yes` | Accetta un comando di installazione modificato da un plugin [command-source](/docs/it/plugins/host-marketplace), senza il prompt. Richiesto quando stdin o stdout non è un TTY, a meno che non passi `--accept-command`. Richiede Claude Code v2.1.229 o successivo |

251| `--accept-command <sha256>` | Accetta il comando dichiarato dal marketplace il cui `sha256` un'esecuzione precedente [`--json`](#plugin-json-result) ha riportato in `shownCommand`, al posto di `-y`. Non può essere combinato con `-y`. Richiede Claude Code v2.1.271 o successivo |265| `--accept-command <sha256>` | Accetta il comando dichiarato dal marketplace il cui `sha256` un'esecuzione precedente [`--json`](#plugin-json-result) ha riportato in `shownCommand`, al posto di `-y`. Non può essere combinato con `-y`. Richiede Claude Code v2.1.271 o successivo |

252| `--json` | Stampa il risultato come un oggetto JSON sull'ultima riga di stdout, nello [stesso formato di `plugin install --json`](#plugin-json-result). Richiede Claude Code v2.1.268 o successivo |266| `--json` | Stampa il risultato come un oggetto JSON sull'ultima riga di stdout, nello [stesso formato di `plugin install --json`](#plugin-json-result). Richiede Claude Code v2.1.268 o successivo |

253 267

268Se ometti `--scope`, il comando aggiorna il plugin all'ambito più specifico in cui è installato per il tuo progetto corrente, controllando local, project, user, quindi managed.

269

270Prima della v2.1.281, il comando usava `user` quando omettevi `--scope`, quindi aggiornare un plugin installato solo all'ambito project o local falliva con `Plugin "<name>" is not installed at scope user`. Su quelle versioni, passa `--scope`.

271

254`managed` è l'unico ambito che puoi aggiornare ma non installare. Per i plugin installati dall'amministratore, vedi [Gestisci i plugin per la tua organizzazione](/docs/it/plugins/org).272`managed` è l'unico ambito che puoi aggiornare ma non installare. Per i plugin installati dall'amministratore, vedi [Gestisci i plugin per la tua organizzazione](/docs/it/plugins/org).

255 273

256Aggiorna un plugin:274Aggiorna un plugin:

plugins/components.md +4 −4

Details

413 413

414 * **Costruire il primo plugin**: iniziare con [Crea un plugin](/docs/it/plugins/create)414 * **Costruire il primo plugin**: iniziare con [Crea un plugin](/docs/it/plugins/create)

415 * **Installare il plugin di qualcun altro**: vedere [Installa plugin](/docs/it/plugins/install)415 * **Installare il plugin di qualcun altro**: vedere [Installa plugin](/docs/it/plugins/install)

416 * **Gli utenti del plugin sono su claude.ai o in Cowork**: un set diverso di componenti carica lì. Vedere [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview)416 * **Gli utenti del plugin sono su claude.ai o in Cowork**: un set diverso di componenti carica lì. Vedere [Struttura del plugin e test](https://claude.com/docs/plugins/build) e la [tabella di supporto dei componenti](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)

417</Note>417</Note>

418 418

419<h2 id="explore-the-plugin-directory">419<h2 id="explore-the-plugin-directory">

436 436

437<PluginExplorer>437<PluginExplorer>

438 <Piece id="manifest">438 <Piece id="manifest">

439 Il [manifest](/docs/it/plugins/manifest-reference) è il file `plugin.json` nella directory `.claude-plugin/` di un plugin. Contiene i metadati del plugin e i valori `userConfig` che Claude Code richiede all'utente. Solo `name` è obbligatorio. In questo, `description` è il testo che gli utenti vedono per il plugin in `/plugin`, e `version` mantiene gli utenti su quella versione finché non la modifichi:439 Il [manifest](/docs/it/plugins/manifest-reference) è il file `plugin.json` nella directory `.claude-plugin/` di un plugin. Contiene i metadati del plugin e i valori `userConfig` che Claude Code richiede all'utente. Claude Code carica un plugin senza uno, ma la [directory di Anthropic](/docs/it/plugins/publish#submit-to-anthropics-directory) lo richiede. All'interno del file, solo `name` è obbligatorio. In questo, `description` è il testo che gli utenti vedono per il plugin in `/plugin`, e `version` mantiene gli utenti su quella versione finché non la modifichi:

440 440

441 ```json theme={null}441 ```json theme={null}

442 {442 {

838 Raggiungi gli utenti su claude.ai e Cowork838 Raggiungi gli utenti su claude.ai e Cowork

839</h4>839</h4>

840 840

841Un server stdio locale, come il server `db` sotto [Server MCP](#mcp-servers), viene eseguito in Claude Code e in una sessione Cowork che viene eseguita sulla tua macchina nell'app Claude Desktop, ma non su claude.ai. Per raggiungerli anche lì, fai riferimento a un server remoto dal suo URL `https://`, che claude.ai e Cowork offrono all'utente come connettore.841Un server stdio locale, come il server `db` sotto [Server MCP](#mcp-servers), viene eseguito in Claude Code e in una sessione Cowork che viene eseguita sulla tua macchina nell'app Claude Desktop, ma non su claude.ai. Per raggiungerli anche lì, fai riferimento a un server remoto dal suo URL `https://`, che claude.ai e Cowork offrono all'utente come connettore, come [Bundle an MCP connector with its skill](https://claude.com/docs/plugins/build#bundle-an-mcp-connector-with-its-skill) mostra.

842 842

843<h4 id="server-names-tool-names-and-reloads">843<h4 id="server-names-tool-names-and-reloads">

844 Nomi dei server, nomi degli strumenti e ricaricamenti844 Nomi dei server, nomi degli strumenti e ricaricamenti

918 918

919Le directory `bin/` del plugin vengono dopo le voci `PATH` dell'utente, quindi un plugin non può oscurare `git`, `ls`, o un altro comando di sistema.919Le directory `bin/` del plugin vengono dopo le voci `PATH` dell'utente, quindi un plugin non può oscurare `git`, `ls`, o un altro comando di sistema.

920 920

921claude.ai e Cowork non installano un plugin che ha una directory `bin/` di livello superiore, incluso uno che [distribuisci attraverso le impostazioni dell'organizzazione claude.ai](/docs/it/plugins/host-marketplace#distribute-through-organization-settings).921claude.ai e Cowork non installano un plugin che ha una directory `bin/` di livello superiore, incluso uno che [distribuisci attraverso le impostazioni dell'organizzazione claude.ai](https://claude.com/docs/plugins/org-sync#keep-executables-out-of-the-top-level-bin-directory).

922 922

923<h3 id="default-settings">923<h3 id="default-settings">

924 Impostazioni predefinite924 Impostazioni predefinite

plugins/create.md +8 −4

Details

15 15

16 * **Installare il plugin di qualcun altro**: vedi [Installare plugin](/docs/it/plugins/install)16 * **Installare il plugin di qualcun altro**: vedi [Installare plugin](/docs/it/plugins/install)

17 * **Non sei sicuro di aver bisogno di un plugin**: vedi [Decidere se hai bisogno di un plugin](/docs/it/plugins/overview#decide-whether-you-need-a-plugin) nella panoramica17 * **Non sei sicuro di aver bisogno di un plugin**: vedi [Decidere se hai bisogno di un plugin](/docs/it/plugins/overview#decide-whether-you-need-a-plugin) nella panoramica

18 * **Gli utenti del tuo plugin sono su claude.ai o in Cowork**: la stessa cartella si installa lì con un sottoinsieme diverso di componenti. Vedi [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview)18 * **Gli utenti del tuo plugin sono su claude.ai o in Cowork**: la stessa cartella si installa lì con un sottoinsieme diverso di componenti. Vedi [Struttura del plugin e test](https://claude.com/docs/plugins/build) e la [tabella di supporto dei componenti](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)

19</Note>19</Note>

20 20

21Inizia dalla sezione che corrisponde a quello che hai già:21Inizia dalla sezione che corrisponde a quello che hai già:

132 132

133Il plugin carica solo nelle sessioni che avvii con `--plugin-dir`. Per continuare a lavorarci senza il flag, o per testare una build `.zip`, vedi [Sviluppare senza un marketplace](#develop-without-a-marketplace).133Il plugin carica solo nelle sessioni che avvii con `--plugin-dir`. Per continuare a lavorarci senza il flag, o per testare una build `.zip`, vedi [Sviluppare senza un marketplace](#develop-without-a-marketplace).

134 134

135Per avere Claude che scaffolda e controlla un plugin più grande con te, [installa](/docs/it/plugins/install#install-a-plugin) il plugin `plugin-dev` di Anthropic dal marketplace `claude-plugins-official`, che aggiunge skills e agents per scrivere componenti come skills, hooks e server MCP e per convalidare il plugin finito. Una volta installato, esegui `/plugin-dev:create-plugin` seguito da una descrizione del plugin che desideri, e Claude ti guida attraverso la progettazione, la creazione e la convalidazione.

136

135<h3 id="share-the-plugin">137<h3 id="share-the-plugin">

136 Condividere il tuo plugin138 Condividere il tuo plugin

137</h3>139</h3>

140 142

141* **Inviarlo a poche persone direttamente**: dai loro la directory del plugin o un `.zip` di esso, e niente deve essere pubblicato. Vedi [Condividere un plugin senza un marketplace](/docs/it/plugins/publish#share-a-plugin-without-a-marketplace).143* **Inviarlo a poche persone direttamente**: dai loro la directory del plugin o un `.zip` di esso, e niente deve essere pubblicato. Vedi [Condividere un plugin senza un marketplace](/docs/it/plugins/publish#share-a-plugin-without-a-marketplace).

142* **Elencarlo nel tuo marketplace**: i colleghi aggiungono il tuo marketplace una volta e installano il plugin per nome, e ricevono i tuoi aggiornamenti. Vedi [Pubblicare attraverso il tuo marketplace](/docs/it/plugins/publish#publish-through-your-own-marketplace).144* **Elencarlo nel tuo marketplace**: i colleghi aggiungono il tuo marketplace una volta e installano il plugin per nome, e ricevono i tuoi aggiornamenti. Vedi [Pubblicare attraverso il tuo marketplace](/docs/it/plugins/publish#publish-through-your-own-marketplace).

143* **Inviarlo al marketplace della comunità di Anthropic**: una volta elencato, chiunque aggiunga quel marketplace può installarlo. Vedi [Inviare al marketplace della comunità](/docs/it/plugins/publish#submit-to-the-community-marketplace).145* **Inviarlo alla directory di Anthropic**: dopo che passa la revisione, le persone possono aggiungerlo su claude.ai e in Cowork, e raggiunge Claude Code attraverso il loro account. Vedi [Inviare alla directory di Anthropic](/docs/it/plugins/publish#submit-to-anthropics-directory).

144 146

145<h3 id="plugin-layout">147<h3 id="plugin-layout">

146 Layout del plugin148 Layout del plugin

201 203

202Se la cartella non ha una directory `.claude-plugin/` e nessun componente di plugin al suo livello superiore, Claude Code la tratta come una cartella di plugin. Ogni sottocartella immediata che ha un manifest `.claude-plugin/plugin.json` quindi carica come un plugin separato. Tutto il resto nella cartella viene saltato senza un errore, inclusa una sottocartella che non ha un manifest. Se un plugin nella cartella non carica, controlla che la sua sottocartella abbia un `.claude-plugin/plugin.json`.204Se la cartella non ha una directory `.claude-plugin/` e nessun componente di plugin al suo livello superiore, Claude Code la tratta come una cartella di plugin. Ogni sottocartella immediata che ha un manifest `.claude-plugin/plugin.json` quindi carica come un plugin separato. Tutto il resto nella cartella viene saltato senza un errore, inclusa una sottocartella che non ha un manifest. Se un plugin nella cartella non carica, controlla che la sua sottocartella abbia un `.claude-plugin/plugin.json`.

203 205

206Puoi anche passare una cartella che mantiene un `.claude-plugin/marketplace.json` accanto alle sue cartelle di plugin. Finché quella directory `.claude-plugin/` non contiene `plugin.json`, le cartelle di plugin continuano a caricare. Niente viene installato o abilitato dal file marketplace, perché Claude Code non lo legge. Caricare plugin da una cartella di questo tipo richiede Claude Code v2.1.281 o successivo.

207

204In una sessione interattiva, puoi anche aggiungere e rimuovere plugin nella cartella dopo l'avvio:208In una sessione interattiva, puoi anche aggiungere e rimuovere plugin nella cartella dopo l'avvio:

205 209

206* Una sottocartella che aggiungi carica come un nuovo plugin una volta che il suo manifest esiste.210* Una sottocartella che aggiungi carica come un nuovo plugin una volta che il suo manifest esiste.

417 421

418* [Componenti del plugin](/docs/it/plugins/components): aggiungi agents, hook, server MCP, server LSP e configurazione utente al tuo plugin422* [Componenti del plugin](/docs/it/plugins/components): aggiungi agents, hook, server MCP, server LSP e configurazione utente al tuo plugin

419* [Testare plugin con evals](/docs/it/plugin-evals): scrivi casi di eval ed eseguili con `claude plugin eval` per controllare quanto affidabilmente il plugin guida il comportamento di Claude423* [Testare plugin con evals](/docs/it/plugin-evals): scrivi casi di eval ed eseguili con `claude plugin eval` per controllare quanto affidabilmente il plugin guida il comportamento di Claude

420* [Pubblicare un plugin](/docs/it/plugins/publish): versiona, mettilo in un marketplace e invialo al marketplace della comunità424* [Pubblicare un plugin](/docs/it/plugins/publish): versiona, mettilo in un marketplace e invialo per la revisione

421* [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview): la stessa cartella di plugin si installa su claude.ai e in Cowork. Alcuni componenti sono solo Claude Code425* [Struttura del plugin e test](https://claude.com/docs/plugins/build): la stessa cartella di plugin si installa su claude.ai e in Cowork. Alcuni componenti sono solo Claude Code e la [tabella di supporto dei componenti](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) elenca quali si caricano su ogni superficie

422* [Riferimento del manifest del plugin](/docs/it/plugins/manifest-reference): ogni campo `plugin.json`, regola di percorso e directory426* [Riferimento del manifest del plugin](/docs/it/plugins/manifest-reference): ogni campo `plugin.json`, regola di percorso e directory

423* [Skills](/docs/it/skills): scrivi le skills che il tuo plugin fornisce427* [Skills](/docs/it/skills): scrivi le skills che il tuo plugin fornisce

424* [Plugin di Anthropic nel repository claude-code](https://github.com/anthropics/claude-code/tree/main/plugins): esempi completi e funzionanti del layout su questa pagina, come `feature-dev` e `code-review`428* [Plugin di Anthropic nel repository claude-code](https://github.com/anthropics/claude-code/tree/main/plugins): esempi completi e funzionanti del layout su questa pagina, come `feature-dev` e `code-review`

plugins/create-marketplace.md +1 −1

Details

14 Questi casi sono coperti su altre pagine:14 Questi casi sono coperti su altre pagine:

15 15

16 * **Condividere un plugin con poche persone**: invia loro la directory del plugin o un `.zip` di essa. Vedi [Condividere un plugin senza un marketplace](/docs/it/plugins/publish#share-a-plugin-without-a-marketplace).16 * **Condividere un plugin con poche persone**: invia loro la directory del plugin o un `.zip` di essa. Vedi [Condividere un plugin senza un marketplace](/docs/it/plugins/publish#share-a-plugin-without-a-marketplace).

~~17 * **Offrire un plugin a tutti**: invialo al marketplace della comunità di Anthropic. Vedi [Inviare al marketplace della comunità](/docs/it/plugins/publish#submit-to-the-community-marketplace).~~17 * **Offrire un plugin a tutti**: invialo al marketplace della comunità di Anthropic. Vedi [Inviare al marketplace della comunità](/docs/it/plugins/publish#submit-to-anthropics-directory).

18 * **Utilizzare un plugin tu stesso**: caricalo con `--plugin-dir` o salvalo nella tua directory skills. Vedi [Sviluppare senza un marketplace](/docs/it/plugins/create#develop-without-a-marketplace).18 * **Utilizzare un plugin tu stesso**: caricalo con `--plugin-dir` o salvalo nella tua directory skills. Vedi [Sviluppare senza un marketplace](/docs/it/plugins/create#develop-without-a-marketplace).

19</Note>19</Note>

20 20

plugins/host-marketplace.md +3 −3

Details

89Organization sync è più rigoroso riguardo al repository rispetto a `/plugin marketplace add`:89Organization sync è più rigoroso riguardo al repository rispetto a `/plugin marketplace add`:

90 90

91* **Repository marketplace**: su github.com e gitlab.com, deve essere privato o interno91* **Repository marketplace**: su github.com e gitlab.com, deve essere privato o interno

92* **Plugin sources**: ogni plugin source deve essere di tipo `github`, `url`, o `git-subdir`, o un [relative path](/docs/it/plugins/marketplace-reference#relative-path-plugin-source) che inizia con `./`92* **Plugin sources**: organization sync accetta solo alcuni [source types](/docs/it/plugins/marketplace-reference#plugin-sources)

93* **Directory `bin/` di primo livello**: claude.ai rifiuta un plugin che ne ha una e sincronizza il resto del marketplace. Il messaggio di errore inizia con `Plugin contains a top-level bin/ directory`. Mantieni gli eseguibili in un'altra directory, come `scripts/`, e fai riferimento ad essi come `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` dai tuoi hooks o dalle configurazioni del server MCP93* **Directory `bin/` di primo livello**: claude.ai rifiuta un plugin che ne ha una e sincronizza il resto del marketplace. Il messaggio di errore inizia con `Plugin contains a top-level bin/ directory`. Mantieni gli eseguibili in un'altra directory, come `scripts/`, e fai riferimento ad essi come `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` dai tuoi hooks o dalle configurazioni del server MCP

94 94

~~95Vedi [Manage plugins for your organization](https://support.claude.com/en/articles/13837433) per il flusso di lavoro dell'amministratore.~~95[Sync your organization's plugins from a repository](https://claude.com/docs/plugins/org-sync) su claude.com elenca i source accettati, la configurazione di GitLab e l'errore `bin/`, e [Manage plugins for your organization](https://claude.com/docs/plugins/admin) copre il flusso di lavoro dell'amministratore.

96 96

97<h2 id="grant-access-to-a-private-marketplace">97<h2 id="grant-access-to-a-private-marketplace">

98 Grant access to a private marketplace98 Grant access to a private marketplace

113 113

114Per un host GitHub Enterprise Server, gli utenti hanno bisogno dell'accesso git a quell'host dalla loro macchina. Vedi [Plugin marketplaces on GHES](/docs/it/github-enterprise-server#plugin-marketplaces-on-ghes) per cosa serve a ogni superficie Claude Code per raggiungere un marketplace ospitato su GHES.114Per un host GitHub Enterprise Server, gli utenti hanno bisogno dell'accesso git a quell'host dalla loro macchina. Vedi [Plugin marketplaces on GHES](/docs/it/github-enterprise-server#plugin-marketplaces-on-ghes) per cosa serve a ogni superficie Claude Code per raggiungere un marketplace ospitato su GHES.

115 115

116Se distribuisci attraverso **Organization settings > Plugins & skills** su claude.ai invece, le credenziali git dei tuoi utenti non sono coinvolte. Vedi [Distribute through organization settings](#distribute-through-organization-settings) per quali plugin sources possono essere privati lì.116Se distribuisci attraverso **Organization settings > Plugins & skills** su claude.ai invece, le credenziali git dei tuoi utenti non sono coinvolte. Vedi [Distribute through organization settings](#distribute-through-organization-settings).

117 117

118<h3 id="serve-users-who-have-no-git-host-account">118<h3 id="serve-users-who-have-no-git-host-account">

119 Serve users who have no git-host account119 Serve users who have no git-host account

plugins/install.md +1 −1

Details

143L'ambito di installazione di un plugin decide chi ottiene il plugin e quale file di impostazioni lo registra come abilitato:143L'ambito di installazione di un plugin decide chi ottiene il plugin e quale file di impostazioni lo registra come abilitato:

144 144

145* **User scope**: il plugin è abilitato per te in ogni progetto su questa macchina. La voce va in `enabledPlugins` in `~/.claude/settings.json`.145* **User scope**: il plugin è abilitato per te in ogni progetto su questa macchina. La voce va in `enabledPlugins` in `~/.claude/settings.json`.

146* **Project scope**: il plugin è abilitato per tutti coloro che lavorano in questo repository. La voce va in `.claude/settings.json`, che esegui il commit.146* **Project scope**: il plugin è abilitato per tutti coloro che lavorano in questo repository. La voce va in `.claude/settings.json`, che esegui il commit. Eseguire il commit di quella voce attiva il plugin per i tuoi collaboratori ma non lo scarica sulle loro macchine, quindi ogni collaboratore esegue anche `claude plugin install <name>@<marketplace> --scope project` una volta; vedi [Enabled in project settings but not installed](/docs/it/plugins/loading#enabled-in-project-settings-but-not-installed).

147* **Local scope**: il plugin è abilitato per te solo in questo repository. La voce va in `.claude/settings.local.json`.147* **Local scope**: il plugin è abilitato per te solo in questo repository. La voce va in `.claude/settings.local.json`.

148 148

149Alcuni plugin sono impostati dal loro autore per iniziare disattivati, attraverso il campo [`defaultEnabled`](/docs/it/plugins/manifest-reference#defaultenabled). Tale plugin è installato ma rimane disattivato finché non lo attivi con `claude plugin enable <name>` nel tuo shell, o dalla scheda **Installed** di `/plugin` in una sessione.149Alcuni plugin sono impostati dal loro autore per iniziare disattivati, attraverso il campo [`defaultEnabled`](/docs/it/plugins/manifest-reference#defaultenabled). Tale plugin è installato ma rimane disattivato finché non lo attivi con `claude plugin enable <name>` nel tuo shell, o dalla scheda **Installed** di `/plugin` in una sessione.

plugins/loading.md +2 −2

Details

100 100

101Nelle sessioni di terminale, le competenze, gli agenti, gli hook, i server MCP e i server LSP di un plugin sincronizzato si caricano tutti, con la stessa fiducia di un plugin marketplace che hai installato.101Nelle sessioni di terminale, le competenze, gli agenti, gli hook, i server MCP e i server LSP di un plugin sincronizzato si caricano tutti, con la stessa fiducia di un plugin marketplace che hai installato.

102 102

103Per i componenti che Cowork carica, vedi [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview) su claude.com.103Per i componenti che Cowork carica, vedi la [tabella di supporto dei componenti](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) su claude.com.

104 104

105I plugin sincronizzati si caricano nelle sessioni Cowork e nelle sessioni di terminale dove accedi con il tuo account claude.ai:105I plugin sincronizzati si caricano nelle sessioni Cowork e nelle sessioni di terminale dove accedi con il tuo account claude.ai:

106 106

184| Percorso | Cosa contiene |184| Percorso | Cosa contiene |

185| :- | :- |185| :- | :- |

186| `cache/<marketplace>/<plugin>/<version>/` | Una directory per ogni versione installata di un plugin marketplace. `<plugin>` è il nome della voce marketplace e `<version>` è la [versione risolta](#versions-and-updates). `${CLAUDE_PLUGIN_ROOT}` punta a questa directory |186| `cache/<marketplace>/<plugin>/<version>/` | Una directory per ogni versione installata di un plugin marketplace. `<plugin>` è il nome della voce marketplace e `<version>` è la [versione risolta](#versions-and-updates). `${CLAUDE_PLUGIN_ROOT}` punta a questa directory |

187| `data/<plugin-id>/` | La directory persistente del plugin, esposta come `${CLAUDE_PLUGIN_DATA}`. Per come `<plugin-id>` è formato, vedi [Variabili di percorso e dati persistenti](/docs/it/plugins/components#path-variables-and-persistent-data). Claude Code la crea quando un componente del plugin la usa per la prima volta e la mantiene attraverso gli aggiornamenti. Claude Code la elimina quando disinstalli il plugin dal suo ultimo ambito, a meno che tu non passi `--keep-data` |187| `data/<plugin-id>/` | La directory persistente del plugin, esposta come `${CLAUDE_PLUGIN_DATA}`. Per come `<plugin-id>` è formato, vedi [Variabili di percorso e dati persistenti](/docs/it/plugins/components#path-variables-and-persistent-data). Claude Code la crea quando un componente del plugin la usa per la prima volta e la mantiene attraverso gli aggiornamenti. Per impostazione predefinita, Claude Code la elimina quando disinstalli il plugin dal suo ultimo ambito. Per `--keep-data` e gli altri casi in cui rimane, vedi [plugin uninstall](/docs/it/plugins/cli-reference#plugin-uninstall) |

188| `marketplaces/<name>/` | Il clone o il download di un marketplace aggiunto da GitHub, un altro host Git, o un URL. Un marketplace aggiunto da una fonte `file` o `directory` locale non ha una copia qui, e il suo `installLocation` in `known_marketplaces.json` è il percorso che hai fornito |188| `marketplaces/<name>/` | Il clone o il download di un marketplace aggiunto da GitHub, un altro host Git, o un URL. Un marketplace aggiunto da una fonte `file` o `directory` locale non ha una copia qui, e il suo `installLocation` in `known_marketplaces.json` è il percorso che hai fornito |

190| `.trash/` | I plugin che la sincronizzazione di claude.ai ha rimosso, come dopo che ne hai disattivato uno su claude.ai o hai smesso di sincronizzare |190| `.trash/` | I plugin che la sincronizzazione di claude.ai ha rimosso, come dopo che ne hai disattivato uno su claude.ai o hai smesso di sincronizzare |

plugins/manifest-reference.md +15 −6

Details

116* **`Validation passed with warnings`**: il manifest si carica, ma il validatore ha trovato qualcosa da correggere, come un campo di primo livello sconosciuto che Claude Code rimuove, un `name` che non è in kebab-case, o un `version`, `description`, o `author` mancante. Passate `--strict` per trasformare gli avvisi in errori in CI116* **`Validation passed with warnings`**: il manifest si carica, ma il validatore ha trovato qualcosa da correggere, come un campo di primo livello sconosciuto che Claude Code rimuove, un `name` che non è in kebab-case, o un `version`, `description`, o `author` mancante. Passate `--strict` per trasformare gli avvisi in errori in CI

117* **`Validation failed`**: il manifest ha una mancata corrispondenza di tipo, un percorso mancante o che esce dalla radice del plugin, o una chiave sconosciuta dentro un'opzione `userConfig`, una voce `channels`, una configurazione `lspServers`, o una voce `monitors`. Claude Code segnala lo stesso problema quando carica il plugin117* **`Validation failed`**: il manifest ha una mancata corrispondenza di tipo, un percorso mancante o che esce dalla radice del plugin, o una chiave sconosciuta dentro un'opzione `userConfig`, una voce `channels`, una configurazione `lspServers`, o una voce `monitors`. Claude Code segnala lo stesso problema quando carica il plugin

118 118

119Il comando controlla anche ogni voce di server MCP che il plugin dichiara in `.mcp.json`, in un file `.json` che [`mcpServers`](#mcpservers) nomina, o inline in `plugin.json`. Questi controlli MCP richiedono Claude Code v2.1.281 o successivo e includono:

120

121* **Errors**: una voce che Claude Code eliminerebbe quando carica il plugin, un riferimento `${user_config.KEY}` a un'opzione che il manifest non dichiara, e un `url` remoto che non è un URL assoluto valido

122* **Warnings**: un URL `http://` o `ws://` a un host non-loopback, e un valore di intestazione che sembra una credenziale letterale

123

119<h2 id="fields">124<h2 id="fields">

120 Fields125 Fields

121</h2>126</h2>

387 Contenimento ed esistenza392 Contenimento ed esistenza

388</h3>393</h3>

389 394

390Ogni percorso di componente deve risolversi all'interno della radice del plugin e deve esistere. `claude plugin validate` non controlla i percorsi `outputStyles`, `lspServers`, `monitors` o `themes`, quindi un percorso errato in questi campi non riesce solo quando il plugin si carica:395Ogni percorso di componente deve risolversi all'interno della radice del plugin e deve esistere. `claude plugin validate` controlla i percorsi sotto ogni chiave di componente:

391 396

392* **Contenimento**: un percorso che si risolve al di fuori della radice del plugin non si carica e la scheda **Errors** di `/plugin` mostra `<component> path escapes plugin directory: <path>`. Un percorso contenente `..` è il caso più comune e `claude plugin validate` lo segnala come `Path contains ".." which could be a path traversal attempt`397* **Contenimento**: un percorso che si risolve al di fuori della radice del plugin non si carica e la scheda **Errors** di `/plugin` mostra `<component> path escapes plugin directory: <path>`. Un percorso contenente `..` è il caso più comune e `claude plugin validate` segnala l'errore `Path contains ".." which could be a path traversal attempt`

393* **Esistenza**: un percorso che non esiste non si carica e la scheda **Errors** di `/plugin` mostra `<component> path not found: <path>`. `claude plugin validate` lo segnala come `Path not found`398* **Esistenza**: un percorso che non esiste non si carica e la scheda **Errors** di `/plugin` mostra `<component> path not found: <path>`. `claude plugin validate` segnala l'errore `Path not found`

399

400Per i percorsi `outputStyles`, `lspServers`, `monitors` e `themes`, il controllo `claude plugin validate` richiede Claude Code v2.1.283 o successivo.

394 401

395<h3 id="how-each-key-combines-with-its-default-location">402<h3 id="how-each-key-combines-with-its-default-location">

396 Come ogni chiave si combina con la sua posizione predefinita403 Come ogni chiave si combina con la sua posizione predefinita

548```555```

549 556

550<h2 id="environment-variables">557<h2 id="environment-variables">

551 Environment variables558 Variabili di ambiente

552</h2>559</h2>

553 560

554Claude Code fornisce tre variabili di percorso ai componenti del plugin. Fate loro riferimento come `${NAME}` nei campi elencati sotto [Where each variable resolves](#where-each-variable-resolves), e leggetele come variabili di ambiente nei processi che le ricevono.561Claude Code fornisce tre variabili di percorso ai componenti del plugin. Fate loro riferimento come `${NAME}` nei campi elencati sotto [Where each variable resolves](#where-each-variable-resolves), e leggetele come variabili di ambiente nei processi che le ricevono.

561 568

562`${CLAUDE_PLUGIN_ROOT}` cambia quando il plugin si aggiorna, quindi non scrivete lo stato lì. Per dove si sposta la radice e quando la directory vecchia viene pulita, vedere la [pagina di caricamento](/docs/it/plugins/loading).569`${CLAUDE_PLUGIN_ROOT}` cambia quando il plugin si aggiorna, quindi non scrivete lo stato lì. Per dove si sposta la radice e quando la directory vecchia viene pulita, vedere la [pagina di caricamento](/docs/it/plugins/loading).

563 570

564Quando disinstallate il plugin dall'ultimo posto in cui è installato, la directory `${CLAUDE_PLUGIN_DATA}` viene eliminata a meno che non passiate [`--keep-data`](/docs/it/plugins/cli-reference).571Per impostazione predefinita, Claude Code elimina la directory `${CLAUDE_PLUGIN_DATA}` quando disinstallate il plugin dall'ultimo posto in cui è installato. Per `--keep-data` e gli altri casi in cui rimane, vedere [plugin uninstall](/docs/it/plugins/cli-reference#plugin-uninstall).

565 572

566<h3 id="where-each-variable-resolves">573<h3 id="where-each-variable-resolves">

567 Where each variable resolves574 Where each variable resolves

589* **Hook commands**: usate [exec form](/docs/it/hooks#exec-form-and-shell-form) con `args` in modo che ogni percorso sia un argomento senza virgolette596* **Hook commands**: usate [exec form](/docs/it/hooks#exec-form-and-shell-form) con `args` in modo che ogni percorso sia un argomento senza virgolette

590* **Shell-form hooks and monitor commands**: avvolgete la variabile tra virgolette doppie in modo che un percorso con spazi rimanga una parola597* **Shell-form hooks and monitor commands**: avvolgete la variabile tra virgolette doppie in modo che un percorso con spazi rimanga una parola

591 598

599Se lasciate una di queste variabili fuori dalle virgolette in un comando in forma shell in un file hooks, `claude plugin validate` avvisa al riguardo a meno che l'hook non imposti [`shell`](/docs/it/hooks#command-hook-fields) su `"powershell"`.

600

592Questo hook in forma shell esegue uno script fornito con il plugin:601Questo hook in forma shell esegue uno script fornito con il plugin:

593 602

594```json theme={null}603```json theme={null}

632| Executables | `bin/` | I file qui sono sul `PATH` dello strumento Bash mentre il plugin è abilitato, quindi Claude li esegue come comandi nudi. claude.ai e Cowork non installano un plugin che ha questa directory, incluso uno che [distribuite attraverso le impostazioni dell'organizzazione claude.ai](/docs/it/plugins/host-marketplace#distribute-through-organization-settings) |641| Executables | `bin/` | I file qui sono sul `PATH` dello strumento Bash mentre il plugin è abilitato, quindi Claude li esegue come comandi nudi. claude.ai e Cowork non installano un plugin che ha questa directory, incluso uno che [distribuite attraverso le impostazioni dell'organizzazione claude.ai](https://claude.com/docs/plugins/org-sync#keep-executables-out-of-the-top-level-bin-directory) |

634 643

635Un plugin che usa ogni posizione predefinita, più una cartella `scripts/` che i suoi hook chiamano, è disposto così:644Un plugin che usa ogni posizione predefinita, più una cartella `scripts/` che i suoi hook chiamano, è disposto così:

plugins/marketplace-reference.md +3 −1

Details

47* **Nomi ufficiali del marketplace**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` e `claude-tag-plugins`. Riservati a meno che il marketplace non provenga da una [sorgente marketplace](#marketplace-sources) `github` o `git` sotto `github.com/anthropics/`.47* **Nomi ufficiali del marketplace**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` e `claude-tag-plugins`. Riservati a meno che il marketplace non provenga da una [sorgente marketplace](#marketplace-sources) `github` o `git` sotto `github.com/anthropics/`.

48* **Nomi del marketplace della comunità**: `claude-community`, `claude-plugins-community` e `healthcare`. Riservati secondo la stessa regola dei nomi ufficiali.48* **Nomi del marketplace della comunità**: `claude-community`, `claude-plugins-community` e `healthcare`. Riservati secondo la stessa regola dei nomi ufficiali.

49* **Nomi della directory dei plugin**: `anthropic-plugin-directory` e `claude-plugin-directory`. Riservati secondo la stessa regola dei nomi ufficiali.49* **Nomi della directory dei plugin**: `anthropic-plugin-directory` e `claude-plugin-directory`. Riservati secondo la stessa regola dei nomi ufficiali.

50* **Nomi che impersonano un marketplace ufficiale**: nomi come `official-claude-plugins` o `claude-plugins-v2`, e qualsiasi nome contenente un carattere non ASCII. L'errore è `Marketplace name impersonates an official Anthropic/Claude marketplace`. Un carattere di controllo o di formattazione bidirezionale in un nome segnala anche `Marketplace name cannot contain control or bidirectional-formatting characters`.50* **Nomi che impersonano un marketplace ufficiale**: nomi come `official-claude-plugins` o `claude-plugins-v2`, e qualsiasi nome contenente un carattere non ASCII. L'errore è `Marketplace name impersonates an official Anthropic/Claude marketplace`. Un carattere di controllo o di formattazione bidirezionale in un nome segnala anche `Marketplace name cannot contain control or bidirectional-formatting characters`. Un marketplace già registrato con tale nome smette di caricarsi, insieme ai suoi plugin.

51* <span id="reserved-name-spellings" />**Un'altra ortografia di un nome riservato**: un nome che differisce da un nome riservato solo per un punto finale, o per un simbolo diverso da un trattino al posto di un trattino, quindi `claude.code.plugins` conta come `claude-code-plugins`. `claude plugin validate` accetta tale nome; l'aggiunta del marketplace non riesce con [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/it/errors#marketplace-name-is-another-spelling-of-a-reserved-name), e un marketplace già registrato sotto uno smette di caricarsi. Questo controllo richiede Claude Code v2.1.280 o successivo.51* <span id="reserved-name-spellings" />**Un'altra ortografia di un nome riservato**: un nome che differisce da un nome riservato solo per un punto finale, o per un simbolo diverso da un trattino al posto di un trattino, quindi `claude.code.plugins` conta come `claude-code-plugins`. `claude plugin validate` accetta tale nome; l'aggiunta del marketplace non riesce con [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/it/errors#marketplace-name-is-another-spelling-of-a-reserved-name), e un marketplace già registrato sotto uno smette di caricarsi. Questo controllo richiede Claude Code v2.1.280 o successivo.

52* **Nomi che Claude Code utilizza per i plugin che non provengono da un marketplace**: `inline` per i plugin caricati con [`--plugin-dir`](/docs/it/cli-reference), `builtin` per i plugin integrati, `skills-dir` per i plugin caricati automaticamente da [`.claude/skills/`](/docs/it/skills) e `synced` per i plugin sincronizzati dal proprio account claude.ai. Anche `claude-plugin-test` è riservato. `skills-dir` appare anche come `{"source": "skills-dir"}` in `strictKnownMarketplaces` e `blockedMarketplaces`, descritto in [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).52* **Nomi che Claude Code utilizza per i plugin che non provengono da un marketplace**: `inline` per i plugin caricati con [`--plugin-dir`](/docs/it/cli-reference), `builtin` per i plugin integrati, `skills-dir` per i plugin caricati automaticamente da [`.claude/skills/`](/docs/it/skills) e `synced` per i plugin sincronizzati dal proprio account claude.ai. Anche `claude-plugin-test` è riservato. `skills-dir` appare anche come `{"source": "skills-dir"}` in `strictKnownMarketplaces` e `blockedMarketplaces`, descritto in [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).

53* **`npm`, `pip`, `uv`, `cargo`, `github` e `gh`**: riservati in qualsiasi maiuscola. Questo controllo richiede Claude Code v2.1.275 o successivo.53* **`npm`, `pip`, `uv`, `cargo`, `github` e `gh`**: riservati in qualsiasi maiuscola. Questo controllo richiede Claude Code v2.1.275 o successivo.

54* **Nomi che iniziano con `claudeai-`**: riservati per i marketplace ospitati su claude.ai. `claude plugin marketplace add` rifiuta qualsiasi altro marketplace che ne utilizzi uno con `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.54* **Nomi che iniziano con `claudeai-`**: riservati per i marketplace ospitati su claude.ai. `claude plugin marketplace add` rifiuta qualsiasi altro marketplace che ne utilizzi uno con `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

55 55

56Quando un marketplace registrato smette di caricarsi perché il suo nome imita uno ufficiale, `claude plugin list` e `/plugin` segnalano `Claude Code refuses the marketplace name "<name>"`. Il messaggio indica di rimuovere il marketplace. La rimozione disinstalla anche i suoi plugin e cancella i loro dati salvati. Questo messaggio di rifiuto denominato richiede Claude Code v2.1.282 o successivo.

56<h2 id="top-level-fields">58<h2 id="top-level-fields">

57 Top-level fields59 Top-level fields

58</h2>60</h2>

plugins/measure.md +2 −0

Details

96* **Sono colleghi che puoi chiedere**: il Claude Code di ogni utente mostra loro se usano ancora il plugin, in quattro posti: il pannello [`/plugin`](#not-used-recently-in-/plugin), [`/skill-doctor`](#find-skills-that-never-run), [`/doctor`](#unused-plugins-in-/doctor), e [`/usage`](#usage-share-in-/usage). Tutti e quattro sono comandi che l'utente esegue al prompt di Claude Code in una sessione sulla propria macchina.96* **Sono colleghi che puoi chiedere**: il Claude Code di ogni utente mostra loro se usano ancora il plugin, in quattro posti: il pannello [`/plugin`](#not-used-recently-in-/plugin), [`/skill-doctor`](#find-skills-that-never-run), [`/doctor`](#unused-plugins-in-/doctor), e [`/usage`](#usage-share-in-/usage). Tutti e quattro sono comandi che l'utente esegue al prompt di Claude Code in una sessione sulla propria macchina.

97* **Nessuno dei due**: non hai alcun segnale di utilizzo da Claude Code per quel plugin.97* **Nessuno dei due**: non hai alcun segnale di utilizzo da Claude Code per quel plugin.

98 98

99Per l'utilizzo di un plugin elencato nella directory di Anthropic, vedi [Track published plugin usage](https://claude.com/docs/connectors/building/after-publishing#track-published-plugin-usage) su claude.com.

100

99<h3 id="not-used-recently-in-/plugin">101<h3 id="not-used-recently-in-/plugin">

100 Non utilizzato di recente in `/plugin`102 Non utilizzato di recente in `/plugin`

101</h3>103</h3>

plugins/org.md +2 −1

Details

14 Questi casi sono coperti su altre pagine:14 Questi casi sono coperti su altre pagine:

15 15

16 * **Installare plugin per te stesso**: inizia da [Install plugins](/docs/it/plugins/install)16 * **Installare plugin per te stesso**: inizia da [Install plugins](/docs/it/plugins/install)

17 * **Controllare quali plugin i membri possono utilizzare in claude.ai e Cowork**: vedi [Manage plugins for your organization](https://support.claude.com/en/articles/13837433) nel centro assistenza17 * **Controllare quali plugin i membri possono utilizzare in claude.ai e Cowork**: vedi [Manage plugins for your organization](https://claude.com/docs/plugins/admin) su claude.com

18 * **Distribuire un plugin a claude.ai, Cowork e Claude Code insieme**: vedi [Choose a rollout route](https://claude.com/docs/plugins/org-rollout#choose-a-rollout-route) su claude.com

18 * **La pagina dei plugin nelle impostazioni di amministrazione di claude.ai**: [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory) attiva i plugin per gli account claude.ai dei membri, e questi raggiungono Claude Code come [synced plugins](/docs/it/plugins/loading#synced-plugins). Non imposta nessuna delle chiavi su questa pagina19 * **La pagina dei plugin nelle impostazioni di amministrazione di claude.ai**: [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory) attiva i plugin per gli account claude.ai dei membri, e questi raggiungono Claude Code come [synced plugins](/docs/it/plugins/loading#synced-plugins). Non imposta nessuna delle chiavi su questa pagina

19</Note>20</Note>

20 21

plugins/overview.md +6 −3

Details

9Un plugin Claude Code è una directory di skills, agenti, hooks, server MCP o altri componenti che Claude Code installa e carica come un'unica unità. La maggior parte dei plugin proviene da un marketplace, che è un catalogo che elenca i plugin e da dove recuperare ciascuno. Puoi anche caricare un plugin da una cartella che qualcuno ti fornisce, oppure [creare il tuo](/docs/it/plugins/create).9Un plugin Claude Code è una directory di skills, agenti, hooks, server MCP o altri componenti che Claude Code installa e carica come un'unica unità. La maggior parte dei plugin proviene da un marketplace, che è un catalogo che elenca i plugin e da dove recuperare ciascuno. Puoi anche caricare un plugin da una cartella che qualcuno ti fornisce, oppure [creare il tuo](/docs/it/plugins/create).

10 10

11<Note>11<Note>

~~12 Se utilizzi la chat claude.ai o Cowork e non Claude Code, consulta [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview).~~12 Inizia su claude.com se una di queste descrizioni ti riguarda:

14 * **Utilizzi la chat claude.ai o Cowork e non Claude Code**: consulta [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview)

15 * **Hai creato un server MCP e vuoi che sia nella directory di Anthropic**: consulta [Pubblica nella directory](https://claude.com/docs/directory/publish)

13</Note>16</Note>

14 17

15Per provare un plugin ora, esegui `/plugin` in una sessione di terminale Claude Code e installa uno dalla scheda **Discover**, che elenca i plugin dal marketplace ufficiale di Anthropic e da qualsiasi marketplace che hai aggiunto. Da lì:18Per provare un plugin ora, esegui `/plugin` in una sessione di terminale Claude Code e installa uno dalla scheda **Discover**, che elenca i plugin dal marketplace ufficiale di Anthropic e da qualsiasi marketplace che hai aggiunto. Da lì:

122Una sessione cloud, inclusa una nel browser su claude.ai/code, non carica i plugin nelle tue impostazioni locali. Per i passaggi di installazione nel terminale, VS Code e l'app desktop, e per ciò che una sessione cloud carica, consulta [Installa un plugin](/docs/it/plugins/install#install-a-plugin).125Una sessione cloud, inclusa una nel browser su claude.ai/code, non carica i plugin nelle tue impostazioni locali. Per i passaggi di installazione nel terminale, VS Code e l'app desktop, e per ciò che una sessione cloud carica, consulta [Installa un plugin](/docs/it/plugins/install#install-a-plugin).

123 126

124<Note>127<Note>

125 Lo stesso formato di plugin si installa anche su claude.ai e in Cowork, dove viene caricato un diverso set di componenti. Per quelle superfici, consulta [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview) su claude.com.128 Lo stesso formato di plugin si installa anche su claude.ai e in Cowork, dove viene caricato un diverso set di componenti. Per quelle superfici, consulta [Plugin su claude.ai e in Cowork](https://claude.com/docs/plugins/overview) su claude.com e la sua [tabella di supporto dei componenti](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app).

126</Note>129</Note>

127 130

128<h2 id="next-steps">131<h2 id="next-steps">

135 138

136Una volta che hai installato o costruito un plugin, queste pagine coprono cosa viene dopo:139Una volta che hai installato o costruito un plugin, queste pagine coprono cosa viene dopo:

137 140

138* **Condividi quello che hai costruito**: [Pubblica e distribuisci un plugin](/docs/it/plugins/publish)141* **Condividi quello che hai costruito**: [Pubblica e distribuisci un plugin](/docs/it/plugins/publish), attraverso il tuo marketplace o [la directory di Anthropic](/docs/it/plugins/publish#submit-to-anthropics-directory)

139* **Verifica se funziona ed è utilizzato**: [Testa i plugin con evals](/docs/it/plugin-evals) e [Misura il costo e l'utilizzo dei plugin](/docs/it/plugins/measure)142* **Verifica se funziona ed è utilizzato**: [Testa i plugin con evals](/docs/it/plugin-evals) e [Misura il costo e l'utilizzo dei plugin](/docs/it/plugins/measure)

140* **Esegui un marketplace per il tuo team**: [Crea un marketplace](/docs/it/plugins/create-marketplace), quindi [Ospita e mantieni un marketplace](/docs/it/plugins/host-marketplace)143* **Esegui un marketplace per il tuo team**: [Crea un marketplace](/docs/it/plugins/create-marketplace), quindi [Ospita e mantieni un marketplace](/docs/it/plugins/host-marketplace)

141* **Imposta la politica dei plugin per un'organizzazione**: [Gestisci i plugin per la tua organizzazione](/docs/it/plugins/org)144* **Imposta la politica dei plugin per un'organizzazione**: [Gestisci i plugin per la tua organizzazione](/docs/it/plugins/org)

plugins/publish.md +21 −18

Details

4 4

5# Pubblica e distribuisci un plugin5# Pubblica e distribuisci un plugin

6 6

7> Pubblica un plugin Claude Code attraverso il tuo marketplace personale o il marketplace della comunità di Anthropic, con una checklist di pre-rilascio e come gli utenti ricevono gli aggiornamenti.7> Pubblica un plugin Claude Code attraverso il tuo marketplace personale o la directory di Anthropic, con una checklist di pre-rilascio e come gli utenti ricevono gli aggiornamenti.

8 8

9Pubblicare un plugin Claude Code significa inserirlo in un marketplace, un catalogo JSON che elenca i plugin e dove recuperare ciascuno di essi, in modo che altre persone possano installarlo per nome e ricevere i tuoi aggiornamenti. Puoi gestire il tuo marketplace personale o inviare il tuo plugin al marketplace della comunità di Anthropic. Per condividere un plugin senza pubblicarlo, invia alle persone la directory del plugin o un `.zip` di esso da caricare da soli.9Pubblicare un plugin Claude Code significa inserirlo in un marketplace, un catalogo JSON che elenca i plugin e dove recuperare ciascuno di essi, in modo che altre persone possano installarlo per nome e ricevere i tuoi aggiornamenti. Puoi gestire il tuo marketplace personale o inviare il tuo plugin alla directory di Anthropic. Per condividere un plugin senza pubblicarlo, invia alle persone la directory del plugin o un `.zip` di esso da caricare da soli.

10 10

11Questa pagina è per l'autore di un plugin funzionante che è pronto a condividerlo.11Questa pagina è per l'autore di un plugin funzionante che è pronto a condividerlo.

12 12

29| :- | :- | :- | :- |29| :- | :- | :- | :- |

31| [Il tuo marketplace personale](#publish-through-your-own-marketplace) | Chiunque possa raggiungere il repository, che può essere uno privato che il tuo team può clonare | Un repository git o altro host con un `.claude-plugin/marketplace.json` che elenca il tuo plugin | Disattivato |31| [Il tuo marketplace personale](#publish-through-your-own-marketplace) | Chiunque possa raggiungere il repository, che può essere uno privato che il tuo team può clonare | Un repository git o altro host con un `.claude-plugin/marketplace.json` che elenca il tuo plugin | Disattivato |

32| [Marketplace della comunità di Anthropic](#submit-to-the-community-marketplace) | Chiunque aggiunga `anthropics/claude-plugins-community` | Un invio attraverso il modulo di invio della directory dei plugin | Disattivato |32| [Directory di Anthropic](#submit-to-anthropics-directory) | Persone che lo aggiungono su claude.ai o in Cowork. Si carica anche nelle loro sessioni Claude Code attraverso [sincronizzazione account](/docs/it/plugins/loading#synced-plugins) | Un repository GitHub che contiene il plugin e un piano claude.ai a pagamento da cui inviare | Sì, dopo che la versione che hai inviato è stata pubblicata |

33 33

34L'aggiornamento automatico è un'impostazione per marketplace sul lato dell'utente che recupera le nuove versioni in background.34L'aggiornamento automatico è un'impostazione per marketplace sul lato dell'utente che recupera le nuove versioni in background.

35 35

141 141

142[Installa plugin](/docs/it/plugins/install) copre i comandi lato utente, e [quando viene eseguito l'aggiornamento automatico](/docs/it/plugins/loading#when-auto-update-runs) copre i tempi.142[Installa plugin](/docs/it/plugins/install) copre i comandi lato utente, e [quando viene eseguito l'aggiornamento automatico](/docs/it/plugins/loading#when-auto-update-runs) copre i tempi.

143 143

144<h2 id="submit-to-the-community-marketplace">144<h2 id="submit-to-anthropics-directory">

145 Invia al marketplace della comunità145 Invia alla directory di Anthropic

146</h2>146</h2>

147 147

148Il marketplace della comunità di Anthropic, `claude-community`, è il marketplace pubblico che elenca i plugin inviati attraverso il modulo di invio della directory dei plugin.148La directory di Anthropic è il catalogo che le persone sfogliano su claude.ai e in Cowork per aggiungere plugin e connettori. Un'inserzione lì raggiunge le persone su claude.ai, in Cowork e in Claude Code. Invii dal portale degli sviluppatori su [claude.ai/directory/manage](https://claude.ai/directory/manage); [Prepara per la revisione](https://claude.com/docs/directory/publish#prepare-for-review) su claude.com descrive cosa accade a ogni versione prima che sia pubblicata.

149 149

150Gli utenti aggiungono il marketplace della comunità in una sessione Claude Code con `/plugin marketplace add anthropics/claude-plugins-community` e installano da esso come `@claude-community`.150L'invio richiede un piano claude.ai a pagamento. Su Pro e Max invii dal tuo account personale. Su Team e Enterprise, un Proprietario può inviare, e su Enterprise un Proprietario può anche concedere l'autorizzazione **Directory** ad altri membri attraverso un ruolo personalizzato in **Impostazioni organizzazione > Ruoli**. Vedi [Conferma che puoi inviare alla directory](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory).

151 151

152Per come il marketplace della comunità differisce dal marketplace ufficiale, vedi [Marketplace di Anthropic](/docs/it/plugins/anthropic-marketplaces).152I passaggi di invio, i controlli che ogni versione deve superare e cosa accade dopo la pubblicazione sono documentati su claude.com, perché sono gli stessi indipendentemente da quale superficie i tuoi utenti utilizzano:

153 153

154Per inviare il tuo plugin al marketplace della comunità, utilizza uno dei moduli in-app:154* [Pubblica nella directory](https://claude.com/docs/directory/publish#before-you-submit-to-the-directory): cosa puoi inviare e chi può inviarlo

155* [Invia un plugin](https://claude.com/docs/plugins/submit#submit-a-plugin): i passaggi del portale e [aggiornamento di un plugin pubblicato](https://claude.com/docs/plugins/submit#update-a-published-plugin)

156* [Checklist di pre-invio del plugin](https://claude.com/docs/plugins/pre-submission-checklist#run-the-checks-before-you-submit): i controlli da eseguire e correggere prima di inviare

157* [Sposta un invio precedente al portale degli sviluppatori](https://claude.com/docs/directory/publish#move-an-earlier-submission-to-the-developer-portal): cosa fare se hai inviato un plugin attraverso uno dei moduli di invio precedenti, prima che il portale esistesse

155 158

156* **claude.ai**: [claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)159Prima di aprire il portale, convalida localmente e controlla quali dei tuoi componenti si caricano al di fuori di Claude Code:

157* **Console**: [platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

158 160

159Il modulo claude.ai richiede un'organizzazione Team o Enterprise e l'autorizzazione Directory, che i Proprietari detengono per impostazione predefinita. Gli autori individuali che non fanno parte di un'organizzazione Team o Enterprise possono utilizzare il modulo Console.161* **Esegui `claude plugin validate ./your-plugin --strict` nel tuo shell**: sostituisci `./your-plugin` con il percorso della tua directory plugin. Il comando cattura gli errori del manifest localmente; [plugin validate](/docs/it/plugins/cli-reference#plugin-validate) elenca quali file ogni esecuzione legge. Il portale applica regole di directory aggiuntive che la CLI non controlla, quindi un'esecuzione locale pulita non garantisce una convalida del portale pulita.

162* **Controlla cosa si carica dove**: alcuni componenti del plugin sono solo Claude Code e non si caricano su claude.ai o in Cowork. La [tabella di supporto dei componenti](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) elenca ogni componente per app, così sai cosa riceveranno gli utenti al di fuori di Claude Code.

160 163

161Nel tuo shell, esegui `claude plugin validate ./your-plugin` localmente prima di inviare, sostituendo `./your-plugin` con il percorso della tua directory plugin. Quando la convalida passa, Claude Code stampa `✔ Validation passed`, o `✔ Validation passed with warnings` se ci sono avvisi. Gli avvisi non fanno fallire la convalida; aggiungi `--strict` per trattarli come errori.164Il marketplace ufficiale di Anthropic, `claude-plugins-official`, non accetta invii attraverso il portale della directory. Se lavori con un contatto partner di Anthropic, chiedi loro informazioni su un'inserzione nel marketplace ufficiale.

162 165

163I plugin elencati appaiono nel catalogo [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community), nella maggior parte dei casi fissati a uno SHA di commit specifico.166<h3 id="how-a-listed-plugin-reaches-claude-code-users">

~~164~~ 167 Come un plugin elencato raggiunge gli utenti di Claude Code

165Può esserci un ritardo tra l'invio e la comparsa del tuo plugin in `marketplace.json`. Per verificare se il tuo plugin è già installabile, cerca il suo nome nel [catalogo della comunità](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json).168</h3>

166 169

167Il marketplace ufficiale, `claude-plugins-official`, non accetta invii attraverso questi moduli. Se lavori con un contatto partner di Anthropic, chiedi loro informazioni su un'inserzione nel marketplace ufficiale.170Una persona che installa il tuo plugin dalla directory su claude.ai lo ha sul suo account, e Claude Code lo carica come `<name>@synced`. [Plugin sincronizzati da claude.ai](/docs/it/plugins/loading#synced-plugins) copre cosa vedono e come lo disattivano.

168 171

169<h2 id="ship-updates-renames-and-removals">172<h2 id="ship-updates-renames-and-removals">

170 Spedisci aggiornamenti, ridenominazioni e rimozioni173 Spedisci aggiornamenti, ridenominazioni e rimozioni

174 Rilascia una nuova versione177 Rilascia una nuova versione

175</h3>178</h3>

176 179

177Se pubblichi attraverso il tuo marketplace personale e il tuo `plugin.json` imposta `version`, incrementala e esegui il push. Gli utenti che eseguono `claude plugin update` o hanno l'aggiornamento automatico attivato ricevono la nuova versione, come descritto in [Spedisci aggiornamenti agli utenti](#ship-updates-to-users).180Se pubblichi attraverso il tuo marketplace personale e il tuo `plugin.json` imposta `version`, incrementala e esegui il push. Gli utenti che eseguono `claude plugin update` o hanno l'aggiornamento automatico attivato ricevono la nuova versione, come descritto in [Spedisci aggiornamenti agli utenti](#ship-updates-to-users). Per un elenco di directory, vedi [Aggiorna un plugin pubblicato](https://claude.com/docs/plugins/submit#update-a-published-plugin).

178 181

179<h3 id="tag-a-release">182<h3 id="tag-a-release">

180 Etichetta un rilascio183 Etichetta un rilascio

plugins/security.md +1 −1

Details

118 118

119Nella tua shell, esegui [`claude plugin uninstall <plugin>`](/docs/it/plugins/cli-reference#plugin-uninstall) con lo `--scope` in cui l'hai installato. Quindi controlla cosa ha rimosso la disinstallazione e cosa ha lasciato:119Nella tua shell, esegui [`claude plugin uninstall <plugin>`](/docs/it/plugins/cli-reference#plugin-uninstall) con lo `--scope` in cui l'hai installato. Quindi controlla cosa ha rimosso la disinstallazione e cosa ha lasciato:

120 120

121* **Dati persistenti**: quando era l'ultimo scope in cui il plugin era installato, la disinstallazione elimina anche la directory dei dati persistenti del plugin, a meno che non passi `--keep-data`.121* **Dati persistenti**: per impostazione predefinita, quando era l'ultimo scope in cui il plugin era installato, la disinstallazione elimina anche la directory dei dati persistenti del plugin. Per `--keep-data` e gli altri casi in cui rimane, vedi [plugin uninstall](/docs/it/plugins/cli-reference#plugin-uninstall).

122* **File memorizzati nella cache**: i file del plugin rimangono su disco sotto `~/.claude/plugins/cache/` per 14 giorni prima che una [scansione di background li rimuova](/docs/it/plugins/loading#cleanup-of-previous-versions). Dopo aver disinstallato l'ultimo plugin, le directory orfane rimangono fino a quando non installi un altro. Per eliminare i file ora, rimuovi tu stesso la directory del plugin sotto `~/.claude/plugins/cache/<marketplace>/<plugin>/`.122* **File memorizzati nella cache**: i file del plugin rimangono su disco sotto `~/.claude/plugins/cache/` per 14 giorni prima che una [scansione di background li rimuova](/docs/it/plugins/loading#cleanup-of-previous-versions). Dopo aver disinstallato l'ultimo plugin, le directory orfane rimangono fino a quando non installi un altro. Per eliminare i file ora, rimuovi tu stesso la directory del plugin sotto `~/.claude/plugins/cache/<marketplace>/<plugin>/`.

123* **Il marketplace**: se non ti fidi nemmeno del proprietario del marketplace, [rimuovi il marketplace](/docs/it/plugins/install#manage-marketplaces) anche, che disinstalla ogni plugin che hai installato da esso.123* **Il marketplace**: se non ti fidi nemmeno del proprietario del marketplace, [rimuovi il marketplace](/docs/it/plugins/install#manage-marketplaces) anche, che disinstalla ogni plugin che hai installato da esso.

124 124

plugins/troubleshooting.md +11 −1

Details

676 `Failed to load hooks from <path>` and hooks that don't fire676 `Failed to load hooks from <path>` and hooks that don't fire

677</h3>677</h3>

678 678

679Gli hooks di un plugin non vengono eseguiti. O la scheda **Errors** mostra un fallimento di caricamento per loro, gli hooks si caricano e si vedono avvisi `<Event> hook error` nella trascrizione, oppure un hook si carica senza errore e non si attiva mai.679Gli hooks di un plugin non vengono eseguiti, oppure uno blocca un'azione. O la scheda **Errors** mostra un fallimento di caricamento per loro, gli hooks si caricano e si vedono avvisi `<Event> hook error` o un errore di blocco nella trascrizione, oppure un hook si carica senza errore e non si attiva mai.

680 680

681<h4 id="hooks-fail-to-load">681<h4 id="hooks-fail-to-load">

682 Hooks fail to load682 Hooks fail to load

693 693

694Un avviso della forma `... hook error: Failed with non-blocking status code: <stderr>` significa che l'hook è stato eseguito e il suo comando è fallito. Ad esempio, `Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found` significa che la shell che Claude Code ha generato non poteva trovare `node`. Installarlo o assicurarsi che sia su `PATH` del terminale da cui si avvia `claude`.694Un avviso della forma `... hook error: Failed with non-blocking status code: <stderr>` significa che l'hook è stato eseguito e il suo comando è fallito. Ad esempio, `Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found` significa che la shell che Claude Code ha generato non poteva trovare `node`. Installarlo o assicurarsi che sia su `PATH` del terminale da cui si avvia `claude`.

695 695

696Se lo stderr mostra il percorso del plugin tagliato a uno spazio, il comando in forma shell dell'hook utilizza `${CLAUDE_PLUGIN_ROOT}` al di fuori delle virgolette e il percorso di installazione contiene uno spazio. Avvolgere la variabile tra virgolette doppie o utilizzare [exec form](/docs/it/hooks#exec-form-and-shell-form). Per trovare la variabile non quotata, eseguire `claude plugin validate` sulla directory del plugin e cercare il suo [avviso di quotazione](/docs/it/plugins/manifest-reference#quoting-and-path-separators).

697

696Per qualsiasi altro errore, eseguire il comando dell'hook da soli dalla directory del plugin per vedere l'output completo o catturare lo stderr completo con [debug logging](/docs/it/hooks#debug-hooks).698Per qualsiasi altro errore, eseguire il comando dell'hook da soli dalla directory del plugin per vedere l'output completo o catturare lo stderr completo con [debug logging](/docs/it/hooks#debug-hooks).

697 699

700<h4 id="a-plugin-hook-blocks-a-tool-call-or-prompt">

701 A plugin hook blocks a tool call or prompt

702</h4>

703

704Un hook che esce con codice 2 [blocca l'azione per cui è stato eseguito](/docs/it/hooks#exit-code-2). Quando un hook di un plugin blocca in questo modo e il suo stderr è il messaggio di blocco, l'errore termina con `This hook comes from the <plugin> plugin.` in modo che si sappia quale plugin disabilitare o correggere. Prima della v2.1.281, l'errore non nominava il plugin.

705

706Se quel messaggio mostra il percorso del plugin tagliato a uno spazio, applicare la [correzione `${CLAUDE_PLUGIN_ROOT}` non quotata](#hook-error-notices-in-the-transcript).

707

698<h4 id="hook-loads-but-never-fires">708<h4 id="hook-loads-but-never-fires">

699 Hook loads but never fires709 Hook loads but never fires

700</h4>710</h4>

prompt-caching.md +30 −18

Details

37Due impostazioni non compaiono nella tabella dei layer ma influiscono comunque su ciò che rimane memorizzato nella cache:37Due impostazioni non compaiono nella tabella dei layer ma influiscono comunque su ciò che rimane memorizzato nella cache:

38 38

39* **Model**: ogni modello ha la propria cache. Cambiare modello ricalcola l'intera richiesta anche quando il contenuto è identico. Consultate [Switching models](#switching-models) di seguito.39* **Model**: ogni modello ha la propria cache. Cambiare modello ricalcola l'intera richiesta anche quando il contenuto è identico. Consultate [Switching models](#switching-models) di seguito.

40* **Effort level**: sulla maggior parte dei modelli, ogni livello di sforzo ha la propria cache, quindi cambiare lo sforzo a metà sessione ricalcola l'intera richiesta. Su Opus 5.5 e Fable 5.1 con una chiave API o un abbonamento Claude, la cache rimane intatta per impostazione predefinita. Consultate [Changing effort level](#changing-effort-level) di seguito.40* **Effort level**: sulla maggior parte dei modelli, ogni livello di sforzo ha la propria cache, quindi cambiare lo sforzo a metà sessione ricalcola l'intera richiesta. Su Opus 5.5, Sonnet 5.5 e Fable 5.1 con una chiave API o un abbonamento Claude, la cache rimane intatta per impostazione predefinita. Consultate [Changing effort level](#changing-effort-level) di seguito.

41 41

42<Tip>42<Tip>

43 Scegliete il vostro modello e il livello di sforzo all'inizio di una sessione, quindi riservate `/compact` per le pause naturali tra i compiti. Meno modifiche apportate a metà compito, più alto sarà il vostro tasso di cache hit.43 Scegliete il vostro modello e il livello di sforzo all'inizio di una sessione, quindi riservate `/compact` per le pause naturali tra i compiti. Meno modifiche apportate a metà compito, più alto sarà il vostro tasso di cache hit.

75* [Cambio di modelli](#switching-models)75* [Cambio di modelli](#switching-models)

76* [Modifica del livello di sforzo](#changing-effort-level)76* [Modifica del livello di sforzo](#changing-effort-level)

77* [Attivazione della modalità veloce](#turning-on-fast-mode)77* [Attivazione della modalità veloce](#turning-on-fast-mode)

~~78* [Connessione o disconnessione di un server MCP](#connecting-or-disconnecting-an-mcp-server)~~78* [Connessione o rimozione di un server MCP](#connecting-or-removing-an-mcp-server)

79* [Abilitazione o disabilitazione di un plugin](#enabling-or-disabling-a-plugin)79* [Abilitazione o disabilitazione di un plugin](#enabling-or-disabling-a-plugin)

80* [Negazione di uno strumento completo](#denying-an-entire-tool)80* [Negazione di uno strumento completo](#denying-an-entire-tool)

81* [Compattazione della conversazione](#compacting-the-conversation)81* [Compattazione della conversazione](#compacting-the-conversation)

96 96

97L'[impostazione del modello `opusplan`](/docs/it/model-config#opusplan-model-setting) si risolve in Opus durante la modalità piano e Sonnet durante l'esecuzione, quindi ogni attivazione/disattivazione della modalità piano è un cambio di modello e avvia una cache nuova.97L'[impostazione del modello `opusplan`](/docs/it/model-config#opusplan-model-setting) si risolve in Opus durante la modalità piano e Sonnet durante l'esecuzione, quindi ogni attivazione/disattivazione della modalità piano è un cambio di modello e avvia una cache nuova.

98 98

99[Il fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui modelli Fable, Opus 5.5 e Opus 5 è anche un cambio di modello. Quando un classificatore di sicurezza contrassegna una richiesta in una categoria che ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e la sessione continua lì.99[Il fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 è anche un cambio di modello. Quando un classificatore di sicurezza contrassegna una richiesta in una categoria che ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e la sessione continua lì.

100 100

101Quando il frontmatter di una skill o di un comando nomina un [`model`](/docs/it/skills#frontmatter-reference) diverso dal modello corrente della sessione, quel turno è anche un cambio di modello: la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Il modello della sessione riprende al tuo prossimo prompt. Una skill `context: fork` imposta il [modello del subagent con fork](/docs/it/skills#run-skills-in-a-subagent) invece.101Quando il frontmatter di una skill o di un comando nomina un [`model`](/docs/it/skills#frontmatter-reference) diverso dal modello corrente della sessione, quel turno è anche un cambio di modello: la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Il modello della sessione riprende al tuo prossimo prompt. Una skill `context: fork` imposta il [modello del subagent con fork](/docs/it/skills#run-skills-in-a-subagent) invece.

102 102

106 106

107Sulla maggior parte dei modelli, modificare il [livello di sforzo](/docs/it/model-config#adjust-effort-level) a metà sessione significa che la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Mentre la cache è ancora calda, Claude Code ti chiede di confermare il cambio prima.107Sulla maggior parte dei modelli, modificare il [livello di sforzo](/docs/it/model-config#adjust-effort-level) a metà sessione significa che la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Mentre la cache è ancora calda, Claude Code ti chiede di confermare il cambio prima.

108 108

109Su Opus 5.5 e Fable 5.1 con una chiave API o un abbonamento Claude, modificare lo sforzo mantiene la cache, e Claude Code applica il nuovo livello senza chiedere. Questo non si applica su Amazon Bedrock, su Google Cloud's Agent Platform, o su un [gateway di app Claude](/docs/it/claude-apps-gateway), o quando imposti [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) o la tua organizzazione ha una configurazione HIPAA.109Su Opus 5.5, Sonnet 5.5 e Fable 5.1 con una chiave API o un abbonamento Claude, modificare lo sforzo mantiene la cache, e Claude Code applica il nuovo livello senza chiedere. Questo non si applica su Amazon Bedrock, su Google Cloud's Agent Platform, o su un [gateway di app Claude](/docs/it/claude-apps-gateway), o quando imposti [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) o la tua organizzazione ha una configurazione HIPAA.

110 110

111Prima della v2.1.260, modificare lo sforzo su Fable 5.1 con una chiave API o un abbonamento Claude invalidava anche la cache.111Prima della v2.1.260, modificare lo sforzo su Fable 5.1 con una chiave API o un abbonamento Claude invalidava anche la cache.

112 112

118 118

119Il costo si applica una volta per conversazione. Dopo il primo turno in modalità veloce, Claude Code continua a inviare l'intestazione e varia solo l'impostazione di velocità della richiesta, che non fa parte della chiave di cache. Disattivare la modalità veloce, il [fallback automatico alla velocità standard](/docs/it/fast-mode#handle-rate-limits) dopo un limite di velocità, e riattivarla in seguito mantengono tutti la cache. Se [esaurisci i crediti di utilizzo](/docs/it/fast-mode#handle-rate-limits) a metà sessione, Claude Code ritenta ogni richiesta in modalità veloce rifiutata alla velocità standard nello stesso modo, quindi questo fallback mantiene anche la cache. `/clear` e `/compact` ripristinano questo, poiché ricostruiscono la cache in quei punti comunque.119Il costo si applica una volta per conversazione. Dopo il primo turno in modalità veloce, Claude Code continua a inviare l'intestazione e varia solo l'impostazione di velocità della richiesta, che non fa parte della chiave di cache. Disattivare la modalità veloce, il [fallback automatico alla velocità standard](/docs/it/fast-mode#handle-rate-limits) dopo un limite di velocità, e riattivarla in seguito mantengono tutti la cache. Se [esaurisci i crediti di utilizzo](/docs/it/fast-mode#handle-rate-limits) a metà sessione, Claude Code ritenta ogni richiesta in modalità veloce rifiutata alla velocità standard nello stesso modo, quindi questo fallback mantiene anche la cache. `/clear` e `/compact` ripristinano questo, poiché ricostruiscono la cache in quei punti comunque.

120 120

121<h3 id="connecting-or-disconnecting-an-mcp-server">121<h3 id="connecting-or-removing-an-mcp-server">

122 Connessione o disconnessione di un server MCP122 Connessione o rimozione di un server MCP

123</h3>123</h3>

124 124

125Le definizioni degli strumenti si trovano nel livello del prompt di sistema, quindi la cache si invalida quando l'insieme delle definizioni degli strumenti nella richiesta cambia tra i turni. Attivare/disattivare lo [strumento advisor](/docs/it/advisor) è un'eccezione: la sua definizione si trova dopo il punto di interruzione della cache, quindi abilitare o disabilitare `/advisor` mantiene il prefisso memorizzato nella cache intatto. Se un cambio di [server MCP](/docs/it/mcp) fa questo dipende dal fatto che i suoi strumenti siano differiti dalla [ricerca degli strumenti](/docs/it/mcp#scale-with-mcp-tool-search) o caricati nel prefisso:125Le definizioni degli strumenti si trovano nel livello del prompt di sistema, quindi la cache si invalida quando l'insieme delle definizioni degli strumenti nella richiesta cambia tra i turni. Attivare/disattivare lo [strumento advisor](/docs/it/advisor) è un'eccezione: la sua definizione si trova dopo il punto di interruzione della cache, quindi abilitare o disabilitare `/advisor` mantiene il prefisso memorizzato nella cache intatto. Se un cambio di [server MCP](/docs/it/mcp) fa questo dipende dal fatto che la [ricerca degli strumenti](/docs/it/mcp#scale-with-mcp-tool-search) differisca gli strumenti MCP della sessione, l'impostazione predefinita sui modelli supportati:

126 126

127* **Strumenti differiti**, l'impostazione predefinita sui modelli supportati: un server che si connette, si disconnette, o cambia il suo elenco di strumenti aggiunge solo nuovo contenuto e non disturba nulla già memorizzato nella cache.127* **Strumenti differiti**: Claude Code mantiene l'elenco degli strumenti dalla prima richiesta della conversazione per l'intera conversazione, quindi un server che si connette o si disconnette a metà sessione non disturba nulla già memorizzato nella cache. Un server che finisce di connettersi dopo la prima richiesta fornisce i suoi strumenti come definizioni differite che Claude carica su richiesta.

128* **Strumenti caricati nel prefisso**: qualsiasi modifica a essi invalida la cache. Questo accade quando la [ricerca degli strumenti non è disponibile o è disabilitata](/docs/it/mcp#configure-tool-search), ad esempio sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, con un gateway `ANTHROPIC_BASE_URL` personalizzato, o su una distribuzione Microsoft Foundry [ospitata su Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) una volta che Claude Code rileva che la distribuzione rifiuta la ricerca degli strumenti. Accade anche per un server o uno strumento contrassegnato [`alwaysLoad`](/docs/it/mcp#exempt-a-server-from-deferral), e per le definizioni mantenute in primo piano dal [caricamento basato su soglia](/docs/it/mcp#configure-tool-search).128* **Strumenti caricati in anticipo**: aggiungere una definizione invalida la cache, e così fa anche rimuoverne una di proposito. Questo si applica quando la ricerca degli strumenti è [al di sotto della sua soglia `auto`, disabilitata o non disponibile](/docs/it/mcp#configure-tool-search), ad esempio sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, con un gateway `ANTHROPIC_BASE_URL` personalizzato, o su una distribuzione Microsoft Foundry [ospitata su Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) una volta che Claude Code rileva che la distribuzione rifiuta la ricerca degli strumenti.

129 129

130Quando gli strumenti si caricano nel prefisso, la causa più comune di un'invalidazione è un server che si connette o si disconnette a metà sessione, il che può accadere senza alcuna azione da parte tua: il processo di un server stdio esce, una sessione HTTP scade, o un server [si riconnette automaticamente dopo un errore transitorio](/docs/it/mcp#automatic-reconnection). Un server connesso può anche inviare un [aggiornamento dinamico dello strumento](/docs/it/mcp#dynamic-tool-updates) che cambia il suo elenco di strumenti.130Senza ricerca degli strumenti, se un cambio di server a metà sessione invalida la cache dipende da cosa è cambiato. Per ogni cambio, questa tabella indica se la cache viene mantenuta e cosa accade alle definizioni degli strumenti nella richiesta successiva.

131

132| Cambio a metà sessione | Cache | Definizioni degli strumenti nella richiesta successiva |

133| - | - | - |

134| Un server si connette, o un [aggiornamento dinamico dello strumento](/docs/it/mcp#dynamic-tool-updates) aggiunge strumenti | Invalidata | Le nuove definizioni vengono aggiunte |

135| Un server si disconnette senza alcuna azione da parte tua, ad esempio il processo di un server stdio esce | Mantenuta | Le definizioni del server rimangono invariate. Una chiamata a uno dei suoi strumenti restituisce un errore invece di eseguirsi |

136| Un server remoto [si riconnette automaticamente](/docs/it/mcp#automatic-reconnection) dopo che la sua connessione si interrompe | Mantenuta, a meno che una richiesta inviata mentre il server si riconnette aggiunga lo strumento `WaitForMcpServers`, che invalida la cache una volta | Le definizioni del server rimangono invariate. Una richiesta inviata mentre il server si riconnette può aggiungere `WaitForMcpServers` quando la conversazione non l'ha ancora elencato, e lo strumento rimane quindi elencato per il resto della conversazione |

137| Rimuovi uno strumento di proposito, ad esempio con una [regola di negazione](#denying-an-entire-tool) o disabilitando il suo server in `/mcp` | Invalidata | La definizione viene rimossa |

138

139Quando riprendi una conversazione i cui strumenti si caricano nel prefisso, uno dei suoi server MCP può ancora essere in fase di connessione mentre la prima richiesta esce. Se la trascrizione ha registrato le definizioni degli strumenti di quel server, quella richiesta le include come registrate, quindi non cambia quando il server finisce di connettersi con gli stessi strumenti.

131 140

132Modificare la tua configurazione MCP non cambia di per sé la cache. La nuova configurazione ha effetto solo dopo un riavvio, che è quando il server si connette o si disconnette.141Modificare la tua configurazione MCP non cambia di per sé la cache. La nuova configurazione ha effetto solo dopo un riavvio, che è quando il server si connette o si disconnette.

133 142

147 Plugin che forniscono server MCP156 Plugin che forniscono server MCP

148</h4>157</h4>

149 158

150Quando abiliti o disabiliti un plugin che fornisce [server MCP](/docs/it/plugins/components#mcp-servers), Claude Code segue le stesse regole di quando [connetti o disconnetti un server MCP](#connecting-or-disconnecting-an-mcp-server):159Quando abiliti o disabiliti un plugin che fornisce [server MCP](/docs/it/plugins/components#mcp-servers), Claude Code segue le stesse regole di quando [connetti o rimuovi un server MCP](#connecting-or-removing-an-mcp-server).

~~151~~

152* Se Claude Code differisce gli strumenti del server, mantiene la cache.

153* Se Claude Code li carica nel prefisso, la richiesta successiva rilegge l'intera conversazione.

154 160

155<h4 id="code-intelligence-plugins">161<h4 id="code-intelligence-plugins">

156 Plugin di intelligenza del codice162 Plugin di intelligenza del codice

244 Modifica di file nel tuo repository250 Modifica di file nel tuo repository

245</h3>251</h3>

246 252

247I contenuti dei file entrano nel contesto solo quando Claude li legge, e le letture si aggiungono alla conversazione. La modifica di un file che Claude ha precedentemente letto non cambia retroattivamente la lettura precedente nella cronologia. Invece, Claude Code aggiunge un `<system-reminder>` che nota il cambio del file, e Claude lo rilegge se necessario.253I contenuti dei file entrano nel contesto solo quando Claude li legge, e le letture si aggiungono alla conversazione. La modifica di un file che Claude ha precedentemente letto non cambia retroattivamente la lettura precedente nella cronologia. Invece, Claude Code aggiunge un [`<system-reminder>`](/docs/it/glossary#system-reminder) che nota il cambio del file, e Claude lo rilegge se necessario.

248 254

249<h3 id="editing-claude-md-mid-session">255<h3 id="editing-claude-md-mid-session">

250 Modifica di CLAUDE.md durante la sessione256 Modifica di CLAUDE.md durante la sessione

354 Cache scope360 Cache scope

355</h2>361</h2>

356 362

357In Claude Code, la cache è effettivamente scoped a una macchina e una directory. Ogni conversazione porta con sé la directory di lavoro, la piattaforma, la shell e la versione del sistema operativo, e il prompt di sistema nomina i tuoi percorsi di memoria automatica, quindi due sessioni in directory diverse costruiscono prefissi diversi e si perdono la cache l'una dell'altra. Questo include i worktrees dello stesso repository, poiché ogni worktree ha la sua directory di lavoro.363In Claude Code, la cache è effettivamente scoped a una macchina e una directory. Il prompt di sistema incorpora i tuoi percorsi di memoria automatica, e la conversazione si apre con un annuncio della directory di lavoro, della piattaforma, della shell e della versione del sistema operativo. Due sessioni in directory diverse quindi costruiscono prefissi diversi e si perdono la cache l'una dell'altra.

358 364

359Le sessioni che esegui in parallelo nella stessa directory costruiscono prefissi corrispondenti e leggono la cache l'una dell'altra. Le sessioni sequenziali condividono il prefisso solo quando lo snapshot dello stato git all'avvio corrisponde, poiché ogni conversazione porta anche il ramo e i commit recenti da quello snapshot.365Le sessioni che esegui in parallelo nella stessa directory costruiscono prefissi corrispondenti e leggono la cache l'una dell'altra. Le sessioni sequenziali condividono il prefisso solo quando lo snapshot dello stato git all'avvio corrisponde, poiché ogni conversazione porta anche il ramo e i commit recenti da quello snapshot.

360 366

361La cache API sottostante è più ampia. Le cache sono isolate tra le organizzazioni e, su alcuni provider, [tra i workspace all'interno di un'organizzazione](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-storage-and-sharing). All'interno di questi confini, qualsiasi due richieste con lo stesso modello e prefisso leggono la stessa cache. Per i chiamanti dell'Agent SDK che eseguono flotte di processi automatizzati, vedi [improve prompt caching across users and machines](/docs/it/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) per sopprimere le sezioni per macchina del prompt di sistema e condividere la cache tra le macchine.367La cache API sottostante è più ampia. Le cache sono isolate tra le organizzazioni e, su alcuni provider, [tra i workspace all'interno di un'organizzazione](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-storage-and-sharing). All'interno di questi confini, qualsiasi due richieste con lo stesso modello e prefisso leggono la stessa cache. Per i chiamanti dell'Agent SDK che eseguono flotte di processi automatizzati, vedi [improve prompt caching across users and machines](/docs/it/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) per spostare la posizione della memoria automatica fuori dal prompt di sistema e condividere la voce della cache del prompt di sistema tra utenti e macchine.

362 368

363<h2 id="check-cache-performance">369<h2 id="check-cache-performance">

364 Verificare le prestazioni della cache370 Verificare le prestazioni della cache

405| Variable | Effect |411| Variable | Effect |

406| - | - |412| - | - |

412 418

419`DISABLE_PROMPT_CACHING_HAIKU` si applica al modello Haiku predefinito, il modello a cui l'alias `haiku` si risolve. Disabilita il caching ovunque quel modello venga eseguito, inclusa la conversazione principale quando è il tuo modello principale. Coprire la conversazione principale richiede Claude Code v2.1.283 o successivo.

420

421La variabile copre anche un modello di background che hai impostato con la variabile deprecata `ANTHROPIC_SMALL_FAST_MODEL`, quando quel modello differisce dal tuo modello principale.

422

423Una versione diversa di Haiku che fissi come tuo modello principale mantiene il caching; imposta `DISABLE_PROMPT_CACHING` per disabilitare il caching per essa.

424

413Per impostare la politica di caching in un'organizzazione, metti una di queste o le [TTL variables](#cache-lifetime) nel blocco `env` di [managed settings](/docs/it/managed-settings). Per l'uso normale, lascia il caching abilitato.425Per impostare la politica di caching in un'organizzazione, metti una di queste o le [TTL variables](#cache-lifetime) nel blocco `env` di [managed settings](/docs/it/managed-settings). Per l'uso normale, lascia il caching abilitato.

414 426

415<h2 id="related-resources">427<h2 id="related-resources">

quickstart.md +4 −2

Details

27 Passaggio 1: Installa Claude Code27 Passaggio 1: Installa Claude Code

28</h2>28</h2>

29 29

~~30Per installare Claude Code, utilizza uno dei seguenti metodi:~~30Per installare Claude Code, apri un terminale ed esegui il comando per il tuo sistema. Se non hai mai utilizzato un terminale prima, la [guida al terminale](/docs/it/terminal-guide) mostra come aprirne uno e incollare il comando.

31 31

32<Tabs>32<Tabs>

33 <Tab title="Installazione nativa (consigliata)">33 <Tab title="Installazione nativa (consigliata)">

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51

52 Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).

52 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell. Il tuo prompt mostra `PS C:\` quando sei in PowerShell e `C:\` senza il `PS` quando sei in CMD.54 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell. Il tuo prompt mostra `PS C:\` quando sei in PowerShell e `C:\` senza il `PS` quando sei in CMD.

53 55

54 Se il comando di installazione non riesce con `syntax error near unexpected token '<'`, un `403`, o un altro errore curl, consulta [Troubleshoot installation](/docs/it/troubleshoot-install#find-your-error) per abbinare l'errore a una soluzione e per metodi di installazione alternativi.56 Se il comando di installazione non riesce con `syntax error near unexpected token '<'`, un `403`, o un altro errore curl, consulta [Troubleshoot installation](/docs/it/troubleshoot-install#find-your-error) per abbinare l'errore a una soluzione e per metodi di installazione alternativi.

187 189

188Claude Code trova il file appropriato e ti mostra la modifica. Se chiede prima di apportare la modifica, seleziona **Sì** per approvare.190Claude Code trova il file appropriato e ti mostra la modifica. Se chiede prima di apportare la modifica, seleziona **Sì** per approvare.

189 191

190La modalità Auto è la [modalità di autorizzazione iniziale integrata](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) per le sessioni di terminale interattive sui piani Pro, Max e Team: un classificatore esamina le azioni invece di voi, e Claude modifica la maggior parte dei file ed esegue la maggior parte dei comandi senza chiedere. Su altri piani, la modalità Manual è la modalità di autorizzazione iniziale integrata. Per la sessione che avviate subito dopo l'installazione, vedere [Prima sessione dopo un'installazione o un aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade).192Con Claude Code v2.1.283 o versioni successive, la modalità auto è la [modalità di autorizzazione iniziale integrata](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) per le sessioni di terminale interattive: un classificatore esamina le azioni invece di voi, e Claude modifica la maggior parte dei file ed esegue la maggior parte dei comandi senza chiedere. Nelle versioni precedenti, la modalità auto è la modalità di autorizzazione iniziale integrata solo sui piani Pro, Max e Team. Per la sessione che avviate subito dopo l'installazione, vedere [Prima sessione dopo un'installazione o un aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade).

191 193

192<Note>194<Note>

193 Le vostre impostazioni o la vostra organizzazione possono impostare una modalità di autorizzazione iniziale diversa. [Quale modalità di autorizzazione una sessione inizia](/docs/it/permission-modes#which-mode-a-session-starts-in) elenca cosa lo fa. Premete `Shift+Tab` in qualsiasi momento per cambiare la modalità di autorizzazione della sessione in cui vi trovate.195 Le vostre impostazioni o la vostra organizzazione possono impostare una modalità di autorizzazione iniziale diversa. [Quale modalità di autorizzazione una sessione inizia](/docs/it/permission-modes#which-mode-a-session-starts-in) elenca cosa lo fa. Premete `Shift+Tab` in qualsiasi momento per cambiare la modalità di autorizzazione della sessione in cui vi trovate.

remote-control.md +166 −174

Details

6 6

7> Continua una sessione locale di Claude Code dal tuo telefono, tablet o da qualsiasi browser utilizzando Remote Control. Funziona con claude.ai/code e l'app Claude per dispositivi mobili.7> Continua una sessione locale di Claude Code dal tuo telefono, tablet o da qualsiasi browser utilizzando Remote Control. Funziona con claude.ai/code e l'app Claude per dispositivi mobili.

8 8

~~9<Note>~~

10 Remote Control è disponibile su tutti i piani. Su Team e Enterprise, è disabilitato per impostazione predefinita fino a quando un proprietario non abilita l'interruttore Remote Control nelle [impostazioni di amministrazione di Claude Code](https://claude.ai/admin-settings/claude-code).

~~11</Note>~~

13Remote Control connette [claude.ai/code](https://claude.ai/code) o l'app Claude per [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) e [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) a una sessione di Claude Code in esecuzione sulla tua macchina. Avvia un'attività alla tua scrivania, quindi riprendi dal tuo telefono sul divano o da un browser su un altro computer.9Remote Control connette [claude.ai/code](https://claude.ai/code) o l'app Claude per [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) e [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) a una sessione di Claude Code in esecuzione sulla tua macchina. Avvia un'attività alla tua scrivania, quindi riprendi dal tuo telefono sul divano o da un browser su un altro computer.

14 10

15Quando avvii una sessione Remote Control sulla tua macchina, Claude continua a funzionare localmente per tutto il tempo, quindi l'esecuzione del codice e l'accesso al filesystem rimangono sulla tua macchina. Con Remote Control puoi:11Quando avvii una sessione Remote Control sulla tua macchina, Claude continua a funzionare localmente per tutto il tempo, quindi l'esecuzione del codice e l'accesso al filesystem rimangono sulla tua macchina. Con Remote Control puoi:

17* **Utilizzare il tuo ambiente locale completo da remoto**: il tuo filesystem, i [server MCP](/docs/it/mcp), gli strumenti e la configurazione del progetto rimangono disponibili, e digitando `@` l'autocompletamento completa i percorsi dei file dal tuo progetto locale.13* **Utilizzare il tuo ambiente locale completo da remoto**: il tuo filesystem, i [server MCP](/docs/it/mcp), gli strumenti e la configurazione del progetto rimangono disponibili, e digitando `@` l'autocompletamento completa i percorsi dei file dal tuo progetto locale.

18* **Lavorare da entrambe le superfici contemporaneamente**: la conversazione e il progresso dei [subagent](/docs/it/sub-agents) e dei [flussi di lavoro dinamici](/docs/it/workflows) rimangono sincronizzati su tutti i dispositivi connessi, quindi puoi inviare messaggi dal tuo terminale, browser e telefono in modo intercambiabile.14* **Lavorare da entrambe le superfici contemporaneamente**: la conversazione e il progresso dei [subagent](/docs/it/sub-agents) e dei [flussi di lavoro dinamici](/docs/it/workflows) rimangono sincronizzati su tutti i dispositivi connessi, quindi puoi inviare messaggi dal tuo terminale, browser e telefono in modo intercambiabile.

19* **Inviare immagini e file dal tuo telefono o browser**: allega una foto o un file nell'app Claude o su claude.ai/code, con o senza didascalia. Claude vede le foto allegate direttamente come parte del tuo messaggio. Claude Code scarica altri file sulla tua macchina e li passa a Claude come riferimenti a file `@`.15* **Inviare immagini e file dal tuo telefono o browser**: allega una foto o un file nell'app Claude o su claude.ai/code, con o senza didascalia. Claude vede le foto allegate direttamente come parte del tuo messaggio. Claude Code scarica altri file sulla tua macchina e li passa a Claude come riferimenti a file `@`.

20* **Sopravvivere alle interruzioni**: se il tuo laptop va in sospensione o la tua rete si interrompe, Claude Code si riconnette automaticamente quando la tua macchina torna online. Mentre la connessione si sta ricostruendo, Claude Code mette in coda i messaggi, i prompt di autorizzazione e gli aggiornamenti di stato dai subagent e dai flussi di lavoro, e li consegna una volta che la connessione si recupera.16* **Sopravvivere alle interruzioni**: se il tuo laptop va in sospensione o la tua rete si interrompe, Claude Code si riconnette automaticamente quando la tua macchina torna online.

22A differenza di [Claude Code sul web](/docs/it/claude-code-on-the-web), che funziona su infrastrutture cloud, le sessioni Remote Control vengono eseguite direttamente sulla tua macchina e interagiscono con il tuo filesystem locale. Le interfacce web e mobile sono una finestra in quella sessione locale.

23 17

~~24Questa pagina copre la configurazione, come avviare e connettersi alle sessioni, e come Remote Control si confronta con Claude Code sul web.~~18A differenza di [sessioni cloud](/docs/it/claude-code-on-the-web), che vengono eseguite su infrastrutture cloud, le sessioni Remote Control vengono eseguite direttamente sulla tua macchina e interagiscono con il tuo filesystem locale. Le interfacce web e mobile sono una finestra in quella sessione locale, quindi il tuo computer deve rimanere acceso e il processo `claude` deve continuare a funzionare.

25 19

26<h2 id="requirements">20<h2 id="requirements">

27 Requisiti21 Requisiti

33* **Autenticazione**: esegui `claude` e utilizza `/login` per accedere tramite claude.ai se non l'hai già fatto. Senza un accesso idoneo, `claude remote-control` esce con un errore, mentre `claude --remote-control` avvia comunque una sessione interattiva e mostra una notifica di errore di Remote Control poco dopo l'avvio.27* **Autenticazione**: esegui `claude` e utilizza `/login` per accedere tramite claude.ai se non l'hai già fatto. Senza un accesso idoneo, `claude remote-control` esce con un errore, mentre `claude --remote-control` avvia comunque una sessione interattiva e mostra una notifica di errore di Remote Control poco dopo l'avvio.

34* **Endpoint API**: non disponibile in nessuna di queste configurazioni:28* **Endpoint API**: non disponibile in nessuna di queste configurazioni:

35 * Utilizzi Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.29 * Utilizzi Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.

36 * Punti [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) a un host diverso da `api.anthropic.com`, come un [gateway LLM](/docs/it/llm-gateway) o proxy. Annulla l'impostazione della variabile per utilizzare Remote Control. Prima della v2.1.196, Claude Code consentiva Remote Control con un `ANTHROPIC_BASE_URL` personalizzato.30 * Punti [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) a un host diverso da `api.anthropic.com`, come un [gateway LLM](/docs/it/llm-gateway) o proxy. Annulla l'impostazione della variabile per utilizzare Remote Control.

37 * Accedi tramite un [gateway di app Claude](/docs/it/claude-apps-gateway) aziendale.31 * Accedi tramite un [gateway di app Claude](/docs/it/claude-apps-gateway) aziendale.

38* **Valutazione dei flag di funzionalità**: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` e `DISABLE_GROWTHBOOK`](/docs/it/env-vars) disabilitano ciascuno la valutazione dei flag di funzionalità da cui dipende la disponibilità di Remote Control. Annulla l'impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco `env` di un [file `settings.json`](/docs/it/settings-reference#all-settings), per utilizzare Remote Control.32* **Valutazione dei flag di funzionalità**: se imposti una [variabile di ambiente che disattiva la valutazione dei flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), la disponibilità di Remote Control dipende da quale:

39* **Fiducia dell'area di lavoro**: esegui `claude` nella directory del tuo progetto almeno una volta per accettare la finestra di dialogo di fiducia dell'area di lavoro. La finestra di dialogo di fiducia all'avvio non salva mai la fiducia per la directory home, quindi avvia Remote Control da una directory di progetto.33 * Se imposti `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK`, Remote Control non è disponibile. Annulla l'impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco `env` di un [file `settings.json`](/docs/it/settings-reference#all-settings), per utilizzare Remote Control.

34 * Se imposti solo `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, Remote Control rimane disponibile a meno che la tua organizzazione non richieda [Dispositivi affidabili](#trusted-devices). Se lo richiede, annulla l'impostazione della variabile per utilizzare Remote Control. L'utilizzo di Remote Control con una di queste variabili impostate richiede Claude Code v2.1.283 o successivo.

35* **Fiducia dell'area di lavoro**: in una directory che non hai ancora considerato attendibile, `claude remote-control` stampa ciò che considerare attendibile attiva e chiede `Trust <directory>? [y/N]` prima di avviarsi. Rispondendo `y` salva la scelta, tranne nella tua directory home, dove la fiducia non viene mai salvata e la domanda ritorna ad ogni esecuzione. Quando il suo input o output standard non è un terminale, il comando non può chiedere ed esce con un errore [`Workspace not trusted`](/docs/it/errors#workspace-not-trusted-when-starting-remote-control).

40 36

41<h2 id="start-a-remote-control-session">37<h2 id="start-a-remote-control-session">

~~42 Avvia una sessione Remote Control~~38 Avviare una sessione Remote Control

43</h2>39</h2>

44 40

~~45Puoi avviare una sessione Remote Control dalla CLI o dall'estensione VS Code. La CLI offre tre modalità di invocazione; VS Code utilizza il comando `/remote-control`.~~41È possibile avviare una sessione Remote Control dalla CLI, dall'[app Claude Desktop](/docs/it/desktop) o dall'estensione VS Code. La CLI offre tre modalità di invocazione; l'app Desktop e VS Code utilizzano il comando `/remote-control`.

46 42

47<Tabs>43<Tabs>

48 <Tab title="Modalità server">44 <Tab title="Modalità server">

~~49 Accedi alla directory del tuo progetto ed esegui:~~45 Nella directory del progetto, eseguire:

50 46

51 ```bash theme={null}47 ```bash theme={null}

52 claude remote-control48 claude remote-control

53 ```49 ```

54 50

55 Finché non accetti la conferma una tantum di Remote Control, `claude remote-control` spiega cosa fa e chiede `Enable Remote Control? (y/n)` prima di avviare il server. Rispondi `y` per accettare e avviare il server. Se rifiuti, Claude Code esce senza avviare il server e chiede di nuovo la prossima volta che esegui il comando.51 Fino a quando non si accetta la conferma una tantum di Remote Control, `claude remote-control` spiega cosa fa e chiede `Enable Remote Control? (y/n)` prima di avviare il server. Rispondere `y` per accettare e avviare il server. Se si rifiuta, Claude Code esce senza avviare il server e chiede di nuovo la prossima volta che si esegue il comando.

56 52

57 Il processo rimane in esecuzione nel tuo terminale in modalità server, in attesa di connessioni remote. Visualizza un URL di sessione che puoi utilizzare per [connetterti da un altro dispositivo](#connect-from-another-device), e puoi premere la barra spaziatrice per mostrare un codice QR per un accesso rapido dal tuo telefono. Mentre una sessione remota è attiva, il terminale mostra lo stato della connessione e l'attività dello strumento.53 Il processo rimane in esecuzione nel terminale in modalità server, in attesa di connessioni remote. Visualizza un URL di sessione che è possibile utilizzare per [connettersi da un altro dispositivo](#connect-from-another-device), e si può premere la barra spaziatrice per visualizzare un codice QR per un accesso rapido dal telefono. Mentre una sessione remota è attiva, il terminale mostra lo stato della connessione e l'attività degli strumenti.

58 54

59 Flag disponibili:55 Flag disponibili:

60 56

61 | Flag | Descrizione |57 | Flag | Descrizione |

62 | - | - |58 | - | - |

63 | `--name "My Project"` | Imposta un titolo di sessione personalizzato visibile nell'elenco delle sessioni su claude.ai/code. |59 | `--name "My Project"` | Imposta un titolo di sessione personalizzato visibile nell'elenco delle sessioni su claude.ai/code. |

64 | `--remote-control-session-name-prefix <prefix>` | Prefisso per i nomi di sessione generati automaticamente quando non è impostato un nome esplicito. Per impostazione predefinita è il nome host della tua macchina, producendo nomi come `myhost-graceful-unicorn`. Imposta `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` per lo stesso effetto. |60 | `--remote-control-session-name-prefix <prefix>` | Prefisso per i nomi di sessione generati automaticamente quando non è impostato un nome esplicito. Per impostazione predefinita, il nome host della macchina, producendo nomi come `myhost-graceful-unicorn`. Impostare `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` per lo stesso effetto. |

65 | `-c`, `--continue` | Riprendi la sessione che l'ultimo server in questa directory ha avviato, invece di crearne una nuova. Vedi [Riprendi le sessioni dopo aver fermato il server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--session-id`, `--spawn`, `--capacity`, o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo; le versioni precedenti rifiutano il flag come argomento sconosciuto. |61 | `-c`, `--continue` | Ripristina la sessione che l'ultimo server in questa directory ha avviato, invece di crearne una nuova. Vedere [Riprendere le sessioni dopo l'arresto del server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--session-id`, `--spawn`, `--capacity` o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo. |

66 | `--session-id <id>` | Riprendi una sessione dal suo ID. Vedi [Riprendi le sessioni dopo aver fermato il server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--continue`, `--spawn`, `--capacity`, o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo; le versioni precedenti rifiutano il flag come argomento sconosciuto. |62 | `--session-id <id>` | Ripristina una sessione in base al suo ID. Vedere [Riprendere le sessioni dopo l'arresto del server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--continue`, `--spawn`, `--capacity` o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo. |

67 | `--spawn <mode>` | Come il server crea le sessioni.<br />• `same-dir` (predefinito): tutte le sessioni condividono la directory di lavoro corrente, quindi possono entrare in conflitto se modificano gli stessi file.<br />• `worktree`: ogni sessione su richiesta ottiene il proprio [git worktree](/docs/it/worktrees). Richiede un repository git.<br />• `session`: modalità a sessione singola. Serve esattamente una sessione e rifiuta connessioni aggiuntive. Impostato solo all'avvio.<br />Premi `w` durante l'esecuzione per attivare/disattivare tra `same-dir` e `worktree`. |63 | `--spawn <mode>` | Come il server crea le sessioni.<br />• `same-dir` (predefinito): tutte le sessioni condividono la directory di lavoro corrente, quindi possono entrare in conflitto se modificano gli stessi file.<br />• `worktree`: ogni sessione su richiesta ottiene il proprio [git worktree](/docs/it/worktrees). Richiede un repository git.<br />• `session`: modalità a sessione singola. Serve esattamente una sessione e rifiuta connessioni aggiuntive. Impostato solo all'avvio.<br />Premere `w` durante l'esecuzione per alternare tra `same-dir` e `worktree`. |

68 | `--capacity <N>` | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con `--spawn=session`. |64 | `--capacity <N>` | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con `--spawn=session`. |

69 | `--[no-]create-session-in-dir` | Pre-crea una sessione nella directory corrente quando il server si avvia, così hai un posto dove digitare immediatamente. In modalità `worktree` questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Abilitato per impostazione predefinita. Se passi `--no-create-session-in-dir` per avviare senza nessuna, Claude Code archivia le sessioni del server quando le fermi, quindi non c'è nulla da [riprendere](#resume-sessions-after-stopping-the-server). |65 | `--[no-]create-session-in-dir` | Pre-crea una sessione nella directory corrente quando il server si avvia, in modo da avere un posto dove digitare immediatamente. In modalità `worktree` questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Attivato per impostazione predefinita. Se si passa `--no-create-session-in-dir` per iniziare senza nessuno, Claude Code archivia le sessioni del server quando lo si arresta, quindi non c'è nulla da [riprendere](#resume-sessions-after-stopping-the-server). |

70 | `--permission-mode <mode>` | Imposta la [modalità di autorizzazione](/docs/it/permission-modes) iniziale per le sessioni del server, come `acceptEdits`. Accetta `manual` come alias per `default`; una modalità non riconosciuta ferma il server all'avvio ed elenca le modalità valide. |66 | `--permission-mode <mode>` | Imposta la [modalità di autorizzazione](/docs/it/permission-modes) iniziale per le sessioni del server, come `acceptEdits`. Accetta `manual` come alias per `default`; una modalità non riconosciuta arresta il server all'avvio ed elenca le modalità valide. |

~~71 | `--debug-file <path>` | Scrivi i log di debug nel file specificato. |~~67 | `-d`, `--debug[=<filter>]` | Attiva la registrazione del debug per il server, facoltativamente filtrata per categoria. Passare un filtro solo nella forma `=`, come `--debug=api,hooks`. Richiede Claude Code v2.1.282 o successivo; le versioni precedenti rifiutano il flag come argomento sconosciuto. |

68 | `--debug-file <path>` | Scrive i log di debug nel file specificato. |

72 | `--verbose` | Mostra log dettagliati di connessione e sessione. |69 | `--verbose` | Mostra log dettagliati di connessione e sessione. |

~~73 | `--sandbox` / `--no-sandbox` | Abilita o disabilita il [sandboxing](/docs/it/sandboxing) per l'isolamento del filesystem e della rete. Disabilitato per impostazione predefinita. |~~70 | `--sandbox` / `--no-sandbox` | Abilita o disabilita il [sandboxing](/docs/it/sandboxing) per l'isolamento del file system e della rete. Disabilitato per impostazione predefinita. |

74 71

~~75 Fornisci questi flag dopo `remote-control`.~~72 Fornire questi flag dopo `remote-control`.

76 73

77 Se passi un flag `claude` globale prima di `remote-control`, o uno script wrapper ne aggiunge uno, Claude Code non trasporta il flag alle sessioni che il server crea. Claude Code lascia passare il flag solo quando eliminarlo non è noto per cambiare ciò che quelle sessioni possono fare, come `--verbose` o `--model`. Per qualsiasi altro flag, come `--settings`, Claude Code [rifiuta di avviare](/docs/it/errors#not-carried-over-to-the-sessions-remote-control-starts) e nomina il flag da rimuovere. Prima della v2.1.248, qualsiasi opzione prima di `remote-control` faceva sì che Claude Code rifiutasse i flag dopo di essa con un errore `unknown option`.74 Se si passa un flag `claude` globale prima di `remote-control`, o uno script wrapper ne aggiunge uno, Claude Code non trasporta il flag alle sessioni che il server crea. Claude Code consente il flag solo quando è noto che eliminarlo non cambia ciò che quelle sessioni possono fare, come `--verbose` o `--model`. Per qualsiasi altro flag, come `--settings`, Claude Code [rifiuta di avviarsi](/docs/it/errors#not-carried-over-to-the-sessions-remote-control-starts) e nomina il flag da rimuovere.

78 75

79 Claude Code verifica l'idoneità di Remote Control prima di stampare la guida, quindi `claude remote-control --help` restituisce un errore invece di questo elenco di flag quando non sei connesso con un account idoneo.76 Claude Code verifica l'idoneità di Remote Control prima di stampare la guida, quindi `claude remote-control --help` restituisce un errore invece di questo elenco di flag quando non si è connessi con un account idoneo.

80 </Tab>77 </Tab>

81 78

82 <Tab title="Sessione interattiva">79 <Tab title="Sessione interattiva">

~~83 Per avviare una normale sessione interattiva di Claude Code con Remote Control abilitato, utilizza il flag `--remote-control` (o `--rc`):~~80 Per avviare una normale sessione Claude Code interattiva con Remote Control abilitato, utilizzare il flag `--remote-control` (o `--rc`):

84 81

85 ```bash theme={null}82 ```bash theme={null}

86 claude --remote-control83 claude --remote-control

87 ```84 ```

88 85

~~89 Facoltativamente passa un nome per la sessione:~~86 Facoltativamente, passare un nome per la sessione:

90 87

91 ```bash theme={null}88 ```bash theme={null}

92 claude --remote-control "My Project"89 claude --remote-control "My Project"

96 </Tab>93 </Tab>

97 94

98 <Tab title="Da una sessione esistente">95 <Tab title="Da una sessione esistente">

~~99 Se sei già in una sessione di Claude Code e vuoi continuarla da remoto, utilizza il comando `/remote-control` (o `/rc`):~~96 Se sei già in una sessione Claude Code e vuoi continuarla da remoto, utilizza il comando `/remote-control` (o `/rc`):

100 97

101 ```text theme={null}98 ```text theme={null}

102 /remote-control99 /remote-control

108 /remote-control My Project105 /remote-control My Project

109 ```106 ```

110 107

111 Questo avvia una sessione Remote Control che mantiene la cronologia della conversazione corrente.108 Questo avvia una sessione Remote Control che trasporta la cronologia della conversazione corrente.

112 109

113 Finché non accetti la conferma una tantum di Remote Control, una finestra di dialogo appare prima che `/remote-control` si connetta. Seleziona **Enable Remote Control** per accettare e connetterti. Se selezioni **Never mind** o premi Esc, Claude Code non si connette e chiede di nuovo la prossima volta che esegui `/remote-control`.110 Fino a quando non si accetta la conferma una tantum di Remote Control, una finestra di dialogo appare prima che `/remote-control` si connetta. Selezionare **Enable Remote Control** per accettare e connettersi. Se si seleziona **Never mind** o si preme Esc, Claude Code non si connette e chiede di nuovo la prossima volta che si esegue `/remote-control`.

114 111

115 I flag `--verbose`, `--sandbox` e `--no-sandbox` non sono disponibili con questo comando.112 I flag `--verbose`, `--sandbox` e `--no-sandbox` non sono disponibili con questo comando.

116 </Tab>113 </Tab>

117 114

118 <Tab title="VS Code">115 <Tab title="VS Code">

119 Nell'[estensione VS Code di Claude Code](/docs/it/vs-code), digita `/remote-control` o `/rc` nella casella del prompt.116 Nell'[estensione Claude Code VS Code](/docs/it/vs-code), digitare `/remote-control` o `/rc` nella casella del prompt.

120 117

121 ```text theme={null}118 ```text theme={null}

122 /remote-control119 /remote-control

123 ```120 ```

124 121

125 Mentre Remote Control è attivo, Claude Code mostra un indicatore **Remote Control** nel footer della casella del prompt. Una volta che la sessione si connette, fai clic sull'indicatore per andare direttamente alla sessione, oppure trovala nell'elenco delle sessioni su [claude.ai/code](https://claude.ai/code). Claude Code pubblica anche l'URL della sessione nella conversazione. Per disconnetterti, esegui `/remote-control` di nuovo.122 Mentre Remote Control è attivo, Claude Code mostra un indicatore **Remote Control** nel footer della casella del prompt. Una volta che la sessione si connette, fare clic sull'indicatore per andare direttamente alla sessione, oppure trovarla nell'elenco delle sessioni su [claude.ai/code](https://claude.ai/code). Claude Code pubblica anche l'URL della sessione nella conversazione. Per disconnettersi, eseguire `/remote-control` di nuovo.

126 123

127 A differenza della CLI, il comando VS Code non accetta un argomento di nome e non visualizza un codice QR. Il titolo della sessione è derivato dalla cronologia della conversazione o dal primo prompt.124 A differenza della CLI, il comando VS Code non accetta un argomento di nome o non visualizza un codice QR. Il titolo della sessione è derivato dalla cronologia della conversazione o dal primo prompt.

128 </Tab>125 </Tab>

129</Tabs>

130 126

131<h3 id="check-connection-status">127 <Tab title="App Desktop">

132 Verifica lo stato della connessione128 In una sessione locale nella scheda Code dell'[app Claude Desktop](/docs/it/desktop), digitare `/remote-control` o `/rc` nella casella del prompt.

133</h3>

134 129

135In una sessione interattiva, mentre Remote Control è connesso, il terminale mostra un indicatore `/rc active` che si collega alla sessione su claude.ai. L'indicatore è nascosto quando il terminale è troppo stretto per contenerlo. Per vedere l'URL della sessione e un codice QR per [connetterti da un altro dispositivo](#connect-from-another-device), esegui `/remote-control` di nuovo per aprire il pannello di stato. Il pannello ti consente anche di disconnettere Remote Control mentre la tua sessione locale continua a funzionare.130 ```text theme={null}

131 /remote-control

132 ```

136 133

137<span id="session-ended-elsewhere" />Se la connessione non riesce in una sessione interattiva, l'indicatore cambia per mostrare l'errore, e Claude Code mostra il motivo in una notifica e lo aggiunge alla conversazione. Esegui `/remote-control` per riconnetterti, a meno che il motivo non dica che la sessione è stata modificata altrove:134 Una volta che la sessione si connette, trovarla nell'elenco delle sessioni su [claude.ai/code](https://claude.ai/code). Per disconnettersi, eseguire `/remote-control` di nuovo.

138 135

139* **Un'altra connessione ha preso il controllo di questa sessione**: un altro dispositivo o una sessione di Claude Code ce l'ha ora. Esegui `/remote-control` solo se vuoi riprendertela.136 Per attivare Remote Control per ogni sessione per impostazione predefinita, vedere [Abilitare Remote Control per tutte le sessioni](#enable-remote-control-for-all-sessions).

140* **Questa sessione è stata terminata o archiviata da un altro dispositivo o app**: esegui `/remote-control` solo se la vuoi indietro. Claude Code riapre una sessione archiviata.137 </Tab>

141* **Il server non segnala più questa sessione**: potrebbe essere stata eliminata da un altro dispositivo o app.138</Tabs>

142 139

143<h3 id="session-url-reminders">140<h3 id="check-connection-status">

144 Promemoria dell'URL della sessione141 Verificare lo stato della connessione

145</h3>142</h3>

146 143

147Mentre Remote Control è connesso, Claude Code ti ricorda l'URL della sessione quando passare al tuo telefono o browser è più utile, così non devi trovare il collegamento in `/remote-control`. Un promemoria appare sopra la casella del prompt in uno di questi momenti:144In una sessione interattiva, mentre Remote Control è connesso, il terminale mostra un indicatore `/rc active` che si collega alla sessione su claude.ai. L'indicatore è nascosto quando il terminale è troppo stretto per contenerlo. Per visualizzare l'URL della sessione e un codice QR per [connettersi da un altro dispositivo](#connect-from-another-device), eseguire `/remote-control` di nuovo per aprire il pannello di stato. Il pannello ti consente anche di disconnettere Remote Control mentre la sessione locale continua a funzionare.

148 145

149* **Turno lungo**: quando un turno dura più a lungo di una soglia sintonizzata dal server, Claude Code mostra una notifica **Still working** con un collegamento **Check in from your phone**, così puoi seguire il turno dal tuo telefono o browser invece di aspettare al terminale. Claude Code la rimuove quando il turno termina.146<span id="session-ended-elsewhere" />Se la connessione non riesce in una sessione interattiva, l'indicatore cambia per mostrare l'errore, e Claude Code mostra il motivo in una notifica e lo aggiunge alla conversazione. Eseguire `/remote-control` per riconnettersi, a meno che il motivo non dica che la sessione è cambiata da qualche altra parte:

150* **Prompt di autorizzazione ripetuti**: dopo aver risposto a diversi [prompt di autorizzazione](/docs/it/permissions) in una sessione, una notifica **Approve tool calls from your phone** mostra l'URL della sessione. Claude Code la rimuove quando il tuo prossimo turno inizia.

151 147

152I promemoria possono apparire in qualsiasi sessione connessa, incluse quelle in cui Remote Control [si connette automaticamente](#enable-remote-control-for-all-sessions). Non appaiono ogni volta che si verificano queste condizioni, e ognuno appare solo poche volte in totale tra le sessioni. Non puoi configurarli o disattivarli; ognuno si cancella da solo.148* **Another connection took over this session**: un altro dispositivo o una sessione Claude Code lo ha ora. Eseguire `/remote-control` solo se si vuole riprenderselo.

149* **This session was ended or archived from another device or app**: eseguire `/remote-control` solo se si vuole la sessione indietro. Claude Code riapre una sessione archiviata.

150* **The server no longer reports this session**: potrebbe essere stato eliminato da un altro dispositivo o app.

153 151

154<h3 id="connect-from-another-device">152<h3 id="connect-from-another-device">

155 Connettiti da un altro dispositivo153 Connettersi da un altro dispositivo

156</h3>154</h3>

157 155

158Una volta che una sessione Remote Control è attiva, hai alcuni modi per connetterti da un altro dispositivo:156Una volta che una sessione Remote Control è attiva, hai alcuni modi per connetterti da un altro dispositivo:

159 157

160* **Apri l'URL della sessione** in qualsiasi browser per andare direttamente alla sessione su [claude.ai/code](https://claude.ai/code).158* **Apri l'URL della sessione** in qualsiasi browser per andare direttamente alla sessione su [claude.ai/code](https://claude.ai/code).

161* **Scansiona il codice QR** mostrato accanto all'URL della sessione per aprirlo direttamente nell'app Claude. Con `claude remote-control`, premi la barra spaziatrice per attivare/disattivare la visualizzazione del codice QR.159* **Scansiona il codice QR** mostrato accanto all'URL della sessione per aprirlo direttamente nell'app Claude. Con `claude remote-control`, premere la barra spaziatrice per attivare/disattivare la visualizzazione del codice QR.

162* **Apri [claude.ai/code](https://claude.ai/code) o l'app Claude** e trova la sessione per nome nell'elenco delle sessioni. Nell'app mobile Claude, tocca **Code** nella navigazione per raggiungere l'elenco delle sessioni. Le sessioni Remote Control mostrano un'icona di computer con un punto di stato verde quando sono online.160* **Apri [claude.ai/code](https://claude.ai/code) o l'app Claude** e trova la sessione per nome nell'elenco delle sessioni. Nell'app mobile Claude, tocca **Code** nella navigazione per raggiungere l'elenco delle sessioni. Le sessioni Remote Control mostrano un'icona del computer con un punto di stato verde quando sono online.

163 161

164Quando ti connetti, il dispositivo mostra tutti i subagent e i workflow che la sessione ha già in esecuzione in background. Ferma uno di essi dal dispositivo, e Claude Code ferma quel compito sulla tua macchina.162Quando ti connetti, il dispositivo mostra tutti i subagent e i flussi di lavoro che la sessione ha già in esecuzione in background. Arresta uno di essi dal dispositivo, e Claude Code arresta quel compito sulla tua macchina.

165 163

166Il titolo della sessione remota viene scelto in questo ordine:164Il titolo della sessione remota viene scelto in questo ordine:

167 165

1681. Il nome che hai passato a `--name`, `--remote-control`, o `/remote-control`1661. Il nome che hai passato a `--name`, `--remote-control` o `/remote-control`

1692. Il titolo che hai impostato con `/rename`1672. Il titolo che hai impostato con `/rename`

1703. L'ultimo messaggio significativo nella cronologia della conversazione esistente1683. L'ultimo messaggio significativo nella cronologia della conversazione esistente

1714. Un nome generato automaticamente come `myhost-graceful-unicorn`, dove `myhost` è il nome host della tua macchina o il prefisso che hai impostato con `--remote-control-session-name-prefix`1694. Un nome generato automaticamente come `myhost-graceful-unicorn`, dove `myhost` è il nome host della tua macchina o il prefisso che hai impostato con `--remote-control-session-name-prefix`

172 170

173Se non hai impostato un nome esplicito, Claude Code aggiorna il titolo per riflettere il tuo prompt una volta che ne invii uno. Claude Code abbina i titoli generati automaticamente alla lingua della tua conversazione, o all'impostazione [`language`](/docs/it/settings-reference#language) se ne è configurata una.171Se non hai impostato un nome esplicito, Claude Code aggiorna il titolo per riflettere il tuo prompt una volta che ne invii uno. Quando rinomini una sessione da claude.ai o dall'app Claude, Claude Code aggiorna anche il titolo locale mostrato in `claude --resume`.

174 172

175Quando rinomini una sessione da claude.ai o dall'app Claude, Claude Code aggiorna anche il titolo locale mostrato in `claude --resume`. Claude Code applica lo stesso rinomina al nome della sessione mostrato sulla barra del prompt, e nell'elenco `claude agents` quando la sessione [funziona in background](/docs/it/agent-view). Prima della v2.1.221, il rinomina da claude.ai o dall'app Claude aggiornava solo il titolo, e la CLI manteneva il suo nome di sessione precedente; `/rename`, che funziona nella CLI stessa, imposta il nome su qualsiasi versione.173Se non hai ancora l'app Claude, esegui `/mobile` all'interno di Claude Code per visualizzare un codice QR per [claude.ai/mobile](https://claude.ai/mobile), che apre il negozio di app corretto per il tuo telefono.

~~176~~

177Se non hai ancora l'app Claude, utilizza il comando `/mobile` all'interno di Claude Code per visualizzare un codice QR per [claude.ai/mobile](https://claude.ai/mobile), che apre il negozio di app corretto per il tuo telefono.

178 174

179<h3 id="what-connected-devices-see">175<h3 id="what-connected-devices-see">

180 Cosa vedono i dispositivi connessi176 Cosa vedono i dispositivi connessi

182 178

183Un dispositivo connesso mostra la conversazione nel tuo terminale mentre accade. Questi casi vanno oltre i messaggi ordinari:179Un dispositivo connesso mostra la conversazione nel tuo terminale mentre accade. Questi casi vanno oltre i messaggi ordinari:

184 180

185* **Compattazione e `/clear`**: mentre Claude Code [compatta la conversazione](/docs/it/context-window#what-survives-compaction), i dispositivi connessi mostrano il progresso e poi dove la conversazione è stata compattata. Quando esegui `/clear`, la conversazione si ripristina anche sui dispositivi connessi.181* **Compattazione e `/clear`**: mentre Claude Code [compatta la conversazione](/docs/it/context-window#what-survives-compaction), i dispositivi connessi mostrano l'avanzamento e poi dove la conversazione è stata compattata. Quando esegui `/clear`, la conversazione si ripristina anche sui dispositivi connessi.

186* **Cambio di conversazioni con `/resume`**: il dispositivo connesso non riceve il titolo della conversazione commutata o la cronologia precedente, ma i nuovi messaggi in entrambe le direzioni vanno verso e da qualunque conversazione sia aperta nel tuo terminale. Per lavorare di nuovo sulla conversazione originale dal dispositivo, esegui `/resume` nel tuo terminale e torna a essa.182* **Cambio di conversazioni con `/resume`**: il dispositivo connesso non riceve il titolo della conversazione a cui è stato passato o la cronologia precedente, ma i nuovi messaggi in entrambe le direzioni vanno verso e da qualunque conversazione sia aperta nel tuo terminale. Per lavorare di nuovo sulla conversazione originale dal dispositivo, esegui `/resume` nel tuo terminale e torna indietro.

187* **Estrazione di una sessione con `/teleport`**: quando estrai una [sessione cloud](/docs/it/claude-code-on-the-web#from-cloud-to-terminal) nel tuo terminale con `/teleport`, il dispositivo connesso non riceve la cronologia precedente della conversazione estratta. I nuovi messaggi in entrambe le direzioni vanno verso e da quella conversazione estratta, che è ora quella aperta nel tuo terminale.183* **Estrazione di una sessione con `/teleport`**: quando estrai una [sessione cloud](/docs/it/claude-code-on-the-web#from-cloud-to-terminal) nel tuo terminale con `/teleport`, il dispositivo connesso non riceve la cronologia precedente della conversazione estratta. I nuovi messaggi in entrambe le direzioni vanno verso e da quella conversazione estratta, che è ora quella aperta nel tuo terminale.

188* **Messaggi dalle tue altre sessioni**: con [messaggistica tra sessioni](/docs/it/cross-session-messaging), la stessa connessione trasporta messaggi tra le tue stesse sessioni su macchine diverse e dalle tue [sessioni cloud](/docs/it/claude-code-on-the-web), attraverso i server Anthropic come il resto del traffico Remote Control. [Messaggi alle sessioni su altre macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines) copre le regole di consegna e [Controlla i messaggi in entrata](/docs/it/cross-session-messaging#control-inbound-messages) copre i controlli in entrata. Richiede Claude Code v2.1.224 o successivo.184* **Messaggi dalle tue altre sessioni**: con la [messaggistica tra sessioni](/docs/it/cross-session-messaging), la stessa connessione trasporta messaggi tra le tue stesse sessioni su macchine diverse e dalle tue [sessioni cloud](/docs/it/claude-code-on-the-web).

189* **Prompt che invii a metà turno**: quando invii un prompt da un dispositivo connesso prima che il turno corrente termini, Claude Code lo mette in coda e lo mantiene nella trascrizione del dispositivo dopo che quel turno finisce.185* **Diff delle tue modifiche**: quando la directory della sessione si trova in un repository git, il pannello diff di un dispositivo connesso mostra le tue modifiche. Su un ramo che ha commit davanti al ramo predefinito del repository, il pannello mostra le modifiche da quando il ramo si è separato da esso, incluse le tue modifiche non sottoposte a commit. Sul ramo predefinito stesso, o su un ramo che non è davanti a esso, il pannello mostra solo le tue modifiche non sottoposte a commit.

190* **Diff dei tuoi cambiamenti**: quando la directory della sessione è in un repository git, il pannello diff di un dispositivo connesso mostra il diff dei tuoi cambiamenti. Il dispositivo richiede il diff sulla connessione, e Claude Code lo calcola sulla tua macchina. Su un ramo che ha commit davanti al ramo predefinito del repository, il pannello mostra i cambiamenti da quando il ramo si è separato da esso, inclusi i tuoi edit non committati. Sul ramo predefinito stesso, o su un ramo che non è davanti a esso, il pannello mostra solo i tuoi cambiamenti non committati. Prima della v2.1.247, Claude Code segnalava il diff ai dispositivi connessi solo nelle sessioni servite da `claude remote-control`.186* **Modello**: quando scegli un [modello](/docs/it/model-config) da un dispositivo connesso, Claude Code esegue la sessione su quel modello. Richiede Claude Code v2.1.238 o successivo. Un modello che scegli dal controllo del modello del dispositivo si applica solo alla sessione corrente. Quando invii `/model <name>` dal dispositivo a una sessione interattiva, Claude Code imposta anche il tuo valore predefinito per le nuove sessioni.

191* **Modello**: quando scegli un [modello](/docs/it/model-config) da un dispositivo connesso, Claude Code esegue la sessione su quel modello. Il picker `/model` del terminale, `/status`, e `/config` mostrano quel modello. Richiede Claude Code v2.1.238 o successivo.187* **Livello di sforzo**: quando imposti il [livello di sforzo](/docs/it/model-config#adjust-effort-level) da un dispositivo connesso, con `/effort` o il controllo dello sforzo del dispositivo, Claude Code lo applica alla sessione sulla tua macchina. Se hai fissato un livello con `CLAUDE_CODE_EFFORT_LEVEL`, la sessione mantiene quel livello, e Claude Code rifiuta una scelta diversa dal controllo dello sforzo. La scelta di un livello dal controllo dello sforzo richiede Claude Code v2.1.234 o successivo sulla tua macchina.

192 * Un modello che scegli dal controllo del modello del dispositivo si applica solo alla sessione corrente. Quando invii `/model <name>` dal dispositivo a una sessione interattiva, Claude Code imposta anche il tuo predefinito per le nuove sessioni.188* **Riconnessione dopo un errore di connessione**: esegui `/remote-control` per riconnetterti. Se la compattazione ha riscritto la conversazione o hai cambiato conversazioni con `/resume` nel frattempo, Claude Code archivia la sessione del server che stava utilizzando invece di lasciarla nell'elenco delle sessioni. Puoi comunque trovarla [filtrando le sessioni archiviate](/docs/it/claude-code-on-the-web#archive-sessions). Il cambio di conversazioni mentre un dispositivo è ancora connesso non archivia la sessione.

193 * Se invii un nome che Claude Code non riconosce, come un nome visualizzato dove è previsto un ID modello, Claude Code [rifiuta la scelta](/docs/it/errors#model-is-not-a-recognized-model-id) e la sessione mantiene il suo modello corrente. Prima della v2.1.260, Claude Code salvava una scelta non riconosciuta dal controllo del modello del dispositivo, e il tuo prossimo messaggio falliva.

194* **Livello di sforzo**: quando imposti il [livello di sforzo](/docs/it/model-config#adjust-effort-level) da un dispositivo connesso, con `/effort` o il controllo dello sforzo del dispositivo, Claude Code lo applica alla sessione sulla tua macchina, e claude.ai/code mostra il livello che la sessione sta utilizzando. Se hai fissato un livello con `CLAUDE_CODE_EFFORT_LEVEL`, la sessione mantiene quel livello, e Claude Code rifiuta una scelta diversa dal controllo dello sforzo. Scegliere un livello dal controllo dello sforzo richiede Claude Code v2.1.234 o successivo sulla tua macchina.

195* **Riconnessione dopo un errore di connessione**: esegui `/remote-control` per riconnetterti. Se la compattazione ha riscritto la conversazione o hai cambiato conversazioni con `/resume` nel frattempo, Claude Code archivia la sessione del server che stava utilizzando invece di lasciarla nell'elenco delle sessioni. Puoi comunque trovarla [filtrando per sessioni archiviate](/docs/it/claude-code-on-the-web#archive-sessions). Cambiare conversazioni mentre un dispositivo è ancora connesso non archivia la sessione.

196 189

197<h3 id="enable-remote-control-for-all-sessions">190<h3 id="enable-remote-control-for-all-sessions">

198 Abilita Remote Control per tutte le sessioni191 Abilitare Remote Control per tutte le sessioni

199</h3>192</h3>

200 193

201Remote Control si attiva solo quando esegui esplicitamente `claude remote-control`, `claude --remote-control`, o `/remote-control`, a meno che l'auto-connessione non sia attivata. Per attivare l'auto-connessione per ogni sessione interattiva, esegui `/config` all'interno di Claude Code e imposta **Enable Remote Control for all sessions**. L'interruttore accetta tre valori:194Remote Control si attiva solo quando esegui esplicitamente `claude remote-control`, `claude --remote-control` o `/remote-control`, a meno che la connessione automatica non sia attivata. Per attivare la connessione automatica per ogni sessione interattiva, esegui `/config` all'interno di Claude Code e imposta **Enable Remote Control for all sessions**. L'interruttore accetta tre valori:

202 195

203* **`true`**: connettiti automaticamente quando una sessione interattiva si avvia.196* **`true`**: connettiti automaticamente quando una sessione interattiva si avvia.

204* **`false`**: disattiva l'auto-connessione, anche se un `true` dalle [impostazioni gestite](/docs/it/managed-settings) lo supera, perché Claude Code salva la scelta alle tue impostazioni utente. Un `false` nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`) disattiva l'auto-connessione anche su un `true` gestito.197* **`false`**: disattiva la connessione automatica, anche se un `true` dalle [impostazioni gestite](/docs/it/managed-settings) lo supera, perché Claude Code salva la scelta nelle tue impostazioni utente. Un `false` nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`) disattiva la connessione automatica anche su un `true` gestito.

205* **`default`**: cancella la tua scelta e segui il valore predefinito dell'amministratore della tua organizzazione se ne è impostato uno, altrimenti il valore predefinito attuale di Claude Code.198* **`default`**: cancella la tua scelta e segui il valore predefinito dell'amministratore della tua organizzazione se ne è stato impostato uno, altrimenti il valore predefinito attuale di Claude Code.

206 199

207Lo stesso interruttore appare al di fuori della CLI:200Lo stesso interruttore appare al di fuori della CLI:

208 201

209* **App Desktop**: **Settings > Claude Code > Enable remote control by default**.202* **App Desktop**: **Settings > Claude Code > Enable remote control by default**.

210* **Estensione VS Code**: **Enable Remote Control for all sessions** nella sezione Impostazioni del [menu dei comandi](/docs/it/vs-code#use-the-prompt-box). Richiede Claude Code v2.1.203 o successivo.203* **Estensione VS Code**: **Enable Remote Control for all sessions** nella sezione Settings del [menu dei comandi](/docs/it/vs-code#use-the-prompt-box).

211 204

212Per attivare l'auto-connessione da un file di impostazioni, imposta [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) a `true` nel tuo file `~/.claude/settings.json` utente o nelle [impostazioni gestite](/docs/it/managed-settings). Nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code onora un `false` e disattiva l'auto-connessione per quel repository, ma ignora un `true`, quindi un file controllato non può attivare Remote Control per tutti coloro che aprono il repository.205Per attivare la connessione automatica da un file di impostazioni, imposta [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) su `true` nel tuo file `~/.claude/settings.json` utente o nelle [impostazioni gestite](/docs/it/managed-settings). Nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code onora un `false` e disattiva la connessione automatica per quel repository, ma ignora un `true`, quindi un file archiviato non può attivare Remote Control per tutti coloro che aprono il repository.

213 206

214L'auto-connessione accede con il tuo account claude.ai, quindi una sessione che avvia appare solo nelle tue app Claude e non concede a nessun altro l'accesso.207La connessione automatica accede con il tuo account claude.ai, quindi una sessione che avvia appare solo nei tuoi account Claude app e non concede a nessun altro l'accesso.

215 208

216Con questa impostazione attiva, ogni processo Claude Code interattivo registra una sessione remota. Se esegui più istanze, ognuna ottiene la sua sessione remota. Per eseguire più sessioni simultanee da un singolo processo, utilizza invece la [modalità server](#start-a-remote-control-session).209Con questa impostazione attivata, ogni processo Claude Code interattivo registra una sessione remota. Se esegui più istanze, ognuna ottiene la sua sessione remota. Per eseguire più sessioni simultanee da un singolo processo, utilizza invece la [modalità server](#start-a-remote-control-session).

217 210

218<h3 id="resume-sessions-after-stopping-the-server">211<h3 id="resume-sessions-after-stopping-the-server">

219 Riprendi le sessioni dopo aver fermato il server212 Riprendere le sessioni dopo l'arresto del server

220</h3>213</h3>

221 214

222Quando fermi `claude remote-control` con Ctrl+C, le sessioni che stava servendo smettono di rispondere dal tuo telefono o browser. Finché non stavi eseguendo un altro `claude remote-control` nella stessa directory e non hai avviato questo con `--no-create-session-in-dir`, Claude Code non le archivia. Per riportarle indietro, esegui uno di questi comandi nella stessa directory:215Quando arresti `claude remote-control` con Ctrl+C, le sessioni che stava servendo smettono di rispondere dal tuo telefono o browser. Finché non stavi eseguendo un altro `claude remote-control` nella stessa directory e non hai avviato questo con `--no-create-session-in-dir`, Claude Code non le archivia. Per ripristinarle, esegui uno di questi comandi nella stessa directory:

223 216

224* **`claude remote-control`**: riporta indietro ogni sessione che il server stava servendo.217* **`claude remote-control`**: ripristina ogni sessione che il server stava servendo.

225* **`claude remote-control --continue`**: riporta indietro solo la sessione con cui il server si è avviato, ed esce quando quella sessione termina. Se questa directory non ha un record, Claude Code utilizza il più recente dai worktree git di questo repository.218* **`claude remote-control --continue`**: ripristina solo la sessione che il server ha avviato, ed esce quando quella sessione termina. Se questa directory non ha un record, Claude Code utilizza la più recente dai worktree git di questo repository.

226* **`claude remote-control --session-id <id>`**: riporta indietro solo la sessione il cui ID passi, ed esce quando quella sessione termina. L'ID è la parte dell'URL della sessione su claude.ai/code tra `/code/` e qualsiasi `?`.219* **`claude remote-control --session-id <id>`**: ripristina solo la sessione il cui ID passi, ed esce quando quella sessione termina. L'ID è la parte dell'URL della sessione su claude.ai/code tra `/code/` e qualsiasi `?`.

227 220

228Questi comandi funzionano per circa quattro ore dopo che il server si è fermato. Dopo di che, esegui `claude remote-control` per avviare una nuova sessione. Se hai archiviato una sessione nel frattempo, `--continue` e `--session-id` la disarchiviano su Claude Code v2.1.228 o successivo.221Questi comandi funzionano per circa quattro ore dopo l'arresto del server. Dopo di che, esegui `claude remote-control` per avviare una nuova sessione. Se hai archiviato una sessione nel frattempo, `--continue` e `--session-id` la disarchiviano su Claude Code v2.1.228 o successivo.

229 222

230Per riportare indietro una sessione che hai avviato con `claude --remote-control` o `/remote-control`, riprendi la conversazione con `claude --continue` o `claude --resume`. Se Claude Code si riconnette, e a quale sessione, dipende dal [record di riconnessione](#resume-outcomes) della conversazione.223Per ripristinare una sessione che hai avviato con `claude --remote-control` o `/remote-control`, riprendi la conversazione con `claude --continue` o `claude --resume`. Se Remote Control non si riconnette, vedi [Couldn't reconnect to your Remote Control session](#couldnt-reconnect-to-your-remote-control-session).

231 224

232Se riprendi la conversazione in un secondo terminale mentre il primo ha ancora Remote Control attivo, Claude Code stampa un avviso nel secondo terminale e lascia Remote Control disattivo lì invece di prendere la sessione dal primo. Mentre Remote Control rimane disattivo lì, Claude in quel terminale non vede [le tue sessioni su altre macchine](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach), e non possono raggiungerlo. Esegui `/remote-control` nel secondo terminale per spostare Remote Control lì.225Se riprendi la conversazione in un secondo terminale mentre il primo ha ancora Remote Control attivo, Claude Code stampa un avviso `Remote Control not started here` nel secondo terminale e lascia Remote Control disattivato lì invece di prendere la sessione dal primo. Esegui `/remote-control` nel secondo terminale per spostare Remote Control su di esso.

233 226

234Quando riprendi una conversazione in Claude Desktop o un'estensione IDE che aveva Remote Control attivo, Claude Code la riallega alla sessione claude.ai esistente invece di aggiungerne una nuova all'elenco delle sessioni.227Quando riprendi una conversazione in Claude Desktop o in un'estensione IDE che aveva Remote Control attivo, Claude Code la riallega alla sessione claude.ai esistente invece di aggiungerne una nuova all'elenco delle sessioni.

235 228

236<h2 id="connection-and-security">229<h2 id="connection-and-security">

237 Connessione e sicurezza230 Connessione e sicurezza

239 232

240La tua sessione locale di Claude Code effettua solo richieste HTTPS in uscita e non apre mai porte in ingresso sulla tua macchina. Quando avvii Remote Control, si registra con l'API Anthropic e esegue il polling per il lavoro. Quando ti connetti da un altro dispositivo, il server instrada i messaggi tra il client web o mobile e la tua sessione locale su una connessione in streaming.233La tua sessione locale di Claude Code effettua solo richieste HTTPS in uscita e non apre mai porte in ingresso sulla tua macchina. Quando avvii Remote Control, si registra con l'API Anthropic e esegue il polling per il lavoro. Quando ti connetti da un altro dispositivo, il server instrada i messaggi tra il client web o mobile e la tua sessione locale su una connessione in streaming.

241 234

242Tutto il traffico viaggia attraverso l'API Anthropic su TLS, lo stesso trasporto di sicurezza di qualsiasi sessione di Claude Code. La connessione utilizza più credenziali di breve durata, ognuna limitata a un singolo scopo e con scadenza indipendente. Quando la credenziale di registrazione di un server `claude remote-control` scade, il server si registra di nuovo con l'API Anthropic e continua a servire le sue sessioni.235Tutto il traffico viaggia attraverso l'API Anthropic su TLS, lo stesso trasporto di sicurezza di qualsiasi sessione di Claude Code. La connessione utilizza più credenziali di breve durata, ognuna limitata a un singolo scopo e con scadenza indipendente.

243 236

244Mentre Remote Control è connesso, la trascrizione della sessione, inclusi i tuoi messaggi, le risposte di Claude e l'attività degli strumenti, viene archiviata sui server Anthropic. La trascrizione archiviata mantiene la conversazione sincronizzata tra i tuoi dispositivi e consente alla sessione di riconnettersi dopo un'interruzione di rete. L'esecuzione e l'accesso al filesystem rimangono sulla tua macchina, e le trascrizioni archiviate vengono conservate secondo la politica di [utilizzo dei dati](/docs/it/data-usage).237Mentre Remote Control è connesso, la trascrizione della sessione, inclusi i tuoi messaggi, le risposte di Claude e l'attività degli strumenti, viene archiviata sui server Anthropic. La trascrizione archiviata mantiene la conversazione sincronizzata tra i tuoi dispositivi e consente alla sessione di riconnettersi dopo un'interruzione di rete. L'esecuzione e l'accesso al filesystem rimangono sulla tua macchina, e le trascrizioni archiviate vengono conservate secondo la politica di [utilizzo dei dati](/docs/it/data-usage).

245 238

309Per un dispositivo perso o rubato, il membro lo rimuove da questa pagina. Se il membro non riesce ad accedere, un amministratore può utilizzare **Sign out everywhere** nella console di amministrazione per revocare ogni sessione e dispositivo registrato per quel membro, dopo di che il membro registra di nuovo i dispositivi che ancora possiede.302Per un dispositivo perso o rubato, il membro lo rimuove da questa pagina. Se il membro non riesce ad accedere, un amministratore può utilizzare **Sign out everywhere** nella console di amministrazione per revocare ogni sessione e dispositivo registrato per quel membro, dopo di che il membro registra di nuovo i dispositivi che ancora possiede.

310 303

311<h2 id="remote-control-vs-cloud-sessions">304<h2 id="remote-control-vs-cloud-sessions">

312 Remote Control vs cloud sessions305 Remote Control vs sessioni cloud

313</h2>306</h2>

314 307

315Remote Control e [cloud sessions](/docs/it/claude-code-on-the-web) utilizzano entrambi l'interfaccia claude.ai/code. La differenza chiave è dove viene eseguita la sessione: Remote Control viene eseguito sulla tua macchina, quindi i tuoi server MCP locali, strumenti e configurazione del progetto rimangono disponibili. Una cloud session viene eseguita su infrastruttura cloud, gestita da Anthropic per impostazione predefinita.308Remote Control e [sessioni cloud](/docs/it/claude-code-on-the-web) utilizzano entrambi l'interfaccia claude.ai/code. La differenza principale è dove viene eseguita la sessione: Remote Control viene eseguito sulla vostra macchina, quindi i vostri server MCP locali, strumenti e configurazione del progetto rimangono disponibili. Una sessione cloud viene eseguita su infrastruttura cloud, gestita da Anthropic per impostazione predefinita.

309

310Utilizzate Remote Control quando siete nel mezzo di un lavoro locale e volete continuare da un altro dispositivo. Utilizzate una sessione cloud quando volete avviare un'attività senza alcuna configurazione locale, lavorare su un repository che non avete clonato, o eseguire più attività in parallelo. Un [progetto](/docs/it/claude-projects) combina i due: i suoi thread vengono eseguiti nel cloud e utilizza Remote Control per [eseguire un thread sul vostro computer](/docs/it/claude-projects#run-a-thread-on-your-own-computer) quando lo richiedete lì.

316 311

317Utilizza Remote Control quando sei nel mezzo di un lavoro locale e vuoi continuare da un altro dispositivo. Utilizza una cloud session quando vuoi avviare un'attività senza alcuna configurazione locale, lavorare su un repository che non hai clonato, o eseguire più attività in parallelo.312Claude Code offre diversi modi di lavorare quando non sei al tuo terminale. Differiscono in ciò che attiva il lavoro, dove Claude viene eseguito e quanto setup è necessario.

313

315| :- | :- | :- | :- | :- |

317| [Remote Control](/docs/it/remote-control) | Guida una sessione in esecuzione da [claude.ai/code](https://claude.ai/code) o dall'app mobile Claude | La tua macchina (CLI, Desktop, o VS Code) | Esegui [`claude remote-control` o `/remote-control`](/docs/it/remote-control#start-a-remote-control-session) | Guidare il lavoro in corso da un altro dispositivo |

318| [Channels](/docs/it/channels) | Invia eventi da un'app di chat come Telegram o Discord, o dal tuo server | La tua macchina (CLI) | [Installa un plugin channel](/docs/it/channels#quickstart) o [crea il tuo](/docs/it/channels-reference) | Reagire a eventi esterni come errori CI o messaggi di chat |

319| [Slack](/docs/it/slack) | Menziona `@Claude` in un canale del team | Cloud Anthropic | [Installa l'app Slack](/docs/it/slack#setting-up-claude-code-in-slack) con [Claude Code sul web](/docs/it/claude-code-on-the-web) abilitato | PR e revisioni dalla chat del team |

320| [Self-hosted environments](/docs/it/self-hosted-environments) | Avvia una [sessione cloud](/docs/it/claude-code-on-the-web) e scegli l'ambiente della tua organizzazione | L'infrastruttura della tua organizzazione | [Distribuisci runner](/docs/it/self-hosted-environments-quickstart), su piani Team e Enterprise | Sessioni cloud che devono essere eseguite all'interno della tua rete |

318 322

319<h2 id="mobile-push-notifications">323<h2 id="mobile-push-notifications">

320 Notifiche push mobili324 Notifiche push mobili

322 326

323Quando Remote Control è attivo, Claude può inviare notifiche push al tuo telefono.327Quando Remote Control è attivo, Claude può inviare notifiche push al tuo telefono.

324 328

325Claude decide quando inviare una notifica. Tipicamente ne invia una quando un'attività a lunga esecuzione termina o quando ha bisogno di una decisione da te per continuare. Puoi anche richiedere una notifica nel tuo prompt, ad esempio `notify me when the tests finish`. Oltre ai due interruttori on/off qui sotto, non c'è configurazione per evento.329Claude decide quando inviare una notifica. Tipicamente ne invia una quando un'attività a lunga esecuzione termina o quando ha bisogno di una decisione da parte tua per continuare. Puoi anche richiedere una notifica nel tuo prompt, ad esempio `notify me when the tests finish`. Oltre ai due interruttori on/off di seguito, non c'è alcuna configurazione per evento.

326 330

327Per configurare le notifiche push mobili:331Per configurare le notifiche push mobili:

328 332

329<Steps>333<Steps>

330 <Step title="Installa l'app Claude per dispositivi mobili">334 <Step title="Installa l'app mobile Claude">

331 Scarica l'app Claude per [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) o [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude).335 Scarica l'app Claude per [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) o [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude).

332 </Step>336 </Step>

333 337

334 <Step title="Accedi con il tuo account Claude Code">338 <Step title="Accedi con il tuo account Claude Code">

335 Utilizza lo stesso account e organizzazione che usi per Claude Code nel terminale.339 Usa lo stesso account e organizzazione che usi per Claude Code nel terminale.

336 </Step>340 </Step>

337 341

338 <Step title="Consenti le notifiche">342 <Step title="Consenti le notifiche">

340 </Step>344 </Step>

341 345

342 <Step title="Abilita push in Claude Code">346 <Step title="Abilita push in Claude Code">

343 Nel tuo terminale, esegui `/config` e abilita **Push when Claude decides** per notifiche proattive, **Push when actions required** per prompt di autorizzazione e domande, o entrambi.347 Nel tuo terminale, esegui `/config` e abilita **Push when Claude decides** per le notifiche proattive, **Push when actions required** per i prompt di autorizzazione e le domande, o entrambi.

344 </Step>348 </Step>

345</Steps>349</Steps>

346 350

347Se le notifiche non arrivano:351Se le notifiche non arrivano:

348 352

349* Se `/config` mostra **No mobile registered**, apri l'app Claude sul tuo telefono in modo che possa aggiornare il suo token push. L'avviso si cancella la prossima volta che Remote Control si connette.353* Se `/config` mostra **No mobile registered**, apri l'app Claude sul tuo telefono in modo che possa aggiornare il suo token push. L'avviso si cancella la prossima volta che Remote Control si connette.

350* Su iOS, le modalità Focus e i riepiloghi delle notifiche possono sopprimere o ritardare le notifiche push. Controlla Impostazioni → Notifiche → Claude.354* Su iOS, le modalità Focus e i riepiloghi delle notifiche possono sopprimere o ritardare i push. Controlla Impostazioni → Notifiche → Claude.

351* Su Android, l'ottimizzazione aggressiva della batteria può ritardare la consegna. Escludi l'app Claude dall'ottimizzazione della batteria nelle impostazioni di sistema.355* Su Android, l'ottimizzazione aggressiva della batteria può ritardare la consegna. Escludi l'app Claude dall'ottimizzazione della batteria nelle impostazioni di sistema.

352 356

353Claude Code salta le notifiche push mobili mentre stai digitando o sei concentrato sul terminale connesso. A partire da v2.1.181, puoi impostare [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/it/env-vars) su un percorso di file marcatore per estendere questo a qualsiasi momento in cui sei alla macchina, anche in un'altra finestra: le notifiche vengono saltate mentre il file esiste. Configura un listener di blocco dello schermo o uno strumento simile per creare il file quando lo schermo si sblocca ed eliminarlo quando lo schermo si blocca.357Claude Code salta le notifiche push mobili mentre stai digitando o sei concentrato sul terminale connesso. Per estendere questo a qualsiasi momento in cui sei alla macchina, anche in un'altra finestra, imposta [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/it/env-vars) su un percorso di file marcatore: le notifiche vengono saltate mentre il file esiste. Configura un listener di blocco dello schermo o uno strumento simile per creare il file quando lo schermo si sblocca ed eliminarlo quando lo schermo si blocca.

354 358

355<h2 id="limitations">359<h2 id="limitations">

356 Limitazioni360 Limitazioni

357</h2>361</h2>

358 362

359* **Una sessione remota per processo interattivo**: al di fuori della modalità server, ogni istanza di Claude Code supporta una sessione remota alla volta. Utilizza la [modalità server](#start-a-remote-control-session) per eseguire più sessioni simultanee da un singolo processo.363* **Una sessione remota per processo interattivo**: al di fuori della modalità server, ogni istanza di Claude Code supporta una sessione remota alla volta. Utilizzare la [modalità server](#start-a-remote-control-session) per eseguire più sessioni simultanee da un singolo processo.

360* **Il processo locale deve continuare a funzionare**: Remote Control viene eseguito come processo locale. Se chiudi il terminale, esci da VS Code, o altrimenti interrompi il processo `claude`, la sessione va offline finché non la [ripristini](#resume-sessions-after-stopping-the-server). A meno che Claude non sia nel mezzo di un'attività, claude.ai e l'app Claude mostrano la sessione come offline entro pochi secondi dopo l'uscita del processo. Per mantenere una sessione in esecuzione su una macchina remota dopo la disconnessione da SSH, avviala all'interno di `tmux` o `screen`.364* **Il processo locale deve continuare a funzionare**: Remote Control viene eseguito come processo locale. Se chiudete il terminale, chiudete l'app Desktop o VS Code, o altrimenti interrompete il processo `claude`, la sessione va offline finché non la [ripristinate](#resume-sessions-after-stopping-the-server). Per mantenere una sessione in esecuzione su una macchina remota dopo la disconnessione da SSH, avviatela all'interno di `tmux` o `screen`.

361* **Sessioni bloccate in modalità server**: se una sessione servita da `claude remote-control` si blocca, inviale un messaggio da un dispositivo connesso. Claude Code la serve di nuovo. Non è necessario riavviare il server. Richiede Claude Code v2.1.238 o successivo.365* **Sessioni bloccate in modalità server**: se una sessione servita da `claude remote-control` si blocca, inviatele un messaggio da un dispositivo connesso. Claude Code la serve di nuovo. Non dovete riavviare il server. Richiede Claude Code v2.1.238 o successivo.

362* **Rifiuti HTTP 403 su una sessione connessa**: una volta che una sessione interattiva è connessa, Claude Code continua a riprovare per un massimo di tre minuti quando qualcosa tra la tua macchina e i server di Anthropic risponde con HTTP 403, come può accadere dopo un cambio VPN o di rete. Se i rifiuti durano più a lungo, Claude Code si disconnette e il motivo indica cosa ha rifiutato: un edge di rete, o un proxy, VPN o firewall sulla tua rete.366* **Rifiuti HTTP 403 su una sessione connessa**: una volta che una sessione interattiva è connessa, Claude Code continua a riprovare per un massimo di tre minuti quando qualcosa tra la vostra macchina e i server di Anthropic risponde con HTTP 403, come può accadere dopo un cambio VPN o di rete. Se i rifiuti durano più a lungo, Claude Code si disconnette e il motivo indica cosa ha rifiutato: un edge di rete, o un proxy, VPN o firewall sulla vostra rete.

363* **Interruzione di rete prolungata**: se la tua macchina è accesa ma non riesce a raggiungere la rete, quello che fai dopo dipende dalla modalità:367* **Interruzione di rete prolungata**: se la vostra macchina è accesa ma non riesce a raggiungere la rete, quello che fate dopo dipende dalla modalità:

364 * **Modalità server**: Claude Code rinuncia dopo circa 10 minuti e il processo `claude remote-control` esce. Esegui di nuovo `claude remote-control` per avviare una nuova sessione.368 * **Modalità server**: Claude Code si arrende dopo circa 10 minuti e il processo `claude remote-control` esce. Eseguite `claude remote-control` di nuovo per avviare una nuova sessione.

365 * **Sessione interattiva**: continua a lavorare localmente. Claude Code continua a riprovare finché dura l'interruzione e si riconnette automaticamente quando la rete ritorna.369 * **Sessione interattiva**: continuate a lavorare localmente. Claude Code continua a riprovare finché dura l'interruzione e si ricollega automaticamente quando la rete ritorna.

366* **Heartbeat di presenza non riusciti**: se una sessione interattiva si disconnette con `could not reach the Remote Control server for about 30 minutes`, esegui `/remote-control` per riconnetterti. Claude Code mostra questo messaggio solo quando gli heartbeat di presenza della sessione non hanno funzionato mentre il resto della connessione è rimasto attivo; registra di nuovo la sessione per circa 30 minuti prima di disconnettersi.370* **Heartbeat di presenza non riusciti**: se una sessione interattiva si disconnette con `could not reach the Remote Control server for about 30 minutes`, eseguite `/remote-control` per riconnettervi.

367* **Dialoghi inoltrati scadono**: Claude Code mantiene aperti i prompt di autorizzazione e le domande `AskUserQuestion` finché non le rispondi. Quando Claude Code inoltra un altro tipo di dialogo alla sessione remota, come il prompt di scelta del modello mostrato dopo un rifiuto di sicurezza, attende cinque minuti per impostazione predefinita, quindi chiude il dialogo e continua con il valore predefinito senza azione del dialogo. Imposta [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry) per regolare o disabilitare la scadenza. Richiede Claude Code v2.1.224 o successivo.371* **I dialoghi inoltrati scadono**: Claude Code mantiene aperti i prompt di autorizzazione e le domande `AskUserQuestion` finché non le rispondete. Quando Claude Code inoltra un altro tipo di dialogo alla sessione remota, come il prompt di scelta del modello mostrato dopo un rifiuto di sicurezza, attende cinque minuti per impostazione predefinita, quindi chiude il dialogo e continua con il valore predefinito senza azione del dialogo. Impostare [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry) per regolare o disabilitare la scadenza. Richiede Claude Code v2.1.224 o successivo.

368* **Il prompt di consenso dei crediti di utilizzo Fable non viene inoltrato**: Claude Code mostra il prompt di consenso dei crediti di utilizzo [Fable](/docs/it/model-config#fable-and-usage-credits) a metà sessione solo dove viene eseguita la sessione, non sul tuo dispositivo. Quando la sessione viene eseguita in un terminale e nessuno lì risponde prima che Claude Code chiuda il prompt, il turno termina senza inviare la richiesta; vedi [Il prompt per confermare non ha ricevuto risposta](/docs/it/errors#the-prompt-to-confirm-went-unanswered).372* **Il prompt di consenso dei crediti di utilizzo di Fable non viene inoltrato**: Claude Code mostra il prompt di consenso dei crediti di utilizzo di [Fable](/docs/it/model-config#fable-and-usage-credits) a metà sessione solo dove la sessione viene eseguita, non sul vostro dispositivo. Quando la sessione viene eseguita in un terminale e nessuno lì risponde prima che Claude Code chiuda il prompt, il turno termina senza inviare la richiesta; vedere [The prompt to confirm went unanswered](/docs/it/errors#the-prompt-to-confirm-went-unanswered).

369* **Alcuni comandi sono solo locali**: i comandi che funzionano solo nell'interfaccia del terminale, come `/plugin` o `/resume`, funzionano solo dalla CLI locale, indipendentemente dal fatto che tu passi un argomento o meno. I seguenti funzionano da mobile e web:373* **Alcuni comandi sono solo locali**: i comandi che vengono eseguiti solo nell'interfaccia del terminale, come `/plugin` o `/resume`, funzionano solo dalla CLI locale, indipendentemente dal fatto che passiate un argomento o meno. I seguenti funzionano da mobile e web:

370 * Comandi con output di testo: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` e `/reload-plugins`. `/usage-credits` stampa l'URL di fatturazione invece di aprire un browser. `/reload-plugins` funziona solo quando la sessione viene eseguita in un terminale interattivo; una sessione senza uno lo rifiuta.374 * Comandi di output di testo: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` e `/reload-plugins`. `/usage-credits` stampa l'URL di fatturazione invece di aprire un browser. `/reload-plugins` funziona solo quando la sessione viene eseguita in un terminale interattivo; una sessione senza uno lo rifiuta.

371 * `/model`, `/effort`, `/fast`, `/color` e `/rename`: passa il valore come argomento, ad esempio `/model sonnet` o `/effort high`. Da mobile e web, `/model` e `/effort` accettano l'argomento al posto del selettore del terminale o del cursore.375 * `/model`, `/effort`, `/fast`, `/color` e `/rename`: passate il valore come argomento, ad esempio `/model sonnet` o `/effort high`. Da mobile e web, `/model` e `/effort` prendono l'argomento al posto del picker del terminale o del cursore.

372 * `/mcp`: dall'app mobile, restituisce un riepilogo testuale dello stato del server invece di aprire il selettore. Sul web, `/mcp` da solo apre una directory dei [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) invece di restituire il riepilogo. I sottocomandi `reconnect`, `enable` e `disable` [](/docs/it/commands#all-commands) funzionano da entrambi. A differenza della CLI locale, `/mcp reconnect` senza nome del server riconnette ogni server che ha avuto un errore o necessita autenticazione.376 * `/mcp`: dall'app mobile, restituisce un riepilogo di testo dello stato del server invece di aprire il picker. Sul web, `/mcp` da solo apre una directory dei [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) invece di restituire il riepilogo. I [sottocomandi](/docs/it/commands#all-commands) `reconnect`, `enable` e `disable` funzionano da entrambi. A differenza della CLI locale, `/mcp reconnect` senza un nome di server ricollega ogni server che ha fallito o ha bisogno di autenticazione.

373 * `/config`: dall'app mobile, passa `key=value` per impostare un'impostazione, o eseguilo senza argomenti per elencare le chiavi che puoi impostare. Sul web, `/config` apre la sezione Claude Code delle tue impostazioni, e ignora il testo dopo il comando.377 * `/config`: dall'app mobile, passate `key=value` per impostare un'impostazione, o eseguitelo senza argomento per elencare le chiavi che potete impostare. Sul web, `/config` apre invece la sezione Claude Code delle vostre impostazioni e ignora il testo dopo il comando.

374 * Su Team ed Enterprise, `/usage-credits` da mobile o web non invia una [richiesta di crediti di utilizzo al tuo amministratore](/docs/it/costs#add-usage-credits-to-your-subscription). L'invio richiede una conferma che appare solo nella CLI interattiva, quindi il comando ti dice di eseguirlo lì. Prima della v2.1.211, il modulo di testo inviava la richiesta senza conferma.378 * Su Team e Enterprise, `/usage-credits` da mobile o web non invia una [richiesta di crediti di utilizzo al vostro amministratore](/docs/it/costs#add-usage-credits-to-your-subscription). L'invio richiede una conferma che appare solo nella CLI interattiva, quindi il comando vi dice di eseguirlo lì invece.

375 * `/autocompact`, dalla v2.1.221: passa la dimensione della finestra come argomento, ad esempio `/autocompact 500k`. Senza argomenti, stampa la dimensione della finestra corrente come testo invece di aprire il dialogo che il comando mostra in una sessione di terminale.379 * `/autocompact`, da v2.1.221: passate la dimensione della finestra come argomento, ad esempio `/autocompact 500k`. Senza argomento, stampa la dimensione della finestra corrente come testo invece di aprire il dialogo che il comando mostra in una sessione di terminale.

376 * `/advisor`, dalla v2.1.260: passa il modello come argomento, ad esempio `/advisor opus`, o passa `off` per disattivare l'advisor. Entrambi i moduli si applicano solo alla sessione corrente e lasciano invariato il tuo valore predefinito salvato. Senza argomenti, stampa l'advisor corrente come testo invece di aprire il selettore.380 * `/advisor`, da v2.1.260: passate il modello come argomento, ad esempio `/advisor opus`, o passate `off` per disattivare l'advisor. Entrambi i moduli si applicano solo alla sessione corrente e lasciano il vostro valore predefinito salvato invariato. Senza argomento, stampa l'advisor corrente come testo invece di aprire il picker.

377 * `/output-style`, dalla v2.1.269: passa il nome dello stile come argomento, ad esempio `/output-style concise`, o eseguilo senza argomenti per elencare gli stili. Da mobile e web, puoi elencare e selezionare solo gli [stili incorporati](/docs/it/output-styles#built-in-output-styles). Per utilizzare uno [stile personalizzato](/docs/it/output-styles#create-a-custom-output-style), selezionalo nella sessione stessa.381 * `/output-style`, da v2.1.269: passate il nome dello stile come argomento, ad esempio `/output-style concise`, o eseguitelo senza argomento per elencare gli stili. Da mobile e web, potete elencare e selezionare solo gli [stili incorporati](/docs/it/output-styles#built-in-output-styles). Per utilizzare uno [stile personalizzato](/docs/it/output-styles#create-a-custom-output-style), selezionatelo nella sessione stessa.

382 * `/focus`, da v2.1.281: passate `on` o `off` come argomento, ad esempio `/focus on`, o eseguitelo senza argomento per attivare/disattivare la [visualizzazione focus](/docs/it/commands#all-commands). Entrambi i moduli si applicano solo alla sessione corrente e lasciano la vostra selezione salvata invariata.

378 383

379<h2 id="troubleshooting">384<h2 id="troubleshooting">

380 Risoluzione dei problemi385 Troubleshooting

381</h2>386</h2>

382 387

383<h3 id="remote-control-requires-a-claude-ai-subscription">388<h3 id="remote-control-requires-a-claude-ai-subscription">

384 "Remote Control requires a claude.ai subscription"389 "Remote Control requires a claude.ai subscription"

385</h3>390</h3>

386 391

387Non sei autenticato con un account claude.ai, oppure un'altra credenziale sta prendendo precedenza sul tuo accesso. Il messaggio assume una di queste forme:392Non sei connesso con un account claude.ai, oppure un'altra credenziale sta avendo la precedenza sul tuo accesso. Il messaggio assume una di queste forme:

388 393

389* Non connesso, da `/remote-control` o `--remote-control`: `Remote Control requires a claude.ai subscription.` o `/remote-control requires a claude.ai subscription.`394* Disconnesso, da `/remote-control` o `--remote-control`: `Remote Control requires a claude.ai subscription.` oppure `/remote-control requires a claude.ai subscription.`

390* Non connesso, da `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`395* Disconnesso, da `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`

391* Connesso, ma una chiave API o un token è in uso: `Remote Control requires claude.ai subscription auth.` seguito dalla credenziale in uso, come `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Un'impostazione `apiKeyHelper` e `ANTHROPIC_AUTH_TOKEN` sono denominate allo stesso modo.396* Connesso, ma una chiave API o un token è in uso: `Remote Control requires claude.ai subscription auth.` seguito dalla credenziale in uso, come `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Un'impostazione `apiKeyHelper` e `ANTHROPIC_AUTH_TOKEN` sono denominate allo stesso modo.

392 397

393Esegui `claude auth login` e scegli l'opzione claude.ai. Se il messaggio nomina `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, rimuovilo ovunque sia impostato: il tuo ambiente shell o il blocco `env` di un [file di impostazioni](/docs/it/settings-reference#env). Se nomina `apiKeyHelper`, rimuovi quella impostazione.398Esegui `claude auth login` e scegli l'opzione claude.ai. Se il messaggio nomina `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, rimuovilo ovunque sia impostato: nel tuo ambiente shell o nel blocco `env` di un [file di impostazioni](/docs/it/settings-reference#env). Se nomina `apiKeyHelper`, rimuovi quella impostazione.

~~394~~

395Prima della v2.1.206, l'esecuzione di `/remote-control` mentre non eri connesso segnalava `Unknown command: /remote-control` invece di questo messaggio.

396 399

397<h3 id="remote-control-requires-a-full-scope-login-token">400<h3 id="remote-control-requires-a-full-scope-login-token">

398 "Remote Control requires a full-scope login token"401 "Remote Control requires a full-scope login token"

410 "Remote Control isn't enabled for this account"413 "Remote Control isn't enabled for this account"

411</h3>414</h3>

412 415

413Claude Code ha verificato la disponibilità di Remote Control per l'account con cui sei autenticato e il controllo è risultato disabilitato. La causa più comune è la cache dei diritti che è obsoleta dopo un cambio di piano. Esegui `claude auth logout` quindi `claude auth login` per aggiornarli, e aggiorna Claude Code se stai utilizzando una versione precedente.416Claude Code ha verificato la disponibilità di Remote Control per l'account con cui sei connesso e il controllo è risultato disattivato. La causa più comune è la memorizzazione nella cache dei diritti che sono obsoleti dopo un cambio di piano. Esegui `claude auth logout` quindi `claude auth login` per aggiornarli, e aggiorna Claude Code se sei su una versione precedente.

414 417

415Esegui `claude doctor` per vedere quale controllo di idoneità individuale ha fallito. I conflitti delle variabili di ambiente, i controlli non raggiungibili e l'impostazione Remote Control della tua organizzazione producono ciascuno il proprio messaggio, quindi questo errore significa il controllo a livello di account stesso.418Esegui `claude doctor` per vedere quale controllo di idoneità individuale ha avuto esito negativo. I conflitti di variabili di ambiente, i controlli non raggiungibili e l'impostazione Remote Control della tua organizzazione producono ciascuno il proprio messaggio, quindi questo errore significa che il controllo a livello di account stesso.

416 419

417Prima della v2.1.239, questo messaggio diceva "Remote Control is not yet enabled for your account". Prima della v2.1.154, una variabile che disabilita la valutazione dei feature-flag, come `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, produceva anche questo messaggio; la voce "Remote Control requires feature-flag evaluation" di seguito copre quella configurazione.420Prima della v2.1.239, questo messaggio diceva "Remote Control is not yet enabled for your account".

418 421

419<h3 id="couldn’t-verify-remote-control-eligibility">422<h3 id="couldn’t-verify-remote-control-eligibility">

420 "Couldn't verify Remote Control eligibility"423 "Couldn't verify Remote Control eligibility"

421</h3>424</h3>

422 425

423Claude Code non ha potuto raggiungere il servizio di feature-flag per verificare se Remote Control è abilitato per il tuo account, in genere perché sei offline o un proxy sta bloccando la richiesta. Riprova una volta che hai accesso alla rete, oppure esegui `claude doctor` per i dettagli. Il messaggio correlato "Couldn't verify your organization's Remote Control policy" significa che Claude Code non ha potuto leggere quella politica, e ha la stessa soluzione. Entrambi i messaggi sono stati aggiunti nella v2.1.178.426Claude Code non ha potuto raggiungere il servizio feature-flag per verificare se Remote Control è abilitato per il tuo account, in genere perché sei offline o un proxy sta bloccando la richiesta. Riprova una volta che hai accesso alla rete, oppure esegui `claude doctor` per i dettagli. Il messaggio correlato "Couldn't verify your organization's Remote Control policy" significa che Claude Code ha riscontrato un errore nella lettura di quella policy, e ha la stessa soluzione.

424 427

425<h3 id="remote-control-requires-feature-flag-evaluation">428<h3 id="remote-control-requires-feature-flag-evaluation">

426 "Remote Control requires feature-flag evaluation"429 "Remote Control requires feature-flag evaluation"

427</h3>430</h3>

428 431

429Una di queste variabili è impostata: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, o `DISABLE_GROWTHBOOK`](/docs/it/env-vars). Ognuna di esse disabilita la valutazione dei feature-flag da cui dipende la disponibilità di Remote Control, e il messaggio completo nomina la variabile che Claude Code ha trovato. Annulla l'impostazione di quella variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco `env` di un [file `settings.json`](/docs/it/settings-reference#all-settings). Nelle versioni precedenti alla 2.1.154, la stessa configurazione produce "Remote Control is not yet enabled for your account" invece.432Una [variabile di ambiente](/docs/it/env-vars#features-that-need-feature-flag-fetching) che disattiva la valutazione feature-flag è impostata, e il messaggio completo nomina la variabile che Claude Code ha trovato. Nelle versioni precedenti alla 2.1.154, la stessa configurazione produce "Remote Control is not yet enabled for your account" invece. Cosa fare dipende dalla variabile che il messaggio nomina:

433

434* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK`**: annulla l'impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco `env` di un [file `settings.json`](/docs/it/settings-reference#all-settings).

435* **`DISABLE_TELEMETRY` o `DO_NOT_TRACK`**: su un piano Pro, Max, Team o Enterprise con `DISABLE_GROWTHBOOK` non impostato, queste variabili lasciano Remote Control disponibile a meno che la tua organizzazione non richieda [Trusted Devices](#trusted-devices). Se lo richiede, annulla l'impostazione della variabile ovunque sia impostata per utilizzare Remote Control. Dalla v2.1.154 alla v2.1.282, una delle due variabili ha prodotto questo messaggio, quindi aggiorna Claude Code alla v2.1.283 o successiva.

430 436

431<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">437<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">

432 "Remote Control is only available when using Claude via api.anthropic.com"438 "Remote Control is only available when using Claude via api.anthropic.com"

433</h3>439</h3>

434 440

435La sessione non sta comunicando direttamente con l'API Anthropic, quindi non c'è alcun backend claude.ai con cui associarsi. Questo accade su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Accade anche quando [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) punta a un host diverso da `api.anthropic.com`, come un [gateway LLM](/docs/it/llm-gateway) o proxy, anche se accedi con claude.ai. Prima della v2.1.196, Claude Code non mostrava questo messaggio per un `ANTHROPIC_BASE_URL` personalizzato. Vedi il [riferimento degli errori](/docs/it/errors#remote-control-requires-the-anthropic-api) per l'elenco completo delle cause.441La sessione non sta comunicando direttamente con l'API Anthropic, quindi non c'è alcun backend claude.ai con cui associarsi. Questo accade su Amazon Bedrock, su Google Cloud's Agent Platform e su Microsoft Foundry. Accade anche quando [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) punta a un host diverso da `api.anthropic.com`, come un [LLM gateway](/docs/it/llm-gateway) o proxy, anche se accedi con claude.ai. Vedi il [riferimento degli errori](/docs/it/errors#remote-control-requires-the-anthropic-api) per l'elenco completo delle cause.

436 442

437Il messaggio nomina cosa ha instradato la sessione lontano dall'API Anthropic, come `CLAUDE_CODE_USE_BEDROCK` o un `ANTHROPIC_BASE_URL` personalizzato. Se hai un accesso claude.ai idoneo, annulla l'impostazione della variabile denominata, rimuovila dalla chiave `env` nelle [impostazioni](/docs/it/settings) se l'hai impostata lì, e riavvia la sessione. Prima della v2.1.219, il messaggio era solo la frase nell'intestazione di questa sezione, quindi nelle versioni precedenti controlla il tuo ambiente stesso per le variabili del provider come `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, e per `ANTHROPIC_BASE_URL`.443Il messaggio nomina ciò che ha instradato la sessione lontano dall'API Anthropic, come `CLAUDE_CODE_USE_BEDROCK` o un `ANTHROPIC_BASE_URL` personalizzato. Se hai un accesso claude.ai idoneo, annulla l'impostazione della variabile denominata, rimuovila dalla chiave `env` nelle [impostazioni](/docs/it/settings) se l'hai impostata lì, e riavvia la sessione.

438 444

439<h3 id="remote-control-is-disabled-by-your-organization’s-policy">445<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

440 "Remote Control is disabled by your organization's policy"446 "Remote Control is disabled by your organization's policy"

441</h3>447</h3>

442 448

443Una politica blocca Remote Control, oppure Claude Code non ha potuto caricare la politica della tua organizzazione su questa macchina e mantiene Remote Control disabilitato nel frattempo. Controlla queste cause in ordine:449Una policy blocca Remote Control. Controlla queste cause in ordine:

444 450

445* **L'errore menziona `disableRemoteControl`**: il tuo amministratore IT ha disabilitato Remote Control su questo dispositivo tramite [impostazioni gestite](/docs/it/managed-settings), indipendentemente dall'interruttore a livello di organizzazione e da come sei autenticato.451* **L'errore menziona `disableRemoteControl`**: il tuo amministratore IT ha disabilitato Remote Control su questo dispositivo tramite [impostazioni gestite](/docs/it/managed-settings), indipendentemente dall'interruttore a livello di organizzazione e da come sei connesso.

446* **Il tuo piano claude.ai è Pro o Max**: Claude Code è ancora autenticato con un'organizzazione Team o Enterprise da un accesso precedente, quindi controlla la politica Remote Control di quell'organizzazione. Esegui `/status` per vedere quale piano e organizzazione usa il tuo accesso. Esegui `claude auth logout` quindi `claude auth login` per accedere di nuovo con il tuo piano attuale.452* **Il tuo piano claude.ai è Pro o Max**: Claude Code è ancora connesso con un'organizzazione Team o Enterprise da un accesso precedente, quindi controlla la policy Remote Control di quell'organizzazione. Esegui `/status` per vedere quale piano e organizzazione utilizza il tuo accesso. Esegui `claude auth logout` quindi `claude auth login` per accedere di nuovo con il tuo piano attuale.

447* **La politica dell'organizzazione non è stata caricata su questa macchina**: esegui `claude doctor` e leggi la riga `Organization policy`. Se la riga mostra che la politica non è caricata, è quello che mantiene Remote Control disabilitato. Prima della v2.1.261, `claude doctor` non stampava questa riga.453* **Il messaggio non dice di contattare l'amministratore della tua organizzazione**: la tua organizzazione ha una configurazione HIPAA che è incompatibile con Remote Control, e `/status` elenca `HIPAA` nella sua riga `Compliance`. In questo stato l'interruttore Remote Control del pannello di amministrazione è disattivato, quindi un Owner non può modificarlo lì. Contatta il supporto Anthropic per discutere le opzioni. Prima della v2.1.267, questo caso mostrava "Remote Control isn't available for your organization due to its compliance policy" invece.

448* **Il messaggio non dice di contattare l'amministratore della tua organizzazione**: la tua organizzazione ha una configurazione HIPAA incompatibile con Remote Control, e `/status` elenca `HIPAA` nella sua riga `Compliance`. In questo stato l'interruttore Remote Control del pannello di amministrazione è disattivato, quindi un Owner non può modificarlo lì. Contatta il supporto Anthropic per discutere le opzioni. Prima della v2.1.267, questo caso mostrava "Remote Control isn't available for your organization due to its compliance policy" invece.454* **Altrimenti, un Owner non l'ha abilitato per la tua organizzazione**: Remote Control è disattivato per impostazione predefinita sui piani Team e Enterprise. Un Owner può abilitarlo su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) attivando l'interruttore **Remote Control**. Questo interruttore è un'impostazione dell'organizzazione lato server.

449* **Altrimenti, un Owner non l'ha abilitato per la tua organizzazione**: Remote Control è disabilitato per impostazione predefinita su piani Team e Enterprise. Un Owner può abilitarlo su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) attivando l'interruttore **Remote Control**. Questo interruttore è un'impostazione organizzativa lato server.455

456Prima della v2.1.281, questo messaggio appariva anche quando Claude Code non aveva caricato la policy della tua organizzazione su questa macchina, ad esempio dopo l'avvio offline. Le versioni successive segnalano quello stato come [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) invece.

457

458<h3 id="couldnt-verify-your-organizations-policy-for-remote-control">

459 "Couldn't verify your organization's policy for remote control"

460</h3>

461

462Claude Code non ha potuto recuperare la policy della tua organizzazione e non ha una copia salvata su questa macchina da utilizzare invece, quindi mantiene Remote Control disattivato finché non può confermare che la tua organizzazione lo consente. Questo di solito accade quando avvii Claude Code offline o prima che una VPN si connetta, oppure quando un proxy interferisce con la richiesta. Su una connessione lenta può anche apparire mentre la prima richiesta è ancora in corso.

463

464Il messaggio assume una di queste forme:

465

466* Da `/remote-control`, `claude remote-control`, o `claude --remote-control`: `Couldn't verify your organization's policy for remote control. Check your network connection and try again.`

467* Da [auto-connect](#enable-remote-control-for-all-sessions) quando una sessione inizia: `couldn't verify your organization's policy — check your network connection and try again`, preceduto da `Remote Control failed` nella notifica e `Remote Control disconnected` nella conversazione. La sessione quindi lascia Remote Control disattivato.

468

469Ripristina la tua connessione di rete, quindi esegui `/remote-control` o esegui di nuovo il comando. Ogni tentativo controlla di nuovo la policy, quindi non hai bisogno di riavviare Claude Code. Se il messaggio continua ad apparire, esegui `claude doctor` e leggi la sua riga `Organization policy`, che dice perché la policy non ha caricato.

470

471Prima della v2.1.281, questo stato mostrava `Remote Control is disabled by your organization's policy` invece.

450 472

451<h3 id="remote-credentials-fetch-failed">473<h3 id="remote-credentials-fetch-failed">

452 "Remote credentials fetch failed"474 "Remote credentials fetch failed"

460 482

461Cause comuni:483Cause comuni:

462 484

463* Non sei connesso: esegui `claude` e utilizza `/login` per autenticarti con il tuo account claude.ai. L'autenticazione con chiave API non è supportata per Remote Control.485* Non connesso: esegui `claude` e usa `/login` per autenticarti con il tuo account claude.ai. L'autenticazione tramite chiave API non è supportata per Remote Control.

464* Problema di rete o proxy: un firewall o proxy potrebbe bloccare la richiesta HTTPS in uscita. Remote Control richiede l'accesso all'API Anthropic sulla porta 443.486* Problema di rete o proxy: un firewall o proxy potrebbe bloccare la richiesta HTTPS in uscita. Remote Control richiede l'accesso all'API Anthropic sulla porta 443.

465* Creazione della sessione non riuscita: se vedi anche `Session creation failed — see debug log`, l'errore si è verificato in precedenza nella configurazione. Verifica che il tuo abbonamento sia attivo.487* Creazione della sessione non riuscita: se vedi anche `Session creation failed — see debug log`, l'errore è accaduto prima nella configurazione. Verifica che il tuo abbonamento sia attivo.

~~466~~

467Un token di accesso obsoleto non causa questo errore. Quando l'API Anthropic rifiuta il token salvato, ad esempio perché un altro processo Claude Code l'ha già aggiornato, Claude Code aggiorna il token e riprova da solo. Prima della v2.1.224, un token obsoleto non riusciva ad avviare Remote Control con questo messaggio, quindi le sessioni impostate per [connettersi automaticamente](#enable-remote-control-for-all-sessions) potevano non riuscire intermittentemente all'avvio.

468 488

469<h3 id="couldn’t-reconnect-to-your-remote-control-session">489<h3 id="couldnt-reconnect-to-your-remote-control-session">

470 "Couldn't reconnect to your Remote Control session"490 "Couldn't reconnect to your Remote Control session"

471</h3>491</h3>

472 492

473Quando riprendi una conversazione con `claude --resume` o `claude --continue`, Claude Code si riconnette alla sessione Remote Control registrata in quella conversazione. Questo messaggio significa che la riconnessione non è riuscita per un motivo che potrebbe essere temporaneo, come un'interruzione di rete o un errore del server, quindi Claude Code non può confermare se la sessione remota esiste ancora.493Quando riprendi una conversazione con `claude --resume` o `claude --continue`, Claude Code si riconnette alla sessione Remote Control registrata in quella conversazione. Questo messaggio significa che la riconnessione non è riuscita per un motivo che potrebbe essere temporaneo, come un'interruzione di rete o un errore del server, quindi Claude Code non può confermare se la sessione remota esiste ancora.

474 494

475Esegui `/remote-control` per riprovare la connessione, o avvia una nuova sessione con `claude --remote-control` per creare una nuova sessione Remote Control. La tua sessione locale continua a funzionare senza Remote Control nel frattempo.495Esegui `/remote-control` per riprovare la connessione, oppure avvia una nuova sessione con `claude --remote-control` per creare una nuova sessione Remote Control. La tua sessione locale continua a funzionare senza Remote Control nel frattempo.

~~476~~

477<span id="resume-outcomes" />Quando riprendi, puoi anche ottenere uno di questi risultati invece di questo messaggio:

~~478~~

479* **Il server segnala che la sessione registrata è scomparsa, oppure il record di riconnessione nomina un account diverso**: Claude Code si basa su quello che dice il record di riconnessione della conversazione:

480 * **Il record nomina il tuo account autenticato**: Claude Code avvia una sessione sostitutiva con un nome generato automaticamente e lascia i messaggi precedenti della conversazione fuori da essa. Ottieni questo dopo aver eliminato la sessione da claude.ai o dall'app Claude, ad esempio.

481 * **Il record nomina un account diverso**: Claude Code avvia una nuova sessione senza i messaggi precedenti della conversazione e senza mostrare un messaggio, indipendentemente dal fatto che la sessione registrata esista ancora.

482 * **Il record non dice quale account possedeva la sessione, oppure Claude Code non può leggere il tuo accesso salvato**: Claude Code mostra [`Previous session is unavailable — run /remote-control to start a new one`](#previous-session-is-unavailable) invece di questo messaggio, non avvia nulla, e rimuove il record dalla conversazione.

483* **Hai disattivato Remote Control prima di riprendere**: a meno che l'app che ospita Claude Code non gli abbia detto che l'app possiede la sessione claude.ai, Claude Code ha rimosso il record di riconnessione quando hai disattivato Remote Control dal [pannello di stato](#check-connection-status) della CLI, dall'estensione VS Code, o da un host costruito su [Agent SDK](/docs/it/agent-sdk/overview), quindi non si riconnette. Quando un'app proprietaria l'ha disattivato, Claude Code ha mantenuto il record e si riconnette.

484* **Un altro Claude Code su questa macchina ha ancora la sessione**: vedi un avviso che inizia con `Remote Control not started here`, e Claude Code [lascia Remote Control disabilitato nella sessione ripresa](#resume-sessions-after-stopping-the-server). Esegui `/remote-control` lì per spostarlo.

~~485~~

486<span id="reconnect-history" />Prima della v2.1.232, Claude Code ha risposto diversamente quando il server ha segnalato che la sessione registrata era scomparsa. Dalla v2.1.227 alla v2.1.231, Claude Code ha rifiutato di avviare una sostituzione anche quando il record corrispondeva al tuo account. Fino alla v2.1.226, Claude Code ha avviato una sostituzione indipendentemente dal fatto che il record corrispondesse al tuo account, e nella v2.1.224 fino alla v2.1.226 l'ha creata con l'account autenticato su quella macchina, mai con un altro account, senza caricare i messaggi precedenti della conversazione su di essa. Prima della v2.1.200, Claude Code ha creato una nuova sessione dopo qualsiasi errore di riconnessione.

487 496

488<h3 id="previous-session-is-unavailable">497<h3 id="previous-session-is-unavailable">

489 "Previous session is unavailable — run /remote-control to start a new one"498 "Previous session is unavailable — run /remote-control to start a new one"

490</h3>499</h3>

491 500

492Claude Code non ha potuto ripristinare la sessione Remote Control precedente e si è fermato invece di avviare una nuova da solo. Puoi vedere questo messaggio dopo aver ripreso una conversazione con `claude --resume` o `claude --continue`, oppure dopo che Claude Code [si è riconnesso da solo dopo una disconnessione](/docs/it/errors#remote-control-couldnt-refresh-your-login).501Claude Code non ha potuto ripristinare la sessione Remote Control precedente e si è fermato invece di avviarne una nuova da solo. Puoi vedere questo messaggio dopo aver ripreso una conversazione con `claude --resume` o `claude --continue`, oppure dopo che Claude Code [si è riconnesso da solo dopo una disconnessione](/docs/it/errors#remote-control-couldnt-refresh-your-login).

~~493~~

494Esegui `/remote-control` per avviare una nuova sessione Remote Control con l'accesso attuale; la tua sessione locale continua a funzionare senza Remote Control nel frattempo. Il messaggio correlato `Remote Control could not verify the signed-in account — run /remote-control to reconnect` ha la stessa soluzione; Claude Code lo mostra quando l'account autenticato è cambiato o non poteva essere letto tra la sua convalida e la riconnessione. Se esegui `/remote-control` dopo `Previous session is unavailable` senza riavviare Claude Code prima, Claude Code lascia i messaggi precedenti della conversazione fuori dalla nuova sessione.

495 502

496Al ripristino, Claude Code [avvia una nuova sessione al suo posto](#resume-outcomes) solo se il record di riconnessione della conversazione nomina l'account che possedeva la sessione, perché il server segnala una sessione che hai eliminato e una sessione posseduta da un altro account allo stesso modo. Claude Code prima della v2.1.227 non ha registrato quell'account, e Claude Code non può controllare il record quando non può leggere il tuo accesso salvato. Claude Code prima della v2.1.232 mostrava `Remote Control could not resume the previous session under the current login — run /remote-control to start fresh` invece, in [un diverso insieme di casi](#reconnect-history).503Esegui `/remote-control` per avviare una nuova sessione Remote Control con l'accesso attuale; la tua sessione locale continua a funzionare senza Remote Control nel frattempo. Il messaggio correlato `Remote Control could not verify the signed-in account — run /remote-control to reconnect` ha la stessa soluzione. Se esegui `/remote-control` dopo `Previous session is unavailable` senza riavviare Claude Code prima, Claude Code lascia i messaggi precedenti della conversazione fuori dalla nuova sessione.

497 504

498<h3 id="remote-control-got-an-unexpected-server-response">505<h3 id="remote-control-got-an-unexpected-server-response">

499 "Remote Control got an unexpected server response"506 "Remote Control got an unexpected server response"

500</h3>507</h3>

501 508

502Il server Remote Control ha accettato una richiesta ma ha risposto in una forma che questa versione di Claude Code non poteva leggere, durante la creazione della sessione remota o il recupero delle sue credenziali. Riprovare sulla stessa versione fallisce allo stesso modo. Esegui `claude update`, quindi esegui `/remote-control` per riconnetterti. Questo messaggio è stato aggiunto nella v2.1.225.509Il server Remote Control ha accettato una richiesta ma ha risposto in una forma che questa versione di Claude Code non poteva leggere, durante la creazione della sessione remota o il recupero delle sue credenziali. Riprovare sulla stessa versione fallisce allo stesso modo. Esegui `claude update`, quindi esegui `/remote-control` per riconnetterti.

503 510

504<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">511<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

505 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"512 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

506</h3>513</h3>

507 514

508La tua organizzazione ha [Trusted Devices](#trusted-devices) abilitato e questa macchina non si è ancora registrata. Esegui `/login` in Claude Code. La registrazione avviene come parte dell'accesso, e non c'è un comando di registrazione separato.515La tua organizzazione ha [Trusted Devices](#trusted-devices) abilitato e questa macchina non si è ancora iscritta. Esegui `/login` in Claude Code. L'iscrizione avviene come parte dell'accesso, e non c'è alcun comando di iscrizione separato.

509 516

510<h3 id="session-expired-for-trusted-device-check">517<h3 id="session-expired-for-trusted-device-check">

511 "session expired for trusted-device check"518 "session expired for trusted-device check"

512</h3>519</h3>

513 520

514Il tuo accesso è più vecchio di 18 ore. Esegui `/login` in Claude Code, o conferma con Face ID, Touch ID, Windows Hello, o una passkey quando claude.ai o l'app mobile te lo chiede. Vedi [Trusted Devices](#trusted-devices).521Il tuo accesso è più vecchio di 18 ore. Esegui `/login` in Claude Code, oppure conferma con Face ID, Touch ID, Windows Hello, o una passkey quando claude.ai o l'app mobile te lo chiede. Vedi [Trusted Devices](#trusted-devices).

~~515~~

516<h2 id="choose-the-right-approach">

517 Scegli l'approccio giusto

518</h2>

~~519~~

520Claude Code offre diversi modi di lavorare quando non sei al tuo terminale. Differiscono in ciò che attiva il lavoro, dove Claude viene eseguito e quanto setup è necessario.

~~521~~

523| :- | :- | :- | :- | :- |

525| [Remote Control](/docs/it/remote-control) | Guida una sessione in esecuzione da [claude.ai/code](https://claude.ai/code) o dall'app mobile Claude | La tua macchina (CLI o VS Code) | Esegui `claude remote-control` | Guidare il lavoro in corso da un altro dispositivo |

526| [Channels](/docs/it/channels) | Invia eventi da un'app di chat come Telegram o Discord, o dal tuo server | La tua macchina (CLI) | [Installa un plugin channel](/docs/it/channels#quickstart) o [crea il tuo](/docs/it/channels-reference) | Reagire a eventi esterni come errori CI o messaggi di chat |

527| [Slack](/docs/it/slack) | Menziona `@Claude` in un canale del team | Cloud Anthropic | [Installa l'app Slack](/docs/it/slack#setting-up-claude-code-in-slack) con [Claude Code sul web](/docs/it/claude-code-on-the-web) abilitato | PR e revisioni dalla chat del team |

528| [Self-hosted environments](/docs/it/self-hosted-environments) | Avvia una [sessione cloud](/docs/it/claude-code-on-the-web) e scegli l'ambiente della tua organizzazione | L'infrastruttura della tua organizzazione | [Distribuisci runner](/docs/it/self-hosted-environments-quickstart), su piani Team e Enterprise | Sessioni cloud che devono essere eseguite all'interno della tua rete |

530 522

531<h2 id="related-resources">523<h2 id="related-resources">

532 Risorse correlate524 Risorse correlate

routines.md +3 −2

Details

59Quando la pianificazione della routine o **Run now** avvia un'esecuzione, Claude ripubblica un artifact esistente senza chiedere solo quando tutti questi elementi sono veri:59Quando la pianificazione della routine o **Run now** avvia un'esecuzione, Claude ripubblica un artifact esistente senza chiedere solo quando tutti questi elementi sono veri:

60 60

61* Puoi modificare l'artifact e appartiene alla tua organizzazione61* Puoi modificare l'artifact e appartiene alla tua organizzazione

~~62* L'artifact non è condiviso pubblicamente e non è condiviso con persone specifiche o la tua organizzazione con l'ultima versione scelta come versione che i visualizzatori vedono~~62* L'artifact non è condiviso pubblicamente

63* Se l'artifact è condiviso con persone specifiche o la tua organizzazione, i suoi visualizzatori non vedono automaticamente ogni nuova versione

63* La pubblicazione contiene solo la pagina, senza file di supporto o altro aggiunto, e non forza una versione più recente64* La pubblicazione contiene solo la pagina, senza file di supporto o altro aggiunto, e non forza una versione più recente

64* La pagina non contiene alcun grant che vada oltre la pagina, come [connector calls](/docs/it/artifacts#pull-live-data-with-mcp-connectors)65* La pagina non contiene alcun grant che vada oltre la pagina, come [connector calls](/docs/it/artifacts#pull-live-data-with-mcp-connectors)

65 66

151 152

152Un trigger di pianificazione esegue la routine su una cadenza ricorrente, o una sola volta a un momento futuro specifico. Scegli una frequenza preimpostata nella sezione **Select a trigger**: oraria, giornaliera, giorni feriali o settimanale. I tempi vengono inseriti nella tua zona locale e convertiti automaticamente, quindi la routine viene eseguita a quell'ora di parete indipendentemente da dove si trova l'infrastruttura cloud.153Un trigger di pianificazione esegue la routine su una cadenza ricorrente, o una sola volta a un momento futuro specifico. Scegli una frequenza preimpostata nella sezione **Select a trigger**: oraria, giornaliera, giorni feriali o settimanale. I tempi vengono inseriti nella tua zona locale e convertiti automaticamente, quindi la routine viene eseguita a quell'ora di parete indipendentemente da dove si trova l'infrastruttura cloud.

153 154

154Le esecuzioni possono iniziare alcuni minuti dopo l'ora pianificata a causa dello sfasamento. L'offset è coerente per ogni routine.155Se pianifichi un'esecuzione esattamente all'ora, ad esempio le 9:00, potrebbe iniziare alcuni minuti dopo. Per iniziare vicino all'ora pianificata, scegli alcuni minuti dopo l'ora, ad esempio le 9:07.

155 156

156Per un intervallo personalizzato come ogni due ore o il primo di ogni mese, scegli il preset più vicino nel modulo, quindi esegui `/schedule update` nella CLI per impostare un'espressione cron specifica. L'intervallo minimo è un'ora; le espressioni che vengono eseguite più frequentemente vengono rifiutate.157Per un intervallo personalizzato come ogni due ore o il primo di ogni mese, scegli il preset più vicino nel modulo, quindi esegui `/schedule update` nella CLI per impostare un'espressione cron specifica. L'intervallo minimo è un'ora; le espressioni che vengono eseguite più frequentemente vengono rifiutate.

157 158

sandbox-environments.md +1 −1

Details

117Su Linux e WSL2, il runtime applica i permessi di scrittura solo ai percorsi che già esistono. In un ambiente nuovo, crea i percorsi di configurazione di Claude Code prima del primo avvio:117Su Linux e WSL2, il runtime applica i permessi di scrittura solo ai percorsi che già esistono. In un ambiente nuovo, crea i percorsi di configurazione di Claude Code prima del primo avvio:

118 118

119```bash theme={null}119```bash theme={null}

120mkdir -p ~/.claude && echo '{}' > ~/.claude.json120mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }

121```121```

122 122

123Una volta che il file di impostazioni è in posizione, avvia Claude Code con `npx` e passa `claude` come comando da avvolgere:123Una volta che il file di impostazioni è in posizione, avvia Claude Code con `npx` e passa `claude` come comando da avvolgere:

sandboxing.md +1 −1

Details

42 </Step>42 </Step>

43 43

44 <Step title="Esegui un comando Bash">44 <Step title="Esegui un comando Bash">

45 Chiedi a Claude di eseguire un comando, come una build o una suite di test. Per impostazione predefinita, i comandi all'interno della sandbox possono scrivere nella directory di lavoro, nella directory temporanea della sessione e in qualsiasi [directory che hai aggiunto](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) con `--add-dir`, `/add-dir` o `permissions.additionalDirectories`.45 Chiedi a Claude di eseguire un comando, come una build o una suite di test. Per impostazione predefinita, i comandi all'interno della sandbox possono scrivere nella directory di lavoro, in una [directory temporanea per utente](/docs/it/env-vars), e in qualsiasi [directory che hai aggiunto](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) con `--add-dir`, `/add-dir` o `permissions.additionalDirectories`.

46 46

47 La prima volta che un comando ha bisogno di un nuovo dominio di rete, Claude Code richiede l'approvazione; in [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), Claude invece nomina gli host di cui un comando ha bisogno [sul comando stesso](#per-command-allowed-domains-in-auto-mode) affinché il classificatore li esamini insieme ad esso.47 La prima volta che un comando ha bisogno di un nuovo dominio di rete, Claude Code richiede l'approvazione; in [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), Claude invece nomina gli host di cui un comando ha bisogno [sul comando stesso](#per-command-allowed-domains-in-auto-mode) affinché il classificatore li esamini insieme ad esso.

48 48

security.md +5 −4

Details

124 Sicurezza dell'esecuzione nel cloud124 Sicurezza dell'esecuzione nel cloud

125</h2>125</h2>

126 126

127Quando si utilizza [Claude Code sul web](/docs/it/claude-code-on-the-web), sono in vigore controlli di sicurezza aggiuntivi. Le sessioni che la vostra organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sulla vostra infrastruttura, dove l'isolamento, l'uscita di rete e le credenziali git sono responsabilità della vostra distribuzione. Negli ambienti ospitati da Anthropic:127Quando si utilizza [sessioni cloud](/docs/it/claude-code-on-the-web), sono in vigore controlli di sicurezza aggiuntivi. Le sessioni che la vostra organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sulla vostra infrastruttura, dove l'isolamento, l'uscita di rete e le credenziali git sono responsabilità della vostra distribuzione. Negli ambienti ospitati da Anthropic:

128 128

129* **Macchine virtuali isolate**: Ogni sessione cloud viene eseguita in una VM isolata gestita da Anthropic129* **Macchine virtuali isolate**: Ogni sessione cloud viene eseguita in una VM isolata gestita da Anthropic

130* **Controlli di accesso alla rete**: L'accesso alla rete è limitato per impostazione predefinita e può essere configurato per essere disabilitato o consentire solo domini specifici130* **Controlli di accesso alla rete**: L'accesso alla rete è limitato per impostazione predefinita e può essere configurato per essere disabilitato o consentire solo domini specifici

131* **Protezione delle credenziali**: L'autenticazione viene gestita tramite un proxy sicuro che utilizza una credenziale con ambito all'interno della sandbox, che viene quindi tradotta nel vostro token di autenticazione GitHub effettivo131* **Protezione delle credenziali**: Le credenziali GitHub sono archiviate crittografate sui server di Anthropic e non entrano mai nella VM della sessione. La VM contiene una credenziale di breve durata con ambito a quella sessione, e il traffico GitHub passa attraverso un [proxy Anthropic](/docs/it/cloud-environments#github-proxy) che allega la credenziale GitHub sul lato server. Vedere [Opzioni di autenticazione GitHub](/docs/it/claude-code-on-the-web#github-authentication-options) per come si concede l'accesso

132* **Restrizioni di ramo**: Le operazioni di push Git sono limitate al ramo di lavoro corrente132* **Restrizioni di ramo**: Le operazioni di push Git sono limitate al ramo di lavoro corrente

133* **Registrazione di audit**: Tutte le operazioni nelle sessioni cloud vengono registrate per scopi di conformità e audit133* **Registrazione di audit**: Tutte le operazioni nelle sessioni cloud vengono registrate per scopi di conformità e audit

134* **Pulizia automatica**: Le VM della sessione vengono recuperate dopo un periodo di inattività134* **Pulizia automatica**: Le VM della sessione vengono recuperate dopo un periodo di inattività

135* **Eliminazione**: È possibile [eliminare una sessione](/docs/it/claude-code-on-the-web#delete-sessions) in qualsiasi momento. Vedere [Flusso di dati dell'esecuzione nel cloud](/docs/it/data-usage#cloud-execution-data-flow-and-dependencies) per ciò che Anthropic archivia per una sessione cloud

135 136

136Per ulteriori dettagli sull'esecuzione nel cloud, vedere [Claude Code sul web](/docs/it/claude-code-on-the-web); per configurare l'accesso alla rete per le sessioni cloud, vedere [Configurare ambienti cloud](/docs/it/cloud-environments#network-access).137Per ulteriori dettagli sull'esecuzione nel cloud, vedere [Utilizzare Claude Code nel cloud](/docs/it/claude-code-on-the-web); per configurare l'accesso alla rete per le sessioni cloud, vedere [Configurare ambienti cloud](/docs/it/cloud-environments#network-access).

137 138

138Le sessioni di [Remote Control](/docs/it/remote-control) funzionano diversamente: l'interfaccia web si connette a un processo Claude Code in esecuzione sulla vostra macchina locale. Tutta l'esecuzione del codice e l'accesso ai file rimangono locali, e il traffico della sessione viaggia attraverso l'API Anthropic su TLS; mentre connessi, la trascrizione della sessione viene archiviata sui server Anthropic per sincronizzare la conversazione tra i dispositivi, come descritto in [Connessione e sicurezza](/docs/it/remote-control#connection-and-security). Non sono coinvolte VM cloud o sandbox. La connessione utilizza più credenziali di breve durata e con ambito ristretto, ciascuna limitata a uno scopo specifico e con scadenza indipendente, per limitare il raggio di esplosione di qualsiasi singola credenziale compromessa.139Le sessioni di [Remote Control](/docs/it/remote-control) funzionano diversamente: l'interfaccia web si connette a un processo Claude Code in esecuzione sulla vostra macchina locale. Tutta l'esecuzione del codice e l'accesso ai file rimangono locali, e il traffico della sessione viaggia attraverso l'API Anthropic su TLS; mentre connessi, la trascrizione della sessione viene archiviata sui server Anthropic per sincronizzare la conversazione tra i dispositivi, come descritto in [Connessione e sicurezza](/docs/it/remote-control#connection-and-security). Non sono coinvolte VM cloud o sandboxing. La connessione utilizza più credenziali di breve durata e con ambito ristretto, ciascuna limitata a uno scopo specifico e con scadenza indipendente, per limitare il raggio di esplosione di qualsiasi singola credenziale compromessa.

139 140

140<h2 id="security-best-practices">141<h2 id="security-best-practices">

141 Migliori pratiche di sicurezza142 Migliori pratiche di sicurezza

self-hosted-environments-deploy.md +6 −2

Details

220ENTRYPOINT ["claude"]220ENTRYPOINT ["claude"]

221```221```

222 222

223Scambia `linux-x64` con `linux-arm64` se i tuoi nodi sono ARM, o con `linux-x64-musl` o `linux-arm64-musl` su un'immagine basata su musl come Alpine; vedi [Configurazione Alpine Linux](/docs/it/setup#alpine-linux-and-musl-based-distributions) per i pacchetti extra di cui le immagini musl hanno bisogno. L'URL è la posizione di rilascio standard di Claude Code, quindi puoi verificare il binario scaricato rispetto al manifesto firmato del rilascio come descritto in [Integrità binaria e firma del codice](/docs/it/setup#binary-integrity-and-code-signing). Costruisci l'immagine con Claude Code versione 2.1.224 o successiva, quindi spingila al tuo registro e fai riferimento ad essa nelle ricette di seguito:223Scambia `linux-x64` con `linux-arm64` se i tuoi nodi sono ARM, o con `linux-x64-musl` o `linux-arm64-musl` su un'immagine basata su musl come Alpine; vedi [Configurazione Alpine Linux](/docs/it/setup#alpine-linux-and-musl-based-distributions) per i pacchetti extra di cui le immagini musl hanno bisogno. L'URL è la posizione di rilascio standard di Claude Code, quindi puoi verificare il binario scaricato rispetto al manifesto firmato del rilascio come descritto in [Integrità binaria e firma del codice](/docs/it/setup#binary-integrity-and-code-signing). Il runner richiede Claude Code versione 2.1.224 o successiva. Costruisci l'immagine, quindi spingila al tuo registro e fai riferimento ad essa nelle ricette di seguito:

224 224

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .226docker build \

227 --build-arg CLAUDE_CODE_VERSION="$(curl -fsSL https://downloads.claude.ai/claude-code-releases/stable)" \

228 -t <your-registry>/claude-runner:latest .

227```229```

228 230

231La sostituzione di comando cerca il numero di rilascio `stable` corrente e lo passa come argomento di build, quindi eseguire lo stesso comando dopo un nuovo rilascio stabile ricostruisce il livello di download con il binario più recente. Per fissare un rilascio specifico per build riproducibili, passa il numero di versione direttamente come `CLAUDE_CODE_VERSION`. Sostituisci `stable` con `latest` nell'URL di ricerca quando hai bisogno di un rilascio più recente del canale stabile, come uno che [un modello appena lanciato richiede](/docs/it/model-config).

232

229<h2 id="size-cpu-and-memory-for-sessions">233<h2 id="size-cpu-and-memory-for-sessions">

230 Dimensiona CPU e memoria per le sessioni234 Dimensiona CPU e memoria per le sessioni

231</h2>235</h2>

server-managed-settings.md +14 −5

Details

171* **Il blocco `env`**: a parte l'unità di telemetria e le variabili di routing associate a una chiave di credenziale, entrambe coperte di seguito, si unisce per chiave tra le fonti controllate dall'amministratore. Per ogni variabile di ambiente, la fonte con la priorità più alta che la definisce vince, e le fonti amministrative inferiori riempiono le variabili che le fonti superiori lasciano non impostate. Una voce `env` gestita dall'endpoint si applica quindi ogni volta che la configurazione gestita dal server lascia quella variabile non impostata, o mentre un valore server memorizzato nella cache per essa è [trattenuto in sospeso della conferma del server](#fetch-and-caching-behavior). Richiede Claude Code v2.1.223 o successivo. Prima della v2.1.223, Claude Code applica solo il blocco `env` della fonte selezionata.171* **Il blocco `env`**: a parte l'unità di telemetria e le variabili di routing associate a una chiave di credenziale, entrambe coperte di seguito, si unisce per chiave tra le fonti controllate dall'amministratore. Per ogni variabile di ambiente, la fonte con la priorità più alta che la definisce vince, e le fonti amministrative inferiori riempiono le variabili che le fonti superiori lasciano non impostate. Una voce `env` gestita dall'endpoint si applica quindi ogni volta che la configurazione gestita dal server lascia quella variabile non impostata, o mentre un valore server memorizzato nella cache per essa è [trattenuto in sospeso della conferma del server](#fetch-and-caching-behavior). Richiede Claude Code v2.1.223 o successivo. Prima della v2.1.223, Claude Code applica solo il blocco `env` della fonte selezionata.

172 * **Unità di telemetria**: le chiavi dell'esportatore `OTEL_EXPORTER_OTLP_*`, gli interruttori di acquisizione del contenuto `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` e le variabili di tracciamento beta `ENABLE_BETA_TRACING_DETAILED` e `BETA_TRACING_ENDPOINT` seguono la fonte più alta che imposta una qualsiasi di esse come unità. Una fonte che fornisce la chiave di credenziale `otelHeadersHelper` rivendica l'unità anche, ma fornisce queste variabili solo quando è la fonte selezionata: una fonte che non è selezionata ma fornisce la chiave non contribuisce a nessuna di esse e blocca comunque le fonti inferiori dal riempirle. In ogni caso, un endpoint dell'esportatore da una fonte non può mai essere associato a credenziali da un'altra.172 * **Unità di telemetria**: le chiavi dell'esportatore `OTEL_EXPORTER_OTLP_*`, gli interruttori di acquisizione del contenuto `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` e le variabili di tracciamento beta `ENABLE_BETA_TRACING_DETAILED` e `BETA_TRACING_ENDPOINT` seguono la fonte più alta che imposta una qualsiasi di esse come unità. Una fonte che fornisce la chiave di credenziale `otelHeadersHelper` rivendica l'unità anche, ma fornisce queste variabili solo quando è la fonte selezionata: una fonte che non è selezionata ma fornisce la chiave non contribuisce a nessuna di esse e blocca comunque le fonti inferiori dal riempirle. In ogni caso, un endpoint dell'esportatore da una fonte non può mai essere associato a credenziali da un'altra.

173 * **Routing associato a credenziale**: una fonte che associa variabili di routing a una chiave di credenziale solo per la fonte selezionata, come `apiKeyHelper` o `otelHeadersHelper`, contribuisce a quelle variabili di routing solo quando vince lo slot.173 * **Routing associato a credenziale**: una fonte che associa variabili di routing a una chiave di credenziale solo per la fonte selezionata, come `apiKeyHelper` o `otelHeadersHelper`, contribuisce a quelle variabili di routing solo quando vince lo slot.

174* **Chiavi di accesso al gateway**: Claude Code non legge mai [`forceLoginGatewayUrl`](/docs/it/settings-reference#forcelogingatewayurl) o il valore `"gateway"` di [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) dalle impostazioni gestite dal server, quindi selezionare le impostazioni gestite dal server non fornisce un accesso al gateway né nasconde uno impostato in una politica MDM o file di impostazioni gestite. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte amministrativa sulla macchina le fornisce.174* **Chiavi di accesso al gateway**: Claude Code non legge mai [`forceLoginGatewayUrl`](/docs/it/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/it/settings-reference#gatewayinternalnetworks), o il valore `"gateway"` di [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) dalle impostazioni gestite dal server, quindi un valore lì non si applica né nasconde uno impostato in una politica MDM o file di impostazioni gestite. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte amministrativa sulla macchina le fornisce.

175 175

176<h3 id="fetch-and-caching-behavior">176<h3 id="fetch-and-caching-behavior">

177 Comportamento di recupero e caching177 Comportamento di recupero e caching

220 220

221La consegna gestita dal server aggiunge questi comportamenti:221La consegna gestita dal server aggiunge questi comportamenti:

222 222

223* La cache in `~/.claude/remote-settings.json` memorizza il payload salvato con le voci non valide rimosse, ad eccezione dei valori `cleanupPeriodDays` e `desktopSessionCleanupPeriodDays` non validi, che rimangono nella copia memorizzata nella cache e non vengono mai applicati.223* Un avvio che viene eseguito sulla cache in `~/.claude/remote-settings.json` tratta le voci non valide nel modo in cui il recupero che ha scritto la cache lo ha fatto:

224* Quando nessun campo nel payload può essere salvato e il payload non è solo quelle chiavi di conservazione, Claude Code rifiuta il payload, mantiene le ultime impostazioni memorizzate nella cache accettate e scrive `Remote settings: Settings validation failed - no fields could be salvaged` nel log di debug. Con `forceRemoteSettingsRefresh` impostato, la CLI esce invece.224 * Le voci che non hanno superato la convalida rimangono eliminate.

225 * [Le chiavi che non riescono in modo chiuso](/docs/it/managed-settings#keys-that-fail-closed) mantengono i loro valori più rigorosi.

226 * Un valore `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` non valido rimane nella copia memorizzata nella cache e non viene mai applicato.

227* Claude Code non applica nulla da un payload e lascia la cache invariata quando tutti e tre questi sono veri:

228

229 * Ogni impostazione nel payload non supera la convalida.

230 * Nessuna di esse ricade su un valore più rigoroso.

231 * Il payload contiene una chiave diversa da quelle due chiavi di conservazione.

232

233 L'avviso all'avvio, `/status` e `claude doctor` quindi segnalano il [caricamento non riuscito](/docs/it/errors#remote-managed-settings-failed-to-load) con la causa `no setting in the server response could be applied as written`, e quella voce dice quale politica la sessione viene eseguita. I client che [applicano l'avvio fail-closed](#enforce-fail-closed-startup) escono all'avvio invece.

225* La [finestra di dialogo di approvazione della sicurezza](#security-approval-dialogs) valuta il payload salvato, quindi una voce non valida rimossa non viene mai presentata per l'approvazione e non viene mai eseguita.234* La [finestra di dialogo di approvazione della sicurezza](#security-approval-dialogs) valuta il payload salvato, quindi una voce non valida rimossa non viene mai presentata per l'approvazione e non viene mai eseguita.

226 235

227Per eseguire il debug dei problemi di consegna, eseguite `claude --debug-file <path>` e cercate nel log `Remote settings`. Convalidate una modifica del payload con `claude doctor` su una macchina di test prima di distribuirla all'organizzazione.236Per eseguire il debug dei problemi di consegna, eseguite `claude --debug-file <path>` e cercate nel log `Remote settings`. Convalidate una modifica del payload con `claude doctor` su una macchina di test prima di distribuirla all'organizzazione.

249}258}

250```259```

251 260

252Potete anche impostare questa chiave in un [profilo MDM](/docs/it/managed-settings#delivery-mechanisms) gestito dall'endpoint o in un file `managed-settings.json` di sistema per applicare il comportamento fail-closed al primo avvio, prima che qualsiasi payload del server sia stato consegnato. In Claude Code v2.1.191 o successivo, questo flag è un'eccezione alla [regola di precedenza](#settings-precedence) sopra: Claude Code lo rispetta quando qualsiasi fonte gestita controllata dall'amministratore lo imposta, anche se è presente anche un payload memorizzato nella cache gestito dal server, quindi non ignora un valore consegnato da MDM quando esistono impostazioni gestite dal server.261Potete anche impostare questa chiave in un [profilo MDM](/docs/it/managed-settings#delivery-mechanisms) gestito dall'endpoint o in un file `managed-settings.json` di sistema per applicare il comportamento fail-closed al primo avvio, prima che qualsiasi payload del server sia stato consegnato. Questo flag è un'eccezione alla [regola di precedenza](#settings-precedence) sopra: Claude Code lo rispetta quando qualsiasi fonte gestita controllata dall'amministratore lo imposta, anche se è presente anche un payload memorizzato nella cache gestito dal server, quindi non ignora un valore consegnato da MDM quando esistono impostazioni gestite dal server.

253 262

254Quando un [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite, il suo output sostituisce ogni altra fonte gestita per le chiavi che Claude Code legge dopo l'avvio. Per le fonti da cui Claude Code legge questa chiave, vedere [la sua voce di impostazioni](/docs/it/settings-reference#forceremotesettingsrefresh). La voce `policyHelper` dice da quali fonti Claude Code legge l'helper e quando viene eseguito.263Quando un [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite, il suo output sostituisce ogni altra fonte gestita per le chiavi che Claude Code legge dopo l'avvio. Per le fonti da cui Claude Code legge questa chiave, vedere [la sua voce di impostazioni](/docs/it/settings-reference#forceremotesettingsrefresh). La voce `policyHelper` dice da quali fonti Claude Code legge l'helper e quando viene eseguito.

255 264

338 347

339Né le chiavi restituite da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) né le credenziali di [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) attivano il recupero delle impostazioni.348Né le chiavi restituite da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) né le credenziali di [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) attivano il recupero delle impostazioni.

340 349

341In una sessione [Cowork](https://claude.com/docs/cowork/overview) nell'app Claude Desktop, Claude Code non recupera le impostazioni gestite dal server dalla console di amministrazione claude.ai, anche quando l'utente accede con un account Team o Enterprise. [Dove e quando si applica una policy](/docs/it/managed-settings#where-and-when-a-policy-applies) copre quale policy raggiunge le sessioni Cowork sulla macchina dell'utente e le sessioni Cowork remote.350In una sessione [Cowork](https://claude.com/docs/cowork/overview) nell'app Claude Desktop, Claude Code non recupera le impostazioni gestite dal server dalla console di amministrazione claude.ai, anche quando l'utente accede con un account Team o Enterprise. [Dove e quando si applica una policy](/docs/it/managed-settings#where-and-when-a-policy-applies) copre quale policy raggiunge le sessioni Cowork sulla macchina dell'utente e le sessioni Cowork remote. claude.ai applica comunque i vostri elenchi [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces) e [`blockedMarketplaces`](/docs/it/settings-reference#blockedmarketplaces) quando un utente Cowork aggiunge un marketplace da un repository git su claude.ai o da **Customize** nella scheda Cowork. [Come funzionano le restrizioni](/docs/it/plugins/org#restrict-what-users-can-install) descrive quel controllo.

342 351

343Se esportate una variabile provider `CLAUDE_CODE_USE_*` o un `ANTHROPIC_BASE_URL` non predefinito nella vostra shell, Claude Code salta il recupero delle impostazioni per le vostre sessioni. [`claude doctor` e `/status` segnalano il recupero saltato e la sua causa](#verify-settings-delivery).352Se esportate una variabile provider `CLAUDE_CODE_USE_*` o un `ANTHROPIC_BASE_URL` non predefinito nella vostra shell, Claude Code salta il recupero delle impostazioni per le vostre sessioni. [`claude doctor` e `/status` segnalano il recupero saltato e la sua causa](#verify-settings-delivery).

344 353

sessions.md +3 −2

Details

43* Modalità di autorizzazione: se riprendi da un terminale con `claude --continue`, `claude --resume <session-id>` o `claude --resume <name>` quando il nome corrisponde a una sessione, senza `-p`, Claude Code ripristina la modalità di autorizzazione in cui era la sessione, tranne nei casi in [modalità di autorizzazione al ripristino](#permission-mode-on-resume), che copre anche il selezionatore di sessioni, `/resume` e la ripresa con `claude -p`. Passa `--permission-mode` o `--dangerously-skip-permissions` per ignorare la modalità ripristinata.43* Modalità di autorizzazione: se riprendi da un terminale con `claude --continue`, `claude --resume <session-id>` o `claude --resume <name>` quando il nome corrisponde a una sessione, senza `-p`, Claude Code ripristina la modalità di autorizzazione in cui era la sessione, tranne nei casi in [modalità di autorizzazione al ripristino](#permission-mode-on-resume), che copre anche il selezionatore di sessioni, `/resume` e la ripresa con `claude -p`. Passa `--permission-mode` o `--dangerously-skip-permissions` per ignorare la modalità ripristinata.

44* Obiettivo attivo: un [obiettivo](/docs/it/goal#resume-with-an-active-goal) che era ancora attivo quando la sessione è terminata si trasferisce; il suo conteggio dei turni, il timer e la linea di base della spesa di token si ripristinano.44* Obiettivo attivo: un [obiettivo](/docs/it/goal#resume-with-an-active-goal) che era ancora attivo quando la sessione è terminata si trasferisce; il suo conteggio dei turni, il timer e la linea di base della spesa di token si ripristinano.

45* Attività pianificate: le [attività che non sono scadute](/docs/it/scheduled-tasks#limitations) vengono ripristinate. Le attività Bash in background e le attività di monitoraggio non lo sono.45* Attività pianificate: le [attività che non sono scadute](/docs/it/scheduled-tasks#limitations) vengono ripristinate. Le attività Bash in background e le attività di monitoraggio non lo sono.

46* Lavoro in background: un [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background), un comando Bash in background o un [workflow](/docs/it/workflows) che è terminato con il processo precedente appare nel trascritto ripreso come una nota che non è stato completato. Claude Code non avvia un turno da quelle note; Claude le legge con il tuo prossimo prompt.

46 47

47Non ogni flag di configurazione dal lancio originale viene ripristinato. Se la sessione dipendeva da `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` o directory aggiunte con `--add-dir`, passale di nuovo quando riprendi; le directory aggiunte a metà sessione con `/add-dir` non vengono ripristinate neanche, anche se il selezionatore di sessioni le usa ancora per individuare la sessione. I file di impostazioni standard, come `settings.json` e `settings.local.json`, vengono riletti al lancio, quindi la configurazione che vive in essi non ha bisogno di essere passata di nuovo. Per `--system-prompt` e `--append-system-prompt`, vedi [Flag del prompt di sistema nelle conversazioni riprese](/docs/it/cli-reference#system-prompt-flags-in-resumed-conversations).48Non ogni flag di configurazione dal lancio originale viene ripristinato. Se la sessione dipendeva da `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` o directory aggiunte con `--add-dir`, passale di nuovo quando riprendi; le directory aggiunte a metà sessione con `/add-dir` non vengono ripristinate neanche, anche se il selezionatore di sessioni le usa ancora per individuare la sessione. I file di impostazioni standard, come `settings.json` e `settings.local.json`, vengono riletti al lancio, quindi la configurazione che vive in essi non ha bisogno di essere passata di nuovo. Per `--system-prompt` e `--append-system-prompt`, vedi [Flag del prompt di sistema nelle conversazioni riprese](/docs/it/cli-reference#system-prompt-flags-in-resumed-conversations).

48 49

74 Riprendere in modalità piano con `-p`75 Riprendere in modalità piano con `-p`

75</h5>76</h5>

76 77

~~77Un'esecuzione `claude -p --resume` o `claude -p --continue` riprende in modalità piano solo quando tutte e quattro le condizioni sono soddisfatte:~~78Un'esecuzione `claude -p --resume` o `claude -p --continue` riprende in modalità piano solo quando tutte queste condizioni sono soddisfatte:

78 79

~~79* Passi [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags), in modo che Claude Code possa presentare il piano per l'approvazione~~80* Passi [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) e non passi [`--permission-prompts none`](/docs/it/headless#turn-off-permission-prompts-in-unattended-runs), in modo che Claude Code possa presentare il piano per l'approvazione

80* Non passi `--permission-mode` o `--dangerously-skip-permissions`81* Non passi `--permission-mode` o `--dangerously-skip-permissions`

81* Non passi `--fork-session`82* Non passi `--fork-session`

82* L'esecuzione non è avviata attraverso [canali](/docs/it/channels)83* L'esecuzione non è avviata attraverso [canali](/docs/it/channels)

settings-reference.md +290 −112

Details

623| [`availableModelsMatch`](#availablemodelsmatch) | Fate in modo che ogni voce dell'ID modello `availableModels` [consenta solo la versione che nomina](/docs/it/model-config#block-specific-models-or-versions) | Model and responses | Managed |

623| [`awaySummaryEnabled`](#awaysummaryenabled) | Disattivate il [riepilogo della sessione](/docs/it/interactive-mode#session-recap) mostrato quando tornate al terminale | Remote, desktop, and notifications | Any file |624| [`awaySummaryEnabled`](#awaysummaryenabled) | Disattivate il [riepilogo della sessione](/docs/it/interactive-mode#session-recap) mostrato quando tornate al terminale | Remote, desktop, and notifications | Any file |

624| [`awsAuthRefresh`](#awsauthrefresh) | Aggiornate le [credenziali Bedrock](/docs/it/amazon-bedrock#advanced-credential-configuration) scadute in `.aws` con il vostro comando | Authentication and providers | Any file |625| [`awsAuthRefresh`](#awsauthrefresh) | Aggiornate le [credenziali Bedrock](/docs/it/amazon-bedrock#advanced-credential-configuration) scadute in `.aws` con il vostro comando | Authentication and providers | Any file |

625| [`awsCredentialExport`](#awscredentialexport) | Fornite le [credenziali Bedrock](/docs/it/amazon-bedrock#advanced-credential-configuration) come JSON dal vostro comando | Authentication and providers | Any file |626| [`awsCredentialExport`](#awscredentialexport) | Fornite le [credenziali Bedrock](/docs/it/amazon-bedrock#advanced-credential-configuration) come JSON dal vostro comando | Authentication and providers | Any file |

633| [`claudeInChromeDefaultEnabled`](#claudeinchromedefaultenabled) | Attivate l'[integrazione Chrome](/docs/it/chrome) in ogni sessione CLI interattiva senza passare `--chrome` | Global config settings | Global config |

638| [`copyFullResponse`](#copyfullresponse) | Fate in modo che [`/copy`](/docs/it/commands) copi la risposta completa senza mostrare il selezionatore di blocchi di codice | Global config settings | Global config |

636| [`copyOnSelect`](#copyonselect) | Disattivate la copia automatica del testo che selezionate con il mouse nel [rendering a schermo intero](/docs/it/fullscreen#use-the-mouse) e nella vista agente | Global config settings | Global config |639| [`copyOnSelect`](#copyonselect) | Disattivate la copia automatica del testo che selezionate con il mouse nel [rendering a schermo intero](/docs/it/fullscreen#use-the-mouse) e nella vista agente | Global config settings | Global config |

637| [`crossSessionInbound`](#crosssessioninbound) | Scegliete se Claude Code consegna i [messaggi dalle vostre altre sessioni](/docs/it/cross-session-messaging#control-inbound-messages), mostra un avviso senza consegnarli, o li rifiuta | Agents, sessions, and worktrees | Any file |640| [`crossSessionInbound`](#crosssessioninbound) | Scegliete se Claude Code consegna i [messaggi dalle vostre altre sessioni](/docs/it/cross-session-messaging#control-inbound-messages), mostra un avviso senza consegnarli, o li rifiuta | Agents, sessions, and worktrees | Any file |

638| [`defaultShell`](#defaultshell) | Scegliete se Bash o PowerShell esegue i comandi shell che digitate con il prefisso [`!`](/docs/it/interactive-mode#shell-mode-with-prefix) | Interface and terminal | Any file |641| [`defaultShell`](#defaultshell) | Scegliete se Bash o PowerShell esegue i comandi shell che digitate con il prefisso [`!`](/docs/it/interactive-mode#shell-mode-with-prefix) | Interface and terminal | Any file |

642| [`defaultToAgentsView`](#defaulttoagentsview) | Aprite la [vista agente](/docs/it/agent-view) invece di una nuova conversazione quando eseguite `claude` senza argomenti | Global config settings | Global config |

640| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Impostate un limite di età in giorni per i [trascritti di Claude Desktop e Cowork](/docs/it/claude-directory#cleaned-up-automatically) | Privacy and telemetry | User or managed |645| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Impostate un limite di età in giorni per i [trascritti di Claude Desktop e Cowork](/docs/it/claude-directory#cleaned-up-automatically) | Privacy and telemetry | User or managed |

641| [`dialogExpiry`](#dialogexpiry) | Impostate quanto a lungo Claude Code aspetta che [Remote Control](/docs/it/remote-control) o un host SDK risponda a una finestra di dialogo inoltrata prima di annullarla | Interface and terminal | User or managed |646| [`dialogExpiry`](#dialogexpiry) | Impostate quanto a lungo Claude Code aspetta che [Remote Control](/docs/it/remote-control) o un host SDK risponda a una finestra di dialogo inoltrata prima di annullarla | Interface and terminal | User or managed |

642| [`diffTool`](#difftool) | Scegliete se le modifiche ai file proposte da Claude si aprono nel visualizzatore diff di [VS Code](/docs/it/vs-code) o [JetBrains](/docs/it/jetbrains#features) o rimangono nel terminale | Global config settings | Global config |647| [`diffTool`](#difftool) | Scegliete se le modifiche ai file proposte da Claude si aprono nel visualizzatore diff di [VS Code](/docs/it/vs-code) o [JetBrains](/docs/it/jetbrains#features) o rimangono nel terminale | Global config settings | Global config |

690| [`isolatePeerMachines`](#isolatepeermachines) | Chiedete prima che Claude [messaggi una delle vostre sessioni su un'altra macchina](/docs/it/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |695| [`isolatePeerMachines`](#isolatepeermachines) | Chiedete prima che Claude [messaggi una delle vostre sessioni su un'altra macchina](/docs/it/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |

691| [`keybindingFlavor`](#keybindingflavor) | Deprecato e non ha effetto; le scorciatoie di modifica delle parole seguono sempre le [convenzioni readline](/docs/it/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |696| [`keybindingFlavor`](#keybindingflavor) | Deprecato e non ha effetto; le scorciatoie di modifica delle parole seguono sempre le [convenzioni readline](/docs/it/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |

698| [`leftArrowOpensAgents`](#leftarrowopensagents) | Disattivate la scorciatoia `←` che [mette in background la sessione e apre la vista agente](/docs/it/agent-view#switch-sessions-without-leaving-the-terminal) | Global config settings | Global config |

694| [`managedSourcesBehavior`](#managedsourcesbehavior) | Componete ogni [fonte gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources) che distribuite invece di usare solo quella con la priorità più alta | Enterprise and managed settings | Managed |700| [`managedSourcesBehavior`](#managedsourcesbehavior) | Componete ogni [fonte gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources) che distribuite invece di usare solo quella con la priorità più alta | Enterprise and managed settings | Managed |

696| [`minimumVersion`](#minimumversion) | Impedite agli [aggiornamenti automatici](/docs/it/setup#pin-a-minimum-version) di installare qualsiasi cosa al di sotto di una versione | Updates and versioning | Any file |703| [`minimumVersion`](#minimumversion) | Impedite agli [aggiornamenti automatici](/docs/it/setup#pin-a-minimum-version) di installare qualsiasi cosa al di sotto di una versione | Updates and versioning | Any file |

724| [`processWrapper`](#processwrapper) | Eseguite i processi in background di Claude Code attraverso un [launcher aziendale](/docs/it/corporate-launcher) su macOS e Linux | Agents, sessions, and worktrees | User or managed |731| [`processWrapper`](#processwrapper) | Eseguite i processi in background di Claude Code attraverso un [launcher aziendale](/docs/it/corporate-launcher) su macOS e Linux | Agents, sessions, and worktrees | User or managed |

726| [`promptSuggestionEnabled`](#promptsuggestionenabled) | Nascondetei [suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) in grigio nella casella di input | Interface and terminal | Any file |733| [`promptSuggestionEnabled`](#promptsuggestionenabled) | Nascondetei [suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) in grigio nella casella di input | Interface and terminal | Any file |

734| [`prStatusFooterEnabled`](#prstatusfooterenabled) | Disattivate il [badge dello stato di revisione PR](/docs/it/interactive-mode#pr-review-status) del footer del prompt e il controllo della pull request dietro di esso | Global config settings | Global config |

728| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Scegliete l'[ambiente cloud](/docs/it/cloud-environments) predefinito per `claude --cloud`; un ID `ccpool_` auto-ospitato è di sola lettura dalle impostazioni utente e gestite e `--settings` | Remote, desktop, and notifications | Any file |736| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Scegliete l'[ambiente cloud](/docs/it/cloud-environments) predefinito per `claude --cloud`; un ID `ccpool_` auto-ospitato è di sola lettura dalle impostazioni utente e gestite e `--settings` | Remote, desktop, and notifications | Any file |

729| [`remoteControlAtStartup`](#remotecontrolatstartup) | Connettetevi a [Remote Control](/docs/it/remote-control#enable-remote-control-for-all-sessions) automaticamente quando una sessione inizia | Remote, desktop, and notifications | Any file |737| [`remoteControlAtStartup`](#remotecontrolatstartup) | Connettetevi a [Remote Control](/docs/it/remote-control#enable-remote-control-for-all-sessions) automaticamente quando una sessione inizia | Remote, desktop, and notifications | Any file |

827 Modello e risposte835 Modello e risposte

828</h2>836</h2>

829 837

830Scegliere quali modelli Claude Code utilizza e come risponde. Per informazioni su come queste impostazioni interagiscono con il comando `/model` e le variabili di ambiente, vedere [Configurazione del modello](/docs/it/model-config).838Scegli quali modelli Claude Code utilizza e come risponde. Per come queste impostazioni interagiscono con il comando `/model` e le variabili di ambiente, vedi [Configurazione del modello](/docs/it/model-config).

831 839

832<h3 id="advisormodel">840<h3 id="advisormodel">

833 `advisorModel`841 `advisorModel`

834</h3>842</h3>

835 843

836Scegliere quale modello risponde quando Claude chiama lo [strumento advisor](/docs/it/advisor) lato server. Lasciarlo non impostato per disattivare l'advisor. L'advisor deve essere almeno altrettanto capace del modello principale. Vedere [Scegliere un modello advisor](/docs/it/advisor#choose-an-advisor-model) per gli accoppiamenti accettati e cosa accade quando se ne sceglie uno che non è accettato.844Scegli quale modello risponde quando Claude chiama lo [strumento advisor](/docs/it/advisor) lato server. Lascialo non impostato per disattivare l'advisor. L'advisor deve essere almeno altrettanto capace del tuo modello principale. Vedi [Scegli un modello advisor](/docs/it/advisor#choose-an-advisor-model) per gli accoppiamenti accettati e cosa succede quando ne scegli uno non accettato.

837 845

838Di solito non si modifica questa chiave manualmente. Eseguire `/advisor` per aprire un selettore che mostra la scelta corrente, i modelli che possono fornire consulenza e **No advisor**. Claude Code salva la scelta in questa chiave in `~/.claude/settings.json`. Se si sceglie da un client [Remote Control](/docs/it/remote-control) o in una sessione collegata a un worker remoto, la scelta si applica solo a quella sessione e non modifica questa chiave.846Di solito non modifichi questa chiave manualmente. Esegui `/advisor` per aprire un selettore che mostra la scelta attuale, i modelli che possono fornire consulenza e **Nessun advisor**. Claude Code salva la tua scelta in questa chiave in `~/.claude/settings.json`. Se scegli da un client [Remote Control](/docs/it/remote-control) o in una sessione collegata a un worker remoto, la scelta si applica solo a quella sessione e non modifica questa chiave.

839 847

840Se l'account richiede il [consenso usage-credits](/docs/it/advisor#fable-advisor-and-usage-credits), accettarlo prima eseguendo `/model fable`. Fino a quando non lo si fa, scegliere Fable in `/advisor` non salva nulla e Claude Code comunica di eseguire prima `/model fable`.848Se il tuo account richiede il [consenso usage-credits](/docs/it/advisor#fable-advisor-and-usage-credits), accettalo prima eseguendo `/model fable`. Fino a quando non lo fai, scegliere Fable in `/advisor` non salva nulla e Claude Code ti dice di eseguire `/model fable` prima.

841 849

842* **Scope**: [`Any file`](#scopes)850* **Scope**: [`Any file`](#scopes)

843* **Type**: string, uno degli alias `"fable"`, `"opus"` o `"sonnet"`, che si risolvono nella versione predefinita corrente di Claude Code di quella famiglia di modelli, oppure un ID modello completo come `"claude-opus-5-5"`851* **Type**: string, uno degli alias `"fable"`, `"opus"`, o `"sonnet"`, che si risolvono nella versione predefinita corrente di Claude Code di quella famiglia di modelli, o un ID modello completo come `"claude-opus-5-5"`

844* **Default**: non impostato, quindi l'advisor è disattivato852* **Default**: non impostato, quindi l'advisor è disattivato

845* **Per-session overrides**: `--advisor` ha la precedenza su questa chiave per una sessione. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/it/env-vars) disattiva l'advisor e questa chiave non può riattivarlo853* **Per-session overrides**: `--advisor` ha la precedenza su questa chiave per una sessione. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/it/env-vars) disattiva l'advisor, e questa chiave non può riattivarlo

846 854

847```json settings.json theme={null}855```json settings.json theme={null}

848{856{

856 `alwaysThinkingEnabled`864 `alwaysThinkingEnabled`

857</h3>865</h3>

858 866

859Disattivare il [pensiero esteso](/docs/it/model-config#extended-thinking) per ogni sessione impostando questo su `false`. Il pensiero è attivato per impostazione predefinita, quindi `true` non cambia nulla. La maggior parte delle persone imposta questo tramite `/config` piuttosto che modificando il file.867Disattiva il [pensiero esteso](/docs/it/model-config#extended-thinking) per ogni sessione impostando questo a `false`. Il pensiero è attivo per impostazione predefinita, quindi `true` non cambia nulla. La maggior parte delle persone imposta questo tramite `/config` piuttosto che modificando il file.

860 868

861Su modelli che pensano sempre, come Opus 5.5 e i modelli Fable, `false` non ha effetto. Su [provider di terze parti](/docs/it/third-party-integrations) Claude Code omette il parametro `thinking` invece di disattivare il pensiero, quindi i modelli di ragionamento adattivo potrebbero comunque pensare. Con il pensiero disattivato sull'API Anthropic, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.869Su modelli che pensano sempre, come Opus 5.5, Sonnet 5.5, e i modelli Fable, `false` non ha effetto. Su [provider di terze parti](/docs/it/third-party-integrations) Claude Code omette il parametro `thinking` invece di disattivare il pensiero, quindi i modelli di ragionamento adattivo potrebbero comunque pensare. Con il pensiero disattivato su Anthropic API, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

862 870

863* **Scope**: [`Any file`](#scopes)871* **Scope**: [`Any file`](#scopes)

864* **Type**: Boolean872* **Type**: Boolean

865 * `true`: nessun effetto; il pensiero è già attivato873 * `true`: nessun effetto; il pensiero è già attivo

866 * `false`: Claude Code disattiva il pensiero esteso per ogni sessione874 * `false`: Claude Code disattiva il pensiero esteso per ogni sessione

867* **Default**: non impostato, quindi il pensiero è attivato per i modelli che lo supportano875* **Default**: non impostato, quindi il pensiero è attivo per i modelli che lo supportano

868* **Per-session overrides**: [`MAX_THINKING_TOKENS`](/docs/it/env-vars) ha la precedenza su questa chiave per una sessione: `0` disattiva il pensiero, con gli stessi limiti di modello e provider di `false`, e un valore positivo attiva il pensiero anche quando questa chiave è `false`. Su modelli di ragionamento adattivo il numero stesso viene ignorato876* **Per-session overrides**: [`MAX_THINKING_TOKENS`](/docs/it/env-vars) ha la precedenza su questa chiave per una sessione: `0` disattiva il pensiero, sotto gli stessi limiti di modello e provider di `false`, e un valore positivo attiva il pensiero anche quando questa chiave è `false`. Su modelli di ragionamento adattivo il numero stesso viene ignorato

869 877

870```json settings.json theme={null}878```json settings.json theme={null}

871{879{

877 `availableModels`885 `availableModels`

878</h3>886</h3>

879 887

880Limitare quali modelli le persone possono selezionare per la sessione principale, [subagenti](/docs/it/sub-agents), [skills](/docs/it/skills) e l'[advisor](/docs/it/advisor). Un elenco gestito vincola `/model`, `--model` e la chiave `model` nei file propri dello sviluppatore; un modello al di fuori di esso non può essere selezionato. Di per sé questo non tocca l'opzione Default; abbinarlo a [`enforceAvailableModels`](#enforceavailablemodels) per quello.888Limita quali modelli le persone possono selezionare per la sessione principale, [subagenti](/docs/it/sub-agents), [skills](/docs/it/skills), e l'[advisor](/docs/it/advisor). Un elenco gestito vincola `/model`, `--model`, e la chiave `model` nei file propri dello sviluppatore; un modello al di fuori di esso non può essere selezionato. Con la corrispondenza di prefisso predefinita, questo non tocca l'opzione Default da sola; abbinala con [`enforceAvailableModels`](#enforceavailablemodels) per quello.

881 889

882* **Scope**: [`Any file`](#scopes). Distribuirlo nelle impostazioni gestite per applicarlo a un'organizzazione.890* **Scope**: [`Any file`](#scopes). Distribuiscilo nelle impostazioni gestite per applicarlo a un'organizzazione.

883* **Type**: array di alias di modelli o ID891* **Type**: array di alias di modelli o ID

884* **Default**: non impostato, quindi ogni modello è disponibile892* **Default**: non impostato, quindi ogni modello è disponibile

885 893

891}899}

892```900```

893 901

894Vedere [Limitare la selezione del modello](/docs/it/model-config#restrict-model-selection).902Una voce ID modello come `"claude-opus-5"` consente anche versioni successive che la estendono, come Opus 5.5. Per bloccare una di quelle versioni, usa [`deniedModels`](#deniedmodels). Per fare in modo che ogni voce ID modello consenta solo la versione che nomina, usa [`availableModelsMatch`](#availablemodelsmatch). Vedi [Limita la selezione del modello](/docs/it/model-config#restrict-model-selection).

903

904<h3 id="availablemodelsmatch">

905 `availableModelsMatch`

906</h3>

907

908Scegli come le voci [`availableModels`](#availablemodels) corrispondono agli ID modello. Per impostazione predefinita una voce ID modello consente anche versioni successive che la estendono, quindi `"claude-opus-5"` consente Opus 5.5. Con `"exact"`, ogni voce ID modello consente solo la versione che nomina, quindi una versione più recente di quel modello rimane bloccata finché non la elenchi. Richiede Claude Code v2.1.283 o successivo.

909

910* **Scope**: [`Managed`](#scopes). Claude Code ignora la chiave nelle impostazioni utente, progetto e locale e in `--settings`, con un avviso

911* **Type**: string, uno di:

912 * `"prefix"`: una voce ID modello consente la sua versione e qualsiasi ID modello che la estende con un altro segmento

913 * `"exact"`: una voce ID modello consente solo la versione che nomina, inclusi gli ID datati di quella versione, quindi `"claude-opus-5"` consente Opus 5 ma non `claude-opus-5-5`. Un alias di famiglia come `"opus"` consente comunque l'intera famiglia, e le voci `best`, `opusplan`, e `default` vengono ignorate

914* **Default**: `"prefix"`

915

916Questo esempio consente Opus 5 e Sonnet 5 e nessuna versione successiva di entrambi:

917

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

919{

920 "availableModels": ["claude-opus-5", "claude-sonnet-5"],

921 "availableModelsMatch": "exact"

922}

923```

924

925Con `"exact"`, l'opzione Default è anche limitata ai modelli elencati ogni volta che l'elenco nomina almeno un modello o una famiglia. Vedi [Blocca modelli o versioni specifiche](/docs/it/model-config#block-specific-models-or-versions).

926

927<h3 id="deniedmodels">

928 `deniedModels`

929</h3>

930

931Blocca modelli specifici, con o senza un elenco [`availableModels`](#availablemodels) e anche quando quell'elenco li consente. Claude Code nasconde un modello bloccato dal selettore `/model`, e il modello non può essere selezionato ovunque `availableModels` sia applicato. Una sessione sull'opzione Default non esegue nemmeno un modello bloccato, come [Blocca modelli o versioni specifiche](/docs/it/model-config#block-specific-models-or-versions) descrive. Richiede Claude Code v2.1.283 o successivo.

932

933* **Scope**: [`Managed`](#scopes). Claude Code ignora la chiave nelle impostazioni utente, progetto e locale e in `--settings`, con un avviso

934* **Type**: array di alias di modelli o ID

935 * Un alias di famiglia come `"opus"` blocca ogni modello in quella famiglia

936 * Un ID modello come `"claude-opus-5-5"` blocca quella versione in ogni ortografia, inclusi gli ID datati e specifici del provider

937 * Un ID modello senza versione minore, come `"claude-opus-5"`, blocca anche versioni minori successive come Opus 5.5. Scrivi `"claude-opus-5-0"` per bloccare solo Opus 5

938 * Le voci `best`, `opusplan`, e `default` vengono ignorate

939* **Default**: non impostato, quindi nessun modello è bloccato

940

941Questo esempio consente modelli Opus e Sonnet e blocca Opus 5.5:

942

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

944{

945 "availableModels": ["opus", "sonnet"],

946 "deniedModels": ["claude-opus-5-5"]

947}

948```

949

950Vedi [Blocca modelli o versioni specifiche](/docs/it/model-config#block-specific-models-or-versions).

895 951

896<h3 id="effortlevel">952<h3 id="effortlevel">

897 `effortLevel`953 `effortLevel`

898</h3>954</h3>

899 955

900Impostare un [livello di effort](/docs/it/model-config#adjust-effort-level) predefinito per i modelli per i quali non è stato salvato un livello. I livelli inferiori sono più veloci e meno costosi su compiti semplici, e i livelli superiori ragionano più profondamente su problemi complessi.956Imposta un [livello di effort](/docs/it/model-config#adjust-effort-level) predefinito per i modelli per i quali non hai salvato un livello. I livelli inferiori sono più veloci e più economici su compiti semplici, e i livelli superiori ragionano più profondamente su problemi complessi.

901 957

902Quando si esegue `/effort low`, `medium`, `high` o `xhigh` in una sessione interattiva sulla propria macchina, Claude Code salva il livello per il modello attivo sotto [`modelSettings`](#modelsettings) piuttosto che scrivere questa chiave. Prima della v2.1.251, `/effort` scriveva questa chiave.958Quando esegui `/effort low`, `medium`, `high`, o `xhigh` in una sessione interattiva sulla tua macchina, Claude Code salva il livello per il modello attivo sotto [`modelSettings`](#modelsettings) piuttosto che scrivere questa chiave. Prima della v2.1.251, `/effort` scriveva questa chiave.

903 959

904All'interno dello stesso file di impostazioni, Claude Code utilizza il livello salvato di un modello piuttosto che questa chiave. [`modelSettings`](#modelsettings) indica la precedenza tra file.960All'interno dello stesso file di impostazioni, Claude Code utilizza il livello salvato di un modello piuttosto che questa chiave. [`modelSettings`](#modelsettings) indica la precedenza tra file.

905 961

906In una sessione collegata a un worker remoto, in un'esecuzione `-p` e nell'Agent SDK, `/effort` si applica solo a quella sessione. [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) elenca le scelte interattive che si applicano anche solo a quella sessione. Il messaggio che `/effort` stampa dice quale è accaduto.962In una sessione collegata a un worker remoto, in un'esecuzione `-p`, e in Agent SDK, `/effort` si applica solo a quella sessione. [Regola il livello di effort](/docs/it/model-config#adjust-effort-level) elenca le scelte interattive che si applicano anche solo a quella sessione. Il messaggio che `/effort` stampa dice quale è accaduto.

907 963

908* **Scope**: [`Any file`](#scopes)964* **Scope**: [`Any file`](#scopes)

909* **Type**: string, uno di:965* **Type**: string, uno di:

910 * `"low"`: il ragionamento minimo, per compiti brevi, circoscritti, sensibili alla latenza che non sono sensibili all'intelligenza966 * `"low"`: il ragionamento minimo, per compiti brevi, limitati e sensibili alla latenza che non sono sensibili all'intelligenza

911 * `"medium"`: riduce l'utilizzo di token per il lavoro sensibile ai costi che può scambiare un po' di intelligenza967 * `"medium"`: riduce l'utilizzo di token per il lavoro sensibile ai costi che può scambiare un po' di intelligenza

912 * `"high"`: bilancia l'utilizzo di token e l'intelligenza968 * `"high"`: bilancia l'utilizzo di token e l'intelligenza

913 * `"xhigh"`: ragionamento più profondo con spesa di token più elevata969 * `"xhigh"`: ragionamento più profondo con spesa di token più elevata

920}976}

921```977```

922 978

923Nel file di impostazioni utente, `~/.claude/settings.json`, questa chiave è la forma più vecchia che `/effort` scriveva prima di salvare i livelli per modello, e continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti. Opus 5.5 e i modelli rilasciati dopo di esso la ignorano e iniziano al loro predefinito fino a quando non si salva un livello per essi, che `/effort` scrive sotto [`modelSettings`](#modelsettings). Nelle impostazioni progetto, locali e gestite, e con `--settings`, questa chiave si applica a ogni modello.979Nel tuo file di impostazioni utente, `~/.claude/settings.json`, questa chiave è la forma più vecchia che `/effort` scriveva prima di salvare i livelli per modello, e continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1, e modelli precedenti. Opus 5.5 e i modelli rilasciati dopo di esso lo ignorano e iniziano al loro default fino a quando non salvi un livello per loro, che `/effort` scrive sotto [`modelSettings`](#modelsettings). Nelle impostazioni di progetto, locale e gestite, e con `--settings`, questa chiave si applica a ogni modello.

924 980

925<h3 id="enforceavailablemodels">981<h3 id="enforceavailablemodels">

926 `enforceAvailableModels`982 `enforceAvailableModels`

927</h3>983</h3>

928 984

929Il selettore `/model` ha un'opzione **Default** che si risolve nel [modello predefinito dell'organizzazione](/docs/it/model-config#organization-default-model) quando uno si applica, e altrimenti al predefinito del tipo di account. Un elenco [`availableModels`](#availablemodels) limita i modelli che è possibile nominare, ma di per sé lascia **Default** da solo, quindi **Default** può comunque risolversi in un modello al di fuori dell'elenco. Questa chiave colma quel divario. Richiede Claude Code v2.1.175 o successivo.985Il selettore `/model` ha un'opzione **Default**, e [`default` model setting](/docs/it/model-config#default-model-setting) descrive il modello a cui si risolve. Un elenco [`availableModels`](#availablemodels) limita i modelli che puoi nominare, ma con la [corrispondenza di prefisso](#availablemodelsmatch) predefinita non rimappa il default del tuo tipo di account, quindi **Default** può comunque risolversi a un modello al di fuori dell'elenco. Questa chiave chiude quella lacuna. Richiede Claude Code v2.1.175 o successivo.

930 986

931Quando l'organizzazione distribuisce impostazioni gestite, Claude Code legge questa chiave solo dalla fonte gestita e la ignora negli altri file.987Quando la tua organizzazione distribuisce qualsiasi impostazione gestita, Claude Code legge questa chiave solo dalla fonte gestita e la ignora negli altri tuoi file.

932 988

933* **Scope**: [`Any file`](#scopes)989* **Scope**: [`Any file`](#scopes)

934* **Type**: Boolean990* **Type**: Boolean

935 * `true`: quando **Default** si risolverebbe in un modello al di fuori di `availableModels`, Claude Code lo risolve nel primo modello disponibile nell'elenco991 * `true`: quando **Default** si risolverebbe a un modello al di fuori di `availableModels`, Claude Code lo risolve al primo modello disponibile nell'elenco

936 * `false`: **Default** si risolve come al solito, anche in un modello al di fuori di `availableModels`992 * `false`: questa chiave non cambia come **Default** si risolve

937* **Default**: `false`993* **Default**: `false`

938 994

939Questo esempio limita le selezioni nominate ai modelli Sonnet e Haiku e fa sì che **Default** si risolva nel primo di essi disponibile:995Questo esempio limita le selezioni nominate ai modelli Sonnet e Haiku e fa sì che **Default** si risolva al primo di essi disponibile:

940 996

941```json settings.json theme={null}997```json settings.json theme={null}

942{998{

945}1001}

946```1002```

947 1003

948Questa chiave non ha effetto quando `availableModels` non è impostato o è vuoto. Vedere [Applicare l'elenco consentito al modello Default](/docs/it/model-config#enforce-the-allowlist-for-the-default-model). Richiede Claude Code v2.1.175 o successivo.1004Questa chiave non ha effetto quando `availableModels` non è impostato o è vuoto. Vedi [Applica l'elenco consentito al modello Default](/docs/it/model-config#enforce-the-allowlist-for-the-default-model). Richiede Claude Code v2.1.175 o successivo.

949 1005

950<h3 id="fallbackmodel">1006<h3 id="fallbackmodel">

951 `fallbackModel`1007 `fallbackModel`

952</h3>1008</h3>

953 1009

954Nominare modelli di backup per Claude Code da provare, in ordine, quando il modello principale è sovraccarico o non disponibile. Claude Code passa al modello disponibile successivo nella catena per il resto del turno e mostra un avviso. Senza una catena, Claude Code ritenta lo stesso modello e quindi visualizza l'errore del server, e si ritenta o si cambiano i modelli manualmente.1010Nomina modelli di backup per Claude Code da provare, in ordine, quando il tuo modello principale è sovraccarico o non disponibile. Claude Code passa al prossimo modello disponibile nella catena per il resto del turno e mostra un avviso. Senza una catena, Claude Code riprova lo stesso modello e poi mostra l'errore del server, e tu riprovi o cambi modelli tu stesso.

955 1011

956Un cambio significa un turno con una [prompt cache](/docs/it/prompt-caching#switching-models) fredda sul modello di fallback; il messaggio successivo ritenta il modello principale per primo.1012Un cambio significa un turno con una [cache prompt](/docs/it/prompt-caching#switching-models) fredda sul modello di fallback; il tuo prossimo messaggio riprova il modello principale per primo di nuovo.

957 1013

958* **Scope**: [`Any file`](#scopes)1014* **Scope**: [`Any file`](#scopes)

959* **Type**: array di alias di modelli o ID; `"default"` si espande al modello predefinito1015* **Type**: array di alias di modelli o ID; `"default"` si espande al modello predefinito

960* **Default**: non impostato, quindi una richiesta non riuscita non viene ritentata su un altro modello1016* **Default**: non impostato, quindi una richiesta fallita non viene ritentata su un altro modello

961* **Per-session overrides**: `--fallback-model` ha la precedenza su questa chiave per una sessione1017* **Per-session overrides**: `--fallback-model` ha la precedenza su questa chiave per una sessione

962 1018

963Questo esempio prova Sonnet 5 per primo, poi Haiku 4.5, quando il modello principale non riesce:1019Questo esempio prova Sonnet 5 per primo, poi Haiku 4.5, quando il tuo modello principale fallisce:

964 1020

965```json settings.json theme={null}1021```json settings.json theme={null}

966{1022{

968}1024}

969```1025```

970 1026

971A differenza della maggior parte delle impostazioni di array, questa chiave non si unisce tra file di impostazioni: il file con la precedenza più alta che la definisce fornisce l'intera catena. Se il file del progetto imposta `["claude-sonnet-5"]` e il file dell'utente imposta `["claude-haiku-4-5"]`, la catena è solo `["claude-sonnet-5"]`. Claude Code mantiene al massimo tre modelli consentiti distinti dall'elenco e ignora il resto. Vedere [Catene di modelli di fallback](/docs/it/model-config#fallback-model-chains).1027A differenza della maggior parte delle impostazioni di array, questa chiave non si unisce tra file di impostazioni: il file con la precedenza più alta che la definisce fornisce l'intera catena. Se il tuo file di progetto imposta `["claude-sonnet-5"]` e il tuo file utente imposta `["claude-haiku-4-5"]`, la catena è `["claude-sonnet-5"]` solo. Claude Code mantiene al massimo tre modelli consentiti distinti dall'elenco e ignora il resto. Vedi [Catene di modelli di fallback](/docs/it/model-config#fallback-model-chains).

972 1028

973<h3 id="fastmode">1029<h3 id="fastmode">

974 `fastMode`1030 `fastMode`

975</h3>1031</h3>

976 1032

977Attivare la [modalità veloce](/docs/it/fast-mode) per sessioni dove è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo dove si desidera velocità a un costo più elevato per token. Di solito non si modifica questa chiave manualmente: eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, e eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave. La modalità veloce funziona solo su Opus 5.5, Opus 5 e Opus 4.8: attivarla da un altro modello passa a Opus, e passare a un modello non supportato la disattiva. Vedere [Cambiare modelli mentre la modalità veloce è attiva](/docs/it/fast-mode#switch-models-while-fast-mode-is-on).1033Attiva la [modalità veloce](/docs/it/fast-mode) per sessioni dove è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo dove vuoi velocità a un costo più elevato per token. Di solito non modifichi questa chiave manualmente: eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, e eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave. La modalità veloce funziona solo su Opus 5.5, Opus 5, e Opus 4.8: attivarla da un altro modello ti passa a Opus, e passare a un modello non supportato la disattiva. Vedi [Cambia modelli mentre la modalità veloce è attiva](/docs/it/fast-mode#switch-models-while-fast-mode-is-on).

978 1034

979* **Scope**: [`Any file`](#scopes)1035* **Scope**: [`Any file`](#scopes)

980* **Type**: Boolean1036* **Type**: Boolean

993 `fastModePerSessionOptIn`1049 `fastModePerSessionOptIn`

994</h3>1050</h3>

995 1051

996Normalmente, eseguire `/fast` salva [`fastMode`](#fastmode) nelle impostazioni utente di una persona, quindi la modalità veloce è attiva all'inizio di ogni sessione successiva. Impostare questa chiave su `true` per fermare questo: un `fastMode: true` salvato non attiva più la modalità veloce all'inizio della sessione, e ogni persona deve eseguire `/fast` in ogni sessione in cui la desidera. Claude Code lascia la chiave `fastMode` nel file, quindi disattivare questa chiave ripristina il comportamento precedente.1052Normalmente, eseguire `/fast` salva [`fastMode`](#fastmode) nelle impostazioni utente di una persona, quindi la modalità veloce è attiva all'inizio di ogni sessione successiva. Imposta questa chiave a `true` per fermare quello: un `fastMode: true` salvato non attiva più la modalità veloce all'inizio della sessione, e ogni persona deve eseguire `/fast` in ogni sessione in cui la vuole. Claude Code lascia la chiave `fastMode` nel loro file, quindi disattivare questa chiave ripristina il comportamento vecchio.

997 1053

998I proprietari su piani Team o Enterprise possono distribuirlo a livello di organizzazione tramite [impostazioni gestite dal server](/docs/it/server-managed-settings). Quando le impostazioni gestite impostano la chiave, `/fast on` viene rifiutato al di fuori delle sessioni di terminale interattive e segnala che l'organizzazione ha disabilitato la modalità veloce. Questo copre la [modalità non interattiva](/docs/it/headless), l'[estensione VS Code](/docs/it/vs-code) e le [sessioni cloud](/docs/it/claude-code-on-the-web).1054I proprietari su piani Team o Enterprise possono distribuirla a livello di organizzazione tramite [impostazioni gestite dal server](/docs/it/server-managed-settings). Quando le impostazioni gestite impostano la chiave, `/fast on` viene rifiutato al di fuori delle sessioni di terminale interattive e segnala che la tua organizzazione ha disabilitato la modalità veloce. Questo copre la [modalità non interattiva](/docs/it/headless), l'[estensione VS Code](/docs/it/vs-code), e le [sessioni cloud](/docs/it/claude-code-on-the-web).

999 1055

1000* **Scope**: [`Any file`](#scopes)1056* **Scope**: [`Any file`](#scopes)

1001* **Type**: Boolean1057* **Type**: Boolean

1002 * `true`: un `fastMode: true` salvato non attiva più la modalità veloce all'inizio della sessione, quindi ogni persona esegue `/fast` in ogni sessione in cui la desidera; un `fastMode: true` passato con `--settings` conta comunque per quella sessione a meno che le impostazioni gestite non impostino questa chiave1058 * `true`: un `fastMode: true` salvato non attiva più la modalità veloce all'inizio della sessione, quindi ogni persona esegue `/fast` in ogni sessione in cui la vuole; un `fastMode: true` passato con `--settings` conta comunque per quella sessione a meno che le impostazioni gestite non impostino questa chiave

1003 * `false`: un `fastMode: true` salvato attiva la modalità veloce all'inizio di ogni sessione successiva1059 * `false`: un `fastMode: true` salvato attiva la modalità veloce all'inizio di ogni sessione successiva

1004* **Default**: `false`1060* **Default**: `false`

1005 1061

1009}1065}

1010```1066```

1011 1067

1012Vedere [Richiedere il consenso per sessione](/docs/it/fast-mode#require-per-session-opt-in).1068Vedi [Richiedi opt-in per sessione](/docs/it/fast-mode#require-per-session-opt-in).

1013 1069

1014<h3 id="language">1070<h3 id="language">

1015 `language`1071 `language`

1016</h3>1072</h3>

1017 1073

1018Fare in modo che Claude risponda in una lingua diversa dall'inglese per impostazione predefinita. Non esiste un elenco fisso per le risposte: Claude Code aggiunge il valore verbatim al prompt di sistema come istruzione per rispondere sempre in quella lingua, quindi qualsiasi nome di lingua che Claude può leggere funziona. Claude Code non controlla il valore, quindi un nome scritto male raggiunge Claude così come scritto piuttosto che produrre un errore. Lo stesso valore imposta la lingua per la [dettatura vocale](/docs/it/voice-dictation#change-the-dictation-language), che ha un elenco fisso di [lingue di dettatura supportate](/docs/it/voice-dictation#change-the-dictation-language), e per i titoli di sessione generati automaticamente.1074Fai rispondere Claude in una lingua diversa dall'inglese per impostazione predefinita. Non c'è un elenco fisso per le risposte: Claude Code passa il valore verbatim a Claude come istruzione per rispondere sempre in quella lingua, quindi qualsiasi nome di lingua che Claude può leggere funziona. Claude Code non controlla il valore, quindi un nome scritto male raggiunge Claude come scritto piuttosto che produrre un errore. Lo stesso valore imposta la lingua per la [dettatura vocale](/docs/it/voice-dictation#change-the-dictation-language), che ha un elenco fisso di [lingue di dettatura supportate](/docs/it/voice-dictation#change-the-dictation-language), e per i titoli di sessione generati automaticamente.

1019 1075

1020* **Scope**: [`Any file`](#scopes)1076* **Scope**: [`Any file`](#scopes)

1021* **Type**: string, qualsiasi nome di lingua, come `"japanese"`, `"spanish"` o `"french"`; Claude Code non lo convalida1077* **Type**: string, qualsiasi nome di lingua, come `"japanese"`, `"spanish"`, o `"french"`; Claude Code non lo convalida

1022* **Default**: non impostato; i titoli di sessione corrispondono quindi alla lingua della conversazione1078* **Default**: non impostato; i titoli di sessione corrispondono quindi alla lingua della tua conversazione

1023 1079

1024```json settings.json theme={null}1080```json settings.json theme={null}

1025{1081{

1031 `maxEffortLevel`1087 `maxEffortLevel`

1032</h3>1088</h3>

1033 1089

1034Limitare il [livello di effort](/docs/it/model-config#adjust-effort-level) che una sessione può utilizzare, lasciando disponibili i livelli inferiori. Qualsiasi livello superiore funziona al limite, incluso uno da `/effort`, il selettore `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars), il frontmatter `effort` di una skill o subagente, o il predefinito del modello stesso. Claude Code applica il limite stesso prima di ogni richiesta, quindi vale su ogni provider, inclusi Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Richiede Claude Code v2.1.267 o successivo.1090Limita il [livello di effort](/docs/it/model-config#adjust-effort-level) che una sessione può utilizzare, lasciando disponibili i livelli inferiori. Qualsiasi livello superiore funziona al limite invece, incluso uno da `/effort`, il selettore `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars), il frontmatter `effort` di una skill o subagente, o il default del modello stesso. Claude Code applica il limite stesso prima di ogni richiesta, quindi vale su ogni provider, inclusi Amazon Bedrock, Agent Platform di Google Cloud, e Microsoft Foundry. Richiede Claude Code v2.1.267 o successivo.

1035 1091

1036* **Scope**: [`Any file`](#scopes). Distribuirlo nelle impostazioni gestite per applicarlo a un'organizzazione. Quando più scope impostano un limite, si applica il più basso, quindi un limite impostato in uno scope non può essere aumentato da un altro1092* **Scope**: [`Any file`](#scopes). Distribuiscilo nelle impostazioni gestite per applicarlo a un'organizzazione. Quando più scope impostano un limite, si applica il più basso, quindi un limite impostato in uno scope non può essere aumentato da un altro

1037* **Type**: string, uno di `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"`. Un valore `"max"` non imposta alcun limite1093* **Type**: string, uno di `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Un valore `"max"` non imposta alcun limite

1038* **Default**: non impostato, quindi non si applica alcun limite1094* **Default**: non impostato, quindi non si applica alcun limite

1039* **Effect on ultracode**: un limite inferiore a `xhigh` rende [ultracode](#ultracode) non disponibile sui modelli a cui si applica il limite1095* **Per-model caps**: aggiungi `maxEffortLevel` alla voce [`modelSettings`](#modelsettings) di un modello. Quella voce sostituisce questa chiave solo per il modello all'interno della fonte di impostazioni che imposta entrambi, come le tue impostazioni utente o una [fonte gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources). Imposta `"max"` lì per esentare il modello dal limite di quella fonte; Claude Code applica comunque i limiti da altre fonti

1040* **Per-model caps**: aggiungere `maxEffortLevel` alla voce [`modelSettings`](#modelsettings) di un modello. Quella voce sostituisce questa chiave solo per il modello all'interno della fonte di impostazioni che imposta entrambi, come le impostazioni utente o una [fonte gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources). Impostare `"max"` lì per esentare il modello dal limite di quella fonte; Claude Code applica comunque i limiti da altre fonti

1041 1096

1042Questo esempio limita ogni modello a `medium` ed esenenta Sonnet 4.6:1097Questo esempio limita ogni modello a `medium` ed esenenta Sonnet 4.6:

1043 1098

1052}1107}

1053```1108```

1054 1109

1055Quando l'organizzazione imposta anche un [limite di effort](/docs/it/model-config#organization-effort-limits) per un modello, si applica il limite inferiore dei due.1110Quando la tua organizzazione imposta anche un [limite di effort](/docs/it/model-config#organization-effort-limits) per un modello, si applica il limite inferiore dei due.

1056 1111

1057<h3 id="model">1112<h3 id="model">

1058 `model`1113 `model`

1059</h3>1114</h3>

1060 1115

1061Impostare il modello che ogni nuova sessione utilizza, quindi non è necessario sceglierne uno con `/model` ogni volta. Impostarlo qui non impedisce di cambiare modello a metà sessione. Se l'amministratore ha impostato un [modello predefinito dell'organizzazione](/docs/it/model-config#organization-default-model) per ignorare la selezione dell'utente, si ottiene quel modello anche quando si imposta questa chiave nelle impostazioni utente, progetto o locali.1116Imposta il modello che ogni nuova sessione utilizza, quindi non devi sceglierne uno con `/model` ogni volta. Impostarlo qui non ti impedisce di cambiare a metà sessione. Se il tuo amministratore ha impostato un [modello predefinito dell'organizzazione](/docs/it/model-config#organization-default-model) per ignorare la selezione dell'utente, ottieni quel modello anche quando imposti questa chiave nelle impostazioni utente, progetto o locale.

1062 1117

1063* **Scope**: [`Any file`](#scopes)1118* **Scope**: [`Any file`](#scopes)

1064* **Type**: string, un alias di modello o ID modello completo1119* **Type**: string, un alias di modello o ID modello completo

1065* **Default**: non impostato, quindi Claude Code utilizza il modello predefinito dell'account1120* **Default**: non impostato, quindi Claude Code utilizza il modello predefinito del tuo account

1066* **Per-session overrides**: `--model` ha la precedenza su [`ANTHROPIC_MODEL`](/docs/it/env-vars), e entrambi hanno la precedenza su questa chiave per una sessione, incluso su un `model` gestito; un elenco [`availableModels`](#availablemodels) si applica comunque alla scelta1121* **Per-session overrides**: `--model` ha la precedenza su [`ANTHROPIC_MODEL`](/docs/it/env-vars), e entrambi hanno la precedenza su questa chiave per una sessione, incluso su un `model` gestito; un elenco [`availableModels`](#availablemodels) si applica comunque alla scelta

1067 1122

1068```json settings.json theme={null}1123```json settings.json theme={null}

1077 `modelOverrides`1132 `modelOverrides`

1078</h3>1133</h3>

1079 1134

1080Mappare gli ID dei modelli Anthropic agli ID dei modelli specifici del provider, come gli ARN del profilo di inferenza di Amazon Bedrock. Ogni voce del selettore di modelli utilizza quindi il suo valore mappato quando chiama l'API del provider. Gli amministratori lo utilizzano su [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/docs/it/model-config#override-model-ids-per-version) per instradare ogni versione del modello a un profilo di inferenza specifico, nome di versione o distribuzione per governance, allocazione dei costi o instradamento regionale.1135Mappa gli ID modello Anthropic agli ID modello specifici del provider, come i profili di inferenza ARN di Amazon Bedrock. Ogni voce del selettore di modelli utilizza quindi il suo valore mappato quando chiama l'API del provider. Gli amministratori lo utilizzano su [Amazon Bedrock, Agent Platform di Google Cloud, e Microsoft Foundry](/docs/it/model-config#override-model-ids-per-version) per instradare ogni versione di modello a un profilo di inferenza specifico, nome di versione, o distribuzione per governance, allocazione dei costi, o instradamento regionale.

1081 1136

1082* **Scope**: [`Any file`](#scopes)1137* **Scope**: [`Any file`](#scopes)

1083* **Type**: object che mappa l'ID del modello all'ID del modello del provider1138* **Type**: object che mappa ID modello a ID modello del provider

1084* **Default**: non impostato1139* **Default**: non impostato

1085 1140

1086Questo esempio instrada ogni chiamata per Opus 4.6 al profilo di inferenza Bedrock denominato:1141Questo esempio instrada ogni chiamata per Opus 4.6 al profilo di inferenza Bedrock denominato:

1093}1148}

1094```1149```

1095 1150

1096Vedere [Ignorare gli ID dei modelli per versione](/docs/it/model-config#override-model-ids-per-version).1151Vedi [Ignora gli ID modello per versione](/docs/it/model-config#override-model-ids-per-version).

1097 1152

1098<h3 id="modelpicker">1153<h3 id="modelpicker">

1099 `modelPicker`1154 `modelPicker`

1100</h3>1155</h3>

1101 1156

1102Elencare i modelli che il selettore `/model` offre, nell'ordine in cui li si scrive e sotto le etichette che si scelgono, quindi il selettore elenca i modelli che l'organizzazione esegue, dopo la lineup integrata o al suo posto. Il `model` di ogni riga viene preso verbatim, quindi accetta qualsiasi cosa accetti `--model`: un alias come `opus`, un ID modello Anthropic, o un ID in formato provider per Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o un gateway LLM. Richiede Claude Code v2.1.242 o successivo.1157Elenca i modelli che il selettore `/model` offre, nell'ordine in cui li scrivi e sotto le etichette che scegli, quindi il selettore elenca i modelli che la tua organizzazione esegue, dopo la lineup integrata o al suo posto. L'`model` di ogni riga viene preso verbatim, quindi accetta qualsiasi cosa che `--model` accetta: un alias come `opus`, un ID modello Anthropic, o un ID in formato provider per Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, o un gateway LLM. Richiede Claude Code v2.1.242 o successivo.

1103 1158

1104* **Scope**: [`User or managed`](#scopes). Claude Code legge la chiave dalle impostazioni gestite, `--settings` e impostazioni utente, e la ignora nelle impostazioni progetto e locali quindi un repository che si clona non può rietichettare il selettore. Il più alto dei tre che imposta la chiave fornisce l'intera lineup, e Claude Code non combina mai lineup da due fonti.1159* **Scope**: [`User or managed`](#scopes). Claude Code legge la chiave dalle impostazioni gestite, `--settings`, e impostazioni utente, e la ignora nelle impostazioni di progetto e locale quindi un repository che cloni non può rietichettare il selettore. Il più alto di quei tre che imposta la chiave fornisce l'intera lineup, e Claude Code non combina mai lineup da due fonti.

1105* **Type**: object con un array `options` di righe e un Boolean `replaceBuiltInOptions` opzionale1160* **Type**: object con un array `options` di righe e un Boolean `replaceBuiltInOptions` opzionale

1106* **Default**: non impostato, quindi il selettore mostra la lineup integrata1161* **Default**: non impostato, quindi il selettore mostra la lineup integrata

1107 1162

1108Questo esempio aggiunge due distribuzioni Bedrock dopo la lineup integrata, sotto nomi che il team riconosce:1163Questo esempio aggiunge due distribuzioni Bedrock dopo la lineup integrata, sotto nomi che il tuo team riconosce:

1109 1164

1110```json managed-settings.json theme={null}1165```json managed-settings.json theme={null}

1111{1166{

1134 1189

1136| :- | :- | :- |1191| :- | :- | :- |

1137| `options` | array di righe, ognuna con un `model` obbligatorio e un `label` e `description` opzionali | Le righe che il selettore mostra, in questo ordine, tranne che una riga disattivata si sposta in fondo. Senza un `label`, Claude Code intitola la riga con il nome integrato per un modello che conosce, o l'ID del modello altrimenti, e senza una `description` scrive una seconda riga generica |1192| `options` | array di righe, ognuna con un `model` richiesto e `label`, `description`, e `behavesAs` opzionali | Le righe che il selettore mostra, in questo ordine, tranne che una riga disattivata si sposta in fondo. Senza un `label`, Claude Code intitola la riga con il nome integrato per un modello che conosce, o l'ID modello altrimenti, e senza una `description` scrive una seconda riga generica |

1138| `replaceBuiltInOptions` | Boolean, default `false` | Impostarlo su `true` per mostrare solo queste righe, **Default** e una riga per il modello che la sessione sta già utilizzando. Lasciarlo non impostato per aggiungere queste righe dopo la lineup integrata |1193| `replaceBuiltInOptions` | Boolean, default `false` | Impostalo a `true` per mostrare solo queste righe, **Default**, e una riga per il modello che la sessione sta già utilizzando. Lascialo non impostato per aggiungere queste righe dopo la lineup integrata |

1139 1194

1140Con `replaceBuiltInOptions` attivato, Claude Code nasconde ogni altra riga: la lineup integrata, le righe che aggiunge per le voci [`availableModels`](#availablemodels), i modelli che la [scoperta del gateway](/docs/it/llm-gateway-protocol#model-discovery) ha trovato, e [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/it/model-config#add-a-custom-model-option). Con esso disattivato, Claude Code salta un modello elencato che la lineup integrata copre già. Un'etichetta cambia ciò che il selettore mostra, non quale modello Claude Code esegue.1195Una voce in `options` può anche portare un `behavesAs` string opzionale accanto al suo `model`, che richiede v2.1.257 o successivo. Impostalo all'ID di un modello che la tua versione di Claude Code già conosce, come `claude-opus-4-8`, su una voce il cui `model` è più recente della tua versione. Claude Code applica quindi le capacità di quel modello conosciuto e i default di effort alla voce invece di trattare il suo modello come sconosciuto. L'etichetta della voce e l'ID modello che Claude Code invia nelle richieste non cambiano.

1141 1196

1142Un elenco [`availableModels`](#availablemodels) si applica comunque a queste righe. Prima di aggiungere un modello elencato all'elenco consentito, leggere [Comportamento di unione](/docs/it/model-config#merge-behavior): un ID modello specifico restringe la voce wildcard della sua famiglia. Claude Code controlla anche ogni riga rispetto alla sessione prima di mostrare il selettore:1197Con `replaceBuiltInOptions` attivo, Claude Code nasconde ogni altra riga: la lineup integrata, le righe che aggiunge per le voci [`availableModels`](#availablemodels), i modelli che la [scoperta del gateway](/docs/it/llm-gateway-protocol#model-discovery) ha trovato, e [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/it/model-config#add-a-custom-model-option). Con esso disattivato, Claude Code salta un modello elencato che la lineup integrata già copre. Un'etichetta cambia quello che il selettore mostra, non quale modello Claude Code esegue.

1143 1198

1144* **Dropped**: una riga che Claude Code non può servire, come un modello ritirato o un modello a cui l'organizzazione non ha accesso1199Un elenco [`availableModels`](#availablemodels) si applica comunque a queste righe. Prima di aggiungere un modello elencato all'elenco consentito, leggi [Comportamento di unione](/docs/it/model-config#merge-behavior): un ID modello specifico restringe la voce wildcard della sua famiglia. Claude Code controlla anche ogni riga rispetto alla sessione prima di mostrare il selettore:

1145* **Grayed out**: una riga che non è possibile selezionare ancora, mostrata con il motivo1200

1201* **Dropped**: una riga che Claude Code non può servire, come un modello ritirato o un modello a cui la tua organizzazione non ha accesso

1202* **Grayed out**: una riga che non puoi ancora selezionare, mostrata con il motivo

1146* **No row survives**: Claude Code mantiene la lineup integrata, filtrata dall'elenco consentito come al solito1203* **No row survives**: Claude Code mantiene la lineup integrata, filtrata dall'elenco consentito come al solito

1147 1204

1148Claude Code elimina una riga che non può analizzare e mantiene il resto. Vedere [Correggere un file di impostazioni rotto](/docs/it/settings#fix-a-broken-settings-file).1205Claude Code elimina una riga che non può analizzare e mantiene il resto. Vedi [Ripara un file di impostazioni rotto](/docs/it/settings#fix-a-broken-settings-file).

1149 1206

1150<h3 id="modelpricing">1207<h3 id="modelpricing">

1151 `modelPricing`1208 `modelPricing`

1152</h3>1209</h3>

1153 1210

1154Segnalare la spesa alle tariffe che l'organizzazione paga invece del prezzo di listino. Impostarlo quando l'organizzazione ha tariffe contrattuali, quindi le cifre in dollari che gli sviluppatori vedono corrispondono alla fattura. Claude Code applica le tariffe in `/usage`, la [riga di stato](/docs/it/statusline), l'`total_cost_usd` dell'Agent SDK, il limite [`--max-budget-usd`](/docs/it/cli-reference) e la metrica di costo [OpenTelemetry](/docs/it/monitoring-usage) e gli eventi. Si forniscono le tariffe: Claude Code non le legge dal contratto o dalla Claude Console. Richiede Claude Code v2.1.242 o successivo.1211Segnala la spesa alle tariffe che la tua organizzazione paga invece del prezzo di listino. Impostalo quando la tua organizzazione ha tariffe contrattuali, quindi le cifre in dollari che gli sviluppatori vedono corrispondono alla tua fattura. Claude Code applica le tariffe in `/usage`, la [riga di stato](/docs/it/statusline), l'`total_cost_usd` di Agent SDK, il limite [`--max-budget-usd`](/docs/it/cli-reference), e la metrica di costo [OpenTelemetry](/docs/it/monitoring-usage) e gli eventi. Fornisci le tariffe: Claude Code non le legge dal tuo contratto o dalla Claude Console. Richiede Claude Code v2.1.242 o successivo.

1155 1212

1156* **Scope**: [`Managed`](#scopes). Distribuire la chiave tramite impostazioni gestite dal server, una politica MDM, un file `managed-settings.json` o un [helper di politica](/docs/it/managed-settings#compute-the-policy-with-a-helper-program). Claude Code la ignora nelle impostazioni utente, progetto e locali, in `--settings` e su Windows nel [registro HKCU](/docs/it/managed-settings#where-each-mechanism-stores-the-policy) scrivibile dall'utente. Con impostazioni gestite dal server, ogni sessione segnala i costi al prezzo di listino fino a quando il [fetch delle impostazioni](/docs/it/server-managed-settings#fetch-and-caching-behavior) di quella sessione non ha confermato l'impostazione. Un'applicazione host che incorpora Claude Code e imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars) può fornire una tabella propria tramite l'opzione SDK [`managedSettings`](/docs/it/agent-sdk/typescript#options), che Claude Code utilizza solo quando nessuna fonte gestita imposta la chiave e solo in Claude Code v2.1.246 o successivo.1213* **Scope**: [`Managed`](#scopes). Distribuisci la chiave tramite impostazioni gestite dal server, una politica MDM, un file `managed-settings.json`, o un [helper di politica](/docs/it/managed-settings#compute-the-policy-with-a-helper-program). Claude Code la ignora nelle impostazioni utente, progetto e locale, in `--settings`, e su Windows nel [registro HKCU](/docs/it/managed-settings#where-each-mechanism-stores-the-policy) scrivibile dall'utente. Con impostazioni gestite dal server, ogni sessione segnala i costi al prezzo di listino fino a quando il [fetch di impostazioni](/docs/it/server-managed-settings#fetch-and-caching-behavior) di quella sessione ha confermato l'impostazione. Un'applicazione host che incorpora Claude Code e imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars) può fornire una tabella propria tramite l'opzione SDK [`managedSettings`](/docs/it/agent-sdk/typescript#options), che Claude Code utilizza solo quando nessuna fonte gestita imposta la chiave e solo in Claude Code v2.1.246 o successivo.

1157* **Type**: object con un `multiplier` opzionale e una mappa `overrides` opzionale1214* **Type**: object con un `multiplier` opzionale e una mappa `overrides` opzionale

1158* **Default**: non impostato, quindi Claude Code segnala il prezzo di listino a meno che un'applicazione host non fornisca una tabella1215* **Default**: non impostato, quindi Claude Code segnala il prezzo di listino a meno che un'applicazione host non fornisca una tabella

1159 1216

1160Impostare `multiplier` da solo per uno sconto fisso o un ricarico, `overrides` da solo per tariffe per modello, o entrambi.1217Imposta `multiplier` da solo per uno sconto o markup fisso, `overrides` da solo per tariffe per modello, o entrambi.

1161 1218

1162Questo esempio imposta tariffe contrattuali per Sonnet 4.6 e quindi riduce ogni cifra, la riga Sonnet inclusa, del 15%:1219Questo esempio imposta tariffe contrattuali per Sonnet 4.6 e poi riduce ogni cifra, la riga Sonnet inclusa, del 15%:

1163 1220

1164```json managed-settings.json theme={null}1221```json managed-settings.json theme={null}

1165{1222{

1177}1234}

1178```1235```

1179 1236

1180Impostare `multiplier` sopra 1, fino a 10, per contrassegnare ogni cifra. Un ricarico richiede Claude Code v2.1.271 o successivo. Le versioni precedenti ignorano un `multiplier` sopra 1 con un avviso e mantengono il resto dell'impostazione.1237Imposta `multiplier` sopra 1, fino a 10, per aumentare ogni cifra. Un markup richiede Claude Code v2.1.271 o successivo. Le versioni precedenti ignorano un `multiplier` sopra 1 con un avviso e mantengono il resto dell'impostazione.

1181 1238

1182Per i passaggi, incluso come confermare che le tariffe sono in vigore, vedere [Segnalare la spesa alle tariffe contrattuali](/docs/it/costs#report-spend-at-your-contracted-rates).1239Per i passaggi, incluso come confermare che le tariffe sono in vigore, vedi [Segnala la spesa alle tue tariffe contrattuali](/docs/it/costs#report-spend-at-your-contracted-rates).

1183 1240

1184<span id="modelpricing-multiplier" />1241<span id="modelpricing-multiplier" />

1185 1242

1191 1248

1193| :- | :- | :- |1250| :- | :- | :- |

1194| `multiplier` | numero maggiore di 0 e al massimo 10 | Scala ogni costo che Claude Code calcola, indipendentemente dal fatto che una riga `overrides` lo copra. Sotto 1 è uno sconto, sopra 1 un ricarico |1251| `multiplier` | number maggiore di 0 e al massimo 10 | Scala ogni costo che Claude Code calcola, indipendentemente dal fatto che una riga `overrides` la copra. Sotto 1 è uno sconto, sopra 1 un markup |

1195| `overrides` | mappa di ID modello a un oggetto di tariffa con `input`, `output`, `cacheRead` e `cacheWrite`, ognuno da 0 a 10000 | Le tariffe USD-per-milione-token per quel modello, tutti e quattro obbligatori. `cacheWrite` copre sia le scritture della cache di cinque minuti che di un'ora. Vedere [Quali modelli si applica una riga modelPricing](#which-models-a-modelpricing-row-applies-to) |1252| `overrides` | mappa di ID modello a un oggetto di tariffa con `input`, `output`, `cacheRead`, e `cacheWrite`, ognuno da 0 a 10000 | Le tariffe USD-per-milione-token per quel modello, tutti e quattro richiesti. `cacheWrite` copre sia le scritture di cache di cinque minuti che di un'ora. Vedi [Quali modelli si applica una riga modelPricing](#which-models-a-modelpricing-row-applies-to) |

1196 1253

1197Claude Code utilizza le tariffe di una riga esattamente come le si è scritte, senza aggiungere il supplemento della modalità veloce o la [tariffa di inferenza solo negli Stati Uniti](https://platform.claude.com/docs/en/about-claude/pricing). Se si imposta anche `multiplier`, Claude Code lo applica in aggiunta alle tariffe della riga. Claude Code elimina una riga con una tariffa che non può analizzare, o un `multiplier` che non può analizzare, e mantiene il resto; vedere [Correggere un file di impostazioni rotto](/docs/it/settings#fix-a-broken-settings-file).1254Claude Code utilizza le tariffe di una riga esattamente come le hai scritte, senza aggiungere il markup di modalità veloce o la [tariffa di inferenza solo negli USA](https://platform.claude.com/docs/en/about-claude/pricing). Se imposti anche `multiplier`, Claude Code lo applica in cima alle tariffe della riga. Claude Code elimina una riga con una tariffa che non può analizzare, o un `multiplier` che non può analizzare, e mantiene il resto; vedi [Ripara un file di impostazioni rotto](/docs/it/settings#fix-a-broken-settings-file).

1198 1255

1199<h4 id="which-models-a-modelpricing-row-applies-to">1256<h4 id="which-models-a-modelpricing-row-applies-to">

1200 Quali modelli si applica una riga `modelPricing`1257 Quali modelli si applica una riga `modelPricing`

1201</h4>1258</h4>

1202 1259

1203Claude Code decide quali modelli si applica una riga dalla chiave della riga:1260Claude Code decide quali modelli si applica una riga da chiave della riga:

1204 1261

1205* **L'ID di un modello integrato**: una chiave che Claude Code stesso utilizza per un modello integrato, indipendentemente dal fatto che quella chiave sia l'ID del modello stesso, come `claude-sonnet-4-6`, o il suo ID Bedrock, Agent Platform o Foundry. Claude Code applica la riga a ogni ID snapshot datato e ID specifico del provider di quel modello.1262* **L'ID di un modello integrato**: una chiave che Claude Code stesso utilizza per un modello integrato, indipendentemente dal fatto che quella chiave sia l'ID del modello stesso, come `claude-sonnet-4-6`, o il suo ID Bedrock, Agent Platform, o Foundry. Claude Code applica la riga a ogni ID snapshot datato e ID specifico del provider di quel modello.

1206* **Qualsiasi altra chiave**: una chiave che non è l'ID di un modello integrato, come un alias di modello gateway. Claude Code applica la riga solo a quell'ID. Quando un ID modello corrisponde esattamente a una delle chiavi e rientra anche in una riga con chiave dall'ID di un modello integrato, Claude Code utilizza la corrispondenza esatta.1263* **Qualsiasi altra chiave**: una chiave che non è l'ID di un modello integrato, come un alias di modello gateway. Claude Code applica la riga a quell'ID solo. Quando un ID modello corrisponde a una delle tue chiavi esattamente e cade anche sotto una riga con chiave dall'ID di un modello integrato, Claude Code utilizza la corrispondenza esatta.

1207* **Un profilo di inferenza dell'applicazione Bedrock**: una volta che Claude Code ha risolto il profilo al modello a cui instrada, tramite la mappa [`modelOverrides`](#modeloverrides) o la ricerca [`bedrock:GetInferenceProfile`](/docs/it/amazon-bedrock#iam-configuration), Claude Code applica la riga di quel modello al profilo.1264* **Un profilo di inferenza dell'applicazione Bedrock**: una volta che Claude Code ha risolto il profilo al modello a cui instrada, tramite la tua mappa [`modelOverrides`](#modeloverrides) o la ricerca [`bedrock:GetInferenceProfile`](/docs/it/amazon-bedrock#iam-configuration), Claude Code applica la riga di quel modello al profilo.

1208 1265

1209<h3 id="modelsettings">1266<h3 id="modelsettings">

1210 `modelSettings`1267 `modelSettings`

1211</h3>1268</h3>

1212 1269

1213Salvare un [livello di effort](/docs/it/model-config#adjust-effort-level) per ogni modello che si utilizza. Richiede Claude Code v2.1.251 o successivo.1270Salva un [livello di effort](/docs/it/model-config#adjust-effort-level) per ogni modello che utilizzi. Richiede Claude Code v2.1.251 o successivo.

1214 1271

1215In una sessione interattiva sulla propria macchina, quando si salva `low`, `medium`, `high` o `xhigh` come predefinito con `/effort` o il cursore di effort del selettore `/model`, Claude Code scrive quel livello qui sotto il modello che si sta utilizzando, quindi raramente si modifica questa chiave manualmente. Quando si sceglie uno di questi livelli nel [selettore di modelli dell'estensione VS Code](/docs/it/vs-code#use-the-prompt-box), Claude Code lo salva qui allo stesso modo. La voce [`effortLevel`](#effortlevel) elenca le sessioni dove `/effort` si applica solo a quella sessione.1272In una sessione interattiva sulla tua macchina, quando salvi `low`, `medium`, `high`, o `xhigh` come tuo default con `/effort` o il cursore di effort del selettore `/model`, Claude Code scrive quel livello qui sotto il modello che stai utilizzando, quindi raramente modifichi questa chiave tu stesso. Quando scegli uno di quei livelli nel [selettore di modelli dell'estensione VS Code](/docs/it/vs-code#use-the-prompt-box), Claude Code lo salva qui allo stesso modo. La voce [`effortLevel`](#effortlevel) elenca le sessioni dove `/effort` si applica solo a quella sessione.

1216 1273

1217Modificare la chiave manualmente per cambiare o rimuovere un livello salvato.1274Modifica la chiave manualmente per cambiare o rimuovere un livello che hai salvato.

1218 1275

1219Un `effortLevel` di un modello qui ha la precedenza sul [`effortLevel`](#effortlevel) di livello superiore nello stesso file di impostazioni. Tra file, Claude Code risolve ogni modello separatamente: il [file di impostazioni](/docs/it/settings#settings-precedence) con la precedenza più alta che imposta un `effortLevel` per quel modello o il `effortLevel` di livello superiore che [si applica a quel modello](#effortlevel) decide, quindi un `effortLevel` nelle impostazioni gestite supera un livello salvato nelle impostazioni utente. [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) elenca cos'altro può ignorare un livello salvato, come `--effort` al lancio.1276Un `effortLevel` di un modello qui ha la precedenza sul [`effortLevel`](#effortlevel) di livello superiore nello stesso file di impostazioni. Tra file, Claude Code risolve ogni modello separatamente: il [file di impostazioni](/docs/it/settings#settings-precedence) con la precedenza più alta che imposta un `effortLevel` per quel modello o un `effortLevel` di livello superiore che [si applica a quel modello](#effortlevel) decide, quindi un `effortLevel` nelle impostazioni gestite supera un livello che hai salvato nelle impostazioni utente. [Regola il livello di effort](/docs/it/model-config#adjust-effort-level) elenca cos'altro può ignorare un livello salvato, come `--effort` al lancio.

1220 1277

1221Per limitare l'effort di un modello piuttosto che impostare il suo livello, aggiungere un campo [`maxEffortLevel`](#maxeffortlevel) alla voce di quel modello. Il campo richiede Claude Code v2.1.267 o successivo.1278Per limitare l'effort di un modello piuttosto che impostare il suo livello, aggiungi un campo [`maxEffortLevel`](#maxeffortlevel) alla voce di quel modello. Il campo richiede Claude Code v2.1.267 o successivo.

1222 1279

1223* **Scope**: [`Any file`](#scopes)1280* **Scope**: [`Any file`](#scopes)

1224* **Type**: object che mappa un nome di modello a un object con un campo `effortLevel`, uno di `"low"`, `"medium"`, `"high"` o `"xhigh"`, un campo [`maxEffortLevel`](#maxeffortlevel) o entrambi1281* **Type**: object che mappa un nome di modello a un object con un campo `effortLevel`, uno di `"low"`, `"medium"`, `"high"`, o `"xhigh"`, un campo [`maxEffortLevel`](#maxeffortlevel), o entrambi

1225* **Default**: non impostato1282* **Default**: non impostato

1226 1283

1227Claude Code scrive ogni voce sotto il nome canonico del modello, come `claude-opus-5-5`, e corrisponde all'alias di quel modello, con suffisso di data, `[1m]` e ID specifici del provider riconosciuti alla stessa voce.1284Claude Code scrive ogni voce sotto il nome canonico del modello, come `claude-opus-5-5`, e corrisponde all'alias di quel modello, datato, `[1m]`, e ID specifici del provider riconosciuti alla stessa voce.

1228 1285

1229Questo esempio mantiene Opus 5.5 a `high` mentre altri modelli utilizzano i loro livelli salvati o predefiniti:1286Questo esempio mantiene Opus 5.5 a `high` mentre altri modelli utilizzano i loro livelli salvati o default:

1230 1287

1231```json settings.json theme={null}1288```json settings.json theme={null}

1232{1289{

1238}1295}

1239```1296```

1240 1297

1241Eseguire `/effort auto` per cancellare il livello salvato per il modello che si sta utilizzando. Claude Code lascia le altre voci e qualsiasi `effortLevel` di livello superiore in vigore.1298Esegui `/effort auto` per cancellare il tuo livello salvato per il modello che stai utilizzando. Claude Code lascia le altre voci e qualsiasi `effortLevel` di livello superiore in posizione.

1242 1299

1243<h3 id="outputstyle">1300<h3 id="outputstyle">

1244 `outputStyle`1301 `outputStyle`

1245</h3>1302</h3>

1246 1303

1247Selezionare uno [stile di output](/docs/it/output-styles) per nome. Uno stile di output è un insieme salvato di istruzioni che cambia il ruolo, il tono e il formato di output di Claude, come gli stili Explanatory e Learning integrati o uno che si è scritto.1304Seleziona uno [stile di output](/docs/it/output-styles) per nome. Uno stile di output è un insieme salvato di istruzioni che cambia il ruolo, il tono e il formato di output di Claude, come gli stili Explanatory e Learning integrati o uno che hai scritto tu stesso.

1248 1305

1249Se si cambia questa chiave durante una sessione, Claude utilizza il nuovo stile a partire dal messaggio successivo. Per il costo di quella cache di prompt, vedere [Cambiare lo stile di output](/docs/it/prompt-caching#changing-output-style). Prima della v2.1.251, la modifica si applicava solo dopo aver eseguito `/clear` o avviato una nuova sessione.1306Se cambi questa chiave durante una sessione, Claude utilizza il nuovo stile a partire dal tuo prossimo messaggio. Per quale costo ha in prompt caching, vedi [Cambio dello stile di output](/docs/it/prompt-caching#changing-output-style). Prima della v2.1.251, la modifica si applicava solo dopo aver eseguito `/clear` o avviato una nuova sessione.

1250 1307

1251* **Scope**: [`Any file`](#scopes)1308* **Scope**: [`Any file`](#scopes)

1252* **Type**: string, il nome di uno stile di output [integrato](/docs/it/output-styles#built-in-output-styles) o [personalizzato](/docs/it/output-styles#create-a-custom-output-style)1309* **Type**: string, il nome di uno [stile di output integrato](/docs/it/output-styles#built-in-output-styles) o [personalizzato](/docs/it/output-styles#create-a-custom-output-style)

1253* **Default**: non impostato, quindi Claude Code utilizza lo stile predefinito1310* **Default**: non impostato, quindi Claude Code utilizza lo stile predefinito

1254 1311

1255Questo esempio seleziona lo stile Explanatory integrato, che aggiunge approfondimenti educativi tra i compiti:1312Questo esempio seleziona lo stile Explanatory integrato, che aggiunge approfondimenti educativi tra i compiti:

1264 `promptCacheTtl`1321 `promptCacheTtl`

1265</h3>1322</h3>

1266 1323

1267Scegliere quanto tempo la [prompt cache](/docs/it/prompt-caching) mantiene la conversazione principale. Questa chiave si applica ai turni interattivi, `-p` e Agent SDK, insieme agli helper che Claude Code esegue inline con essi. La durata di un'ora mantiene la cache calda durante pause più lunghe, e l'API [fattura ogni scrittura della cache a una tariffa più elevata](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) rispetto alla durata di cinque minuti. Richiede Claude Code v2.1.242 o successivo.1324Scegli quanto tempo la [cache prompt](/docs/it/prompt-caching) mantiene la conversazione principale. Questa chiave si applica ai tuoi turni interattivi, `-p`, e Agent SDK, insieme agli helper che Claude Code esegue inline con loro. La durata di un'ora mantiene la cache calda attraverso pause più lunghe, e l'API [fattura ogni scrittura di cache a una tariffa più elevata](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) rispetto alla durata di cinque minuti. Richiede Claude Code v2.1.242 o successivo.

1268 1325

1269* **Scope**: [`Any file`](#scopes)1326* **Scope**: [`Any file`](#scopes)

1270* **Type**: string, uno di:1327* **Type**: string, uno di:

1271 * `"5m"`: la cache si mantiene per cinque minuti1328 * `"5m"`: la cache si mantiene per cinque minuti

1272 * `"1h"`: la cache si mantiene per un'ora1329 * `"1h"`: la cache si mantiene per un'ora

1273* **Default**: non impostato, quindi ogni richiesta di conversazione principale ottiene la [durata predefinita](/docs/it/prompt-caching#which-ttl-each-request-gets)1330* **Default**: non impostato, quindi ogni richiesta di conversazione principale ottiene la [sua durata predefinita](/docs/it/prompt-caching#which-ttl-each-request-gets)

1274* **Per-session overrides**: [`FORCE_PROMPT_CACHING_5M`](/docs/it/env-vars) ha la precedenza su tutto il resto, poi [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/it/env-vars), poi questa chiave, e infine [`ENABLE_PROMPT_CACHING_1H`](/docs/it/env-vars)1331* **Per-session overrides**: [`FORCE_PROMPT_CACHING_5M`](/docs/it/env-vars) ha la precedenza su tutto il resto, poi [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/it/env-vars), poi questa chiave, e per ultimo [`ENABLE_PROMPT_CACHING_1H`](/docs/it/env-vars)

1275 1332

1276Questo esempio mantiene la conversazione principale sulla durata di un'ora e lascia i subagenti su cinque minuti:1333Questo esempio mantiene la conversazione principale sulla durata di un'ora e lascia i subagenti su cinque minuti:

1277 1334

1282}1339}

1283```1340```

1284 1341

1285Per il costo di ogni durata, vedere [Durata della cache](/docs/it/prompt-caching#cache-lifetime).1342Per quale costo ha ogni durata, vedi [Durata della cache](/docs/it/prompt-caching#cache-lifetime).

1286 1343

1287<h3 id="showthinkingsummaries">1344<h3 id="showthinkingsummaries">

1288 `showThinkingSummaries`1345 `showThinkingSummaries`

1289</h3>1346</h3>

1290 1347

1291Vedere i riassunti del [pensiero esteso](/docs/it/model-config#extended-thinking) di Claude nelle sessioni interattive. Impostarlo se si desidera i riassunti completi quando si espande il pensiero con `Ctrl+O`. Quando non impostato o `false`, l'API Anthropic redige i blocchi di pensiero e Claude Code mostra uno stub compresso; i provider di terze parti non redigono.1348Vedi riassunti del [pensiero esteso](/docs/it/model-config#extended-thinking) di Claude nelle sessioni interattive. Impostalo se vuoi i riassunti completi quando espandi il pensiero con `Ctrl+O`. Quando non impostato o `false`, l'API Anthropic redige i blocchi di pensiero e Claude Code mostra uno stub compresso; i provider di terze parti non redigono.

1292 1349

1293* **Scope**: [`Any file`](#scopes)1350* **Scope**: [`Any file`](#scopes)

1294* **Type**: Boolean1351* **Type**: Boolean

1295 * `true`: si vedono i riassunti completi del pensiero quando si espande il pensiero con `Ctrl+O`1352 * `true`: vedi riassunti di pensiero completi quando espandi il pensiero con `Ctrl+O`

1296 * `false`: l'API Anthropic redige i blocchi di pensiero e Claude Code mostra uno stub compresso1353 * `false`: l'API Anthropic redige i blocchi di pensiero e Claude Code mostra uno stub compresso

1297* **Default**: `false`1354* **Default**: `false`

1298 1355

1302}1359}

1303```1360```

1304 1361

1305La redazione cambia solo ciò che si vede, non ciò che il modello genera. Per ridurre la spesa di pensiero, [abbassare il budget o disattivare il pensiero](/docs/it/model-config#extended-thinking) invece.1362La redazione cambia solo quello che vedi, non quello che il modello genera. Per ridurre la spesa di pensiero, [abbassa il budget o disattiva il pensiero](/docs/it/model-config#extended-thinking) invece.

1306 1363

1307<h3 id="subagentpromptcachettl">1364<h3 id="subagentpromptcachettl">

1308 `subagentPromptCacheTtl`1365 `subagentPromptCacheTtl`

1309</h3>1366</h3>

1310 1367

1311Scegliere quanto tempo la [prompt cache](/docs/it/prompt-caching) mantiene le richieste che Claude Code effettua al di fuori della conversazione principale. Questa chiave si applica a [subagenti](/docs/it/sub-agents), [workflows](/docs/it/workflows) e le richieste di background e helper proprie di Claude Code, come la compattazione e i titoli di sessione. La durata di un'ora mantiene la cache calda durante pause più lunghe, e l'API [fattura ogni scrittura della cache a una tariffa più elevata](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) rispetto alla durata di cinque minuti. Richiede Claude Code v2.1.242 o successivo.1368Scegli quanto tempo la [cache prompt](/docs/it/prompt-caching) mantiene le richieste che Claude Code fa al di fuori della conversazione principale. Questa chiave si applica ai [subagenti](/docs/it/sub-agents), [workflow](/docs/it/workflows), e alle richieste di background e helper proprie di Claude Code, come la compattazione e i titoli di sessione. La durata di un'ora mantiene la cache calda attraverso pause più lunghe, e l'API [fattura ogni scrittura di cache a una tariffa più elevata](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) rispetto alla durata di cinque minuti. Richiede Claude Code v2.1.242 o successivo.

1312 1369

1313* **Scope**: [`Any file`](#scopes)1370* **Scope**: [`Any file`](#scopes)

1314* **Type**: string, uno di:1371* **Type**: string, uno di:

1315 * `"5m"`: la cache si mantiene per cinque minuti1372 * `"5m"`: la cache si mantiene per cinque minuti

1316 * `"1h"`: la cache si mantiene per un'ora1373 * `"1h"`: la cache si mantiene per un'ora

1317* **Default**: non impostato, quindi ognuna di queste richieste ottiene la [durata predefinita](/docs/it/prompt-caching#which-ttl-each-request-gets)1374* **Default**: non impostato, quindi ognuna di queste richieste ottiene la [sua durata predefinita](/docs/it/prompt-caching#which-ttl-each-request-gets)

1318* **Per-session overrides**: [`FORCE_PROMPT_CACHING_5M`](/docs/it/env-vars) ha la precedenza su tutto il resto, poi [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/it/env-vars), poi questa chiave, poi [`ENABLE_PROMPT_CACHING_1H`](/docs/it/env-vars), che chiede la durata di un'ora su ogni richiesta. Per dove il valore del frontmatter proprio di un subagente si classifica, vedere [Scegliere il TTL da soli](/docs/it/prompt-caching#choose-the-ttl-yourself)1375* **Per-session overrides**: [`FORCE_PROMPT_CACHING_5M`](/docs/it/env-vars) ha la precedenza su tutto il resto, poi [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/it/env-vars), poi questa chiave, poi [`ENABLE_PROMPT_CACHING_1H`](/docs/it/env-vars), che chiede la durata di un'ora su ogni richiesta. Per dove il valore frontmatter proprio di un subagente si classifica, vedi [Scegli il TTL tu stesso](/docs/it/prompt-caching#choose-the-ttl-yourself)

1319 1376

1320Questo esempio fornisce ai subagenti e alle altre richieste al di fuori della conversazione principale la durata di un'ora:1377Questo esempio dà ai subagenti e alle altre richieste al di fuori della conversazione principale la durata di un'ora:

1321 1378

1322```json settings.json theme={null}1379```json settings.json theme={null}

1323{1380{

1325}1382}

1326```1383```

1327 1384

1328Questa chiave copre le richieste che [`promptCacheTtl`](#promptcachettl) non copre, quindi impostare entrambi per scegliere una durata per ogni richiesta che Claude Code effettua. Per come la cache di un subagente differisce da quella della conversazione principale, vedere [Subagenti e la cache](/docs/it/prompt-caching#subagents-and-the-cache).1385Questa chiave copre le richieste che [`promptCacheTtl`](#promptcachettl) non copre, quindi imposta entrambi per scegliere una durata per ogni richiesta che Claude Code fa. Per come la cache di un subagente differisce da quella della conversazione principale, vedi [Subagenti e la cache](/docs/it/prompt-caching#subagents-and-the-cache).

1329 1386

1330<h3 id="switchmodelsonflag">1387<h3 id="switchmodelsonflag">

1331 `switchModelsOnFlag`1388 `switchModelsOnFlag`

1332</h3>1389</h3>

1333 1390

1334Scegliere cosa accade quando un [classificatore di sicurezza contrassegna una richiesta](/docs/it/model-config#automatic-model-fallback): passare al modello di fallback e continuare, o mettere in pausa in modo da poter scegliere tra passare e modificare il prompt.1391Scegli cosa succede quando un [classificatore di sicurezza contrassegna una richiesta](/docs/it/model-config#automatic-model-fallback): passa al modello di fallback e continua, o pausa così puoi scegliere tra passare e modificare il prompt.

1335 1392

1336* **Scope**: [`Any file`](#scopes). Appare in `/config` come **Switch models when a message is flagged**.1393* **Scope**: [`Any file`](#scopes). Appare in `/config` come **Switch models when a message is flagged**.

1337* **Type**: Boolean1394* **Type**: Boolean

1338 * `true`: Claude Code passa al modello di fallback e continua1395 * `true`: Claude Code passa al modello di fallback e continua

1339 * `false`: in una sessione interattiva Claude Code mette in pausa in modo da poter scegliere tra passare e modificare il prompt; dove nessuna finestra di dialogo può mostrare, come un'esecuzione `-p`, la richiesta contrassegnata termina come errore1396 * `false`: in una sessione interattiva Claude Code pausa così puoi scegliere tra passare e modificare il prompt; dove nessuna finestra di dialogo può mostrare, come un'esecuzione `-p`, la richiesta contrassegnata termina come errore

1340* **Default**: `true`, passa automaticamente1397* **Default**: `true`, passa automaticamente

1341 1398

1342```json settings.json theme={null}1399```json settings.json theme={null}

1345}1402}

1346```1403```

1347 1404

1348Vedere [Chiedere prima di passare](/docs/it/model-config#ask-before-switching).1405Vedi [Chiedi prima di passare](/docs/it/model-config#ask-before-switching).

1349 1406

1350<h3 id="ultracode">1407<h3 id="ultracode">

1351 `ultracode`1408 `ultracode`

1352</h3>1409</h3>

1353 1410

1354Avviare sessioni con [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) attivato. Con esso attivato, Claude pianifica un workflow per ogni compito sostanziale invece di aspettare che lo si chieda. Claude pianifica workflow solo quando i [workflow dinamici](/docs/it/workflows) sono abilitati per l'utente, il modello supporta `xhigh` effort, e nessun [limite di effort](/docs/it/model-config#organization-effort-limits) inferiore a `xhigh` si applica. In ogni caso, `ultracode: true` esegue la sessione a `xhigh` effort, o al limite quando un limite di effort è inferiore. Claude Code legge questa chiave ma non la scrive mai: `/effort ultracode` attiva ultracode solo per la sessione corrente.1411Avvia sessioni con [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) attivo. Con esso attivo, Claude pianifica un workflow per ogni compito sostanziale invece di aspettare che tu lo chieda. Claude pianifica workflow solo quando i [workflow dinamici](/docs/it/workflows) sono abilitati per te e il tuo modello supporta `xhigh` effort. La chiave non cambia il livello di effort della sessione: ultracode funziona a qualsiasi livello la sessione utilizza. Claude Code legge questa chiave ma non la scrive mai: `/effort ultracode` attiva ultracode solo per la sessione corrente.

1355 1412

1356* **Scope**: [`Any file`](#scopes)1413* **Scope**: [`Any file`](#scopes)

1357* **Type**: Boolean1414* **Type**: Boolean

1358 * `true`: le sessioni iniziano a `xhigh` effort, con ultracode attivato quando i workflow dinamici sono abilitati per l'utente, il modello supporta `xhigh` e nessun limite di effort è inferiore a `xhigh`1415 * `true`: le sessioni iniziano con ultracode attivo quando i workflow dinamici sono abilitati per te e il tuo modello supporta `xhigh`

1359 * `false`: le sessioni iniziano con ultracode disattivato1416 * `false`: le sessioni iniziano con ultracode disattivato

1360* **Default**: non impostato, quindi ultracode è disattivato1417* **Default**: non impostato, quindi ultracode è disattivato

1361* **Per-session overrides**: `/effort ultracode` attiva ultracode per una sessione senza questa chiave. Lo fa anche `--effort ultracode`, che richiede Claude Code v2.1.203 o successivo1418* **Per-session overrides**: `/effort ultracode` attiva ultracode per una sessione senza questa chiave, e `/effort ultracode off` lo disattiva per una sessione quando questa chiave è `true`. Il flag `--effort ultracode` lo attiva anche per una sessione, a `xhigh` effort, e richiede Claude Code v2.1.203 o successivo

1362 1419

1363```json settings.json theme={null}1420```json settings.json theme={null}

1364{1421{

1366}1423}

1367```1424```

1368 1425

1369Ultracode esegue la sessione a `xhigh` effort e ha la precedenza su `effortLevel` e voci [`modelSettings`](#modelsettings). Se un [limite di effort](/docs/it/model-config#organization-effort-limits) inferiore a `xhigh` si applica al modello, come un'impostazione [`maxEffortLevel`](#maxeffortlevel), la sessione funziona al limite e ultracode rimane disattivato. Claude quindi non pianifica workflow da solo, e `/effort` non offre `ultracode`. Una richiesta di controllo `apply_flag_settings` dell'Agent SDK accetta anche la chiave.1426Il livello di effort della sessione viene da [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings), e le altre [fonti di effort](/docs/it/model-config#adjust-effort-level), e un [limite di effort](/docs/it/model-config#organization-effort-limits) come [`maxEffortLevel`](#maxeffortlevel) abbassa quel livello senza disattivare ultracode. Questo e il modulo `/effort ultracode off` richiedono Claude Code v2.1.284 o successivo. Prima della v2.1.284, `ultracode: true` eseguiva la sessione a `xhigh` effort, e un limite di effort inferiore a `xhigh` manteneva ultracode disattivato. Una richiesta di controllo `apply_flag_settings` di Agent SDK accetta anche la chiave.

1370 1427

1371<h2 id="permission-settings">1428<h2 id="permission-settings">

1372 Impostazioni di autorizzazione1429 Impostazioni di autorizzazione

1489 `useAutoModeDuringPlan`1546 `useAutoModeDuringPlan`

1490</h3>1547</h3>

1491 1548

1492Scegli se Claude Code utilizza il classificatore della modalità automatica per esaminare i comandi shell in modalità piano. Con il valore predefinito `true`, il classificatore esamina ogni comando durante la pianificazione quando la modalità automatica è disponibile e non vedi alcun prompt. Imposta `false` per ottenere un prompt di autorizzazione per ogni comando al di fuori dell'insieme integrato di sola lettura. Appare in `/config` come **Usa modalità automatica durante il piano**.1549Scegli se Claude Code utilizza il classificatore della modalità automatica per esaminare i comandi shell in modalità piano. Con il valore predefinito `true`, il classificatore esamina ogni comando durante la pianificazione quando la modalità automatica è disponibile e non vedi alcun prompt, eccetto per [rimozioni di percorsi critici](/docs/it/permission-modes#critical-paths). Imposta `false` per ottenere un prompt di autorizzazione per ogni comando al di fuori dell'insieme integrato di sola lettura. Appare in `/config` come **Usa modalità automatica durante il piano**.

1493 1550

1494* **Ambito**: [`User, local, or managed`](#scopes). Un repository non può disattivarlo per te.1551* **Ambito**: [`User, local, or managed`](#scopes). Un repository non può disattivarlo per te.

1495* **Tipo**: Booleano1552* **Tipo**: Booleano

1496 * `true`: lo stesso di non impostato; quando la modalità automatica è disponibile, il classificatore esamina ogni comando shell durante la pianificazione invece di chiederti. Un `false` in uno qualsiasi di questi file lo disattiva comunque1553 * `true`: lo stesso di non impostato; quando la modalità automatica è disponibile, il classificatore esamina ogni comando shell durante la pianificazione invece di chiederti per esso, eccetto [rimozioni di percorsi critici](/docs/it/permission-modes#critical-paths). Un `false` in uno qualsiasi di questi file lo disattiva comunque

1497 * `false`: ricevi un prompt di autorizzazione per ogni comando al di fuori dell'insieme integrato di sola lettura1554 * `false`: ricevi un prompt di autorizzazione per ogni comando al di fuori dell'insieme integrato di sola lettura

1498* **Predefinito**: `true`1555* **Predefinito**: `true`

1499 1556

3017* [`CLAUDE_CODE_MESSAGING_SOCKET` e `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/it/env-vars#variables), che Claude Code esporta stesso, sono ignorate da ogni file. Ignorare la variabile socket richiede Claude Code v2.1.224 o successivo, e ignorare il token richiede v2.1.228 o successivo.3074* [`CLAUDE_CODE_MESSAGING_SOCKET` e `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/it/env-vars#variables), che Claude Code esporta stesso, sono ignorate da ogni file. Ignorare la variabile socket richiede Claude Code v2.1.224 o successivo, e ignorare il token richiede v2.1.228 o successivo.

3018* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/it/sessions#name-the-project-directory-yourself), che Claude Code legge solo dall'ambiente di avvio, è ignorata da ogni file; richiede v2.1.234 o successivo.3075* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/it/sessions#name-the-project-directory-yourself), che Claude Code legge solo dall'ambiente di avvio, è ignorata da ogni file; richiede v2.1.234 o successivo.

3019* [`CLAUDE_CODE_RESTRICTED`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, è ignorata da ogni file.3076* [`CLAUDE_CODE_RESTRICTED`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, è ignorata da ogni file.

3077* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, è ignorata da ogni file. La variabile richiede Claude Code v2.1.283 o successivo.

3078* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` e `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, sono ignorate da ogni file.

3020 3079

3021<h3 id="filecheckpointingenabled">3080<h3 id="filecheckpointingenabled">

3022 `fileCheckpointingEnabled`3081 `fileCheckpointingEnabled`

3416* **Type**: string, `"classic"` o `"readline"`3475* **Type**: string, `"classic"` o `"readline"`

3417* **Default**: unset3476* **Default**: unset

3418 3477

3478<h3 id="maxprosewidth">

3479 `maxProseWidth`

3480</h3>

3481

3482Limita la larghezza della prosa nelle risposte di Claude in modo che le righe rimangono leggibili in un terminale ampio. I paragrafi, i titoli, gli elenchi e le citazioni si avvolgono entro questo numero di colonne, mentre le tabelle e i blocchi di codice mantengono la larghezza completa del terminale. Richiede Claude Code v2.1.282 o successivo.

3483

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

3485* **Type**: numero di colonne del terminale, un numero intero, minimo `40`. Claude Code ignora qualsiasi altro valore

3486* **Default**: unset, quindi la prosa si avvolge al bordo del terminale

3487

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

3489{

3490 "maxProseWidth": 80

3491}

3492```

3493

3419<h3 id="prefersreducedmotion">3494<h3 id="prefersreducedmotion">

3420 `prefersReducedMotion`3495 `prefersReducedMotion`

3421</h3>3496</h3>

4090 4165

4091* **Ambito**: [`Any file`](#scopes)4166* **Ambito**: [`Any file`](#scopes)

4092* **Tipo**: stringa4167* **Tipo**: stringa

4093* **Predefinito**: non impostato, quindi Claude Code aggiunge `Co-Authored-By: <name> <noreply@anthropic.com>`. Il nome è il modello attivo della sessione, come `Claude Sonnet 5`.4168* **Predefinito**: non impostato, quindi Claude Code aggiunge `Co-Authored-By: <name> <noreply@anthropic.com>`. Il nome è il modello in uso quando viene effettuato il commit, come `Claude Sonnet 5`. Quando un [subagent](/docs/it/sub-agents) effettua il commit, il trailer nomina il modello del subagent.

4094 * Quando Claude Code riconosce il modello come un modello Claude ma non può confermarne la versione esatta, scrive `Claude` da solo.4169 * Quando Claude Code riconosce il modello come un modello Claude ma non può confermarne la versione esatta, scrive `Claude` da solo.

4095 * Quando non può abbinare l'ID del modello a nessun modello Claude, come un modello di terze parti servito attraverso un [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) personalizzato, scrive `Claude Code`.4170 * Quando non può abbinare l'ID del modello a nessun modello Claude, come un modello di terze parti servito attraverso un [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) personalizzato, scrive `Claude Code`.

4096 4171

5690* **Type**: Boolean5765* **Type**: Boolean

5691 * `true`: Claude Code connette il Controllo remoto automaticamente quando ogni sessione interattiva inizia5766 * `true`: Claude Code connette il Controllo remoto automaticamente quando ogni sessione interattiva inizia

5692 * `false`: Claude Code aspetta `/remote-control`5767 * `false`: Claude Code aspetta `/remote-control`

5693* **Default**: non impostato, quindi la connessione automatica segue il default amministratore della tua organizzazione quando ne è impostato uno e altrimenti il default attuale di Claude Code5768* **Default**: non impostato, quindi l'[auto-connect default](/docs/it/remote-control#enable-remote-control-for-all-sessions) si applica

5694* **Per-session overrides**: `--remote-control` attiva il Controllo remoto per una sessione anche quando questa chiave è `false` e nessun flag lo disattiva per una sessione5769* **Per-session overrides**: `--remote-control` attiva il Controllo remoto per una sessione anche quando questa chiave è `false` e nessun flag lo disattiva per una sessione

5695 5770

5696```json settings.json theme={null}5771```json settings.json theme={null}

5842 5917

5843Imposta l'URL del gateway a cui si connette la schermata `/login` Cloud gateway, in modo che le persone raggiungano il tuo [cloud gateway](/docs/it/claude-apps-gateway) senza digitare il suo indirizzo. La schermata non ha un campo URL: con questa chiave impostata, mostra l'URL del tuo gateway e si connette quando la persona preme Invio; senza di essa, dice loro di contattare il loro amministratore IT.5918Imposta l'URL del gateway a cui si connette la schermata `/login` Cloud gateway, in modo che le persone raggiungano il tuo [cloud gateway](/docs/it/claude-apps-gateway) senza digitare il suo indirizzo. La schermata non ha un campo URL: con questa chiave impostata, mostra l'URL del tuo gateway e si connette quando la persona preme Invio; senza di essa, dice loro di contattare il loro amministratore IT.

5844 5919

5845O questa chiave o `forceLoginMethod: "gateway"` rende la macchina solo gateway, quindi `/login` si apre sulla schermata Cloud gateway senza un selettore di metodo di accesso. Vedi [La policy dell'amministratore richiede un accesso Cloud gateway](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) per cosa succede a un accesso di prima parte residuo o a una chiave API. Imposta entrambe le chiavi in modo che la schermata si connetta invece di mostrare un errore.5920O questa chiave o `forceLoginMethod: "gateway"` rende la macchina solo gateway, ad eccezione delle sessioni che selezionano un provider cloud con `CLAUDE_CODE_USE_*`. `/login` si apre quindi sulla schermata Cloud gateway senza un selettore di metodo di accesso. Vedi [La policy dell'amministratore richiede un accesso Cloud gateway](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) per cosa succede a un accesso di prima parte residuo o a una chiave API. Imposta entrambe le chiavi in modo che la schermata si connetta invece di mostrare un errore.

5846 5921

5847* **Scope**: [`Managed`](#scopes). Leggi solo da una fonte sulla macchina: `managed-settings.json`, il plist macOS o il registro HKLM di Windows, o un helper di policy. Claude Code lo ignora nelle impostazioni HKCU e gestite dal server.5922* **Scope**: [`Managed`](#scopes). Leggi solo da una fonte sulla macchina: `managed-settings.json`, il plist macOS o il registro HKLM di Windows, o un helper di policy. Claude Code lo ignora nelle impostazioni HKCU e gestite dal server.

5848* **Type**: string, un URL completo incluso lo schema5923* **Type**: string, un URL completo incluso lo schema

6095 `cleanupPeriodDays`6170 `cleanupPeriodDays`

6096</h3>6171</h3>

6097 6172

6098Imposta quanti giorni Claude Code mantiene [i trascritti della sessione e altri dati dell'applicazione](/docs/it/claude-directory#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.6173Imposta quanti giorni Claude Code mantiene [i trascritti della sessione e altri dati dell'applicazione](/docs/it/claude-directory#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`](/docs/it/sessions#resume-a-session).

6099 6174

6100* **Scope**: [`Any file`](#scopes)6175* **Scope**: [`Any file`](#scopes)

6101* **Type**: numero di giorni, un numero intero, minimo `1`6176* **Type**: numero di giorni, un numero intero, minimo `1`

6439 `wslInheritsWindowsSettings`6514 `wslInheritsWindowsSettings`

6440</h3>6515</h3>

6441 6516

6442Fai in modo che Claude Code su WSL legga le impostazioni gestite dalla catena di politica Windows, con HKLM e il file delle impostazioni gestite Windows che hanno priorità su `/etc/claude-code` e HKCU al di sotto. Mentre la catena è attiva, Claude Code legge `/etc/claude-code` solo quando nessun file di impostazioni gestite o drop-in sotto `C:\Program Files\ClaudeCode\` fornisce una [chiave di politica](/docs/it/managed-settings#how-claude-code-combines-managed-sources). Impostalo per estendere la politica che già distribuisci su Windows alle sessioni WSL sulla stessa macchina, in modo che seguano le stesse regole delle sessioni host. Claude Code lo onora solo quando impostato nella chiave del registro HKLM o in un file di impostazioni gestite o drop-in sotto `C:\Program Files\ClaudeCode\`, entrambi i quali richiedono l'amministratore Windows per scrivere.6517Fai in modo che Claude Code su WSL legga le impostazioni gestite dalla catena di politica Windows, con HKLM e il file delle impostazioni gestite Windows che hanno priorità su `/etc/claude-code` e HKCU al di sotto. Mentre la catena è attiva, Claude Code legge `/etc/claude-code` solo quando [nessun documento amministrativo Windows è presente](/docs/it/managed-settings#present-admin-documents) nel valore del registro HKLM o nella cartella `C:\Program Files\ClaudeCode\`. Impostalo per estendere la politica che già distribuisci su Windows alle sessioni WSL sulla stessa macchina, in modo che seguano le stesse regole delle sessioni host. Claude Code lo onora solo quando impostato nella chiave del registro HKLM o in un file di impostazioni gestite o drop-in sotto `C:\Program Files\ClaudeCode\`, entrambi i quali richiedono l'amministratore Windows per scrivere.

6443 6518

6444* **Scope**: [`Managed`](#scopes). In una fonte Windows controllata dall'amministratore.6519* **Scope**: [`Managed`](#scopes). In una fonte Windows controllata dall'amministratore.

6445* **Type**: Boolean6520* **Type**: Boolean

6446 * `true`: Claude Code su WSL legge le impostazioni gestite dalla catena di politica Windows e legge `/etc/claude-code` solo quando nessun file di impostazioni gestite o drop-in sotto `C:\Program Files\ClaudeCode\` fornisce una [chiave di politica](/docs/it/managed-settings#how-claude-code-combines-managed-sources)6521 * `true`: Claude Code su WSL legge le impostazioni gestite dalla catena di politica Windows e legge `/etc/claude-code` solo quando nessun documento amministrativo Windows è presente

6447 * `false`: WSL legge solo `/etc/claude-code`6522 * `false`: WSL legge solo `/etc/claude-code`

6448* **Default**: `false`, quindi WSL legge solo `/etc/claude-code`6523* **Default**: `false`, quindi WSL legge solo `/etc/claude-code`

6449 6524

6453}6528}

6454```6529```

6455 6530

6456Una volta che una fonte amministrativa attiva la catena, la politica HKCU si unisce ad essa su WSL solo quando HKCU imposta anche la chiave su `true`. Quella copia non attiva la catena da sola. Una fonte Windows che contiene solo questa chiave non conta come fonte di politica, quindi una fonte con priorità inferiore fornisce comunque la politica. Questa chiave non ha effetto su Windows nativo.6531Una volta che una fonte amministrativa attiva la catena, la politica HKCU si unisce ad essa su WSL solo quando HKCU imposta anche la chiave su `true`. Quella copia non attiva la catena da sola. Una fonte Windows che contiene solo questa chiave, impostata su `true` o `false`, non conta come fonte di politica, quindi una fonte con priorità inferiore fornisce comunque la politica. Questa chiave non ha effetto su Windows nativo.

6532

6533Claude Code legge `true` e `false` con o senza virgolette e legge `null` come rimozione della chiave. Una fonte Windows controllata dall'amministratore che contiene qualsiasi altro valore conta come un [documento amministrativo presente](/docs/it/managed-settings#present-admin-documents) con la catena attivata: né `/etc/claude-code` né HKCU si applica, e un avviso di avvio nomina la chiave. Un valore HKLM o un file della cartella Windows che esiste ma non può essere letto mantiene anche `/etc/claude-code` dall'applicarsi indipendentemente dal fatto che la catena sia attiva o meno. Richiede Claude Code v2.1.282 o successivo.

6457 6534

6458<h2 id="global-config-settings">6535<h2 id="global-config-settings">

6459 Impostazioni di configurazione globale6536 Impostazioni di configurazione globale

6503 6580

6504Claude Code ignora questa chiave in `settings.json`.6581Claude Code ignora questa chiave in `settings.json`.

6505 6582

6583<h3 id="claudeinchromedefaultenabled">

6584 `claudeInChromeDefaultEnabled`

6585</h3>

6586

6587Avvia ogni sessione CLI interattiva con l'[integrazione Chrome](/docs/it/chrome) attivata, senza passare `--chrome` ogni volta. Se esegui [`claude remote-control`](/docs/it/remote-control), una sessione che avvia per uno dei tuoi thread di [progetto](/docs/it/claude-projects) segue questa chiave anche, tranne in modalità `bypassPermissions`. Eseguire `/chrome` e selezionare **Enabled by default** imposta questa chiave per te, come descritto in [Enable Chrome by default](/docs/it/chrome#enable-chrome-by-default). Appare in `/config` come **Claude in Chrome enabled by default**.

6588

6589* **Scope**: [`Global config`](#scopes)

6590* **Type**: Boolean

6591 * `true`: Claude Code attiva l'integrazione Chrome quando una sessione CLI interattiva si avvia, come fa quando passi `--chrome`

6592 * `false`: le sessioni CLI interattive si avviano con l'integrazione Chrome disattivata, e Claude Code smette di [offrire di configurarla](/docs/it/chrome#install-the-extension-when-claude-asks). Passa `--chrome` per attivarla per una sessione interattiva

6593* **Default**: non impostato, quindi l'integrazione Chrome è disattivata e Claude Code può ancora offrire di configurarla

6594* **Per-session overrides**: `--chrome` e [`--no-chrome`](/docs/it/cli-reference) hanno la precedenza su questa chiave per una sessione interattiva

6595

6596```json ~/.claude.json theme={null}

6597{

6598 "claudeInChromeDefaultEnabled": true

6599}

6600```

6601

6602Claude Code ignora questa chiave in `settings.json`.

6603

6604<h3 id="copyfullresponse">

6605 `copyFullResponse`

6606</h3>

6607

6608Fai in modo che [`/copy`](/docs/it/commands) copi la risposta completa ogni volta, senza il selettore che altrimenti mostra quando la risposta contiene blocchi di codice. Selezionare **Always copy full response** in quel selettore imposta questa chiave su `true`. Appare in `/config` come **Skip the /copy picker**.

6609

6610* **Scope**: [`Global config`](#scopes)

6611* **Type**: Boolean

6612 * `true`: `/copy` copia la risposta completa senza mostrare il selettore

6613 * `false`: quando la risposta contiene blocchi di codice, `/copy` mostra un selettore dove scegli un blocco di codice o la risposta completa

6614* **Default**: `false`

6615

6616```json ~/.claude.json theme={null}

6617{

6618 "copyFullResponse": true

6619}

6620```

6621

6622Claude Code ignora questa chiave in `settings.json`.

6623

6506<h3 id="copyonselect">6624<h3 id="copyonselect">

6507 `copyOnSelect`6625 `copyOnSelect`

6508</h3>6626</h3>

6523 6641

6524Claude Code ignora questa chiave in `settings.json`.6642Claude Code ignora questa chiave in `settings.json`.

6525 6643

6644<h3 id="defaulttoagentsview">

6645 `defaultToAgentsView`

6646</h3>

6647

6648Apri la [vista agente](/docs/it/agent-view) invece di una nuova conversazione quando esegui `claude` senza argomenti. Appare in `/config` come **Open agents view by default** a meno che la vista agente non sia [disattivata](#disableagentview).

6649

6650* **Scope**: [`Global config`](#scopes)

6651* **Type**: Boolean

6652 * `true`: `claude` senza argomenti apre la vista agente, a meno che la vista agente non sia [disattivata](#disableagentview)

6653 * `false`: `claude` senza argomenti avvia una nuova conversazione

6654* **Default**: `false`

6655

6656```json ~/.claude.json theme={null}

6657{

6658 "defaultToAgentsView": true

6659}

6660```

6661

6662Claude Code ignora questa chiave in `settings.json`.

6663

6526<h3 id="difftool">6664<h3 id="difftool">

6527 `diffTool`6665 `diffTool`

6528</h3>6666</h3>

6577 6715

6578Claude Code ignora questa chiave in `settings.json`.6716Claude Code ignora questa chiave in `settings.json`.

6579 6717

6718<h3 id="leftarrowopensagents">

6719 `leftArrowOpensAgents`

6720</h3>

6721

6722Premi `←` su un prompt vuoto per [mettere in background la sessione e aprire la vista agente](/docs/it/agent-view#switch-sessions-without-leaving-the-terminal). Imposta questa chiave su `false` per disattivare la scorciatoia. Appare in `/config` come **← opens agents** quando la vista agente è disponibile.

6723

6724* **Scope**: [`Global config`](#scopes)

6725* **Type**: Boolean

6726 * `true`: premendo `←` su un prompt vuoto in una sessione che hai avviato nel terminale la mette in background e apre la vista agente

6727 * `false`: Claude Code disattiva la scorciatoia; in una sessione che hai [collegato dalla vista agente](/docs/it/agent-view#attach-to-a-session), `←` su un prompt vuoto si scollega comunque

6728* **Default**: `true`

6729

6730```json ~/.claude.json theme={null}

6731{

6732 "leftArrowOpensAgents": false

6733}

6734```

6735

6736Claude Code ignora questa chiave in `settings.json`.

6737

6580<h3 id="permissionexplainerenabled">6738<h3 id="permissionexplainerenabled">

6581 `permissionExplainerEnabled`6739 `permissionExplainerEnabled`

6582</h3>6740</h3>

6591* **Type**: Boolean6749* **Type**: Boolean

6592* **Default**: `true`6750* **Default**: `true`

6593 6751

6752<h3 id="prstatusfooterenabled">

6753 `prStatusFooterEnabled`

6754</h3>

6755

6756Mostra un badge nel footer del prompt per la pull request o merge request aperta del ramo corrente, con una sottolineatura colorata che mostra il suo [stato](/docs/it/interactive-mode#pr-review-status). Appare in `/config` come **Show PR status footer**.

6757

6758* **Scope**: [`Global config`](#scopes)

6759* **Type**: Boolean

6760 * `true`: il footer mostra il badge secondo le condizioni in [PR review status](/docs/it/interactive-mode#pr-review-status)

6761 * `false`: Claude Code salta il controllo della pull request e merge request del footer e non mostra quel badge. Una sessione che hai [collegato dalla vista agente](/docs/it/agent-view#attach-to-a-session) può comunque mostrare un link semplice a una pull request [collegata ad essa](/docs/it/agent-view#pull-request-status)

6762* **Default**: `true`

6763

6764```json ~/.claude.json theme={null}

6765{

6766 "prStatusFooterEnabled": false

6767}

6768```

6769

6770Claude Code ignora questa chiave in `settings.json`.

6771

6594<h3 id="teammatedefaultmodel">6772<h3 id="teammatedefaultmodel">

6595 `teammateDefaultModel`6773 `teammateDefaultModel`

6596</h3>6774</h3>

setup.md +3 −3

Details

37 37

38<Tip>38<Tip>

39 Preferite un'interfaccia grafica? L'[app Desktop](/docs/it/desktop-quickstart) vi consente di utilizzare Claude Code senza il terminale. Scaricatela per [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) o [Linux](/docs/it/desktop-linux).39 Preferite un'interfaccia grafica? L'[app Desktop](/docs/it/desktop-quickstart) vi consente di utilizzare Claude Code senza il terminale. Scaricatela per [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) o [Linux](/docs/it/desktop-linux).

~~41 Siete nuovi al terminale? Consultate la [guida del terminale](/docs/it/terminal-guide) per istruzioni passo dopo passo.~~

42</Tip>40</Tip>

43 41

~~44Per installare Claude Code, utilizza uno dei seguenti metodi:~~42Per installare Claude Code, apri un terminale ed esegui il comando per il tuo sistema. Se non hai mai utilizzato un terminale prima, la [guida al terminale](/docs/it/terminal-guide) mostra come aprirne uno e incollare il comando.

45 43

46<Tabs>44<Tabs>

47 <Tab title="Installazione nativa (consigliata)">45 <Tab title="Installazione nativa (consigliata)">

63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd61 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

64 ```62 ```

65 63

64 Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).

66 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell. Il tuo prompt mostra `PS C:\` quando sei in PowerShell e `C:\` senza il `PS` quando sei in CMD.66 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell. Il tuo prompt mostra `PS C:\` quando sei in PowerShell e `C:\` senza il `PS` quando sei in CMD.

67 67

68 Se il comando di installazione non riesce con `syntax error near unexpected token '<'`, un `403`, o un altro errore curl, consulta [Troubleshoot installation](/docs/it/troubleshoot-install#find-your-error) per abbinare l'errore a una soluzione e per metodi di installazione alternativi.68 Se il comando di installazione non riesce con `syntax error near unexpected token '<'`, un `403`, o un altro errore curl, consulta [Troubleshoot installation](/docs/it/troubleshoot-install#find-your-error) per abbinare l'errore a una soluzione e per metodi di installazione alternativi.

skills.md +30 −11

Details

135Le cartelle delle skill seguono anche queste regole:135Le cartelle delle skill seguono anche queste regole:

136 136

137* **Cartelle con symlink**: una voce `<skill-name>` nella posizione enterprise, personale o di progetto può essere un symlink a una directory altrove su disco. Claude Code legge `SKILL.md` dal target e carica la skill una sola volta anche se più posizioni puntano allo stesso target. Le skill dei plugin [gestiscono i symlink diversamente](/docs/it/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks).137* **Cartelle con symlink**: una voce `<skill-name>` nella posizione enterprise, personale o di progetto può essere un symlink a una directory altrove su disco. Claude Code legge `SKILL.md` dal target e carica la skill una sola volta anche se più posizioni puntano allo stesso target. Le skill dei plugin [gestiscono i symlink diversamente](/docs/it/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks).

138* **Nome riservato**: non nominare una cartella di skill `synced`, in nessuna capitalizzazione. Claude Code usa `~/.claude/skills/synced/` per [skills scaricate da claude.ai](#where-synced-skills-load) e salta una skill che crei con quel nome nelle posizioni enterprise, personale e di progetto.138* **Nome riservato `synced`**: non nominare una cartella di skill `synced`, in nessuna capitalizzazione. Claude Code usa `~/.claude/skills/synced/` per [skills scaricate da claude.ai](#where-synced-skills-load) e salta una skill che crei con quel nome nelle posizioni enterprise, personale e di progetto.

139* **Nome riservato `anthropic-skills`**: al di fuori di un plugin, una cartella di skill o un file di comando il cui nome è `anthropic-skills` o inizia con `anthropic-skills:` non si carica. Vedi [Nomi riservati per le skill sincronizzate](#names-reserved-for-synced-skills).

139* **File di comando**: un file Markdown in `.claude/commands/` è il formato più vecchio e funziona ancora. Supporta lo stesso [frontmatter](#frontmatter-reference) tranne `name` e `paths`. Per trovare il nome che digiti per invocarlo, vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name). Preferisci una skill per il nuovo lavoro, poiché le skill supportano anche [file di supporto](#add-supporting-files).140* **File di comando**: un file Markdown in `.claude/commands/` è il formato più vecchio e funziona ancora. Supporta lo stesso [frontmatter](#frontmatter-reference) tranne `name` e `paths`. Per trovare il nome che digiti per invocarlo, vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name). Preferisci una skill per il nuovo lavoro, poiché le skill supportano anche [file di supporto](#add-supporting-files).

140* **Cartella di skill come plugin**: aggiungi un `.claude-plugin/plugin.json` a una cartella di skill e si carica come [plugin](/docs/it/plugins/loading#plugins-shared-through-a-repository) denominato `<name>@skills-dir`, in modo che possa raggruppare agenti, hooks e server MCP. In un `.claude/skills/` di un progetto, questo richiede di accettare prima la finestra di dialogo di fiducia dell'area di lavoro.141* **Cartella di skill come plugin**: aggiungi un `.claude-plugin/plugin.json` a una cartella di skill e si carica come [plugin](/docs/it/plugins/loading#plugins-shared-through-a-repository) denominato `<name>@skills-dir`, in modo che possa raggruppare agenti, hooks e server MCP. In un `.claude/skills/` di un progetto, questo richiede di accettare prima la finestra di dialogo di fiducia dell'area di lavoro.

141 142

168 Risolvi skills che condividono un nome169 Risolvi skills che condividono un nome

169</h3>170</h3>

170 171

171Quando due skill condividono un nome, il luogo da cui proviene ciascuna decide quale `/name` esegue. La tabella copre le posizioni enterprise, personale, progetto, annidato, plugin e claude.ai, le skill raggruppate e i file di comando:172Quando due skill condividono un nome, il luogo da cui proviene ciascuna decide quale `/name` esegue. Per un nome impostato dal campo frontmatter `name`, vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name). La tabella copre le posizioni enterprise, personale, progetto, annidato, plugin e claude.ai, le skill raggruppate e i file di comando:

172 173

173| Stesso nome in | Quale esegue |174| Stesso nome in | Quale esegue |

174| :- | :- |175| :- | :- |

235 Quando un nome di skill sincronizzato corrisponde a un altro comando236 Quando un nome di skill sincronizzato corrisponde a un altro comando

236</h4>237</h4>

237 238

238Puoi invocare una skill sincronizzato con il suo nome completo, `/anthropic-skills:<name>`, o con il suo nome breve, `/<name>`. Quando un altro comando usa quel nome breve, `/<name>` esegue l'altro comando, e la skill sincronizzato esegue solo come `/anthropic-skills:<name>`. Con una skill `deploy` locale e una `deploy` sincronizzato, `/deploy` esegue la skill locale e `/anthropic-skills:deploy` esegue quella sincronizzato. Prima di v2.1.269, una skill sincronizzato aveva solo il suo nome breve.239Puoi invocare una skill sincronizzato con il suo nome breve, `/<name>`, o con il suo nome completo, `/anthropic-skills:<name>`. Quando un altro comando usa il nome breve, `/<name>` esegue l'altro comando, e la skill sincronizzato esegue solo come `/anthropic-skills:<name>`. Con una skill `deploy` locale e una `deploy` sincronizzato, `/deploy` esegue la skill locale e `/anthropic-skills:deploy` esegue quella sincronizzato. Prima di v2.1.269, una skill sincronizzato aveva solo il suo nome breve.

239 240

240L'altro comando può essere uno qualsiasi di questi:241Nel menu `/`, `/skills` e `/context`, una skill sincronizzato appare con il suo nome breve, o con il suo nome completo mentre un altro comando usa il nome breve. Esegui `/skills` nella tua sessione. Una nota sotto l'elenco spiega ogni skill sincronizzato che ha perso il suo nome breve. Se uno dei tuoi skill personali o file di comando in `~/.claude/` usa il nome, la nota dice anche cosa rinominare o eliminare per liberarlo.

242

243Da v2.1.269 a v2.1.280, questi elenchi mostravano ogni skill sincronizzato con il suo nome completo, e `/skills` non aveva tale nota; entrambi sono cambiati in v2.1.281.

244

245Il comando che usa il nome breve può essere uno qualsiasi di questi:

241 246

242* Un comando integrato o una [skill raggruppata](#bundled-skills), inclusa una che non è disponibile nella tua sessione, ad esempio dopo aver disattivato le skill raggruppate247* Un comando integrato o una [skill raggruppata](#bundled-skills), inclusa una che non è disponibile nella tua sessione, ad esempio dopo aver disattivato le skill raggruppate

243* Una skill a qualsiasi [livello locale](#where-skills-live) o un file in `.claude/commands/`248* Una skill a qualsiasi [livello locale](#where-skills-live) o un file in `.claude/commands/`

250 255

251Un nome che differisce solo per una lettera simile da un altro alfabeto conta come un nome diverso, e l'etichetta `claude.ai sync` è come distingui i due. Questi controlli e etichette richiedono Claude Code v2.1.228 o successiva.256Un nome che differisce solo per una lettera simile da un altro alfabeto conta come un nome diverso, e l'etichetta `claude.ai sync` è come distingui i due. Questi controlli e etichette richiedono Claude Code v2.1.228 o successiva.

252 257

258<h4 id="names-reserved-for-synced-skills">

259 Nomi riservati per le skill sincronizzate

260</h4>

261

262Claude Code riserva il nome `anthropic-skills`, e ogni nome all'interno di quello spazio dei nomi come `anthropic-skills:pdf`, per le skill sincronizzate da claude.ai, quindi il nome completo di una skill sincronizzato non esegue mai nient'altro. Il nome è riservato in ogni sessione, indipendentemente dal fatto che tu acceda o meno con un account claude.ai.

263

264* **Una cartella di skill, un `name` nel frontmatter, un file o una sottocartella in `.claude/commands/`, o un [flusso di lavoro salvato](/docs/it/workflows#save-the-workflow-for-reuse)**: non si carica. Un [avviso di avvio](/docs/it/errors#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) nomina il primo elemento da rinominare o modificare.

265* **Un plugin denominato `anthropic-skills`**: si carica. Quando una delle sue skill e una skill sincronizzato sono entrambe denominate `<name>`, `/anthropic-skills:<name>` esegue la skill sincronizzato.

266* **Un server MCP denominato `anthropic-skills`**: si connette e i suoi strumenti funzionano, ma [i suoi prompt non appaiono come comandi](/docs/it/mcp#use-mcp-prompts-as-commands). Rinomina il server nella tua configurazione MCP per elencarli.

267

253<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">268<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">

254 Come Claude Code gestisce il frontmatter di una skill sincronizzato269 Come Claude Code gestisce il frontmatter di una skill sincronizzato

255</h4>270</h4>

273 Modifica una skill durante una sessione288 Modifica una skill durante una sessione

274</h3>289</h3>

275 290

276Claude Code osserva le directory delle skill per i cambiamenti di file, tranne in [modalità bare](/docs/it/headless#start-faster-with-bare-mode). Quando aggiungi, modifichi o rimuovi una skill sotto `~/.claude/skills/`, il progetto `.claude/skills/`, o una `.claude/skills/` all'interno di una directory `--add-dir`, Claude Code raccoglie il cambiamento all'interno della sessione corrente, senza un riavvio. Se crei una directory di skill di livello superiore che non esisteva quando la sessione è iniziata, riavvia Claude Code in modo che possa osservare la nuova directory.291Claude Code osserva le directory delle skill per i cambiamenti di file, tranne in [modalità bare](/docs/it/headless#start-faster-with-bare-mode). Quando aggiungi, modifichi o rimuovi una skill sotto `~/.claude/skills/`, il progetto `.claude/skills/`, o una `.claude/skills/` all'interno di una directory `--add-dir`, Claude Code raccoglie il cambiamento all'interno della sessione corrente, senza un riavvio.

292

293Se crei una directory di skill di livello superiore che non esisteva quando la sessione è iniziata, esegui [`/reload-skills`](/docs/it/commands#all-commands) per raccogliere le skill che hai messo lì. Claude Code non sta ancora osservando quella directory, quindi esegui `/reload-skills` di nuovo dopo ogni cambiamento successivo lì.

277 294

278La rilevazione dei cambiamenti in tempo reale copre solo il testo `SKILL.md`. Per una cartella di skill che è anche un [plugin](/docs/it/plugins/loading#plugins-shared-through-a-repository), i cambiamenti a `hooks/`, `.mcp.json`, `agents/` e `output-styles/` richiedono `/reload-plugins` per avere effetto.295La rilevazione dei cambiamenti in tempo reale copre solo il testo `SKILL.md`. Per una cartella di skill che è anche un [plugin](/docs/it/plugins/loading#plugins-shared-through-a-repository), i cambiamenti a `hooks/`, `.mcp.json`, `agents/` e `output-styles/` richiedono `/reload-plugins` per avere effetto.

279 296

286* **Skill personale o di progetto**: elimina la directory della skill, `~/.claude/skills/<skill-name>/` o `.claude/skills/<skill-name>/`. Claude Code [la elimina da `/skills` nella sessione corrente](#live-change-detection); il contenuto che Claude Code ha già caricato da essa segue il [ciclo di vita del contenuto della skill](#skill-content-lifecycle).303* **Skill personale o di progetto**: elimina la directory della skill, `~/.claude/skills/<skill-name>/` o `.claude/skills/<skill-name>/`. Claude Code [la elimina da `/skills` nella sessione corrente](#live-change-detection); il contenuto che Claude Code ha già caricato da essa segue il [ciclo di vita del contenuto della skill](#skill-content-lifecycle).

287* **Skill enterprise**: un amministratore elimina la directory della skill da `.claude/skills/` all'interno della [directory delle impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), ad esempio `/etc/claude-code/.claude/skills/<skill-name>/` su Linux.304* **Skill enterprise**: un amministratore elimina la directory della skill da `.claude/skills/` all'interno della [directory delle impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), ad esempio `/etc/claude-code/.claude/skills/<skill-name>/` su Linux.

288* **Skill di plugin**: disabilita o disinstalla il plugin che la fornisce, dal menu `/plugin` o con `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code scarica le skill del plugin quando [il cambiamento si applica](/docs/it/plugins/cli-reference#reload-plugins) o quando riavvii.305* **Skill di plugin**: disabilita o disinstalla il plugin che la fornisce, dal menu `/plugin` o con `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code scarica le skill del plugin quando [il cambiamento si applica](/docs/it/plugins/cli-reference#reload-plugins) o quando riavvii.

289* **Skill sincronizzato da claude.ai**: disattiva la skill per il tuo account claude.ai, nello stesso luogo in cui l'hai [abilitata](#skills-in-cowork-and-cloud-sessions). Claude Code la rimuove da `~/.claude/skills/synced/` la prossima volta che [sincronizza le tue skill](#how-synced-skills-behave). Se elimini la directory manualmente, la prossima sincronizzazione la scarica di nuovo mentre la skill rimane abilitata su claude.ai.306* **Skill sincronizzato da claude.ai**: disattiva la skill per il tuo account claude.ai, nello stesso luogo in cui l'hai [abilitata](#skills-in-cowork-and-cloud-sessions). Claude Code la rimuove da `~/.claude/skills/synced/` la prossima volta che [sincronizza le tue skill](#where-synced-skills-load). Se elimini la directory manualmente, la prossima sincronizzazione la scarica di nuovo mentre la skill rimane abilitata su claude.ai.

290* **Skill raggruppata**: imposta [`disableBundledSkills`](#bundled-skills) su `true` per disattivare le skill raggruppate, o imposta una skill su `"off"` in [`skillOverrides`](#override-skill-visibility-from-settings) per nasconderla.307* **Skill raggruppata**: imposta [`disableBundledSkills`](#bundled-skills) su `true` per disattivare le skill raggruppate, o imposta una skill su `"off"` in [`skillOverrides`](#override-skill-visibility-from-settings) per nasconderla.

291 308

292Per mantenere una skill personale o di progetto ma impedire a Claude di invocarla da solo, imposta [`disable-model-invocation: true`](#control-who-invokes-a-skill) nel suo frontmatter, o `"user-invocable-only"` in [`skillOverrides`](#override-skill-visibility-from-settings) quando non vuoi modificare il file.309Per mantenere una skill personale o di progetto ma impedire a Claude di invocarla da solo, imposta [`disable-model-invocation: true`](#control-who-invokes-a-skill) nel suo frontmatter, o `"user-invocable-only"` in [`skillOverrides`](#override-skill-visibility-from-settings) quando non vuoi modificare il file.

360 377

362| :- | :- | :- |379| :- | :- | :- |

363| `name` | No | Nome visualizzato mostrato negli elenchi di skills. Predefinito al nome della directory. Vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name) per come il campo interagisce con il nome che digiti per invocare la skill. |380| `name` | No | Nome del comando mostrato nel menu `/`. Predefinito al nome della directory. Vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name) per come il campo interagisce con il nome che digiti per invocare la skill. |

364| `description` | Consigliato | Cosa fa la skill e quando usarla. Claude usa questo per decidere quando applicare la skill. Se omesso, usa la prima riga non vuota del contenuto markdown. Metti il caso d'uso chiave per primo: il testo combinato `description` e `when_to_use` viene troncato a 1.536 caratteri nell'elenco delle skills per ridurre l'utilizzo del contesto. |381| `description` | Consigliato | Cosa fa la skill e quando usarla. Claude usa questo per decidere quando applicare la skill. Se omesso, usa la prima riga non vuota del contenuto markdown. Metti il caso d'uso chiave per primo: il testo combinato `description` e `when_to_use` viene troncato a 1.536 caratteri nell'elenco delle skills per ridurre l'utilizzo del contesto. |

365| `when_to_use` | No | Contesto aggiuntivo per quando Claude dovrebbe invocare la skill, come frasi trigger o richieste di esempio. Aggiunto a `description` nell'elenco delle skills e conta verso il limite di 1.536 caratteri. |382| `when_to_use` | No | Contesto aggiuntivo per quando Claude dovrebbe invocare la skill, come frasi trigger o richieste di esempio. Aggiunto a `description` nell'elenco delle skills e conta verso il limite di 1.536 caratteri. |

366| `argument-hint` | No | Suggerimento mostrato durante l'autocompletamento per indicare gli argomenti previsti. Esempio: `[issue-number]` o `[filename] [format]`. |383| `argument-hint` | No | Suggerimento mostrato durante l'autocompletamento per indicare gli argomenti previsti. Esempio: `[issue-number]` o `[filename] [format]`. |

406 Come una skill ottiene il suo nome di comando423 Come una skill ottiene il suo nome di comando

407</h4>424</h4>

408 425

409Il comando che digiti per invocare una skill proviene da dove vive il file skill e, per skills di plugin, anche dal campo frontmatter `name`. In una skill personale o di progetto, `name` imposta solo l'etichetta di visualizzazione mostrata negli elenchi di skills, e il comando proviene ancora dal nome della directory. In una skill di plugin, `name` imposta l'ultimo segmento del comando e il prefisso del plugin rimane in posizione.426Il comando che digiti per invocare una skill proviene da dove vive il file skill e, per skills di plugin, dal campo frontmatter `name`. In una skill personale o di progetto, `name` imposta il comando che il menu `/` mostra e che digiti, a meno che un altro comando non usi già quel nome. Il nome della directory invoca anche la skill. In una skill di plugin, `name` imposta l'ultimo segmento del comando e il prefisso del plugin rimane in posizione.

410 427

411La tabella seguente mostra da dove proviene il nome del comando per ogni layout:428La tabella seguente mostra da dove proviene il nome del comando per ogni layout:

412 429

414| :- | :- | :- |431| :- | :- | :- |

415| Directory skill sotto `~/.claude/skills/` o `.claude/skills/` | Nome della directory | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |432| Directory skill sotto `~/.claude/skills/` o `.claude/skills/` | Frontmatter `name` o il nome della directory | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging`, o `/deploy` con `name: deploy` |

416| Directory [nidificata](#where-skills-live) `.claude/skills/`, quando il nome si scontra con un'altra skill | Percorso della sottodirectory relativo alla directory di lavoro, quindi il nome della directory skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |433| Directory [nidificata](#where-skills-live) `.claude/skills/`, quando il nome si scontra con un'altra skill | Percorso della sottodirectory relativo alla directory di lavoro, quindi il nome della directory skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

418| File in una sottodirectory di `.claude/commands/` | Percorso della sottodirectory relativo a `commands/` con ogni `/` sostituito da `:`, quindi il nome del file senza estensione | `.claude/commands/frontend/component.md` → `/frontend:component` |435| File in una sottodirectory di `.claude/commands/` | Percorso della sottodirectory relativo a `commands/` con ogni `/` sostituito da `:`, quindi il nome del file senza estensione | `.claude/commands/frontend/component.md` → `/frontend:component` |

439| `$N` | Abbreviazione per `$ARGUMENTS[N]`, come `$0` per il primo argomento o `$1` per il secondo. |456| `$N` | Abbreviazione per `$ARGUMENTS[N]`, come `$0` per il primo argomento o `$1` per il secondo. |

440| `$name` | Argomento denominato dichiarato nell'elenco frontmatter [`arguments`](#frontmatter-reference). I nomi si mappano alle posizioni in ordine, quindi con `arguments: [issue, branch]` il placeholder `$issue` si espande al primo argomento e `$branch` al secondo. |457| `$name` | Argomento denominato dichiarato nell'elenco frontmatter [`arguments`](#frontmatter-reference). I nomi si mappano alle posizioni in ordine, quindi con `arguments: [issue, branch]` il placeholder `$issue` si espande al primo argomento e `$branch` al secondo. |

441| `${CLAUDE_SESSION_ID}` | L'ID della sessione attuale. Utile per il logging, la creazione di file specifici della sessione o la correlazione dell'output della skill con le sessioni. |458| `${CLAUDE_SESSION_ID}` | L'ID della sessione attuale. Utile per il logging, la creazione di file specifici della sessione o la correlazione dell'output della skill con le sessioni. |

442| `${CLAUDE_EFFORT}` | Il livello di sforzo attuale: `low`, `medium`, `high`, `xhigh` o `max`. Ultracode non è un livello distinto e viene segnalato come `xhigh`. Usa questo per adattare le istruzioni della skill all'impostazione di sforzo attiva. |459| `${CLAUDE_EFFORT}` | Il livello di sforzo attuale: `low`, `medium`, `high`, `xhigh` o `max`. Usa questo per adattare le istruzioni della skill all'impostazione di sforzo attiva. |

443| `${CLAUDE_SKILL_DIR}` | La directory contenente il file `SKILL.md` della skill. Per skills di plugin, questa è la sottodirectory della skill all'interno del plugin, non la radice del plugin. Usa questo nei comandi di iniezione bash per fare riferimento a script o file forniti con la skill, indipendentemente dalla directory di lavoro attuale. |460| `${CLAUDE_SKILL_DIR}` | La directory contenente il file `SKILL.md` della skill. Per skills di plugin, questa è la sottodirectory della skill all'interno del plugin, non la radice del plugin. Usa questo nei comandi di iniezione bash per fare riferimento a script o file forniti con la skill, indipendentemente dalla directory di lavoro attuale. |

444| `${CLAUDE_PROJECT_DIR}` | La directory radice del progetto. Questo è lo stesso percorso che [hooks](/docs/it/hooks#reference-scripts-by-path) e server MCP ricevono come `CLAUDE_PROJECT_DIR`. Usa questo per fare riferimento a script o file locali del progetto, come `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, indipendentemente da dove la skill è installata. |461| `${CLAUDE_PROJECT_DIR}` | La directory radice del progetto. Questo è lo stesso percorso che [hooks](/docs/it/hooks#reference-scripts-by-path) e server MCP ricevono come `CLAUDE_PROJECT_DIR`. Usa questo per fare riferimento a script o file locali del progetto, come `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, indipendentemente da dove la skill è installata. |

445| `${CLAUDE_PLUGIN_ROOT}` | La directory di installazione del plugin. Sostituito solo in skills di plugin. Usa questo per fare riferimento a script o file forniti in qualsiasi punto del plugin, incluse risorse condivise tra le skills del plugin. Vedi [variabili di ambiente del plugin](/docs/it/plugins/manifest-reference#environment-variables). |462| `${CLAUDE_PLUGIN_ROOT}` | La directory di installazione del plugin. Sostituito solo in skills di plugin. Usa questo per fare riferimento a script o file forniti in qualsiasi punto del plugin, incluse risorse condivise tra le skills del plugin. Vedi [variabili di ambiente del plugin](/docs/it/plugins/manifest-reference#environment-variables). |

826Skill(deploy *)843Skill(deploy *)

827```844```

828 845

829Sintassi di permesso: `Skill(name)` per corrispondenza esatta, `Skill(name *)` per corrispondenza di prefisso con qualsiasi argomento.846Sintassi di permesso: `Skill(name)` per corrispondenza esatta, `Skill(name *)` per corrispondenza di prefisso con qualsiasi argomento. In una regola `allow`, un prefisso al di fuori dello [spazio dei nomi riservato per le skill sincronizzate](#names-reserved-for-synced-skills) non corrisponde ai nomi al suo interno: `Skill(anthropic *)` non copre `anthropic-skills:pdf`.

830 847

831Se la tua regola `deny` nomina un alias o un nome non qualificato piuttosto che il nome della skill stessa, Claude Code blocca comunque la skill: con `Skill(review)` blocca il bundled `/code-review` attraverso il suo alias `/review`, e con `Skill(deploy)` blocca una [skill annidata](#where-skills-live) elencata come `apps/web:deploy` attraverso il suo nome non qualificato. Prima della v2.1.260, Claude Code non bloccava una skill annidata elencata sotto il suo nome qualificato quando la regola deny nominava solo il nome non qualificato.848Se la tua regola `deny` nomina un alias o un nome non qualificato piuttosto che il nome della skill stessa, Claude Code blocca comunque la skill: con `Skill(review)` blocca il bundled `/code-review` attraverso il suo alias `/review`, e con `Skill(deploy)` blocca una [skill annidata](#where-skills-live) elencata come `apps/web:deploy` attraverso il suo nome non qualificato. Prima della v2.1.260, Claude Code non bloccava una skill annidata elencata sotto il suo nome qualificato quando la regola deny nominava solo il nome non qualificato.

832 849

833Claude Code corrisponde a una regola `allow` solo contro il nome della skill stessa e il nome nell'invocazione di Claude.850Claude Code corrisponde a una regola `allow` solo contro il nome della skill stessa e il nome nell'invocazione di Claude.

834 851

852Per approvare una [skill sincronizzata](#how-synced-skills-behave) senza un prompt, nominala all'interno del suo [spazio dei nomi riservato](#names-reserved-for-synced-skills): `Skill(anthropic-skills:pdf)` approva la skill sincronizzata `pdf`, e `Skill(anthropic-skills *)` approva ogni skill sincronizzata.

853

835**Nascondere skill individuali** aggiungendo `disable-model-invocation: true` al loro frontmatter. Questo rimuove la skill dal contesto di Claude interamente.854**Nascondere skill individuali** aggiungendo `disable-model-invocation: true` al loro frontmatter. Questo rimuove la skill dal contesto di Claude interamente.

836 855

837<Note>856<Note>

statusline.md +3 −3

Details

175 175

176Claude Code acquisisce l'output del tuo script invece di collegarlo direttamente al terminale, quindi `tput cols` e il rilevamento della larghezza a livello di linguaggio non possono leggere la dimensione del terminale dall'interno dello script. Leggi invece le variabili di ambiente `COLUMNS` e `LINES`. Claude Code imposta queste variabili alle dimensioni attuali del terminale prima di eseguire il tuo script.176Claude Code acquisisce l'output del tuo script invece di collegarlo direttamente al terminale, quindi `tput cols` e il rilevamento della larghezza a livello di linguaggio non possono leggere la dimensione del terminale dall'interno dello script. Leggi invece le variabili di ambiente `COLUMNS` e `LINES`. Claude Code imposta queste variabili alle dimensioni attuali del terminale prima di eseguire il tuo script.

177 177

178<Note>La barra di stato viene eseguita localmente e non consuma token API. Si nasconde temporaneamente durante determinate interazioni dell'interfaccia utente, inclusi i suggerimenti di completamento automatico, il menu della guida e i prompt di autorizzazione.</Note>178<Note>La barra di stato viene eseguita localmente e non consuma token API. Si nasconde temporaneamente durante determinate interazioni dell'interfaccia utente, inclusi il menu della guida e i prompt di autorizzazione.</Note>

179 179

180<h2 id="available-data">180<h2 id="available-data">

181 Dati disponibili181 Dati disponibili

202| `context_window.current_usage` | Conteggi dei token dall'ultima chiamata API, descritti in [campi della finestra di contesto](#context-window-fields) |202| `context_window.current_usage` | Conteggi dei token dall'ultima chiamata API, descritti in [campi della finestra di contesto](#context-window-fields) |

203| `exceeds_200k_tokens` | Se il conteggio totale dei token (token di input, cache e output combinati) dalla risposta API più recente supera 200k. Questo è un limite fisso indipendentemente dalla dimensione effettiva della finestra di contesto. |203| `exceeds_200k_tokens` | Se il conteggio totale dei token (token di input, cache e output combinati) dalla risposta API più recente supera 200k. Questo è un limite fisso indipendentemente dalla dimensione effettiva della finestra di contesto. |

205| `effort.level` | Livello di sforzo di ragionamento corrente (`low`, `medium`, `high`, `xhigh`, o `max`). Riflette il valore della sessione attiva, inclusi i cambiamenti di `/effort` durante la sessione. Ultracode non è un livello distinto e viene segnalato come `xhigh`. Assente quando il modello corrente non supporta il parametro effort |205| `effort.level` | Livello di sforzo di ragionamento corrente (`low`, `medium`, `high`, `xhigh`, o `max`). Riflette il valore della sessione attiva, inclusi i cambiamenti di `/effort` durante la sessione. Assente quando il modello corrente non supporta il parametro effort |

207| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | Percentuale del limite di velocità di 5 ore o 7 giorni consumato, da 0 a 100 |207| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | Percentuale del limite di velocità di 5 ore o 7 giorni consumato, da 0 a 100 |

208| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Secondi di epoca Unix quando la finestra del limite di velocità di 5 ore o 7 giorni si ripristina |208| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Secondi di epoca Unix quando la finestra del limite di velocità di 5 ore o 7 giorni si ripristina |

1166* Su Windows con Git Bash installato, i backslash nel percorso `command` vengono probabilmente consumati come caratteri di escape prima che lo script venga eseguito. Usa barre oblique nel percorso. Vedi [Configurazione Windows](#windows-configuration).1166* Su Windows con Git Bash installato, i backslash nel percorso `command` vengono probabilmente consumati come caratteri di escape prima che lo script venga eseguito. Usa barre oblique nel percorso. Vedi [Configurazione Windows](#windows-configuration).

1167* Se `disableAllHooks` è `true` al di fuori delle impostazioni gestite dopo che la [precedenza delle impostazioni](/docs/it/hooks#disable-or-remove-hooks) si applica, Claude Code esegue solo uno `statusLine` dalle impostazioni gestite, e senza uno `statusLine` gestito la barra di stato è disabilitata. Rimuovi l'impostazione, o impostala su `false` nel file che la imposta, per riabilitarla. Vedi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks).1167* Se `disableAllHooks` è `true` al di fuori delle impostazioni gestite dopo che la [precedenza delle impostazioni](/docs/it/hooks#disable-or-remove-hooks) si applica, Claude Code esegue solo uno `statusLine` dalle impostazioni gestite, e senza uno `statusLine` gestito la barra di stato è disabilitata. Rimuovi l'impostazione, o impostala su `false` nel file che la imposta, per riabilitarla. Vedi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks).

1168* Se la tua organizzazione imposta `allowManagedHooksOnly` nelle impostazioni gestite, la tua barra di stato personalizzata scompare senza avviso: puoi ottenere una barra di stato solo da un valore `statusLine` in quelle impostazioni gestite. Vedi [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) per il comportamento completo, e chiedi al tuo amministratore se questa impostazione si applica a te.1168* Se la tua organizzazione imposta `allowManagedHooksOnly` nelle impostazioni gestite, la tua barra di stato personalizzata scompare senza avviso: puoi ottenere una barra di stato solo da un valore `statusLine` in quelle impostazioni gestite. Vedi [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) per il comportamento completo, e chiedi al tuo amministratore se questa impostazione si applica a te.

1169* Esegui `claude --debug` per registrare il codice di uscita e stderr dalla prima invocazione della barra di stato in una sessione1169* Esegui `claude --debug` per registrare lo stderr del tuo script su ogni invocazione della barra di stato, e il suo codice di uscita sulla prima invocazione in una sessione

1170* Chiedi a Claude di leggere il tuo file di impostazioni ed eseguire il comando `statusLine` direttamente per far emergere gli errori1170* Chiedi a Claude di leggere il tuo file di impostazioni ed eseguire il comando `statusLine` direttamente per far emergere gli errori

1171 1171

1172**La barra di stato mostra `--` o valori vuoti**1172**La barra di stato mostra `--` o valori vuoti**

sub-agents.md +11 −7

Details

8 8

9I subagent sono assistenti AI specializzati che gestiscono tipi specifici di attività. Utilizzi uno quando un'attività secondaria allagherebbe la sua conversazione principale con risultati di ricerca, log o contenuti di file che non farà più riferimento: il subagent svolge quel lavoro nel suo proprio contesto e restituisce solo il riassunto. Definisca un subagent personalizzato quando continua a generare lo stesso tipo di worker con le stesse istruzioni.9I subagent sono assistenti AI specializzati che gestiscono tipi specifici di attività. Utilizzi uno quando un'attività secondaria allagherebbe la sua conversazione principale con risultati di ricerca, log o contenuti di file che non farà più riferimento: il subagent svolge quel lavoro nel suo proprio contesto e restituisce solo il riassunto. Definisca un subagent personalizzato quando continua a generare lo stesso tipo di worker con le stesse istruzioni.

10 10

11Ogni subagent viene eseguito nella propria finestra di contesto con un prompt di sistema personalizzato, accesso a strumenti specifici e autorizzazioni indipendenti. Quando Claude incontra un'attività che corrisponde alla descrizione di un subagent, la delega a quel subagent, che lavora in modo indipendente e restituisce i risultati. Per vedere il risparmio di contesto in pratica, la [visualizzazione della finestra di contesto](/docs/it/context-window) illustra una sessione in cui un subagent gestisce la ricerca nella sua finestra separata.11Ogni subagent viene eseguito nella propria finestra di contesto con un prompt di sistema personalizzato, accesso a strumenti specifici e autorizzazioni indipendenti. Invia anche le proprie richieste, che contano verso gli stessi [limiti di utilizzo](/docs/it/costs#plan-usage-breakdown) della sua conversazione principale. Quando Claude incontra un'attività che corrisponde alla descrizione di un subagent, la delega a quel subagent, che lavora in modo indipendente e restituisce i risultati. Per vedere il risparmio di contesto in pratica, la [visualizzazione della finestra di contesto](/docs/it/context-window) illustra una sessione in cui un subagent gestisce la ricerca nella sua finestra separata.

12 12

13<Note>13<Note>

14 I subagent funzionano all'interno di una singola sessione. Per eseguire molte sessioni indipendenti in parallelo e monitorarle da un unico posto, consulti [background agents](/docs/it/agent-view). Per sessioni separate che si scambiano messaggi, consulti [cross-session messaging](/docs/it/cross-session-messaging). Per un team coordinato di sessioni che Claude genera e supervisiona, consulti [agent teams](/docs/it/agent-teams).14 I subagent funzionano all'interno di una singola sessione. Per eseguire molte sessioni indipendenti in parallelo e monitorarle da un unico posto, consulti [background agents](/docs/it/agent-view). Per sessioni separate che si scambiano messaggi, consulti [cross-session messaging](/docs/it/cross-session-messaging). Per un team coordinato di sessioni che Claude genera e supervisiona, consulti [agent teams](/docs/it/agent-teams).

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232

233Il flag `--agents` accetta JSON con un campo `prompt` più questi campi [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd`, e `isolation`. Usi `prompt` per il prompt di sistema, equivalente al corpo markdown nei subagent basati su file. `color` e `experimental` non sono accettati qui e vengono ignorati piuttosto che rifiutati.233In [modalità non interattiva](/docs/it/headless), `--agents` accetta anche il percorso di un file JSON che contiene lo stesso oggetto, per definizioni troppo grandi per passare sulla riga di comando. Ad esempio, `claude -p --agents ./agents.json "Review my changes"` legge le definizioni da quel file. In una sessione interattiva, Claude Code rifiuta un percorso di file. La forma di file richiede Claude Code v2.1.281 o successivo.

234 234

235Ogni chiave di primo livello nel JSON è il nome dell'agente. Non inizi un nome con `-`.235Ogni chiave di primo livello nel JSON è il nome di un agente, e il suo valore è la definizione di quell'agente. Non inizi un nome con `-`. Una definizione accetta questi campi:

236

237* **`prompt`**: il prompt di sistema dell'agente, equivalente al corpo markdown nei subagent basati su file. `prompt` può essere vuoto. Se seleziona un agente con un `prompt` vuoto e nessun campo `memory` come agente della sessione con `--agent`, il prompt di sistema della sessione rimane invariato. Un `prompt` vuoto richiede Claude Code v2.1.281 o successivo.

238* **[Campi frontmatter](#supported-frontmatter-fields)**: `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd`, e `isolation`.

239* **Campi ignorati**: `color` e `experimental` non vengono accettati qui e vengono ignorati piuttosto che rifiutati.

236 240

237Per quello che Claude Code fa con un valore che non può caricare, e i flag e la variabile di ambiente che saltano quel controllo, consulti [`Invalid --agents configuration`](/docs/it/errors#invalid-agents-configuration).241Per quello che Claude Code fa con un valore che non può caricare, e i flag e la variabile di ambiente che saltano quel controllo, consulti [`Invalid --agents configuration`](/docs/it/errors#invalid-agents-configuration).

238 242

587 Modalità di autorizzazione591 Modalità di autorizzazione

588</h4>592</h4>

589 593

590Imposti `permissionMode` per scegliere la modalità di autorizzazione in cui viene eseguito un subagent. Usi i valori di configurazione delle modalità, quindi la modalità Manual è `default`. Se la lascia non impostata, il subagent eredita la modalità della conversazione principale, che inizia come [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) su piani Pro, Max e Team a meno che le sue impostazioni o la sua organizzazione non la cambino.594Imposti `permissionMode` per scegliere la modalità di autorizzazione in cui viene eseguito un subagent. Usi i valori di configurazione delle modalità, quindi la modalità Manual è `default`. Se la lascia non impostata, il subagent eredita la [modalità di autorizzazione](/docs/it/permission-modes) della conversazione principale.

591 595

592La modalità di autorizzazione della conversazione principale decide se Claude Code utilizza il valore che imposta:596La modalità di autorizzazione della conversazione principale decide se Claude Code utilizza il valore che imposta:

593 597

899claude --agent code-reviewer903claude --agent code-reviewer

900```904```

901 905

902Il prompt di sistema del subagent sostituisce completamente il prompt di sistema predefinito di Claude Code, nello stesso modo in cui [`--system-prompt`](/docs/it/cli-reference) fa. I file `CLAUDE.md` e la memoria del progetto continuano a caricarsi attraverso il flusso di messaggi normale, anche quando la definizione dell'agente imposta [`omitClaudeMd`](#supported-frontmatter-fields).906A meno che il prompt dell'agente non sia [vuoto](#choose-the-subagent-scope), il prompt di sistema del subagent sostituisce completamente il prompt di sistema predefinito di Claude Code, nello stesso modo in cui [`--system-prompt`](/docs/it/cli-reference) fa. I file `CLAUDE.md` e la memoria del progetto continuano a caricarsi attraverso il flusso di messaggi normale, anche quando la definizione dell'agente imposta [`omitClaudeMd`](#supported-frontmatter-fields).

903 907

904Il nome dell'agente appare come `@<name>` nell'intestazione di avvio in modo che possa confermare che è attivo.908Il nome dell'agente appare come `@<name>` nell'intestazione di avvio in modo che possa confermare che è attivo.

905 909

1036Ogni subagent esplora la sua area in modo indipendente, quindi Claude sintetizza i risultati. Questo funziona meglio quando i percorsi di ricerca non dipendono l'uno dall'altro.1040Ogni subagent esplora la sua area in modo indipendente, quindi Claude sintetizza i risultati. Questo funziona meglio quando i percorsi di ricerca non dipendono l'uno dall'altro.

1037 1041

1038<Warning>1042<Warning>

1039 Quando i subagent completano, i loro risultati ritornano alla sua conversazione principale. L'esecuzione di molti subagent che ognuno restituisce risultati dettagliati può consumare contesto significativo.1043 Quando i subagent completano, i loro risultati ritornano alla sua conversazione principale. L'esecuzione di molti subagent che ognuno restituisce risultati dettagliati può consumare contesto significativo, e ogni subagent spende token propri mentre è in esecuzione.

1040</Warning>1044</Warning>

1041 1045

1042Per il lavoro che deve continuare a funzionare in parallelo o non si adatta a una finestra di contesto, eseguilo in [sessioni separate](/docs/it/agents) e lascia che Claude [passi i risultati tra di loro](/docs/it/cross-session-messaging).1046Per il lavoro che deve continuare a funzionare in parallelo o non si adatta a una finestra di contesto, eseguilo in [sessioni separate](/docs/it/agents) e lascia che Claude [passi i risultati tra di loro](/docs/it/cross-session-messaging).

1135* **File CLAUDE.md**: ogni livello della [gerarchia CLAUDE.md](/docs/it/memory#how-claude-md-files-load) che la conversazione principale carica, inclusi `~/.claude/CLAUDE.md`, regole del progetto, `CLAUDE.local.md`, file di policy gestiti e qualsiasi file [`AGENTS.md`](/docs/it/memory#agents-md) caricato come istruzioni del progetto. Gli agenti Explore e Plan integrati saltano questo. Un subagent la cui definizione imposta [`omitClaudeMd`](#supported-frontmatter-fields) carica solo i file di policy gestiti, o nessuno affatto quando la definizione proviene da [impostazioni gestite](#choose-the-subagent-scope).1139* **File CLAUDE.md**: ogni livello della [gerarchia CLAUDE.md](/docs/it/memory#how-claude-md-files-load) che la conversazione principale carica, inclusi `~/.claude/CLAUDE.md`, regole del progetto, `CLAUDE.local.md`, file di policy gestiti e qualsiasi file [`AGENTS.md`](/docs/it/memory#agents-md) caricato come istruzioni del progetto. Gli agenti Explore e Plan integrati saltano questo. Un subagent la cui definizione imposta [`omitClaudeMd`](#supported-frontmatter-fields) carica solo i file di policy gestiti, o nessuno affatto quando la definizione proviene da [impostazioni gestite](#choose-the-subagent-scope).

1136* **Git status**: uno snapshot che Claude Code legge dal suo repository quando il subagent inizia. Assente al di fuori di un repository Git o ogni volta che lo snapshot è disattivato; vedi [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions). Explore e Plan lo saltano comunque.1140* **Git status**: uno snapshot che Claude Code legge dal suo repository quando il subagent inizia. Assente al di fuori di un repository Git o ogni volta che lo snapshot è disattivato; vedi [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions). Explore e Plan lo saltano comunque.

1137* **Preloaded skills**: contenuto completo di qualsiasi skill denominata nel campo [`skills`](#preload-skills-into-subagents) dell'agente. Gli agenti integrati non precaricano skills.1141* **Preloaded skills**: contenuto completo di qualsiasi skill denominata nel campo [`skills`](#preload-skills-into-subagents) dell'agente. Gli agenti integrati non precaricano skills.

1138* **Sibling roster**: un promemoria di sistema che elenca `main` e ogni altro agente denominato nella sessione, ognuno un valore `to` valido per [`SendMessage`](#resume-subagents). Richiede Claude Code v2.1.206 o successivo. L'elenco appare solo quando gli strumenti del subagent includono `SendMessage` e almeno un altro agente ha un nome, sia che Claude lo abbia denominato quando lo ha generato o che venga eseguito come un collega [agent teams](/docs/it/agent-teams). È uno snapshot preso quando il subagent inizia, quindi gli agenti denominati successivamente non appaiono.1142* **Sibling roster**: un [promemoria di sistema](/docs/it/glossary#system-reminder) che elenca `main` e ogni altro agente denominato nella sessione, ognuno un valore `to` valido per [`SendMessage`](#resume-subagents). Richiede Claude Code v2.1.206 o successivo. L'elenco appare solo quando gli strumenti del subagent includono `SendMessage` e almeno un altro agente ha un nome, sia che Claude lo abbia denominato quando lo ha generato o che venga eseguito come un collega [agent teams](/docs/it/agent-teams). È uno snapshot preso quando il subagent inizia, quindi gli agenti denominati successivamente non appaiono.

1139 1143

1140Per avviare uno dei suoi subagent senza i file CLAUDE.md dell'utente, del progetto e locali, imposti [`omitClaudeMd: true`](#supported-frontmatter-fields) nel suo frontmatter o `--agents` JSON.1144Per avviare uno dei suoi subagent senza i file CLAUDE.md dell'utente, del progetto e locali, imposti [`omitClaudeMd: true`](#supported-frontmatter-fields) nel suo frontmatter o `--agents` JSON.

1141 1145

terminal-config.md +6 −0

Details

339 ```339 ```

340</CodeGroup>340</CodeGroup>

341 341

342<h2 id="cap-response-width-in-wide-terminals">

343 Limitare la larghezza della risposta nei terminali ampi

344</h2>

345

346In un terminale ampio, ogni riga di prosa nelle risposte di Claude si estende per l'intera larghezza della finestra. Per avvolgere la prosa a un numero impostato di colonne, impostare [`maxProseWidth`](/docs/it/settings-reference#maxprosewidth) nelle impostazioni.

347

342<h2 id="paste-large-content">348<h2 id="paste-large-content">

343 Incollare contenuti di grandi dimensioni349 Incollare contenuti di grandi dimensioni

344</h2>350</h2>

tools-reference.md +2 −2

Details

13Per aggiungere strumenti personalizzati, connetti un [server MCP](/docs/it/mcp). Per estendere Claude con flussi di lavoro basati su prompt riutilizzabili, scrivi una [skill](/docs/it/skills), che viene eseguita attraverso lo strumento `Skill` esistente piuttosto che aggiungere una nuova voce di strumento.13Per aggiungere strumenti personalizzati, connetti un [server MCP](/docs/it/mcp). Per estendere Claude con flussi di lavoro basati su prompt riutilizzabili, scrivi una [skill](/docs/it/skills), che viene eseguita attraverso lo strumento `Skill` esistente piuttosto che aggiungere una nuova voce di strumento.

14 14

15<Info>15<Info>

16 Nei piani Pro, Max e Team, Claude Code avvia le sessioni in [modalità automatica](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), dove un classificatore decide la maggior parte di questi prompt invece di te. La colonna `Permission required` mostra se lo strumento richiede prompt in [modalità manuale](/docs/it/permission-modes) per i percorsi all'interno della directory di lavoro. Gli strumenti di accesso ai file contrassegnati No, inclusi `Read`, `Grep` e `Glob`, richiedono comunque prompt per i percorsi al di fuori della [directory di lavoro e delle directory aggiuntive](/docs/it/permissions#working-directories). `Bash` è contrassegnato Yes ma esegue un set integrato di [comandi di sola lettura](/docs/it/permissions#read-only-commands) senza richiedere prompt.16 In [modalità automatica](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), un classificatore decide la maggior parte dei prompt di autorizzazione invece di te. La colonna `Permission required` mostra se lo strumento richiede prompt in [modalità manuale](/docs/it/permission-modes) per i percorsi all'interno della directory di lavoro. Gli strumenti di accesso ai file contrassegnati No, inclusi `Read`, `Grep` e `Glob`, richiedono comunque prompt per i percorsi al di fuori della [directory di lavoro e delle directory aggiuntive](/docs/it/permissions#working-directories). `Bash` è contrassegnato Yes ma esegue un set integrato di [comandi di sola lettura](/docs/it/permissions#read-only-commands) senza richiedere prompt.

17</Info>17</Info>

18 18

34| `Glob` | Trova file in base alla corrispondenza di pattern. Assente per impostazione predefinita su macOS, Linux e WSL. Vedi [Comportamento dello strumento Glob](#glob-tool-behavior) | No |34| `Glob` | Trova file in base alla corrispondenza di pattern. Assente per impostazione predefinita su macOS, Linux e WSL. Vedi [Comportamento dello strumento Glob](#glob-tool-behavior) | No |

35| `Grep` | Cerca pattern nei contenuti dei file. Assente per impostazione predefinita su macOS, Linux e WSL. Vedi [Comportamento dello strumento Grep](#grep-tool-behavior) | No |35| `Grep` | Cerca pattern nei contenuti dei file. Assente per impostazione predefinita su macOS, Linux e WSL. Vedi [Comportamento dello strumento Grep](#grep-tool-behavior) | No |

36| `ListAgents` | Elenca gli agenti con cui Claude può inviare messaggi con `SendMessage`: subagent nella sessione, compagni di squadra del [team di agenti](/docs/it/agent-teams), le tue altre sessioni locali di Claude Code e, mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control), le tue sessioni di [Claude Code sul web](/docs/it/claude-code-on-the-web) e le tue sessioni Remote Control su altre macchine. Supporta il comando `/list-agents`. Vedi [messaggistica tra sessioni](/docs/it/cross-session-messaging). Richiede Claude Code v2.1.224 o successivo e appare solo nelle sessioni in cui la [messaggistica tra sessioni è abilitata](/docs/it/cross-session-messaging#availability). Le righe dei compagni di squadra e la prima riga che mostra il nome della sessione stessa richiedono v2.1.239 o successivo | No |36| `ListAgents` | Elenca gli agenti con cui Claude può inviare messaggi con `SendMessage`: subagent nella sessione, compagni di squadra del [team di agenti](/docs/it/agent-teams), le tue altre sessioni locali di Claude Code e, mentre questa sessione è connessa a [Remote Control](/docs/it/remote-control), le tue sessioni di [Claude Code sul web](/docs/it/claude-code-on-the-web) e le tue sessioni Remote Control su altre macchine. Supporta il comando `/list-agents`. Vedi [messaggistica tra sessioni](/docs/it/cross-session-messaging). Richiede Claude Code v2.1.224 o successivo e appare solo nelle sessioni in cui la [messaggistica tra sessioni è abilitata](/docs/it/cross-session-messaging#availability). Le righe dei compagni di squadra e la prima riga che mostra il nome della sessione stessa richiedono v2.1.239 o successivo | No |

~~37| `ListMcpResourcesTool` | Elenca le risorse esposte dai [server MCP](/docs/it/mcp) connessi | No |~~37| `ListMcpResourcesTool` | Elenca le risorse esposte dai [server MCP](/docs/it/mcp) connessi, escludendo le [risorse dell'interfaccia utente delle app MCP](/docs/it/mcp#reference-mcp-resources), che sono pagine per un'applicazione host da renderizzare | No |

38| `LSP` | Intelligenza del codice tramite language server: salta alle definizioni, trova riferimenti, segnala errori di tipo e avvisi. Vedi [Comportamento dello strumento LSP](#lsp-tool-behavior) | No |38| `LSP` | Intelligenza del codice tramite language server: salta alle definizioni, trova riferimenti, segnala errori di tipo e avvisi. Vedi [Comportamento dello strumento LSP](#lsp-tool-behavior) | No |

39| `Monitor` | Esegue un comando in background e restituisce ogni riga di output a Claude, in modo che possa reagire alle voci di log, ai cambiamenti di file o allo stato sottoposto a polling a metà conversazione. Può anche aprire un WebSocket e trattare ogni messaggio in arrivo come un evento. Vedi [Strumento Monitor](#monitor-tool) | Yes |39| `Monitor` | Esegue un comando in background e restituisce ogni riga di output a Claude, in modo che possa reagire alle voci di log, ai cambiamenti di file o allo stato sottoposto a polling a metà conversazione. Può anche aprire un WebSocket e trattare ogni messaggio in arrivo come un evento. Vedi [Strumento Monitor](#monitor-tool) | Yes |

40| `NotebookEdit` | Modifica le celle del notebook Jupyter. Vedi [Comportamento dello strumento NotebookEdit](#notebookedit-tool-behavior) | Yes |40| `NotebookEdit` | Modifica le celle del notebook Jupyter. Vedi [Comportamento dello strumento NotebookEdit](#notebookedit-tool-behavior) | Yes |

troubleshoot-install.md +43 −1

Details

41| `running scripts is disabled on this system` o `PSSecurityException` | [Consenti l'esecuzione dei shim npm](#running-scripts-is-disabled-on-this-system) |41| `running scripts is disabled on this system` o `PSSecurityException` | [Consenti l'esecuzione dei shim npm](#running-scripts-is-disabled-on-this-system) |

42| `Error: claude native binary not installed` | [Completa l'installazione npm](#native-binary-not-found-after-npm-install) |42| `Error: claude native binary not installed` | [Completa l'installazione npm](#native-binary-not-found-after-npm-install) |

43| `npm error code ENOTEMPTY` durante l'aggiornamento o la reinstallazione | [Rimuovi la directory del pacchetto rimasta](#npm-enotempty-during-update-or-reinstall) |43| `npm error code ENOTEMPTY` durante l'aggiornamento o la reinstallazione | [Rimuovi la directory del pacchetto rimasta](#npm-enotempty-during-update-or-reinstall) |

44| `'claude' is not recognized` subito dopo un aggiornamento su Windows | [Ripristina `claude.exe` dal suo backup](#claude-exe-missing-after-an-update-on-windows) |

44| Su Windows, il comando di installazione stampa il testo dello script e nulla viene installato | [Esegui il comando di installazione completo](#wrong-install-command-on-windows) |45| Su Windows, il comando di installazione stampa il testo dello script e nulla viene installato | [Esegui il comando di installazione completo](#wrong-install-command-on-windows) |

45| `App unavailable in region` | Claude Code non è disponibile nel tuo paese. Vedi [paesi supportati](https://www.anthropic.com/supported-countries). |46| `App unavailable in region` | Claude Code non è disponibile nel tuo paese. Vedi [paesi supportati](https://www.anthropic.com/supported-countries). |

46| `unable to get local issuer certificate` | [Configura i certificati CA aziendali](#tls-or-ssl-connection-errors) |47| `unable to get local issuer certificate` | [Configura i certificati CA aziendali](#tls-or-ssl-connection-errors) |

47| `OAuth error` o `403 Forbidden` | [Correggi l'autenticazione](#login-and-authentication) |48| `OAuth error` o `403 Forbidden` | [Correggi l'autenticazione](#login-and-authentication) |

49| `Claude Code access has not been granted for this account` | [Ottieni un ruolo che include Claude Code](#claude-code-access-has-not-been-granted-for-this-account) |

48| `Unable to connect to Anthropic services` durante la configurazione | Vedi [Unable to connect to Anthropic services](/docs/it/errors#unable-to-connect-to-anthropic-services) nel riferimento degli errori |50| `Unable to connect to Anthropic services` durante la configurazione | Vedi [Unable to connect to Anthropic services](/docs/it/errors#unable-to-connect-to-anthropic-services) nel riferimento degli errori |

49| `Could not load the default credentials` o `Could not load credentials from any providers` | [Credenziali Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |51| `Could not load the default credentials` o `Could not load credentials from any providers` | [Credenziali Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

50| `ChainedTokenCredential authentication failed` o `CredentialUnavailableError` | [Credenziali Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |52| `ChainedTokenCredential authentication failed` o `CredentialUnavailableError` | [Credenziali Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

142 source ~/.zshrc144 source ~/.zshrc

143 ```145 ```

144 146

145 Per Bash, il default sulla maggior parte delle distribuzioni Linux:147 Per Bash su Linux, dove è il default sulla maggior parte delle distribuzioni:

146 148

147 ```bash theme={null}149 ```bash theme={null}

148 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc150 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

149 source ~/.bashrc151 source ~/.bashrc

150 ```152 ```

151 153

154 Per Bash su macOS, aggiungi la riga a `~/.bash_profile` invece. Terminal su macOS avvia Bash come shell di login, che ignora `~/.bashrc` e legge solo il primo di `~/.bash_profile`, `~/.bash_login`, o `~/.profile` che esiste. Se hai già un `~/.bash_login` o `~/.profile` e nessun `~/.bash_profile`, metti la riga in quel file piuttosto che creare `~/.bash_profile`:

155

156 ```bash theme={null}

157 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile

158 source ~/.bash_profile

159 ```

160

152 In alternativa, chiudi e riapri il tuo terminale.161 In alternativa, chiudi e riapri il tuo terminale.

153 162

154 Per altri shell come fish o Nushell, aggiungi `~/.local/bin` al tuo PATH usando la sintassi di configurazione del tuo shell, quindi riavvia il tuo terminale.163 Per altri shell come fish o Nushell, aggiungi `~/.local/bin` al tuo PATH usando la sintassi di configurazione del tuo shell, quindi riavvia il tuo terminale.

593irm https://claude.ai/install.ps1 | iex602irm https://claude.ai/install.ps1 | iex

594```603```

595 604

605<h3 id="claude-exe-missing-after-an-update-on-windows">

606 `claude.exe` mancante dopo un aggiornamento su Windows

607</h3>

608

609Se il vostro terminale segnala `'claude' is not recognized` subito dopo che Claude Code si è aggiornato su Windows, verificare se `%USERPROFILE%\.local\bin` contiene ancora `claude.exe`. Se quella directory non è affatto sul vostro PATH, vedere [Correggere il vostro PATH](#command-not-found-claude-after-installation). Per aggiornare su Windows, Claude Code rinomina il `claude.exe` esistente da parte a un backup e sposta la nuova versione al suo posto. Se lo spostamento della nuova versione al suo posto fallisce e Claude Code non riesce nemmeno a rinominare il backup indietro, la directory mantiene il backup ma non ha `claude.exe`.

610

611Il backup è un file nella stessa directory il cui nome inizia con `claude.exe.old.` seguito da un timestamp numerico. Eseguire quanto segue in PowerShell per rinominare il backup più recente indietro a `claude.exe`:

612

613```powershell theme={null}

614Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

615```

616

617Quindi eseguire `claude --version` per confermare la correzione. Un `claude.exe` ripristinato stampa un numero di versione.

618

619Se non c'è un file `claude.exe.old.*`, o `claude` fallisce ancora dopo il rinomina, reinstallare:

620

621```powershell theme={null}

622irm https://claude.ai/install.ps1 | iex

623```

624

625Prima di v2.1.281, Claude Code potrebbe eliminare il backup mentre `claude.exe` era ancora mancante.

626

596<h3 id="install-killed-on-low-memory-linux-servers">627<h3 id="install-killed-on-low-memory-linux-servers">

597 Installazione interrotta su server Linux con poca memoria628 Installazione interrotta su server Linux con poca memoria

598</h3>629</h3>

992* **Utenti della Console Anthropic**: conferma che il tuo account ha il ruolo "Claude Code" o "Developer". Gli amministratori assegnano questo nella Console Anthropic sotto Impostazioni → Membri.1023* **Utenti della Console Anthropic**: conferma che il tuo account ha il ruolo "Claude Code" o "Developer". Gli amministratori assegnano questo nella Console Anthropic sotto Impostazioni → Membri.

993* **Dietro un proxy**: i proxy aziendali possono interferire con le richieste API. Vedi [configurazione di rete](/docs/it/network-config) per la configurazione del proxy.1024* **Dietro un proxy**: i proxy aziendali possono interferire con le richieste API. Vedi [configurazione di rete](/docs/it/network-config) per la configurazione del proxy.

994 1025

1026<h3 id="claude-code-access-has-not-been-granted-for-this-account">

1027 Claude Code access has not been granted for this account

1028</h3>

1029

1030Se la pagina di accesso mostra `Authorization failed` con il messaggio `Claude Code access has not been granted for this account. Contact your administrator.` dopo che accedi da Claude Code, la tua organizzazione Claude Enterprise ha impostato il tuo ruolo su Custom e nessuno dei [custom roles](https://support.claude.com/en/articles/13930452) assegnati ai tuoi gruppi concede l'accesso a Claude Code. Nel ruolo Custom, ottieni l'accesso solo da quei custom roles, quindi nulla di quello che cambi in Claude Code risolve questo errore.

1031

1032Per ottenere l'accesso:

1033

10341. Chiedi a un Owner della tua organizzazione Claude di assegnare un custom role che conceda l'accesso a Claude Code a uno dei tuoi gruppi, o di cambiare il tuo ruolo da Custom a un ruolo standard come User. Gli Owner gestiscono i ruoli nelle [impostazioni dei ruoli](https://claude.ai/admin-settings/roles) dell'organizzazione.

10352. Dopo che l'Owner apporta il cambiamento, esegui `claude` e accedi di nuovo.

1036

995<h3 id="this-organization-has-been-disabled-with-an-active-subscription">1037<h3 id="this-organization-has-been-disabled-with-an-active-subscription">

996 Questa organizzazione è stata disabilitata con un abbonamento attivo1038 Questa organizzazione è stata disabilitata con un abbonamento attivo

997</h3>1039</h3>

troubleshooting.md +1 −0

Details

17| Sessione avviata in modalità auto, o Claude modifica file ed esegue comandi senza chiedere | [Which mode a session starts in](/docs/it/permission-modes#which-mode-a-session-starts-in) |17| Sessione avviata in modalità auto, o Claude modifica file ed esegue comandi senza chiedere | [Which mode a session starts in](/docs/it/permission-modes#which-mode-a-session-starts-in) |

18| `API Error: 5xx`, `529 Overloaded`, `429`, errori di convalida delle richieste | [Error reference](/docs/it/errors) |18| `API Error: 5xx`, `529 Overloaded`, `429`, errori di convalida delle richieste | [Error reference](/docs/it/errors) |

19| `model not found` o `you may not have access to it` | [Error reference](/docs/it/errors#theres-an-issue-with-the-selected-model) |19| `model not found` o `you may not have access to it` | [Error reference](/docs/it/errors#theres-an-issue-with-the-selected-model) |

20| Un comando che Claude esegue fallisce con `Your disk quota is full`, `is full (ENOSPC)`, o `Command output was lost` | [Error reference](/docs/it/errors#disk-quota-or-temp-filesystem-is-full) |

20| L'estensione VS Code non si connette o non rileva Claude | [VS Code integration](/docs/it/vs-code#fix-common-issues) |21| L'estensione VS Code non si connette o non rileva Claude | [VS Code integration](/docs/it/vs-code#fix-common-issues) |

21| `Claude Code process exited with code 1` in VS Code o in un'app SDK | [Error reference](/docs/it/errors#claude-code-process-exited-with-code-n) |22| `Claude Code process exited with code 1` in VS Code o in un'app SDK | [Error reference](/docs/it/errors#claude-code-process-exited-with-code-n) |

22| Il plugin JetBrains o l'IDE non viene rilevato | [JetBrains integration](/docs/it/jetbrains#troubleshooting) |23| Il plugin JetBrains o l'IDE non viene rilevato | [JetBrains integration](/docs/it/jetbrains#troubleshooting) |

voice-dictation.md +2 −2

Details

30 Abilita la dettatura vocale30 Abilita la dettatura vocale

31</h2>31</h2>

32 32

33Esegui `/voice` per abilitare la dettatura. La prima volta che la abiliti, Claude Code esegue un controllo del microfono. Su macOS, questo attiva il prompt di autorizzazione del microfono di sistema per il tuo terminale se non è mai stato concesso.33Esegui `/voice` per abilitare la dettatura. Quando la abiliti, Claude Code esegue un controllo del microfono. Su macOS, questo attiva il prompt di autorizzazione del microfono di sistema per il tuo terminale se non è mai stato concesso.

34 34

35```35```

36/voice36/voice

190* **`Voice mode requires SoX for audio recording` su Linux**: il modulo audio nativo non ha potuto caricarsi e nessun fallback è installato. Installa SoX con il comando mostrato nel messaggio di errore, ad esempio `sudo apt-get install sox`.190* **`Voice mode requires SoX for audio recording` su Linux**: il modulo audio nativo non ha potuto caricarsi e nessun fallback è installato. Installa SoX con il comando mostrato nel messaggio di errore, ad esempio `sudo apt-get install sox`.

191* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX è installato, ma l'host non ha alcun dispositivo di cattura audio, ad esempio un server headless o un container. Esegui Claude Code su una macchina con un microfono. A partire dalla v2.1.195, Claude Code su Linux segnala questo messaggio in quella situazione; le versioni precedenti ti chiedevano di installare SoX anche quando era già installato.191* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX è installato, ma l'host non ha alcun dispositivo di cattura audio, ad esempio un server headless o un container. Esegui Claude Code su una macchina con un microfono. A partire dalla v2.1.195, Claude Code su Linux segnala questo messaggio in quella situazione; le versioni precedenti ti chiedevano di installare SoX anche quando era già installato.

192* **`Voice mode could not find a working audio recorder in WSL`**: WSLg instrada l'audio attraverso PulseAudio piuttosto che un dispositivo ALSA, quindi SoX ha bisogno che il suo backend PulseAudio sia installato esplicitamente. Esegui `sudo apt install sox libsox-fmt-pulse`. L'installazione di `sox` da sola estrae il backend ALSA, che non può registrare su WSL perché non c'è alcun dispositivo `/dev/snd`.192* **`Voice mode could not find a working audio recorder in WSL`**: WSLg instrada l'audio attraverso PulseAudio piuttosto che un dispositivo ALSA, quindi SoX ha bisogno che il suo backend PulseAudio sia installato esplicitamente. Esegui `sudo apt install sox libsox-fmt-pulse`. L'installazione di `sox` da sola estrae il backend ALSA, che non può registrare su WSL perché non c'è alcun dispositivo `/dev/snd`.

193* **`Voice input is failing repeatedly and has been paused`**: la dettatura vocale ha riscontrato tre errori di cattura entro 10 secondi. Claude Code mette in pausa la dettatura fino a quando non siano passati 10 secondi dal primo di questi errori. Un errore conta sia che il microfono non riesca ad avviarsi sia che il registratore si avvii e poi si fermi senza produrre alcun audio. Questo di solito significa che il microfono o lo stack audio su questo host non può catturare l'audio, ad esempio un server headless, una shell remota senza passthrough audio, o un'autorizzazione del microfono negata. Conferma un dispositivo di input funzionante, correggi la causa sottostante dalle voci precedenti, quindi attiva di nuovo la voce. Prima della v2.1.202, solo gli errori di avvio contavano verso la pausa.193* **`Voice input is failing repeatedly and has been paused`**: la dettatura vocale ha riscontrato tre errori entro 10 secondi. Claude Code mette in pausa la dettatura fino a quando non siano passati 10 secondi dal primo di questi errori. Questo di solito significa che il microfono o lo stack audio su questo host non può catturare l'audio, ad esempio un server headless, una shell remota senza passthrough audio, o un'autorizzazione del microfono negata. Conferma un dispositivo di input funzionante, correggi la causa sottostante dalle voci precedenti, quindi attiva di nuovo la voce. Prima della v2.1.202, solo gli errori di avvio contavano verso la pausa.

194* **Nulla accade quando tieni premuto `Space` in modalità pressione prolungata**: osserva l'input del prompt mentre tieni premuto. Se gli spazi continuano ad accumularsi, la dettatura vocale è probabilmente disattivata; esegui `/voice hold` per abilitarla. Se appare solo uno o due spazi e poi nulla, la dettatura vocale è attiva ma il rilevamento della pressione prolungata non si attiva. Il rilevamento della pressione prolungata richiede che il tuo terminale invii eventi di ripetizione dei tasti, quindi non può rilevare un tasto premuto se la ripetizione dei tasti è disabilitata a livello del sistema operativo. Passa a modalità tocco con `/voice tap` per evitare il requisito di ripetizione dei tasti.194* **Nulla accade quando tieni premuto `Space` in modalità pressione prolungata**: osserva l'input del prompt mentre tieni premuto. Se gli spazi continuano ad accumularsi, la dettatura vocale è probabilmente disattivata; esegui `/voice hold` per abilitarla. Se appare solo uno o due spazi e poi nulla, la dettatura vocale è attiva ma il rilevamento della pressione prolungata non si attiva. Il rilevamento della pressione prolungata richiede che il tuo terminale invii eventi di ripetizione dei tasti, quindi non può rilevare un tasto premuto se la ripetizione dei tasti è disabilitata a livello del sistema operativo. Passa a modalità tocco con `/voice tap` per evitare il requisito di ripetizione dei tasti.

195* **Toccare `Space` digita uno spazio invece di registrare in modalità tocco**: il primo tocco avvia la registrazione solo quando l'input del prompt è vuoto. Cancella prima l'input, oppure verifica di essere in modalità tocco eseguendo `/voice tap`.195* **Toccare `Space` digita uno spazio invece di registrare in modalità tocco**: il primo tocco avvia la registrazione solo quando l'input del prompt è vuoto. Cancella prima l'input, oppure verifica di essere in modalità tocco eseguendo `/voice tap`.

196* **`No audio detected from microphone`**: la registrazione è iniziata ma ha catturato il silenzio. Conferma che il dispositivo di input corretto è impostato come predefinito di sistema e che il suo livello di input non è disattivato o vicino a zero. Su Windows, apri Impostazioni → Sistema → Suono → Input e seleziona il tuo microfono. Su macOS, apri Impostazioni di sistema → Suono → Input.196* **`No audio detected from microphone`**: la registrazione è iniziata ma ha catturato il silenzio. Conferma che il dispositivo di input corretto è impostato come predefinito di sistema e che il suo livello di input non è disattivato o vicino a zero. Su Windows, apri Impostazioni → Sistema → Suono → Input e seleziona il tuo microfono. Su macOS, apri Impostazioni di sistema → Suono → Input.

vs-code.md +30 −7

Details

109 109

110La casella di prompt supporta diverse funzionalità:110La casella di prompt supporta diverse funzionalità:

111 111

112* **Modalità di autorizzazione**: fai clic sull'indicatore di modalità nella parte inferiore della casella di prompt per cambiare le modalità di autorizzazione. Nei piani Pro, Max e Team, Auto è la modalità di autorizzazione predefinita all'avvio. Consulta [come l'estensione sceglie la modalità di autorizzazione iniziale](/docs/it/permission-modes#switch-permission-modes) per sapere cosa la cambia e ogni modalità di autorizzazione che l'indicatore offre.112* **Modalità di autorizzazione**: fai clic sull'indicatore di modalità nella parte inferiore della casella di prompt per cambiare le modalità di autorizzazione. Con Claude Code v2.1.283 o successivo, Auto è la modalità di autorizzazione predefinita all'avvio, e nelle versioni precedenti solo nei piani Pro, Max e Team. Consulta [come l'estensione sceglie la modalità di autorizzazione iniziale](/docs/it/permission-modes#switch-permission-modes) per sapere cosa la cambia e ogni modalità di autorizzazione che l'indicatore offre.

113 * **Auto**: un classificatore esamina la maggior parte delle azioni invece di chiederti. Consulta [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) per sapere cosa esamina e blocca.113 * **Auto**: un classificatore esamina la maggior parte delle azioni invece di chiederti. Consulta [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) per sapere cosa esamina e blocca.

114 * **Manual**: Claude chiede l'autorizzazione prima delle modifiche ai file e della maggior parte dei comandi shell.114 * **Manual**: Claude chiede l'autorizzazione prima delle modifiche ai file e della maggior parte dei comandi shell.

115 * **Plan**: Claude descrive cosa farà e attende l'approvazione prima di apportare modifiche. VS Code apre automaticamente il piano come documento Markdown completo dove puoi aggiungere commenti inline per fornire feedback prima che Claude inizi.115 * **Plan**: Claude descrive cosa farà e attende l'approvazione prima di apportare modifiche. VS Code apre automaticamente il piano come documento Markdown completo dove puoi aggiungere commenti inline per fornire feedback prima che Claude inizi.

123* **Model**: seleziona **Switch model…** dal menu dei comandi per cambiare il modello durante la sessione. Puoi anche fare clic sul nome del modello nella parte inferiore della casella di prompt per aprire lo stesso selettore.123* **Model**: seleziona **Switch model…** dal menu dei comandi per cambiare il modello durante la sessione. Puoi anche fare clic sul nome del modello nella parte inferiore della casella di prompt per aprire lo stesso selettore.

124 124

125 Quando il modello attuale supporta [livelli di sforzo](/docs/it/model-config#adjust-effort-level), il selettore mostra anche una riga **Effort** e il pulsante del nome del modello mostra il livello selezionato. Quando scegli un livello diverso da `max`, Claude Code lo salva per il modello attuale come predefinito, sotto [`modelSettings`](/docs/it/settings-reference#modelsettings) nelle impostazioni utente; `max` si applica solo alla sessione corrente. Il pulsante del nome del modello e la riga **Effort** richiedono Claude Code v2.1.257 o successivo.125 Quando il modello attuale supporta [livelli di sforzo](/docs/it/model-config#adjust-effort-level), il selettore mostra anche una riga **Effort** e il pulsante del nome del modello mostra il livello selezionato. Quando scegli un livello diverso da `max`, Claude Code lo salva per il modello attuale come predefinito, sotto [`modelSettings`](/docs/it/settings-reference#modelsettings) nelle impostazioni utente; `max` si applica solo alla sessione corrente. Il pulsante del nome del modello e la riga **Effort** richiedono Claude Code v2.1.257 o successivo.

126

127 Quando i [flussi di lavoro dinamici](/docs/it/workflows) sono abilitati e il modello attuale li supporta, un interruttore **Ultracode** appare sotto la riga **Effort**. Attivalo per fare in modo che Claude pianifichi un [flusso di lavoro](/docs/it/workflows#let-claude-decide-with-ultracode) per ogni compito sostanziale in questa sessione, al livello di sforzo selezionato. Mentre è attivo, il pulsante del nome del modello mostra `· Ultracode` dopo il livello. L'interruttore richiede Claude Code v2.1.284 o successivo.

126* **Command menu**: fai clic su `/` o digita `/` per aprire il menu dei comandi. Le opzioni includono l'allegazione di file, il cambio di modelli e l'attivazione del pensiero esteso.128* **Command menu**: fai clic su `/` o digita `/` per aprire il menu dei comandi. Le opzioni includono l'allegazione di file, il cambio di modelli e l'attivazione del pensiero esteso.

127 129

128 La sezione Customize fornisce accesso ai server MCP, comandi, stili di output, hooks, memoria, istruzioni, autorizzazioni e plugin. Gli elementi con un'icona di terminale si aprono nel terminale integrato.130 La sezione Customize include voci come server MCP, comandi, stili di output, hooks, memoria, istruzioni, autorizzazioni e plugin. Gli elementi con un'icona di terminale si aprono nel terminale integrato.

129 131

130 * Per sfogliare comandi come `/usage` o [`/remote-control`](/docs/it/remote-control), seleziona **Slash commands** nella sezione Customize. Una finestra di dialogo li elenca con una casella di filtro. Scegline uno per eseguirlo. Digitare `/` nella casella di prompt suggerisce comunque i comandi inline. Richiede Claude Code v2.1.257 o successivo.132 * Per sfogliare comandi come `/usage` o [`/remote-control`](/docs/it/remote-control), seleziona **Slash commands** nella sezione Customize. Una finestra di dialogo li elenca con una casella di filtro. Scegline uno per eseguirlo. Digitare `/` nella casella di prompt suggerisce comunque i comandi inline. Richiede Claude Code v2.1.257 o successivo.

131 133

150 152

151 L'elenco di cose da fare più recente di Claude rimane visibile, così come il testo di una domanda in sospeso da Claude; questo richiede Claude Code v2.1.225 o successivo. Mentre Claude esegue [subagenti](/docs/it/sub-agents), le righe di progresso in tempo reale con la loro attività più recente appaiono sotto il gruppo di chiamate di strumenti che le ha avviate. Questo richiede Claude Code v2.1.269 o successivo.153 L'elenco di cose da fare più recente di Claude rimane visibile, così come il testo di una domanda in sospeso da Claude; questo richiede Claude Code v2.1.225 o successivo. Mentre Claude esegue [subagenti](/docs/it/sub-agents), le righe di progresso in tempo reale con la loro attività più recente appaiono sotto il gruppo di chiamate di strumenti che le ha avviate. Questo richiede Claude Code v2.1.269 o successivo.

152 * Per disconnetterti dal tuo account Anthropic, seleziona **Sign out** nella sezione Settings, o digita `/logout`. Su un [provider di terze parti](#use-third-party-providers), il menu non offre nessuno dei due. Richiede Claude Code v2.1.277 o successivo.154 * Per disconnetterti dal tuo account Anthropic, seleziona **Sign out** nella sezione Settings, o digita `/logout`. Su un [provider di terze parti](#use-third-party-providers), il menu non offre nessuno dei due. Richiede Claude Code v2.1.277 o successivo.

153 * Per segnalare un bug, fai clic su **Report a problem** nella parte inferiore del menu, o digita `/bug` o `/feedback` con una descrizione facoltativa che precompila il rapporto. Quando invii il rapporto e sei connesso ad Anthropic su una connessione di prima parte, Claude Code lo invia ad Anthropic. Su un provider di terze parti, o senza credenziali Anthropic, la finestra di dialogo si apre comunque, ma l'invio mostra un errore e non invia nulla: a differenza di `/bug` della CLI, l'estensione non scrive un archivio locale. Richiede Claude Code v2.1.229 o successivo.155 * Per segnalare un bug, fai clic su **Report a problem** nella parte inferiore del menu, o digita `/bug` o `/feedback` con una descrizione facoltativa che precompila il rapporto. Quando invii il rapporto e sei connesso ad Anthropic su una connessione di prima parte, Claude Code lo invia ad Anthropic. Richiede Claude Code v2.1.229 o successivo.

156

157 Su un provider di terze parti, o senza credenziali Anthropic, nulla viene inviato. La finestra di dialogo lo dice prima che tu scriva. L'invio salva il rapporto come [archivio locale sotto `~/.claude/feedback-bundles/`](/docs/it/data-usage#telemetry-services) con modelli di chiave API e token noti oscurati. Invia quel file al tuo rappresentante dell'account Anthropic o allegalo a una richiesta di supporto. La conferma nomina il file e include un pulsante **Show folder**. Salvare il rapporto sul tuo computer richiede Claude Code v2.1.284 o successivo.

154 158

155 Se la politica della tua organizzazione disattiva il feedback sui prodotti, **Report a problem** non appare nel menu, e `/bug` e `/feedback` mostrano un avviso `Feedback is turned off by your organization's policy or this environment's settings.` invece di aprire il rapporto.159 Se la politica della tua organizzazione disattiva il feedback sui prodotti, **Report a problem** non appare nel menu, e `/bug` e `/feedback` mostrano un avviso `Feedback is turned off by your organization's policy or this environment's settings.` invece di aprire il rapporto. Con Claude Code v2.1.284 o successivo, se imposti la variabile di ambiente `DISABLE_FEEDBACK_COMMAND` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, il feedback è anche disattivato e l'apertura del rapporto mostra quell'avviso invece.

156* **Side questions**: digita `/btw` seguito da una domanda per chiedere informazioni sulla tua sessione [senza aggiungere alla conversazione](/docs/it/interactive-mode#side-questions-with-%2Fbtw). La risposta si apre in un pannello accanto alla chat, dove puoi fare domande di follow-up. Il thread sopravvive ai ricaricamenti della finestra. Claude Code mantiene i 20 scambi più recenti e scade i thread archiviati secondo la pianificazione [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), purché Claude Code possa [determinare in sicurezza il periodo di conservazione](/docs/it/claude-directory#cleaned-up-automatically). Per cancellare un thread, fai clic sull'icona del cestino nel pannello. Richiede Claude Code v2.1.227 o successivo.160* **Side questions**: digita `/btw` seguito da una domanda per chiedere informazioni sulla tua sessione [senza aggiungere alla conversazione](/docs/it/interactive-mode#side-questions-with-%2Fbtw). La risposta si apre in un pannello accanto alla chat, dove puoi fare domande di follow-up. Il thread sopravvive ai ricaricamenti della finestra. Claude Code mantiene i 20 scambi più recenti e scade i thread archiviati secondo la pianificazione [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), purché Claude Code possa [determinare in sicurezza il periodo di conservazione](/docs/it/claude-directory#cleaned-up-automatically). Per cancellare un thread, fai clic sull'icona del cestino nel pannello. Richiede Claude Code v2.1.227 o successivo.

157* **Copy a response**: passa il mouse su una risposta e fai clic su **Copy response** per copiarla negli appunti, o digita `/copy` per copiare l'ultima risposta. `/copy 2` copia la penultima. Richiede Claude Code v2.1.277 o successivo.161* **Copy a response**: passa il mouse su una risposta e fai clic su **Copy response** per copiarla negli appunti, o digita `/copy` per copiare l'ultima risposta. `/copy 2` copia la penultima. Richiede Claude Code v2.1.277 o successivo.

158* **Context indicator**: la casella di prompt mostra quanto della finestra di contesto di Claude stai utilizzando. Claude compatta automaticamente quando necessario, oppure puoi eseguire `/compact` manualmente.162* **Context indicator**: la casella di prompt mostra quanto della finestra di contesto di Claude stai utilizzando. Claude compatta automaticamente quando necessario, oppure puoi eseguire `/compact` manualmente.

247</Steps>251</Steps>

248 252

249<Note>253<Note>

250 Solo le sessioni web avviate con un repository GitHub appaiono nella scheda Web. Il ripristino carica la cronologia della conversazione localmente; le modifiche non vengono sincronizzate di nuovo a claude.ai.254 Quando la cartella che hai aperto è un repository GitHub, la scheda Web mostra solo le sessioni da quel repository.

255

256 Quando riprendi una sessione cloud, l'estensione scarica una copia della cronologia della conversazione; le modifiche non vengono sincronizzate di nuovo a claude.ai.

251</Note>257</Note>

252 258

259La scheda Web elenca anche le tue sessioni [Remote Control](/docs/it/remote-control). Se fai clic su una che è stata eseguita nella cartella che hai aperto, l'estensione apre quella conversazione locale invece di scaricare una copia, e mette a fuoco la scheda che la mostra già se ce n'è una. Se l'estensione non può escludere che un altro processo Claude abbia la conversazione aperta, ricevi una copia scaricata invece.

260

261Se una parte di una conversazione non riesce a scaricarsi, appare un errore e nessuna copia viene salvata. Seleziona di nuovo la sessione per riprovare. Se selezioni una sessione che non ha ancora una conversazione da scaricare, un errore ti dice dove continuarla invece.

262

253<h3 id="check-account-and-usage">263<h3 id="check-account-and-usage">

254 Controlla account e utilizzo264 Controlla account e utilizzo

255</h3>265</h3>

269 Personalizza il tuo flusso di lavoro279 Personalizza il tuo flusso di lavoro

270</h2>280</h2>

271 281

272Puoi riposizionare il pannello Claude, eseguire più conversazioni, organizzare l'elenco delle sessioni in gruppi o passare alla modalità terminale.282Puoi riposizionare il pannello Claude, eseguire più conversazioni, organizzare l'elenco delle sessioni in gruppi o filtrare l'elenco delle sessioni, oppure passare alla modalità terminale.

273 283

274<h3 id="choose-where-claude-lives">284<h3 id="choose-where-claude-lives">

275 Scegli dove Claude si trova285 Scegli dove Claude si trova

319 329

320L'estensione salva i gruppi per cartella di workspace, quindi sopravvivono ai ricaricamenti della finestra e appaiono in ogni finestra in cui apri la stessa cartella. Quando cerchi nell'elenco, l'estensione mostra i risultati in un elenco piatto su tutti i gruppi.330L'estensione salva i gruppi per cartella di workspace, quindi sopravvivono ai ricaricamenti della finestra e appaiono in ogni finestra in cui apri la stessa cartella. Quando cerchi nell'elenco, l'estensione mostra i risultati in un elenco piatto su tutti i gruppi.

321 331

332<h3 id="filter-the-sessions-list">

333 Filtra l'elenco delle sessioni

334</h3>

335

336Per restringere un lungo elenco di sessioni nella Activity Bar, utilizza i due controlli di filtro nella parte superiore dell'elenco. Richiede Claude Code v2.1.271 o successivo. Le sessioni archiviate non appaiono mentre uno dei filtri è attivo.

337

338* **Active**: attiva questo interruttore per mostrare solo le sessioni che necessitano del tuo input, sono in corso di elaborazione o non lette, più la sessione nella scheda Claude su cui hai messo a fuoco per ultimo.

339* **Filter by status**: fai clic sull'icona dell'imbuto, quindi seleziona **Needs input**, **Working** o **Completed** per mostrare le sessioni in uno di questi stati. Seleziona **Open** o **Closed** per restringere in base al fatto che una sessione sia aperta. Una sessione conta come aperta quando ha una scheda in questa finestra o è in esecuzione in un altro processo Claude Code su questa macchina, ad esempio in un terminale.

340

341Quando **Active** è attivo e selezioni uno stato, **Open** o **Closed**, l'elenco mostra anche ogni sessione che corrisponde alle tue selezioni. I filtri che imposti persistono nei ricaricamenti della finestra.

342

322<h3 id="switch-to-terminal-mode">343<h3 id="switch-to-terminal-mode">

323 Passa alla modalità terminale344 Passa alla modalità terminale

324</h3>345</h3>

506L'estensione ha due tipi di impostazioni:527L'estensione ha due tipi di impostazioni:

507 528

508* **Impostazioni dell'estensione** in VS Code: controllano il comportamento dell'estensione all'interno di VS Code. Aprire con `Cmd+,` (Mac) o `Ctrl+,` (Windows/Linux), quindi andare a Estensioni → Claude Code. È anche possibile digitare `/` e selezionare **General config…** per aprire le impostazioni.529* **Impostazioni dell'estensione** in VS Code: controllano il comportamento dell'estensione all'interno di VS Code. Aprire con `Cmd+,` (Mac) o `Ctrl+,` (Windows/Linux), quindi andare a Estensioni → Claude Code. È anche possibile digitare `/` e selezionare **General config…** per aprire le impostazioni.

509* **Impostazioni di Claude Code** in `~/.claude/settings.json`: condivise tra l'estensione e CLI. Utilizzarle per i comandi consentiti, le variabili di ambiente, gli hooks e i server MCP. Nei piani Pro, Max e Team, è anche uno degli input della modalità di autorizzazione con cui iniziano le conversazioni. [Switch permission modes](/docs/it/permission-modes#switch-permission-modes) elenca l'ordine. Vedere [Settings](/docs/it/settings) per i dettagli.530* **Impostazioni di Claude Code** in `~/.claude/settings.json`: condivise tra l'estensione e CLI. Utilizzarle per i comandi consentiti, le variabili di ambiente, gli hooks e i server MCP. Con Claude Code v2.1.283 o successivo, è anche uno degli input della modalità di autorizzazione con cui iniziano le conversazioni, e nelle versioni precedenti solo nei piani Pro, Max e Team. [Switch permission modes](/docs/it/permission-modes#switch-permission-modes) elenca l'ordine. Vedere [Settings](/docs/it/settings) per i dettagli.

510 531

511<Tip>532<Tip>

512 Aggiungere `"$schema": "https://json.schemastore.org/claude-code-settings.json"` al vostro `settings.json` per ottenere il completamento automatico e la convalida inline per tutte le impostazioni disponibili direttamente in VS Code.533 Aggiungere `"$schema": "https://json.schemastore.org/claude-code-settings.json"` al vostro `settings.json` per ottenere il completamento automatico e la convalida inline per tutte le impostazioni disponibili direttamente in VS Code.

722 743

723**Selection and open-file context.** Mentre è connesso, il CLI include la selezione dell'editor corrente e il percorso del file attivo come contesto su ogni prompt che inviate. La trascrizione mostra una riga `⧉ Selected N lines from <file>` quando ciò accade.744**Selection and open-file context.** Mentre è connesso, il CLI include la selezione dell'editor corrente e il percorso del file attivo come contesto su ogni prompt che inviate. La trascrizione mostra una riga `⧉ Selected N lines from <file>` quando ciò accade.

724 745

746Se [accodate un messaggio mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works), mantiene la selezione che avevate quando avete premuto `Enter`, qualunque cosa selezioniate in seguito.

747

725Per escludere un file sensibile come `.env`, aggiungete una [regola di negazione `Read`](/docs/it/permissions#read-and-edit) per il suo percorso. Una regola di negazione corrispondente impedisce sia il testo selezionato che l'avviso del file aperto per quel file di raggiungere Claude.748Per escludere un file sensibile come `.env`, aggiungete una [regola di negazione `Read`](/docs/it/permissions#read-and-edit) per il suo percorso. Una regola di negazione corrispondente impedisce sia il testo selezionato che l'avviso del file aperto per quel file di raggiungere Claude.

726 749

727Se disattivate l'impostazione [Attach Open File](#extension-settings), il CLI riceve il percorso del file attivo solo mentre avete testo selezionato in esso.750Se disattivate l'impostazione [Attach Open File](#extension-settings), il CLI riceve il percorso del file attivo solo mentre avete testo selezionato in esso.

workflows.md +15 −7

Details

161 Lasciare che Claude decida con ultracode161 Lasciare che Claude decida con ultracode

162</h3>162</h3>

163 163

164Ultracode è un'impostazione di Claude Code che combina `xhigh` [sforzo di ragionamento](/docs/it/model-config#adjust-effort-level) con orchestrazione automatica del flusso di lavoro. Con essa attiva, Claude pianifica un flusso di lavoro per ogni compito sostanziale invece di aspettare che tu lo chieda.164Ultracode è un'impostazione di Claude Code che attiva l'orchestrazione automatica del flusso di lavoro per la sessione, a qualsiasi [livello di sforzo](/docs/it/model-config#adjust-effort-level) la sessione viene eseguita. Con essa attiva, Claude pianifica un flusso di lavoro per ogni compito sostanziale invece di aspettare che tu lo chieda. Attivalo al prompt di Claude Code:

165 165

166```text wrap theme={null}166```text wrap theme={null}

167/effort ultracode167/effort ultracode

168```168```

169 169

170Per avviare una sessione con ultracode già attivo, avvia con `claude --effort ultracode`. Richiede Claude Code v2.1.203 o successivo.170Per avviare una sessione con ultracode già attivo, avvia con `claude --effort ultracode`, che imposta anche il livello di sforzo su `xhigh`. Richiede Claude Code v2.1.203 o successivo.

171 171

172Per attivarlo mentre scegli un modello, sposta il cursore dello sforzo del selettore `/model` su `ultracode` con i tasti freccia. [Regola il livello di sforzo](/docs/it/model-config#adjust-effort-level) elenca i percorsi che attivano ultracode.172Per attivarlo dal cursore `/effort`, premi `Tab` per attivare/disattivare il toggle **Ultracode**, quindi `Enter` per applicarlo. [Regola il livello di sforzo](/docs/it/model-config#adjust-effort-level) elenca i percorsi che attivano ultracode.

173 173

174Con ultracode attivo, Claude decide quando un compito merita un flusso di lavoro. Una singola richiesta può trasformarsi in diversi flussi di lavoro di fila: uno per comprendere il codice, uno per fare il cambiamento e uno per verificarlo. Questo si applica a ogni compito nella sessione, quindi ogni richiesta usa più token e richiede più tempo rispetto ai livelli di sforzo inferiori.174Con ultracode attivo, Claude decide quando un compito merita un flusso di lavoro. Una singola richiesta può trasformarsi in diversi flussi di lavoro di fila: uno per comprendere il codice, uno per fare il cambiamento e uno per verificarlo. Questo si applica a ogni compito nella sessione, quindi ogni richiesta usa più token e richiede più tempo rispetto alla stessa richiesta senza un flusso di lavoro. Su un piano di abbonamento quei token vengono prelevati dai tuoi limiti di utilizzo, quindi una sessione con ultracode attivo raggiunge un limite di sessione o settimanale prima dello stesso lavoro con esso disattivato.

175 175

176`/effort ultracode` dura per la sessione corrente; per avere ogni sessione che inizi con esso, imposta l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode). Torna indietro con `/effort high` quando ritorni al lavoro di routine. Il menu `/effort` lo offre solo [quando ultracode è disponibile](/docs/it/model-config#when-ultracode-is-available).176L'attivazione di ultracode ti consente già di optare per esecuzioni di grandi dimensioni, quindi questi controlli non si applicano mentre è attivo:

177

178* L'avvertimento [`Large workflow`](#cost) non appare su un'esecuzione di flusso di lavoro

179* Il [limite di subagent concorrenti](/docs/it/sub-agents#concurrent-subagent-limit) della sessione non viene applicato per i subagent che Claude genera con lo strumento Agent

180* In modalità di autorizzazione automatica, non ti viene chiesto di [approvare il primo lancio del flusso di lavoro](#approve-the-plan-before-it-runs)

181

182`/effort ultracode` dura per la sessione corrente; per avere ogni sessione che inizi con esso, imposta l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode). Disattivalo con `/effort ultracode off` quando ritorni al lavoro di routine. Il cursore `/effort` offre il toggle solo [quando ultracode è disponibile](/docs/it/model-config#when-ultracode-is-available).

177 183

178<h3 id="approve-the-plan-before-it-runs">184<h3 id="approve-the-plan-before-it-runs">

179 Approvare il piano prima che venga eseguito185 Approvare il piano prima che venga eseguito

446 Quando un'esecuzione raggiunge il tuo limite di utilizzo452 Quando un'esecuzione raggiunge il tuo limite di utilizzo

447</h3>453</h3>

448 454

449Quando un agente raggiunge il tuo limite di utilizzo [usage limit](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset) su claude.ai, l'esecuzione si mette in pausa piuttosto che far fallire quell'agente: gli agenti che hanno raggiunto il limite aspettano il ripristino, e nessun nuovo agente si avvia. Poco dopo che il limite si ripristina, gli agenti in attesa vengono eseguiti di nuovo e l'esecuzione continua da sola. Richiede Claude Code v2.1.271 o successivo; nelle versioni precedenti, gli agenti interessati falliscono.455Quando un agente raggiunge il tuo limite di utilizzo su claude.ai [usage limit](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset), l'esecuzione si mette in pausa piuttosto che far fallire quell'agente: gli agenti che hanno raggiunto il limite aspettano il ripristino, e nessun nuovo agente si avvia. Poco dopo che il limite si ripristina, gli agenti in attesa vengono eseguiti di nuovo e l'esecuzione continua da sola. Richiede Claude Code v2.1.271 o successivo; nelle versioni precedenti, gli agenti interessati falliscono.

450 456

451Mentre l'esecuzione aspetta, la sua linea di progresso nel pannello attività e l'intestazione [`/workflows`](#watch-the-run) mostrano quando il limite si ripristina.457Mentre l'esecuzione aspetta, la sua linea di progresso nel pannello attività e l'intestazione [`/workflows`](#watch-the-run) mostrano quando il limite si ripristina.

452 458

516 522

517Per disattivare i workflow per l'intera organizzazione, imposta `"disableWorkflows": true` nelle [impostazioni gestite](/docs/it/server-managed-settings), oppure utilizza l'interruttore nella pagina [impostazioni admin di Claude Code](https://claude.ai/admin-settings/claude-code).523Per disattivare i workflow per l'intera organizzazione, imposta `"disableWorkflows": true` nelle [impostazioni gestite](/docs/it/server-managed-settings), oppure utilizza l'interruttore nella pagina [impostazioni admin di Claude Code](https://claude.ai/admin-settings/claude-code).

518 524

519Quando i workflow sono disabilitati, i comandi workflow in bundle e la skill `/workflow-authoring` non sono disponibili, la parola chiave `ultracode` non attiva più un'esecuzione, e `ultracode` viene rimosso dal menu `/effort`.525Quando i workflow sono disabilitati, i comandi workflow in bundle e la skill `/workflow-authoring` non sono disponibili, la parola chiave `ultracode` non attiva più un'esecuzione, e il toggle **Ultracode** viene rimosso da `/effort`. Un'esecuzione che era già in corso continua.

526

527Disattivare i workflow rende anche [ultracode](#let-claude-decide-with-ultracode) non disponibile. Nessuna impostazione gestita esclude ultracode da solo: ovunque sia [disponibile](/docs/it/model-config#when-ultracode-is-available), gli utenti possono attivarlo con `/effort ultracode`. Un [limite di sforzo](/docs/it/model-config#organization-effort-limits) abbassa il livello di sforzo che una sessione con ultracode attivo esegue, ma non disattiva ultracode.

520 528

521<h2 id="related-resources">529<h2 id="related-resources">

522 Risorse correlate530 Risorse correlate

worktrees.md +3 −3

Details

62Quando uscite da una sessione di worktree interattiva, Claude controlla il worktree per il lavoro che la rimozione eliminerebbe: file modificati o non tracciati, lavoro non committato all'interno di submodule estratti, e nuovi commit.62Quando uscite da una sessione di worktree interattiva, Claude controlla il worktree per il lavoro che la rimozione eliminerebbe: file modificati o non tracciati, lavoro non committato all'interno di submodule estratti, e nuovi commit.

63 63

64* **Il worktree è pulito**: per una sessione senza nome, Claude rimuove il worktree e il suo branch automaticamente. Una sessione [denominata](/docs/it/sessions#name-your-sessions) vi chiede prima in modo da poter mantenere il worktree per dopo64* **Il worktree è pulito**: per una sessione senza nome, Claude rimuove il worktree e il suo branch automaticamente. Una sessione [denominata](/docs/it/sessions#name-your-sessions) vi chiede prima in modo da poter mantenere il worktree per dopo

65* **Il worktree ha lavoro in esso**: Claude vi chiede di mantenere o rimuovere il worktree. Mantenere preserva la directory e il branch in modo da poter tornare in seguito. Rimuovere elimina la directory del worktree e il suo branch, insieme a tutto il lavoro in essi65* **Il worktree ha lavoro in esso**: Claude vi chiede di mantenere o rimuovere il worktree. Mantenere preserva la directory e il branch. Per tornare in seguito, eseguite il comando `claude --worktree <name> --resume` che Claude Code stampa all'uscita. Rimuovere elimina la directory del worktree e il suo branch, insieme a tutto il lavoro in essi

66* **Lo stato del worktree non può essere verificato**: quando Claude Code non riesce a contare i cambiamenti del worktree o non riesce a ispezionare i checkout dei suoi submodule, vi chiede piuttosto che rimuovere il worktree automaticamente. Il prompt nomina ciò che non ha potuto controllare66* **Lo stato del worktree non può essere verificato**: quando Claude Code non riesce a contare i cambiamenti del worktree o non riesce a ispezionare i checkout dei suoi submodule, vi chiede piuttosto che rimuovere il worktree automaticamente. Il prompt nomina ciò che non ha potuto controllare

67 67

68Le esecuzioni non interattive con `-p` non hanno un prompt di uscita, quindi Claude non pulisce i loro worktree, e Claude Code lascia il blocco che ha preso su ognuno al momento della creazione in posizione fino a quando una [scansione di blocco stale](#clean-up-subagent-and-background-session-worktrees) successiva della sessione lo rilascia. Per rimuoverne uno, eseguite `git worktree remove`; se git rifiuta perché il worktree è bloccato, eseguite prima `git worktree unlock` su di esso.68Le esecuzioni non interattive con `-p` non hanno un prompt di uscita, quindi Claude non pulisce i loro worktree, e Claude Code lascia il blocco che ha preso su ognuno al momento della creazione in posizione fino a quando una [scansione di blocco stale](#clean-up-subagent-and-background-session-worktrees) successiva della sessione lo rilascia. Per rimuoverne uno, eseguite `git worktree remove`; se git rifiuta perché il worktree è bloccato, eseguite prima `git worktree unlock` su di esso.

73 Riprendere una sessione di worktree73 Riprendere una sessione di worktree

74</h2>74</h2>

75 75

76Quando riprendete una sessione che era all'interno di un worktree, Claude Code restituisce la sessione a quel worktree. Questo vale per le riprese interattive, per `--continue` e `--resume` in [modalità non interattiva](/docs/it/headless) con `-p`, e per l'Agent SDK. Di nuovo all'interno del worktree, Claude può ancora uscirne con lo strumento [`ExitWorktree`](/docs/it/tools-reference).76Quando riprendete una sessione che era terminata all'interno di un worktree senza [uscirne](#clean-up-worktrees), Claude Code restituisce la sessione a quel worktree. Questo vale per le riprese interattive, per `--continue` e `--resume` in [modalità non interattiva](/docs/it/headless) con `-p`, e per l'Agent SDK. `--continue` seleziona la sessione più recente registrata nella directory da cui lanciate. Di nuovo all'interno del worktree, Claude può ancora uscirne con lo strumento [`ExitWorktree`](/docs/it/tools-reference).

77 77

78Prima di restituire la sessione al suo worktree, Claude Code verifica che il worktree sia ancora un checkout separato da quello principale, e rifiuta di rientrare in un worktree che fallisce il controllo. Per un git worktree, il controllo legge i suoi metadati git. Un worktree senza metadati git, come uno che un hook [`WorktreeCreate`](#non-git-version-control) ha creato, può passare il controllo; i casi che Claude Code ancora rifiuta sono elencati con i loro recuperi sotto [Claude Code rifiuta di usare un worktree](#claude-code-refuses-to-use-a-worktree). Per i messaggi e come recuperare da ognuno, vedere [La sessione riprende al di fuori del suo worktree](#the-session-resumes-outside-its-worktree).78Prima di restituire la sessione al suo worktree, Claude Code verifica che il worktree sia ancora un checkout separato da quello principale, e rifiuta di rientrare in un worktree che fallisce il controllo. Per un git worktree, il controllo legge i suoi metadati git. Un worktree senza metadati git, come uno che un hook [`WorktreeCreate`](#non-git-version-control) ha creato, può passare il controllo; i casi che Claude Code ancora rifiuta sono elencati con i loro recuperi sotto [Claude Code rifiuta di usare un worktree](#claude-code-refuses-to-use-a-worktree). Per i messaggi e come recuperare da ognuno, vedere [La sessione riprende al di fuori del suo worktree](#the-session-resumes-outside-its-worktree).

79 79

80Dove lanciate da, e come riprendete, cambiano cosa Claude Code rientra:80Dove lanciate da, e come riprendete, cambiano cosa Claude Code rientra:

81 81

82* **Directory di lancio**: riprendete dal checkout principale o da un'altra directory del repository. Claude Code rientra in un worktree che ha creato con git sotto `.claude/worktrees/` anche quando lanciate da dentro di esso. Quando lanciate da dentro qualsiasi altro worktree, Claude Code rientra in esso solo se può garantirlo da lì: un worktree che è il suo proprio repository, uno senza metadati git, o un lancio da una sottodirectory di un worktree che avete creato con `git worktree add` rifiuta, quindi lanciate quelli dal checkout principale.82* **Directory di lancio**: riprendete con `--resume` dal checkout principale o da un'altra directory del repository. Claude Code rientra in un worktree che ha creato con git sotto `.claude/worktrees/` anche quando lanciate da dentro di esso. Quando lanciate da dentro qualsiasi altro worktree, Claude Code rientra in esso solo se può garantirlo da lì: un worktree che è il suo proprio repository, uno senza metadati git, o un lancio da una sottodirectory di un worktree che avete creato con `git worktree add` rifiuta, quindi lanciate quelli dal checkout principale.

83* **`--fork-session`**: la sessione biforcata inizia nella directory da cui avete lanciato Claude, e Claude Code lascia il worktree della sessione originale intatto.83* **`--fork-session`**: la sessione biforcata inizia nella directory da cui avete lanciato Claude, e Claude Code lascia il worktree della sessione originale intatto.

84* **Worktree eliminato**: se la directory del worktree non esiste più, Claude Code riprende la sessione nella directory da cui avete lanciato Claude. Vi dice che il worktree è scomparso e cancella il binding del worktree della sessione.84* **Worktree eliminato**: se la directory del worktree non esiste più, Claude Code riprende la sessione nella directory da cui avete lanciato Claude. Vi dice che il worktree è scomparso e cancella il binding del worktree della sessione.

85 85

Documentation 2026-09-28 22:59 UTC to 2026-09-29 16:01 UTC