Documentation 2026-11-10 21:57 UTC to 2026-11-11 22:59 UTC

96| [Managed policy CLAUDE.md](https://code.claude.com/docs/it/memory.md#deploy-organization-wide-claude-md) | Indicazioni comportamentali a livello di organizzazione per Claude, anziché una regola applicata dal client | File nel percorso della policy gestita |96| [Managed policy CLAUDE.md](https://code.claude.com/docs/it/memory.md#deploy-organization-wide-claude-md) | Indicazioni comportamentali a livello di organizzazione per Claude, anziché una regola applicata dal client | File nel percorso della policy gestita |

97| [MCP server control](https://code.claude.com/docs/it/managed-mcp.md) | 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 |97| [MCP server control](https://code.claude.com/docs/it/managed-mcp.md) | 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 |

98| [Plugin marketplace control](https://code.claude.com/docs/it/plugins/org.md#restrict-what-users-can-install) | Limitare quali fonti di marketplace gli utenti possono aggiungere e da quali possono installare, e rifiutare i flag CLI che caricano in sideload plugin, agenti e server MCP per una singola esecuzione. Bloccare le [fonti di plugin `command`](https://code.claude.com/docs/it/plugins/marketplace-reference#command-plugin-source) e definire un'allowlist dei marketplace i cui plugin possono essere suggeriti nel terminale | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |98| [Plugin marketplace control](https://code.claude.com/docs/it/plugins/org.md#restrict-what-users-can-install) | Limitare quali fonti di marketplace gli utenti possono aggiungere e da quali possono installare, e rifiutare i flag CLI che caricano in sideload plugin, agenti e server MCP per una singola esecuzione. Bloccare le [fonti di plugin `command`](https://code.claude.com/docs/it/plugins/marketplace-reference#command-plugin-source) e definire un'allowlist dei marketplace i cui plugin possono essere suggeriti nel terminale | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |

99| [Customization lockdown](https://code.claude.com/docs/it/settings-reference.md#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](https://code.claude.com/docs/it/skills.md#where-synced-skills-load) | `strictPluginOnlyCustomization` |99| [Customization lockdown](https://code.claude.com/docs/it/settings-reference.md#strictpluginonlycustomization) | Bloccare skill, agenti, hook e server MCP da fonti utente e progetto. Bloccare le skill interrompe anche la sincronizzazione delle [skill che i tuoi sviluppatori abilitano su claude.ai](https://code.claude.com/docs/it/skills.md#where-synced-skills-load) | `strictPluginOnlyCustomization` |

100| [Disable claude.ai sync](https://code.claude.com/docs/it/settings-reference.md#syncclaudeaiskills) | Impedire a Claude Code di caricare i [skills](https://code.claude.com/docs/it/skills.md#how-synced-skills-behave) e i [plugin](https://code.claude.com/docs/it/plugins/loading.md#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` |100| [Disable claude.ai sync](https://code.claude.com/docs/it/settings-reference.md#syncclaudeaiskills) | Impedire a Claude Code di caricare i [skills](https://code.claude.com/docs/it/skills.md#how-synced-skills-behave) e i [plugin](https://code.claude.com/docs/it/plugins/loading.md#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` |

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

102| [Login enforcement](https://code.claude.com/docs/it/settings-reference.md#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](https://code.claude.com/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` |102| [Login enforcement](https://code.claude.com/docs/it/settings-reference.md#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](https://code.claude.com/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` |

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Lo strumento advisor è sperimentale e richiede l'API Anthropic. Non è disponibile su Amazon Bedrock, Claude Platform su AWS, Google Cloud's Agent Platform o Microsoft Foundry. Il comportamento, i prezzi e la disponibilità potrebbero cambiare.11> Lo strumento advisor è sperimentale e richiede l'API Anthropic o [Claude Platform su AWS](https://code.claude.com/docs/it/claude-platform-on-aws.md). Su Claude Platform su AWS, richiede Claude Code v2.1.300 o versioni successive. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Il comportamento, i prezzi e la disponibilità potrebbero cambiare.

12 12 

13Lo strumento advisor consente a Claude di consultare un secondo modello, tipicamente più potente, nei momenti chiave durante un'attività, ad esempio prima di impegnarsi in un approccio, quando bloccato su un errore ricorrente, o prima di dichiarare un'attività completata. L'advisor riceve l'intera conversazione, incluse tutte le chiamate agli strumenti e i risultati, e restituisce una guida che Claude applica prima di continuare.13Lo strumento advisor consente a Claude di consultare un secondo modello, tipicamente più potente, nei momenti chiave durante un'attività, ad esempio prima di impegnarsi in un approccio, quando bloccato su un errore ricorrente, o prima di dichiarare un'attività completata. L'advisor riceve l'intera conversazione, incluse tutte le chiamate agli strumenti e i risultati, e restituisce una guida che Claude applica prima di continuare.

14 14 

174 174 

175## Requisiti175## Requisiti

176 176 

177Lo strumento advisor richiede tutti i seguenti:177* **Provider**: l'API Anthropic o [Claude Platform su AWS](https://code.claude.com/docs/it/claude-platform-on-aws.md), non Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Su Claude Platform su AWS, l'advisor richiede Claude Code v2.1.300 o successivo.

178 178* **Gateway LLM**: attraverso un [gateway LLM](https://code.claude.com/docs/it/llm-gateway) configurato con `ANTHROPIC_BASE_URL`, la disponibilità dipende dal fatto che il gateway inoltri la richiesta intatta all'API Anthropic. Se il gateway o il suo upstream non riconosce lo strumento advisor, consulta [Nuovo tentativo automatico e inoltro degli errori](https://code.claude.com/docs/it/llm-gateway-protocol.md#automatic-retry-and-error-forwarding) per sapere come Claude Code risponde.

179* **Solo API Anthropic**: l'advisor è uno strumento eseguito dal server. Non è disponibile su Amazon Bedrock, Claude Platform su AWS, Google Cloud's Agent Platform, o Microsoft Foundry. Attraverso un [gateway LLM](https://code.claude.com/docs/it/llm-gateway) configurato con `ANTHROPIC_BASE_URL`, la disponibilità dipende dal fatto che il gateway inoltri la richiesta intatta all'API Anthropic. Se il gateway o il suo upstream non riconosce lo strumento advisor, vedere [Retry automatico e inoltro degli errori](https://code.claude.com/docs/it/llm-gateway-protocol.md#automatic-retry-and-error-forwarding) per sapere come Claude Code risponde.

180* **Modello principale supportato**: Fable, Opus 4.6 o successivo, Sonnet 4.6 o successivo, Haiku 4.5 o Haiku 5.5. Consulta [Scegliere un modello advisor](#choose-an-advisor-model) per sapere quali advisor accetta ciascuno.179* **Modello principale supportato**: Fable, Opus 4.6 o successivo, Sonnet 4.6 o successivo, Haiku 4.5 o Haiku 5.5. Consulta [Scegliere un modello advisor](#choose-an-advisor-model) per sapere quali advisor accetta ciascuno.

181* **Recupero del feature flag**: Claude Code attiva l'advisor tramite un feature flag che recupera da Anthropic. In una sessione in cui è impostata una variabile che disattiva il recupero dei flag, come `DISABLE_TELEMETRY`, l'advisor rimane disattivato. Vedere [Funzionalità che richiedono il recupero del feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching).180* **Recupero dei feature flag**: tranne quando usi Claude Platform su AWS, l'advisor richiede un feature flag recuperato da Anthropic. Una sessione con una variabile che disattiva il recupero, come `DISABLE_TELEMETRY`, non ha quel flag. Per verificare la tua sessione, consulta [quali sessioni saltano il recupero o si avviano senza il flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching).

182 181 

183## Disattiva l'advisor182## Disattiva l'advisor

184 183 

220 220 

221> [!NOTE]221> [!NOTE]

222>222>

223> `effort` scambia latenza e costo dei token per profondità di ragionamento all'interno di ogni risposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) è una funzione separata che produce blocchi di `thinking` nell'output, e il campo `display` su `ThinkingConfig` per [Python](https://code.claude.com/docs/it/agent-sdk/python.md#thinkingconfig) o [TypeScript](https://code.claude.com/docs/it/agent-sdk/typescript.md#thinkingconfig) controlla se ricevete il loro testo. Sono indipendenti: potete impostare `effort: "low"` con extended thinking abilitato, o `effort: "max"` senza di esso.223> `effort` scambia latenza e costo dei token per profondità di ragionamento all'interno di ogni risposta. Il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) produce blocchi `thinking` nell'output, e il campo `display` su `ThinkingConfig` per [Python](https://code.claude.com/docs/it/agent-sdk/python.md#thinkingconfig) o [TypeScript](https://code.claude.com/docs/it/agent-sdk/typescript.md#thinkingconfig) controlla se ricevi il loro testo.

224 224 

225Usa uno sforzo inferiore per gli agenti che eseguono attività semplici e ben definite, come elencare file o eseguire un singolo grep, per ridurre il costo e la latenza. Imposta `effort` nelle opzioni di livello superiore `query()` per la [sessione](https://code.claude.com/docs/it/sub-agents.md#choose-an-effort-level), o per singolo subagent con il campo `effort` su [`AgentDefinition`](https://code.claude.com/docs/it/agent-sdk/subagents#agentdefinition-configuration) per sovrascrivere il livello della sessione.225Usa uno sforzo inferiore per gli agenti che eseguono attività semplici e ben definite, come elencare file o eseguire un singolo grep, per ridurre il costo e la latenza. Imposta `effort` nelle opzioni di livello superiore `query()` per la [sessione](https://code.claude.com/docs/it/sub-agents.md#choose-an-effort-level), o per singolo subagent con il campo `effort` su [`AgentDefinition`](https://code.claude.com/docs/it/agent-sdk/subagents#agentdefinition-configuration) per sovrascrivere il livello della sessione.

226 226 

224Dopo aver allegato l'identità dell'utente finale, questi eventi diventano un audit trail per utente che puoi inoltrare a una piattaforma Security Information and Event Management (SIEM):224Dopo aver allegato l'identità dell'utente finale, questi eventi diventano un audit trail per utente che puoi inoltrare a una piattaforma Security Information and Event Management (SIEM):

225 225 

226* `tool_decision` e `tool_result`: ogni chiamata a uno strumento, se è stata consentita o negata, e il suo risultato226* `tool_decision` e `tool_result`: ogni chiamata a uno strumento, se è stata consentita o negata, e il suo risultato

227* `safety_event`: quale controllo ha rifiutato una chiamata a uno strumento o ha richiesto per essa una richiesta di permesso, come una regola di permesso o il classificatore della modalità auto. Alcune chiamate [non hanno un evento di sicurezza](https://code.claude.com/docs/it/monitoring-usage.md#calls-without-a-safety-event). Richiede Claude Code v2.1.307 o successivo

228* `mcp_server_connection`: connessioni ai server MCP e connessioni non riuscite227* `mcp_server_connection`: connessioni ai server MCP e connessioni non riuscite

229* `permission_mode_changed`: modifiche della modalità di permesso228* `permission_mode_changed`: modifiche della modalità di permesso

230 229 

231Questi eventi vengono esportati come record di log denominati con un prefisso `claude_code.`, come `claude_code.safety_event`. Consulta [Audit security events](https://code.claude.com/docs/it/monitoring-usage.md#audit-security-events) nel riferimento Monitoring per l'elenco completo degli eventi rilevanti per la sicurezza e gli attributi che ognuno porta.230Questi eventi vengono esportati come record di log denominati con un prefisso `claude_code.`, come `claude_code.tool_decision`. Consulta [Audit security events](https://code.claude.com/docs/it/monitoring-usage.md#audit-security-events) nel riferimento Monitoring per l'elenco completo degli eventi rilevanti per la sicurezza e gli attributi che ognuno porta.

232 231 

233## Controlla i dati sensibili nelle esportazioni232## Controlla i dati sensibili nelle esportazioni

234 233 

237| Variabile | Aggiunge |236| Variabile | Aggiunge |

238| - | - |237| - | - |

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

240| `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](https://code.claude.com/docs/it/monitoring-usage.md#cost-counter). La regola integrata indicata dal classificatore della modalità auto quando ha bloccato una chiamata, come [`classifier_category`](https://code.claude.com/docs/it/monitoring-usage#tool-decision-event) sugli eventi `claude_code.tool_decision` e `claude_code.safety_event` |239| `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](https://code.claude.com/docs/it/monitoring-usage.md#cost-counter). La regola integrata indicata dal classificatore della modalità auto quando ha bloccato una chiamata, come [`classifier_category`](https://code.claude.com/docs/it/monitoring-usage#tool-decision-event) sugli eventi `claude_code.tool_decision` |

241| `OTEL_LOG_TOOL_CONTENT=1` | Un evento span [`tool.output`](https://code.claude.com/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](https://code.claude.com/docs/it/monitoring-usage.md#new-context-gates) |240| `OTEL_LOG_TOOL_CONTENT=1` | Un evento span [`tool.output`](https://code.claude.com/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](https://code.claude.com/docs/it/monitoring-usage.md#new-context-gates) |

242| `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 |241| `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 |

243 242 

1383| :- | :- | :- |1383| :- | :- | :- |

1384| `adaptive` | `type`, `display` | Claude decide in modo adattivo quando ragionare |1384| `adaptive` | `type`, `display` | Claude decide in modo adattivo quando ragionare |

1385| `enabled` | `type`, `budget_tokens`, `display` | Abilita il ragionamento con un budget di token specifico |1385| `enabled` | `type`, `budget_tokens`, `display` | Abilita il ragionamento con un budget di token specifico |

1386| `disabled` | `type` | Disabilita il ragionamento |1386| `disabled` | `type` | Disattiva il ragionamento [dove il modello e il provider lo consentono](https://code.claude.com/docs/it/model-config.md#where-you-cant-turn-thinking-off) |

1387 1387 

1388Il campo opzionale `display` controlla se il testo del ragionamento viene restituito `"summarized"` o `"omitted"`. Su Claude Opus 4.7 e versioni successive, l'impostazione predefinita dell'API è `"omitted"`, quindi imposta `"summarized"` per ricevere il contenuto del ragionamento negli output [`ThinkingBlock`](#thinkingblock). Su provider come Amazon Bedrock e l'Agent Platform di Google Cloud, Claude Code non passa `display` per i modelli precedenti che riconosce. Si tratta di Opus 4.6, Sonnet 4.6, Haiku 4.5 e dei modelli precedenti, che usano il loro valore predefinito.1388Il campo opzionale `display` controlla se il testo del ragionamento viene restituito `"summarized"` o `"omitted"`. Su Claude Opus 4.7 e versioni successive, l'impostazione predefinita dell'API è `"omitted"`, quindi imposta `"summarized"` per ricevere il contenuto del ragionamento negli output [`ThinkingBlock`](#thinkingblock). Su provider come Amazon Bedrock e l'Agent Platform di Google Cloud, Claude Code non passa `display` per i modelli precedenti che riconosce. Si tratta di Opus 4.6, Sonnet 4.6, Haiku 4.5 e dei modelli precedenti, che usano il loro valore predefinito.

1389 1389 

664| `rewindFiles(userMessageId, options?)` | Ripristina i file allo stato in cui si trovavano al messaggio dell'utente specificato. Passa `{ dryRun: true }` per visualizzare in anteprima le modifiche. Richiede `enableFileCheckpointing: true`. Consulta [Checkpointing dei file](https://code.claude.com/docs/it/agent-sdk/file-checkpointing.md) |664| `rewindFiles(userMessageId, options?)` | Ripristina i file allo stato in cui si trovavano al messaggio dell'utente specificato. Passa `{ dryRun: true }` per visualizzare in anteprima le modifiche. Richiede `enableFileCheckpointing: true`. Consulta [Checkpointing dei file](https://code.claude.com/docs/it/agent-sdk/file-checkpointing.md) |

665| `setPermissionMode()` | Cambia la modalità di permesso (disponibile solo in modalità di input in streaming) |665| `setPermissionMode()` | Cambia la modalità di permesso (disponibile solo in modalità di input in streaming) |

666| `setModel()` | Cambia il modello (disponibile solo in modalità di input in streaming). Passando `undefined` o la stringa `"default"` si ripristina il [modello predefinito di Claude Code](https://code.claude.com/docs/it/model-config.md). Una sessione in modalità `auto` [passa alla modalità `default`](https://code.claude.com/docs/it/agent-sdk/permissions#auto-mode-auto) se il nuovo modello non supporta la modalità auto |666| `setModel()` | Cambia il modello (disponibile solo in modalità di input in streaming). Passando `undefined` o la stringa `"default"` si ripristina il [modello predefinito di Claude Code](https://code.claude.com/docs/it/model-config.md). Una sessione in modalità `auto` [passa alla modalità `default`](https://code.claude.com/docs/it/agent-sdk/permissions#auto-mode-auto) se il nuovo modello non supporta la modalità auto |

667| `setMaxThinkingTokens()` | *Deprecato:* usa invece l'opzione `thinking`. Cambia il numero massimo di token di ragionamento. Passando `null` si ripristina il ragionamento al valore predefinito della sessione: un override impostato a metà sessione viene cancellato e il ragionamento resta disattivato per le sessioni in cui è disabilitato |667| `setMaxThinkingTokens()` | *Deprecato:* usa invece l'opzione `thinking`. Cambia il numero massimo di token di ragionamento. Passa `null` per annullare le chiamate precedenti e ripristinare l'opzione `thinking` o `maxThinkingTokens` con cui è stata avviata la sessione |

668| `applyFlagSettings(settings)` | Esegue il merge delle impostazioni nel livello di impostazioni dei flag della sessione in fase di esecuzione (disponibile solo in modalità di input in streaming). Consulta [`applyFlagSettings()`](#applyflagsettings) |668| `applyFlagSettings(settings)` | Esegue il merge delle impostazioni nel livello di impostazioni dei flag della sessione in fase di esecuzione (disponibile solo in modalità di input in streaming). Consulta [`applyFlagSettings()`](#applyflagsettings) |

669| `updateSettings(source, settings)` | Scrive una chiave consentita nel file di impostazioni locali del progetto o nel tuo file di impostazioni utente, in modo che il valore persista per le sessioni successive. Consulta [`updateSettings()`](#updatesettings). Richiede TypeScript SDK v0.3.257 o successiva, che include Claude Code v2.1.257 |669| `updateSettings(source, settings)` | Scrive una chiave consentita nel file di impostazioni locali del progetto o nel tuo file di impostazioni utente, in modo che il valore persista per le sessioni successive. Consulta [`updateSettings()`](#updatesettings). Richiede TypeScript SDK v0.3.257 o successiva, che include Claude Code v2.1.257 |

670| `initializationResult()` | Restituisce il risultato completo dell'inizializzazione, inclusi i comandi supportati, i modelli, le informazioni sull'account e la configurazione dello stile di output |670| `initializationResult()` | Restituisce il risultato completo dell'inizializzazione, inclusi i comandi supportati, i modelli, le informazioni sull'account e la configurazione dello stile di output |

5432type ThinkingConfig =5432type ThinkingConfig =

5433 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)5433 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5434 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget5434 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5435 | { type: "disabled" }; // No extended thinking5435 | { type: "disabled" }; // Turn thinking off where the model and provider allow it

5436```5436```

5437 5437 

5438Per `disabled`, consulta [dove non puoi disattivare il ragionamento](https://code.claude.com/docs/it/model-config.md#where-you-cant-turn-thinking-off).

5439 

5438Il campo facoltativo `display` controlla se il testo di ragionamento viene restituito `"summarized"` o `"omitted"`. Su Claude Opus 4.7 e versioni successive, il valore predefinito dell'API è `"omitted"`, quindi imposta `"summarized"` per ricevere il contenuto del ragionamento nei blocchi `thinking`. Su provider come Amazon Bedrock e Agent Platform di Google Cloud, Claude Code non passa `display` per i modelli precedenti che riconosce. Si tratta di Opus 4.6, Sonnet 4.6, Haiku 4.5 e dei modelli precedenti, che usano il proprio valore predefinito.5440Il campo facoltativo `display` controlla se il testo di ragionamento viene restituito `"summarized"` o `"omitted"`. Su Claude Opus 4.7 e versioni successive, il valore predefinito dell'API è `"omitted"`, quindi imposta `"summarized"` per ricevere il contenuto del ragionamento nei blocchi `thinking`. Su provider come Amazon Bedrock e Agent Platform di Google Cloud, Claude Code non passa `display` per i modelli precedenti che riconosce. Si tratta di Opus 4.6, Sonnet 4.6, Haiku 4.5 e dei modelli precedenti, che usano il proprio valore predefinito.

5439 5441 

5440### `SpawnedProcess`5442### `SpawnedProcess`

169 169 

170Quando l'elenco è [raggruppato per directory](#organize-the-list), il riassunto inizia con lo stato della sessione come parola colorata, ad esempio `Needs input · double jump or wall climb?`. Nel raggruppamento predefinito per stato, l'intestazione del gruppo indica già lo stato, quindi la riga mostra solo il riassunto.170Quando l'elenco è [raggruppato per directory](#organize-the-list), il riassunto inizia con lo stato della sessione come parola colorata, ad esempio `Needs input · double jump or wall climb?`. Nel raggruppamento predefinito per stato, l'intestazione del gruppo indica già lo stato, quindi la riga mostra solo il riassunto.

171 171 

172Il riassunto di fine turno e ogni riscrittura a metà turno sono una breve richiesta di classe Haiku attraverso il tuo provider abituale, fatturata e gestita secondo gli stessi [termini di utilizzo dei dati](https://code.claude.com/docs/it/data-usage.md) della sessione stessa. Gli aggiornamenti ogni 15 secondi tra una riscrittura del modello e l'altra riutilizzano l'output della sessione stessa e non inviano richieste. Su un provider di terze parti o un gateway senza un modello di classe Haiku configurato, la richiesta usa invece il modello principale della sessione; imposta [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/it/model-config#environment-variables) per sceglierne uno.172#### Costo dei riassunti delle righe

173 

174Il riassunto di fine turno e ogni riscrittura a metà turno sono una breve richiesta attraverso il tuo provider abituale, fatturata e gestita secondo gli stessi [termini di utilizzo dei dati](https://code.claude.com/docs/it/data-usage.md) della sessione stessa. Su un provider di terze parti o un gateway, i riassunti usano il modello che imposti in [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/it/model-config#environment-variables). Se non è impostato, usano il modello del tuo provider per le attività in background: consulta [Amazon Bedrock](https://code.claude.com/docs/it/amazon-bedrock.md#4-pin-model-versions), [Agent Platform di Google Cloud](https://code.claude.com/docs/it/google-vertex-ai.md#5-pin-model-versions), [Microsoft Foundry](https://code.claude.com/docs/it/microsoft-foundry.md#4-pin-model-versions) o il tuo [gateway](https://code.claude.com/docs/it/llm-gateway-protocol.md#requests-and-defaults-by-connection-method).

173 175 

174### Stato della pull request176### Stato della pull request

175 177 

128 128 

129### Strumenti del browser in plan mode129### Strumenti del browser in plan mode

130 130 

131In [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode), appare una richiesta di permesso prima che Claude registri una GIF, apra una nuova scheda o esegua una scorciatoia. In una sessione interattiva della CLI, se la [modalità bypass permissions è disponibile](https://code.claude.com/docs/it/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) e il [recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching) è disattivato, queste chiamate vengono eseguite senza richiesta.131In [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode), appare una richiesta di permesso prima che Claude registri una GIF o apra una nuova scheda. In una sessione interattiva della CLI, se la [modalità bypass permissions è disponibile](https://code.claude.com/docs/it/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) e il [recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching) è disattivato, queste chiamate vengono eseguite senza richiesta.

132 132 

133Anche una chiamata `tabs_context_mcp` chiede conferma quando imposta `createIfEmpty`, così come una chiamata `browser_batch` che include una qualsiasi di queste azioni.133Anche una chiamata `tabs_context_mcp` chiede conferma quando imposta `createIfEmpty`, così come una chiamata `browser_batch` che include una qualsiasi di queste azioni.

134 134 

313>313>

314> `gatewayInternalNetworks` è pensato per le reti interne che risultano numerate a partire da uno spazio di indirizzi pubblico. Non rende sicuro esporre un gateway su internet: un gateway attendibile può distribuire impostazioni che eseguono comandi sulle macchine degli sviluppatori.314> `gatewayInternalNetworks` è pensato per le reti interne che risultano numerate a partire da uno spazio di indirizzi pubblico. Non rende sicuro esporre un gateway su internet: un gateway attendibile può distribuire impostazioni che eseguono comandi sulle macchine degli sviluppatori.

315>315>

316> Mantieni il gateway irraggiungibile dall'esterno della tua rete con le regole del firewall o del load balancer. Imposta [`access_control.allow_cidrs`](https://code.claude.com/docs/it/claude-apps-gateway-config#http-tuning) del gateway sugli stessi blocchi che dichiari qui, in modo che il gateway stesso rifiuti i client provenienti da qualsiasi altro luogo. Dietro un load balancer o un ingress, imposta anche `listen.trusted_proxies` su quel front end, perché altrimenti il gateway confronta `allow_cidrs` con l'indirizzo del front end anziché con quello dello sviluppatore.316> Mantieni il gateway irraggiungibile dall'esterno della tua rete con le regole del firewall o del load balancer. Imposta [`access_control.allow_cidrs`](https://code.claude.com/docs/it/claude-apps-gateway-config#http-tuning) del gateway sugli stessi blocchi che dichiari qui. Se un load balancer o un ingress [va incluso in `listen.trusted_proxies`](https://code.claude.com/docs/it/claude-apps-gateway-config#listen), elencalo anche lì, perché altrimenti il gateway confronta `allow_cidrs` con l'indirizzo del front end anziché con quello dello sviluppatore.

317 317 

318Aggiungi la chiave alla stessa origine di impostazioni gestite delle chiavi di accesso: il file di impostazioni gestite, il profilo MDM o la policy del registro. Claude Code la ignora nelle impostazioni utente, di progetto e gestite dal server.318Aggiungi la chiave alla stessa origine di impostazioni gestite delle chiavi di accesso: il file di impostazioni gestite, il profilo MDM o la policy del registro. Claude Code la ignora nelle impostazioni utente, di progetto e gestite dal server.

319 319 

59| `port` | No | Porta di binding. Predefinito `8080`. |59| `port` | No | Porta di binding. Predefinito `8080`. |

60| `public_url` | A meno che `host` non sia loopback | L'origine `https://` visibile esternamente, utilizzata per costruire il `redirect_uri` dell'IdP e i metadati di scoperta. Obbligatorio ogni volta che `host` non è un indirizzo loopback, sia che TLS termini a un proxy come un ALB, Ingress o Cloud Run o al gateway stesso tramite `tls`, perché il gateway non deriva mai la sua stessa origine dagli header `X-Forwarded-*`; sono falsificabili dal client. L'avvio fallisce senza di esso. `trusted_proxies` di seguito governa solo la risoluzione dell'IP del client. Obbligatorio anche per abilitare la [telemetria](#telemetry), perché il gateway costruisce l'endpoint OTLP che spinge ai client da questo URL. |60| `public_url` | A meno che `host` non sia loopback | L'origine `https://` visibile esternamente, utilizzata per costruire il `redirect_uri` dell'IdP e i metadati di scoperta. Obbligatorio ogni volta che `host` non è un indirizzo loopback, sia che TLS termini a un proxy come un ALB, Ingress o Cloud Run o al gateway stesso tramite `tls`, perché il gateway non deriva mai la sua stessa origine dagli header `X-Forwarded-*`; sono falsificabili dal client. L'avvio fallisce senza di esso. `trusted_proxies` di seguito governa solo la risoluzione dell'IP del client. Obbligatorio anche per abilitare la [telemetria](#telemetry), perché il gateway costruisce l'endpoint OTLP che spinge ai client da questo URL. |

61| `tls.cert` / `tls.key` | No | Percorsi PEM se il gateway termina TLS stesso |61| `tls.cert` / `tls.key` | No | Percorsi PEM se il gateway termina TLS stesso |

62| `trusted_proxies` | No | CIDR o IP dei load balancer davanti al gateway. Quando impostato, il gateway si fida di `X-Forwarded-For` solo da questi peer e registra l'IP client reale per il rate limiting per IP e l'audit. Equivalente a nginx `set_real_ip_from`. Le voci `X-Forwarded-For` scritte come `ipv4:port` o `[ipv6]:port`, come fanno alcuni load balancer, vengono lette con la porta eliminata. Un indirizzo IPv6 con una porta aggiunta e senza parentesi può essere letto come un indirizzo diverso o non letto affatto, quindi disattiva l'opzione della porta su qualsiasi proxy che scrive quella forma. |62| `trusted_proxies` | No | CIDR o IP dei frontend da considerare attendibili. Se impostato, il gateway considera attendibile `X-Forwarded-For` solo da questi peer e registra il vero IP del client per il rate limit per IP e per l'audit. |

63 

64Elenca un frontend in `trusted_proxies` solo se l'ultima voce `X-Forwarded-For` che inoltra è una voce che nessuno sviluppatore ha scritto. Non elencare alcun indirizzo o intervallo da cui si connettono gli sviluppatori. Un frontend che aggiunge l'indirizzo di ogni connessione che riceve è idoneo. Uno che inoltra l'intestazione così come la inviano gli sviluppatori non lo è.

65 

66Le voci `X-Forwarded-For` scritte come `ipv4:port` o `[ipv6]:port`, come fanno alcuni load balancer, vengono lette scartando la porta. Un indirizzo IPv6 con una porta aggiunta e senza parentesi quadre può essere letto come un indirizzo diverso o non essere letto affatto. Disattiva l'opzione della porta su qualsiasi proxy che scriva in quella forma.

63 67 

64### `oidc`68### `oidc`

65 69 

1659 1663 

1660Entrambi i segnali usano l'indirizzo del client così come il gateway lo risolve. Se un load balancer, un port-forward o un tunnel inoltra il traffico e non è elencato in `listen.trusted_proxies`, il gateway vede l'indirizzo dell'intermediario, che di solito è privato, quindi né l'avviso in fase di esecuzione né un'allowlist privata intercettano il traffico inoltrato attraverso di esso.1664Entrambi i segnali usano l'indirizzo del client così come il gateway lo risolve. Se un load balancer, un port-forward o un tunnel inoltra il traffico e non è elencato in `listen.trusted_proxies`, il gateway vede l'indirizzo dell'intermediario, che di solito è privato, quindi né l'avviso in fase di esecuzione né un'allowlist privata intercettano il traffico inoltrato attraverso di esso.

1661 1665 

1662Dietro un front end di questo tipo, imposta prima [`listen.trusted_proxies`](#listen) in modo che il gateway veda gli indirizzi reali dei client, e in ogni caso mantieni il gateway e tutto ciò che si trova davanti a esso irraggiungibili dalla rete internet pubblica.1666Se l'inoltro [appartiene a `listen.trusted_proxies`](#listen), elencalo lì. In ogni caso, mantieni il gateway e tutto ciò che si trova davanti a esso irraggiungibili dalla rete Internet pubblica.

1663 1667 

1664### `load_test_mode`1668### `load_test_mode`

1665 1669 

131 131 

132L'accesso è limitato per indirizzo IP client, e i valori predefiniti si adattano a un piccolo team. Ogni indirizzo ottiene 30 avvii di accesso e 10 invii di codice ogni 10 minuti. Un rollout a migliaia di sviluppatori può raggiungere questi limiti la prima mattina, per uno di due motivi:132L'accesso è limitato per indirizzo IP client, e i valori predefiniti si adattano a un piccolo team. Ogni indirizzo ottiene 30 avvii di accesso e 10 invii di codice ogni 10 minuti. Un rollout a migliaia di sviluppatori può raggiungere questi limiti la prima mattina, per uno di due motivi:

133 133 

134* **Il gateway non può vedere oltre il tuo load balancer.** Senza [`listen.trusted_proxies`](https://code.claude.com/docs/it/claude-apps-gateway-config#listen), ogni sviluppatore sembra provenire dall'indirizzo del load balancer e condivide un limite. Impostalo prima di qualsiasi altra cosa. Il gateway registra un avviso la prima volta che ignora un'intestazione `X-Forwarded-For`.134* **Il gateway non può vedere oltre il tuo load balancer.** Senza [`listen.trusted_proxies`](https://code.claude.com/docs/it/claude-apps-gateway-config#listen), ogni sviluppatore sembra provenire dall'indirizzo del load balancer e condivide un unico limite. Il gateway registra un avviso la prima volta che ignora un'intestazione `X-Forwarded-For`. Se il load balancer [va incluso in `listen.trusted_proxies`](https://code.claude.com/docs/it/claude-apps-gateway-config#listen), elencalo prima di modificare qualsiasi altra cosa. Se gli sviluppatori condividono ancora un unico indirizzo, aumenta [`rate_limits`](https://code.claude.com/docs/it/claude-apps-gateway-config#http-tuning).

135* **Molti sviluppatori condividono pochi indirizzi di uscita NAT o VPN.** Condividono i limiti di quegli indirizzi anche quando `trusted_proxies` è corretto. Aumenta [`rate_limits`](https://code.claude.com/docs/it/claude-apps-gateway-config#http-tuning) per adattarsi.135* **Molti sviluppatori condividono pochi indirizzi di uscita NAT o VPN.** Condividono i limiti di quegli indirizzi anche quando `trusted_proxies` è corretto. Aumenta [`rate_limits`](https://code.claude.com/docs/it/claude-apps-gateway-config#http-tuning) per adattarsi.

136 136 

137Per dimensionare `max`, dividi gli sviluppatori per gli indirizzi di uscita che condividono. Stima quanti di loro accedono entro un periodo `window_seconds`, che è 10 minuti per impostazione predefinita. Quindi raddoppialo per coprire i tentativi e gli sviluppatori che accedono sia a Claude Code che a Claude Desktop.137Per dimensionare `max`, dividi gli sviluppatori per gli indirizzi di uscita che condividono. Stima quanti di loro accedono entro un periodo `window_seconds`, che è 10 minuti per impostazione predefinita. Quindi raddoppialo per coprire i tentativi e gli sviluppatori che accedono sia a Claude Code che a Claude Desktop.

418| 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 |418| 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 |

419| 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`](https://code.claude.com/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](https://code.claude.com/docs/it/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in). |419| 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`](https://code.claude.com/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](https://code.claude.com/docs/it/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in). |

420| 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`](https://code.claude.com/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 |420| 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`](https://code.claude.com/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 |

421| 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 rate limit 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). |421| 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 rate limit 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`. | Se il bilanciatore di carico [va incluso in `listen.trusted_proxies`](https://code.claude.com/docs/it/claude-apps-gateway-config#listen), inseriscilo lì come prima cosa. Poi aumenta `rate_limits` se gli sviluppatori condividono ancora indirizzi. Vedi [Large rollouts](#large-rollouts). |

422| 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](https://code.claude.com/docs/it/claude-apps-gateway#prerequisites). Se l'indirizzo è spazio pubblico che la tua organizzazione possiede e utilizza internamente, [dichiara quel blocco](https://code.claude.com/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) invece. |422| 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](https://code.claude.com/docs/it/claude-apps-gateway#prerequisites). Se l'indirizzo è spazio pubblico che la tua organizzazione possiede e utilizza internamente, [dichiara quel blocco](https://code.claude.com/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) invece. |

423| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | Un `HTTPS_PROXY` o `HTTP_PROXY` si applica all'host del gateway e il nome host del proxy si risolve in un indirizzo pubblico. Un proxy il cui host si risolve solo in indirizzi privati è consentito e non attiva questo errore | Aggiungi l'host del gateway a `NO_PROXY` sulla macchina dello sviluppatore in modo che la connessione sia diretta, oppure utilizza un proxy il cui nome host si risolve in indirizzi privati. Il messaggio nomina la voce esatta `NO_PROXY` da aggiungere |423| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | Un `HTTPS_PROXY` o `HTTP_PROXY` si applica all'host del gateway e il nome host del proxy si risolve in un indirizzo pubblico. Un proxy il cui host si risolve solo in indirizzi privati è consentito e non attiva questo errore | Aggiungi l'host del gateway a `NO_PROXY` sulla macchina dello sviluppatore in modo che la connessione sia diretta, oppure utilizza un proxy il cui nome host si risolve in indirizzi privati. Il messaggio nomina la voce esatta `NO_PROXY` da aggiungere |

424| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Il gateway è su un blocco dichiarato in [`gatewayInternalNetworks`](https://code.claude.com/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e la macchina dello sviluppatore l'ha raggiunto da un indirizzo al di fuori di quel blocco: un pool di indirizzi VPN, un segmento NAT di container o WSL2, oppure una rete che non è la tua | Chiedi allo sviluppatore di eseguire `/login` dal sistema operativo host sulla tua rete. Se l'indirizzo mostrato è anche lo spazio pubblico della tua organizzazione, sostituisci la voce del gateway con un blocco che copra entrambi, fino a `/8`; una seconda voce sovrapposta è rifiutata. Se nessun blocco copre entrambi, vedi [Scegliere un indirizzo per il gateway](#choose-an-address-for-the-gateway) |424| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Il gateway è su un blocco dichiarato in [`gatewayInternalNetworks`](https://code.claude.com/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e la macchina dello sviluppatore l'ha raggiunto da un indirizzo al di fuori di quel blocco: un pool di indirizzi VPN, un segmento NAT di container o WSL2, oppure una rete che non è la tua | Chiedi allo sviluppatore di eseguire `/login` dal sistema operativo host sulla tua rete. Se l'indirizzo mostrato è anche lo spazio pubblico della tua organizzazione, sostituisci la voce del gateway con un blocco che copra entrambi, fino a `/8`; una seconda voce sovrapposta è rifiutata. Se nessun blocco copre entrambi, vedi [Scegliere un indirizzo per il gateway](#choose-an-address-for-the-gateway) |

36 36 

37Ogni sessione cloud viene eseguita in un [ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md), la configurazione salvata che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione.37Ogni sessione cloud viene eseguita in un [ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md), la configurazione salvata che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione.

38 38 

39* **Il tuo primo ambiente**: se non hai ancora un ambiente, l'onboarding configura un ambiente **Default** con [accesso alla rete **Trusted**](https://code.claude.com/docs/it/cloud-environments.md#access-levels), creandolo per te o chiedendoti di crearlo. Vedi [L'ambiente Default](https://code.claude.com/docs/it/cloud-environments.md#the-default-environment) per sapere quale di questi accade sul tuo piano39* **Il tuo primo ambiente**: se non ne hai ancora uno, l'onboarding configura un ambiente **Default** con [accesso alla rete **Limited**](https://code.claude.com/docs/it/cloud-environments.md#access-levels). Vedi [L'ambiente Default](https://code.claude.com/docs/it/cloud-environments.md#the-default-environment) per sapere come funziona sul tuo piano

40* **Quale ambiente utilizza una sessione**: vedi [L'ambiente Default](https://code.claude.com/docs/it/cloud-environments.md#the-default-environment) per sapere come le sessioni scelgono un ambiente quando ne hai più di uno40* **Quale ambiente utilizza una sessione**: vedi [L'ambiente Default](https://code.claude.com/docs/it/cloud-environments.md#the-default-environment) per sapere come le sessioni scelgono un ambiente quando ne hai più di uno

41* **Modificare cosa le sessioni possono raggiungere o eseguire all'avvio**: vedi [Configura ambienti cloud](https://code.claude.com/docs/it/cloud-environments.md)41* **Modificare cosa le sessioni possono raggiungere o eseguire all'avvio**: vedi [Configura ambienti cloud](https://code.claude.com/docs/it/cloud-environments.md)

42* **Cosa è installato senza alcuna configurazione**: vedi [Strumenti installati](https://code.claude.com/docs/it/cloud-environments.md#installed-tools)42* **Cosa è installato senza alcuna configurazione**: vedi [Strumenti installati](https://code.claude.com/docs/it/cloud-environments.md#installed-tools)

146* **Memoria automatica**: la pulizia automatica non elimina i file di memoria nella directory della [memoria automatica](https://code.claude.com/docs/it/memory.md#auto-memory) di un progetto, `projects/<project>/memory/`. Claude Code rimuove quella directory solo se è rimasta vuota per l'intero periodo di conservazione. Prima della v2.1.228, la pulizia automatica trattava le cartelle all'interno della directory della memoria come dati di sessione e poteva eliminare i file vecchi al loro interno.146* **Memoria automatica**: la pulizia automatica non elimina i file di memoria nella directory della [memoria automatica](https://code.claude.com/docs/it/memory.md#auto-memory) di un progetto, `projects/<project>/memory/`. Claude Code rimuove quella directory solo se è rimasta vuota per l'intero periodo di conservazione. Prima della v2.1.228, la pulizia automatica trattava le cartelle all'interno della directory della memoria come dati di sessione e poteva eliminare i file vecchi al loro interno.

147* **Trascrizioni di Claude Desktop e Cowork**: Claude Code conserva la trascrizione di una sessione che hai avviato o proseguito più di recente in Claude Desktop o Cowork, a prescindere dalla sua età. Per dare a queste trascrizioni un limite di età, imposta [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/it/settings-reference#desktopsessioncleanupperioddays). Richiede Claude Code v2.1.248 o successivo; le versioni precedenti le eliminano dopo `cleanupPeriodDays`.147* **Trascrizioni di Claude Desktop e Cowork**: Claude Code conserva la trascrizione di una sessione che hai avviato o proseguito più di recente in Claude Desktop o Cowork, a prescindere dalla sua età. Per dare a queste trascrizioni un limite di età, imposta [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/it/settings-reference#desktopsessioncleanupperioddays). Richiede Claude Code v2.1.248 o successivo; le versioni precedenti le eliminano dopo `cleanupPeriodDays`.

148 148 

149 Claude Code elimina invece queste trascrizioni dopo `cleanupPeriodDays` in uno qualsiasi di questi casi:149 Claude Code elimina invece queste trascrizioni dopo `cleanupPeriodDays` in casi come questi:

150 150 

151 * Le [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) impostano `cleanupPeriodDays`151 * Le [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) impostano `cleanupPeriodDays`

152 * La [configurazione HIPAA si applica alle tue sessioni](https://code.claude.com/docs/it/hipaa-setup.md#check-how-developers-sign-in-and-connect)152 * La [configurazione HIPAA si applica alle tue sessioni](https://code.claude.com/docs/it/hipaa-setup.md#check-how-developers-sign-in-and-connect)

170* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, oppure la stessa struttura in `$TMPDIR` quando il tuo sistema ne imposta uno170* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, oppure la stessa struttura in `$TMPDIR` quando il tuo sistema ne imposta uno

171* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`171* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`

172 172 

173`<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`](https://code.claude.com/docs/it/env-vars), l'albero viene invece spostato in quella directory. Gli hook ricevono il percorso della sessione corrente come [`scratchpad_dir`](https://code.claude.com/docs/it/hooks#common-input-fields).173`<project>` è il percorso della tua directory di lavoro con ogni carattere diverso da lettere e cifre sostituito da `-`, ad esempio `-Users-you-my-project`. Su Windows, `<project>` è un hash di 16 caratteri di quella stringa, ad esempio `73295dabccd14c56`. In una sessione dell'app Desktop, può essere la stringa stessa. Per ottenere il percorso esatto, chiedi a Claude. Se imposti [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/it/env-vars), l'albero viene invece spostato in quella directory. Gli hook ricevono il percorso della sessione corrente come [`scratchpad_dir`](https://code.claude.com/docs/it/hooks#common-input-fields).

174 174 

175I file dello scratchpad durano quanto la trascrizione della sessione: la [pulizia automatica di conservazione](#cleaned-up-automatically) elimina la directory quando elimina la trascrizione, e [`claude purge`](#clear-local-data) non tocca la directory temporanea. Poiché la directory si trova nel percorso temporaneo del sistema, anche il sistema operativo può svuotarla, ad esempio al riavvio. Per conservare qualcosa che Claude ha scritto lì, chiedi a Claude di spostarlo nel tuo progetto.175I file dello scratchpad durano quanto la trascrizione della sessione: la [pulizia automatica di conservazione](#cleaned-up-automatically) elimina la directory quando elimina la trascrizione, e [`claude purge`](#clear-local-data) non tocca la directory temporanea. Poiché la directory si trova nel percorso temporaneo del sistema, anche il sistema operativo può svuotarla, ad esempio al riavvio. Per conservare qualcosa che Claude ha scritto lì, chiedi a Claude di spostarlo nel tuo progetto.

176 176 

6 6 

7> Configura Claude Code per utilizzare l'API Claude gestita da Anthropic con autenticazione AWS, controllo dell'accesso IAM e fatturazione tramite AWS Marketplace.7> Configura Claude Code per utilizzare l'API Claude gestita da Anthropic con autenticazione AWS, controllo dell'accesso IAM e fatturazione tramite AWS Marketplace.

8 8 

9Claude Platform on AWS è l'API Claude gestita da Anthropic con autenticazione AWS, controllo dell'accesso IAM e fatturazione tramite AWS Marketplace. Le richieste raggiungono direttamente l'API di Anthropic, quindi si ottengono gli stessi modelli e funzionalità dell'[API Claude](https://platform.claude.com/docs) con la stessa pianificazione dei rilasci. Le funzionalità lato client che Claude Code attiva tramite il servizio di feature flag di Anthropic sono disattivate per impostazione predefinita, e lo [strumento advisor](https://code.claude.com/docs/it/advisor.md) non è disponibile. Consultare la [matrice di disponibilità delle funzionalità](https://code.claude.com/docs/it/feature-availability.md#summary-by-provider) per l'elenco completo.9Claude Platform on AWS è l'API Claude gestita da Anthropic con autenticazione AWS, controllo dell'accesso IAM e fatturazione tramite AWS Marketplace. Le richieste raggiungono direttamente l'API di Anthropic, quindi ottieni gli stessi modelli e le stesse funzionalità API dell'[API Claude](https://platform.claude.com/docs) con la stessa pianificazione dei rilasci. Ti autentichi con le credenziali AWS o con una chiave API del workspace, e paghi tramite AWS Marketplace.

10 10 

11Utilizzare questa guida per indirizzare Claude Code a un'area di lavoro già fornita tramite Claude Platform on AWS. Per la sottoscrizione AWS e la configurazione dell'area di lavoro che precede questo, consultare la [documentazione di Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).11Usa questa guida per indirizzare Claude Code a un workspace che hai già fornito tramite Claude Platform on AWS. Per l'abbonamento AWS e la configurazione del workspace che precedono questo passaggio, consulta la [documentazione di Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).

12 12 

13> [!NOTE]13> [!NOTE]

14>14>

15> L'iscrizione tramite AWS Marketplace fornisce una nuova organizzazione Anthropic collegata al proprio account AWS. Questa organizzazione è separata da qualsiasi organizzazione già presente con Anthropic e le credenziali non si trasferiscono tra loro. Utilizzare l'ID dell'area di lavoro e le chiavi API dall'organizzazione collegata ad AWS, non da un account Claude Console preesistente.15> L'abbonamento tramite AWS Marketplace fornisce una nuova organizzazione Anthropic collegata al tuo account AWS. Questa organizzazione è separata da qualsiasi organizzazione che hai già con Anthropic, e le credenziali non si trasferiscono tra le due. Usa l'ID del workspace e le chiavi API dell'organizzazione collegata ad AWS, non quelli di un account Claude Console preesistente.

16 

17Alcune funzionalità di Claude Code non sono disponibili o funzionano diversamente su Claude Platform on AWS. Consulta la [matrice di disponibilità delle funzionalità](https://code.claude.com/docs/it/feature-availability.md#summary-by-provider) e le [funzionalità che richiedono il recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching).

16 18 

17## Prerequisiti19## Prerequisiti

18 20 

37 37 

38**Default** non ha alcuna configurazione propria:38**Default** non ha alcuna configurazione propria:

39 39 

40* [Accesso di rete **Trusted**](#access-levels): le sessioni raggiungono i registri dei pacchetti e altri [domini consentiti](#default-allowed-domains), e nient'altro attraverso la rete della sessione.40* [Accesso di rete **Limited**](#access-levels): le sessioni raggiungono i registri dei pacchetti e altri [domini nell'allowlist](#default-allowed-domains).

41* Nessun'altra configurazione: **Default** non definisce variabili di ambiente o script di configurazione, quindi le sessioni iniziano con solo gli [strumenti preinstallati](#installed-tools).41* Nessun'altra configurazione: **Default** non definisce variabili di ambiente o script di configurazione, quindi le sessioni iniziano con solo gli [strumenti preinstallati](#installed-tools).

42 42 

43Con solo **Default** disponibile, ogni sessione viene eseguita in esso. Quando si dispone di più di un ambiente, le sessioni ne scelgono uno per superficie:43Con solo **Default** disponibile, ogni sessione viene eseguita in esso. Quando si dispone di più di un ambiente, le sessioni ne scelgono uno per superficie:

198 198 

199## Accesso di rete199## Accesso di rete

200 200 

201Ogni ambiente imposta un livello di accesso di rete, che controlla le connessioni in uscita che le sue sessioni possono effettuare. Il livello predefinito, **Trusted**, consente i registri dei pacchetti e altri [domini consentiti](#default-allowed-domains); **Custom** accetta il vostro elenco di domini.201Ogni ambiente imposta un livello di accesso di rete, che controlla le connessioni in uscita che le sue sessioni possono effettuare. Un nuovo ambiente parte da **Limited** con **Allow package managers** selezionato, quindi le sue sessioni raggiungono i registri dei pacchetti e altri [domini in allowlist](#default-allowed-domains).

202 202 

203Per modificare l'accesso di rete di un ambiente, [aprilo per la modifica](#configure-your-environment) e utilizza il selettore **Network access** nella finestra di dialogo. Un [ambiente condiviso](#organization-shared-environments) si apre lì in sola lettura, quindi un Owner ne modifica l'accesso di rete dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings). Il controllo che apre il selettore appare sulle superfici dell'app elencate sotto [L'ambiente Default](#the-default-environment) e nell'[editor delle attività pianificate cloud](https://code.claude.com/docs/it/routines.md#environments-and-network-access). Gli ambienti personali non hanno una pagina separata nelle impostazioni del tuo account claude.ai.203Per modificare l'accesso di rete di un ambiente, [aprilo per la modifica](#configure-your-environment) e utilizza il selettore **Network access** nella finestra di dialogo. Un [ambiente condiviso](#organization-shared-environments) si apre lì in sola lettura, quindi un Owner ne modifica l'accesso di rete dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings). Il controllo che apre il selettore appare sulle superfici dell'app elencate sotto [L'ambiente Default](#the-default-environment) e nell'[editor delle attività pianificate cloud](https://code.claude.com/docs/it/routines.md#environments-and-network-access). Gli ambienti personali non hanno una pagina separata nelle impostazioni del tuo account claude.ai.

204 204 

210 210 

211### Livelli di accesso211### Livelli di accesso

212 212 

213Il campo **Network access** nella [finestra di dialogo dell'ambiente](#configure-your-environment) accetta uno di quattro livelli:213Il campo **Network access** nella [finestra di dialogo dell'ambiente](#configure-your-environment) accetta uno di tre livelli:

214 214 

215| Livello | Connessioni in uscita |215| Livello | Connessioni in uscita |

216| :- | :- |216| :- | :- |

217| **None** | Nessun accesso di rete in uscita attraverso la rete della sessione |217| **None** | Nessun accesso di rete in uscita attraverso la rete della sessione |

218| **Trusted** | [Domini consentiti](#default-allowed-domains) solo: registri dei pacchetti, GitHub, cloud SDK |218| **Limited** | L'[allowlist predefinita](#default-allowed-domains) di registri dei pacchetti, GitHub e cloud SDK finché **Allow package managers** è selezionato, più eventuali [domini che elenchi](#allow-specific-domains). Vedi [come appare una richiesta bloccata](https://code.claude.com/docs/it/errors.md#host-not-allowed-in-a-cloud-session). |

219| **Full** | Qualsiasi dominio |219| **Full** | Qualsiasi dominio |

220| **Custom** | Il vostro elenco di consentiti, opzionalmente includendo i default |

221 220 

222Qualunque livello scegliate, le sessioni possono ancora raggiungere questi, perché ognuno prende un percorso che non passa attraverso l'elenco di consentiti di rete della sessione:221Qualunque livello scegliate, le sessioni possono ancora raggiungere questi, perché ognuno prende un percorso che non passa attraverso l'elenco di consentiti di rete della sessione:

223 222 

226* Gli host che hai elencato nei [segreti di rete](#add-network-secrets) dell'ambiente, tranne gli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential)225* Gli host che hai elencato nei [segreti di rete](#add-network-secrets) dell'ambiente, tranne gli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential)

227* L'API Anthropic, per le richieste di Claude Code stesso, anche a **None**, come notato sotto [Sicurezza e isolamento](https://code.claude.com/docs/it/claude-code-on-the-web.md#security-and-isolation)226* L'API Anthropic, per le richieste di Claude Code stesso, anche a **None**, come notato sotto [Sicurezza e isolamento](https://code.claude.com/docs/it/claude-code-on-the-web.md#security-and-isolation)

228 227 

228Un ambiente salvato come **Trusted** o **Custom** continua a raggiungere gli stessi host e si apre in questo modo:

229 

230* **Salvato come Trusted**: si apre come **Limited** con **Allow package managers** selezionato

231* **Salvato come Custom**: si apre come **Limited** con il suo elenco **Allowed domains** e **Allow package managers** come li hai impostati, oppure come **Full** se l'elenco conteneva un `*` da solo

232 

229### Consentire domini specifici233### Consentire domini specifici

230 234 

231Per consentire domini che non sono nella lista Trusted, selezionate **Custom** nelle impostazioni di accesso di rete dell'ambiente, quindi elencate un dominio per riga nel campo **Allowed domains**. Questo esempio consente tre host che un progetto interno potrebbe necessitare.235Per consentire domini che non sono nell'[allowlist predefinita](#default-allowed-domains), seleziona **Limited** nel selettore **Network access** dell'ambiente, quindi elenca un dominio per riga nel campo **Allowed domains**. Un `*.` iniziale corrisponde a ogni sottodominio. Questo esempio consente tre host di cui un progetto interno potrebbe avere bisogno.

232 236 

233```text theme={null}237```text theme={null}

234api.example.com238api.example.com

236registry.example.com240registry.example.com

237```241```

238 242 

239Le sessioni in questo ambiente possono ora raggiungere `api.example.com`, qualsiasi sottodominio di `internal.example.com` e `registry.example.com`, e nessun altro dominio attraverso la rete della sessione. Il [traffico GitHub](#github-proxy), il [traffico dei connettori MCP](#network-access) e le richieste agli host dei [segreti di rete](#add-network-secrets) dell'ambiente, diversi dagli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential), non passano attraverso questa allowlist. Un `*.` iniziale corrisponde a ogni sottodominio. Per mantenere anche i [domini Trusted](#default-allowed-domains), seleziona **Also include default list of common package managers**; lascialo deselezionato per consentire solo ciò che elenchi.243Finché **Allow package managers** è selezionato, le sessioni in questo ambiente raggiungono l'[allowlist predefinita](#default-allowed-domains) oltre ai domini che elenchi. Deseleziona la casella per escludere l'allowlist predefinita. Il [traffico GitHub](#github-proxy), il [traffico dei connettori MCP](#network-access) e le richieste agli host dei [segreti di rete](#add-network-secrets) dell'ambiente, diversi dagli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential), non passano attraverso questa allowlist.

240 244 

241Se la vostra organizzazione utilizza gli [artifact](https://code.claude.com/docs/it/artifacts.md#availability), non avete bisogno di `*.frame.claudeusercontent.com` nell'elenco affinché le sessioni li leggano. Quando l'elenco lascia fuori quell'host, Claude Code legge il contenuto dell'artifact attraverso la connessione della sessione ad Anthropic invece. Mantenete l'host in un elenco di consentiti in due situazioni:245Se la vostra organizzazione utilizza gli [artifact](https://code.claude.com/docs/it/artifacts.md#availability), non avete bisogno di `*.frame.claudeusercontent.com` nell'elenco affinché le sessioni li leggano. Quando l'elenco lascia fuori quell'host, Claude Code legge il contenuto dell'artifact attraverso la connessione della sessione ad Anthropic invece. Mantenete l'host in un elenco di consentiti in due situazioni:

242 246 

243* **Le sessioni in questo ambiente aprono gli artifact pubblici di un'altra organizzazione**: Claude Code li recupera dall'host direttamente, quindi aggiungetelo a questo elenco.247* **Le sessioni in questo ambiente aprono gli artifact pubblici di un'altra organizzazione**: Claude Code li recupera dall'host direttamente, quindi aggiungetelo a questo elenco.

244* **State configurando la CLI locale o un runner self-hosted**: mantenete l'host in quell'elenco di consentiti. Consultate i [requisiti di accesso di rete](https://code.claude.com/docs/it/network-config.md#network-access-requirements) e i [requisiti di rete](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#network-requirements) self-hosted.248* **State configurando la CLI locale o un runner self-hosted**: mantenete l'host in quell'elenco di consentiti. Consultate i [requisiti di accesso di rete](https://code.claude.com/docs/it/network-config.md#network-access-requirements) e i [requisiti di rete](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#network-requirements) self-hosted.

245 249 

246Ogni ambiente ha il suo elenco di domini consentiti; non c'è un elenco di consentiti a livello di organizzazione che gli amministratori possono spingere agli ambienti di ogni membro. Nessuna [impostazione gestita dal server](https://code.claude.com/docs/it/server-managed-settings.md) aggiunge domini all'elenco di consentiti di rete dell'ambiente. Per dare a un team un elenco standard, un Owner può creare un [ambiente condiviso dall'organizzazione](#organization-shared-environments) con accesso di rete **Custom** e quell'elenco.250Ogni ambiente ha il proprio elenco di domini consentiti; non esiste un'allowlist a livello di organizzazione che gli amministratori possano distribuire agli ambienti di ogni membro. Neanche alcuna [impostazione gestita dal server](https://code.claude.com/docs/it/server-managed-settings.md) aggiunge domini all'allowlist di rete di un ambiente. Per dare a un team un unico elenco standard, un Owner può creare un [ambiente condiviso dall'organizzazione](#organization-shared-environments) con accesso di rete **Limited** e quell'elenco.

247 251 

248### Proxy GitHub252### Proxy GitHub

249 253 

255* **Ambito del repository**: il proxy gestisce le richieste API GitHub per i repository collegati alla sessione. Una richiesta API per un altro repository riceve un 403 il cui messaggio inizia con `GitHub access to` e contiene `is not enabled for this session`. Un archivio sorgente che recuperi tramite un URL `github.com/{owner}/{repo}/archive/` o `codeload.github.com` riceve lo stesso 403 quando il repository non è collegato, anche se è pubblico.259* **Ambito del repository**: il proxy gestisce le richieste API GitHub per i repository collegati alla sessione. Una richiesta API per un altro repository riceve un 403 il cui messaggio inizia con `GitHub access to` e contiene `is not enabled for this session`. Un archivio sorgente che recuperi tramite un URL `github.com/{owner}/{repo}/archive/` o `codeload.github.com` riceve lo stesso 403 quando il repository non è collegato, anche se è pubblico.

256* **Restrizioni GraphQL**: il proxy rifiuta le richieste all'endpoint GraphQL di GitHub con un 403 il cui messaggio inizia con `GitHub GraphQL is not available from Claude Code sessions` e indica il fallback REST, `gh api repos/{owner}/{repo}/...`. I sottocomandi di `gh` che usano GraphQL, come `gh pr` e `gh issue`, ricevono lo stesso 403. La restrizione si applica a ogni richiesta attraverso il proxy indipendentemente dalle credenziali che fornisci, quindi anche un `GH_TOKEN` che imposti riceve lo stesso 403. Claude non può raggiungere attraverso il proxy le API GitHub che esistono solo in GraphQL, come Projects v2.260* **Restrizioni GraphQL**: il proxy rifiuta le richieste all'endpoint GraphQL di GitHub con un 403 il cui messaggio inizia con `GitHub GraphQL is not available from Claude Code sessions` e indica il fallback REST, `gh api repos/{owner}/{repo}/...`. I sottocomandi di `gh` che usano GraphQL, come `gh pr` e `gh issue`, ricevono lo stesso 403. La restrizione si applica a ogni richiesta attraverso il proxy indipendentemente dalle credenziali che fornisci, quindi anche un `GH_TOKEN` che imposti riceve lo stesso 403. Claude non può raggiungere attraverso il proxy le API GitHub che esistono solo in GraphQL, come Projects v2.

257 261 

258I file sottoposti a commit dai repository pubblici arrivano tramite `raw.githubusercontent.com`, che il [proxy di sicurezza](#security-proxy) gestisce invece. Quel dominio è nella lista [Trusted](#default-allowed-domains) predefinita, quindi quei file rimangono raggiungibili a meno che il [livello di accesso](#access-levels) dell'ambiente non lo escluda.262I file sottoposti a commit dai repository pubblici arrivano tramite `raw.githubusercontent.com`, che è invece gestito dal [proxy di sicurezza](#security-proxy). Quel dominio è nell'[allowlist predefinita](#default-allowed-domains), quindi quei file restano raggiungibili finché l'[accesso di rete](#access-levels) dell'ambiente consente quell'elenco.

259 263 

260### Proxy di sicurezza264### Proxy di sicurezza

261 265 

391service redis-server start395service redis-server start

392```396```

393 397 

394Docker è disponibile per eseguire servizi containerizzati. Chiedi a Claude di eseguire `docker compose up` per avviare i servizi del tuo progetto. L'accesso di rete per scaricare le immagini segue il [livello di accesso](#access-levels) del tuo ambiente, e i [default Trusted](#default-allowed-domains) includono Docker Hub e altri registri comuni.398Docker è disponibile per eseguire servizi containerizzati. Chiedi a Claude di eseguire `docker compose up` per avviare i servizi del tuo progetto. L'accesso di rete per scaricare le immagini segue il [livello di accesso](#access-levels) del tuo ambiente, e l'[allowlist predefinita](#default-allowed-domains) include Docker Hub e altri registri comuni.

395 399 

396Se le tue immagini sono grandi o lente da scaricare, aggiungi `docker compose pull` o `docker compose build` al tuo [script di configurazione](#setup-scripts). La [cache dell'ambiente](#environment-caching) conserva le immagini scaricate, quindi ogni nuova sessione le ha già su disco. La cache memorizza solo file, non processi in esecuzione, quindi Claude avvia comunque i container in ogni sessione.400Se le tue immagini sono grandi o lente da scaricare, aggiungi `docker compose pull` o `docker compose build` al tuo [script di configurazione](#setup-scripts). La [cache dell'ambiente](#environment-caching) conserva le immagini scaricate, quindi ogni nuova sessione le ha già su disco. La cache memorizza solo file, non processi in esecuzione, quindi Claude avvia comunque i container in ogni sessione.

397 401 

445 449 

446* **Exit zero**: se lo script esce con un codice diverso da zero, la sessione [non si avvia](https://code.claude.com/docs/it/web-quickstart.md#setup-script-failed) oppure si avvia senza ciò che lo script non è riuscito a installare. Aggiungere `|| true` ai comandi non critici in modo che un errore di installazione intermittente non faccia fallire lo script.450* **Exit zero**: se lo script esce con un codice diverso da zero, la sessione [non si avvia](https://code.claude.com/docs/it/web-quickstart.md#setup-script-failed) oppure si avvia senza ciò che lo script non è riuscito a installare. Aggiungere `|| true` ai comandi non critici in modo che un errore di installazione intermittente non faccia fallire lo script.

447* **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](https://code.claude.com/docs/it/web-quickstart.md#new-sessions-hang-or-time-out-during-setup).451* **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](https://code.claude.com/docs/it/web-quickstart.md#new-sessions-hang-or-time-out-during-setup).

448* **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.452* **Accesso di rete per le installazioni**: le installazioni di pacchetti devono raggiungere i registri. Il livello **Limited** predefinito con **Allow package managers** selezionato copre i [registri di pacchetti comuni](#default-allowed-domains) inclusi npm, PyPI, RubyGems e crates.io. Con accesso di rete **None**, le installazioni non riescono.

449* **Le variabili dell'ambiente non sono ancora impostate**: lo script viene eseguito prima che la sessione imposti le [variabili d'ambiente](#set-environment-variables) dell'ambiente. Imposta nello script stesso qualsiasi valore di cui lo script ha bisogno.453* **Le variabili dell'ambiente non sono ancora impostate**: lo script viene eseguito prima che la sessione imposti le [variabili d'ambiente](#set-environment-variables) dell'ambiente. Imposta nello script stesso qualsiasi valore di cui lo script ha bisogno.

450 454 

451### Cache dell'ambiente455### Cache dell'ambiente

541* **Un repository per sessione**: in un ambiente ospitato da Anthropic, una sessione con più repository non carica gli hook dal `.claude/settings.json` di nessun repository, quindi un hook SessionStart che definisci lì non viene eseguito. Installa invece le dipendenze per quelle sessioni con uno [script di configurazione](#setup-scripts). Per un ambiente self-hosted, consulta [quali impostazioni del repository si applicano](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).545* **Un repository per sessione**: in un ambiente ospitato da Anthropic, una sessione con più repository non carica gli hook dal `.claude/settings.json` di nessun repository, quindi un hook SessionStart che definisci lì non viene eseguito. Installa invece le dipendenze per quelle sessioni con uno [script di configurazione](#setup-scripts). Per un ambiente self-hosted, consulta [quali impostazioni del repository si applicano](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).

542* **Non nei thread cloud di un progetto**: un thread cloud in un [progetto](https://code.claude.com/docs/it/claude-projects.md#what-threads-pick-up-from-your-repositories) non esegue gli hook dal `.claude/settings.json` di un repository, qualunque sia il numero di repository. In un ambiente ospitato da Anthropic, installa le dipendenze per i thread con uno [script di configurazione](#setup-scripts). In un ambiente self-hosted, usa invece un hook nelle [impostazioni dell'host del runner](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).546* **Non nei thread cloud di un progetto**: un thread cloud in un [progetto](https://code.claude.com/docs/it/claude-projects.md#what-threads-pick-up-from-your-repositories) non esegue gli hook dal `.claude/settings.json` di un repository, qualunque sia il numero di repository. In un ambiente ospitato da Anthropic, installa le dipendenze per i thread con uno [script di configurazione](#setup-scripts). In un ambiente self-hosted, usa invece un hook nelle [impostazioni dell'host del runner](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).

543* **Nessun ambito solo cloud**: gli hook vengono eseguiti sia nelle sessioni locali che in quelle cloud. Per saltare l'esecuzione locale, uscire anticipatamente a meno che la variabile di ambiente `CLAUDE_CODE_REMOTE` non sia `true`, come fa lo [script di installazione delle dipendenze](#install-dependencies-with-a-sessionstart-hook).547* **Nessun ambito solo cloud**: gli hook vengono eseguiti sia nelle sessioni locali che in quelle cloud. Per saltare l'esecuzione locale, uscire anticipatamente a meno che la variabile di ambiente `CLAUDE_CODE_REMOTE` non sia `true`, come fa lo [script di installazione delle dipendenze](#install-dependencies-with-a-sessionstart-hook).

544* **Richiede accesso di rete**: i comandi di installazione devono raggiungere i registri dei pacchetti. Se l'ambiente utilizza accesso di rete **None**, questi hook non riescono. L'[elenco consentiti predefinito](#default-allowed-domains) sotto **Trusted** copre npm, PyPI, RubyGems e crates.io.548* **Richiede accesso di rete**: i comandi di installazione devono raggiungere i registri dei pacchetti. Se il tuo ambiente utilizza accesso di rete **None**, questi hook non riescono. Con il livello **Limited** predefinito e **Allow package managers** selezionato, l'[allowlist predefinita](#default-allowed-domains) copre npm, PyPI, RubyGems e crates.io.

545* **Compatibilità proxy**: negli ambienti ospitati da Anthropic, tutto il traffico in uscita passa attraverso un [proxy di sicurezza](#security-proxy), e alcuni gestori di pacchetti non funzionano correttamente con esso; Bun è un esempio noto. In un [ambiente self-hosted](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#default-deny-egress), il traffico in uscita passa attraverso il proprio confine di rete.549* **Compatibilità proxy**: negli ambienti ospitati da Anthropic, tutto il traffico in uscita passa attraverso un [proxy di sicurezza](#security-proxy), e alcuni gestori di pacchetti non funzionano correttamente con esso; Bun è un esempio noto. In un [ambiente self-hosted](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#default-deny-egress), il traffico in uscita passa attraverso il proprio confine di rete.

546* **Aggiunge latenza all'avvio**: gli hook vengono eseguiti ogni volta che una sessione si avvia o riprende, a differenza degli script di configurazione che beneficiano della [cache dell'ambiente](#environment-caching). Mantieni veloci gli script di installazione saltando il lavoro già fatto, come fa lo [script di installazione delle dipendenze](#install-dependencies-with-a-sessionstart-hook).550* **Aggiunge latenza all'avvio**: gli hook vengono eseguiti ogni volta che una sessione si avvia o riprende, a differenza degli script di configurazione che beneficiano della [cache dell'ambiente](#environment-caching). Mantieni veloci gli script di installazione saltando il lavoro già fatto, come fa lo [script di installazione delle dipendenze](#install-dependencies-with-a-sessionstart-hook).

547 551 

549 553 

550## Domini consentiti predefiniti554## Domini consentiti predefiniti

551 555 

552Con accesso di rete **Trusted**, le sessioni possono raggiungere i seguenti domini per impostazione predefinita. I domini contrassegnati con `*` indicano la corrispondenza del sottodominio con carattere jolly, quindi `*.gcr.io` consente qualsiasi sottodominio di `gcr.io`.556Quando **Allow package managers** è selezionato con accesso di rete **Limited**, come avviene in un nuovo ambiente, le sessioni possono raggiungere i seguenti domini. I domini contrassegnati con `*` indicano la corrispondenza del sottodominio con carattere jolly, quindi `*.gcr.io` consente qualsiasi sottodominio di `gcr.io`.

553 557 

554> [accordion] Servizi Anthropic558> [accordion] Servizi Anthropic

555>559>

65| `/bug [report]` | Segnala un bug o condivide la tua conversazione. Scegli quanta cronologia della sessione includere e confermi in una schermata di consenso prima che venga inviato qualsiasi contenuto. Quando hai effettuato l'accesso ad Anthropic su una connessione first-party, la segnalazione va ad Anthropic; su un provider di terze parti, o senza credenziali Anthropic, Claude Code scrive la segnalazione in un [archivio locale in `~/.claude/feedback-bundles/`](https://code.claude.com/docs/it/data-usage#telemetry-services) che inoltri tu stesso. Nell'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md#use-the-prompt-box), `/bug` apre invece la finestra di dialogo di feedback dell'estensione; richiede Claude Code v2.1.229 o successiva. Quando lo esegui mentre Claude sta rispondendo, Claude Code apre immediatamente la finestra di dialogo. Prima della v2.1.232, Claude Code metteva il comando in coda fino al termine del turno. Alias: `/share`. Prima della v2.1.212, `/bug` e `/share` erano alias di `/feedback` |65| `/bug [report]` | Segnala un bug o condivide la tua conversazione. Scegli quanta cronologia della sessione includere e confermi in una schermata di consenso prima che venga inviato qualsiasi contenuto. Quando hai effettuato l'accesso ad Anthropic su una connessione first-party, la segnalazione va ad Anthropic; su un provider di terze parti, o senza credenziali Anthropic, Claude Code scrive la segnalazione in un [archivio locale in `~/.claude/feedback-bundles/`](https://code.claude.com/docs/it/data-usage#telemetry-services) che inoltri tu stesso. Nell'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md#use-the-prompt-box), `/bug` apre invece la finestra di dialogo di feedback dell'estensione; richiede Claude Code v2.1.229 o successiva. Quando lo esegui mentre Claude sta rispondendo, Claude Code apre immediatamente la finestra di dialogo. Prima della v2.1.232, Claude Code metteva il comando in coda fino al termine del turno. Alias: `/share`. Prima della v2.1.212, `/bug` e `/share` erano alias di `/feedback` |

66| `/cd <path>` | Sposta questa sessione in una nuova directory di lavoro, mantenendo la conversazione. Digita un percorso parziale per vedere i suggerimenti di directory corrispondenti; premi `Tab` per accettarne uno. Per sapere cosa Claude Code applica dalla nuova directory non appena ti sposti e in cosa `/cd` differisce da `/add-dir`, consulta [Spostare la sessione in un'altra directory](https://code.claude.com/docs/it/permissions.md#move-the-session-to-another-directory) |66| `/cd <path>` | Sposta questa sessione in una nuova directory di lavoro, mantenendo la conversazione. Digita un percorso parziale per vedere i suggerimenti di directory corrispondenti; premi `Tab` per accettarne uno. Per sapere cosa Claude Code applica dalla nuova directory non appena ti sposti e in cosa `/cd` differisce da `/add-dir`, consulta [Spostare la sessione in un'altra directory](https://code.claude.com/docs/it/permissions.md#move-the-session-to-another-directory) |

67| `/chrome` | Configura le impostazioni di [Claude in Chrome](https://code.claude.com/docs/it/chrome.md) |67| `/chrome` | Configura le impostazioni di [Claude in Chrome](https://code.claude.com/docs/it/chrome.md) |

68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Carica 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 tuo progetto. Si attiva anche automaticamente quando il tuo codice importa `anthropic` o `@anthropic-ai/sdk`. Per sapere cosa fa ogni sottocomando e quale versione richiede, consulta [Lavorare su progetti Claude API](https://code.claude.com/docs/it/skills.md#work-on-claude-api-projects) |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|latency-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Carica 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 tuo progetto. Si attiva anche automaticamente quando il tuo codice importa `anthropic` o `@anthropic-ai/sdk`. Per sapere cosa fa ogni sottocomando e quale versione richiede, consulta [Lavorare su progetti Claude API](https://code.claude.com/docs/it/skills.md#work-on-claude-api-projects) |

69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Fa svolgere a Claude un'attività nel tuo browser, come testare una pagina, compilare un modulo o leggere i log della console, tramite [Claude in Chrome](https://code.claude.com/docs/it/chrome.md). Disponibile quando l'integrazione con Chrome è abilitata per la sessione, ad esempio con `claude --chrome`, o quando Claude Code può offrirsi di [installare l'estensione](https://code.claude.com/docs/it/chrome.md#install-the-extension-when-claude-asks) |69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Fa svolgere a Claude un'attività nel tuo browser, come testare una pagina, compilare un modulo o leggere i log della console, tramite [Claude in Chrome](https://code.claude.com/docs/it/chrome.md). Disponibile quando l'integrazione con Chrome è abilitata per la sessione, ad esempio con `claude --chrome`, o quando Claude Code può offrirsi di [installare l'estensione](https://code.claude.com/docs/it/chrome.md#install-the-extension-when-claude-asks) |

70| `/clear [name]` | Avvia una nuova conversazione con contesto vuoto. Passa un nome per etichettare la conversazione precedente nel selettore di `/resume`. Per liberare contesto continuando la stessa conversazione, usa invece `/compact`. Riprendi la conversazione precedente con `/resume` oppure, nello stesso processo di Claude Code, ripristinala dalla [voce della sessione precedente nel menu di rewind](https://code.claude.com/docs/it/checkpointing.md#rewind-past-a-cleared-conversation). Alias: `/reset`, `/new` |70| `/clear [name]` | Avvia una nuova conversazione con contesto vuoto. Passa un nome per etichettare la conversazione precedente nel selettore di `/resume`. Per liberare contesto continuando la stessa conversazione, usa invece `/compact`. Riprendi la conversazione precedente con `/resume` oppure, nello stesso processo di Claude Code, ripristinala dalla [voce della sessione precedente nel menu di rewind](https://code.claude.com/docs/it/checkpointing.md#rewind-past-a-cleared-conversation). Alias: `/reset`, `/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Esamina il diff corrente, oppure un numero di PR, un branch o un percorso che passi, alla ricerca di bug di correttezza. A seconda del modello e del livello di sforzo, la revisione copre anche opportunità di pulizia. Passa `--fix` per fare in modo che Claude applichi i risultati, `--comment` per pubblicarli sulla PR GitHub o sulla merge request GitLab, oppure `ultra` per eseguire una [revisione cloud](https://code.claude.com/docs/it/ultrareview.md) approfondita. La pubblicazione su una merge request GitLab richiede Claude Code v2.1.257 o successiva. Con `ultra` su una PR di `github.com` come destinazione, passa `--post` per preselezionare nella finestra di dialogo di avvio la [pubblicazione dei risultati finali sulla PR](https://code.claude.com/docs/it/ultrareview.md#post-findings-to-the-pull-request); `--post` richiede Claude Code v2.1.227 o successiva. Consulta [Revisione locale con `/code-review`](https://code.claude.com/docs/it/code-review-local) per i livelli di sforzo, la scelta della destinazione e la relazione con `/simplify`. Alias: `/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Esamina il diff corrente, oppure un numero di PR, un branch o un percorso che passi, alla ricerca di bug di correttezza. A seconda del modello e del livello di sforzo, la revisione copre anche opportunità di pulizia. Passa `--fix` per fare in modo che Claude applichi i risultati, `--comment` per pubblicarli sulla PR GitHub o sulla merge request GitLab, oppure `ultra` per eseguire una [revisione cloud](https://code.claude.com/docs/it/ultrareview.md) approfondita. La pubblicazione su una merge request GitLab richiede Claude Code v2.1.257 o successiva. Con `ultra` su una PR di `github.com` come destinazione, passa `--post` per preselezionare nella finestra di dialogo di avvio la [pubblicazione dei risultati finali sulla PR](https://code.claude.com/docs/it/ultrareview.md#post-findings-to-the-pull-request); `--post` richiede Claude Code v2.1.227 o successiva. Consulta [Revisione locale con `/code-review`](https://code.claude.com/docs/it/code-review-local) per i livelli di sforzo, la scelta della destinazione e la relazione con `/simplify`. Alias: `/review` |

466claude --worktree feature-auth466claude --worktree feature-auth

467```467```

468 468 

469Esegui lo stesso comando con un nome diverso in un secondo terminale per avviare una sessione parallela isolata. In un repository senza commit, il comando fallisce con `Failed to resolve base branch "HEAD": git rev-parse failed`. Vedi [Worktrees](https://code.claude.com/docs/it/worktrees.md) per pulizia, `.worktreeinclude` e supporto VCS non-git. Per monitorare sessioni parallele da uno schermo invece di terminali separati, vedi [agenti in background](https://code.claude.com/docs/it/agent-view.md).469Esegui lo stesso comando con un nome diverso in un secondo terminale per avviare una sessione parallela isolata. Vedi [Worktrees](https://code.claude.com/docs/it/worktrees.md) per pulizia, `.worktreeinclude` e supporto VCS non-git. Per monitorare sessioni parallele da uno schermo invece di terminali separati, vedi [agenti in background](https://code.claude.com/docs/it/agent-view.md).

470 470 

471## Pianificare prima di modificare471## Pianificare prima di modificare

472 472 

19 19 

20## Cosa sopravvive alla compattazione20## Cosa sopravvive alla compattazione

21 21 

22Quando una sessione lunga si compatta, Claude Code riassume la cronologia della conversazione per adattarsi alla finestra di contesto. A partire dalla v2.1.198, la richiesta di riepilogo eredita la configurazione del [ragionamento esteso](https://code.claude.com/docs/it/model-config.md#extended-thinking) della tua sessione, quindi usa il ragionamento quando la tua sessione lo ha abilitato e lo lascia disattivato altrimenti. Il ragionamento influisce solo su come viene prodotto il riepilogo; le impostazioni della tua sessione rimangono invariate in seguito. Cosa accade a ogni tipo di contenuto dipende da come è stato caricato:22Quando una sessione lunga si compatta, Claude Code riassume la cronologia della conversazione per adattarsi alla finestra di contesto.

23 23 

24| Meccanismo | Dopo la compattazione |24| Meccanismo | Dopo la compattazione |

25| :- | :- |25| :- | :- |

243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disattivare le [skill](https://code.claude.com/docs/it/skills.md) e i workflow inclusi in Claude Code: le skill e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma sono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; nascondilo invece con `DISABLE_DOCTOR_COMMAND`. Le skill provenienti dai plugin, da `.claude/skills/` e da `.claude/commands/` non sono interessate. Equivale all'impostazione [`disableBundledSkills`](https://code.claude.com/docs/it/settings-reference#disablebundledskills) |243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disattivare le [skill](https://code.claude.com/docs/it/skills.md) e i workflow inclusi in Claude Code: le skill e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma sono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; nascondilo invece con `DISABLE_DOCTOR_COMMAND`. Le skill provenienti dai plugin, da `.claude/skills/` e da `.claude/commands/` non sono interessate. Equivale all'impostazione [`disableBundledSkills`](https://code.claude.com/docs/it/settings-reference#disablebundledskills) |

244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Imposta `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](https://code.claude.com/docs/it/chrome.md) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](https://code.claude.com/docs/it/skills.md#bundled-skills) `/claude-in-chrome`. In VS Code, l'estensione alla v2.1.314 o successiva esclude anche le istruzioni di Claude in Chrome dai messaggi di una sessione. Richiede Claude Code v2.1.257 o successivo |244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Imposta `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](https://code.claude.com/docs/it/chrome.md) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](https://code.claude.com/docs/it/skills.md#bundled-skills) `/claude-in-chrome`. In VS Code, l'estensione alla v2.1.314 o successiva esclude anche le istruzioni di Claude in Chrome dai messaggi di una sessione. Richiede Claude Code v2.1.257 o successivo |

245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta su `1` per impedire il caricamento nel contesto di qualsiasi file di memoria CLAUDE.md, inclusi i file di memoria utente, di progetto e automatica |245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta su `1` per impedire il caricamento nel contesto di qualsiasi file di memoria CLAUDE.md, inclusi i file di memoria utente, di progetto e automatica |

246| `CLAUDE_CODE_DISABLE_CRON` | Imposta `1` per disattivare le [attività pianificate con ambito di sessione](https://code.claude.com/docs/it/scheduled-tasks.md). La skill `/loop` e gli strumenti cron diventano non disponibili e le attività già pianificate smettono di attivarsi, incluse quelle già in esecuzione a metà sessione |246| `CLAUDE_CODE_DISABLE_CRON` | Imposta `1` per disabilitare le [attività pianificate limitate alla sessione](https://code.claude.com/docs/it/scheduled-tasks.md#disable-scheduled-tasks). La skill `/loop` e `CronCreate` diventano non disponibili e le attività già pianificate smettono di attivarsi, incluse quelle già in esecuzione a metà sessione |

247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Imposta `1` per disattivare il [limite di tempo e i rifiuti](https://code.claude.com/docs/it/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes) di `auto` e `bypassPermissions` sulle rimozioni di percorsi critici. Queste rimozioni passano quindi al classificatore in modalità `auto` e ricevono una richiesta di conferma senza limite di tempo in modalità `bypassPermissions` ovunque Claude Code possa mostrarne una. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva |247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Imposta `1` per disattivare il [limite di tempo e i rifiuti](https://code.claude.com/docs/it/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes) di `auto` e `bypassPermissions` sulle rimozioni di percorsi critici. Queste rimozioni passano quindi al classificatore in modalità `auto` e ricevono una richiesta di conferma senza limite di tempo in modalità `bypassPermissions` ovunque Claude Code possa mostrarne una. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva |

248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere dalle richieste API gli header `anthropic-beta` di pre-release, i campi del corpo associati e i campi beta dello schema degli strumenti come `defer_loading` e `eager_input_streaming`. Usala quando un gateway proxy rifiuta le richieste con un errore `Unexpected value(s)` per l'header `anthropic-beta` o un errore `Extra inputs are not permitted`. [Disattivare le funzionalità di pre-release](https://code.claude.com/docs/it/llm-gateway-protocol.md#disable-pre-release-capabilities) elenca cosa rimuove la variabile, incluso [MCP Tool Search](https://code.claude.com/docs/it/mcp.md#scale-with-mcp-tool-search), e cosa Claude Code continua a inviare |248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere dalle richieste API gli header `anthropic-beta` di pre-release, i campi del corpo associati e i campi beta dello schema degli strumenti come `defer_loading` e `eager_input_streaming`. Usala quando un gateway proxy rifiuta le richieste con un errore `Unexpected value(s)` per l'header `anthropic-beta` o un errore `Extra inputs are not permitted`. [Disattivare le funzionalità di pre-release](https://code.claude.com/docs/it/llm-gateway-protocol.md#disable-pre-release-capabilities) elenca cosa rimuove la variabile, incluso [MCP Tool Search](https://code.claude.com/docs/it/mcp.md#scale-with-mcp-tool-search), e cosa Claude Code continua a inviare |

249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Imposta su `1` per disattivare i [subagent Explore e Plan](https://code.claude.com/docs/it/sub-agents.md#built-in-subagents) integrati. Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode) legge i file direttamente invece di avviare gli agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent integrato nell'Agent SDK o in modalità non interattiva, usa invece `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o versioni successive |249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Imposta su `1` per disattivare i [subagent Explore e Plan](https://code.claude.com/docs/it/sub-agents.md#built-in-subagents) integrati. Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode) legge i file direttamente invece di avviare gli agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent integrato nell'Agent SDK o in modalità non interattiva, usa invece `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o versioni successive |

250| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disattivare la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) |250| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disattivare la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) |

251| `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | Imposta `1` per disattivare il recupero dei feature flag. Richiede Claude Code v2.1.319 o successiva. Con questa variabile impostata, [Remote Control](https://code.claude.com/docs/it/remote-control.md#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching) non sono disponibili. La registrazione degli eventi di telemetria resta attiva tranne quando è impostata anche `DISABLE_TELEMETRY`. Il nome precedente, `DISABLE_GROWTHBOOK`, funziona ancora ed è l'unico che le versioni dalla v2.1.124 alla v2.1.318 leggono |

251| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disattivare i sondaggi sulla qualità della sessione "How is Claude doing?". I sondaggi sono disattivati anche quando è impostata `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non li riattivi. Per impostare una frequenza di campionamento invece di disattivarli del tutto, usa l'impostazione [`feedbackSurveyRate`](https://code.claude.com/docs/it/settings-reference#feedbacksurveyrate). Consulta [Sondaggi sulla qualità della sessione](https://code.claude.com/docs/it/data-usage.md#session-quality-surveys) |252| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disattivare i sondaggi sulla qualità della sessione "How is Claude doing?". I sondaggi sono disattivati anche quando è impostata `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non li riattivi. Per impostare una frequenza di campionamento invece di disattivarli del tutto, usa l'impostazione [`feedbackSurveyRate`](https://code.claude.com/docs/it/settings-reference#feedbacksurveyrate). Consulta [Sondaggi sulla qualità della sessione](https://code.claude.com/docs/it/data-usage.md#session-quality-surveys) |

252| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disattivare il [checkpointing](https://code.claude.com/docs/it/checkpointing.md) dei file. Il comando `/rewind` non potrà ripristinare le modifiche al codice. Sovrascrive l'impostazione [`fileCheckpointingEnabled`](https://code.claude.com/docs/it/settings-reference#filecheckpointingenabled) |253| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disattivare il [checkpointing](https://code.claude.com/docs/it/checkpointing.md) dei file. Il comando `/rewind` non potrà ripristinare le modifiche al codice. Sovrascrive l'impostazione [`fileCheckpointingEnabled`](https://code.claude.com/docs/it/settings-reference#filecheckpointingenabled) |

253| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | Imposta su `1` per impedire a Claude Code di espandere le [menzioni `@`](https://code.claude.com/docs/it/common-workflows#reference-files-and-directories) di file e directory. Claude riceve invece i percorsi menzionati con una nota che gli indica di leggerli usando i suoi strumenti per i file. Ignorata nelle [impostazioni di progetto e locali](https://code.claude.com/docs/it/settings-reference.md#variables-claude-code-ignores-in-env). Richiede Claude Code v2.1.299 o successiva |254| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | Imposta su `1` per impedire a Claude Code di espandere le [menzioni `@`](https://code.claude.com/docs/it/common-workflows#reference-files-and-directories) di file e directory. Claude riceve invece i percorsi menzionati con una nota che gli indica di leggerli usando i suoi strumenti per i file. Ignorata nelle [impostazioni di progetto e locali](https://code.claude.com/docs/it/settings-reference.md#variables-claude-code-ignores-in-env). Richiede Claude Code v2.1.299 o successiva |

451| `DISABLE_ERROR_REPORTING` | Imposta a qualsiasi valore non vuoto, come `1`, per disattivare la segnalazione degli errori. **Impostarla a `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la segnalazione degli errori |452| `DISABLE_ERROR_REPORTING` | Imposta a qualsiasi valore non vuoto, come `1`, per disattivare la segnalazione degli errori. **Impostarla a `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la segnalazione degli errori |

452| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta a `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i rate limit |453| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta a `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i rate limit |

453| `DISABLE_FEEDBACK_COMMAND` | Imposta a `1` per disabilitare il comando `/feedback` e il [feedback redatto da Claude](https://code.claude.com/docs/it/tools-reference.md#sendfeedback-tool-behavior). Disabilita anche `/bug` e `/share`, che inviano le segnalazioni attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando era disabilitato con ogni nome. È accettato anche il nome precedente `DISABLE_BUG_COMMAND` |454| `DISABLE_FEEDBACK_COMMAND` | Imposta a `1` per disabilitare il comando `/feedback` e il [feedback redatto da Claude](https://code.claude.com/docs/it/tools-reference.md#sendfeedback-tool-behavior). Disabilita anche `/bug` e `/share`, che inviano le segnalazioni attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando era disabilitato con ogni nome. È accettato anche il nome precedente `DISABLE_BUG_COMMAND` |

454| `DISABLE_GROWTHBOOK` | Imposta su `1` o `true` per disattivare il recupero dei feature flag e usare i valori predefiniti del codice per ogni flag. Questo rende non disponibili [Remote Control](https://code.claude.com/docs/it/remote-control.md#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). Impostarla su `0` o `false` lascia attivo il recupero. La registrazione degli eventi di telemetria resta attiva a meno che non sia impostata anche `DISABLE_TELEMETRY` |455| `DISABLE_GROWTHBOOK` | Imposta a `1` per disattivare il [recupero dei feature flag](#features-that-need-feature-flag-fetching). Richiede Claude Code v2.1.124 o successivo. Sostituita da `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, che richiede la v2.1.319 o successiva: usa quel nome, a meno che la configurazione non venga letta da una macchina con la v2.1.318 o precedente. Questo nome funziona ancora |

455| `DISABLE_INSTALLATION_CHECKS` | Imposta a `1` per disabilitare gli avvisi di installazione. Usala solo quando gestisci manualmente il percorso di installazione, perché può mascherare problemi con le installazioni standard |456| `DISABLE_INSTALLATION_CHECKS` | Imposta a `1` per disabilitare gli avvisi di installazione. Usala solo quando gestisci manualmente il percorso di installazione, perché può mascherare problemi con le installazioni standard |

456| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Imposta a `1` per nascondere il comando `/install-github-app`. È già nascosto quando si usano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry) |457| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Imposta a `1` per nascondere il comando `/install-github-app`. È già nascosto quando si usano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry) |

457| `DISABLE_INTERLEAVED_THINKING` | Imposta a `1` per evitare l'invio dell'header beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il [ragionamento interleaved](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |458| `DISABLE_INTERLEAVED_THINKING` | Imposta a `1` per evitare l'invio dell'header beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il [ragionamento interleaved](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

569 570 

570Claude Code attiva alcune funzionalità tramite feature flag che recupera da Anthropic. Claude Code salta questo recupero nelle seguenti sessioni:571Claude Code attiva alcune funzionalità tramite feature flag che recupera da Anthropic. Claude Code salta questo recupero nelle seguenti sessioni:

571 572 

572* Una sessione in cui imposti `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`; la riga di ciascuna variabile nella [tabella delle variabili](#variables) indica quali valori disattivano il recupero573* Una sessione in cui imposti `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`; la riga di ciascuna variabile nella [tabella delle variabili](#variables) indica quali valori disattivano il recupero

573* Una sessione su un [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md), come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform o Microsoft Foundry, a meno che una piattaforma host che incorpora Claude Code non imposti `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`574* Una sessione su un [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md), come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform o Microsoft Foundry, a meno che una piattaforma host che incorpora Claude Code non imposti `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`

574* Una sessione del [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway)575* Una sessione del [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway)

575 576 

576Con il recupero disattivato, non puoi:577Con il recupero disattivato, non puoi:

577 578 

578* Usare [Remote Control](https://code.claude.com/docs/it/remote-control.md) con `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK` impostati. Per `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulta i [requisiti di Remote Control](https://code.claude.com/docs/it/remote-control.md#requirements)579* Usare [Remote Control](https://code.claude.com/docs/it/remote-control.md) con `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](#variables) impostati. Per `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulta i [requisiti di Remote Control](https://code.claude.com/docs/it/remote-control.md#requirements)

579* [Inviare messaggi a sessioni al di fuori di questa macchina](https://code.claude.com/docs/it/cross-session-messaging.md#message-sessions-on-other-machines) quando [Remote Control](https://code.claude.com/docs/it/remote-control.md#requirements) non è disponibile. La messaggistica tra sessioni su questa macchina funziona con il recupero disattivato580* [Inviare messaggi a sessioni al di fuori di questa macchina](https://code.claude.com/docs/it/cross-session-messaging.md#message-sessions-on-other-machines) quando [Remote Control](https://code.claude.com/docs/it/remote-control.md#requirements) non è disponibile. La messaggistica tra sessioni su questa macchina funziona con il recupero disattivato

580* Eseguire [`claude import` o il comando `/import`](https://code.claude.com/docs/it/cli-reference#cli-commands)581* Eseguire [`claude import` o il comando `/import`](https://code.claude.com/docs/it/cli-reference#cli-commands)

581* Eseguire [`/skill-doctor`](https://code.claude.com/docs/it/skills#find-unused-skills) o aprirne il report nella scheda **Stats** di `/plugin`582* Eseguire [`/skill-doctor`](https://code.claude.com/docs/it/skills#find-unused-skills) o aprirne il report nella scheda **Stats** di `/plugin`

582* Eseguire [`/restart`](https://code.claude.com/docs/it/commands) sui piani Pro, Max e Ultra583* Eseguire [`/restart`](https://code.claude.com/docs/it/commands) sui piani Pro, Max e Ultra

583* Sincronizzare le [skill](https://code.claude.com/docs/it/skills.md#where-synced-skills-load) e i [plugin](https://code.claude.com/docs/it/plugins/loading.md#synced-plugins) abilitati per il tuo account claude.ai nelle sessioni del terminale584* Sincronizzare le [skill](https://code.claude.com/docs/it/skills.md#where-synced-skills-load) e i [plugin](https://code.claude.com/docs/it/plugins/loading.md#synced-plugins) abilitati per il tuo account claude.ai nelle sessioni del terminale

584* Attivare il [mod You should know](https://code.claude.com/docs/it/interactive-mode.md#you-should-know-suggestions)585* Attivare il [mod You should know](https://code.claude.com/docs/it/interactive-mode.md#you-should-know-suggestions)

585* Usare [lo strumento advisor](https://code.claude.com/docs/it/advisor.md#requirements)586* Usare [lo strumento advisor](https://code.claude.com/docs/it/advisor.md#requirements), tranne su Claude Platform on AWS con Claude Code v2.1.300 o versioni successive

586* Usare i [task MCP](https://code.claude.com/docs/it/mcp.md#mcp-tasks-that-run-on-the-server)587* Usare i [task MCP](https://code.claude.com/docs/it/mcp.md#mcp-tasks-that-run-on-the-server)

587* Leggere o rispondere ai [commenti su un artefatto](https://code.claude.com/docs/it/artifacts.md#collect-comments-on-an-artifact)588* Leggere o rispondere ai [commenti su un artefatto](https://code.claude.com/docs/it/artifacts.md#collect-comments-on-an-artifact)

588* Far leggere a Claude [l'artefatto pubblico di un'altra organizzazione](https://code.claude.com/docs/it/artifacts.md#read-an-artifact-shared-with-you)589* Far leggere a Claude [l'artefatto pubblico di un'altra organizzazione](https://code.claude.com/docs/it/artifacts.md#read-an-artifact-shared-with-you)

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/it/env-vars) | 500 | Ritardo iniziale in millisecondi del backoff tra i nuovi tentativi di una richiesta che l'API rifiuta con un errore di sovraccarico `529`. Aumentalo, fino a 32000, per distribuire i nuovi tentativi su un intervallo più lungo quando l'API è al limite della capacità. Non ha effetto quando `CLAUDE_CODE_RETRY_WATCHDOG` è impostato su `1`, o quando la richiesta rifiutata è stata inviata in [modalità veloce](https://code.claude.com/docs/it/fast-mode.md#handle-rate-limits). Richiede Claude Code v2.1.292 o successivo. |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/it/env-vars) | 500 | Ritardo iniziale in millisecondi del backoff tra i nuovi tentativi di una richiesta che l'API rifiuta con un errore di sovraccarico `529`. Aumentalo, fino a 32000, per distribuire i nuovi tentativi su un intervallo più lungo quando l'API è al limite della capacità. Non ha effetto quando `CLAUDE_CODE_RETRY_WATCHDOG` è impostato su `1`, o quando la richiesta rifiutata è stata inviata in [modalità veloce](https://code.claude.com/docs/it/fast-mode.md#handle-rate-limits). Richiede Claude Code v2.1.292 o successivo. |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/it/env-vars) | 32000 | Limite massimo in millisecondi del backoff tra i nuovi tentativi di una richiesta che l'API rifiuta con un errore di sovraccarico `529`. Aumentalo, fino a 64000, in modo che i nuovi tentativi successivi continuino a distanziarsi quando l'API è al limite della capacità. Non ha effetto quando `CLAUDE_CODE_RETRY_WATCHDOG` è impostato su `1`, o quando la richiesta rifiutata è stata inviata in [modalità veloce](https://code.claude.com/docs/it/fast-mode.md#handle-rate-limits). Richiede Claude Code v2.1.296 o successivo. |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/it/env-vars) | 32000 | Limite massimo in millisecondi del backoff tra i nuovi tentativi di una richiesta che l'API rifiuta con un errore di sovraccarico `529`. Aumentalo, fino a 64000, in modo che i nuovi tentativi successivi continuino a distanziarsi quando l'API è al limite della capacità. Non ha effetto quando `CLAUDE_CODE_RETRY_WATCHDOG` è impostato su `1`, o quando la richiesta rifiutata è stata inviata in [modalità veloce](https://code.claude.com/docs/it/fast-mode.md#handle-rate-limits). Richiede Claude Code v2.1.296 o successivo. |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/it/env-vars) | 600000 | Tempo in millisecondi entro cui ogni tentativo di richiesta deve ricevere le intestazioni di risposta. Non limita quanto a lungo prosegue una risposta in streaming dopo quel momento. Aumentalo per reti lente o proxy. Per come limita la scadenza del primo byte, vedi [No response from API](#no-response-from-api). |564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/it/env-vars) | 600000 | Tempo in millisecondi entro cui ogni tentativo di richiesta deve ricevere le intestazioni di risposta. Non limita quanto a lungo prosegue una risposta in streaming dopo quel momento. Aumentalo per reti lente o proxy. Per come limita la scadenza del primo byte, vedi [No response from API](#no-response-from-api). |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/it/env-vars) | unset | Limite di nuovi invii di una [richiesta non in streaming](#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Al raggiungimento del limite, la richiesta fallisce. Una risposta di Claude che impiega più del timeout per essere generata va di nuovo in timeout a ogni nuovo invio, quindi imposta un numero basso come `0` per fallire prima. Ogni tentativo non in streaming va in timeout dopo 300 secondi in una sessione locale, oppure dopo `API_TIMEOUT_MS` quando imposti un valore positivo. Richiede Claude Code v2.1.285 o successivo. |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/it/env-vars) | unset | Limite di nuovi invii di una [richiesta non in streaming](#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Al raggiungimento del limite, la richiesta fallisce. Una risposta di Claude che impiega più del timeout per essere generata va di nuovo in timeout a ogni nuovo invio, quindi imposta un numero basso come `0` per fallire prima. Per il timeout di ogni tentativo, vedi [Quanto attende un tentativo non in streaming](#how-long-a-non-streaming-attempt-waits). Richiede Claude Code v2.1.285 o successivo. |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/it/env-vars) | unset | Scadenza in millisecondi per il primo byte di risposta di una richiesta di streaming. Richiede Claude Code v2.1.242 o successivo. Per come Claude Code sceglie la scadenza quando questo non è impostato, vedi [No response from API](#no-response-from-api). |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/it/env-vars) | unset | Scadenza in millisecondi per il primo byte di risposta di una richiesta di streaming. Richiede Claude Code v2.1.242 o successivo. Per come Claude Code sceglie la scadenza quando questo non è impostato, vedi [No response from API](#no-response-from-api). |

567 567 

568#### Quanto attende un tentativo non in streaming

569 

570Un tentativo non in streaming termina al suo timeout della richiesta o al timeout di inattività del corpo, a seconda di quale arrivi prima:

571 

572* **Timeout della richiesta**: `API_TIMEOUT_MS` quando imposti un valore positivo, altrimenti 300 secondi in una sessione locale.

573* **[Timeout di inattività del corpo](https://code.claude.com/docs/it/network-config.md#streaming-idle-watchdogs)**: da 5 a 6 minuti senza una risposta, per quanto alto imposti `API_TIMEOUT_MS`, dove è attivo e non l'hai disattivato.

574 

568## Errori del server575## Errori del server

569 576 

570La maggior parte di questi errori proviene dal provider di inferenza: il servizio di Anthropic su Anthropic API e il servizio dietro l'endpoint di quel provider su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway personalizzato. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) e [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) coprono anche cause dal tuo lato, come un account Amazon Bedrock che non può invocare il modello del classificatore o un subagent che ha raggiunto un limite di utilizzo.577La maggior parte di questi errori proviene dal provider di inferenza: il servizio di Anthropic su Anthropic API e il servizio dietro l'endpoint di quel provider su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway personalizzato. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) e [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) coprono anche cause dal tuo lato, come un account Amazon Bedrock che non può invocare il modello del classificatore o un subagent che ha raggiunto un limite di utilizzo.

2212Questo errore non è un problema di rete lato client. Le sessioni cloud e le [attività pianificate cloud](https://code.claude.com/docs/it/routines.md) vengono eseguite all'interno di una VM sandbox il cui traffico in uscita attraverso la rete della sessione è filtrato in base all'allowlist dell'[ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md):2219Questo errore non è un problema di rete lato client. Le sessioni cloud e le [attività pianificate cloud](https://code.claude.com/docs/it/routines.md) vengono eseguite all'interno di una VM sandbox il cui traffico in uscita attraverso la rete della sessione è filtrato in base all'allowlist dell'[ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md):

2213 2220 

2214* **Traffico GitHub e dei connettori**: le [operazioni GitHub](https://code.claude.com/docs/it/cloud-environments.md#github-proxy) e il traffico dei connettori MCP utilizzano canali separati, motivo per cui possono continuare a funzionare mentre altri host sono bloccati2221* **Traffico GitHub e dei connettori**: le [operazioni GitHub](https://code.claude.com/docs/it/cloud-environments.md#github-proxy) e il traffico dei connettori MCP utilizzano canali separati, motivo per cui possono continuare a funzionare mentre altri host sono bloccati

2215* **Ambiente predefinito**: l'ambiente **Default** utilizza l'accesso **Trusted**, che consente l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) di registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni e blocca altri domini su quel percorso2222* **Ambiente predefinito**: l'ambiente **Default** utilizza l'accesso **Limited** con **Allow package managers** selezionato. Le sue sessioni raggiungono l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) di registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni.

2216 2223 

2217**Cosa fare:**2224**Cosa fare:**

2218 2225 

2219Questi passaggi cambiano uno dei tuoi ambienti. Un [organization-shared environment](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) si apre in sola lettura nel selettore, quindi chiedi a un Owner di cambiare il suo accesso di rete dalla pagina **Cloud environments** in [admin settings](https://claude.ai/admin-settings).2226Questi passaggi cambiano uno dei tuoi ambienti. Un [organization-shared environment](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) si apre in sola lettura nel selettore, quindi chiedi a un Owner di cambiare il suo accesso di rete dalla pagina **Cloud environments** in [admin settings](https://claude.ai/admin-settings).

2220 2227 

2221* Apri il tuo ambiente per la modifica, o dal [modulo dell'attività pianificata cloud](https://code.claude.com/docs/it/routines.md#environments-and-network-access) o dal [environment selector](https://code.claude.com/docs/it/cloud-environments.md#configure-your-environment) dove avvii sessioni cloud.2228* Apri il tuo ambiente per la modifica, o dal [modulo dell'attività pianificata cloud](https://code.claude.com/docs/it/routines.md#environments-and-network-access) o dal [environment selector](https://code.claude.com/docs/it/cloud-environments.md#configure-your-environment) dove avvii sessioni cloud.

2222* Nella finestra di dialogo **Edit cloud environment**, cambia **Network access** da **Trusted** a **Custom**, quindi aggiungi il dominio bloccato a **Allowed domains**. Inserisci un dominio per riga. Seleziona **Also include default list of common package managers** per mantenere l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) insieme ai tuoi domini personalizzati. Seleziona **Full** invece se desideri accesso senza restrizioni.2229* Nella finestra di dialogo **Edit cloud environment**, seleziona **Limited** in **Network access**, quindi aggiungi il dominio bloccato a **Allowed domains**. Inserisci un dominio per riga. Seleziona **Allow package managers** per consentire l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) insieme ai tuoi domini. Seleziona **Full** invece se desideri accesso senza restrizioni.

2223* Fai clic su **Save changes**. La prossima esecuzione utilizza l'allowlist aggiornata. Per una sessione cloud che è già aperta, vedi [quando una modifica dell'accesso di rete raggiunge le sessioni esistenti](https://code.claude.com/docs/it/cloud-environments.md#network-access).2230* Fai clic su **Save changes**. La prossima esecuzione utilizza l'allowlist aggiornata. Per una sessione cloud che è già aperta, vedi [quando una modifica dell'accesso di rete raggiunge le sessioni esistenti](https://code.claude.com/docs/it/cloud-environments.md#network-access).

2224 2231 

2225Vedi [Network access](https://code.claude.com/docs/it/cloud-environments.md#network-access) per i livelli di accesso e l'allowlist predefinita. Le sessioni CLI locali non sono interessate da questa politica.2232Vedi [Network access](https://code.claude.com/docs/it/cloud-environments.md#network-access) per i livelli di accesso e l'allowlist predefinita. Le sessioni CLI locali non sono interessate da questa politica.

2342**Cosa fare:**2349**Cosa fare:**

2343 2350 

2344* **Accesso non effettuato**: il messaggio continua con `: not signed in. Run /login, then retry.` Esegui `/login`, quindi invia di nuovo2351* **Accesso non effettuato**: il messaggio continua con `: not signed in. Run /login, then retry.` Esegui `/login`, quindi invia di nuovo

2345* **Rifiuto della tua organizzazione**: ad esempio `: Feedback has not been enabled for your organization.` o `: Feedback collection is not available for organizations with custom data retention policies.` Se il messaggio aggiunge `To report a bug, open an issue`, fallo su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). In seguito `/feedback` può rispondere per sette giorni che è [disabilitato dalla policy della tua organizzazione](#feedback-is-disabled-by-your-organizations-policy). Una bozza in coda rimane in coda e [scade comunque secondo la pianificazione](https://code.claude.com/docs/it/tools-reference.md#discard-or-keep-a-draft)2352* **Rifiuto della tua organizzazione**: ad esempio `: Feedback has not been enabled for your organization.` o `: Feedback collection is not available for organizations with custom data retention policies.` In seguito `/feedback` può rispondere per sette giorni che è [disabilitato dalla policy della tua organizzazione](#feedback-is-disabled-by-your-organizations-policy). Una bozza in coda rimane in coda e [scade comunque secondo la pianificazione](https://code.claude.com/docs/it/tools-reference.md#discard-or-keep-a-draft)

2346* **Credenziali rifiutate**: il messaggio continua con `: the sign-in this session uses is not allowed to send feedback` o `: the server did not accept the credentials this session uses`. Esegui `/status` al prompt di Claude Code per vedere quale login, token o chiave API invia questa sessione2353* **Credenziali rifiutate**: il messaggio continua con `: the sign-in this session uses is not allowed to send feedback` o `: the server did not accept the credentials this session uses`. Esegui `/status` al prompt di Claude Code per vedere quale login, token o chiave API invia questa sessione

2347* **`(request timed out)` o `(couldn't reach the service)` subito dopo `Couldn't send feedback`**: invia di nuovo il rapporto o la bozza in coda. La finestra di dialogo mantiene il tuo testo e il messaggio di una bozza in coda indica `The draft is still queued.` Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api). Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2354* **`(request timed out)` o `(couldn't reach the service)` subito dopo `Couldn't send feedback`**: invia di nuovo il rapporto o la bozza in coda. La finestra di dialogo mantiene il tuo testo e il messaggio di una bozza in coda indica `The draft is still queued.` Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api). Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

2348* **`(server returned <status>)`, o nessun motivo, subito dopo `Couldn't send feedback`**: lo stato è il codice di risposta del servizio. Il messaggio del servizio stesso lo segue quando ne è stato inviato uno, come in `(server returned 403: Access Forbidden)`. Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2355* **`(server returned <status>)`, o nessun motivo, subito dopo `Couldn't send feedback`**: lo stato è il codice di risposta del servizio. Il messaggio del servizio stesso lo segue quando ne è stato inviato uno, come in `(server returned 403: Access Forbidden)`. Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

3492* **`Error: Workspace not trusted. <folder> is your home directory`**: poiché la fiducia per la tua directory home non viene mai salvata, eseguire prima `claude` lì non può aiutare. Esegui invece `claude ultrareview` da una directory di progetto, dopo aver eseguito `claude` lì una volta per accettare la finestra di dialogo di fiducia, oppure aggiungi `--trust-workspace`.3499* **`Error: Workspace not trusted. <folder> is your home directory`**: poiché la fiducia per la tua directory home non viene mai salvata, eseguire prima `claude` lì non può aiutare. Esegui invece `claude ultrareview` da una directory di progetto, dopo aver eseguito `claude` lì una volta per accettare la finestra di dialogo di fiducia, oppure aggiungi `--trust-workspace`.

3493* **`No answer in time.` seguito da `Error: Workspace not trusted`**: la domanda `Trust <folder>? [y/N]` è rimasta senza risposta per 5 minuti. Esegui di nuovo `claude ultrareview` e rispondi.3500* **`No answer in time.` seguito da `Error: Workspace not trusted`**: la domanda `Trust <folder>? [y/N]` è rimasta senza risposta per 5 minuti. Esegui di nuovo `claude ultrareview` e rispondi.

3494* **`Ultrareview did not start: <folder> is not trusted`**: hai rifiutato alla domanda `Trust <folder>? [y/N]`, ad esempio rispondendo `n` o premendo Enter. Per avviare la revisione, esegui di nuovo `claude ultrareview` e rispondi `y`.3501* **`Ultrareview did not start: <folder> is not trusted`**: hai rifiutato alla domanda `Trust <folder>? [y/N]`, ad esempio rispondendo `n` o premendo Enter. Per avviare la revisione, esegui di nuovo `claude ultrareview` e rispondi `y`.

3495* **``Ultrareview did not start: `--trust-workspace` takes no value``**: qualcosa che non è un flag segue `--trust-workspace`, come un numero di PR o `false`. Se non consideri attendibile la cartella, ometti il flag. Per considerarla attendibile per questa esecuzione, metti il numero di PR o il branch di base prima del flag: `claude ultrareview 1234 --trust-workspace`.3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**: dopo `--trust-workspace` segue qualcosa che non è un flag, come un numero di PR o `false`. Se non ti fidi della cartella, ometti il flag. Per considerarla attendibile per questa esecuzione, metti il numero di PR o il branch di base prima del flag: `claude ultrareview 1234 --trust-workspace`.

3496 3503 

3497Prima della v2.1.309, `claude ultrareview` non accettava `--trust-workspace`.3504Prima della v2.1.309, `claude ultrareview` non accettava `--trust-workspace`.

3498 3505 

3557 3564 

3558* Non hai avviato una sessione dopo l'installazione, quindi Claude Code non ha ancora recuperato il flag. Il primo `claude import` può stampare questo messaggio anche quando la funzionalità è disponibile per te.3565* Non hai avviato una sessione dopo l'installazione, quindi Claude Code non ha ancora recuperato il flag. Il primo `claude import` può stampare questo messaggio anche quando la funzionalità è disponibile per te.

3559* Usi Claude Code tramite Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry o Claude Platform su AWS, oppure tramite un [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway#availability-and-limitations). Claude Code non recupera i feature flag in queste sessioni, quindi `claude import` rimane non disponibile.3566* Usi Claude Code tramite Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry o Claude Platform su AWS, oppure tramite un [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway#availability-and-limitations). Claude Code non recupera i feature flag in queste sessioni, quindi `claude import` rimane non disponibile.

3560* Hai impostato `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` o [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/it/env-vars), che disattivano il recupero dei feature flag, quindi `claude import` rimane non disponibile.3567* Hai impostato `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/it/env-vars#variables), `DISABLE_GROWTHBOOK` o [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/it/env-vars), che disattivano il recupero dei feature flag, quindi `claude import` rimane non disponibile.

3561 3568 

3562**Cosa fare:**3569**Cosa fare:**

3563 3570 

3799 3806 

3800Stringhe analoghe compaiono prima ancora che il comando venga eseguito:3807Stringhe analoghe compaiono prima ancora che il comando venga eseguito:

3801 3808 

3802* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Controlli dei permessi sui comandi iniettati](https://code.claude.com/docs/it/skills.md#permission-checks-on-injected-commands) spiega quali risultati causano l'interruzione in ciascuna modalità di permesso e come pre-approvare un comando con `allowed-tools`3809* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Controlli dei permessi sui comandi iniettati](https://code.claude.com/docs/it/skills.md#permission-checks-on-injected-commands) spiega quali risultati interrompono l'invocazione in ciascuna modalità di permesso e come pre-approvare un comando con `allowed-tools`

3803* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: il frontmatter della skill richiede bash su una macchina che non ce l'ha. Installa Git for Windows o modifica il frontmatter in `shell: powershell`. Consulta [Come vengono eseguiti i comandi iniettati](https://code.claude.com/docs/it/skills.md#how-injected-commands-run)3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: il frontmatter della skill richiede bash su una macchina che non ce l'ha. Installa Git for Windows o modifica il frontmatter in `shell: powershell`. Consulta [Come vengono eseguiti i comandi iniettati](https://code.claude.com/docs/it/skills.md#how-injected-commands-run)

3804 3811 

3805**Cosa fare:**3812**Cosa fare:**

6615 6622 

6616**2. Aggiorna ogni host che condivide la directory home**6623**2. Aggiorna ogni host che condivide la directory home**

6617 6624 

6618Se più host condividono questa directory home, aggiorna prima Claude Code su ogni host alla versione indicata dal messaggio o successiva. Una versione precedente può riscrivere un `.config.json` spostato.6625Se più host condividono questa directory home, aggiorna prima Claude Code su ogni host alla versione indicata dal messaggio o successiva.

6619 6626 

6620**3. Arresta Claude Code**6627**3. Arresta Claude Code**

6621 6628 

112 <td>✓</td>112 <td>✓</td>

113 <td>✓</td>113 <td>✓</td>

114 <td>✗</td>114 <td>✗</td>

115 <td>✗</td>115 <td>✓ (Claude Code v2.1.300 o successivo)</td>

116 <td>✗</td>116 <td>✗</td>

117 <td>✗</td>117 <td>✗</td>

118 </tr>118 </tr>

221 221 

222> [!NOTE]222> [!NOTE]

223>223>

224> Se ti autentichi tramite un [gateway LLM](https://code.claude.com/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](https://code.claude.com/docs/it/remote-control.md#requirements) e [server-managed settings](https://code.claude.com/docs/it/server-managed-settings.md#platform-availability), indipendentemente da ciò che il gateway inoltra. Alcune funzionalità solo Anthropic come l'[Advisor](https://code.claude.com/docs/it/advisor.md) funzionano solo se il gateway inoltra le richieste intatte all'API Anthropic.224> Se ti autentichi tramite un [gateway LLM](https://code.claude.com/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](https://code.claude.com/docs/it/remote-control.md#requirements) e [server-managed settings](https://code.claude.com/docs/it/server-managed-settings.md#platform-availability), indipendentemente da ciò che il gateway inoltra. Alcune funzionalità, come l'[Advisor](https://code.claude.com/docs/it/advisor.md#requirements), funzionano solo se il gateway inoltra le richieste intatte.

225>225>

226> Per come le richieste che Claude Code invia differiscono tra un gateway in formato Amazon Bedrock o Agent Platform, un gateway `ANTHROPIC_BASE_URL` e un accesso gateway di app Claude, consulta [comportamento del client per metodo di connessione](https://code.claude.com/docs/it/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior).226> Per come le richieste che Claude Code invia differiscono tra un gateway in formato Amazon Bedrock o Agent Platform, un gateway `ANTHROPIC_BASE_URL` e un accesso gateway di app Claude, consulta [comportamento del client per metodo di connessione](https://code.claude.com/docs/it/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior).

227 227 

244 244 

245> [tab] Claude Platform on AWS245> [tab] Claude Platform on AWS

246>246>

247> **Non disponibile:** tutte le [funzionalità che richiedono un abbonamento Claude](#features-that-require-a-claude-subscription), più [fast mode](https://code.claude.com/docs/it/fast-mode.md), [Advisor](https://code.claude.com/docs/it/advisor.md), [Channels](https://code.claude.com/docs/it/channels.md), [GitHub Actions](https://code.claude.com/docs/it/github-actions.md), il [dashboard analytics](https://code.claude.com/docs/it/analytics.md), [server-managed settings](https://code.claude.com/docs/it/server-managed-settings.md) e i [comandi `/design-sync` e `/import`](https://code.claude.com/docs/it/commands#all-commands).247> **Non disponibile:** tutte le [funzionalità che richiedono un abbonamento Claude](#features-that-require-a-claude-subscription), più [fast mode](https://code.claude.com/docs/it/fast-mode.md), [Channels](https://code.claude.com/docs/it/channels.md), [GitHub Actions](https://code.claude.com/docs/it/github-actions.md), il [dashboard analytics](https://code.claude.com/docs/it/analytics.md), [server-managed settings](https://code.claude.com/docs/it/server-managed-settings.md) e i [comandi `/design-sync` e `/import`](https://code.claude.com/docs/it/commands#all-commands).

248>248>

249> **Disponibile dove Amazon Bedrock non lo è:** [web search](https://code.claude.com/docs/it/tools-reference.md#websearch-tool-behavior).249> **Disponibile qui, non su Amazon Bedrock:** [web search](https://code.claude.com/docs/it/tools-reference.md#websearch-tool-behavior), più l'[Advisor](https://code.claude.com/docs/it/advisor.md) in Claude Code v2.1.300 o successivo.

250>250>

251> **Supporto parziale:**251> **Supporto parziale:**

252>252>

54 54 

55### Auto mode55### Auto mode

56 56 

57Una [modalità di permesso](#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. Il classificatore blocca l'escalation dell'ambito, l'infrastruttura non attendibile e la [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.57Una [modalità di permesso](#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. Il classificatore blocca l'escalation dell'ambito, l'infrastruttura non attendibile e la [prompt injection](#prompt-injection).

58 58 

59* **Claude Code v2.1.283 o successivo**: la modalità auto è la [modalità di permesso di avvio integrata](https://code.claude.com/docs/it/permission-modes.md#which-mode-a-session-starts-in) per le sessioni di terminale interattivo e VS Code59* **Claude Code v2.1.283 o successivo**: la modalità auto è la [modalità di permesso di avvio integrata](https://code.claude.com/docs/it/permission-modes.md#which-mode-a-session-starts-in) per le sessioni di terminale interattivo e VS Code

60* **Versioni precedenti**: la modalità auto è la modalità di permesso di avvio integrata solo sui piani Pro, Max, Ultra e Team60* **Versioni precedenti**: la modalità auto è la modalità di permesso di avvio integrata solo sui piani Pro, Max, Ultra e Team

261 261 

262### Prompt injection262### Prompt injection

263 263 

264Istruzioni ostili incorporate in un file, pagina web o risultato dello strumento che tentano di reindirizzare Claude verso azioni che non hai mai chiesto. Le difese di Claude Code includono il sistema di autorizzazioni, il rilevamento dell'iniezione di comandi e la verifica della fiducia. [Auto mode](#auto-mode) aggiunge una sonda lato server che scansiona i risultati degli strumenti per contenuti sospetti e un classificatore che esamina le azioni con i risultati degli strumenti rimossi, quindi il testo iniettato non può manipolarlo direttamente.264Istruzioni ostili incorporate in un file, pagina web o risultato di uno strumento che tentano di reindirizzare Claude verso azioni che non hai chiesto. Le difese di Claude Code includono il sistema di permessi, il rilevamento della command injection e la verifica della fiducia. In [modalità auto](#auto-mode), una sonda lato server scansiona i risultati degli strumenti alla ricerca di contenuti sospetti e un classificatore esamina le azioni.

265 265 

266Scopri di più: [Proteggi da prompt injection](https://code.claude.com/docs/it/security.md#protect-against-prompt-injection)266Scopri di più: [Proteggi da prompt injection](https://code.claude.com/docs/it/security.md#protect-against-prompt-injection)

267 267 

2341 2341 

2342#### Annotare un risultato per il classificatore della modalità auto2342#### Annotare un risultato per il classificatore della modalità auto

2343 2343 

2344Restituisci `classifierContext` per inviare una breve nota sul risultato della chiamata allo strumento al classificatore della [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) anziché a Claude. Il classificatore [non riceve mai i risultati degli strumenti in sé](https://code.claude.com/docs/it/permission-modes.md#how-the-classifier-evaluates-actions), quindi questo campo è il modo supportato per comunicargli qualcosa su ciò che una chiamata ha restituito prima che esamini le azioni successive. Il campo richiede Claude Code v2.1.236 o successivo.2344Restituisci `classifierContext` per inviare una breve nota sul risultato della chiamata allo strumento al classificatore della [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) anziché a Claude. La nota serve al classificatore per la revisione delle azioni successive. Il campo richiede Claude Code v2.1.236 o versioni successive.

2345 2345 

2346L'esempio seguente indica al classificatore da dove proviene l'output di una query:2346L'esempio seguente indica al classificatore da dove proviene l'output di una query:

2347 2347 

47 47 

48Mentre una [variabile di credenziale del gateway](https://code.claude.com/docs/it/llm-gateway-connect.md#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ì.48Mentre una [variabile di credenziale del gateway](https://code.claude.com/docs/it/llm-gateway-connect.md#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ì.

49 49 

50[`ANTHROPIC_BASE_URL`](https://code.claude.com/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](https://code.claude.com/docs/it/llm-gateway-protocol.md#request-headers).50[`ANTHROPIC_BASE_URL`](https://code.claude.com/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 `Authorization` e la capacità OAuth in `anthropic-beta`; vedi il [riferimento delle intestazioni della richiesta](https://code.claude.com/docs/it/llm-gateway-protocol.md#request-headers).

51 51 

52## Pagine correlate52## Pagine correlate

53 53 

40 40 

41| Formato | Selezionato da | Endpoint | Inoltra invariato |41| Formato | Selezionato da | Endpoint | Inoltra invariato |

42| :- | :- | :- | :- |42| :- | :- | :- | :- |

43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (opzionale) | header di richiesta `anthropic-beta` e `anthropic-version` |43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (opzionale) | header di richiesta `anthropic-beta` e `anthropic-version`, più `Authorization` quando un [login claude.ai](#request-headers) autentica la richiesta verso Anthropic |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` con `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (opzionale) | campi del corpo della richiesta `anthropic_beta` e `anthropic_version` |44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` con `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (opzionale) | campi del corpo della richiesta `anthropic_beta` e `anthropic_version` |

45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` con `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (opzionale) | header di richiesta `anthropic-beta` e `anthropic-version`, e il campo del corpo della richiesta `anthropic_version` |45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` con `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (opzionale) | header di richiesta `anthropic-beta` e `anthropic-version`, e il campo del corpo della richiesta `anthropic_version` |

46 46 

115 115 

116## Intestazioni delle richieste116## Intestazioni delle richieste

117 117 

118Claude Code include queste intestazioni sulle richieste API. I nomi delle intestazioni non fanno distinzione tra maiuscole e minuscole sul filo. Inoltrare `anthropic-version` e `anthropic-beta` invariate, più `anthropic-workspace-id` quando l'upstream è [Claude Platform on AWS](https://code.claude.com/docs/it/claude-platform-on-aws.md); il resto il gateway può consumare per il routing, l'attribuzione e il tracciamento, e non è necessario inoltrare.118Claude Code include queste intestazioni sulle richieste API. I nomi delle intestazioni non fanno distinzione tra maiuscole e minuscole sul filo. Inoltra `anthropic-version` e `anthropic-beta` invariate, più `anthropic-workspace-id` quando l'upstream è [Claude Platform on AWS](https://code.claude.com/docs/it/claude-platform-on-aws.md). Inoltra anche `Authorization` quando il tuo gateway si autentica presso Anthropic con l'accesso claude.ai dello sviluppatore e non con una propria chiave. Il resto il gateway può consumarlo per il routing, l'attribuzione e il tracciamento, e non è necessario inoltrarlo.

119 119 

120| Intestazione | Descrizione |120| Intestazione | Descrizione |

121| :- | :- |121| :- | :- |

122| `Authorization`, `x-api-key` | La credenziale del gateway dello sviluppatore, in una o entrambe le intestazioni a seconda di quale [variabile di credenziale](https://code.claude.com/docs/it/llm-gateway-connect.md#set-the-credential-variable) impostano |122| `Authorization`, `x-api-key` | La credenziale del gateway dello sviluppatore, in una o entrambe le intestazioni a seconda di quale [variabile di credenziale](https://code.claude.com/docs/it/llm-gateway-connect.md#set-the-credential-variable) ha impostato. Con un accesso claude.ai e nessuna credenziale del gateway, `Authorization` porta il token dell'accesso |

123| `anthropic-version` | Versione API, attualmente `2023-06-01`. Le richieste in formato Amazon Bedrock e Agent Platform di Google Cloud portano anche il campo del corpo `anthropic_version`, il cui valore è la stringa del dialetto del provider, non il valore di questa intestazione |123| `anthropic-version` | Versione API, attualmente `2023-06-01`. Le richieste in formato Amazon Bedrock e Agent Platform di Google Cloud portano anche il campo del corpo `anthropic_version`, il cui valore è la stringa del dialetto del provider, non il valore di questa intestazione |

124| `anthropic-beta` | Valori di capacità separati da virgole per la richiesta. Inoltrare l'intestazione verbatim; non creare un elenco di consentiti dei singoli valori, perché l'insieme cambia con i rilasci di Claude Code. Quando lo sviluppatore si autentica con un accesso claude.ai, che è possibile quando `ANTHROPIC_BASE_URL` è impostato senza una variabile di credenziale del gateway, questa intestazione porta anche una capacità OAuth che l'upstream richiede, e rimuoverla fa fallire quelle richieste con `401` |124| `anthropic-beta` | Valori di capacità separati da virgole per la richiesta. Inoltrare l'intestazione verbatim; non creare un elenco di consentiti dei singoli valori, perché l'insieme cambia con i rilasci di Claude Code. Quando lo sviluppatore si autentica con un accesso claude.ai, che è possibile quando `ANTHROPIC_BASE_URL` è impostato senza una variabile di credenziale del gateway, questa intestazione porta anche una capacità OAuth che l'upstream richiede, e rimuoverla fa fallire quelle richieste con `401` |

125| `x-claude-code-session-id` | Un identificatore univoco per la sessione Claude Code corrente. Usarlo per aggregare tutte le richieste da una sessione senza analizzare i corpi delle richieste |125| `x-claude-code-session-id` | Un identificatore univoco per la sessione Claude Code corrente. Usarlo per aggregare tutte le richieste da una sessione senza analizzare i corpi delle richieste |

52* **Delivery controls**: [`policyHelper`](https://code.claude.com/docs/it/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/it/settings-reference#wslinheritswindowssettings), e [`managedSourcesBehavior`](https://code.claude.com/docs/it/settings-reference#managedsourcesbehavior)52* **Delivery controls**: [`policyHelper`](https://code.claude.com/docs/it/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/it/settings-reference#wslinheritswindowssettings), e [`managedSourcesBehavior`](https://code.claude.com/docs/it/settings-reference#managedsourcesbehavior)

53* **Gateway login keys**: [`forceLoginGatewayUrl`](https://code.claude.com/docs/it/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/it/settings-reference#gatewayinternalnetworks), e il valore `"gateway"` di [`forceLoginMethod`](https://code.claude.com/docs/it/settings-reference#forceloginmethod)53* **Gateway login keys**: [`forceLoginGatewayUrl`](https://code.claude.com/docs/it/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/it/settings-reference#gatewayinternalnetworks), e il valore `"gateway"` di [`forceLoginMethod`](https://code.claude.com/docs/it/settings-reference#forceloginmethod)

54 54 

55Un file di impostazioni gestite, un profilo MDM, o la console claude.ai applica una policy a tutti coloro che raggiunge. Per dare a un gruppo di sviluppatori una policy diversa, distribuisci un file o profilo diverso a quel gruppo; la console claude.ai [non può ancora indirizzare un gruppo](https://code.claude.com/docs/it/server-managed-settings.md#current-limitations), mentre un [Claude apps gateway](https://code.claude.com/docs/it/claude-apps-gateway) auto-ospitato distribuisce impostazioni gestite per gruppo IdP.55Con un file di impostazioni gestite o un profilo MDM, tutti coloro che raggiunge ricevono un'unica policy. Per dare a un gruppo di sviluppatori una policy diversa, distribuisci un file o profilo diverso a quel gruppo. Con un piano Enterprise, puoi anche [assegnare a ogni gruppo la propria configurazione](https://code.claude.com/docs/it/server-managed-settings.md#give-groups-different-settings) nelle impostazioni server-managed. Un [Claude apps gateway](https://code.claude.com/docs/it/claude-apps-gateway) auto-ospitato distribuisce impostazioni gestite per gruppo IdP.

56 56 

57Quando più di un meccanismo distribuisce una policy alla stessa macchina, Claude Code per impostazione predefinita ne usa uno e ignora gli altri. [How Claude Code combines managed sources](#how-claude-code-combines-managed-sources) fornisce l'ordine e l'opt-in che applica ogni fonte.57Quando più di un meccanismo distribuisce una policy alla stessa macchina, Claude Code per impostazione predefinita ne usa uno e ignora gli altri. [How Claude Code combines managed sources](#how-claude-code-combines-managed-sources) fornisce l'ordine e l'opt-in che applica ogni fonte.

58 58 

163 163 

164La forma inline imposta la variabile per quel singolo avvio in Bash o Zsh. Per mantenerla attiva per ogni sessione, aggiungila al blocco `env` in `~/.claude/settings.json` come mostrato in [Impostare le variabili d'ambiente](https://code.claude.com/docs/it/env-vars.md#set-environment-variables).164La forma inline imposta la variabile per quel singolo avvio in Bash o Zsh. Per mantenerla attiva per ogni sessione, aggiungila al blocco `env` in `~/.claude/settings.json` come mostrato in [Impostare le variabili d'ambiente](https://code.claude.com/docs/it/env-vars.md#set-environment-variables).

165 165 

166Questo carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md` dalla directory aggiuntiva. `CLAUDE.local.md` viene saltato se escludi `local` da [`--setting-sources`](https://code.claude.com/docs/it/cli-reference).166Con la variabile impostata, Claude Code carica i file `CLAUDE.md`, `.claude/CLAUDE.md`, `CLAUDE.local.md` e `.claude/rules/*.md` della directory aggiuntiva, tranne le regole che impostano un [campo `paths`](#path-specific-rules). `CLAUDE.local.md` viene saltato se escludi `local` da [`--setting-sources`](https://code.claude.com/docs/it/cli-reference).

167 167 

168### Organizza le regole con `.claude/rules/`168### Organizza le regole con `.claude/rules/`

169 169 

168 168 

169Consulta [Model is not a recognized model id](https://code.claude.com/docs/it/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/it/errors.md#model-not-found) per i messaggi.169Consulta [Model is not a recognized model id](https://code.claude.com/docs/it/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/it/errors.md#model-not-found) per i messaggi.

170 170 

171Se imposti il modello con il flag `--model`, la variabile d'ambiente `ANTHROPIC_MODEL` o l'impostazione `model`, Claude Code non rifiuta in anticipo un valore digitato in modo errato. La sessione si avvia e la prima richiesta produce [There's an issue with the selected model](https://code.claude.com/docs/it/errors.md#theres-an-issue-with-the-selected-model). Sull'API Anthropic, un valore che non inizia con `claude-` e corrisponde quasi al nome o all'alias di un modello può produrre anche un [avviso all'avvio che lo suggerisce](#fix-a-mistyped-model-name).171Se imposti il modello con il flag `--model`, la variabile d'ambiente `ANTHROPIC_MODEL` o l'impostazione `model`, Claude Code non rifiuta in anticipo un valore digitato in modo errato. La sessione si avvia e la prima richiesta produce [There's an issue with the selected model](https://code.claude.com/docs/it/errors.md#theres-an-issue-with-the-selected-model). Sull'API Anthropic, puoi vedere un [avviso che suggerisce il nome più vicino](#fix-a-mistyped-model-name) se il valore corrisponde quasi al nome o all'alias di un modello e non inizia con `claude-`.

172 172 

173Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che indica il modello richiesto. Le sessioni interattive lo mostrano come avviso all'avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](https://code.claude.com/docs/it/headless.md) quando si usa il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter di un subagent](https://code.claude.com/docs/it/sub-agents.md). L'avviso su stderr viene soppresso per `--output-format json` e `stream-json`; in questi casi leggi il modello effettivo dal campo `modelUsage` del [messaggio di risultato](https://code.claude.com/docs/it/headless.md#get-structured-output).173Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che indica il modello richiesto. Le sessioni interattive lo mostrano come avviso all'avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](https://code.claude.com/docs/it/headless.md) quando si usa il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter di un subagent](https://code.claude.com/docs/it/sub-agents.md). L'avviso su stderr viene soppresso per `--output-format json` e `stream-json`; in questi casi leggi il modello effettivo dal campo `modelUsage` del [messaggio di risultato](https://code.claude.com/docs/it/headless.md#get-structured-output).

174 174 

195}195}

196```196```

197 197 

198#### Correggere un nome di modello digitato in modo errato

199 

200Ciascuno di questi avvisi indica che Claude Code non riconosce l'ID del modello che hai impostato e che l'ID corrisponde quasi al nome o all'alias di un modello che invece riconosce:

201 

202```text theme={null}

203⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

204Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

205```

206 

207* **Hai digitato l'ID in modo errato**: sostituiscilo con il suggerimento [ovunque tu abbia impostato il modello](#setting-your-model)

208* **L'ID è intenzionale**: lascialo com'è. La sessione lo invia così come l'hai scritto. Se la finestra di contesto che Claude Code presume per esso è errata, [correggi la finestra](#correct-the-window-for-a-gateway-or-custom-model-id)

209 

198#### Impostare un modello predefinito per le nuove sessioni210#### Impostare un modello predefinito per le nuove sessioni

199 211 

200Imposta `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.212Imposta `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.

772| :- | :- |784| :- | :- |

773| Attiva/disattiva per la sessione corrente | Premi `Option+T` su macOS o `Alt+T` su Windows e Linux |785| Attiva/disattiva per la sessione corrente | Premi `Option+T` su macOS o `Alt+T` su Windows e Linux |

774| Imposta il predefinito globale | Esegui `/config` e attiva/disattiva la modalità di ragionamento. Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json` |786| Imposta il predefinito globale | Esegui `/config` e attiva/disattiva la modalità di ragionamento. Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json` |

775| Disattiva tramite una variabile d'ambiente | Imposta [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/it/env-vars), che disattiva il ragionamento su Anthropic API tranne che su Opus 5.5, Sonnet 5.5, Haiku 5.5 e sui modelli Fable. Sui [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md), Claude Code omette invece il parametro `thinking`, e i modelli con ragionamento adattivo potrebbero comunque ragionare |787| Disattiva tramite una variabile d'ambiente | Imposta [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/it/env-vars) |

788 

789Claude Code comprime l'output del ragionamento per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedere il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di ragionamento oscurati per impostazione predefinita, quindi imposta [`showThinkingSummaries: true`](https://code.claude.com/docs/it/settings-reference#showthinkingsummaries) nelle impostazioni se vuoi che i riassunti completi siano disponibili quando espandi. Ti vengono addebitati tutti i token di ragionamento generati, anche quando compressi o oscurati.

790 

791#### Dove non puoi disattivare il ragionamento

776 792 

777Non puoi disattivare il ragionamento su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable. L'opzione della sessione e la riga di `/config` mostrano `Thinking can't be turned off` per questi modelli invece di offrire l'interruttore, e un `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` salvato non ha effetto lì. Su questi modelli, il modello decide per ogni passo quanto ragionare in base al livello di sforzo. L'impostazione salvata si applica di nuovo quando passi a un modello che la accetta.793Non puoi disattivare il ragionamento su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable. L'opzione della sessione e la riga di `/config` mostrano `Thinking can't be turned off` per questi modelli invece di offrire l'interruttore, e un `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` salvato non ha effetto lì. Su questi modelli, il modello decide per ogni passo quanto ragionare in base al livello di sforzo. L'impostazione salvata si applica di nuovo quando passi a un modello che la accetta.

778 794 

779Claude Code comprime l'output del ragionamento per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedere il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di ragionamento oscurati per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](https://code.claude.com/docs/it/settings.md) se vuoi che i riassunti completi siano disponibili quando espandi. Ti vengono addebitati tutti i token di ragionamento generati, anche quando compressi o oscurati.795Per interrompere o ridurre il ragionamento, segui il passaggio per il tuo provider:

796 

797* **Anthropic API**: puoi disattivare il ragionamento su modelli come `claude-opus-5`, `claude-sonnet-5` e `claude-haiku-4-5`. Gli [alias](#model-aliases) come `sonnet` selezionano modelli su cui non puoi farlo, quindi [imposta il modello](#setting-your-model) tramite il suo ID.

798* **[Provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md)**: su provider come Amazon Bedrock e Microsoft Foundry, i modelli con [ragionamento adattivo](#adaptive-reasoning-and-fixed-thinking-budgets) potrebbero comunque ragionare con il ragionamento disattivato. [Abbassa il livello di sforzo](#set-the-effort-level) per ridurre il ragionamento.

780 799 

781### Contesto esteso800### Contesto esteso

782 801 

900 919 

901Una volta che Claude Code riconosce l'ID o usa la finestra che gli hai fornito, l'avviso non compare più quando avvii una sessione su quell'ID.920Una volta che Claude Code riconosce l'ID o usa la finestra che gli hai fornito, l'avviso non compare più quando avvii una sessione su quell'ID.

902 921 

903#### Correggere un nome di modello digitato male

904 

905Uno qualsiasi di questi avvisi significa che Claude Code non riconosce l'ID modello che hai impostato, e che l'ID corrisponde quasi a un nome o alias di modello che invece riconosce:

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **Hai digitato male l'ID**: sostituiscilo con il suggerimento [ovunque imposti il modello](#setting-your-model)

913* **L'ID è intenzionale**: lascialo così com'è. La sessione lo invia come lo hai scritto. Se la finestra di contesto che Claude Code assume per esso è errata, [correggi la finestra](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

915#### A quali ID si applica `CLAUDE_CODE_MAX_CONTEXT_TOKENS`922#### A quali ID si applica `CLAUDE_CODE_MAX_CONTEXT_TOKENS`

916 923 

917Su un [LLM gateway](https://code.claude.com/docs/it/llm-gateway) o un altro deploy personalizzato, Claude Code può assumere una finestra di contesto per l'ID modello che differisce dalla finestra reale del modello, indipendentemente dal fatto che risolva l'ID a un modello Claude o meno. Imposta [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/it/env-vars) alla finestra che Claude Code dovrebbe assumere invece.924Su un [LLM gateway](https://code.claude.com/docs/it/llm-gateway) o un altro deploy personalizzato, Claude Code può assumere una finestra di contesto per l'ID modello che differisce dalla finestra reale del modello, indipendentemente dal fatto che risolva l'ID a un modello Claude o meno. Imposta [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/it/env-vars) alla finestra che Claude Code dovrebbe assumere invece.

710* `skill.name`: Skill attiva per la richiesta, impostata dallo strumento Skill o da un comando `/`, oppure ereditata da un subagent generato. I nomi delle skill integrate, incluse nel pacchetto, definite dall'utente e dei plugin del marketplace ufficiale compaiono testualmente. I nomi delle skill dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando nessuna skill è attiva.710* `skill.name`: Skill attiva per la richiesta, impostata dallo strumento Skill o da un comando `/`, oppure ereditata da un subagent generato. I nomi delle skill integrate, incluse nel pacchetto, definite dall'utente e dei plugin del marketplace ufficiale compaiono testualmente. I nomi delle skill dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando nessuna skill è attiva.

711* `plugin.name`: Plugin proprietario quando la skill o il subagent attivo è fornito da un plugin. I nomi dei plugin del marketplace ufficiale compaiono testualmente. I nomi dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando né la skill né il subagent hanno un plugin proprietario.711* `plugin.name`: Plugin proprietario quando la skill o il subagent attivo è fornito da un plugin. I nomi dei plugin del marketplace ufficiale compaiono testualmente. I nomi dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando né la skill né il subagent hanno un plugin proprietario.

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

713* `mcp_server.name`: Server MCP il cui risultato dello strumento è stato consumato da questa richiesta. I nomi dei server integrati, tramite proxy di claude.ai e del registro ufficiale compaiono testualmente. I nomi dei server configurati dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non ha consumato alcun risultato di uno strumento MCP. Prima della v2.1.222, Claude Code impostava questo attributo su ogni richiesta successiva a una chiamata a uno strumento MCP, non solo sulle richieste che consumavano un risultato dello strumento, quindi le dashboard che lo aggregano mostrano un calo dopo l'aggiornamento.713* `mcp_server.name`: Server MCP il cui risultato di strumento è stato consumato da questa richiesta. I nomi dei server integrati, tramite proxy di claude.ai e del registro ufficiale appaiono testualmente. I nomi dei server configurati dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non ha consumato alcun risultato di strumento MCP. Prima della v2.1.222, Claude Code impostava questo attributo su ogni richiesta successiva a una chiamata a uno strumento MCP, non solo sulle richieste che consumavano un risultato di strumento, quindi le dashboard che lo aggregano mostrano un calo dopo l'aggiornamento.

714* `mcp_tool.name`: Strumento MCP il cui risultato è stato consumato da questa richiesta, con lo stesso comportamento di oscuramento e di versione di `mcp_server.name`. Assente quando la richiesta non ha consumato alcun risultato di uno strumento MCP.714 * Dalla v2.1.312, anche il nome di un server remoto con URL fisso dichiarato da un plugin del marketplace ufficiale di Anthropic appare testualmente, come `plugin_<plugin>_<server>`. Quel nome viene sostituito con `"custom"` quando la copia del plugin nel marketplace non proviene dalla fonte registrata di Anthropic, come una montata da una directory seed in una sessione cloud.

715* `mcp_tool.name`: Strumento MCP il cui risultato è stato consumato da questa richiesta, con lo stesso comportamento di oscuramento e di versione di `mcp_server.name`, tranne per il fatto che può riportare `"custom"` quando `mcp_server.name` mostra un nome `plugin_<plugin>_<server>`. Assente quando la richiesta non ha consumato alcun risultato di strumento MCP.

715 716 

716#### Contatore dei token717#### Contatore dei token

717 718 

998 * Una concessione per il resto della sessione, data in una precedente richiesta di permesso nella stessa sessione interattiva della CLI999 * Una concessione per il resto della sessione, data in una precedente richiesta di permesso nella stessa sessione interattiva della CLI

999 * Lo strumento intrinsecamente sicuro1000 * Lo strumento intrinsecamente sicuro

1000 1001 

1001 Il valore `source` non indica quale di queste origini ha avuto corrispondenza. Per scoprire quale ha rifiutato una chiamata, cerca l'[evento di sicurezza](#safety-event) con lo stesso `tool_use_id` e leggi i suoi attributi `category` e `rule_source`. Alcune chiamate rifiutate [non hanno un evento di sicurezza](#calls-without-a-safety-event).1002 Il valore di `source` non indica quale di queste fonti è stata applicata. Quando `classifier_verdict` è presente, indica l'esito del classificatore che ha deciso la chiamata. Nessun attributo di `tool_decision` indica la regola di permesso o l'impostazione che ha rifiutato la chiamata.

1002 1003 

1003 Claude Code riporta `"config"` anche quando la richiesta di permesso stessa non riesce. Ad esempio, quella richiesta non riesce quando il callback [`canUseTool`](https://code.claude.com/docs/it/agent-sdk/typescript#canusetool) dell'Agent SDK o lo strumento [`--permission-prompt-tool`](https://code.claude.com/docs/it/cli-reference#cli-flags) restituisce un risultato non valido, o quando lo stream di input si chiude mentre la richiesta è in sospeso.1004 Claude Code riporta `"config"` anche quando la richiesta di permesso stessa non riesce. Ad esempio, quella richiesta non riesce quando il callback [`canUseTool`](https://code.claude.com/docs/it/agent-sdk/typescript#canusetool) dell'Agent SDK o lo strumento [`--permission-prompt-tool`](https://code.claude.com/docs/it/cli-reference#cli-flags) restituisce un risultato non valido, o quando lo stream di input si chiude mentre la richiesta è in sospeso.

1004 * `"hook"`: Un hook `PreToolUse` o `PermissionRequest` ha restituito la decisione.1005 * `"hook"`: Un hook `PreToolUse` o `PermissionRequest` ha restituito la decisione.

1046 1047 

1047#### Evento di sicurezza1048#### Evento di sicurezza

1048 1049 

1049Registrato quando un controllo rifiuta una chiamata a uno strumento o richiede una richiesta di permesso, eccetto per le [chiamate senza un evento di sicurezza](#calls-without-a-safety-event). Registrato anche quando il [proxy di rete della sandbox](https://code.claude.com/docs/it/sandboxing.md#network-isolation) rifiuta una connessione o una richiesta, e quando un hook blocca un risultato. Richiede Claude Code v2.1.307 o successiva.1050Claude Code ha smesso di inviare `claude_code.safety_event`:

1051 

1052* **v2.1.312 e successive**: queste versioni non inviano l'evento e nessuna impostazione lo attiva

1053* **Dalla v2.1.307 alla v2.1.311**: una sessione smette di inviare l'evento al successivo aggiornamento dei feature flag. Una sessione che non [recupera i feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching), ad esempio su Amazon Bedrock, Agent Platform di Google Cloud o Microsoft Foundry, può continuare a inviarlo.

1054 

1055Per vedere le chiamate agli strumenti rifiutate, interroga gli eventi [`tool_decision`](#tool-decision-event), che mostrano che una chiamata è stata rifiutata ma non sempre quale controllo l'ha rifiutata.

1056 

1057I dettagli dell'evento riportati qui descrivono gli eventi dalla v2.1.307 alla v2.1.311, in cui un evento di sicurezza registra [casi](#safety-event-categories) come questi:

1058 

1059* Un controllo rifiuta una chiamata a uno strumento o richiede una richiesta di permesso, tranne per le [chiamate senza un evento di sicurezza](#calls-without-a-safety-event)

1060* Il [proxy di rete della sandbox](https://code.claude.com/docs/it/sandboxing.md#network-isolation) rifiuta una connessione o una richiesta

1061* Un hook blocca un risultato o la fine di un turno

1050 1062 

1051L'evento viene esportato insieme agli altri eventi e non ha un'impostazione separata. Gli attributi propri dell'evento non contengono testo dei comandi, percorsi di file, nomi host né nomi di server e strumenti MCP. Il record riporta anche gli [attributi standard](#standard-attributes) presenti in ogni evento, che possono includere `workspace.host_paths` e gli [attributi del repository](#repository-attributes). Per vedere il comando o lo strumento MCP dietro un evento, imposta `OTEL_LOG_TOOL_DETAILS=1` e leggi `tool_parameters` nell'evento `tool_decision` corrispondente.1063L'evento viene esportato insieme agli altri eventi e non ha un'impostazione separata. Gli attributi propri dell'evento non contengono testo dei comandi, percorsi di file, nomi host né nomi di server e strumenti MCP. Il record riporta anche gli [attributi standard](#standard-attributes) presenti in ogni evento, che possono includere `workspace.host_paths` e gli [attributi del repository](#repository-attributes). Per vedere il comando o lo strumento MCP dietro un evento, imposta `OTEL_LOG_TOOL_DETAILS=1` e leggi `tool_parameters` nell'evento `tool_decision` corrispondente.

1052 1064 

1663 1675 

1664### Mappa le domande di sicurezza agli eventi1676### Mappa le domande di sicurezza agli eventi

1665 1677 

1678Le righe relative a `safety_event` si applicano solo a una sessione sulle versioni dalla v2.1.307 alla v2.1.311 che [invia ancora l'evento](#safety-event).

1679 

1666Quando costruite regole di rilevamento, cercate il segnale che volete monitorare e interrogate il vostro backend per l'evento corrispondente e gli attributi:1680Quando costruite regole di rilevamento, cercate il segnale che volete monitorare e interrogate il vostro backend per l'evento corrispondente e gli attributi:

1667 1681 

1668| Segnale | Evento | Attributi chiave |1682| Segnale | Evento | Attributi chiave |

1672| Il classificatore della modalità auto ha consentito o bloccato una chiamata a uno strumento, oppure Claude Code ha negato la chiamata senza un verdetto del classificatore | [`tool_decision`](#tool-decision-event) in cui è presente `classifier_verdict`. Per un diniego senza verdetto, `classifier_verdict` è `"no_verdict"` o `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name`; `classifier_category` quando imposti `OTEL_LOG_TOOL_DETAILS=1` |1686| Il classificatore della modalità auto ha consentito o bloccato una chiamata a uno strumento, oppure Claude Code ha negato la chiamata senza un verdetto del classificatore | [`tool_decision`](#tool-decision-event) in cui è presente `classifier_verdict`. Per un diniego senza verdetto, `classifier_verdict` è `"no_verdict"` o `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name`; `classifier_category` quando imposti `OTEL_LOG_TOOL_DETAILS=1` |

1673| Escalation della modalità di autorizzazione | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |1687| Escalation della modalità di autorizzazione | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |

1674| In quale modalità di permesso è stata verificata ogni chiamata a uno strumento, incluse le chiamate effettuate dai subagent | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |1688| In quale modalità di permesso è stata verificata ogni chiamata a uno strumento, incluse le chiamate effettuate dai subagent | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |

1675| Hook della politica ha bloccato un'azione | `hook_execution_complete` | `hook_event`, `num_blocking` |1689| Un hook di policy ha bloccato un'azione | `hook_execution_complete`, che non è legato a una chiamata né a `tool_use_id` | `hook_event`, `num_blocking` |

1676| Quale chiamata a uno strumento è stata rifiutata da un hook, e quale risultato o fine del turno è stato bloccato da un hook | [`safety_event`](#safety-event) in cui `category` è `"hook"` e `decision` è `"reject"` per una chiamata rifiutata, oppure `category` è `"hook_review"` per un risultato o una fine del turno bloccati | `category`, `decision`, `hook_event`; `tool_use_id` per una chiamata a uno strumento |1690| Chiamata a uno strumento rifiutata da un hook | [`tool_decision`](#tool-decision-event) in cui `decision` è `"reject"` e `source` è `"hook"` | `decision`, `source`, `tool_use_id` |

1691| Quale risultato o fine del turno è stato bloccato da un hook | [`safety_event`](#safety-event) in cui `category` è `"hook_review"` | `category`, `hook_event`; `tool_use_id` per una chiamata a uno strumento |

1677| Il proxy di rete della sandbox ha rifiutato una connessione o una richiesta da un comando Bash o PowerShell | [`safety_event`](#safety-event) in cui `sandbox_violation_count` è presente e non è `"0"` | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |1692| Il proxy di rete della sandbox ha rifiutato una connessione o una richiesta da un comando Bash o PowerShell | [`safety_event`](#safety-event) in cui `sandbox_violation_count` è presente e non è `"0"` | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |

1678| Login, logout e guasto di autenticazione | `auth` | `action`, `success`, `error_category` |1693| Login, logout e guasto di autenticazione | `auth` | `action`, `success`, `error_category` |

1679| Connessione del server MCP o guasto | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |1694| Connessione del server MCP o guasto | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |

25 25 

26La modalità che rivede ogni azione si chiama **Manual** nella CLI, in `claude --help`, nelle estensioni VS Code e JetBrains e nell'app desktop. Il suo valore di configurazione è `default`, ed è quello usato dagli hook e dalle integrazioni SDK. La CLI accetta `manual` come alias ovunque tu digiti il valore, ad esempio `claude --permission-mode manual` o `"defaultMode": "manual"`.26La modalità che rivede ogni azione si chiama **Manual** nella CLI, in `claude --help`, nelle estensioni VS Code e JetBrains e nell'app desktop. Il suo valore di configurazione è `default`, ed è quello usato dagli hook e dalle integrazioni SDK. La CLI accetta `manual` come alias ovunque tu digiti il valore, ad esempio `claude --permission-mode manual` o `"defaultMode": "manual"`.

27 27 

28Le scritture nei [percorsi protetti](#protected-paths) non vengono mai approvate automaticamente, tranne in modalità `bypassPermissions` e nelle sessioni in plan mode in cui bypass permissions è disponibile, ovvero le sessioni interattive nel terminale avviate in un modo che [inserisce `bypassPermissions` nel ciclo delle modalità](#switch-permission-modes).28Ogni modalità ha una propria regola per le scritture nei [percorsi protetti](#protected-paths).

29 29 

30Le modalità definiscono la base. Aggiungi sopra di esse delle [regole di permesso](https://code.claude.com/docs/it/permissions.md#manage-permissions) per pre-approvare o bloccare strumenti specifici. Le regole deny bloccano in ogni modalità, incluso `bypassPermissions`. Le regole deny e ask non si applicano a [`EndConversation`](https://code.claude.com/docs/it/tools-reference#endconversation-tool-behavior) finché Claude dispone ancora di almeno un altro strumento che può chiamare. Le regole allow non hanno alcun effetto in `bypassPermissions`.30Le modalità definiscono la base. Aggiungi sopra di esse delle [regole di permesso](https://code.claude.com/docs/it/permissions.md#manage-permissions) per pre-approvare o bloccare strumenti specifici. Le regole deny bloccano in ogni modalità, incluso `bypassPermissions`. Le regole deny e ask non si applicano a [`EndConversation`](https://code.claude.com/docs/it/tools-reference#endconversation-tool-behavior) finché Claude dispone ancora di almeno un altro strumento che può chiamare. Le regole allow non hanno alcun effetto in `bypassPermissions`.

31 31 

484* Apertura di una pull request verso un repository o un'organizzazione diversi, fork con `gh repo fork`, o push a un repository di terze parti, a meno che tu non abbia nominato quel target esterno484* Apertura di una pull request verso un repository o un'organizzazione diversi, fork con `gh repo fork`, o push a un repository di terze parti, a meno che tu non abbia nominato quel target esterno

485* Contenuto proveniente da un archivio locale sensibile, o da un file il cui nome, percorso o tipo lo identifica come sensibile, che finisce in un commit, un push, il testo di una PR o issue, un gist o paste, o una pubblicazione di pacchetto, a meno che tu non abbia nominato sia la fonte che la destinazione. Le trascrizioni di sessione e i log di conversazione, le cartelle nascoste di credenziali e configurazione come chiavi SSH, credenziali cloud, profili del browser e cronologia della shell, e gli export di dati utente contano tutti, e il fatto che il repository sia privato non rimuove il blocco485* Contenuto proveniente da un archivio locale sensibile, o da un file il cui nome, percorso o tipo lo identifica come sensibile, che finisce in un commit, un push, il testo di una PR o issue, un gist o paste, o una pubblicazione di pacchetto, a meno che tu non abbia nominato sia la fonte che la destinazione. Le trascrizioni di sessione e i log di conversazione, le cartelle nascoste di credenziali e configurazione come chiavi SSH, credenziali cloud, profili del browser e cronologia della shell, e gli export di dati utente contano tutti, e il fatto che il repository sia privato non rimuove il blocco

486* Scrittura nelle trascrizioni di sessione di Claude Code, i file di cronologia `.jsonl` sotto `~/.claude/projects/` o la directory di configurazione che hai configurato, direttamente o tramite un comando della shell. La regola copre anche le righe di metadati che Claude Code aggiunge a ogni voce della trascrizione per i propri controlli. La lettura di una trascrizione non è bloccata486* Scrittura nelle trascrizioni di sessione di Claude Code, i file di cronologia `.jsonl` sotto `~/.claude/projects/` o la directory di configurazione che hai configurato, direttamente o tramite un comando della shell. La regola copre anche le righe di metadati che Claude Code aggiunge a ogni voce della trascrizione per i propri controlli. La lettura di una trascrizione non è bloccata

487* Un'eliminazione forzata ricorsiva come `rm -rf "$VAR"` o `Remove-Item -Recurse -Force $dir` il cui target è una variabile della shell non assegnata in nessun punto della conversazione che il classificatore vede, o un glob radicato in tale variabile. Il valore proveniva solo dall'output di un comando precedente, che il classificatore non riceve mai, quindi il classificatore non può verificare il target dell'eliminazione rispetto alle altre regole di eliminazione. Il blocco viene rimosso quando nomini il percorso esatto da eliminare, 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.487* Un'eliminazione forzata ricorsiva come `rm -rf "$VAR"` o `Remove-Item -Recurse -Force $dir` il cui target è una variabile della shell non assegnata nella conversazione che il classificatore vede, o un glob radicato in tale variabile. Senza quell'assegnazione, il classificatore non può sapere cosa eliminerebbe il comando.

488 488 

489 Un glob direttamente sotto la variabile, come in `rm -rf "$VAR"/*`, è invece un [percorso critico](#critical-paths). I target di `Remove-Item` che sono un `*` isolato o terminano in `/*` o `\*` non raggiungono mai il classificatore: Claude Code li [nega direttamente](#remove-item-in-powershell).489 Il blocco viene rimosso quando nomini il percorso esatto da eliminare, 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.

490 

491 Un glob direttamente sotto la variabile, come in `rm -rf "$VAR"/*`, è invece un [percorso critico](#critical-paths). Per un target di `Remove-Item` che è un `*` isolato o termina in `/*` o `\*`, vedi [Remove-Item in PowerShell](#remove-item-in-powershell): Claude Code nega direttamente quel comando.

490 492 

491Diverse di queste categorie dipendono da voci di [ambiente](https://code.claude.com/docs/it/auto-mode-config.md#define-trusted-infrastructure), come target remoti sensibili e ambiti IaC protetti, che puoi restringere a nomi concreti.493Diverse di queste categorie dipendono da voci di [ambiente](https://code.claude.com/docs/it/auto-mode-config.md#define-trusted-infrastructure), come target remoti sensibili e ambiti IaC protetti, che puoi restringere a nomi concreti.

492 494 

730 732 

731## Percorsi protetti733## Percorsi protetti

732 734 

733Le scritture in un piccolo insieme di percorsi non vengono mai auto-approvate, tranne in modalità `bypassPermissions` e nelle sessioni di terminale interattivo in modalità plan dove le [autorizzazioni di bypass](#skip-all-checks-with-bypasspermissions-mode) sono disponibili. Ciò previene la corruzione accidentale dello stato del repository e della configurazione di Claude.735Un piccolo insieme di percorsi contiene lo stato del repository e la configurazione di Claude stesso, quindi ogni modalità ha una propria regola per le scritture su di essi:

734 736 

735| Modalità | Scritture su percorsi protetti |737| Modalità | Scritture su percorsi protetti |

736| :- | :- |738| :- | :- |

737| `default`, `acceptEdits` | Richiesta di conferma |739| `default`, `acceptEdits` | Richiesta di conferma |

738| `plan` | Consentito nelle sessioni di terminale interattivo con [autorizzazioni di bypass](#skip-all-checks-with-bypasspermissions-mode) disponibili. Altrimenti, instradato al classificatore quando [la modalità auto](#eliminate-prompts-with-auto-mode) è disponibile durante la pianificazione, e con richiesta di conferma quando non lo è |740| `plan` | Consentito nelle sessioni di terminale interattivo con [autorizzazioni di bypass](#skip-all-checks-with-bypasspermissions-mode) disponibili. Altrimenti, instradato al classificatore quando [la modalità auto](#eliminate-prompts-with-auto-mode) è disponibile durante la pianificazione, e con richiesta di conferma quando non lo è |

739| `auto` | Instradato al classificatore |741| `auto` | Instradato al classificatore, che decide |

740| `dontAsk` | Negato |742| `dontAsk` | Negato |

741| `bypassPermissions` | Consentito |743| `bypassPermissions` | Consentito |

742 744 

185| `disableSideloadFlags` | Rifiuta all'avvio `--plugin-dir`, `--plugin-url`, `--agents`, l'opzione `plugins` dell'Agent SDK e le cartelle indicate nella variabile [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/it/env-vars#variables), e anche `--mcp-config` a meno che ogni server al suo interno non sia una voce in-process `type: "sdk"`. Rifiuta le cartelle di plugin che un'applicazione Agent SDK aggiunge durante la sessione con [`addPlugins`](https://code.claude.com/docs/it/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) | Non limita `.mcp.json`, `claude mcp add` o i server forniti dall'SDK. Abbinalo a [`allowedMcpServers`](https://code.claude.com/docs/it/managed-mcp) |185| `disableSideloadFlags` | Rifiuta all'avvio `--plugin-dir`, `--plugin-url`, `--agents`, l'opzione `plugins` dell'Agent SDK e le cartelle indicate nella variabile [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/it/env-vars#variables), e anche `--mcp-config` a meno che ogni server al suo interno non sia una voce in-process `type: "sdk"`. Rifiuta le cartelle di plugin che un'applicazione Agent SDK aggiunge durante la sessione con [`addPlugins`](https://code.claude.com/docs/it/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) | Non limita `.mcp.json`, `claude mcp add` o i server forniti dall'SDK. Abbinalo a [`allowedMcpServers`](https://code.claude.com/docs/it/managed-mcp) |

186| `disableCommandPluginSources` | Blocca i plugin con una fonte `command` dall'installazione, aggiornamento o caricamento. Una fonte `command` è quella il cui directory di plugin è prodotto eseguendo un comando sulla macchina. Quando non impostato, assume il valore di `allowManagedHooksOnly` | Non influisce su altri tipi di fonte |186| `disableCommandPluginSources` | Blocca i plugin con una fonte `command` dall'installazione, aggiornamento o caricamento. Una fonte `command` è quella il cui directory di plugin è prodotto eseguendo un comando sulla macchina. Quando non impostato, assume il valore di `allowManagedHooksOnly` | Non influisce su altri tipi di fonte |

187| `allowManagedHooksOnly` | Limita quali hook vengono eseguiti. Vedere [`allowManagedHooksOnly`](https://code.claude.com/docs/it/settings-reference#allowmanagedhooksonly) | Non si fida degli hook dai plugin che gli utenti abilitano da soli |187| `allowManagedHooksOnly` | Limita quali hook vengono eseguiti. Vedere [`allowManagedHooksOnly`](https://code.claude.com/docs/it/settings-reference#allowmanagedhooksonly) | Non si fida degli hook dai plugin che gli utenti abilitano da soli |

188| `strictPluginOnlyCustomization` | Blocca skill, agenti, hook e server MCP che non provengono da un plugin, dalle impostazioni gestite o dai componenti integrati di Claude Code. Impedisce anche il caricamento dei [plugin skills-directory](#keep-skills-directory-plugins-loading). Imposta `true` per coprire tutti e quattro i tipi, o un array di valori `skills`, `agents`, `hooks` e `mcp` come `["skills", "hooks"]` per coprirne alcuni | Non limita quali plugin installano gli utenti. Abbinalo a `strictKnownMarketplaces` |188| `strictPluginOnlyCustomization` | Blocca skill, agenti, hook e server MCP provenienti da fonti utente e di progetto. Impedisce anche il caricamento dei [plugin skills-directory](#keep-skills-directory-plugins-loading). Imposta `true` per coprire tutti e quattro i tipi, o un array di valori `skills`, `agents`, `hooks` e `mcp` come `["skills", "hooks"]` per coprirne alcuni | Non limita quali plugin installano gli utenti, né rifiuta i flag della CLI che caricano lateralmente plugin, agenti e server MCP. Abbinalo a `strictKnownMarketplaces` e `disableSideloadFlags` |

189| `pluginSuggestionMarketplaces` | Marketplace i cui plugin possono apparire come suggerimenti di installazione nel terminale. Consulta [Consigliare plugin](#recommend-plugins) | Non influisce sui suggerimenti integrati |189| `pluginSuggestionMarketplaces` | Marketplace i cui plugin possono apparire come suggerimenti di installazione nel terminale. Consulta [Consigliare plugin](#recommend-plugins) | Non influisce sui suggerimenti integrati |

190| `pluginTrustMessage` | Aggiunge il vostro testo all'avviso di fiducia che `/plugin` mostra prima che un plugin si installi | Non cambia il testo dell'avviso stesso |190| `pluginTrustMessage` | Aggiunge il vostro testo all'avviso di fiducia che `/plugin` mostra prima che un plugin si installi | Non cambia il testo dell'avviso stesso |

191| `allowedChannelPlugins` | Sostituisce l'elenco predefinito di plugin autorizzati a inviare messaggi di canale. Richiede `channelsEnabled: true` | Vedere [Limitare quali plugin di canale possono essere eseguiti](https://code.claude.com/docs/it/channels.md#restrict-which-channel-plugins-can-run) |191| `allowedChannelPlugins` | Sostituisce l'elenco predefinito di plugin autorizzati a inviare messaggi di canale. Richiede `channelsEnabled: true` | Vedere [Limitare quali plugin di canale possono essere eseguiti](https://code.claude.com/docs/it/channels.md#restrict-which-channel-plugins-can-run) |

336 336 

337### Assegnare canali di rilascio ai gruppi di utenti337### Assegnare canali di rilascio ai gruppi di utenti

338 338 

339Per eseguire canali stabili e ad accesso anticipato, ospitare due marketplace che puntano a ref diversi degli stessi plugin. Quindi assegnare a ogni gruppo di utenti il proprio marketplace attraverso impostazioni gestite da endpoint separate o una politica gateway. Le impostazioni gestite dal server dalla console di amministrazione [si applicano a ogni utente della tua organizzazione](https://code.claude.com/docs/it/server-managed-settings.md#current-limitations), quindi non possono assegnare impostazioni diverse a gruppi diversi.339Per eseguire canali stabili e ad accesso anticipato, ospita due marketplace che puntano a ref diversi degli stessi plugin. Quindi assegna a ogni gruppo di utenti il proprio marketplace attraverso impostazioni gestite da endpoint separate o una politica gateway. Con un piano Enterprise, puoi anche usare le impostazioni gestite dal server dalla console di amministrazione.

340 340 

341* Distribuire [impostazioni gestite da endpoint](https://code.claude.com/docs/it/managed-settings.md#delivery-mechanisms) separate, come un file di impostazioni gestite o un profilo MDM, ai dispositivi di ogni gruppo. Per verificare se il file o il profilo per gruppo si applica su un dispositivo che ha anche un'origine a livello di organizzazione, consultare [Come Claude Code combina le origini gestite](https://code.claude.com/docs/it/managed-settings.md#precedence-within-the-managed-tier).341* Distribuire [impostazioni gestite da endpoint](https://code.claude.com/docs/it/managed-settings.md#delivery-mechanisms) separate, come un file di impostazioni gestite o un profilo MDM, ai dispositivi di ogni gruppo. Per verificare se il file o il profilo per gruppo si applica su un dispositivo che ha anche un'origine a livello di organizzazione, consultare [Come Claude Code combina le origini gestite](https://code.claude.com/docs/it/managed-settings.md#precedence-within-the-managed-tier).

342* Definisci una [politica gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway-config.md#managed) per ogni gruppo. Per impostazione predefinita, il gateway applica la prima politica la cui regola di corrispondenza si adatta a un utente, quindi ordina le politiche in modo che ogni utente raggiunga la politica del suo gruppo. Della mappa `extraKnownMarketplaces` di quella politica non viene fatto il merge con quella di nessun'altra politica, quindi elenca in essa ogni marketplace di cui il gruppo ha bisogno, non solo il suo marketplace del canale.342* Definisci una [politica gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway-config.md#managed) per ogni gruppo. Per impostazione predefinita, il gateway applica la prima politica la cui regola di corrispondenza si adatta a un utente, quindi ordina le politiche in modo che ogni utente raggiunga la politica del suo gruppo. Della mappa `extraKnownMarketplaces` di quella politica non viene fatto il merge con quella di nessun'altra politica, quindi elenca in essa ogni marketplace di cui il gruppo ha bisogno, non solo il suo marketplace del canale.

343* Con un piano Enterprise, [assegna a ogni gruppo la propria configurazione](https://code.claude.com/docs/it/server-managed-settings.md#give-groups-different-settings) nella console di amministrazione. Della configurazione di un gruppo non viene fatto il merge con quella a livello di organizzazione, quindi inserisci ogni impostazione di cui il gruppo ha bisogno nella configurazione del gruppo stesso, incluso ogni marketplace.

343 344 

344Con uno dei due meccanismi, il gruppo stabile riceve questa configurazione:345Con uno qualsiasi di questi meccanismi, il gruppo stabile riceve questa impostazione:

345 346 

346```json theme={null}347```json theme={null}

347{348{

383 384 

384Queste richieste dalle revisioni di sicurezza non hanno una chiave dedicata nello schema delle impostazioni corrente. I controlli esistenti più vicini sono:385Queste richieste dalle revisioni di sicurezza non hanno una chiave dedicata nello schema delle impostazioni corrente. I controlli esistenti più vicini sono:

385 386 

386* **Targeting per utente o per gruppo**: ogni chiave plugin si applica a ogni utente che riceve le impostazioni. Le impostazioni gestite dal server forniscono una configurazione per organizzazione. Per la politica per gruppo, utilizzare impostazioni gestite da endpoint separate o politiche gateway, come in [Assegnare canali di rilascio ai gruppi di utenti](#assign-release-channels-to-user-groups).387* **Targeting per utente o per gruppo**: ogni chiave plugin si applica a ogni utente che riceve le impostazioni. Per una policy per gruppo, fornisci a ciascun gruppo le proprie impostazioni, come descritto in [Assegnare canali di rilascio ai gruppi di utenti](#assign-release-channels-to-user-groups).

387* **Limitazione delle voci all'interno di un marketplace consentito**: l'elenco consentito corrisponde alle fonti del marketplace. Per bloccare un plugin da un marketplace consentito, impostarlo su `false` in `enabledPlugins` gestito.388* **Limitazione delle voci all'interno di un marketplace consentito**: l'elenco consentito corrisponde alle fonti del marketplace. Per bloccare un plugin da un marketplace consentito, impostarlo su `false` in `enabledPlugins` gestito.

388* **Nascondere `/plugin`**: nessuna chiave disabilita il comando. L'equivalente più vicino combina un elenco consentito che nomina solo il vostro marketplace, voci `enabledPlugins` gestite per i plugin che fornite, e `disableSideloadFlags`.389* **Nascondere `/plugin`**: nessuna chiave disabilita il comando. L'equivalente più vicino combina un elenco consentito che nomina solo il vostro marketplace, voci `enabledPlugins` gestite per i plugin che fornite, e `disableSideloadFlags`.

389* **Controllare `--plugin-dir` attraverso l'elenco consentito**: l'elenco consentito non copre `--plugin-dir`. `disableSideloadFlags` lo fa.390* **Controllare `--plugin-dir` attraverso l'elenco consentito**: l'elenco consentito non copre `--plugin-dir`. `disableSideloadFlags` lo fa.

31>31>

32> **macOS, Linux, WSL:**32> **macOS, Linux, WSL:**

33>33>

34> ```bash theme={null}34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell:**40> **Windows PowerShell:**

41>41>

42> ```powershell theme={null}42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD:**46> **Windows CMD:**

47>47>

48> ```batch theme={null}48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

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>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

66> ```bash theme={null}66> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null}78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

257 257 

258| Comando | Cosa fa | Esempio |258| Comando | Cosa fa | Esempio |

259| - | - | - |259| - | - | - |

260| `/clear` | Cancella la cronologia della conversazione | `/clear` |260| `/clear` | Avvia una nuova conversazione. Riprendi quella precedente con `/resume`. | `/clear` |

261| `/help` | Mostra i comandi disponibili | `/help` |261| `/help` | Mostra i comandi disponibili | `/help` |

262| `/exit` o Ctrl+D due volte | Esci da Claude Code | `/exit` |262| `/exit` o Ctrl+D due volte | Esci da Claude Code | `/exit` |

263 263 

33 * Punti [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/it/env-vars) a un host diverso da `api.anthropic.com`, come un [gateway LLM](https://code.claude.com/docs/it/llm-gateway) o proxy. Annulla l'impostazione della variabile per utilizzare Remote Control.33 * Punti [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/it/env-vars) a un host diverso da `api.anthropic.com`, come un [gateway LLM](https://code.claude.com/docs/it/llm-gateway) o proxy. Annulla l'impostazione della variabile per utilizzare Remote Control.

34 * Accedi tramite un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway) aziendale.34 * Accedi tramite un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway) aziendale.

35* **Valutazione dei flag di funzionalità**: se imposti una [variabile d'ambiente che disattiva la valutazione dei flag di funzionalità](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching), la disponibilità di Remote Control dipende da quale:35* **Valutazione dei flag di funzionalità**: se imposti una [variabile d'ambiente che disattiva la valutazione dei flag di funzionalità](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching), la disponibilità di Remote Control dipende da quale:

36 * 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`](https://code.claude.com/docs/it/settings-reference#all-settings), per utilizzare Remote Control.36 * Se imposti `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/it/env-vars#variables), 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`](https://code.claude.com/docs/it/settings-reference#all-settings), per utilizzare Remote Control.

37 * 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, oppure v2.1.304 o successivo nell'app Claude Desktop.37 * 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, oppure v2.1.304 o successivo nell'app Claude Desktop.

38* **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`](https://code.claude.com/docs/it/errors#workspace-not-trusted-when-starting-remote-control).38* **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`](https://code.claude.com/docs/it/errors#workspace-not-trusted-when-starting-remote-control).

39 39 

217 217 

218#### Connessione automatica con `DISABLE_TELEMETRY` o `DO_NOT_TRACK` impostati218#### Connessione automatica con `DISABLE_TELEMETRY` o `DO_NOT_TRACK` impostati

219 219 

220Con solo `DISABLE_TELEMETRY` o `DO_NOT_TRACK` impostati, le tue sessioni non si connettono automaticamente tramite il valore predefinito dell'amministratore della tua organizzazione o il valore predefinito di Claude Code. Se qualcos'altro rende Remote Control non disponibile per te, come `DISABLE_GROWTHBOOK` o un gateway LLM, parti invece da [Requisiti](#requirements).220Con solo `DISABLE_TELEMETRY` o `DO_NOT_TRACK` impostati, le tue sessioni non si connettono automaticamente tramite il valore predefinito dell'amministratore della tua organizzazione o il valore predefinito di Claude Code. Se qualcos'altro rende Remote Control non disponibile per te, come [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/it/env-vars#variables) o un gateway LLM, parti invece da [Requisiti](#requirements).

221 221 

222Prima di attivare la connessione automatica con solo `DISABLE_TELEMETRY` o `DO_NOT_TRACK` impostati, verifica che la tua versione di Claude Code soddisfi il [requisito per queste variabili](#requirements). Poi verifica se la tua organizzazione richiede i [Trusted Devices](#trusted-devices):222Prima di attivare la connessione automatica con solo `DISABLE_TELEMETRY` o `DO_NOT_TRACK` impostati, verifica che la tua versione di Claude Code soddisfi il [requisito per queste variabili](#requirements). Poi verifica se la tua organizzazione richiede i [Trusted Devices](#trusted-devices):

223 223 

458 458 

459Una [variabile d'ambiente](https://code.claude.com/docs/it/env-vars.md#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:459Una [variabile d'ambiente](https://code.claude.com/docs/it/env-vars.md#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:

460 460 

461* **`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`](https://code.claude.com/docs/it/settings-reference#all-settings).461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` o `DISABLE_GROWTHBOOK`**: annulla l'impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco `env` di un [file `settings.json`](https://code.claude.com/docs/it/settings-reference#all-settings).

462* **`DISABLE_TELEMETRY` o `DO_NOT_TRACK`**: su un piano Pro, Max, Ultra, Team o Enterprise con `DISABLE_GROWTHBOOK` non impostato, Remote Control resta disponibile con queste variabili impostate, 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, vedi questo messaggio con una qualsiasi delle due variabili impostata, quindi aggiorna Claude Code a una versione che soddisfi il [requisito per queste variabili](#requirements).462* **`DISABLE_TELEMETRY` o `DO_NOT_TRACK`**: su un piano Pro, Max, Ultra, Team o Enterprise con `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` e `DISABLE_GROWTHBOOK` non impostati, Remote Control resta disponibile con queste variabili impostate, 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, vedi questo messaggio con una qualsiasi delle due variabili impostata, quindi aggiorna Claude Code a una versione che soddisfi il [requisito per queste variabili](#requirements).

463 463 

464### "Remote Control is only available when using Claude via api.anthropic.com"464### "Remote Control is only available when using Claude via api.anthropic.com"

465 465 

111* **Environment variables**: fornisci valori che Claude può utilizzare durante ogni esecuzione. Sono [visibili a chiunque utilizzi l'ambiente](https://code.claude.com/docs/it/cloud-environments.md#what-carries-over-from-your-setup), quindi in un ambiente ospitato da Anthropic archivia invece le chiavi per le API che Claude chiama durante un'esecuzione come [segreti di rete](https://code.claude.com/docs/it/cloud-environments.md#add-network-secrets). Quella sezione elenca anche le richieste che non ricevono mai un segreto111* **Environment variables**: fornisci valori che Claude può utilizzare durante ogni esecuzione. Sono [visibili a chiunque utilizzi l'ambiente](https://code.claude.com/docs/it/cloud-environments.md#what-carries-over-from-your-setup), quindi in un ambiente ospitato da Anthropic archivia invece le chiavi per le API che Claude chiama durante un'esecuzione come [segreti di rete](https://code.claude.com/docs/it/cloud-environments.md#add-network-secrets). Quella sezione elenca anche le richieste che non ricevono mai un segreto

112* **Setup script**: installa le dipendenze e gli strumenti di cui l'attività ha bisogno. Il risultato viene [memorizzato nella cache](https://code.claude.com/docs/it/cloud-environments.md#environment-caching), quindi lo script non viene rieseguito a ogni sessione112* **Setup script**: installa le dipendenze e gli strumenti di cui l'attività ha bisogno. Il risultato viene [memorizzato nella cache](https://code.claude.com/docs/it/cloud-environments.md#environment-caching), quindi lo script non viene rieseguito a ogni sessione

113 113 

114Viene fornito un ambiente **Default** con accesso di rete **Trusted**, che consente solo l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) di registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni attraverso la rete della sessione. I connettori che aggiungi all'attività raggiungono i loro servizi attraverso i server di Anthropic, quindi non richiedono modifiche all'allowlist.114Viene fornito un ambiente **Default** con accesso di rete **Limited** e l'opzione **Allow package managers** selezionata. Le sue esecuzioni raggiungono l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains): registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni. I connettori che aggiungi all'attività raggiungono i loro servizi attraverso i server di Anthropic, quindi non richiedono modifiche all'allowlist.

115 115 

116Se la tua attività ha bisogno di raggiungere direttamente i tuoi servizi, o un dominio al di fuori di tale elenco, modifica l'[accesso di rete](https://code.claude.com/docs/it/cloud-environments.md#network-access) dell'ambiente prima dell'esecuzione. Per utilizzare un ambiente separato, [creane uno](https://code.claude.com/docs/it/cloud-environments.md#configure-your-environment) prima.116Se la tua attività ha bisogno di raggiungere direttamente i tuoi servizi, o un dominio al di fuori di tale elenco, modifica l'[accesso di rete](https://code.claude.com/docs/it/cloud-environments.md#network-access) dell'ambiente prima dell'esecuzione. Per utilizzare un ambiente separato, [creane uno](https://code.claude.com/docs/it/cloud-environments.md#configure-your-environment) prima.

117 117 

431 431 

432Ogni attività pianificata utilizza un [ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md) che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione. L'attività eredita la policy di rete dell'ambiente a ogni esecuzione.432Ogni attività pianificata utilizza un [ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md) che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione. L'attività eredita la policy di rete dell'ambiente a ogni esecuzione.

433 433 

434L'ambiente **Default** utilizza l'accesso alla rete **Trusted**, che consente solo l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) attraverso la rete della sessione. Le richieste su quel percorso verso host al di fuori dell'allowlist non riescono con `403` e `x-deny-reason: host_not_allowed`. Il traffico dei connettori MCP viene instradato attraverso i server di Anthropic anziché su quel percorso, quindi i connettori che aggiungi all'attività funzionano senza aggiungere i loro host in **Allowed domains**. Rimuovi i connettori che non ti servono in [Connettori](#connectors).434L'ambiente **Default** utilizza l'accesso **Limited** con **Allow package managers** selezionato, quindi le sue esecuzioni raggiungono l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains). Una richiesta verso un host bloccato non riesce con `403` e `x-deny-reason: host_not_allowed`. Il traffico dei connettori MCP viene instradato attraverso i server di Anthropic, quindi i connettori che aggiungi all'attività funzionano senza aggiungere i loro host in **Allowed domains**. Rimuovi i connettori che non ti servono in [Connettori](#connectors).

435 435 

436Per consentire domini aggiuntivi su uno dei tuoi ambienti, segui questi passaggi. Un [ambiente condiviso dall'organizzazione](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) si apre qui in sola lettura, quindi è un Owner a modificarne l'accesso alla rete dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings).436Per consentire domini aggiuntivi su uno dei tuoi ambienti, segui questi passaggi. Un [ambiente condiviso dall'organizzazione](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) si apre qui in sola lettura, quindi è un Owner a modificarne l'accesso alla rete dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings).

437 437 

447 447 

448Passa il mouse sull'ambiente nell'elenco e fai clic sull'icona delle impostazioni che compare a destra.448Passa il mouse sull'ambiente nell'elenco e fai clic sull'icona delle impostazioni che compare a destra.

449 449 

450**4. Modifica il livello di accesso alla rete**450**4. Aggiungi i domini**

451 451 

452Nella finestra di dialogo **Edit cloud environment**, imposta **Network access** su **Custom** e inserisci i tuoi domini in **Allowed domains**. Seleziona **Also include default list of common package managers** per mantenere l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) insieme ai tuoi domini personalizzati. Seleziona invece **Full** per un accesso senza restrizioni.452Nella finestra di dialogo **Edit cloud environment**, seleziona **Limited** in **Network access** e inserisci i tuoi domini in **Allowed domains**. Seleziona **Allow package managers** per consentire l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains) insieme ai tuoi domini. Seleziona invece **Full** per un accesso senza restrizioni.

453 453 

454**5. Salva**454**5. Salva**

455 455 

6 6 

7> Confronta le opzioni di sandbox di Claude Code: lo strumento Bash sandboxed integrato, il runtime sandbox, i dev container, Docker e le VM. Scegli l'isolamento giusto per il tuo modello di minaccia.7> Confronta le opzioni di sandbox di Claude Code: lo strumento Bash sandboxed integrato, il runtime sandbox, i dev container, Docker e le VM. Scegli l'isolamento giusto per il tuo modello di minaccia.

8 8 

9L'isolamento di Claude Code limita ciò che una sessione può leggere, scrivere e raggiungere sulla rete. Questo è particolarmente importante quando consenti a Claude di lavorare con meno prompt di autorizzazione, lo esegui in modo automatico o lo punti verso codice di cui non sei completamente sicuro.9L'isolamento di Claude Code limita ciò che una sessione può leggere, scrivere e raggiungere sulla rete. Questo è particolarmente importante quando consenti a Claude di lavorare con meno richieste di permesso o lo esegui senza supervisione.

10 10 

11Claude Code può essere eseguito in diversi tipi di ambienti isolati, che vanno da una sandbox leggera per comando a una macchina virtuale completamente separata. Questa pagina confronta gli ambienti in base a ciò che isolano e a cosa richiedono, ti aiuta a sceglierne uno per il tuo modello di minaccia e mostra come applicare tale scelta in tutta l'organizzazione.11Claude Code può essere eseguito in diversi tipi di ambienti isolati, che vanno da una sandbox leggera per comando a una macchina virtuale completamente separata. Questa pagina confronta gli ambienti in base a ciò che isolano e a cosa richiedono, ti aiuta a sceglierne uno per il tuo modello di minaccia e mostra come applicare tale scelta in tutta l'organizzazione.

12 12 

44| Ridurre i prompt di autorizzazione durante il lavoro quotidiano sulla tua macchina | Lo [sandboxed Bash tool](https://code.claude.com/docs/it/sandboxing.md), configurato con `/sandbox` |44| Ridurre i prompt di autorizzazione durante il lavoro quotidiano sulla tua macchina | Lo [sandboxed Bash tool](https://code.claude.com/docs/it/sandboxing.md), configurato con `/sandbox` |

45| Lasciare che Claude lavori in modo automatico con `--dangerously-skip-permissions` o in modalità auto | Il [dev container](https://code.claude.com/docs/it/devcontainer.md) preconfigurato, qualsiasi container o VM, o il [sandbox runtime](#sandbox-runtime) |45| Lasciare che Claude lavori in modo automatico con `--dangerously-skip-permissions` o in modalità auto | Il [dev container](https://code.claude.com/docs/it/devcontainer.md) preconfigurato, qualsiasi container o VM, o il [sandbox runtime](#sandbox-runtime) |

46| Isolare i server MCP e gli hooks così come Bash, senza Docker | Il sandbox runtime |46| Isolare i server MCP e gli hooks così come Bash, senza Docker | Il sandbox runtime |

47| Lavorare su un repository non attendibile | Una macchina virtuale dedicata, o una [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) se hai un abbonamento Claude; GitHub non è richiesto quando avvii con `claude --cloud` |

48| Standardizzare un ambiente sandboxed in un team | Il [dev container](https://code.claude.com/docs/it/devcontainer.md) preconfigurato, copiato nel tuo repository |47| Standardizzare un ambiente sandboxed in un team | Il [dev container](https://code.claude.com/docs/it/devcontainer.md) preconfigurato, copiato nel tuo repository |

49| Usare Claude Code da un dispositivo senza setup locale | Una [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md), che richiede un abbonamento Claude, e un account GitHub connesso per clonare un repository GitHub |48| Usare Claude Code da un dispositivo senza setup locale | Una [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md), che richiede un abbonamento Claude, e un account GitHub connesso per clonare un repository GitHub |

50| Richiedere l'isolamento per ogni sviluppatore nella tua organizzazione | [Applicare l'isolamento in un'organizzazione](#enforce-isolation-across-an-organization) |49| Richiedere l'isolamento per ogni sviluppatore nella tua organizzazione | [Applicare l'isolamento in un'organizzazione](#enforce-isolation-across-an-organization) |

157 156 

158## Virtual machine157## Virtual machine

159 158 

160Una macchina virtuale dedicata fornisce la separazione più forte, con il suo kernel e, nei deployment cloud o microVM, il suo hardware virtualizzato. Le opzioni includono istanze cloud, hypervisor locali e microVM come Firecracker. Usa questo approccio quando stai valutando codice non attendibile, quando la tua politica di sicurezza richiede separazione a livello di kernel tra l'agente e l'host, o quando nessun approccio a livello di host soddisfa i tuoi requisiti di conformità.159Una macchina virtuale dedicata fornisce la separazione più forte, con il suo kernel e, nei deploy cloud o microVM, il suo hardware virtualizzato. Le opzioni includono istanze cloud, hypervisor locali e microVM come Firecracker. Usa questo approccio quando la tua politica di sicurezza richiede separazione a livello di kernel tra l'agente e l'host, o quando nessun approccio a livello di host soddisfa i tuoi requisiti di conformità.

161 160 

162[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) fornisce una microVM con il suo daemon Docker e sincronizzazione dell'area di lavoro, che può eseguire Claude Code su qualsiasi host con Docker Sandboxes installato. È un prodotto gratuito e autonomo di Docker che non richiede Docker Desktop.161[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) fornisce una microVM con il suo daemon Docker e sincronizzazione dell'area di lavoro, che può eseguire Claude Code su qualsiasi host con Docker Sandboxes installato. È un prodotto gratuito e autonomo di Docker che non richiede Docker Desktop.

163 162 

739 739 

740La sandbox non viene eseguita su Windows nativo, quindi con `failIfUnavailable` impostato, Claude Code si chiude all'avvio su quelle macchine. Se la tua flotta include host Windows, puoi:740La sandbox non viene eseguita su Windows nativo, quindi con `failIfUnavailable` impostato, Claude Code si chiude all'avvio su quelle macchine. Se la tua flotta include host Windows, puoi:

741 741 

742* **Distribuire la configurazione in base al sistema operativo**: distribuiscila tramite il tuo MDM o come [file di impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md#delivery-mechanisms) solo sulle macchine macOS e Linux. Le [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md#current-limitations) si applicano a tutti gli utenti dell'organizzazione742* **Distribuire la configurazione in base al sistema operativo**: distribuiscila tramite il tuo MDM o come [file di impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md#delivery-mechanisms) solo sulle macchine macOS e Linux. Le [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md#give-groups-different-settings) seguono il membro, non il dispositivo.

743* **Spostare gli utenti Windows in un ambiente supportato**: fai in modo che eseguano Claude Code all'interno di WSL2 o di un container743* **Spostare gli utenti Windows in un ambiente supportato**: fai in modo che eseguano Claude Code all'interno di WSL2 o di un container

744 744 

745### Impedisci agli sviluppatori di ampliare la politica745### Impedisci agli sviluppatori di ampliare la politica

92* prendersi cura della pull request del ramo corrente: commenti di revisione, esecuzioni CI non riuscite, conflitti di merge92* prendersi cura della pull request del ramo corrente: commenti di revisione, esecuzioni CI non riuscite, conflitti di merge

93* eseguire passaggi di pulizia come cacce ai bug o semplificazione quando non c'è nulla di altro in sospeso93* eseguire passaggi di pulizia come cacce ai bug o semplificazione quando non c'è nulla di altro in sospeso

94 94 

95Claude non avvia nuove iniziative al di fuori di tale ambito, e le azioni irreversibili come il push o l'eliminazione procedono solo quando continuano qualcosa che il trascritto ha già autorizzato.95Ogni esecuzione passa attraverso i [controlli dei permessi](https://code.claude.com/docs/it/permissions.md) della tua sessione prima di eseguire il push o eliminare qualcosa.

96 

97Un `/loop` senza argomenti esegue questo prompt a un [intervallo scelto dinamicamente](#let-claude-choose-the-interval):

96 98 

97```text theme={null}99```text theme={null}

98/loop100/loop

99```101```

100 102 

101Un `/loop` nudo esegue questo prompt a un [intervallo scelto dinamicamente](#let-claude-choose-the-interval). Aggiungete un intervallo, ad esempio `/loop 15m`, per eseguirlo su un programma fisso invece. Per sostituire il prompt integrato con il vostro predefinito, vedere [Personalizzare il prompt predefinito con loop.md](#customize-the-default-prompt-with-loop-md).103Aggiungi un intervallo, ad esempio `/loop 15m`, per eseguirlo invece su un programma fisso. Per sostituire il prompt integrato con un tuo prompt predefinito, consulta [Personalizzare il prompt predefinito con loop.md](#customize-the-default-prompt-with-loop-md).

102 104 

103### Personalizzare il prompt predefinito con loop.md105### Personalizzare il prompt predefinito con loop.md

104 106 

227 229 

228## Disabilitare le attività pianificate con ambito di sessione230## Disabilitare le attività pianificate con ambito di sessione

229 231 

230Impostare `CLAUDE_CODE_DISABLE_CRON=1` nel vostro ambiente per disabilitare completamente lo scheduler. Gli strumenti cron e `/loop` diventano non disponibili e tutte le attività già pianificate smettono di attivarsi. Vedere [Variabili di ambiente](https://code.claude.com/docs/it/env-vars.md) per l'elenco completo dei flag di disabilitazione.232Imposta `CLAUDE_CODE_DISABLE_CRON=1` nel tuo ambiente per disabilitare completamente lo scheduler. `CronCreate` e `/loop` diventano non disponibili e tutte le attività già pianificate smettono di attivarsi. Finché il file `.claude/scheduled_tasks.json` del progetto contiene attività, `CronList` e `CronDelete` restano disponibili, quindi puoi comunque chiedere a Claude di elencarle o annullarle. Consulta [Variabili d'ambiente](https://code.claude.com/docs/it/env-vars.md) per l'elenco completo dei flag di disabilitazione.

231 233 

232## Limitazioni234## Limitazioni

233 235 

183 183 

184* **Un repository a cui la sessione spinge i risultati**: il runner fa fallire la sessione e, in caso di uscita diversa da zero, mostra all'utente la coda dello stderr dello script. Scrivi il motivo nello stderr come un'unica riga breve, scrivilo per ultimo e poi esci con un codice diverso da zero. Non stampare segreti nello stderr e rimuovi `set -x` prima di distribuire l'hook.184* **Un repository a cui la sessione spinge i risultati**: il runner fa fallire la sessione e, in caso di uscita diversa da zero, mostra all'utente la coda dello stderr dello script. Scrivi il motivo nello stderr come un'unica riga breve, scrivilo per ultimo e poi esci con un codice diverso da zero. Non stampare segreti nello stderr e rimuovi `set -x` prima di distribuire l'hook.

185 185 

186 Se il messaggio `couldn't find remote ref` di git compare all'incirca negli ultimi 4 KB dello stderr dell'hook, il runner segnala invece un branch eliminato. Il messaggio di errore della sessione indica allora che il branch non esiste più sul remote e chiede all'utente di ripristinarlo. Se quel branch esiste, consulta [Una sessione fallisce con `no longer exists on the remote` o `couldn't find remote ref`](https://code.claude.com/docs/it/self-hosted-environments-deploy#no-longer-exists-on-the-remote).186 Se il messaggio `couldn't find remote ref` di git compare all'incirca negli ultimi 4 KB dello stderr dell'hook, il runner segnala invece un branch mancante. Se quel branch esiste, consulta [Una sessione fallisce con `couldn't be found in the remote repository` o `couldn't find remote ref`](https://code.claude.com/docs/it/self-hosted-environments-deploy#no-longer-exists-on-the-remote).

187* **Un repository che la sessione legge soltanto**, come un repository aggiunto a una sessione in esecuzione: il runner lo salta e continua con i repository rimanenti. Il runner pubblica un passaggio `Skipped` nella sessione e rimuove ciò che l'hook ha lasciato nel percorso di checkout.187* **Un repository che la sessione legge soltanto**, come un repository aggiunto a una sessione in esecuzione: il runner lo salta e continua con i repository rimanenti. Il runner pubblica un passaggio `Skipped` nella sessione e rimuove ciò che l'hook ha lasciato nel percorso di checkout.

188 188 

189 Quando il passaggio `Skipped` menziona l'hook di checkout, trovi il dettaglio del fallimento nella riga `[runner:warn] checkout hook failed` del log del runner. Quando il passaggio indica che un ref di origine `no longer exists on remote`, consulta [Una sessione fallisce con `no longer exists on the remote` o `couldn't find remote ref`](https://code.claude.com/docs/it/self-hosted-environments-deploy#no-longer-exists-on-the-remote). Se saltarlo lascia la sessione senza alcun repository, il runner fa comunque fallire la sessione.189 Quando il passaggio `Skipped` menziona l'hook di checkout, trovi il dettaglio del fallimento nella riga `[runner:warn] checkout hook failed` del log del runner. Quando il passaggio indica che un ref di origine `no longer exists on remote`, consulta [Una sessione fallisce con `couldn't be found in the remote repository` o `couldn't find remote ref`](https://code.claude.com/docs/it/self-hosted-environments-deploy#no-longer-exists-on-the-remote). Se saltarlo lascia la sessione senza alcun repository, il runner fa comunque fallire la sessione.

190 190 

191Quando l'hook ha successo, il runner rimuove il percorso di checkout dopo la fine della sessione.191Quando l'hook ha successo, il runner rimuove il percorso di checkout dopo la fine della sessione.

192 192 

638 638 

639* Il [file MCP gestito](https://code.claude.com/docs/it/managed-mcp.md) con ambito enterprise nel suo percorso di sistema standard: `/etc/claude-code/managed-mcp.json` sugli host runner Linux, `/Library/Application Support/ClaudeCode/managed-mcp.json` sugli host macOS. Usalo per flotte bloccate in cui possono essere caricati solo i server elencati dall'amministratore. Consulta [controllo esclusivo con managed-mcp.json](https://code.claude.com/docs/it/managed-mcp.md#exclusive-control-with-managed-mcp-json) per le regole di precedenza. Quando questo file si trova sull'host del runner, Claude Code ignora i server MCP che il control plane di Anthropic fornisce a una sessione, inclusi i connettori di claude.ai, e li nomina in un avviso sullo stderr del processo figlio della sessione, che il runner registra al livello di log `debug`. Prima della v2.1.229, quelle sessioni terminavano all'avvio con `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.639* Il [file MCP gestito](https://code.claude.com/docs/it/managed-mcp.md) con ambito enterprise nel suo percorso di sistema standard: `/etc/claude-code/managed-mcp.json` sugli host runner Linux, `/Library/Application Support/ClaudeCode/managed-mcp.json` sugli host macOS. Usalo per flotte bloccate in cui possono essere caricati solo i server elencati dall'amministratore. Consulta [controllo esclusivo con managed-mcp.json](https://code.claude.com/docs/it/managed-mcp.md#exclusive-control-with-managed-mcp-json) per le regole di precedenza. Quando questo file si trova sull'host del runner, Claude Code ignora i server MCP che il control plane di Anthropic fornisce a una sessione, inclusi i connettori di claude.ai, e li nomina in un avviso sullo stderr del processo figlio della sessione, che il runner registra al livello di log `debug`. Prima della v2.1.229, quelle sessioni terminavano all'avvio con `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.

640* La chiave [`managedMcpServers`](https://code.claude.com/docs/it/settings-reference#managedmcpservers) nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) sull'host del runner: fornisce server HTTP e SSE senza assumere il controllo esclusivo, quindi i server delle altre fonti vengono comunque caricati. Richiede Claude Code v2.1.259 o successiva.640* La chiave [`managedMcpServers`](https://code.claude.com/docs/it/settings-reference#managedmcpservers) nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) sull'host del runner: fornisce server HTTP e SSE senza assumere il controllo esclusivo, quindi i server delle altre fonti vengono comunque caricati. Richiede Claude Code v2.1.259 o successiva.

641* `<repo>/.mcp.json`: ambito di progetto. Al di fuori di un thread di [progetto](https://code.claude.com/docs/it/claude-projects.md#what-threads-pick-up-from-your-repositories), esegui il commit del file nel repository e i suoi server vengono approvati automaticamente nelle sessioni cloud. In una sessione con più repository, [viene caricato al massimo il file di un solo repository](#repository-settings-in-sessions-with-several-repositories).641* `<repo>/.mcp.json`: ambito di progetto. Al di fuori di un thread di [progetto](https://code.claude.com/docs/it/claude-projects.md#what-threads-pick-up-from-your-repositories), esegui il commit del file nel repository e i suoi server vengono approvati automaticamente nelle sessioni cloud. In una sessione con più repository, [viene caricato al massimo il file di un solo repository](#repository-settings-in-sessions-with-several-repositories). Con [`--trust-workspace false`](https://code.claude.com/docs/it/self-hosted-environments-reference#runner-cli-flags), le sessioni ignorano i server del file tranne quando li approvano impostazioni non incluse nei commit del repository, come [`enabledMcpjsonServers`](https://code.claude.com/docs/it/settings-reference#enabledmcpjsonservers) nel file `~/.claude/settings.json` dell'host. Richiede Claude Code v2.1.319 o successiva.

642* Un file [`--mcp-config`](https://code.claude.com/docs/it/cli-reference#cli-flags) passato dal tuo script wrapper: aggiungi il flag dopo `"$@"`, come in `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Per mantenere in esecuzione i server di quel file quando i server forniti alla sessione vengono aggiornati a sessione in corso, fai in modo che il tuo wrapper passi l'[ambiente completo](#wrapper-scripts) al processo figlio, come fa `exec`. Prima della v2.1.299, i server stdio, HTTP e SSE in quel file si arrestavano al primo aggiornamento di questo tipo che non li nominava.642* Un file [`--mcp-config`](https://code.claude.com/docs/it/cli-reference#cli-flags) passato dal tuo script wrapper: aggiungi il flag dopo `"$@"`, come in `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Per mantenere in esecuzione i server di quel file quando i server forniti alla sessione vengono aggiornati a sessione in corso, fai in modo che il tuo wrapper passi l'[ambiente completo](#wrapper-scripts) al processo figlio, come fa `exec`. Prima della v2.1.299, i server stdio, HTTP e SSE in quel file si arrestavano al primo aggiornamento di questo tipo che non li nominava.

643 643 

644Quando la distribuzione dei connettori è abilitata per la tua organizzazione, il control plane di Anthropic fornisce i connettori che hai configurato su claude.ai alle sessioni create in modo interattivo tramite una configurazione MCP fornita dal server, instradata attraverso `api.anthropic.com`. Le sessioni create in modo programmatico, come i [dispatch da CLI](https://code.claude.com/docs/it/self-hosted-environments-testing.md#run-the-test-loop), non ricevono i connettori; fornisci loro i server MCP tramite una qualsiasi delle altre fonti elencate in questa sezione. Il token OAuth del processo figlio non include uno scope per recuperare direttamente i connettori, quindi il processo figlio non tenta autonomamente quel recupero; la distribuzione è gestita dal server.644Quando la distribuzione dei connettori è abilitata per la tua organizzazione, il control plane di Anthropic fornisce i connettori che hai configurato su claude.ai alle sessioni create in modo interattivo tramite una configurazione MCP fornita dal server, instradata attraverso `api.anthropic.com`. Le sessioni create in modo programmatico, come i [dispatch da CLI](https://code.claude.com/docs/it/self-hosted-environments-testing.md#run-the-test-loop), non ricevono i connettori; fornisci loro i server MCP tramite una qualsiasi delle altre fonti elencate in questa sezione. Il token OAuth del processo figlio non include uno scope per recuperare direttamente i connettori, quindi il processo figlio non tenta autonomamente quel recupero; la distribuzione è gestita dal server.

909 909 

910In qualsiasi altra sessione con più repository, Claude Code legge le impostazioni di progetto dalla directory in cui si avvia la sessione, quindi al massimo il `.claude/settings.json` di un solo repository ha effetto come impostazioni di progetto. Un hook definito nel file di un altro repository non viene eseguito, una regola deny al suo interno non si applica e il suo `env` non viene impostato.910In qualsiasi altra sessione con più repository, Claude Code legge le impostazioni di progetto dalla directory in cui si avvia la sessione, quindi al massimo il `.claude/settings.json` di un solo repository ha effetto come impostazioni di progetto. Un hook definito nel file di un altro repository non viene eseguito, una regola deny al suo interno non si applica e il suo `env` non viene impostato.

911 911 

912* **`--capacity 1`, il valore predefinito, con il checkout integrato**: la sessione si avvia nel primo repository del suo elenco di repository. Il `.claude/settings.json` di quel repository ha effetto come impostazioni di progetto e il suo `.mcp.json` viene caricato, mentre quelli degli altri repository no.912* **`--capacity 1`, il valore predefinito, con il checkout integrato**: la sessione si avvia nel primo repository del suo elenco di repository. Il `.claude/settings.json` di quel repository ha effetto come impostazioni di progetto e il suo [`.mcp.json`](#mcp-servers) viene caricato, mentre quelli degli altri repository no.

913* **Un `--capacity` maggiore di uno, oppure un [hook `checkout`](#checkout)**: la sessione si avvia in una directory per sessione che contiene i checkout. Nessun `.claude/settings.json` di alcun repository ha effetto come impostazioni di progetto, nessun `.mcp.json` viene caricato e [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/it/hooks#reference-scripts-by-path) in un comando hook corrisponde a quella directory, non a un checkout.913* **Un `--capacity` maggiore di uno, oppure un [hook `checkout`](#checkout)**: la sessione si avvia in una directory per sessione che contiene i checkout. Nessun `.claude/settings.json` di alcun repository ha effetto come impostazioni di progetto, nessun `.mcp.json` viene caricato e [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/it/hooks#reference-scripts-by-path) in un comando hook corrisponde a quella directory, non a un checkout.

914 914 

915Il `CLAUDE.md` di ogni repository viene caricato ovunque si avvii la sessione. Al di fuori di un thread di progetto, vengono caricate anche le sue skill. Il runner passa ogni repository a Claude Code come [directory aggiuntiva](https://code.claude.com/docs/it/permissions.md#additional-directories-grant-file-access-not-configuration), quindi Claude Code legge anche le chiavi `enabledPlugins` ed `extraKnownMarketplaces` dal `.claude/settings.json` di ogni repository.915Il `CLAUDE.md` di ogni repository viene caricato ovunque si avvii la sessione. Al di fuori di un thread di progetto, vengono caricate anche le sue skill. Il runner passa ogni repository a Claude Code come [directory aggiuntiva](https://code.claude.com/docs/it/permissions.md#additional-directories-grant-file-access-not-configuration), quindi Claude Code legge anche le chiavi `enabledPlugins` ed `extraKnownMarketplaces` dal `.claude/settings.json` di ogni repository.

916* **Il runner registra righe `Poll failed` contenenti `rejecting the malformed poll response`**: il runner ha ricevuto una risposta di work-poll il cui corpo non è il JSON previsto dalla coda. Una possibile causa è un proxy di intercettazione o un captive portal che risponde con una propria pagina. Se il runner si connette attraverso un proxy, configura il proxy in modo che lasci passare inalterate le risposte da `api.anthropic.com`.916* **Il runner registra righe `Poll failed` contenenti `rejecting the malformed poll response`**: il runner ha ricevuto una risposta di work-poll il cui corpo non è il JSON previsto dalla coda. Una possibile causa è un proxy di intercettazione o un captive portal che risponde con una propria pagina. Se il runner si connette attraverso un proxy, configura il proxy in modo che lasci passare inalterate le risposte da `api.anthropic.com`.

917 917 

918 Il runner rifiuta la risposta malformata, la conteggia sotto il tipo `transport` della [metrica](https://code.claude.com/docs/it/self-hosted-environments-reference.md#prometheus-metrics) `claude_code_self_hosted_runner_poll_errors_total` e riprova secondo la pianificazione per i poll falliti descritta in [Ciclo di vita della sessione](https://code.claude.com/docs/it/self-hosted-environments#session-lifecycle). Il runner continua a servire le sue sessioni attive. Prima della v2.1.246, il runner interpretava una risposta di questo tipo come una coda di lavoro vuota, il che poteva terminare le sue sessioni attive o farlo uscire.918 Il runner rifiuta la risposta malformata, la conteggia sotto il tipo `transport` della [metrica](https://code.claude.com/docs/it/self-hosted-environments-reference.md#prometheus-metrics) `claude_code_self_hosted_runner_poll_errors_total` e riprova secondo la pianificazione per i poll falliti descritta in [Ciclo di vita della sessione](https://code.claude.com/docs/it/self-hosted-environments#session-lifecycle). Il runner continua a servire le sue sessioni attive. Prima della v2.1.246, il runner interpretava una risposta di questo tipo come una coda di lavoro vuota, il che poteva terminare le sue sessioni attive o farlo uscire.

919* **Una sessione fallisce con `no longer exists on the remote` o `couldn't find remote ref`**: il runner interpreta il messaggio `couldn't find remote ref` di git come un branch eliminato. Il branch potrebbe comunque esistere. Cercalo sul tuo host git, esattamente con il nome riportato nel messaggio, poi verifica ciascuna causa applicabile:919* **Una sessione fallisce con `couldn't be found in the remote repository` o `couldn't find remote ref`**: cerca il branch sul tuo host git. Cerca esattamente il nome riportato nel messaggio.

920 920 

921 * **Il branch non esiste più**: ripristinalo, come chiede il messaggio.921 L'errore della sessione include `Retrying will fail the same way until you fix the missing branch described below.` Quando l'errore nomina il branch, il testo sotto `Last output before exit:` riporta:

922 

923 ```text theme={null}

924 The branch '<ref>' couldn't be found in the remote repository <repo>. If it was never pushed, push it. If it was deleted after a merge, restore it from its pull request. Then send a new message, or start a new session from a branch that has been pushed. (couldn't find remote ref)

925 ```

926 

927 * **Il branch non è sull'host**: esegui il push se non ne è mai stato eseguito il push, oppure ripristinalo dalla sua pull request se è stato eliminato dopo un merge.

922 * **Il branch esiste e non amministri il runner**: invia all'amministratore del runner il messaggio completo e comunicagli che il branch esiste.928 * **Il branch esiste e non amministri il runner**: invia all'amministratore del runner il messaggio completo e comunicagli che il branch esiste.

923 * **Il branch esiste e il runner ha un hook `checkout`**: un comando git nel tuo hook può stampare `couldn't find remote ref` su stderr prima che l'hook esca con un codice diverso da zero. Trova quel comando e correggi il ref che richiede o il remote da cui esegue il fetch. Il runner passa al tuo hook la revisione richiesta dalla sessione come [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/it/self-hosted-environments-configuration#checkout).929 * **Il branch esiste e il runner ha un hook `checkout`**: un comando git nel tuo hook può stampare `couldn't find remote ref` su stderr prima che l'hook esca con un codice diverso da zero. Trova quel comando e correggi il ref che richiede o il remote da cui esegue il fetch. Il runner passa al tuo hook la revisione richiesta dalla sessione come [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/it/self-hosted-environments-configuration#checkout).

924 * **Il branch esiste e il runner non ha un hook `checkout`**: il runner esegue il fetch del branch da solo. Se al repository si applica un [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks), verifica che l'host verso cui riscrive abbia il branch con lo stesso nome, e in caso contrario esegui il push del branch su quell'host.930 * **Il branch esiste e il runner non ha un hook `checkout`**: il runner esegue il fetch del branch da solo. Se al repository si applica un [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks), verifica che l'host verso cui riscrive abbia il branch con lo stesso nome, e in caso contrario esegui il push del branch su quell'host.

925 * **Il branch esiste e il runner è precedente alla v2.1.301**: aggiorna il runner come descritto in [Fissa la versione](#pin-the-version), in modo che un errore diverso mostri il proprio messaggio. Prima della v2.1.301, anche altri errori con `couldn't find remote ref` nel loro output venivano segnalati come branch eliminato.931 * **Il branch esiste e il runner è precedente alla v2.1.301**: aggiorna il runner come descritto in [Fissa la versione](#pin-the-version), in modo che un errore diverso mostri il proprio messaggio. Prima della v2.1.301, anche altri errori con `couldn't find remote ref` nel loro output venivano segnalati come branch eliminato.

926 932 

927 Una volta aggiornato il runner o corretta la causa, riprova la sessione o avviane una nuova. Se nessuno di questi controlli individua la causa, [segnala un problema](#report-an-issue).933 Una volta aggiornato il runner o corretta la causa, invia un nuovo messaggio alla sessione, oppure avvia una nuova sessione da un branch di cui è stato eseguito il push. Se nessuno di questi controlli individua la causa, [segnala un problema](#report-an-issue). Prima della v2.1.314, il messaggio diceva che il branch `no longer exists on the remote`. Segui gli stessi controlli per quel messaggio.

928 934 

929 Per l'origine a cui la sessione invia i risultati, un branch eliminato fa fallire la sessione. Per un'origine git che la sessione legge soltanto, il runner salta quell'origine e continua con le rimanenti. Il runner fa fallire la sessione quando saltare l'origine la lascerebbe senza alcun repository. Prima della v2.1.228, una sessione di questo tipo si avviava in una directory vuota.935 Per l'origine a cui la sessione invia i risultati, un branch eliminato fa fallire la sessione. Per un'origine git che la sessione legge soltanto, il runner salta quell'origine e continua con le rimanenti. Il runner fa fallire la sessione quando saltare l'origine la lascerebbe senza alcun repository. Prima della v2.1.228, una sessione di questo tipo si avviava in una directory vuota.

930* **Claude Tag a volte non pubblica la sua risposta in Slack**: il promemoria di risposta è un [hook fornito dal control plane](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled). Verifica con `claude --version` che il runner sia Claude Code v2.1.229 o successivo, poiché i runner meno recenti ignorano gli hook forniti; verifica che `python3 --version` riesca all'interno dell'immagine del runner, poiché gli hook eseguono `python3`; e verifica che nessun file di impostazioni disattivi gli hook, che si tratti di `disableAllHooks` in `managed-settings.json`, nel `~/.claude/settings.json` dell'utente del runner o nel `.claude/settings.json` o `.claude/settings.local.json` del repository, oppure di `allowManagedHooksOnly` o di uno [`strictPluginOnlyCustomization`](https://code.claude.com/docs/it/settings-reference#strictpluginonlycustomization) che copre gli hook nelle impostazioni gestite.936* **Claude Tag a volte non pubblica la sua risposta in Slack**: il promemoria di risposta è un [hook fornito dal control plane](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled). Verifica con `claude --version` che il runner sia Claude Code v2.1.229 o successivo, poiché i runner meno recenti ignorano gli hook forniti; verifica che `python3 --version` riesca all'interno dell'immagine del runner, poiché gli hook eseguono `python3`; e verifica che nessun file di impostazioni disattivi gli hook, che si tratti di `disableAllHooks` in `managed-settings.json`, nel `~/.claude/settings.json` dell'utente del runner o nel `.claude/settings.json` o `.claude/settings.local.json` del repository, oppure di `allowManagedHooksOnly` o di uno [`strictPluginOnlyCustomization`](https://code.claude.com/docs/it/settings-reference#strictpluginonlycustomization) che copre gli hook nelle impostazioni gestite.

125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Quanto tempo il runner attende dopo che una sessione raggiunge il suo limite `--kill-session-after-min`, affinché un turno in esecuzione finisca o il rilascio si completi, prima di terminare la sessione |125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Quanto tempo il runner attende dopo che una sessione raggiunge il suo limite `--kill-session-after-min`, affinché un turno in esecuzione finisca o il rilascio si completi, prima di terminare la sessione |

126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Limite massimo su quanto tempo il runner conta una sessione come occupata per il drenaggio `--drain-wait-sec` dopo che un turno finisce, mentre il processo della sessione segnala la fine del turno ad Anthropic. `0` o un valore inutilizzabile ricade al valore predefinito, quindi la tenuta non può essere disattivata. Richiede Claude Code v2.1.275 o successivo. |126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Limite massimo su quanto tempo il runner conta una sessione come occupata per il drenaggio `--drain-wait-sec` dopo che un turno finisce, mentre il processo della sessione segnala la fine del turno ad Anthropic. `0` o un valore inutilizzabile ricade al valore predefinito, quindi la tenuta non può essere disattivata. Richiede Claude Code v2.1.275 o successivo. |

127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Quanto tempo il runner attende che il sistema operativo consegni `SIGKILL` a un figlio bloccato in I/O non interrompibile prima di uscire lui stesso. Limitato inferiormente a `--post-session-hook-timeout-sec` più 15 secondi, e 30 in più quando `--push-outcome-on-release` è impostato, quindi il minimo effettivo è 75 secondi ai valori predefiniti. |127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Quanto tempo il runner attende che il sistema operativo consegni `SIGKILL` a un figlio bloccato in I/O non interrompibile prima di uscire lui stesso. Limitato inferiormente a `--post-session-hook-timeout-sec` più 15 secondi, e 30 in più quando `--push-outcome-on-release` è impostato, quindi il minimo effettivo è 75 secondi ai valori predefiniti. |

128| `CLAUDE_RUNNER_DISABLE_RENEWAL_WARNING` | unset | Quando `1`, il runner non pubblica `The server has refused to renew this session's access to the model` in una sessione. Dopo ogni rifiuto, attende il successivo rinnovo pianificato per chiedere di nuovo. Richiede Claude Code v2.1.319 o successivo. |

128| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Profondità di fetch git per cloni freschi. Imposta un numero intero positivo, o `full` o `0` per un fetch completo. Per un clone già presente nel workspace, consulta [Riutilizzare un checkout pre-riscaldato](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |129| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Profondità di fetch git per cloni freschi. Imposta un numero intero positivo, o `full` o `0` per un fetch completo. Per un clone già presente nel workspace, consulta [Riutilizzare un checkout pre-riscaldato](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |

129| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | Quanto tempo in millisecondi, per tentativo, un fetch git può attendere i primi dati mentre i numeri di avanzamento del server git continuano a crescere, come quando il server prepara il pack per un repository di grandi dimensioni. `0` o `off` disattiva l'attesa: un fetch di questo tipo viene quindi interrotto dopo due minuti senza dati. Qualsiasi altro numero intero viene limitato a un valore compreso tra `120000` e `1800000`, da 2 a 30 minuti. Richiede Claude Code v2.1.295 o successivo. |130| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | Quanto tempo in millisecondi, per tentativo, un fetch git può attendere i primi dati mentre i numeri di avanzamento del server git continuano a crescere, come quando il server prepara il pack per un repository di grandi dimensioni. `0` o `off` disattiva l'attesa: un fetch di questo tipo viene quindi interrotto dopo due minuti senza dati. Qualsiasi altro numero intero viene limitato a un valore compreso tra `120000` e `1800000`, da 2 a 30 minuti. Richiede Claude Code v2.1.295 o successivo. |

130| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | unset | Quando `1`, salta il controllo della presenza `.git` dopo l'esecuzione di un hook `checkout`. Imposta questo quando il tuo hook materializza una fonte non-git. |131| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | unset | Quando `1`, salta il controllo della presenza `.git` dopo l'esecuzione di un hook `checkout`. Imposta questo quando il tuo hook materializza una fonte non-git. |

135 136 

136I figli della sessione inviano telemetria operativa ad Anthropic a meno che non la disattivi. Nessun codice o contenuto del repository viene inviato. Imposta le variabili di telemetria sul processo del runner; il runner le ri-asserisce dopo aver applicato le variabili d'ambiente fornite dal server, quindi l'impostazione dell'operatore ha sempre la precedenza.137I figli della sessione inviano telemetria operativa ad Anthropic a meno che non la disattivi. Nessun codice o contenuto del repository viene inviato. Imposta le variabili di telemetria sul processo del runner; il runner le ri-asserisce dopo aver applicato le variabili d'ambiente fornite dal server, quindi l'impostazione dell'operatore ha sempre la precedenza.

137 138 

138Un controllo è specifico per gli ambienti self-hosted: `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` acconsente alle metriche operative di Datadog, che sono disattivate per impostazione predefinita negli ambienti self-hosted. I controlli generali di telemetria di Claude Code, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, si applicano ai figli della sessione come documentato nel [riferimento delle variabili d'ambiente](https://code.claude.com/docs/it/env-vars.md). `DISABLE_GROWTHBOOK` è correlato ma diverso: impostare `DISABLE_GROWTHBOOK=1` disabilita il recupero dei flag di funzionalità, e la telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato.139Un controllo è specifico per gli ambienti self-hosted: `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` acconsente alle metriche operative di Datadog, che sono disattivate per impostazione predefinita negli ambienti self-hosted. I controlli generali di telemetria di Claude Code, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, si applicano ai figli della sessione come documentato nel [riferimento delle variabili d'ambiente](https://code.claude.com/docs/it/env-vars.md). [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/it/env-vars#variables) è correlato ma diverso: impostare `CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1` disabilita il recupero dei flag di funzionalità, e la telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato. `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` richiede Claude Code v2.1.319 o versioni successive.

139 140 

140`CLAUDE_CODE_ENABLE_TELEMETRY` non è correlato: abilita l'esportazione OpenTelemetry al tuo collettore, come descritto in [Monitoring](https://code.claude.com/docs/it/monitoring-usage.md), e non controlla l'analittica di Anthropic.141`CLAUDE_CODE_ENABLE_TELEMETRY` non è correlato: abilita l'esportazione OpenTelemetry al tuo collettore, come descritto in [Monitoring](https://code.claude.com/docs/it/monitoring-usage.md), e non controlla l'analittica di Anthropic.

141 142 

108 108 

109In una sessione in esecuzione, `/status` mostra la stessa riga dopo un recupero non riuscito, e per alcune cause di recupero saltato, come una variabile del provider di terze parti o un `ANTHROPIC_BASE_URL` personalizzato esportato nella shell dell'utente.109In una sessione in esecuzione, `/status` mostra la stessa riga dopo un recupero non riuscito, e per alcune cause di recupero saltato, come una variabile del provider di terze parti o un `ANTHROPIC_BASE_URL` personalizzato esportato nella shell dell'utente.

110 110 

111### Assegnare impostazioni diverse ai gruppi

112 

113Con un piano Enterprise, puoi assegnare a ogni gruppo di membri una propria configurazione invece di un'unica configurazione valida per tutta l'organizzazione. Se la tua organizzazione ha [HIPAA abilitato](https://code.claude.com/docs/it/hipaa-setup.md), le configurazioni per gruppo non sono ancora disponibili. Ogni gruppo deve già esistere, sincronizzato dal tuo provider di identità tramite SCIM oppure come gruppo personalizzato che gestisci nella console di amministrazione.

114 

115Ogni membro riceve al massimo una configurazione, la stessa su ogni dispositivo:

116 

117* **Un membro di un gruppo con una configurazione**: la configurazione con la posizione più alta tra i suoi gruppi

118* **Chiunque altro**, incluso un membro il cui unico gruppo con una configurazione è stato eliminato: la configurazione predefinita per tutti gli altri, se ne imposti una

119 

120Le configurazioni non vengono sottoposte a merge tra loro né con la configurazione valida per tutta l'organizzazione, quindi ognuna deve contenere tutte le impostazioni che vuoi assegnare a quel gruppo. Per applicare una restrizione a tutti i membri, inseriscila in ogni configurazione di gruppo e nella configurazione predefinita.

121 

122I membri continuano a ricevere la configurazione valida per tutta l'organizzazione fino all'ultimo di questi passaggi, quindi puoi prima preparare e testare tutto:

123 

124**1. Aggiungere una configurazione per ogni gruppo**

125 

126In [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code), fai clic su **Add configuration**, scegli il gruppo e seleziona un punto di partenza. Per allentare la politica per un gruppo, scegli un gruppo sincronizzato dal tuo provider di identità, in modo che nessuno possa aggiungersi a esso nella console di amministrazione.

127 

128Per mantenere ciò che i membri hanno oggi e modificare alcune impostazioni, parti da una copia della configurazione valida per tutta l'organizzazione. Modifica la configurazione e salvala.

129 

130**2. Impostare la configurazione predefinita**

131 

132Fai clic su **Set** in **Everyone else** e aggiungi il JSON per i membri che non corrispondono ad alcuna configurazione di gruppo. Per lasciare loro ciò che hanno oggi, incolla la configurazione valida per tutta l'organizzazione. Se salti questo passaggio, le loro sessioni locali non ricevono impostazioni gestite dal server, e qualsiasi [impostazione gestita dall'endpoint](https://code.claude.com/docs/it/managed-settings.md#delivery-mechanisms) presente sul dispositivo si applica comunque.

133 

134**3. Ordinare i gruppi**

135 

136Trascina le configurazioni nell'ordine desiderato. Un membro di più gruppi riceve solo la configurazione con la posizione più alta, quindi metti in cima i gruppi più restrittivi o più specifici.

137 

138**4. Verificare chi riceve cosa**

139 

140In **Check effective settings** in fondo alla pagina, cerca un membro per vedere quale configurazione riceverebbe. Verifica un membro di ciascun gruppo, un membro di più gruppi e un membro che non corrisponde ad alcuna configurazione di gruppo.

141 

142**5. Passare alla modalità basata sui gruppi**

143 

144Fai clic su **Switch to group-based configurations** nel banner in cima alla pagina e conferma. I membri ricevono le loro configurazioni entro circa un'ora, a parte le [chiavi che si applicano solo al prossimo avvio](#fetch-and-caching-behavior). Per tornare indietro, passa alla modalità per tutta l'organizzazione dallo stesso banner: la configurazione valida per tutta l'organizzazione si applica di nuovo, se ne hai una, e le configurazioni di gruppo vengono mantenute.

145 

146I limiti sui modelli di un gruppo valgono solo nelle sessioni locali. Le sessioni cloud e le sessioni remote di Cowork usano l'elenco [`availableModels`](https://code.claude.com/docs/it/model-config#restrict-model-selection) della configurazione predefinita. Se non imposti una configurazione predefinita, l'elenco proviene dalla configurazione valida per tutta l'organizzazione, anche dopo il passaggio alla modalità basata sui gruppi. Se ometti la chiave dalla configurazione predefinita, i membri non sono limitati da questo elenco in quelle sessioni.

147 

148Se usi la configurazione di un gruppo per impostare dove vengono inviate le richieste API, ciò si applica solo a Claude Code, non ad altri strumenti che chiamano l'API.

149 

111### Controllo di accesso150### Controllo di accesso

112 151 

113I seguenti ruoli possono gestire le impostazioni gestite dal server:152I seguenti ruoli possono gestire le impostazioni gestite dal server:

115* **Primary Owner**154* **Primary Owner**

116* **Owner**155* **Owner**

117 156 

118Limitare l'accesso al personale di fiducia, poiché le modifiche alle impostazioni si applicano a tutti gli utenti dell'organizzazione.157Limita l'accesso al personale di fiducia, poiché le modifiche alle impostazioni possono applicarsi a tutti gli utenti dell'organizzazione.

119 158 

120### Impostazioni solo gestite159### Impostazioni solo gestite

121 160 

125 164 

126Le impostazioni gestite dal server hanno le seguenti limitazioni:165Le impostazioni gestite dal server hanno le seguenti limitazioni:

127 166 

128* Le impostazioni si applicano uniformemente a tutti gli utenti dell'organizzazione. Le configurazioni per gruppo non sono ancora supportate.167* Con un piano Team, le impostazioni si applicano uniformemente a tutti gli utenti dell'organizzazione. Le [configurazioni per gruppo](#give-groups-different-settings) richiedono un piano Enterprise.

129* Non è possibile distribuire un file [`managed-mcp.json`](https://code.claude.com/docs/it/managed-mcp) tramite impostazioni gestite dal server. Distribuire invece le chiavi di politica `allowedMcpServers` e `deniedMcpServers` lì. Su Claude Code v2.1.259 o successivo, è inoltre possibile fornire server remoti con [`managedMcpServers`](https://code.claude.com/docs/it/managed-mcp#provide-servers-through-managed-settings), che accetta solo server `http` e `sse` e non assume il controllo esclusivo come fa il file.168* Non è possibile distribuire un file [`managed-mcp.json`](https://code.claude.com/docs/it/managed-mcp) tramite impostazioni gestite dal server. Distribuire invece le chiavi di politica `allowedMcpServers` e `deniedMcpServers` lì. Su Claude Code v2.1.259 o successivo, è inoltre possibile fornire server remoti con [`managedMcpServers`](https://code.claude.com/docs/it/managed-mcp#provide-servers-through-managed-settings), che accetta solo server `http` e `sse` e non assume il controllo esclusivo come fa il file.

130 169 

131 Claude Code legge un file `managed-mcp.json` distribuito nel suo [percorso di sistema](https://code.claude.com/docs/it/managed-mcp.md#exclusive-control-with-managed-mcp-json) separatamente dal livello delle impostazioni gestite, quindi il file si applica ancora quando le impostazioni gestite dal server sono in vigore.170 Claude Code legge un file `managed-mcp.json` distribuito nel suo [percorso di sistema](https://code.claude.com/docs/it/managed-mcp.md#exclusive-control-with-managed-mcp-json) separatamente dal livello delle impostazioni gestite, quindi il file si applica ancora quando le impostazioni gestite dal server sono in vigore.

245* `cleanupPeriodDays` accorcia la conservazione dei trascritti delle sessioni e altri dati locali a sette giorni245* `cleanupPeriodDays` accorcia la conservazione dei trascritti delle sessioni e altri dati locali a sette giorni

246* `companyAnnouncements` mostra un messaggio all'avvio246* `companyAnnouncements` mostra un messaggio all'avvio

247 247 

248Gli amministratori distribuiscono un file come questo come `managed-settings.json`, o lo stesso JSON tramite MDM o [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Un file distribuito si applica a ogni macchina o account che raggiunge. Per dare a un gruppo valori diversi, distribuisci un file o profilo diverso a quel gruppo, poiché [le impostazioni gestite dal server non supportano ancora la politica per gruppo](https://code.claude.com/docs/it/server-managed-settings.md#current-limitations).248Gli amministratori distribuiscono un file come questo come `managed-settings.json`, o lo stesso JSON tramite MDM o [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Un file distribuito si applica a ogni macchina o account che raggiunge. Per dare a un gruppo valori diversi, distribuisci un file o profilo diverso a quel gruppo. Con un piano Enterprise, puoi invece [dare al gruppo una propria configurazione](https://code.claude.com/docs/it/server-managed-settings.md#give-groups-different-settings) nelle impostazioni gestite dal server.

249 249 

250> [tab] Copyable settings file250> [tab] Copyable settings file

251>251>

91| `managed-agents-secure [<agent-id>]` | Leggere le impostazioni di un Managed Agent e segnalare dove corrispondono alla guida [Proteggi il deploy dei tuoi Managed Agents](https://platform.claude.com/docs/en/managed-agents/secure-deployment) o dove se ne discostano. Richiede la [CLI `ant`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 o successivo |91| `managed-agents-secure [<agent-id>]` | Leggere le impostazioni di un Managed Agent e segnalare dove corrispondono alla guida [Proteggi il deploy dei tuoi Managed Agents](https://platform.claude.com/docs/en/managed-agents/secure-deployment) o dove se ne discostano. Richiede la [CLI `ant`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 o successivo |

92| `prompt-audit` | Contrassegnare le istruzioni scritte per modelli più vecchi nei vostri prompt, skill e descrizioni di strumenti e proporre correzioni come diff | v2.1.221 o successivo |92| `prompt-audit` | Contrassegnare le istruzioni scritte per modelli più vecchi nei vostri prompt, skill e descrizioni di strumenti e proporre correzioni come diff | v2.1.221 o successivo |

93| `cost-optimize` | 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, batch processing, effort, e scelta del modello, una modifica alla volta | v2.1.247 o successivo |93| `cost-optimize` | 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, batch processing, effort, e scelta del modello, una modifica alla volta | v2.1.247 o successivo |

94| `latency-optimize` | Individua dove si spende il tempo nel tuo codice Claude API esistente e propone modifiche che riducono l'attesa delle persone | v2.1.319 o successivo |

94| `build-eval` | Costruire un set di eval per la vostra app basata su Claude | v2.1.259 o successivo |95| `build-eval` | Costruire un set di eval per la vostra app basata su Claude | v2.1.259 o successivo |

95| `hillclimb` | Migliorare iterativamente la vostra app rispetto a un eval esistente | v2.1.259 o successivo |96| `hillclimb` | Migliorare iterativamente la vostra app rispetto a un eval esistente | v2.1.259 o successivo |

96| `preserved-thinking-migration` | Trovare le modifiche che la vostra integrazione apporta ai turni precedenti, al suo system prompt, o alla sua lista di strumenti che invalidano i blocchi di [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), misurare quanto ragionamento ogni uno elimina, e proporre correzioni una alla volta, ri-misurando dopo ogni modifica | v2.1.282 o successivo |97| `preserved-thinking-migration` | Trovare le modifiche che la vostra integrazione apporta ai turni precedenti, al suo system prompt, o alla sua lista di strumenti che invalidano i blocchi di [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), misurare quanto ragionamento ogni uno elimina, e proporre correzioni una alla volta, ri-misurando dopo ogni modifica | v2.1.282 o successivo |

197Il limite di tempo viene contato dal momento in cui il comando entra in background:197Il limite di tempo viene contato dal momento in cui il comando entra in background:

198 198 

199* Un comando che Claude avvia in background ottiene 30 minuti, o il `timeout` che Claude passa con `run_in_background`, fino a un massimo di 2 ore199* Un comando che Claude avvia in background ottiene 30 minuti, o il `timeout` che Claude passa con `run_in_background`, fino a un massimo di 2 ore

200* Un comando che inizia in primo piano e poi si sposta in background, ad esempio al suo timeout, ottiene 30 minuti dalla mossa200* Un comando che inizia in primo piano e poi si sposta in background al suo timeout ottiene 30 minuti dallo spostamento