SpyBara
Go Premium

Documentation 2026-10-03 23:57 UTC to 2026-10-04 21:58 UTC

53 files changed +1,084 −673. View all changes and history on the product overview
2026
Sun 4 21:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +2 −2

Details

137 Account GitHub connessi137 Account GitHub connessi

138</h3>138</h3>

139 139 

140Sui piani Team ed Enterprise, [**Admin settings > GitHub**](https://claude.ai/admin-settings/github) elenca le organizzazioni GitHub e gli account personali collegati alla tua organizzazione Claude tramite la [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security condividono l'elenco. Per aprirlo è necessario un ruolo di amministratore nella tua organizzazione Claude.140Sui piani Team ed Enterprise, [**Organization settings > GitHub**](https://claude.ai/admin-settings/github) elenca le organizzazioni GitHub e gli account personali collegati alla tua organizzazione Claude tramite la [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security condividono l'elenco. Per aprirlo è necessario un ruolo di amministratore nella tua organizzazione Claude.

141 141 

142Un amministratore o un membro può collegare un account:142Un amministratore o un membro può collegare un account:

143 143 


161| Usage monitoring | Esportazione OpenTelemetry di sessioni, strumenti e token | Tutti i provider | [Monitoring usage](/docs/it/monitoring-usage) |161| Usage monitoring | Esportazione OpenTelemetry di sessioni, strumenti e token | Tutti i provider | [Monitoring usage](/docs/it/monitoring-usage) |

162| Analytics dashboard | Metriche di adozione e contributo con una leaderboard su Teams / Enterprise; metriche di utilizzo e spesa per utente su Console | Teams / Enterprise su [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console su [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/docs/it/analytics) |162| Analytics dashboard | Metriche di adozione e contributo con una leaderboard su Teams / Enterprise; metriche di utilizzo e spesa per utente su Console | Teams / Enterprise su [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console su [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/docs/it/analytics) |

163| Programmatic reporting | Dati di utilizzo e costo per utente tramite un'API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) per Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) per Console | [Costs](/docs/it/costs#manage-costs-for-your-organization) |163| Programmatic reporting | Dati di utilizzo e costo per utente tramite un'API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) per Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) per Console | [Costs](/docs/it/costs#manage-costs-for-your-organization) |

164| Spend controls | Limiti di spesa e limiti di velocità | Impostazioni amministratore per Teams / Enterprise, limiti dell'area di lavoro per Console; sui cloud di terze parti, controlli del budget cloud o un [Claude apps gateway](/docs/it/claude-apps-gateway) con [limiti di spesa](/docs/it/claude-apps-gateway-spend-limits) per utente | [Costs](/docs/it/costs#manage-costs-for-your-organization) |164| Spend controls | Limiti di spesa e rate limit | Impostazioni dell'organizzazione per Teams / Enterprise, limiti del workspace per Console; sui cloud di terze parti, controlli del budget cloud o un [Claude apps gateway](/docs/it/claude-apps-gateway) con [limiti di spesa](/docs/it/claude-apps-gateway-spend-limits) per utente | [Costs](/docs/it/costs#manage-costs-for-your-organization) |

165 165 

166Su Teams e Enterprise, i numeri di utilizzo e spesa per utente provengono dal [rapporto di spesa](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) nelle impostazioni di analisi della tua organizzazione, non dalla dashboard di analisi. I provider cloud espongono la spesa attraverso AWS Cost Explorer, GCP Billing o Azure Cost Management. Per pianificare i budget aziendali su Claude chat, Claude Code e Cowork, consulta la [guida al consumo Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).166Su Teams e Enterprise, i numeri di utilizzo e spesa per utente provengono dal [rapporto di spesa](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) nelle impostazioni di analisi della tua organizzazione, non dalla dashboard di analisi. I provider cloud espongono la spesa attraverso AWS Cost Explorer, GCP Billing o Azure Cost Management. Per pianificare i budget aziendali su Claude chat, Claude Code e Cowork, consulta la [guida al consumo Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).

167 167 

agent-sdk/mcp.md +14 −0

Details

919 ```919 ```

920</CodeGroup>920</CodeGroup>

921 921 

922<h3 id="a-tool-is-missing-from-an-sdk-mcp-server">

923 Manca uno strumento da un server MCP dell'SDK

924</h3>

925 

926Nell'SDK TypeScript, quando lo schema di input di uno strumento non può essere convertito in JSON Schema, il server che hai creato con [`createSdkMcpServer()`](/docs/it/agent-sdk/typescript#createsdkmcpserver) esclude quello strumento quando elenca i propri strumenti. In quel momento l'SDK emette un avviso. In Node.js l'avviso è un process warning con codice `CLAUDE_SDK_MCP_TOOL_SCHEMA_UNCONVERTIBLE` e inizia con questo testo:

927 

928```text theme={null}

929Tool "<name>" on SDK MCP server "<server>" was left out of the server's tool list, because its input schema cannot be converted to JSON Schema

930```

931 

932Il resto dell'avviso riporta il messaggio dell'errore di conversione, quando presente, e poi indica cosa controllare e modificare.

933 

934Prima della versione v0.3.286 dell'Agent SDK TypeScript, un singolo schema non convertibile faceva fallire l'intero elenco degli strumenti del server senza questo avviso, quindi nessuno degli strumenti di quel server raggiungeva Claude.

935 

922<h3 id="connection-timeouts">936<h3 id="connection-timeouts">

923 Connection timeouts937 Connection timeouts

924</h3>938</h3>

Details

13| Sintomo | Vai a |13| Sintomo | Vai a |

14| :- | :- |14| :- | :- |

15| Skills non trovate, una skill non viene utilizzata, errore `Invalid skill name` | [Troubleshooting delle skills](/docs/it/agent-sdk/skills#troubleshooting) |15| Skills non trovate, una skill non viene utilizzata, errore `Invalid skill name` | [Troubleshooting delle skills](/docs/it/agent-sdk/skills#troubleshooting) |

16| Il server MCP mostra lo stato `failed`, gli strumenti non vengono chiamati, timeout di connessione, output dello strumento che supera il numero massimo di token consentiti | [Troubleshooting di MCP](/docs/it/agent-sdk/mcp#troubleshooting) |16| Il server MCP mostra lo stato `failed`, gli strumenti non vengono chiamati, uno strumento mancante da un server MCP dell'SDK, timeout di connessione, output dello strumento che supera il numero massimo di token consentiti | [Risoluzione dei problemi di MCP](/docs/it/agent-sdk/mcp#troubleshooting) |

17| Plugin non caricato, le skill del plugin non appaiono | [Troubleshooting dei plugin](/docs/it/agent-sdk/plugins#troubleshooting) |17| Plugin non caricato, le skill del plugin non appaiono | [Troubleshooting dei plugin](/docs/it/agent-sdk/plugins#troubleshooting) |

18| Claude non delega ai subagent, gli agenti basati su filesystem non si caricano | [Troubleshooting dei subagent](/docs/it/agent-sdk/subagents#troubleshooting) |18| Claude non delega ai subagent, gli agenti basati su filesystem non si caricano | [Troubleshooting dei subagent](/docs/it/agent-sdk/subagents#troubleshooting) |

19| Le opzioni di checkpointing non sono riconosciute, i messaggi dell'utente senza UUID, `No file checkpoint found`, `File rewinding is not enabled`, `ProcessTransport is not ready for writing` | [Troubleshooting del file checkpointing](/docs/it/agent-sdk/file-checkpointing#troubleshooting) |19| Le opzioni di checkpointing non sono riconosciute, i messaggi dell'utente senza UUID, `No file checkpoint found`, `File rewinding is not enabled`, `ProcessTransport is not ready for writing` | [Troubleshooting del file checkpointing](/docs/it/agent-sdk/file-checkpointing#troubleshooting) |

Details

863 fast_mode_state?: "off" | "cooldown" | "on";863 fast_mode_state?: "off" | "cooldown" | "on";

864 fast_mode_disabled_reason?: FastModeDisabledReason;864 fast_mode_disabled_reason?: FastModeDisabledReason;

865 hooks_applied?: boolean;865 hooks_applied?: boolean;

866 sdk_mcp_manifests_parked?: Record<

867 string,

868 | "parked"

869 | "already_connected"

870 | "protocol_version_mismatch"

871 | "malformed"

872 | "not_honoured"

873 >;

866};874};

867```875```

868 876 


875 883 

876Prima di Agent SDK v0.3.238, la risposta non ha mai trasportato il campo, e Claude Code ha ignorato `hooks` su ogni inizializzazione ripetuta.884Prima di Agent SDK v0.3.238, la risposta non ha mai trasportato il campo, e Claude Code ha ignorato `hooks` su ogni inizializzazione ripetuta.

877 885 

886Il campo `sdkMcpServerManifests` della richiesta e il campo `sdk_mcp_manifests_parked` della risposta riguardano i [server MCP dell'SDK](/docs/it/agent-sdk/custom-tools) in-process che hai creato con [`createSdkMcpServer()`](#createsdkmcpserver). La tua applicazione non imposta né legge nessuno dei due campi.

887 

878La risposta segnala sempre `fast_mode_state`, e quando qualcosa blocca [fast mode](/docs/it/fast-mode), `fast_mode_disabled_reason` trasporta il codice della ragione insieme ad esso, in modo che tu possa spiegare lo stato bloccato invece di ri-derivare la disponibilità. Entrambi i comportamenti richiedono Claude Code v2.1.219 o successivo. Prima di v2.1.219, la risposta ometteva `fast_mode_state` quando fast mode non era disponibile e non trasportava mai una ragione. Per i codici della ragione e i loro significati, vedi [`fast_mode_disabled_reason`](#sdkresultmessage) sul messaggio di risultato.888La risposta segnala sempre `fast_mode_state`, e quando qualcosa blocca [fast mode](/docs/it/fast-mode), `fast_mode_disabled_reason` trasporta il codice della ragione insieme ad esso, in modo che tu possa spiegare lo stato bloccato invece di ri-derivare la disponibilità. Entrambi i comportamenti richiedono Claude Code v2.1.219 o successivo. Prima di v2.1.219, la risposta ometteva `fast_mode_state` quando fast mode non era disponibile e non trasportava mai una ragione. Per i codici della ragione e i loro significati, vedi [`fast_mode_disabled_reason`](#sdkresultmessage) sul messaggio di risultato.

879 889 

880Il wrapper di risposta di controllo per un `initialize` riuscito trasporta anche un array `pending_permission_requests`. Il campo è sul wrapper di risposta stesso, non nel payload `SDKControlInitializeResponse` sopra. Ogni voce è un messaggio `control_request` completo con la stessa forma `{ type: "control_request", request_id, request }` che la sessione trasmette per le richieste di permesso durante l'esecuzione.890Il wrapper di risposta di controllo per un `initialize` riuscito trasporta anche un array `pending_permission_requests`. Il campo è sul wrapper di risposta stesso, non nel payload `SDKControlInitializeResponse` sopra. Ogni voce è un messaggio `control_request` completo con la stessa forma `{ type: "control_request", request_id, request }` che la sessione trasmette per le richieste di permesso durante l'esecuzione.


1955| - | - |1965| - | - |

1956| `interrupt_receipt_v1` | [`interrupt()`](#query-object) si risolve con una ricevuta [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) che elenca i messaggi in sospeso al momento dell'arrivo dell'interruzione |1966| `interrupt_receipt_v1` | [`interrupt()`](#query-object) si risolve con una ricevuta [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) che elenca i messaggi in sospeso al momento dell'arrivo dell'interruzione |

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

1968| `sdk_mcp_manifests` | La richiesta di controllo `initialize` accetta `sdkMcpServerManifests`, risultati di handshake MCP acquisiti dai tuoi [server MCP dell'SDK](/docs/it/agent-sdk/custom-tools) in-process. Claude Code dichiara questa capability in v2.1.286 o successivo |

1969| `sdk_mcp_tools_list_changed` | Una notifica `tools/list_changed` da un [server MCP dell'SDK](/docs/it/agent-sdk/custom-tools) fa sì che Claude Code elenchi di nuovo gli strumenti di quel server, così uno strumento che il server aggiunge a metà sessione raggiunge Claude. Claude Code dichiara questa capability in v2.1.286 o successivo |

1958 1970 

1959L'array `plugin_errors` elenca gli errori di caricamento dei plugin. Una voce descrive un plugin che non è stato caricato ed è assente da `plugins`, oppure un plugin che è stato caricato senza una delle sue parti, come il suo file degli hook. La chiave viene omessa quando non si è verificato alcun errore. `SDKSystemMessage` dichiara `plugin_errors` in Agent SDK v0.3.283 o successivo.1971L'array `plugin_errors` elenca gli errori di caricamento dei plugin. Una voce descrive un plugin che non è stato caricato ed è assente da `plugins`, oppure un plugin che è stato caricato senza una delle sue parti, come il suo file degli hook. La chiave viene omessa quando non si è verificato alcun errore. `SDKSystemMessage` dichiara `plugin_errors` in Agent SDK v0.3.283 o successivo.

1960 1972 

agent-view.md +5 −2

Details

347 347 

348Per combinare i filtri, inizia con `a:`, `s:`, `n:` o `o:` e aggiungine altri, separati da spazi. L'elenco mostra le sessioni che corrispondono a tutti. Ad esempio, `s:blocked a:reviewer` elenca le sessioni `reviewer` che stanno aspettando te.348Per combinare i filtri, inizia con `a:`, `s:`, `n:` o `o:` e aggiungine altri, separati da spazi. L'elenco mostra le sessioni che corrispondono a tutti. Ad esempio, `s:blocked a:reviewer` elenca le sessioni `reviewer` che stanno aspettando te.

349 349 

350Mentre un filtro è attivo, i gruppi che hai compresso si espandono per mostrare le loro corrispondenze e la prima corrispondenza è selezionata, quindi premendo `Enter` la apri. Cancella l'input per rimuovere il filtro, e quei gruppi si comprimono di nuovo.350Mentre un filtro è attivo, i gruppi che hai compresso si espandono per mostrare le loro corrispondenze e una corrispondenza è selezionata, quindi premendo `Enter` la apri. Cancella l'input per rimuovere il filtro, e quei gruppi si comprimono di nuovo.

351 351 

352<h3 id="keyboard-shortcuts">352<h3 id="keyboard-shortcuts">

353 Scorciatoie da tastiera353 Scorciatoie da tastiera


369| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |369| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |

370| `Ctrl+S` | Cambia raggruppamento tra stato e directory |370| `Ctrl+S` | Cambia raggruppamento tra stato e directory |

371| `Ctrl+T` | Fissa o scollega la sessione selezionata |371| `Ctrl+T` | Fissa o scollega la sessione selezionata |

372| `Ctrl+F` | Trova le sessioni per nome, con il [filtro `n:`](#filter-sessions) |

373| `Alt+↑` / `Alt+↓` | Salta all'intestazione di gruppo precedente o successiva |

372| `Ctrl+R` | Rinomina la sessione selezionata |374| `Ctrl+R` | Rinomina la sessione selezionata |

373| `Ctrl+G` | Apri il prompt di dispatch nel tuo `$VISUAL` o `$EDITOR` |375| `Ctrl+G` | Apri il prompt di dispatch nel tuo `$VISUAL` o `$EDITOR` |

374| `Ctrl+J` | Inserisci una nuova riga nell'input di dispatch |376| `Ctrl+J` | Inserisci una nuova riga nell'input di dispatch |


378| `Ctrl+C` | Cancella l'input; premi due volte per uscire |380| `Ctrl+C` | Cancella l'input; premi due volte per uscire |

379| `?` | Mostra tutte le scorciatoie |381| `?` | Mostra tutte le scorciatoie |

380 382 

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

382 384 

383<h2 id="dispatch-new-agents">385<h2 id="dispatch-new-agents">

384 Inviare nuovi agenti386 Inviare nuovi agenti


1087 1089 

1088| Versione | Cambiamento |1090| Versione | Cambiamento |

1089| - | - |1091| - | - |

1092| v2.1.288 | `Ctrl+F` trova le sessioni per nome, e `Alt+↑` / `Alt+↓` saltano tra le intestazioni dei gruppi. Entrambe, e `Ctrl+R`, possono essere [riassegnate](/docs/it/keybindings#agents-actions). |

1090| v2.1.287 | Il [filtro `n:<text>`](#filter-sessions) trova le sessioni per nome o per primo prompt. Mentre un qualsiasi filtro è attivo, i gruppi che hai compresso si espandono per mostrare le loro corrispondenze e la prima corrispondenza viene selezionata, quindi `Enter` la apre. |1093| v2.1.287 | Il [filtro `n:<text>`](#filter-sessions) trova le sessioni per nome o per primo prompt. Mentre un qualsiasi filtro è attivo, i gruppi che hai compresso si espandono per mostrare le loro corrispondenze e la prima corrispondenza viene selezionata, quindi `Enter` la apre. |

1091| v2.1.287 | Un comando inviato come [risposta dal pannello peek](#peek-and-reply) viene eseguito al termine del turno corrente della sessione, inclusi i comandi che vengono eseguiti non appena li digiti nel prompt della sessione stessa. Una risposta che è esattamente `/stop` arresta immediatamente la sessione. |1094| v2.1.287 | Un comando inviato come [risposta dal pannello peek](#peek-and-reply) viene eseguito al termine del turno corrente della sessione, inclusi i comandi che vengono eseguiti non appena li digiti nel prompt della sessione stessa. Una risposta che è esattamente `/stop` arresta immediatamente la sessione. |

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

Details

386 386 

387Quando questi controlli trovano un modello che il vostro account non può richiamare, Claude Code ricorda il rifiuto su questa macchina per un massimo di un giorno, e durante quel tempo l'avvio salta il modello ricordato senza chiedere di nuovo ad Amazon Bedrock. Claude Code controlla un rifiuto ricordato di un modello predefinito corrente di nuovo all'avvio una volta che sono passati dieci minuti dall'ultimo controllo, quindi un valore predefinito che l'amministratore riabilita ritorna. Per disattivare la memoria, impostate [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/it/env-vars).387Quando questi controlli trovano un modello che il vostro account non può richiamare, Claude Code ricorda il rifiuto su questa macchina per un massimo di un giorno, e durante quel tempo l'avvio salta il modello ricordato senza chiedere di nuovo ad Amazon Bedrock. Claude Code controlla un rifiuto ricordato di un modello predefinito corrente di nuovo all'avvio una volta che sono passati dieci minuti dall'ultimo controllo, quindi un valore predefinito che l'amministratore riabilita ritorna. Per disattivare la memoria, impostate [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/it/env-vars).

388 388 

389<h3 id="when-your-organization-enforces-a-model-allowlist">

390 Quando la tua organizzazione applica un'allowlist dei modelli

391</h3>

392 

393Se imposti [`enforceAvailableModels`](/docs/it/model-config#enforce-the-allowlist-for-the-default-model) nelle impostazioni gestite, i controlli del modello all'avvio usano solo i modelli consentiti dal tuo elenco `availableModels`. Questo si applica all'API Invoke di Amazon Bedrock e richiede Claude Code v2.1.287 o versioni successive. Un elenco senza `enforceAvailableModels` non limita questi controlli.

394 

395I controlli confrontano ogni voce con l'ID del profilo di inferenza che invierebbero, incluso il relativo [prefisso di regione](#cross-region-inference-profile-prefixes), quindi scrivi l'elenco usando quegli ID. Questo esempio consente Opus 4.8 e Sonnet 4.5 per un deploy i cui modelli si risolvono in profili `us.`:

396 

397```json theme={null}

398{

399 "availableModels": ["us.anthropic.claude-opus-4-8", "us.anthropic.claude-sonnet-4-5-20250929-v1:0"],

400 "enforceAvailableModels": true

401}

402```

403 

404Per alias, prefissi di versione e voci `modelOverrides`, consulta [Fissare i modelli per i deploy di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments).

405 

389<h3 id="when-a-model-is-disabled-mid-session">406<h3 id="when-a-model-is-disabled-mid-session">

390 Quando un modello viene disabilitato durante la sessione407 Quando un modello viene disabilitato durante la sessione

391</h3>408</h3>

artifacts.md +3 −1

Details

156 Lascia che Claude risponda ai commenti da solo156 Lascia che Claude risponda ai commenti da solo

157</h3>157</h3>

158 158 

159Dopo che la tua sessione pubblica un artefatto, Claude Code osserva quell'artefatto per i commenti finché la sessione è in esecuzione. Quando qualcuno che può modificare l'artefatto invia un commento a Claude, raggiunge la tua sessione subito, e Claude può leggere il thread e rispondere senza che tu lo chieda.159Dopo che la tua sessione pubblica un artefatto, Claude Code osserva quell'artefatto per i commenti. Quando qualcuno che può modificare l'artefatto invia un commento a Claude, raggiunge la tua sessione subito, e Claude può leggere il thread e rispondere senza che tu lo chieda.

160 160 

161Hai bisogno di Claude Code v2.1.228 o successivo. Se hai disattivato il [recupero dei feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching), Claude Code non osserva i commenti.161Hai bisogno di Claude Code v2.1.228 o successivo. Se hai disattivato il [recupero dei feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching), Claude Code non osserva i commenti.

162 162 


174* **Ferma il task in `/tasks`**: Claude smette di rispondere su quell'artefatto finché non gli chiedi di riprendere le risposte lì. Pubblicare di nuovo l'artefatto non avvia di nuovo le risposte, e l'arresto si applica ancora quando riprendi la sessione in seguito.174* **Ferma il task in `/tasks`**: Claude smette di rispondere su quell'artefatto finché non gli chiedi di riprendere le risposte lì. Pubblicare di nuovo l'artefatto non avvia di nuovo le risposte, e l'arresto si applica ancora quando riprendi la sessione in seguito.

175* **Premi `Ctrl+X Ctrl+K` due volte entro 3 secondi**: l'accordo che [ferma ogni subagent di background in esecuzione](/docs/it/interactive-mode#general-controls) ferma anche Claude dal rispondere su ogni artefatto per il resto della sessione. Chiedere a Claude di riprendere le risposte non annulla questo arresto.175* **Premi `Ctrl+X Ctrl+K` due volte entro 3 secondi**: l'accordo che [ferma ogni subagent di background in esecuzione](/docs/it/interactive-mode#general-controls) ferma anche Claude dal rispondere su ogni artefatto per il resto della sessione. Chiedere a Claude di riprendere le risposte non annulla questo arresto.

176 176 

177Un'osservazione che Claude Code ha avviato da solo può terminare dopo che l'artefatto resta diverse ore senza attività. Per avviare di nuovo l'osservazione, pubblica di nuovo l'artefatto o chiedi a Claude di osservarlo.

178 

177Se il servizio che fornisce i commenti diventa non disponibile o smette di rispondere, Claude Code continua a provare a riconnettersi per un po', quindi smette di osservare ogni artefatto che la tua sessione stava osservando.179Se il servizio che fornisce i commenti diventa non disponibile o smette di rispondere, Claude Code continua a provare a riconnettersi per un po', quindi smette di osservare ogni artefatto che la tua sessione stava osservando.

178 180 

179<h2 id="pull-live-data-with-mcp-connectors">181<h2 id="pull-live-data-with-mcp-connectors">

best-practices.md +35 −34

Details

476***476***

477 477 

478<h2 id="automate-and-scale">478<h2 id="automate-and-scale">

479 Automatizzate e ridimensionate479 Automatizza e scala

480</h2>480</h2>

481 481 

482Una volta che siete efficaci con un Claude, moltiplicate il vostro output con sessioni parallele, modalità non interattiva e modelli di fan-out.482Una volta che sei efficace con un Claude, moltiplica il tuo output con sessioni parallele, modalità non interattiva e pattern di fan-out.

483 483 

484<h3 id="run-non-interactive-mode">484<h3 id="run-non-interactive-mode">

485 Eseguite la modalità non interattiva485 Esegui la modalità non interattiva

486</h3>486</h3>

487 487 

488<Tip>488<Tip>

489 Utilizzate `claude -p "prompt"` in CI, pre-commit hooks o script. Aggiungete `--output-format stream-json --verbose` per l'output JSON in streaming.489 Usa `claude -p "prompt"` in CI, hook pre-commit o script. Aggiungi `--output-format stream-json --verbose` per l'output JSON in streaming.

490</Tip>490</Tip>

491 491 

492Con `claude -p "your prompt"`, potete eseguire Claude in modo non interattivo, senza un prompt interattivo. L'esecuzione crea comunque una sessione ripristinabile a meno che non passiate `--no-session-persistence`. [La modalità non interattiva](/docs/it/headless) è il modo in cui integrate Claude nelle pipeline CI, pre-commit hooks o qualsiasi flusso di lavoro automatizzato. I formati di output vi permettono di analizzare i risultati a livello di programmazione: testo semplice, JSON o JSON in streaming.492Con `claude -p "your prompt"`, puoi eseguire Claude in modo non interattivo, senza un prompt interattivo. L'esecuzione crea comunque una sessione ripristinabile a meno che tu non passi `--no-session-persistence`. [La modalità non interattiva](/docs/it/headless) è il modo in cui integri Claude nelle pipeline CI, negli hook pre-commit o in qualsiasi workflow automatizzato. I formati di output ti permettono di analizzare i risultati a livello di programmazione: testo semplice, JSON o JSON in streaming.

493 493 

494```bash theme={null}494```bash theme={null}

495# One-off queries495# One-off queries


505Il primo comando stampa testo semplice. Il formato `json` restituisce un singolo oggetto JSON con un campo `result`. Il formato `stream-json` stampa un oggetto JSON per riga, iniziando con un evento di inizializzazione.505Il primo comando stampa testo semplice. Il formato `json` restituisce un singolo oggetto JSON con un campo `result`. Il formato `stream-json` stampa un oggetto JSON per riga, iniziando con un evento di inizializzazione.

506 506 

507<h3 id="run-multiple-claude-sessions">507<h3 id="run-multiple-claude-sessions">

508 Eseguite più sessioni Claude508 Esegui più sessioni Claude

509</h3>509</h3>

510 510 

511<Tip>511<Tip>

512 Eseguite più sessioni Claude in parallelo per accelerare lo sviluppo, eseguire esperimenti isolati o avviare flussi di lavoro complessi.512 Esegui più sessioni Claude in parallelo per accelerare lo sviluppo, eseguire esperimenti isolati o avviare workflow complessi.

513</Tip>513</Tip>

514 514 

515Scegliete l'approccio parallelo che si adatta a quanto coordinamento volete fare voi stessi, e aggiungete messaggistica quando le sessioni devono passarsi i risultati tra loro:515Scegli l'approccio parallelo che si adatta a quanto coordinamento vuoi fare tu stesso, e aggiungi la messaggistica quando le sessioni devono passarsi i risultati tra loro:

516 516 

517* [Worktrees](/docs/it/worktrees): eseguite sessioni CLI separate in checkout git isolati in modo che le modifiche non si scontrino517* [Worktree](/docs/it/worktrees): esegui sessioni CLI separate in checkout git isolati in modo che le modifiche non si scontrino

518* [Cross-session messaging](/docs/it/cross-session-messaging): lasciate che le sessioni che eseguite voi stessi si passino i risultati l'una all'altra518* [Messaggistica tra sessioni](/docs/it/cross-session-messaging): lascia che le sessioni che esegui tu stesso si passino i risultati l'una all'altra

519* [App desktop](/docs/it/desktop#work-in-parallel-with-sessions): gestite più sessioni locali visivamente, ciascuna nel suo worktree519* [App desktop](/docs/it/desktop#work-in-parallel-with-sessions): gestisci più sessioni locali visivamente, facoltativamente ciascuna nel proprio worktree

520* [Claude Code sul web](/docs/it/claude-code-on-the-web): eseguite sessioni nel cloud, su infrastruttura gestita da Anthropic per impostazione predefinita520* [Usa Claude Code nel cloud](/docs/it/claude-code-on-the-web): esegui sessioni su infrastruttura gestita da Anthropic per impostazione predefinita

521* [Visualizzazione agente](/docs/it/agent-view): anteprima di ricerca. Eseguite `claude agents` per inviare sessioni che continuano a funzionare in background e osservatele da una sola schermata521* [Visualizzazione agente](/docs/it/agent-view): anteprima di ricerca. Esegui `claude agents` per inviare sessioni che continuano a funzionare in background e osservale da una sola schermata

522* [Team di agenti](/docs/it/agent-teams): sperimentale e disabilitato per impostazione predefinita. Coordinamento automatizzato di più sessioni con attività condivise, messaggistica e un team lead522* [Team di agenti](/docs/it/agent-teams): sperimentale e disabilitato per impostazione predefinita. Coordinamento automatizzato di più sessioni con attività condivise, messaggistica e un team lead

523 523 

524Oltre a parallelizzare il lavoro, più sessioni consentono flussi di lavoro focalizzati sulla qualità. Un contesto fresco migliora la revisione del codice poiché Claude non sarà distorto verso il codice che ha appena scritto.524Oltre a parallelizzare il lavoro, più sessioni consentono workflow focalizzati sulla qualità. Un contesto fresco migliora la code review poiché Claude non sarà influenzato dal codice che ha appena scritto.

525 525 

526Ad esempio, utilizzate un modello Writer/Reviewer:526Ad esempio, usa un pattern Writer/Reviewer:

527 527 

528| Sessione A (Writer) | Sessione B (Reviewer) |528| Sessione A (Writer) | Sessione B (Reviewer) |

529| - | - |529| - | - |


531| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` |531| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` |

532| `Here's the review feedback: [Session B output]. Address these issues.` | |532| `Here's the review feedback: [Session B output]. Address these issues.` | |

533 533 

534Potete fare qualcosa di simile con i test: fate scrivere i test a un Claude, poi a un altro scrivere il codice per passarli.534Puoi fare qualcosa di simile con i test: fai scrivere i test a un Claude, poi a un altro il codice per superarli.

535 535 

536<h3 id="fan-out-across-files">536<h3 id="fan-out-across-files">

537 Fan out tra i file537 Fan out tra i file

538</h3>538</h3>

539 539 

540<Tip>540<Tip>

541 Eseguite un ciclo attraverso le attività chiamando `claude -p` per ciascuna. Utilizzate `--allowedTools` per limitare i permessi per le operazioni batch.541 Esegui un ciclo sulle attività chiamando `claude -p` per ciascuna. Usa `--allowedTools` per pre-approvare gli strumenti per le operazioni batch.

542</Tip>542</Tip>

543 543 

544Per migrazioni o analisi su larga scala, potete distribuire il lavoro tra molte invocazioni parallele di Claude. Eseguite [`/batch <instruction>`](/docs/it/commands#all-commands) per fare in modo che Claude divida il cambiamento tra 5 e 30 subagent. Ogni subagent lavora nel suo worktree. Per guidare il fan-out dal vostro script, eseguite un ciclo su `claude -p`:544Per migrazioni o analisi su larga scala, puoi distribuire il lavoro tra molte invocazioni parallele di Claude. Esegui [`/batch <instruction>`](/docs/it/commands#all-commands) per fare in modo che Claude divida la modifica tra 5 e 30 subagent. Ogni subagent lavora nel proprio worktree. Per guidare invece il fan-out dal tuo script, esegui un ciclo su `claude -p`:

545 545 

546<Steps>546<Steps>

547 <Step title="Generare un elenco di attività">547 <Step title="Genera un elenco di attività">

548 Fate in modo che Claude scriva l'elenco dei file che devono essere migrati in un file, in modo che il ciclo nel passaggio successivo possa leggerlo, con un prompt come `list all 2,000 Python files that need migrating and save the list to files.txt`548 Fai scrivere a Claude l'elenco dei file da migrare in un file, in modo che il ciclo nel passaggio successivo possa leggerlo, con un prompt come `list all 2,000 Python files that need migrating and save the list to files.txt`

549 </Step>549 </Step>

550 550 

551 <Step title="Scrivere uno script per eseguire un ciclo attraverso l'elenco">551 <Step title="Scrivi uno script per scorrere l'elenco">

552 ```bash theme={null}552 ```bash theme={null}

553 for file in $(cat files.txt); do553 for file in $(cat files.txt); do

554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \

555 --allowedTools "Edit,Bash(git commit *)"555 --allowedTools "Edit,Bash(git commit *)" \

556 --permission-mode dontAsk

556 done557 done

557 ```558 ```

558 </Step>559 </Step>

559 560 

560 <Step title="Testare su pochi file, quindi eseguire su larga scala">561 <Step title="Testa su pochi file, poi esegui su tutti">

561 Affinate il vostro prompt in base a quello che va male con i primi 2-3 file, quindi eseguite sull'intero set. Il flag `--allowedTools` limita quello che Claude può fare, il che è importante quando state eseguendo senza supervisione.562 Affina il tuo prompt in base a ciò che va storto con i primi 2-3 file, quindi esegui sull'intero set. Il flag `--allowedTools` pre-approva gli strumenti di cui la migrazione ha bisogno, e [`--permission-mode dontAsk`](/docs/it/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) nega qualsiasi altra cosa che richiederebbe un'approvazione, il che è importante quando esegui senza supervisione.

562 </Step>563 </Step>

563</Steps>564</Steps>

564 565 

565Potete anche integrare Claude nelle pipeline di elaborazione/dati esistenti:566Puoi anche integrare Claude nelle pipeline di elaborazione/dati esistenti:

566 567 

567```bash theme={null}568```bash theme={null}

568claude -p "<your prompt>" --output-format json | your_command569claude -p "<your prompt>" --output-format json | your_command

569```570```

570 571 

571<h3 id="run-autonomously-with-auto-mode">572<h3 id="run-autonomously-with-auto-mode">

572 Eseguite autonomamente con auto mode573 Esegui in autonomia con la modalità auto

573</h3>574</h3>

574 575 

575Per l'esecuzione ininterrotta con controlli di sicurezza in background, utilizzate [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode). Un modello classificatore esamina i comandi prima che vengono eseguiti, bloccando l'escalation di ambito, l'infrastruttura sconosciuta e le azioni guidate da contenuti ostili mentre consente al lavoro di routine di procedere senza prompt.576Per un'esecuzione ininterrotta con controlli di sicurezza in background, usa la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode). Un modello classificatore esamina i comandi prima che vengano eseguiti, bloccando l'escalation dell'ambito, l'infrastruttura sconosciuta e le azioni guidate da contenuti ostili, mentre consente al lavoro abituale di procedere senza richieste di conferma.

576 577 

577```bash theme={null}578```bash theme={null}

578claude --permission-mode auto -p "fix all lint errors"579claude --permission-mode auto -p "fix all lint errors"

579```580```

580 581 

581Quando il classificatore blocca ripetutamente le azioni in un'esecuzione non interattiva con il flag `-p`, Claude Code non interrompe l'esecuzione. Consultate [when auto mode falls back](/docs/it/permission-modes#when-auto-mode-falls-back) per quello che accade invece e per le soglie.582Quando il classificatore blocca ripetutamente le azioni in un'esecuzione non interattiva con il flag `-p`, Claude Code non interrompe l'esecuzione. Consulta [quando la modalità auto ricorre al fallback](/docs/it/permission-modes#when-auto-mode-falls-back) per sapere cosa accade invece e quali sono le soglie.

582 583 

583<h3 id="add-an-adversarial-review-step">584<h3 id="add-an-adversarial-review-step">

584 Aggiungete un passaggio di revisione avversariale585 Aggiungi un passaggio di revisione avversariale

585</h3>586</h3>

586 587 

587<Tip>588<Tip>

588 Prima di considerare un'attività come completata, fate in modo che un subagent riveda il diff in un contesto fresco e segnali le lacune.589 Prima di considerare un'attività completata, fai in modo che un subagent riveda il diff in un contesto fresco e segnali le lacune.

589</Tip>590</Tip>

590 591 

591Più a lungo Claude lavora senza supervisione, più un controllo indipendente è importante prima di contare il lavoro come completato. Un revisore che esegue in un contesto [subagent](/docs/it/sub-agents) fresco vede solo il diff e i criteri che gli date, non il ragionamento che ha prodotto il cambiamento, quindi valuta il risultato secondo i suoi stessi termini.592Più a lungo Claude lavora senza supervisione, più un controllo indipendente è importante prima di considerare il lavoro completato. Un revisore che opera in un contesto [subagent](/docs/it/sub-agents) fresco vede solo il diff e i criteri che gli fornisci, non il ragionamento che ha prodotto la modifica, quindi valuta il risultato in modo autonomo.

592 593 

593Per un controllo di correttezza, eseguite la skill [`/code-review`](/docs/it/commands) in bundle, che rivede il diff corrente per bug in un subagent fresco e restituisce i risultati alla sessione. Per controllare il diff rispetto al vostro piano, scrivete il prompt di revisione voi stessi. Nominate il lavoro da controllare, il piano da controllare e cosa conta come una lacuna:594Per un controllo di correttezza, esegui la [skill `/code-review`](/docs/it/commands) inclusa, che esamina il diff corrente alla ricerca di bug in un subagent fresco e restituisce i risultati alla sessione. Per controllare invece il diff rispetto al tuo piano, scrivi tu stesso il prompt di revisione. Indica il lavoro da controllare, il piano rispetto a cui controllarlo e cosa conta come lacuna:

594 595 

595```text wrap theme={null}596```text wrap theme={null}

596Use a subagent to review the rate limiter diff against PLAN.md. Check that597Use a subagent to review the rate limiter diff against PLAN.md. Check that


598nothing outside the task's scope changed. Report gaps, not style preferences.599nothing outside the task's scope changed. Report gaps, not style preferences.

599```600```

600 601 

601Poiché il revisore esegue come subagent, la sessione di implementazione riceve le lacune direttamente e può correggerle e riesaminarle senza che voi copiate i risultati tra le finestre.602Poiché il revisore opera come subagent, la sessione di implementazione riceve direttamente le lacune e può correggerle e ripetere la revisione senza che tu debba copiare i risultati tra le finestre.

602 603 

603<Callout>604<Callout>

604 Un revisore incaricato di trovare lacune di solito ne segnala alcune, anche quando il lavoro è solido, perché è quello che gli è stato chiesto di fare. Inseguire ogni risultato porta a un'over-engineering: strati di astrazione extra, codice difensivo e test per casi che non possono accadere. Dite al revisore di segnalare solo le lacune che influiscono sulla correttezza o sui requisiti dichiarati, e trattate il resto come facoltativo.605 Un revisore incaricato di trovare lacune di solito ne segnala alcune, anche quando il lavoro è solido, perché è quello che gli è stato chiesto di fare. Inseguire ogni risultato porta all'over-engineering: strati di astrazione extra, codice difensivo e test per casi che non possono verificarsi. Di' al revisore di segnalare solo le lacune che influiscono sulla correttezza o sui requisiti dichiarati, e tratta il resto come facoltativo.

605</Callout>606</Callout>

606 607 

607***608***

channels.md +1 −1

Details

326 Abilita i canali per la tua organizzazione326 Abilita i canali per la tua organizzazione

327</h3>327</h3>

328 328 

329Abilita i canali per la tua organizzazione da [**claude.ai → Admin settings → Claude Code → Channels**](https://claude.ai/admin-settings/claude-code), che richiede il ruolo Owner, o impostando `channelsEnabled` su `true` nelle impostazioni gestite.329Abilita i canali per la tua organizzazione da [**Organization settings > Claude Code > Channels**](https://claude.ai/admin-settings/claude-code), che richiede il ruolo Owner, o impostando `channelsEnabled` su `true` nelle impostazioni gestite.

330 330 

331Una volta abilitati, gli utenti della tua organizzazione possono usare `--channels` per optare i server di canale in sessioni individuali. Se l'impostazione è disabilitata o non impostata, il server MCP si connette comunque e i suoi strumenti funzionano, ma i messaggi del canale non arriveranno. Un avviso di avvio dice all'utente di far abilitare l'impostazione a un amministratore.331Una volta abilitati, gli utenti della tua organizzazione possono usare `--channels` per optare i server di canale in sessioni individuali. Se l'impostazione è disabilitata o non impostata, il server MCP si connette comunque e i suoi strumenti funzionano, ma i messaggi del canale non arriveranno. Un avviso di avvio dice all'utente di far abilitare l'impostazione a un amministratore.

332 332 

Details

279 279 

280La conferma richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore; un client al di sotto di quella versione ignora il campo. Il server gateway nel binario `claude` non restituisce il campo, quindi i suoi accessi si completano senza la conferma.280La conferma richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore; un client al di sotto di quella versione ignora il campo. Il server gateway nel binario `claude` non restituisce il campo, quindi i suoi accessi si completano senza la conferma.

281 281 

282Una volta che lo sviluppatore accede, il [selettore di modelli](/docs/it/model-config) mostra i modelli nella loro lista di autorizzazione `availableModels`. Le impostazioni gestite si applicano all'avvio e si aggiornano ogni ora, e la telemetria viene instradata al tuo raccoglitore.282Una volta che lo sviluppatore accede, il [selettore di modelli](/docs/it/model-config) mostra i modelli nella loro allowlist `availableModels`. Le impostazioni gestite si applicano all'avvio e si aggiornano ogni ora, e la telemetria viene instradata al tuo raccoglitore.

283 283 

284Le sessioni si aggiornano silenziosamente prima della scadenza di `ttl_hours`. Quando un aggiornamento non riesce dopo il deprovisioning dell'IdP, Claude Code chiede allo sviluppatore di accedere di nuovo.284Le sessioni si aggiornano silenziosamente prima della scadenza di `ttl_hours`. Quando un aggiornamento non riesce dopo il deprovisioning dell'IdP, Claude Code chiede allo sviluppatore di accedere di nuovo.

285 285 


287 Imposta l'URL del gateway287 Imposta l'URL del gateway

288</h3>288</h3>

289 289 

290Tre chiavi vanno nel file [impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) per OS che distribuisci tramite MDM o direttamente su disco. `forceLoginMethod` e `forceLoginGatewayUrl` aprono `/login` direttamente sulla schermata **Cloud gateway** con l'URL compilato, e `parentSettingsBehavior: "merge"` consente a Claude Desktop di fornire la lista di autorizzazione dell'uscita del gateway alle sessioni di Claude Code che avvia, spiegato in [Fornisci la politica alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions):290Tre chiavi vanno nel file [impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) per OS che distribuisci tramite MDM o direttamente su disco. `forceLoginMethod` e `forceLoginGatewayUrl` aprono `/login` direttamente sulla schermata **Cloud gateway** con l'URL compilato, e `parentSettingsBehavior: "merge"` consente a Claude Desktop di fornire l'allowlist di uscita del gateway alle sessioni di Claude Code che avvia, come spiegato in [Fornisci la politica alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions):

291 291 

292```json theme={null}292```json theme={null}

293{293{


297}297}

298```298```

299 299 

300Lo sviluppatore preme Invio per connettersi. Il [prompt di impronta TLS al primo collegamento](#connect-developers) appare ancora. Una volta che il file è su una macchina, uno sviluppatore che non ha completato l'accesso al gateway vede uno dei messaggi descritti in [La politica dell'amministratore richiede un accesso al gateway Cloud](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). Gli sviluppatori che selezionano un provider cloud tramite una variabile di ambiente come `CLAUDE_CODE_USE_BEDROCK` non hanno bisogno dell'accesso al gateway.300Lo sviluppatore preme Invio per connettersi. Il [prompt di impronta TLS al primo collegamento](#connect-developers) appare ancora. Una volta che il file è su una macchina, uno sviluppatore che non ha completato l'accesso al gateway vede uno dei messaggi descritti in [La politica dell'amministratore richiede un accesso al gateway Cloud](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). Gli sviluppatori che selezionano un provider cloud tramite una variabile d'ambiente come `CLAUDE_CODE_USE_BEDROCK` non hanno bisogno dell'accesso al gateway.

301 301 

302Uno sviluppatore non può configurarlo manualmente. Il selettore di accesso non ha opzione gateway, e `forceLoginGatewayUrl` viene ignorato nei file di impostazioni dello sviluppatore. `forceLoginMethod` da solo, senza un URL, lascia lo sviluppatore con un messaggio "Contatta il tuo amministratore IT". Le chiavi di accesso appartengono al file che distribuisci alle macchine, non al blocco `managed.policies[].cli` del gateway, che raggiunge solo i client già connessi.302Uno sviluppatore non può configurarlo manualmente. Il selettore di accesso non ha opzione gateway, e `forceLoginGatewayUrl` viene ignorato nei file di impostazioni dello sviluppatore. `forceLoginMethod` da solo, senza un URL, lascia lo sviluppatore con un messaggio "Contatta il tuo amministratore IT". Le chiavi di accesso appartengono al file che distribuisci alle macchine, non al blocco `managed.policies[].cli` del gateway, che raggiunge solo i client già connessi.

303 303 


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

314</Warning>314</Warning>

315 315 

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

317 317 

318Questo esempio dichiara un blocco. Sostituisci `203.0.113.0/24` con il tuo blocco. È un intervallo di documentazione e Claude Code rifiuta quelli.318Questo esempio dichiara un blocco. Sostituisci `203.0.113.0/24` con il tuo blocco. È un intervallo di documentazione e Claude Code rifiuta quelli.

319 319 


332 332 

333I blocchi da `managed-settings.json` e i suoi file drop-in `managed-settings.d/` si combinano in un elenco, e questi limiti si applicano all'elenco combinato. Per restringere un blocco, sostituisci la sua voce piuttosto che aggiungerne una seconda, sovrapposta in un drop-in; `/login` rifiuta la sovrapposizione.333I blocchi da `managed-settings.json` e i suoi file drop-in `managed-settings.d/` si combinano in un elenco, e questi limiti si applicano all'elenco combinato. Per restringere un blocco, sostituisci la sua voce piuttosto che aggiungerne una seconda, sovrapposta in un drop-in; `/login` rifiuta la sovrapposizione.

334 334 

335Se una voce viola una regola, o il valore non è un elenco di stringhe, Claude Code rifiuta ogni nuovo accesso al gateway su quella macchina e nomina il problema nel messaggio. L'accesso a un gateway su un indirizzo privato non riesce anche, e gli accessi esistenti continuano a funzionare. Prova il valore su una macchina prima di distribuirlo. Claude Code elenca anche un valore digitato erroneamente tra le [impostazioni gestite non valide che segnala](/docs/it/managed-settings#keys-that-fail-closed).335Se una voce viola una regola, o il valore non è un elenco di stringhe, Claude Code rifiuta ogni nuovo accesso al gateway su quella macchina e nomina il problema nel messaggio. Anche l'accesso a un gateway su un indirizzo privato non riesce, e gli accessi esistenti continuano a funzionare. Prova il valore su una macchina prima di distribuirlo. Claude Code elenca anche un valore di tipo errato tra le [impostazioni gestite non valide che segnala](/docs/it/managed-settings#keys-that-fail-closed).

336 336 

337Con un elenco valido, `/login` applica tre controlli a un gateway il cui indirizzo è all'interno di un blocco elencato:337Con un elenco valido, `/login` applica tre controlli a un gateway il cui indirizzo è all'interno di un blocco elencato:

338 338 


350 Fornisci la politica alle sessioni di Claude Desktop350 Fornisci la politica alle sessioni di Claude Desktop

351</h3>351</h3>

352 352 

353Claude Desktop esegue le sue schede Cowork e Code, più la scheda Chat quando la abiliti, su sessioni di Claude Code incorporate e invia le loro richieste di modello attraverso il gateway. Passa la politica a ciascuna di quelle sessioni, costruita dalla configurazione che il gateway serve a `/user/bootstrap`: la lista di autorizzazione dei modelli, gli strumenti disabilitati e la lista di autorizzazione dell'uscita derivata dal blocco `cli` della politica corrispondente, più l'[overlay `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay).353Claude Desktop esegue le sue schede Cowork e Code, più la scheda Chat quando la abiliti, su sessioni di Claude Code incorporate e invia le loro richieste di modello attraverso il gateway. Passa la politica a ciascuna di quelle sessioni, costruita dalla configurazione che il gateway gli serve a `/user/bootstrap`: l'allowlist dei modelli, gli strumenti disabilitati e l'allowlist di uscita derivata dal blocco `cli` della politica corrispondente, più l'[overlay `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay).

354 354 

355Altre chiavi `cli`, come hooks, `env` e regole di autorizzazione scoped come `Bash(npm *)`, raggiungono solo i client che accedono tramite `/login`. Claude Desktop legge l'URL del gateway dalla sua propria configurazione gestita e accede con il suo proprio flusso, separato dalle chiavi `forceLoginMethod` e `forceLoginGatewayUrl` in [Imposta l'URL del gateway](#set-the-gateway-url).355Altre chiavi `cli`, come gli hook, `env` e le regole di permesso con ambito come `Bash(npm *)`, raggiungono solo i client che accedono tramite `/login`. Claude Desktop legge l'URL del gateway dalla sua propria configurazione gestita e accede con il suo proprio flusso, separato dalle chiavi `forceLoginMethod` e `forceLoginGatewayUrl` in [Imposta l'URL del gateway](#set-the-gateway-url).

356 356 

357Le impostazioni passate da un processo di avvio sono impostazioni padre. Claude Code ignora le impostazioni padre su qualsiasi macchina che ha una fonte gestita distribuita dall'amministratore, a meno che la [fonte che fornisce la politica](/docs/it/managed-settings#which-managed-source-claude-code-uses) non imposti `parentSettingsBehavior: "merge"`.357Le impostazioni passate da un processo di avvio sono impostazioni padre. Claude Code ignora le impostazioni padre su qualsiasi macchina che ha una fonte gestita distribuita dall'amministratore, a meno che la [fonte che fornisce la politica](/docs/it/managed-settings#which-managed-source-claude-code-uses) non imposti `parentSettingsBehavior: "merge"`.

358 358 


360 Quali macchine hanno bisogno dell'opt-in360 Quali macchine hanno bisogno dell'opt-in

361</h4>361</h4>

362 362 

363Le macchine che eseguono solo Claude Desktop ne hanno bisogno. Claude Desktop applica la lista dei modelli e la lista degli strumenti disabilitati alle sessioni incorporate stesse, ma la lista di autorizzazione dell'uscita le raggiunge solo come impostazioni padre, sotto forma di regole di dominio `WebFetch` e regole di rete sandbox. Senza l'opt-in, quelle sessioni vengono eseguite senza la restrizione dell'uscita, e nulla ti avverte. Il gateway rifiuta comunque le richieste di inferenza per i modelli che la politica non concede.363Le macchine che eseguono solo Claude Desktop ne hanno bisogno. Claude Desktop applica direttamente la lista dei modelli e la lista degli strumenti disabilitati alle sessioni incorporate, ma l'allowlist di uscita le raggiunge solo come impostazioni padre, sotto forma di regole di dominio `WebFetch` e regole di rete della sandbox. Senza l'opt-in, quelle sessioni vengono eseguite senza la restrizione dell'uscita, e nulla ti avverte. Il gateway rifiuta comunque le richieste di inferenza per i modelli che la politica non concede.

364 364 

365Una lista di autorizzazione del marketplace dei plugin raggiunge anche le sessioni incorporate solo come impostazioni padre. Quando disattivi i marketplace dei plugin aggiunti dall'utente nella configurazione gestita di Claude Desktop, Claude Desktop 2.16120.0 o successivo nasconde i marketplace che la tua organizzazione non ha fornito e rifiuta gli install da essi. Per impedire alle sessioni incorporate di caricare i plugin già installati da quei marketplace, invia loro una lista `strictKnownMarketplaces` come impostazioni padre. Senza l'opt-in, Claude Code ignora quella lista e quei plugin continuano a caricarsi.365Anche un'allowlist dei marketplace dei plugin raggiunge le sessioni incorporate solo come impostazioni padre. Quando disattivi i marketplace dei plugin aggiunti dall'utente nella configurazione gestita di Claude Desktop, Claude Desktop 2.16120.0 o successivo nasconde i marketplace che la tua organizzazione non ha fornito e rifiuta le installazioni da essi. Per impedire alle sessioni incorporate di caricare i plugin già installati da quei marketplace, invia loro una lista `strictKnownMarketplaces` come impostazioni padre. Senza l'opt-in, Claude Code ignora quella lista e quei plugin continuano a caricarsi.

366 366 

367Le macchine in cui gli sviluppatori accedono tramite `/login` non ne hanno bisogno; ogni sessione di Claude Code recupera la sua politica dal gateway.367Le macchine in cui gli sviluppatori accedono tramite `/login` non ne hanno bisogno; ogni sessione di Claude Code recupera la sua politica dal gateway.

368 368 

369Le flotte il cui [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite non possono usarlo: Claude Code non unisce mai le impostazioni padre su quelle flotte, perché legge le impostazioni gestite solo dall'output dell'helper.369Le flotte il cui [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite non possono usarlo: Claude Code non esegue mai il merge delle impostazioni padre su quelle flotte, perché legge le impostazioni gestite solo dall'output dell'helper.

370 370 

371<h4 id="set-the-opt-in">371<h4 id="set-the-opt-in">

372 Imposta l'opt-in372 Imposta l'opt-in

373</h4>373</h4>

374 374 

375Distribuisci lo snippet di impostazioni gestite da [Imposta l'URL del gateway](#set-the-gateway-url), specchialo su qualsiasi fonte lato client che supera il file, quindi verifica.375Distribuisci lo snippet di impostazioni gestite da [Imposta l'URL del gateway](#set-the-gateway-url), replicalo su qualsiasi fonte lato client che ha la precedenza sul file, quindi verifica.

376 376 

377<Steps>377<Steps>

378 <Step title="Distribuisci l'opt-in nel file di impostazioni gestite">378 <Step title="Distribuisci l'opt-in nel file di impostazioni gestite">

379 Lo [snippet sopra](#set-the-gateway-url) include già `parentSettingsBehavior: "merge"`, quindi il file che distribuisci alle macchine lo contiene.379 Lo [snippet sopra](#set-the-gateway-url) include già `parentSettingsBehavior: "merge"`, quindi il file che distribuisci alle macchine lo contiene.

380 </Step>380 </Step>

381 381 

382 <Step title="Specchia lo snippet su qualsiasi fonte che supera il file">382 <Step title="Replica lo snippet su qualsiasi fonte che ha la precedenza sul file">

383 Claude Code legge `parentSettingsBehavior` solo dalla [fonte selezionata](/docs/it/managed-settings#which-managed-source-claude-code-uses). Aggiungere qualsiasi chiave di politica a una fonte può rendere quella fonte quella selezionata, quindi in una fonte lato client, specchia l'intero snippet piuttosto che solo `parentSettingsBehavior`. [Le impostazioni gestite lato client](/docs/it/claude-apps-gateway-config#client-side-managed-settings) copre le flotte che forniscono la politica tramite Group Policy o profili di configurazione. Un plist di preferenze gestite su macOS o una politica HKLM su Windows supera il file `managed-settings.json`, e le impostazioni gestite remote del gateway superano entrambi, quindi su macchine che accedono al gateway, imposta anche `parentSettingsBehavior` nel blocco [`cli`](/docs/it/claude-apps-gateway-config#managed) della politica del gateway.383 Claude Code legge `parentSettingsBehavior` solo dalla [fonte selezionata](/docs/it/managed-settings#which-managed-source-claude-code-uses). Aggiungere qualsiasi chiave di politica a una fonte può rendere quella fonte quella selezionata, quindi in una fonte lato client, replica l'intero snippet piuttosto che solo `parentSettingsBehavior`. [Le impostazioni gestite lato client](/docs/it/claude-apps-gateway-config#client-side-managed-settings) copre le flotte che forniscono la politica tramite Group Policy o profili di configurazione. Un plist di preferenze gestite su macOS o una politica HKLM su Windows ha la precedenza sul file `managed-settings.json`, e le impostazioni gestite remote del gateway hanno la precedenza su entrambi, quindi sulle macchine che accedono al gateway, imposta anche `parentSettingsBehavior` nel [blocco `cli`](/docs/it/claude-apps-gateway-config#managed) della politica del gateway.

384 </Step>384 </Step>

385 385 

386 <Step title="Controlla quale fonte è selezionata">386 <Step title="Controlla quale fonte è selezionata">


394 394 

395Una volta che distribuisci `parentSettingsBehavior: "merge"`, qualsiasi processo host che avvia Claude Code può fornire impostazioni padre, non solo Claude Desktop ma anche un'applicazione Agent SDK o un'estensione IDE.395Una volta che distribuisci `parentSettingsBehavior: "merge"`, qualsiasi processo host che avvia Claude Code può fornire impostazioni padre, non solo Claude Desktop ma anche un'applicazione Agent SDK o un'estensione IDE.

396 396 

397Claude Code filtra le impostazioni padre rispetto a una lista di autorizzazione di chiavi restrittive, ma alcune chiavi consentite possono concedere accesso piuttosto che limitarlo. A meno che tu non imposti i blocchi `allowManaged*Only`, le regole di autorizzazione di permesso e le liste di autorizzazione sandbox fornite dall'host si applicano comunque. Le regole di negazione e richiesta della tua politica rimangono in vigore comunque; [vengono valutate prima di qualsiasi regola di autorizzazione](/docs/it/permissions#manage-permissions).397Claude Code filtra le impostazioni padre rispetto a un'allowlist di chiavi restrittive, ma alcune chiavi consentite possono concedere accesso piuttosto che limitarlo. A meno che tu non imposti i blocchi `allowManaged*Only`, le regole di permesso allow e le allowlist della sandbox fornite dall'host si applicano comunque. Le regole deny e ask della tua politica rimangono in vigore in ogni caso; [vengono valutate prima di qualsiasi regola allow](/docs/it/permissions#manage-permissions).

398 398 

399Claude Code inoltra le voci [`sandbox.credentials`](/docs/it/settings-reference#sandbox-credentials) fornite dal padre in forma spogliata:399Claude Code inoltra le voci [`sandbox.credentials`](/docs/it/settings-reference#sandbox-credentials) fornite dal padre in forma ridotta:

400 400 

401* **Voci `deny`**: inoltrate con solo il loro `path` o `name` e la modalità.401* **Voci `deny`**: inoltrate con solo il loro `path` o `name` e la modalità.

402* **Voci di file con [`mode: mask`](/docs/it/sandboxing#mask-credential-files)**: inoltrate solo sentinel, come una maschera di file intero il cui `injectHosts` è l'elenco vuoto, quindi il proxy non sostituisce mai il valore reale per una voce fornita dal padre su nessuna piattaforma. Tutti i campi di mascheramento strutturato vengono eliminati anche, quindi un modello di estrazione fornito dal padre non può spostare una maschera più ristretta che un'altra fonte imposta per lo stesso percorso.402* **Voci di file con [`mode: mask`](/docs/it/sandboxing#mask-credential-files)**: inoltrate solo come sentinel, come una maschera di file intero il cui `injectHosts` è l'elenco vuoto, quindi il proxy non sostituisce mai il valore reale per una voce fornita dal padre su nessuna piattaforma. Vengono eliminati anche tutti i campi di mascheramento strutturato, quindi un modello di estrazione fornito dal padre non può sostituire una maschera più rigorosa che un'altra fonte imposta per lo stesso percorso.

403* **Voci `envVars` con `mode: mask`**: non inoltrate. `deny` è l'unica restrizione che il canale padre può esprimere attraverso le voci `envVars`.403* **Voci `envVars` con `mode: mask`**: non inoltrate. `deny` è l'unica restrizione che il canale padre può esprimere attraverso le voci `envVars`.

404* **[`awsPairs` e `sigv4`](/docs/it/sandboxing#re-sign-aws-requests)**: inoltrate solo restrizione. Da `sigv4`, vengono mantenuti solo i valori `deny`, e un padre che definisce un blocco `sigv4` affatto fissa tutti e tre i moduli di richiesta, `streaming`, `presigned` e `sigv4a`, a `deny`. Una coppia `awsPairs` non viene mai inoltrata in una forma che possa ri-firmare; una coppia che nomina una delle variabili AWS convenzionali viene sostituita da una voce inerte che mantiene l'accoppiamento automatico di `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN` soppresso.404* **[`awsPairs` e `sigv4`](/docs/it/sandboxing#re-sign-aws-requests)**: inoltrate solo come restrizione. Da `sigv4`, vengono mantenuti solo i valori `deny`, e un padre che definisce un blocco `sigv4` in qualsiasi forma fissa tutti e tre i moduli di richiesta, `streaming`, `presigned` e `sigv4a`, a `deny`. Una coppia `awsPairs` non viene mai inoltrata in una forma che possa ri-firmare; una coppia che nomina una delle variabili AWS convenzionali viene sostituita da una voce inerte che mantiene soppresso l'accoppiamento automatico di `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN`.

405 405 

406<h4 id="deploy-the-locks">406<h4 id="deploy-the-locks">

407 Distribuisci i blocchi407 Distribuisci i blocchi

408</h4>408</h4>

409 409 

410Per mantenere le impostazioni padre il più vicino possibile a solo restrizione come il filtro supporta, aggiungi tutti e cinque i blocchi `allowManaged*Only` e le liste di autorizzazione che governano, alle stesse fonti come l'opt-in di unione:410Per mantenere le impostazioni padre il più vicino possibile a solo restrizione quanto il filtro consente, aggiungi tutti e cinque i blocchi `allowManaged*Only`, e le allowlist che governano, alle stesse fonti dell'opt-in di merge:

411 411 

412```json theme={null}412```json theme={null}

413{413{


432}432}

433```433```

434 434 

435Una politica del sistema operativo, come una politica del registro HKLM o un plist di preferenze gestite, supera questo file, quindi fornisci l'intero snippet attraverso di esso invece del file. Le impostazioni gestite remote del gateway superano le fonti della politica del sistema operativo e del file ma raggiungono solo i client connessi. Specchia i blocchi, le liste di autorizzazione e l'opt-in di unione nel blocco [`cli`](/docs/it/claude-apps-gateway-config#managed) della politica e mantieni questo file distribuito, perché le macchine che non si connettono mai, incluse quelle che eseguono solo Claude Desktop, ottengono la loro politica dal file solo.435Una politica del sistema operativo, come una politica del registro HKLM o un plist di preferenze gestite, ha la precedenza su questo file, quindi fornisci l'intero snippet attraverso di essa invece del file. Le impostazioni gestite remote del gateway hanno la precedenza sulle fonti della politica del sistema operativo e del file ma raggiungono solo i client connessi. Replica i blocchi, le allowlist e l'opt-in di merge nel [blocco `cli`](/docs/it/claude-apps-gateway-config#managed) della politica e mantieni questo file distribuito, perché le macchine che non si connettono mai, incluse quelle che eseguono solo Claude Desktop, ottengono la loro politica solo dal file.

436 436 

437<h4 id="lock-behavior-across-sources">437<h4 id="lock-behavior-across-sources">

438 Comportamento del blocco tra le fonti438 Comportamento dei blocchi tra le fonti

439</h4>439</h4>

440 440 

441Impostare un blocco non limita gli altri; ogni chiave è documentata nel [riferimento delle impostazioni](/docs/it/settings-reference#all-settings).441Impostare un blocco non limita gli altri; ogni chiave è documentata nel [riferimento delle impostazioni](/docs/it/settings-reference#all-settings).

442 442 

443Da una fonte amministrativa al di sotto del vincitore, i due blocchi sandbox si applicano comunque, e `allowManagedPermissionRulesOnly` blocca comunque le regole di autorizzazione fornite dal padre e `additionalDirectories`. Su Claude Code v2.1.273 o successivo, il blocco del server MCP si applica anche da una fonte al di sotto del vincitore, e mentre è attivo, la lista `allowedMcpServers` gestita proviene dalla fonte amministrativa con la priorità più alta che ne imposta una.443Da una fonte di amministrazione al di sotto di quella vincente, i due blocchi della sandbox si applicano comunque, e `allowManagedPermissionRulesOnly` blocca comunque le regole allow fornite dal padre e `additionalDirectories`. Su Claude Code v2.1.273 o successivo, anche il blocco dei server MCP si applica da una fonte al di sotto di quella vincente, e mentre è attivo, la lista `allowedMcpServers` gestita proviene dalla fonte di amministrazione con la priorità più alta che ne imposta una.

444 444 

445Il blocco dei hooks e l'effetto di `allowManagedPermissionRulesOnly` sulle regole dello sviluppatore hanno bisogno della fonte vincente per impostazione predefinita; secondo l'opt-in di unione `managedSourcesBehavior` in [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources), Claude Code applica il valore più rigoroso che qualsiasi fonte imposta per ogni blocco. Su flotte [`policyHelper`](/docs/it/settings-reference#policyhelper), Claude Code legge i blocchi solo dall'output dell'helper.445Il blocco degli hook e l'effetto di `allowManagedPermissionRulesOnly` sulle regole dello sviluppatore richiedono la fonte vincente per impostazione predefinita; con l'opt-in di merge `managedSourcesBehavior` descritto in [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources), Claude Code applica il valore più rigoroso che qualsiasi fonte imposta per ogni blocco. Sulle flotte [`policyHelper`](/docs/it/settings-reference#policyhelper), Claude Code legge i blocchi solo dall'output dell'helper.

446 446 

447Ogni blocco fa sì che Claude Code ignori le voci dello sviluppatore per quella impostazione, quindi includi le liste di autorizzazione della tua organizzazione accanto ai blocchi:447Ogni blocco fa sì che Claude Code ignori le voci dello sviluppatore per quell'impostazione, quindi includi le allowlist della tua organizzazione accanto ai blocchi:

448 448 

449* **Domini di rete**: il blocco con una lista di domini gestiti vuota blocca tutto il traffico in uscita sandbox.449* **Domini di rete**: il blocco con una lista di domini gestiti vuota blocca tutto il traffico in uscita dalla sandbox.

450* **Server MCP**: il blocco senza `allowedMcpServers` in nessuna fonte amministrativa o nelle impostazioni fornite dal padre carica ogni server che `deniedMcpServers` non blocca.450* **Server MCP**: il blocco senza `allowedMcpServers` in nessuna fonte di amministrazione o nelle impostazioni fornite dal padre carica ogni server che `deniedMcpServers` non blocca.

451* **Percorsi di lettura**: le voci `allowRead` solo ri-consentono i percorsi all'interno delle regioni `denyRead`, quindi abbinale a un `denyRead` gestito.451* **Percorsi di lettura**: le voci `allowRead` ri-consentono solo i percorsi all'interno delle regioni `denyRead`, quindi abbinale a un `denyRead` gestito.

452 452 

453<h4 id="settings-the-locks-don’t-cover">453<h4 id="settings-the-locks-don’t-cover">

454 Impostazioni che i blocchi non coprono454 Impostazioni che i blocchi non coprono

455</h4>455</h4>

456 456 

457Sei impostazioni fornite dal padre passano il filtro anche con tutti e cinque i blocchi impostati. Secondo l'impostazione predefinita first-wins, un valore amministrativo blocca quello del padre solo quando si trova nella fonte amministrativa con la priorità più alta, tranne per `allowedMcpServers` mentre il [blocco del server MCP](#lock-behavior-across-sources) è attivo. Secondo l'opt-in di unione `managedSourcesBehavior`, [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quale valore della fonte si applica invece.457Queste impostazioni fornite dal padre passano il filtro anche con tutti e cinque i blocchi impostati:

458 458 

459* **`forceLoginOrgUUID`**: Claude Code onora un valore fornito dal padre quando la fonte amministrativa con la priorità più alta non imposta un UUID org. L'accesso al gateway non controlla questa chiave. Un UUID org nella fonte amministrativa con la priorità più alta blocca il valore del padre ed è quello che Claude Code applica.459* **`forceLoginOrgUUID`**: Claude Code rispetta un valore fornito dal padre quando la fonte di amministrazione con la priorità più alta non imposta un UUID org. L'accesso al gateway non controlla questa chiave. Un UUID org nella fonte di amministrazione con la priorità più alta blocca il valore del padre ed è quello che Claude Code applica.

460* **`allowedMcpServers`**: Claude Code onora una lista di autorizzazione fornita dal padre quando nessuna lista amministrativa è in vigore. `allowManagedMcpServersOnly` non la blocca, perché il blocco applica qualsiasi lista vinca come valore gestito, inclusa una fornita dal padre quando nessuna fonte amministrativa fornisce una lista. Una lista nella fonte amministrativa con la priorità più alta blocca quella del padre ed è la lista che Claude Code applica, quindi imposta `allowedMcpServers` lì, accanto al blocco. Prima della v2.1.223, un valore per una delle due chiavi in qualsiasi fonte amministrativa bloccava quella del padre.460* **`allowedMcpServers`**: Claude Code rispetta un'allowlist fornita dal padre quando nessuna lista di amministrazione è in vigore. `allowManagedMcpServersOnly` non la blocca, perché il blocco applica qualsiasi lista prevalga come valore gestito, inclusa una fornita dal padre quando nessuna fonte di amministrazione fornisce una lista. Una lista nella fonte di amministrazione con la priorità più alta blocca quella del padre ed è la lista che Claude Code applica, quindi imposta `allowedMcpServers` lì, accanto al blocco. Prima della v2.1.223, un valore per una delle due chiavi in qualsiasi fonte di amministrazione bloccava quello del padre.

461* **`availableModels`**: Claude Code onora una lista di modelli fornita dal padre quando la fonte gestita vincente non ne imposta una. Se la tua flotta limita i modelli, imposta `availableModels` nella fonte vincente.461* **`availableModels`**: Claude Code rispetta una lista di modelli fornita dal padre quando la fonte gestita vincente non ne imposta una. Se la tua flotta limita i modelli, imposta `availableModels` nella fonte vincente.

462* **`strictKnownMarketplaces`**: Claude Code onora una lista di autorizzazione del marketplace dei plugin fornita dal padre quando la fonte gestita vincente non ne imposta una. Claude Desktop 2.16120.0 o successivo ne invia una quando la sua configurazione gestita disattiva i marketplace dei plugin aggiunti dall'utente. Se la tua flotta limita i marketplace, imposta `strictKnownMarketplaces` nella fonte vincente. Richiede Claude Code v2.1.282 o successivo.462* **`allowedProviders`**: Claude Code rispetta un'allowlist di provider API fornita dal padre quando la fonte gestita vincente non ne imposta una. Se la tua flotta limita i provider API che gli sviluppatori possono usare, imposta `allowedProviders` nella fonte vincente. Richiede Claude Code v2.1.285 o successivo.

463* **`blockedMarketplaces`**: una lista di blocco del marketplace fornita dal padre passa e si aggiunge a qualsiasi lista di blocco che una fonte gestita imposta, poiché una lista di blocco può solo limitare ulteriormente. Richiede Claude Code v2.1.282 o successivo.463* **`strictKnownMarketplaces`**: Claude Code rispetta un'allowlist dei marketplace dei plugin fornita dal padre quando la fonte gestita vincente non ne imposta una. Claude Desktop 2.16120.0 o successivo ne invia una quando la sua configurazione gestita disattiva i marketplace dei plugin aggiunti dall'utente. Se la tua flotta limita i marketplace, imposta `strictKnownMarketplaces` nella fonte vincente. Richiede Claude Code v2.1.282 o successivo.

464* **`strictPluginOnlyCustomization`**: questa chiave passa il filtro indipendentemente da qualsiasi blocco, e fa sì che Claude Code ignori la personalizzazione dello sviluppatore, inclusi i hooks protettivi. Nessun blocco la blocca.464* **`blockedMarketplaces`**: una lista di blocco dei marketplace fornita dal padre passa e si aggiunge a qualsiasi lista di blocco che una fonte gestita imposta, poiché una lista di blocco può solo limitare ulteriormente. Richiede Claude Code v2.1.282 o successivo.

465* **`strictPluginOnlyCustomization`**: questa chiave passa il filtro indipendentemente da qualsiasi blocco, e fa sì che Claude Code ignori la personalizzazione dello sviluppatore, inclusi gli hook protettivi. Nessun blocco la blocca.

466 

467Con l'impostazione predefinita first-wins, un valore di amministrazione blocca quello del padre solo quando si trova nella fonte di amministrazione con la priorità più alta, tranne per `allowedMcpServers` mentre il [blocco dei server MCP](#lock-behavior-across-sources) è attivo. Con l'opt-in di merge `managedSourcesBehavior`, [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) indica invece quale valore di fonte si applica.

465 468 

466<h3 id="connect-claude-desktop">469<h3 id="connect-claude-desktop">

467 Connetti Claude Desktop470 Connetti Claude Desktop

468</h3>471</h3>

469 472 

470[Claude Desktop](/docs/it/desktop) si connette allo stesso gateway attraverso una chiave MDM diversa: imposta `bootstrapUrl` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop a `<listen.public_url>/user/bootstrap`, e opt-in della politica dell'utente con una chiave `desktop`. [L'overlay di Claude Desktop](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) copre entrambe le metà. Richiede Claude Code v2.1.203 o successivo sul server gateway.473[Claude Desktop](/docs/it/desktop) si connette allo stesso gateway attraverso una chiave MDM diversa: imposta `bootstrapUrl` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop a `<listen.public_url>/user/bootstrap`, e abilita l'opt-in della politica dell'utente con una chiave `desktop`. [L'overlay di Claude Desktop](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) copre entrambe le metà. Richiede Claude Code v2.1.203 o successivo sul server gateway.

471 474 

472Claude Desktop accede allo sviluppatore tramite il provider di identità del gateway con lo stesso passaggio SSO del browser, quindi recupera la sua configurazione dal gateway invece che da Anthropic. L'accesso al modello e la politica seguono le stesse regole per gruppo dell'interfaccia della riga di comando. Uno sviluppatore che utilizza sia l'interfaccia della riga di comando che Claude Desktop accede a ciascuno separatamente; la sessione del gateway non è condivisa tra loro.475Claude Desktop fa accedere lo sviluppatore tramite il provider di identità del gateway con lo stesso passaggio SSO nel browser, quindi recupera la sua configurazione dal gateway invece che da Anthropic. L'accesso ai modelli e la politica seguono le stesse regole per gruppo della CLI. Uno sviluppatore che utilizza sia la CLI che Claude Desktop accede a ciascuno separatamente; la sessione del gateway non è condivisa tra loro.

473 476 

474Una volta connesso, Claude Desktop invia richieste di modello da ogni scheda abilitata attraverso il gateway. Mostra le schede Cowork e Code per impostazione predefinita. Per attivare anche la scheda Chat, imposta `chatTabEnabled` a `true` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop, o nel blocco [`desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) della politica su un gateway che esegue Claude Code v2.1.227 o successivo.477Una volta connesso, Claude Desktop invia richieste di modello da ogni scheda abilitata attraverso il gateway. Mostra le schede Cowork e Code per impostazione predefinita. Per attivare anche la scheda Chat, imposta `chatTabEnabled` a `true` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop, o nel [blocco `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) della politica su un gateway che esegue Claude Code v2.1.227 o successivo.

475 478 

476<h3 id="ci-pipelines-and-remote-machines">479<h3 id="ci-pipelines-and-remote-machines">

477 Pipeline CI e macchine remote480 Pipeline CI e macchine remote

478</h3>481</h3>

479 482 

480Non esiste un flusso di token di servizio per le pipeline non presenziate. L'accesso al gateway esegue sempre il flusso del dispositivo del browser, quindi un lavoro CI senza uno sviluppatore per approvare l'accesso non può autenticarsi; configura quelli direttamente contro il tuo provider.483Non esiste un flusso di token di servizio per le pipeline non presidiate. L'accesso al gateway esegue sempre il flusso del dispositivo nel browser, quindi un job CI senza uno sviluppatore che approvi l'accesso non può autenticarsi; configura questi job direttamente con il tuo provider.

481 484 

482Una volta che uno sviluppatore ha effettuato l'accesso, ogni sessione di Claude Code su quella macchina utilizza la sessione del gateway, incluse le esecuzioni non interattive `claude -p` e le sessioni avviate dall'Agent SDK. Claude Code applica la [politica del gateway](/docs/it/claude-apps-gateway-config#managed) a ciascuna di esse.485Una volta che uno sviluppatore ha effettuato l'accesso, ogni sessione di Claude Code su quella macchina utilizza la sessione del gateway, incluse le esecuzioni non interattive `claude -p` e le sessioni avviate dall'Agent SDK. Claude Code applica la [politica del gateway](/docs/it/claude-apps-gateway-config#managed) a ciascuna di esse.

483 486 

484Il flusso del dispositivo separa l'interfaccia della riga di comando di polling dal browser di approvazione, quindi una casella di sviluppo remota senza display funziona comunque: lo sviluppatore esegue `/login` su SSH sulla macchina remota e apre il collegamento di verifica nel browser sul suo laptop.487Il flusso del dispositivo separa la CLI che esegue il polling dal browser che approva, quindi una macchina di sviluppo remota senza display funziona comunque: lo sviluppatore esegue `/login` via SSH sulla macchina remota e apre il link di verifica nel browser sul suo laptop.

485 488 

486<h3 id="whats-enforced-on-developers">489<h3 id="whats-enforced-on-developers">

487 Cosa viene applicato agli sviluppatori490 Cosa viene applicato agli sviluppatori

488</h3>491</h3>

489 492 

490Queste garanzie si applicano a ogni sessione connessa tramite `/login`. Le sessioni incorporate che Claude Desktop avvia ottengono la loro politica come descritto in [Fornisci la politica alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions), e il punto della telemetria dice dove vanno le loro esportazioni.493Queste garanzie si applicano a ogni sessione connessa tramite `/login`. Le sessioni incorporate che Claude Desktop avvia ottengono la loro politica come descritto in [Fornisci la politica alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions), e il punto sulla telemetria indica dove vanno le loro esportazioni.

491 494 

492* **Accesso al modello**: le richieste per i modelli che la politica non concede restituiscono 400, e il selettore `/model` viene filtrato alla lista di autorizzazione `availableModels` della politica. Imposta [`enforceAvailableModels: true`](/docs/it/model-config#default-model-behavior) nella politica in modo che l'opzione Predefinito si risolva in un modello all'interno di `availableModels` invece che nel predefinito integrato di Claude Code; senza di esso, Predefinito rimane selezionabile e viene rifiutato al momento della richiesta se quel modello non è concesso.495* **Accesso ai modelli**: le richieste per i modelli che la politica non concede restituiscono 400, e il selettore `/model` viene filtrato all'allowlist `availableModels` della politica. Questo include il modello con cui una sessione si avvia prima che lo sviluppatore ne scelga uno; consulta [Avvia le sessioni su un modello consentito dalla politica](/docs/it/claude-apps-gateway-config#start-sessions-on-a-model-the-policy-allows).

493* **Destinazione della telemetria**: nelle sessioni connesse tramite `/login`, l'interfaccia della riga di comando invia le sue esportazioni OTLP/HTTP al gateway piuttosto che a un `OTEL_EXPORTER_OTLP_ENDPOINT` impostato localmente, a meno che una politica non [nomini il tuo raccoglitore come endpoint](/docs/it/claude-apps-gateway-config#export-directly-to-your-collector). Il gateway inoltra le esportazioni che riceve alle destinazioni in [`telemetry.forward_to`](/docs/it/claude-apps-gateway-config#telemetry).496* **Destinazione della telemetria**: nelle sessioni connesse tramite `/login`, la CLI invia le sue esportazioni OTLP/HTTP al gateway piuttosto che a un `OTEL_EXPORTER_OTLP_ENDPOINT` impostato localmente, a meno che una politica non [indichi il tuo raccoglitore come endpoint](/docs/it/claude-apps-gateway-config#export-directly-to-your-collector). Il gateway inoltra le esportazioni che riceve alle destinazioni in [`telemetry.forward_to`](/docs/it/claude-apps-gateway-config#telemetry).

494 * Nelle sessioni incorporate che [Claude Desktop avvia](#connect-claude-desktop), l'interfaccia della riga di comando invia le sue esportazioni al `OTEL_EXPORTER_OTLP_ENDPOINT` configurato. L'interfaccia della riga di comando allega il token di sessione del gateway a quelle esportazioni solo quando quell'endpoint punta al gateway stesso.497 * Nelle sessioni incorporate che [Claude Desktop avvia](#connect-claude-desktop), la CLI invia le sue esportazioni al `OTEL_EXPORTER_OTLP_ENDPOINT` configurato. La CLI allega il token di sessione del gateway a quelle esportazioni solo quando quell'endpoint punta al gateway stesso.

495 * Senza una destinazione configurata per un segnale, il gateway lo accetta e lo scarta.498 * Senza una destinazione configurata per un segnale, il gateway lo accetta e lo scarta.

496 * Se raccogli già la telemetria di Claude Code direttamente, aggiungi il tuo raccoglitore come destinazione `forward_to`, o nominalo in una politica per saltare l'inoltro.499 * Se raccogli già la telemetria di Claude Code direttamente, aggiungi il tuo raccoglitore come destinazione `forward_to`, o indicalo in una politica per saltare l'inoltro.

497* **Credenziali**: il token del gateway è l'unica credenziale della sessione. I [profili Anthropic](/docs/it/authentication#anthropic-profiles-and-federation-credentials) e qualsiasi accesso precedente a claude.ai vengono ignorati mentre connessi, quindi gli sviluppatori non hanno bisogno di disconnettersi da claude.ai prima. Per una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` configurata, o una chiave API salvata da un accesso precedente a Claude Console, vedi [La politica dell'amministratore richiede un accesso al gateway Cloud](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in).500* **Credenziali**: il token del gateway è l'unica credenziale della sessione. I [profili Anthropic](/docs/it/authentication#anthropic-profiles-and-federation-credentials) e qualsiasi accesso precedente a claude.ai vengono ignorati mentre sei connesso, quindi gli sviluppatori non hanno bisogno di disconnettersi prima da claude.ai. Per una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` configurata, o una chiave API salvata da un accesso precedente a Claude Console, consulta [La politica dell'amministratore richiede un accesso al gateway Cloud](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in).

498* **Impostazioni gestite**: le chiavi bloccate non possono essere ignorate localmente. L'interfaccia della riga di comando applica la politica all'avvio e applica le modifiche ad ogni sondaggio orario, a parte i [cambiamenti che si applicano solo al prossimo avvio](/docs/it/server-managed-settings#fetch-and-caching-behavior).501* **Impostazioni gestite**: le chiavi bloccate non possono essere sovrascritte localmente. La CLI applica la politica all'avvio e applica le modifiche a ogni polling orario, a parte le [modifiche che si applicano solo al prossimo avvio](/docs/it/server-managed-settings#fetch-and-caching-behavior).

499* **Avvio con il gateway irraggiungibile**: le sessioni connesse escono all'avvio con un errore dopo circa 10 secondi piuttosto che avviarsi senza le loro impostazioni.502* **Avvio con il gateway irraggiungibile**: le sessioni connesse escono all'avvio con un errore dopo circa 10 secondi piuttosto che avviarsi senza le loro impostazioni.

500* **Avvio dopo che il gateway termina la sessione**: vedi [Applica l'avvio fail-closed](/docs/it/server-managed-settings#enforce-fail-closed-startup) per gli avvii che si aprono disconnessi dal gateway e quelli che escono quando il gateway risponde con un `401`.503* **Avvio dopo che il gateway termina la sessione**: consulta [Applica l'avvio fail-closed](/docs/it/server-managed-settings#enforce-fail-closed-startup) per gli avvii che si aprono disconnessi dal gateway e quelli che escono quando il gateway risponde con un `401`.

501* **Deprovisioning**: una sessione il cui utente è disabilitato nell'IdP scade entro `ttl_hours` quando il prossimo aggiornamento non riesce.504* **Deprovisioning**: una sessione il cui utente è disabilitato nell'IdP scade entro `ttl_hours` quando il prossimo aggiornamento non riesce.

502* **Disconnessione**: `/logout` elimina la credenziale del gateway dalla macchina dello sviluppatore.505* **Disconnessione**: `/logout` elimina la credenziale del gateway dalla macchina dello sviluppatore.

503 * Quando il documento di scoperta del gateway pubblicizza un `revocation_endpoint` sullo schema, host e porta dell'URL del gateway, `/logout` invia anche i token archiviati a quell'endpoint in modo che il gateway possa terminare la sessione dal suo lato. La richiesta è best effort, quindi la disconnessione si completa sulla macchina dello sviluppatore indipendentemente dal fatto che l'endpoint risponda. La revoca richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore.506 * Quando il documento di discovery del gateway pubblicizza un `revocation_endpoint` sullo stesso schema, host e porta dell'URL del gateway, `/logout` invia anche i token archiviati a quell'endpoint in modo che il gateway possa terminare la sessione dal suo lato. La richiesta è best effort, quindi la disconnessione si completa sulla macchina dello sviluppatore indipendentemente dal fatto che l'endpoint risponda. La revoca richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore.

504 * Il server gateway nel binario `claude` non ne pubblicizza nessuno, quindi una disconnessione da esso termina la sessione sulla macchina dello sviluppatore solo. Per forzare le sessioni fuori dal lato server, vedi [Rotazione della chiave JWT](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation).507 * Il server gateway nel binario `claude` non ne pubblicizza nessuno, quindi una disconnessione da esso termina la sessione solo sulla macchina dello sviluppatore. Per forzare la chiusura delle sessioni lato server, consulta [Rotazione del segreto JWT](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation).

505 508 

506<h3 id="what-the-organization-can-see">509<h3 id="what-the-organization-can-see">

507 Cosa può vedere l'organizzazione510 Cosa può vedere l'organizzazione

508</h3>511</h3>

509 512 

510La telemetria di utilizzo contiene l'identità dello sviluppatore, i conteggi dei token, il modello e la latenza al raccoglitore dell'organizzazione. Il gateway non registra o archivia il contenuto del prompt o del completamento. Se viene raccolta una telemetria più ricca come log e tracce, che può includere comandi e percorsi di file, è la [scelta per destinazione](/docs/it/claude-apps-gateway-config#telemetry) dell'organizzazione.513La telemetria di utilizzo porta al raccoglitore dell'organizzazione l'identità dello sviluppatore, i conteggi dei token, il modello e la latenza. Il gateway non registra né archivia il contenuto dei prompt o dei completamenti. Se venga raccolta una telemetria più ricca come log e tracce, che può includere comandi e percorsi di file, è una [scelta per destinazione](/docs/it/claude-apps-gateway-config#telemetry) dell'organizzazione.

511 514 

512<h2 id="availability-and-limitations">515<h2 id="availability-and-limitations">

513 Disponibilità e limitazioni516 Disponibilità e limitazioni


515 518 

516La tabella copre quali funzionalità di Claude Code funzionano quando gli sviluppatori si connettono attraverso il gateway e cosa supporta il server gateway stesso. Dove qualcosa non è supportato, la colonna Note fornisce l'alternativa.519La tabella copre quali funzionalità di Claude Code funzionano quando gli sviluppatori si connettono attraverso il gateway e cosa supporta il server gateway stesso. Dove qualcosa non è supportato, la colonna Note fornisce l'alternativa.

517 520 

518Il gateway consegna i valori [`anthropic-beta`](https://platform.claude.com/docs/en/api/beta-headers) che il CLI invia a ogni upstream, quindi gli operatori non mantengono un elenco di autorizzazioni beta. Per Amazon Bedrock, che ignora l'intestazione, il gateway sposta i valori nel campo `anthropic_beta` del corpo della richiesta; gli altri upstream ricevono l'intestazione come inviata.521Il gateway consegna i valori [`anthropic-beta`](https://platform.claude.com/docs/en/api/beta-headers) che il CLI invia a ogni upstream, quindi gli operatori non mantengono un'allowlist beta. Per Amazon Bedrock, che ignora l'intestazione, il gateway sposta i valori nel campo `anthropic_beta` del corpo della richiesta; gli altri upstream ricevono l'intestazione come inviata.

519 522 

520| Funzionalità | Stato | Note |523| Funzionalità | Stato | Note |

521| - | - | - |524| - | - | - |

522| Inoltro di inferenza (Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, Microsoft Foundry, Anthropic) | Disponibile | Con traduzione del modello per upstream e failover. L'upstream Amazon Bedrock utilizza l'endpoint `bedrock-runtime` e la catena di credenziali predefinita AWS; l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock non è un upstream supportato. L'[upstream Claude Platform su AWS](/docs/it/claude-apps-gateway-config#claude-platform-on-aws) richiede Claude Code v2.1.198 o successivo sul server gateway. |525| Inoltro di inferenza (Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, Microsoft Foundry, Anthropic) | Disponibile | Con traduzione del modello per upstream e failover. L'upstream Amazon Bedrock utilizza l'endpoint `bedrock-runtime` e la catena di credenziali predefinita AWS. L'[upstream Amazon Bedrock Mantle](/docs/it/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) richiede Claude Code v2.1.283 o successivo sul server gateway, e l'[upstream Claude Platform su AWS](/docs/it/claude-apps-gateway-config#claude-platform-on-aws) richiede v2.1.198 o successivo. |

523| Accesso ai modelli e impostazioni gestite per gruppo IdP | Disponibile | L'accesso ai modelli viene applicato lato server; le impostazioni gestite vengono consegnate per gruppo IdP e applicate dal CLI al [livello di impostazioni gestite](/docs/it/settings#settings-precedence) |526| Accesso ai modelli e impostazioni gestite per gruppo IdP | Disponibile | L'accesso ai modelli viene applicato lato server; le impostazioni gestite vengono consegnate per gruppo IdP e applicate dal CLI al [livello di impostazioni gestite](/docs/it/settings#settings-precedence) |

524| Claude Desktop | Disponibile con consenso esplicito | Il gateway fornisce la configurazione di Claude Desktop su `/user/bootstrap` una volta che una politica [acconsente con una chiave `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay), e Claude Desktop invia richieste di modello dalle sue schede Cowork e Code, e dalla scheda Chat quando la abiliti, attraverso il gateway. Per attivare la scheda Chat, vedi [Connetti Claude Desktop](#connect-claude-desktop). Richiede Claude Code v2.1.203 o successivo sul server gateway. |527| Claude Desktop | Disponibile con consenso esplicito | Il gateway fornisce la configurazione di Claude Desktop su `/user/bootstrap` una volta che una politica [acconsente con una chiave `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay), e Claude Desktop invia richieste di modello dalle sue schede Cowork e Code, e dalla scheda Chat quando la abiliti, attraverso il gateway. Per attivare la scheda Chat, vedi [Connetti Claude Desktop](#connect-claude-desktop). Richiede Claude Code v2.1.203 o successivo sul server gateway. |

525| Fan-out di telemetria (OTLP/HTTP) | Disponibile | Identità-timbrato per esportazione; entrambe le codifiche protobuf e JSON |528| Fan-out di telemetria (OTLP/HTTP) | Disponibile | Identità-timbrato per esportazione; entrambe le codifiche protobuf e JSON |


529| [Remote Control](/docs/it/remote-control) | Non disponibile | Il CLI mostra [un errore che nomina il gateway](/docs/it/errors#remote-control-requires-the-anthropic-api) |532| [Remote Control](/docs/it/remote-control) | Non disponibile | Il CLI mostra [un errore che nomina il gateway](/docs/it/errors#remote-control-requires-the-anthropic-api) |

530| [`/design-sync`](/docs/it/commands#all-commands) e `/design-login` | Non disponibile | Entrambi hanno bisogno di claude.ai, che il CLI non contatta sulle sessioni del gateway, quindi nessuno dei due comandi appare lì |533| [`/design-sync`](/docs/it/commands#all-commands) e `/design-login` | Non disponibile | Entrambi hanno bisogno di claude.ai, che il CLI non contatta sulle sessioni del gateway, quindi nessuno dei due comandi appare lì |

531| Funzionalità che necessitano di recupero dei flag di funzionalità, come `/import` e `claude import` | Non disponibile | Il CLI salta il recupero dei flag sulle sessioni del gateway. [Funzionalità che necessitano di recupero dei flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching) elenca cosa questo disattiva |534| Funzionalità che necessitano di recupero dei flag di funzionalità, come `/import` e `claude import` | Non disponibile | Il CLI salta il recupero dei flag sulle sessioni del gateway. [Funzionalità che necessitano di recupero dei flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching) elenca cosa questo disattiva |

532| Caching del prompt standard | Disponibile | Il gateway inoltri i breakpoint `cache_control` a ogni upstream. [Dove risiede la cache](/docs/it/prompt-caching#where-the-cache-lives) copre quali blocchi il CLI contrassegna, incluso il contesto di sistema che aggiunge a metà conversazione |535| Prompt caching standard | Disponibile | Il gateway inoltra i breakpoint `cache_control` a ogni upstream. [Dove risiede la cache](/docs/it/prompt-caching#where-the-cache-lives) copre quali blocchi il CLI contrassegna, incluso il contesto di sistema che aggiunge a metà conversazione |

533| TTL cache di 1 ora | Non disponibile | Il CLI omette il beta della cache estesa sulle sessioni del gateway, perché non ogni upstream a cui il gateway può instradare supporta il TTL di 1 ora, quindi il caching del prompt attraverso il gateway utilizza il TTL di 5 minuti; vedi la nota dell'intestazione beta sopra |536| TTL cache di 1 ora | Non disponibile | Il CLI omette il beta della cache estesa sulle sessioni del gateway, perché non ogni upstream a cui il gateway può instradare supporta il TTL di 1 ora, quindi il prompt caching attraverso il gateway utilizza il TTL di 5 minuti; vedi la nota dell'intestazione beta sopra |

534| Modalità Auto | Disponibile | Segue le [regole del provider di terze parti](/docs/it/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry): solo i modelli idonei sui provider di terze parti possono usarlo. Prima della v2.1.207, la modalità auto sulle sessioni del gateway richiedeva l'impostazione di `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, consegnabile tramite il blocco `env` della politica gestita |537| Modalità auto | Disponibile | Segue le [regole del provider di terze parti](/docs/it/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry): solo i modelli idonei sui provider di terze parti possono usarla. Prima della v2.1.207, la modalità auto sulle sessioni del gateway richiedeva l'impostazione di `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, consegnabile tramite il blocco `env` della politica gestita |

535| Ottimizzazioni solo per la prima parte come ambito cache globale e strumenti efficienti in termini di token | Non disponibile | Il CLI non le abilita sulle sessioni del gateway; vedi la nota dell'intestazione beta sopra |538| Ottimizzazioni solo per la prima parte come ambito cache globale e strumenti efficienti in termini di token | Non disponibile | Il CLI non le abilita sulle sessioni del gateway; vedi la nota dell'intestazione beta sopra |

536| OTLP/gRPC | Non supportato | OTLP su HTTP solo |539| OTLP/gRPC | Non supportato | OTLP su HTTP solo |

537| SAML, LDAP e altri auth non OIDC | Non supportato | Solo OIDC. Fronte con un ponte OIDC se necessario |540| SAML, LDAP e altri auth non OIDC | Non supportato | Solo OIDC. Fronte con un ponte OIDC se necessario |

Details

242 242 

243`upstreams` è un elenco ordinato. Il gateway inoltra l'inferenza al primo upstream che risolve il modello richiesto.243`upstreams` è un elenco ordinato. Il gateway inoltra l'inferenza al primo upstream che risolve il modello richiesto.

244 244 

245Su `5xx`, `429`, `401`, `403`, `404` o timeout il gateway esegue il failover all'upstream successivo; sugli altri `4xx` no, perché questi errori sono attribuibili alla richiesta anziché all'upstream. Un `401` o `403` significa che la credenziale usata dal gateway verso quell'upstream non ha funzionato. Un `404` significa che quell'upstream non serve il modello richiesto, quindi un upstream successivo nell'elenco può ancora servirlo.245Su `5xx`, `429`, `401`, `403`, `404` o timeout il gateway esegue il failover all'upstream successivo; sugli altri `4xx` no, perché questi errori sono attribuibili alla richiesta anziché all'upstream. Un `401` o `403` significa che l'upstream ha rifiutato la credenziale usata dal gateway o gli ha negato l'accesso, ad esempio al modello richiesto. Un `404` significa che quell'upstream non serve il modello richiesto, quindi un upstream successivo nell'elenco può ancora servirlo.

246 246 

247Se imposti `forward_user_identity: true` su un upstream, un `429` che questo restituisce a una richiesta che portava l'email dello sviluppatore non esegue il failover. Consulta [come un rifiuto per limite per utente raggiunge lo sviluppatore](#per-user-identity-headers-for-a-proxy-you-run).247Se imposti `forward_user_identity: true` su un upstream, un `429` che questo restituisce a una richiesta che portava l'email dello sviluppatore non esegue il failover. Consulta [come un rifiuto per limite per utente raggiunge lo sviluppatore](#per-user-identity-headers-for-a-proxy-you-run).

248 248 


401 401 

402Imposta `guardrail` su ogni upstream `bedrock` o su nessuno. Il gateway si rifiuta di avviarsi con una configurazione mista, perché altrimenti il [failover](#multiple-upstreams) potrebbe inviare una richiesta a un upstream Bedrock privo di guardrail.402Imposta `guardrail` su ogni upstream `bedrock` o su nessuno. Il gateway si rifiuta di avviarsi con una configurazione mista, perché altrimenti il [failover](#multiple-upstreams) potrebbe inviare una richiesta a un upstream Bedrock privo di guardrail.

403 403 

404Il guardrail copre solo gli upstream Bedrock. Se elenchi un altro provider in `upstreams`, il gateway invia le richieste a quel provider senza il guardrail.404Il guardrail copre solo gli upstream Bedrock. Se elenchi un altro provider in `upstreams`, il gateway invia le richieste a quel provider senza il guardrail, oppure si rifiuta di avviarsi se quel provider è [`mantle`](#amazon-bedrock-mantle-endpoint).

405 405 

406Quando una richiesta `/v1/messages` il cui corpo contiene un campo `amazon-bedrock-*`, come `amazon-bedrock-guardrailConfig`, raggiunge un upstream Bedrock con `guardrail` impostato, il gateway risponde 400 invece di inoltrarla.406Quando una richiesta `/v1/messages` il cui corpo contiene un campo `amazon-bedrock-*`, come `amazon-bedrock-guardrailConfig`, raggiunge un upstream Bedrock con `guardrail` impostato, il gateway risponde 400 invece di inoltrarla.

407 407 


451* Se STS rifiuta o non è raggiungibile, il gateway non invia la richiesta con le credenziali proprie dell'upstream. Registra l'errore STS con ciò che occorre verificare, quindi prova l'upstream successivo che hai elencato. [Messaggi di errore dell'upstream](#upstream-error-messages) descrive ciò che riceve il client quando nessun upstream ha successo. Un upstream successivo senza `assume_role` servirebbe la richiesta con le proprie credenziali, quindi elencane uno solo se è ciò che desideri.451* Se STS rifiuta o non è raggiungibile, il gateway non invia la richiesta con le credenziali proprie dell'upstream. Registra l'errore STS con ciò che occorre verificare, quindi prova l'upstream successivo che hai elencato. [Messaggi di errore dell'upstream](#upstream-error-messages) descrive ciò che riceve il client quando nessun upstream ha successo. Un upstream successivo senza `assume_role` servirebbe la richiesta con le proprie credenziali, quindi elencane uno solo se è ciò che desideri.

452* Il gateway chiama l'endpoint STS regionale `sts.<region>.amazonaws.com`, che la sua rete deve poter raggiungere. Per l'endpoint FIPS, imposta `AWS_USE_FIPS_ENDPOINT=true` nell'ambiente del gateway anziché `use_fips_endpoint` in un file di configurazione AWS.452* Il gateway chiama l'endpoint STS regionale `sts.<region>.amazonaws.com`, che la sua rete deve poter raggiungere. Per l'endpoint FIPS, imposta `AWS_USE_FIPS_ENDPOINT=true` nell'ambiente del gateway anziché `use_fips_endpoint` in un file di configurazione AWS.

453* `assume_role` si applica solo a `provider: bedrock` e richiede credenziali di origine SigV4: il gateway si rifiuta di avviarsi quando è impostato insieme a `aws_bearer_token`.453* `assume_role` si applica solo a `provider: bedrock` e richiede credenziali di origine SigV4: il gateway si rifiuta di avviarsi quando è impostato insieme a `aws_bearer_token`.

454* Ogni sviluppatore ammesso dal gateway può usare questo upstream; [`managed`](#managed) stabilisce quali sviluppatori possono usare quali modelli. Per evitare che un modello servito tramite il ruolo venga servito anche da un altro account, assegnagli un id personalizzato la cui mappa `upstream_model` contenga solo il nome di questo upstream. Per un id di questo tipo il gateway salta ogni altro upstream, quindi né la richiesta né il conteggio dei token per una richiesta interrotta possono eseguire il failover su un altro account. I nomi dei modelli integrati vengono comunque provati su ogni upstream in ordine, questo incluso, e una richiesta che lo raggiunge viene firmata con lo stesso ruolo, quindi elenca questo upstream per ultimo a meno che anche il suo account non debba servirli.454* Ogni sviluppatore ammesso dal gateway può usare questo upstream; [`managed`](#managed) stabilisce quali sviluppatori possono usare quali modelli. Per evitare che un modello servito tramite il ruolo venga servito anche da un altro account, assegnagli un id personalizzato la cui mappa `upstream_model` contenga solo il nome di questo upstream. Per un id di questo tipo il gateway salta ogni altro upstream, quindi né la richiesta né il conteggio dei token per una richiesta interrotta possono eseguire il failover su un altro account. Una richiesta per il nome di un modello integrato può comunque [raggiungere questo upstream](#multiple-upstreams), e il gateway la firma con lo stesso ruolo. Elenca questo upstream per ultimo a meno che anche il suo account non debba servire quei modelli.

455 455 

456Questo esempio assegna a un modello un id personalizzato che solo l'upstream isolato serve:456Questo esempio assegna a un modello un id personalizzato che solo l'upstream isolato serve:

457 457 


490 490 

491Per un'attribuzione rigorosa per sviluppatore, imposta `assume_role` con `session_name` su ogni upstream Bedrock che elenchi. Un upstream senza di esso firma le richieste che serve con le proprie credenziali.491Per un'attribuzione rigorosa per sviluppatore, imposta `assume_role` con `session_name` su ogni upstream Bedrock che elenchi. Un upstream senza di esso firma le richieste che serve con le proprie credenziali.

492 492 

493<h4 id="amazon-bedrock-mantle-endpoint">

494 Endpoint Mantle di Amazon Bedrock

495</h4>

496 

497Il provider `mantle` invia l'inferenza all'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock. Richiede Claude Code v2.1.283 o successivo sul server del gateway. Le versioni precedenti del gateway lo rifiutano all'avvio, quindi aggiorna ogni replica prima di aggiungerlo.

498 

499L'esempio seguente mette Mantle per primo, con dietro un upstream Amazon Bedrock per servire ogni modello che il campo `models` esclude:

500 

501```yaml theme={null}

502upstreams:

503 - provider: mantle

504 region: us-east-1

505 models: [claude-opus-4-7, claude-haiku-4-5] # required

506 auth: {} # AWS default credential chain

507 - provider: bedrock

508 region: us-east-1

509 auth: {}

510```

511 

512La tabella seguente elenca i campi specifici di un upstream `mantle`.

513 

514| Campo | Obbligatorio | Descrizione |

515| - | - | - |

516| `region` | Sì | Regione AWS. Il gateway ne deriva l'endpoint come `https://bedrock-mantle.<region>.api.aws/anthropic`. |

517| `models` | Sì | I modelli a cui il tuo account AWS ha accesso su Mantle, indicati come li inviano i client, ad esempio `claude-haiku-4-5`. Solo questi vanno a questo upstream, e ogni altro modello passa all'upstream successivo. |

518| `auth` | No | Accetta le stesse chiavi del blocco `auth` dell'upstream [Amazon Bedrock](#amazon-bedrock), con le stesse regole. |

519| `base_url` | No | Override dell'endpoint derivato. Mantieni il percorso `/anthropic` alla fine. |

520 

521Concedi all'identità AWS dell'upstream le azioni IAM proprie di Mantle per l'inferenza e il conteggio dei token, elencate in [Usare l'endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint).

522 

523Per un ID modello Mantle che il gateway non conosce, aggiungi una voce al blocco [`models:`](#models) di primo livello la cui `upstream_model` mappa il nome di questo upstream a quell'ID. Poi inserisci l'`id` di quella voce anche nel campo `models` di questo upstream.

524 

525Le impostazioni `guardrail` e `assume_role` di un upstream `bedrock` non si estendono alle richieste servite da Mantle:

526 

527* **`guardrail`**: il gateway non applica alcun [guardrail Bedrock](#apply-an-amazon-bedrock-guardrail) alle richieste che invia a Mantle, quindi si rifiuta di avviarsi quando è elencato un upstream `mantle` mentre un qualsiasi upstream `bedrock` imposta `guardrail`.

528* **`assume_role`**: un upstream `mantle` non accetta [`assume_role`](#bedrock-in-another-aws-account). Le richieste servite da Mantle vengono inviate con le credenziali `auth` proprie dell'upstream `mantle` e non vengono [attribuite per sviluppatore](#per-developer-aws-cost-attribution).

529 

530Per il significato delle risposte di errore proprie di Mantle, consulta [Errori dell'endpoint Mantle](/docs/it/amazon-bedrock#mantle-endpoint-errors).

531 

493<h4 id="claude-platform-on-aws">532<h4 id="claude-platform-on-aws">

494 Claude Platform on AWS533 Claude Platform on AWS

495</h4>534</h4>


692| Account diversi | Un upstream Amazon Bedrock per account. La catena predefinita (`auth: {}`) usa l'identità del pod; per un secondo account, aggiungi [`assume_role`](#bedrock-in-another-aws-account) per raggiungerlo con credenziali a breve durata, oppure imposta credenziali esplicite o un token bearer in `auth:`. |731| Account diversi | Un upstream Amazon Bedrock per account. La catena predefinita (`auth: {}`) usa l'identità del pod; per un secondo account, aggiungi [`assume_role`](#bedrock-in-another-aws-account) per raggiungerlo con credenziali a breve durata, oppure imposta credenziali esplicite o un token bearer in `auth:`. |

693| Throughput provisioned | Mappa il modello all'ARN di throughput provisioned in `models:` per il nome di quell'upstream. Gli altri upstream mantengono l'ID on-demand, quindi la capacità PT viene esaurita prima del failover. |732| Throughput provisioned | Mappa il modello all'ARN di throughput provisioned in `models:` per il nome di quell'upstream. Gli altri upstream mantengono l'ID on-demand, quindi la capacità PT viene esaurita prima del failover. |

694| Endpoint VPC / FIPS | Imposta `base_url:` sull'upstream all'URL del tuo endpoint VPC o FIPS |733| Endpoint VPC / FIPS | Imposta `base_url:` sull'upstream all'URL del tuo endpoint VPC o FIPS |

695| Instradamento limitato al modello | Solo un `id` di modello personalizzato, cioè non un modello Claude integrato, salta gli upstream assenti dalla sua mappa `upstream_model:`. Il gateway prova i modelli integrati su ogni upstream in ordine e usa l'ID predefinito del provider dove la mappa non ha una voce, quindi per i modelli integrati la mappa cambia quale ID riceve un upstream anziché se venga provato; un upstream che rifiuta l'ID segue le stesse [regole di failover](#upstreams) di qualsiasi altro errore dell'upstream. |734| Instradamento limitato al modello | Solo un `id` di modello personalizzato, cioè non un modello Claude integrato, salta gli upstream assenti dalla sua mappa `upstream_model:`. Un upstream `mantle` viene provato solo per i modelli elencati nel suo [campo `models`](#amazon-bedrock-mantle-endpoint). Su ogni altro upstream il gateway prova i modelli integrati in ordine e usa l'ID predefinito del provider dove la mappa non ha una voce, quindi per i modelli integrati la mappa cambia quale ID riceve un upstream anziché se venga provato; un upstream che rifiuta l'ID segue le stesse [regole di failover](#upstreams) di qualsiasi altro errore dell'upstream. |

696 735 

697Il failover tra provider cloud, o verso l'API Anthropic diretta, cambia quale accordo, area geografica e altri termini regolano la richiesta.736Il failover tra provider cloud, o verso l'API Anthropic diretta, cambia quale accordo, area geografica e altri termini regolano la richiesta.

698 737 


848 - match: {}887 - match: {}

849 cli:888 cli:

850 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]889 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

890 # Make the Default option in /model resolve inside each policy's

891 # list. The eng-contractors policy inherits enforceAvailableModels.

892 enforceAvailableModels: true

851```893```

852 894 

853Un catch-all `match: {}`, convenzionalmente elencato per ultimo, viene trattato come un livello base. Ogni altra policy eredita dal catch-all qualsiasi chiave che non imposta, quindi le voci per ruolo devono solo elencare ciò che differisce dal valore predefinito dell'organizzazione. Le regole di merge dipendono dal tipo di chiave:895Un catch-all `match: {}`, convenzionalmente elencato per ultimo, viene trattato come un livello base. Ogni altra policy eredita dal catch-all qualsiasi chiave che non imposta, quindi le voci per ruolo devono solo elencare ciò che differisce dal valore predefinito dell'organizzazione. Le regole di merge dipendono dal tipo di chiave:


856* **Elenchi di negazione e array di hook**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` e ogni array di tipo evento `hooks`. Questi prendono l'unione di base e policy, quindi un deny a livello di organizzazione o un hook di audit non può essere accidentalmente eliminato da un override per ruolo.898* **Elenchi di negazione e array di hook**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` e ogni array di tipo evento `hooks`. Questi prendono l'unione di base e policy, quindi un deny a livello di organizzazione o un hook di audit non può essere accidentalmente eliminato da un override per ruolo.

857* **Chiavi di tipo record**: `env`, `modelOverrides` e `skillOverrides`. Per queste si esegue un merge superficiale, quindi un blocco `env` per ruolo sovrascrive le chiavi che imposta ed eredita il resto dalla base.899* **Chiavi di tipo record**: `env`, `modelOverrides` e `skillOverrides`. Per queste si esegue un merge superficiale, quindi un blocco `env` per ruolo sovrascrive le chiavi che imposta ed eredita il resto dalla base.

858 900 

859`availableModels` viene anche applicato lato server su `/v1/messages`, quindi un modello negato restituisce `400` indipendentemente da quello che il client invia.901`availableModels` viene anche applicato lato server su `/v1/messages`, quindi un modello negato restituisce `400` indipendentemente da quello che il client invia. Un elenco vuoto nega ogni modello. Il controllo copre anche il modello su cui si avvia una sessione prima che lo sviluppatore ne scelga uno, quindi [avvia le sessioni su un modello consentito dalla policy](#start-sessions-on-a-model-the-policy-allows).

860 902 

861Il gateway convalida il valore `model` stesso prima di inoltrare una richiesta, quindi un valore malformato non raggiunge mai un upstream. Rifiuta la richiesta con un `400` in due casi:903Il gateway convalida il valore `model` stesso prima di inoltrare una richiesta, quindi un valore malformato non raggiunge mai un upstream. Rifiuta la richiesta con un `400` in due casi:

862 904 


883 * **Appartenenza ai gruppi**: cambiare l'appartenenza ai gruppi di un utente cambia quale policy gli corrisponde. Questo ha effetto alla prossima riemissione della sessione, cioè al prossimo aggiornamento silenzioso, limitato da `session.ttl_hours`.925 * **Appartenenza ai gruppi**: cambiare l'appartenenza ai gruppi di un utente cambia quale policy gli corrisponde. Questo ha effetto alla prossima riemissione della sessione, cioè al prossimo aggiornamento silenzioso, limitato da `session.ttl_hours`.

884</Note>926</Note>

885 927 

928<h4 id="start-sessions-on-a-model-the-policy-allows">

929 Avvia le sessioni su un modello consentito dalla policy

930</h4>

931 

932Se `availableModels` esclude il modello predefinito di Claude Code, le sessioni ricevono risposte `400` finché lo sviluppatore non sceglie un modello elencato, ad esempio con `/model`. Nelle sessioni del gateway il modello predefinito è il modello Opus a cui si risolve l'alias `opus`, e `availableModels` da solo non lo cambia.

933 

934Per risolvere, imposta [`enforceAvailableModels: true`](/docs/it/model-config#enforce-the-allowlist-for-the-default-model) nello stesso blocco `cli`, poi verifica quale tipo di voce contiene l'elenco:

935 

936* **Un alias come `sonnet`, o un ID incorporato come `claude-sonnet-4-6`**: le sessioni si avviano su uno di quei modelli, e l'opzione Default in `/model` si risolve in esso

937* **Nessun alias né ID incorporato nell'elenco**: le sessioni possono continuare ad avviarsi sul modello predefinito incorporato, quindi imposta anche [`model`](/docs/it/model-config#control-the-model-users-run-on) su uno degli ID elencati nel blocco `cli` di quella policy

938 

939Questa policy elenca un ID personalizzato definito da [`models`](#models) e avvia le sessioni su quell'ID:

940 

941```yaml theme={null}

942managed:

943 policies:

944 - match: { groups: [restricted-projects] }

945 cli:

946 availableModels: [claude-opus-restricted]

947 enforceAvailableModels: true

948 model: claude-opus-restricted

949```

950 

886<h4 id="matcher-values-that-stop-the-gateway-at-boot">951<h4 id="matcher-values-that-stop-the-gateway-at-boot">

887 Valori dei matcher che arrestano il gateway all'avvio952 Valori dei matcher che arrestano il gateway all'avvio

888</h4>953</h4>


920 cli:985 cli:

921 # Model access (also enforced server-side at /v1/messages)986 # Model access (also enforced server-side at /v1/messages)

922 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]987 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

988 enforceAvailableModels: true # Default resolves inside the list

923 989 

924 # Permission policy990 # Permission policy

925 permissions:991 permissions:


1041 - match: { groups: [eng-contractors] }1107 - match: { groups: [eng-contractors] }

1042 cli:1108 cli:

1043 availableModels: [claude-sonnet-4-6]1109 availableModels: [claude-sonnet-4-6]

1110 enforceAvailableModels: true

1044 desktop:1111 desktop:

1045 isLocalDevMcpEnabled: false1112 isLocalDevMcpEnabled: false

1046 disableAutoUpdates: true1113 disableAutoUpdates: true


1434 # region: us-east-11501 # region: us-east-1

1435 # auth: {}1502 # auth: {}

1436 1503 

1504 # - provider: mantle

1505 # region: us-east-1

1506 # models: [claude-opus-4-8, claude-opus-4-7, claude-haiku-4-5]

1507 # auth: {}

1508 

1437 # - provider: anthropicAws1509 # - provider: anthropicAws

1438 # region: us-east-11510 # region: us-east-1

1439 # workspace_id: wrkspc_...1511 # workspace_id: wrkspc_...


1456 upstream_model:1528 upstream_model:

1457 anthropic: claude-opus-4-81529 anthropic: claude-opus-4-8

1458 # bedrock: us.anthropic.claude-opus-4-81530 # bedrock: us.anthropic.claude-opus-4-8

1531 # mantle: anthropic.claude-opus-4-8

1459 # anthropicAws: claude-opus-4-81532 # anthropicAws: claude-opus-4-8

1460 # vertex: claude-opus-4-81533 # vertex: claude-opus-4-8

1461 # foundry: <your-opus-deployment-name>1534 # foundry: <your-opus-deployment-name>


1473 - match: { groups: [contractors] }1546 - match: { groups: [contractors] }

1474 cli:1547 cli:

1475 availableModels: [claude-haiku-4-5]1548 availableModels: [claude-haiku-4-5]

1476 # Constrain the Default picker option to availableModels instead of

1477 # the tier default, so contractors don't get a 400 on the default.

1478 enforceAvailableModels: true

1479 # allow auto-approves these tools; it does not block the rest.1549 # allow auto-approves these tools; it does not block the rest.

1480 # Add deny rules to restrict tools.1550 # Add deny rules to restrict tools.

1481 permissions: { allow: [Read, Grep] }1551 permissions: { allow: [Read, Grep] }

1482 - match: {}1552 - match: {}

1483 cli:1553 cli:

1484 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]1554 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

1555 # Constrain the Default picker option to each policy's availableModels

1556 # instead of the built-in default, so no role gets a 400 on Default.

1557 # The contractors policy inherits this key.

1558 enforceAvailableModels: true

1485 permissions:1559 permissions:

1486 allow: [Read, Grep, Bash, Edit]1560 allow: [Read, Grep, Bash, Edit]

1487 deny: ["WebFetch"]1561 deny: ["WebFetch"]

Details

429 429 

430Il gateway risponde `431` quando le intestazioni di una richiesta superano in totale 256 KiB, oppure [`limits.max_request_header_bytes`](/docs/it/claude-apps-gateway-config#http-tuning) se lo imposti. Non scrive alcuna riga di log né evento di audit per queste richieste. Le versioni del gateway precedenti a v2.1.284 rispondono `431` oltre i 16 KiB.430Il gateway risponde `431` quando le intestazioni di una richiesta superano in totale 256 KiB, oppure [`limits.max_request_header_bytes`](/docs/it/claude-apps-gateway-config#http-tuning) se lo imposti. Non scrive alcuna riga di log né evento di audit per queste richieste. Le versioni del gateway precedenti a v2.1.284 rispondono `431` oltre i 16 KiB.

431 431 

432Cosa cambiare dipende dalla versione e dalla configurazione del tuo gateway:432Inizia dalla prima di queste opzioni che si applica al tuo gateway:

433 433 

434* **Gateway precedente a v2.1.284**: aggiorna il gateway434* **Gateway precedente a v2.1.284**: aggiorna il gateway

435* **`limits.max_request_header_bytes` impostato**: aumenta il valore o rimuovi la chiave435* **`limits.max_request_header_bytes` impostato**: aumenta il valore o rimuovi la chiave

436* **Nessuno dei due casi si applica, oppure il `431` continua in seguito**: fai in modo che il tuo IdP emetta meno gruppi. [Identity provider setup](#identity-provider-setup) spiega come Okta, Microsoft Entra ID e Google Workspace forniscono i gruppi436* **Nessuno dei due casi si applica, oppure il `431` continua in seguito**: fai in modo che il tuo IdP emetta meno gruppi. [Identity provider setup](#identity-provider-setup) spiega come Okta, Microsoft Entra ID e Google Workspace forniscono i gruppi

437 437 

438Quando riduci l'attestazione dei gruppi, mantieni i gruppi che hai indicato in queste impostazioni, che determinano l'accesso, il criterio e i limiti di spesa di uno sviluppatore:

439 

440* **[`oidc.allowed_groups`](/docs/it/claude-apps-gateway-config#oidc)**: determina chi può accedere

441* **[`admin.admin_groups`](/docs/it/claude-apps-gateway-config#admin)**: determina chi può chiamare l'API di amministrazione con la propria sessione del gateway

442* **`match.groups` in [`managed.policies`](/docs/it/claude-apps-gateway-config#managed)**: determina quale criterio si applica a uno sviluppatore

443* **`rbac_group` [limiti di spesa](/docs/it/claude-apps-gateway-spend-limits)**: determinano quali limiti di spesa di gruppo si applicano a uno sviluppatore

444 

438<h2 id="related">445<h2 id="related">

439 Correlati446 Correlati

440</h2>447</h2>

Details

12 12 

13Una sessione cloud è una sessione Claude Code che viene eseguita su infrastruttura cloud invece che sulla tua macchina. Per impostazione predefinita viene eseguita su infrastruttura gestita da Anthropic, oppure sull'[ambiente self-hosted](/docs/it/self-hosted-environments) della tua organizzazione quando instradato lì. La sessione continua a essere eseguita dopo che chiudi il tuo laptop, e puoi controllarla o dirigerla da qualsiasi dispositivo.13Una sessione cloud è una sessione Claude Code che viene eseguita su infrastruttura cloud invece che sulla tua macchina. Per impostazione predefinita viene eseguita su infrastruttura gestita da Anthropic, oppure sull'[ambiente self-hosted](/docs/it/self-hosted-environments) della tua organizzazione quando instradato lì. La sessione continua a essere eseguita dopo che chiudi il tuo laptop, e puoi controllarla o dirigerla da qualsiasi dispositivo.

14 14 

15Per consentire alle sessioni cloud di clonare il tuo codice da GitHub e fare push dei branch, connetti GitHub con uno dei [metodi di connessione GitHub](#github-authentication-options). Se il tuo repository si trova su GitLab, Bitbucket o un altro host, consulta [Restrizioni della piattaforma](#limitations) per sapere cosa funziona.

16 

15Puoi avviare una sessione cloud da una qualsiasi di queste superfici:17Puoi avviare una sessione cloud da una qualsiasi di queste superfici:

16 18 

17* **Browser**: [claude.ai/code](https://claude.ai/code), chiamato anche Claude Code sul web19* **Browser**: [claude.ai/code](https://claude.ai/code), chiamato anche Claude Code sul web


20* **Terminale**: [`claude --cloud`](#from-terminal-to-cloud)22* **Terminale**: [`claude --cloud`](#from-terminal-to-cloud)

21* **Routine**: [esecuzioni pianificate e attivate](/docs/it/routines) vengono eseguite ciascuna come sessione cloud23* **Routine**: [esecuzioni pianificate e attivate](/docs/it/routines) vengono eseguite ciascuna come sessione cloud

22 24 

23Per fare in modo che Claude avvii e tenga traccia di molte sessioni cloud per un corpo di lavoro, usa un [progetto](/docs/it/claude-projects). Una sessione nel tuo terminale, nel tuo IDE, o nell'app Desktop con **Local** selezionato viene eseguita sulla tua macchina. Per dirigere una di quelle sessioni locali dal tuo telefono o browser, usa [Remote Control](/docs/it/remote-control).25Una volta completata la configurazione, usa questa pagina per spostare il lavoro tra il tuo terminale e il cloud, gestire e condividere le sessioni, attivare la correzione automatica per le pull request e risolvere i problemi.

24 

25<Tip>

26 Nuovo a sessioni cloud? Inizia con [Guida introduttiva](/docs/it/web-quickstart) per connettere il tuo account GitHub e inviare il tuo primo compito.

27</Tip>

28 26 

29Questa pagina copre:27<Note>

28 Questi casi sono trattati in altre pagine:

30 29 

31* [Ambienti cloud](#cloud-environments): dove vengono eseguite le sessioni, e dove configurare questo30 * **Avviare la tua prima sessione cloud**: [Inizia con le sessioni cloud](/docs/it/web-quickstart) connette GitHub e ti guida attraverso un compito nel browser

32* [Opzioni di autenticazione GitHub](#github-authentication-options): due modi per connettere GitHub31 * **Molte sessioni cloud per un unico corpo di lavoro**: un [progetto](/docs/it/claude-projects) fa sì che Claude le avvii e ne tenga traccia per te

33* [Sposta attività tra terminale e cloud](#move-tasks-between-terminal-and-cloud) con `--cloud` e `--teleport`32 * **Dirigere una sessione locale da un altro dispositivo**: le sessioni nel tuo terminale, nel tuo IDE o nell'app Desktop con **Local** selezionato vengono eseguite sulla tua macchina, e [Remote Control](/docs/it/remote-control) ti consente di raggiungerle dal tuo telefono o browser

34* [Lavora con le sessioni](#work-with-sessions): modalità di autorizzazione, revisione, condivisione, archiviazione, eliminazione33</Note>

35* [Correzione automatica delle pull request](#auto-fix-pull-requests): rispondi automaticamente ai fallimenti CI e ai commenti di revisione

36* [Sicurezza e isolamento](#security-and-isolation): come le sessioni sono isolate

37* [Limitazioni](#limitations): limiti di velocità e restrizioni della piattaforma

38 34 

39<h2 id="cloud-environments">35<h2 id="cloud-environments">

40 Ambienti cloud36 Ambienti cloud

41</h2>37</h2>

42 38 

43Ogni sessione cloud viene eseguita in un [ambiente cloud](/docs/it/cloud-environments), la configurazione salvata che controlla l'accesso alla rete, le variabili di ambiente e gli script di configurazione. Se non hai ancora un ambiente, l'onboarding configura un ambiente **Default** con accesso alla rete [**Trusted**](/docs/it/cloud-environments#access-levels), creandolo per te o chiedendoti di crearlo. Vedi [L'ambiente Default](/docs/it/cloud-environments#the-default-environment) per sapere quale di questi accade sul tuo piano e come le sessioni scelgono un ambiente quando ne hai più di uno.39Ogni sessione cloud viene eseguita in un [ambiente cloud](/docs/it/cloud-environments), la configurazione salvata che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione.

44 40 

45Gli stessi ambienti si applicano ovunque tu avvii una sessione cloud: il browser, il terminale, [Claude Tag](https://claude.com/docs/claude-tag/overview), [routine](/docs/it/routines) e le app mobile e Desktop. Le sessioni dei canali Claude Tag utilizzano solo ambienti a livello di organizzazione, sia [ambienti condivisi](/docs/it/cloud-environments#organization-shared-environments) che [ambienti self-hosted](/docs/it/self-hosted-environments).41* **Il tuo primo ambiente**: se non hai ancora un ambiente, l'onboarding configura un ambiente **Default** con [accesso alla rete **Trusted**](/docs/it/cloud-environments#access-levels), creandolo per te o chiedendoti di crearlo. Vedi [L'ambiente Default](/docs/it/cloud-environments#the-default-environment) per sapere quale di questi accade sul tuo piano

46 42* **Quale ambiente utilizza una sessione**: vedi [L'ambiente Default](/docs/it/cloud-environments#the-default-environment) per sapere come le sessioni scelgono un ambiente quando ne hai più di uno

47Vedi [Configura ambienti cloud](/docs/it/cloud-environments) per modificare cosa consente un ambiente, impostare variabili o aggiungere uno script di configurazione, e [Strumenti installati](/docs/it/cloud-environments#installed-tools) per quello che le sessioni includono senza alcuna configurazione.43* **Modificare cosa le sessioni possono raggiungere o eseguire all'avvio**: vedi [Configura ambienti cloud](/docs/it/cloud-environments)

44* **Cosa è installato senza alcuna configurazione**: vedi [Strumenti installati](/docs/it/cloud-environments#installed-tools)

48 45 

49<h2 id="github-authentication-options">46<h2 id="github-authentication-options">

50 Opzioni di autenticazione GitHub47 Opzioni di autenticazione GitHub


57| **GitHub App** | Autorizza l'app Claude GitHub durante l'[onboarding web](/docs/it/web-quickstart) | Qualsiasi repository pubblico e repository privati su cui è installata l'app Claude GitHub | Onboarding del browser; team che desiderano [Auto-fix](#auto-fix-pull-requests) |54| **GitHub App** | Autorizza l'app Claude GitHub durante l'[onboarding web](/docs/it/web-quickstart) | Qualsiasi repository pubblico e repository privati su cui è installata l'app Claude GitHub | Onboarding del browser; team che desiderano [Auto-fix](#auto-fix-pull-requests) |

58| **`/web-setup`** | Esegui `/web-setup` nel tuo terminale per inviare il tuo token CLI `gh` locale al tuo account Claude | Qualsiasi repository a cui il tuo token `gh` può accedere, indipendentemente dal fatto che l'app sia installata o meno | Sviluppatori individuali che già usano `gh` |55| **`/web-setup`** | Esegui `/web-setup` nel tuo terminale per inviare il tuo token CLI `gh` locale al tuo account Claude | Qualsiasi repository a cui il tuo token `gh` può accedere, indipendentemente dal fatto che l'app sia installata o meno | Sviluppatori individuali che già usano `gh` |

59 56 

60L'installazione dell'app Claude GitHub su un repository abilita anche [Auto-fix](#auto-fix-pull-requests) per le pull request in esso.57Queste funzionalità dipendono dall'installazione dell'app Claude GitHub sul repository:

61 58 

62I thread in un [progetto](/docs/it/claude-projects) hanno bisogno che l'app sia installata su ogni repository che clonano, indipendentemente dal metodo con cui ti sei connesso. Vedi [Configura l'accesso a GitHub](/docs/it/claude-projects#set-up-github-access).59* **Auto-fix**: l'installazione dell'app Claude GitHub su un repository abilita anche [Auto-fix](#auto-fix-pull-requests) per le pull request in esso

60* **Progetti**: i thread in un [progetto](/docs/it/claude-projects) hanno bisogno che l'app Claude GitHub sia installata su ogni repository che clonano, indipendentemente dal metodo con cui ti sei connesso. Vedi [Configura l'accesso a GitHub](/docs/it/claude-projects#set-up-github-access)

63 61 

64In ambienti ospitati da Anthropic, le tue credenziali GitHub rimangono crittografate sui server di Anthropic e non entrano mai nella VM di una sessione. Le operazioni GitHub dalla VM passano attraverso il [proxy GitHub](/docs/it/cloud-environments#github-proxy), che allega la credenziale sul lato server.62In ambienti ospitati da Anthropic, le tue credenziali GitHub rimangono crittografate sui server di Anthropic e non entrano mai nella VM di una sessione. Le operazioni GitHub dalla VM passano attraverso il [proxy GitHub](/docs/it/cloud-environments#github-proxy), che allega la credenziale sul lato server.

65 63 

66Per come `/schedule` verifica l'accesso al repository prima di creare una routine, vedi [Repository e autorizzazioni di ramo](/docs/it/routines#repositories-and-branch-permissions). Vedi [Connetti dal tuo terminale](/docs/it/web-quickstart#connect-from-your-terminal) per la procedura dettagliata di `/web-setup`, incluso ciò che `/web-setup` memorizza e come rimuoverlo.64Vedi [Connetti dal tuo terminale](/docs/it/web-quickstart#connect-from-your-terminal) per la procedura dettagliata di `/web-setup`, incluso ciò che `/web-setup` memorizza e come rimuoverlo.

67 

68La configurazione rapida del web è un'impostazione dell'organizzazione che consente ai membri di connettere GitHub con `/web-setup`, salta il prompt di installazione dell'app Claude GitHub durante l'onboarding del browser e fa sì che l'onboarding del browser crei l'[ambiente **Default**](/docs/it/cloud-environments#the-default-environment) per loro invece di mostrare il modulo dell'ambiente. Nei piani Team ed Enterprise è disabilitato per impostazione predefinita, il che nasconde `/web-setup`. Un [Proprietario](/docs/it/server-managed-settings#access-control) lo attiva con l'interruttore **Quick web setup** su [**Impostazioni di amministrazione > Claude Code**](https://claude.ai/admin-settings/claude-code).

69 65 

70<Note>66<Note>

71 Le organizzazioni con [Zero Data Retention](/docs/it/zero-data-retention) abilitato non possono utilizzare `/web-setup` o altre funzionalità di sessione cloud.67 Le organizzazioni con [Zero Data Retention](/docs/it/zero-data-retention) abilitato non possono utilizzare `/web-setup` o altre funzionalità di sessione cloud.

72</Note>68</Note>

73 69 

70<h3 id="quick-setup-for-team-and-enterprise">

71 Configurazione rapida per Team ed Enterprise

72</h3>

73 

74La configurazione rapida è un'impostazione dell'organizzazione che elimina alcuni passaggi dalla configurazione di GitHub e dell'ambiente dei membri. Nei piani Team ed Enterprise è disattivata per impostazione predefinita.

75 

76Ecco cosa cambia per i membri quando è attiva:

77 

78* **`/web-setup`**: i membri possono connettere GitHub con `/web-setup`. Quando l'impostazione è disattivata, il comando è nascosto

79* **Prompt della GitHub App**: l'onboarding del browser salta il prompt di installazione dell'app Claude GitHub

80* **Primo ambiente**: l'onboarding del browser crea l'[ambiente **Default**](/docs/it/cloud-environments#the-default-environment) per i membri invece di mostrare il modulo dell'ambiente

81 

82Un [Owner](/docs/it/server-managed-settings#access-control) la attiva con l'interruttore **Quick setup** in [**Impostazioni dell'organizzazione > Claude Code**](https://claude.ai/admin-settings/claude-code).

83 

74<h2 id="move-tasks-between-terminal-and-cloud">84<h2 id="move-tasks-between-terminal-and-cloud">

75 Sposta attività tra terminale e cloud85 Sposta attività tra terminale e cloud

76</h2>86</h2>


78Questi flussi di lavoro richiedono la [Claude Code CLI](/docs/it/quickstart) connessa allo stesso account claude.ai. Puoi avviare nuove sessioni cloud dal tuo terminale o estrarre sessioni cloud nel tuo terminale per continuare localmente. Le sessioni cloud persistono anche se chiudi il tuo laptop e puoi monitorarle da qualsiasi luogo inclusa l'app mobile Claude.88Questi flussi di lavoro richiedono la [Claude Code CLI](/docs/it/quickstart) connessa allo stesso account claude.ai. Puoi avviare nuove sessioni cloud dal tuo terminale o estrarre sessioni cloud nel tuo terminale per continuare localmente. Le sessioni cloud persistono anche se chiudi il tuo laptop e puoi monitorarle da qualsiasi luogo inclusa l'app mobile Claude.

79 89 

80<Note>90<Note>

81 Dalla CLI, l'handoff della sessione è unidirezionale: puoi estrarre sessioni cloud nel tuo terminale con `--teleport`, ma non puoi inviare una sessione terminale esistente al cloud. Il flag `--cloud` con una descrizione di compito crea una nuova sessione cloud per il tuo repository attuale; con `-p` e un ID di sessione o URL claude.ai/code invece [accoda un messaggio in quella sessione esistente](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli). L'[app Desktop](/docs/it/desktop#continue-in-another-surface) fornisce un menu **Continua in** che può inviare una sessione locale al cloud.91 Dalla CLI, l'handoff della sessione è unidirezionale: puoi estrarre sessioni cloud nel tuo terminale con `--teleport`, ma non puoi inviare una sessione terminale esistente al cloud. Il flag `--cloud` con una descrizione di compito crea una nuova sessione cloud per il tuo repository attuale; con `-p` e un ID di sessione o URL claude.ai/code invece [accoda un messaggio in quella sessione esistente](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli). L'[app Desktop](/docs/it/desktop#continue-in-another-surface) può inviare al cloud una sessione locale della sua scheda Code dal menu **Open in**.

82</Note>92</Note>

83 93 

84<h3 id="from-terminal-to-cloud">94<h3 id="from-terminal-to-cloud">


173 Invia follow-up dalla CLI183 Invia follow-up dalla CLI

174</h3>184</h3>

175 185 

176Una volta che una sessione cloud è in esecuzione, ovunque venga eseguita, inviala un messaggio di follow-up dalla CLI `claude` su qualsiasi macchina dove sei connesso con `claude auth login`. La CLI si autentica con le credenziali del tuo account Anthropic e non invia alcuno stato di sessione locale, quindi il comando non ha bisogno di essere eseguito dalla macchina che ha avviato la sessione, ed è lo stesso in ogni shell, incluso PowerShell.186Una volta che una sessione cloud è in esecuzione, ovunque venga eseguita, inviale un messaggio di follow-up dalla CLI `claude` su qualsiasi macchina dove sei connesso con `claude auth login`. La CLI si autentica con le credenziali del tuo account Anthropic e non invia alcuno stato di sessione locale, quindi il comando non ha bisogno di essere eseguito dalla macchina che ha avviato la sessione.

177 187 

178Il comando pubblica un messaggio e esce:188Il comando pubblica un messaggio e esce:

179 189 


189 `--cloud` richiede un account Anthropic. Non è disponibile quando Claude Code è configurato per Amazon Bedrock, Google Cloud's Agent Platform o un altro provider di terze parti. Un [gateway LLM](/docs/it/llm-gateway) configurato solo tramite `ANTHROPIC_BASE_URL` non conta come provider di terze parti per questo controllo, ma devi comunque accedere con `claude auth login`. La politica `allow_remote_sessions` della tua organizzazione deve anche essere abilitata. Un Proprietario può attivarla nelle impostazioni di amministrazione di Claude Code su claude.ai/admin-settings/claude-code.199 `--cloud` richiede un account Anthropic. Non è disponibile quando Claude Code è configurato per Amazon Bedrock, Google Cloud's Agent Platform o un altro provider di terze parti. Un [gateway LLM](/docs/it/llm-gateway) configurato solo tramite `ANTHROPIC_BASE_URL` non conta come provider di terze parti per questo controllo, ma devi comunque accedere con `claude auth login`. La politica `allow_remote_sessions` della tua organizzazione deve anche essere abilitata. Un Proprietario può attivarla nelle impostazioni di amministrazione di Claude Code su claude.ai/admin-settings/claude-code.

190</Note>200</Note>

191 201 

192<h4 id="output-and-errors">202<h4 id="output">

193 Output e errori203 Output

194</h4>204</h4>

195 205 

196Al successo, il comando stampa l'ID della sessione e un link per visualizzare la sessione:206Al successo, il comando stampa l'ID della sessione e un link per visualizzare la sessione:


203 213 

204Passa `--output-format json` per un risultato leggibile da macchina: `{ok, session_id, url}` al successo, o `{ok: false, session_id, error}` quando l'invio fallisce, ad esempio quando la sessione è mancante o archiviata. Gli errori di configurazione, come un provider non supportato o una politica organizzativa disabilitata, vengono stampati su stderr senza JSON. `--output-format stream-json` non è supportato con `--cloud <session-id>`.214Passa `--output-format json` per un risultato leggibile da macchina: `{ok, session_id, url}` al successo, o `{ok: false, session_id, error}` quando l'invio fallisce, ad esempio quando la sessione è mancante o archiviata. Gli errori di configurazione, come un provider non supportato o una politica organizzativa disabilitata, vengono stampati su stderr senza JSON. `--output-format stream-json` non è supportato con `--cloud <session-id>`.

205 215 

206La CLI antepone gli errori con `Error: `. Un'entrega fallita è avvolta come `failed to send message to cloud session <id>: <reason>`.216Se l'invio fallisce, consulta [Errori durante l'invio a una sessione cloud](#errors-when-sending-to-a-cloud-session).

207 

208| Messaggio | Cosa significa |

209| - | - |

210| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code è configurato per un provider di terze parti. Il messaggio nomina il provider con l'etichetta che la tua configurazione utilizza, come `Amazon Bedrock` o `Google Vertex AI`. Rimuovi la configurazione di quel provider, ad esempio annullando l'impostazione di `CLAUDE_CODE_USE_BEDROCK`, e accedi con un account Anthropic (`claude auth login`). |

211| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | La politica organizzativa `allow_remote_sessions` è disattivata. |

212| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code non ha potuto recuperare la politica della tua organizzazione, quindi rifiuta l'invio piuttosto che assumere che le sessioni cloud siano consentite. Controlla la tua connessione di rete e riprova. |

213| `Attaching to an existing cloud session is not enabled for your account.` | Hai eseguito `--cloud <session-id>` senza `-p`. Invia il messaggio con `claude -p "your message" --cloud <session-id>`. |

214| `Session not found: <id>` | L'ID o l'URL non corrisponde a una sessione a cui puoi accedere. Controllalo rispetto all'URL claude.ai/code della sessione. |

215| `cloud session <id> is archived and cannot accept new messages` | La sessione è stata archiviata. Avvia una nuova sessione invece. |

216 217 

217<h3 id="from-cloud-to-terminal">218<h3 id="from-cloud-to-terminal">

218 Dal cloud al terminale219 Dal cloud al terminale


239| Requisito | Dettagli |240| Requisito | Dettagli |

240| - | - |241| - | - |

241| Stato git pulito | La tua directory di lavoro non deve avere modifiche non sottoposte a commit. Il teletrasporto ti chiede di archiviare le modifiche se necessario. |242| Stato git pulito | La tua directory di lavoro non deve avere modifiche non sottoposte a commit. Il teletrasporto ti chiede di archiviare le modifiche se necessario. |

242| Repository corretto | Devi eseguire `--teleport` da un checkout dello stesso repository, non da un fork. Se lo esegui da un checkout di un repository diverso, Claude Code mostra un errore che nomina sia il repository della sessione che il repository del tuo checkout. Prima della v2.1.219, l'errore non nominava il repository del tuo checkout. Se Claude Code non riesce ad analizzare il tuo remoto in un nome host, ad esempio un alias host SSH come `git@work:owner/repo.git`, ti chiede di confermare e accetta il checkout quando il proprietario del remoto e il nome del repository corrispondono al repository della sessione. |243| Repository corretto | Devi eseguire `--teleport` da un checkout dello stesso repository, non da un fork. Se lo esegui da un checkout di un repository diverso, Claude Code mostra un errore che nomina sia il repository della sessione che il repository del tuo checkout. Se Claude Code non riesce ad analizzare il tuo remoto in un nome host, ad esempio un alias host SSH come `git@work:owner/repo.git`, ti chiede di confermare e accetta il checkout quando il proprietario del remoto e il nome del repository corrispondono al repository della sessione. |

243| Ramo disponibile | Il ramo dalla sessione cloud deve essere stato inviato al remoto. Il teletrasporto lo recupera e lo controlla automaticamente. |244| Ramo disponibile | Il ramo dalla sessione cloud deve essere stato inviato al remoto. Il teletrasporto lo recupera e lo controlla automaticamente. |

244| Stesso account | Devi essere autenticato allo stesso account claude.ai utilizzato nella sessione cloud. |245| Stesso account | Devi essere autenticato allo stesso account claude.ai utilizzato nella sessione cloud. |

245 246 


249 `--teleport` non è disponibile250 `--teleport` non è disponibile

250</h4>251</h4>

251 252 

252Il teletrasporto richiede l'autenticazione dell'abbonamento claude.ai. Se sei autenticato tramite chiave API, esegui `/login` per accedere con il tuo account claude.ai. Se il messaggio di errore nomina il tuo provider, le sessioni cloud non sono disponibili tramite provider di terze parti; vedi la [tabella degli errori](#output-and-errors). Se sei già connesso tramite claude.ai e `--teleport` non è ancora disponibile, la tua organizzazione potrebbe aver disabilitato le sessioni cloud.253Teleport richiede l'autenticazione dell'abbonamento claude.ai. Trova il caso che corrisponde al tuo:

254 

255* **Sei autenticato tramite chiave API**: esegui `/login` per accedere invece con il tuo account claude.ai

256* **L'errore nomina il tuo provider**: le sessioni cloud non sono disponibili tramite provider di terze parti. Consulta la [tabella degli errori](#errors-when-sending-to-a-cloud-session)

257* **Sei già connesso tramite claude.ai**: la tua organizzazione potrebbe aver disabilitato le sessioni cloud

253 258 

254<h2 id="work-with-sessions">259<h2 id="work-with-sessions">

255 Lavorare con le sessioni260 Lavorare con le sessioni


257 262 

258Le sessioni appaiono nella barra laterale su claude.ai/code. Da lì è possibile rivedere le modifiche, condividere con i colleghi, archiviare il lavoro completato o eliminare le sessioni in modo permanente.263Le sessioni appaiono nella barra laterale su claude.ai/code. Da lì è possibile rivedere le modifiche, condividere con i colleghi, archiviare il lavoro completato o eliminare le sessioni in modo permanente.

259 264 

260<h3 id="take-back-a-queued-message">265<h3 id="permission-modes-in-cloud-sessions">

261 Riprendere un messaggio in coda266 Modalità di permesso nelle sessioni cloud

262</h3>267</h3>

263 268 

264Se inviate un messaggio mentre Claude sta lavorando, il messaggio rimane in coda finché Claude non lo legge. Per riprendere un messaggio in coda, fate clic sulla ✕ su di esso. Il testo ritorna nella casella dei messaggi in modo che possiate modificarlo o inviare qualcos'altro.269Scegli la [modalità di permesso](/docs/it/permission-modes) di una sessione cloud dal [menu a discesa della modalità](/docs/it/permission-modes#switch-permission-modes), sia quando crei l'attività sia mentre la sessione è in esecuzione.

265 270 

266Se Claude ha già letto il messaggio, rimane nella conversazione.271Claude Code riprende una sessione nella modalità di permesso in cui si trovava quando esegui una di queste azioni:

272 

273* Riapri una sessione il cui [ambiente ospitato da Anthropic è scaduto](#environment-expired)

274* Invii un messaggio a una sessione che un runner self-hosted [ha rilasciato mentre era inattiva](/docs/it/self-hosted-environments-reference#runner-cli-flags)

275 

276<h3 id="review-changes">

277 Rivedere le modifiche

278</h3>

279 

280Ogni sessione mostra un indicatore di diff con righe aggiunte e rimosse, come `+42 -18`. Selezionalo per aprire la visualizzazione diff, lasciare commenti in linea su righe specifiche e inviarli a Claude con il messaggio successivo.

281 

282Per impostazione predefinita, la visualizzazione diff confronta le modifiche della sessione con il suo branch di base. Per confrontarle con qualsiasi altro branch nel repository, seleziona **Compare against** e scegline uno.

283 

284Claude Code calcola questi diff dal contenuto grezzo dei blob git, quindi i driver diff e i filtri `textconv` configurati nel repository non si applicano.

285 

286Questi passaggi sono trattati altrove:

287 

288* **La procedura dettagliata completa, inclusa la creazione di PR**: consulta [Rivedere e iterare](/docs/it/web-quickstart#review-and-iterate)

289* **Fare in modo che Claude monitori automaticamente la PR per errori CI e commenti di revisione**: consulta [Correzione automatica delle pull request](#auto-fix-pull-requests)

267 290 

268<h3 id="manage-context">291<h3 id="manage-context">

269 Gestire il contesto292 Gestire il contesto


291 314 

292I [team di agenti](/docs/it/agent-teams) sono disabilitati per impostazione predefinita ma possono essere abilitati aggiungendo `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` alle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables).315I [team di agenti](/docs/it/agent-teams) sono disabilitati per impostazione predefinita ma possono essere abilitati aggiungendo `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` alle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables).

293 316 

294<h3 id="permission-modes-in-cloud-sessions">317<h3 id="take-back-a-queued-message">

295 Modalità di autorizzazione nelle sessioni cloud318 Riprendere un messaggio in coda

296</h3>

297 

298Si sceglie la [modalità di autorizzazione](/docs/it/permission-modes) di una sessione cloud dal [menu a discesa della modalità](/docs/it/permission-modes#switch-permission-modes), sia quando si crea l'attività che mentre la sessione è in esecuzione. Quando si riapre una sessione il cui [ambiente ospitato da Anthropic è scaduto](#environment-expired), o si invia un messaggio a una sessione che un runner self-hosted [ha rilasciato mentre era inattivo](/docs/it/self-hosted-environments-reference#runner-cli-flags), Claude Code riprende la sessione nella modalità di autorizzazione in cui si trovava.

299 

300<h3 id="review-changes">

301 Rivedere le modifiche

302</h3>319</h3>

303 320 

304Ogni sessione mostra un indicatore di diff con righe aggiunte e rimosse, come `+42 -18`. Selezionarlo per aprire la visualizzazione diff, lasciare commenti in linea su righe specifiche e inviarli a Claude con il messaggio successivo.321Se invii un messaggio mentre Claude sta lavorando, il messaggio rimane in coda finché Claude non lo legge. Per riprendere un messaggio in coda, fai clic sulla ✕ su di esso. Il testo ritorna nella casella dei messaggi, così puoi modificarlo o inviare qualcos'altro.

305 

306La visualizzazione diff confronta le modifiche della sessione rispetto al suo ramo base per impostazione predefinita. Per confrontare con qualsiasi altro ramo nel repository, selezionare **Compare against** e sceglierne uno.

307 

308Claude Code calcola questi diff, inclusi i diff per file mostrati mentre Claude modifica, dal contenuto grezzo del blob git, quindi i driver diff e i filtri `textconv` configurati nel repository non si applicano. Per un file in un repository che non è uno dei checkout della sessione stessa, come uno clonato all'interno dell'area di lavoro durante la sessione, il diff per file mostra la modifica di Claude stessa piuttosto che un confronto git.

309 322 

310Vedere [Rivedere e iterare](/docs/it/web-quickstart#review-and-iterate) per la procedura dettagliata completa inclusa la creazione di PR. Per fare in modo che Claude monitori automaticamente la PR per errori CI e commenti di revisione, vedere [Correzione automatica delle pull request](#auto-fix-pull-requests).323Se Claude ha già letto il messaggio, rimane nella conversazione.

311 324 

312<h3 id="share-sessions">325<h3 id="share-sessions">

313 Condividere sessioni326 Condividere sessioni


319 Condividere da un account Enterprise o Team332 Condividere da un account Enterprise o Team

320</h4>333</h4>

321 334 

322Per gli account Enterprise e Team, le due opzioni di visibilità sono **Private** e **Team**. La visibilità Team rende la sessione visibile agli altri membri dell'organizzazione claude.ai. Le sessioni di [Claude in Slack](/docs/it/slack) vengono condivise automaticamente con visibilità Team.335Per gli account Enterprise e Team, la condivisione funziona come segue:

323 336 

324La verifica dell'accesso al repository è abilitata per impostazione predefinita, in base all'account GitHub connesso all'account del destinatario. Il nome visualizzato dell'account è visibile a tutti i destinatari con accesso.337* **Opzioni di visibilità**: **Private** e **Team**. La visibilità Team rende la sessione visibile agli altri membri della tua organizzazione claude.ai

338* **Accesso al repository**: la verifica è abilitata per impostazione predefinita, in base all'account GitHub connesso all'account del destinatario

339* **Il tuo nome**: il nome visualizzato del tuo account è visibile a tutti i destinatari con accesso

340* **Sessioni Slack**: le sessioni di [Claude in Slack](/docs/it/slack) vengono condivise automaticamente con visibilità Team

325 341 

326<h4 id="share-from-a-max-or-pro-account">342<h4 id="share-from-a-max-or-pro-account">

327 Condividere da un account Max o Pro343 Condividere da un account Max o Pro

328</h4>344</h4>

329 345 

330Per gli account Max e Pro, le due opzioni di visibilità sono **Private** e **Public**. La visibilità Public rende la sessione visibile a qualsiasi utente connesso a claude.ai.346Per gli account Max e Pro, la condivisione funziona come segue:

331 347 

332Controllare la sessione per contenuti sensibili prima di condividere. Le sessioni possono contenere codice e credenziali da repository GitHub privati. La verifica dell'accesso al repository non è abilitata per impostazione predefinita.348* **Opzioni di visibilità**: **Private** e **Public**. La visibilità Public rende la sessione visibile a qualsiasi utente che abbia effettuato l'accesso a claude.ai

349* **Accesso al repository**: la verifica non è abilitata per impostazione predefinita

350* **Contenuti sensibili**: controlla la sessione prima di condividerla. Le sessioni possono contenere codice e credenziali provenienti da repository GitHub privati

333 351 

334Per richiedere ai destinatari di avere accesso al repository, o per nascondere il nome dalle sessioni condivise, andare a [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code).352Per richiedere ai destinatari di avere accesso al repository, o per nascondere il nome dalle sessioni condivise, andare a [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code).

335 353 


421 Impossibile ottenere l'UUID dell'organizzazione439 Impossibile ottenere l'UUID dell'organizzazione

422</h3>440</h3>

423 441 

424`claude --cloud` e `claude --teleport` richiedono l'accesso con un account claude.ai. Se ti autentichi con una chiave API, o i dettagli dell'account archiviati sono obsoleti, questi comandi falliscono con `Unable to get organization UUID` o un messaggio che l'autenticazione con chiave API non è sufficiente. Con l'autenticazione con chiave API o i dettagli dell'account obsoleti, l'esecuzione di `claude --teleport` senza un ID di sessione mostra `Error loading Claude Code sessions` nel selettore di sessione invece di uno dei due messaggi, e la stessa correzione si applica.442`claude --cloud` e `claude --teleport` richiedono l'accesso con un account claude.ai. Se ti autentichi con una chiave API, o i dettagli dell'account archiviati sono obsoleti, vedrai uno di questi:

443 

444* `Unable to get organization UUID`

445* Un messaggio che indica che l'autenticazione con chiave API non è sufficiente

446* `Error loading Claude Code sessions` nel selettore di sessione, quando esegui `claude --teleport` senza un ID di sessione

425 447 

426Esegui `/login` per accedere con il tuo account claude.ai, quindi riprova il comando. Se il messaggio nomina il tuo provider, vedi la [tabella degli errori](#output-and-errors): le sessioni cloud non sono disponibili tramite provider di terze parti.448Esegui `/login` per accedere con il tuo account claude.ai, quindi riprova il comando. Se invece l'errore nomina il tuo provider, vedi la [tabella degli errori](#errors-when-sending-to-a-cloud-session): le sessioni cloud non sono disponibili tramite provider di terze parti.

427 449 

428<h3 id="remote-control-session-expired-or-access-denied">450<h3 id="remote-control-session-expired-or-access-denied">

429 Sessione Remote Control scaduta o accesso negato451 Sessione Remote Control scaduta o accesso negato


435* Conferma che sei connesso allo stesso account che possiede la sessione457* Conferma che sei connesso allo stesso account che possiede la sessione

436* Se vedi `Remote Control may not be available for this organization`, un Proprietario non ha abilitato le sessioni cloud per la tua organizzazione458* Se vedi `Remote Control may not be available for this organization`, un Proprietario non ha abilitato le sessioni cloud per la tua organizzazione

437 459 

460<h3 id="errors-when-sending-to-a-cloud-session">

461 Errori durante l'invio a una sessione cloud

462</h3>

463 

464Questi errori derivano dall'esecuzione di `claude` con [`--cloud <session-id>`](#send-follow-ups-from-the-cli), con o senza `-p`. La CLI antepone agli errori il prefisso `Error: `. Un invio non riuscito viene racchiuso come `failed to send message to cloud session <id>: <reason>`.

465 

466| Messaggio | Significato |

467| - | - |

468| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code è configurato per un provider di terze parti. Il messaggio nomina il provider con l'etichetta usata dalla tua configurazione, come `Amazon Bedrock` o `Google Vertex AI`. Rimuovi la configurazione di quel provider, ad esempio annullando l'impostazione di `CLAUDE_CODE_USE_BEDROCK`, e accedi con un account Anthropic (`claude auth login`). |

469| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | Il criterio dell'organizzazione `allow_remote_sessions` è disattivato. |

470| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code non è riuscito a recuperare il criterio della tua organizzazione, quindi rifiuta l'invio anziché presumere che le sessioni cloud siano consentite. Controlla la connessione di rete e riprova. |

471| `Attaching to an existing cloud session is not enabled for your account.` | Hai eseguito `--cloud <session-id>` senza `-p`. Invia il messaggio con `claude -p "your message" --cloud <session-id>`. |

472| `Session not found: <id>` | L'ID o l'URL non corrisponde a una sessione a cui puoi accedere. Confrontalo con l'URL claude.ai/code della sessione. |

473| `cloud session <id> is archived and cannot accept new messages` | La sessione è stata archiviata. Avvia invece una nuova sessione. |

474 

438<h3 id="environment-expired">475<h3 id="environment-expired">

439 Ambiente scaduto476 Ambiente scaduto

440</h3>477</h3>

441 478 

442Le sessioni cloud si fermano dopo un periodo di inattività e la VM della sessione viene recuperata. Una sessione conta come inattiva mentre attende che tu approvi una chiamata dello strumento [MCP connector](/docs/it/cloud-environments#network-access) o che tu acceda a un server MCP, e può scadere durante quell'attesa.479Le sessioni cloud si fermano dopo un periodo di inattività e la VM della sessione viene recuperata. Una sessione conta come inattiva mentre attende che tu approvi una chiamata dello strumento [MCP connector](/docs/it/cloud-environments#network-access) o che tu acceda a un server MCP, e può scadere durante quell'attesa.

443 480 

444Riapri la sessione da [claude.ai/code](https://claude.ai/code) per fornire una VM fresca con la cronologia della conversazione ripristinata. Il lavoro in background che era ancora in esecuzione quando la VM è stata recuperata, come subagent e comandi shell, non viene ripristinato.481Riapri la sessione da [claude.ai/code](https://claude.ai/code) per fornire una VM nuova:

482 

483* **Ripristinata**: la cronologia della conversazione

484* **Non ripristinato**: il lavoro in background che era ancora in esecuzione quando la VM è stata recuperata, come subagent e comandi shell

445 485 

446<h2 id="limitations">486<h2 id="limitations">

447 Limitazioni487 Limitazioni

Details

429 badge: 'local',429 badge: 'local',

430 oneLiner: 'App state and UI preferences',430 oneLiner: 'App state and UI preferences',

431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,

432 description: <>Holds state that does not belong in settings.json: theme, OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,432 description: <>Holds state that does not belong in settings.json: OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,

433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],

434 example: `{434 example: `{

435 "autoConnectIde": true,435 "autoConnectIde": true,


497 oneLiner: 'Custom keyboard shortcuts',497 oneLiner: 'Custom keyboard shortcuts',

498 when: 'Read at session start and hot-reloaded when you edit the file',498 when: 'Read at session start and hot-reloaded when you edit the file',

499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,

500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+U</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+S</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,

501 example: `{501 example: `{

502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

503 "$docs": "https://code.claude.com/docs/en/keybindings",503 "$docs": "https://code.claude.com/docs/en/keybindings",


506 "context": "Chat",506 "context": "Chat",

507 "bindings": {507 "bindings": {

508 "ctrl+e": "chat:externalEditor",508 "ctrl+e": "chat:externalEditor",

509 "ctrl+u": null509 "ctrl+s": null

510 }510 }

511 }511 }

512 ]512 ]


1455| `managed-settings.json` | A livello di sistema, varia in base al sistema operativo | Impostazioni applicate dall'azienda che non puoi ignorare, a parte [eccezioni ristrette](/docs/it/settings#security-keys-where-the-stricter-value-applies). Vedi [dove salvare il file](/docs/it/managed-settings#deploy-a-managed-settings-file) e [quale fonte gestita Claude Code utilizza](/docs/it/managed-settings#precedence-within-the-managed-tier). |1455| `managed-settings.json` | A livello di sistema, varia in base al sistema operativo | Impostazioni applicate dall'azienda che non puoi ignorare, a parte [eccezioni ristrette](/docs/it/settings#security-keys-where-the-stricter-value-applies). Vedi [dove salvare il file](/docs/it/managed-settings#deploy-a-managed-settings-file) e [quale fonte gestita Claude Code utilizza](/docs/it/managed-settings#precedence-within-the-managed-tier). |

1456| `CLAUDE.local.md` | Radice del progetto | Le tue preferenze private per questo progetto, caricate insieme a CLAUDE.md. Crealo manualmente e aggiungilo a `.gitignore`. |1456| `CLAUDE.local.md` | Radice del progetto | Le tue preferenze private per questo progetto, caricate insieme a CLAUDE.md. Crealo manualmente e aggiungilo a `.gitignore`. |

1457| `AGENTS.md` | Radice del progetto, `.claude/`, o qualsiasi directory | Istruzioni di progetto che scrivi per gli agenti di codifica AI. Claude Code può [caricarlo](/docs/it/memory#agents-md) autonomamente o insieme a `CLAUDE.md`. |1457| `AGENTS.md` | Radice del progetto, `.claude/`, o qualsiasi directory | Istruzioni di progetto che scrivi per gli agenti di codifica AI. Claude Code può [caricarlo](/docs/it/memory#agents-md) autonomamente o insieme a `CLAUDE.md`. |

1458| Plugin installati | `~/.claude/plugins` | Marketplace clonati, versioni plugin installate, il record di installazione `installed_plugins.json` e dati per plugin, gestiti dai comandi `claude plugin`. I plugin [sincronizzati dal tuo account claude.ai](/docs/it/plugins/loading#synced-plugins) vengono scaricati in `~/.claude/plugins/synced/`. Per un plugin installato da un marketplace con [fonte `command`](/docs/it/plugins/marketplace-reference#command-plugin-source) in modalità link, Claude Code memorizza i link qui invece di una copia, e i file del plugin rimangono nella directory che il comando stampa. Una fonte `command` richiede Claude Code v2.1.229 o successivo. Un plugin elencato per percorso relativo in un marketplace di directory locale [carica in posizione](/docs/it/plugins/loading#find-plugins-on-disk) dalla sua directory di origine piuttosto che da una copia cache. Vedi [plugin caching](/docs/it/plugins/loading#find-plugins-on-disk) per come le versioni orfane vengono pulite. |1458| Plugin installati | `~/.claude/plugins` | Marketplace clonati, versioni plugin installate, il record di installazione `installed_plugins.json` e dati per plugin, gestiti dai comandi `claude plugin`. I plugin [sincronizzati dal tuo account claude.ai](/docs/it/plugins/loading#synced-plugins) vengono scaricati in `~/.claude/plugins/synced/`. Per un plugin installato da un marketplace con [fonte `command`](/docs/it/plugins/marketplace-reference#command-plugin-source) in modalità link, Claude Code memorizza i link qui invece di una copia, e i file del plugin rimangono nella directory che il comando stampa. Una fonte `command` richiede Claude Code v2.1.229 o successivo. Anche un plugin elencato per percorso relativo in un marketplace che hai aggiunto da un percorso locale [viene caricato sul posto](/docs/it/plugins/loading#find-plugins-on-disk) dalla sua directory di origine anziché da una copia nella cache. Vedi [plugin caching](/docs/it/plugins/loading#find-plugins-on-disk) per come le versioni orfane vengono pulite. |

1459 1459 

1460`~/.claude` contiene anche dati che Claude Code scrive mentre lavori: trascrizioni, cronologia dei prompt, snapshot dei file, cache e log. Vedi [dati dell'applicazione](#application-data) di seguito.1460`~/.claude` contiene anche dati che Claude Code scrive mentre lavori: trascrizioni, cronologia dei prompt, snapshot dei file, cache e log. Vedi [dati dell'applicazione](#application-data) di seguito.

1461 1461 

Details

26 26 

27* **Flussi CLI come `/web-setup`**: creano **Default** per voi27* **Flussi CLI come `/web-setup`**: creano **Default** per voi

28* **Onboarding web su Pro e Max**: crea **Default** per voi28* **Onboarding web su Pro e Max**: crea **Default** per voi

29* **Onboarding web su Team ed Enterprise**: mostra un modulo **Create your first cloud environment** a meno che un Owner non abbia attivato [Quick web setup](/docs/it/claude-code-on-the-web#github-authentication-options); mantenete i valori predefiniti del modulo e fate clic su **Create & finish** per ottenere lo stesso ambiente **Default**29* **Onboarding web su Team ed Enterprise**: mostra un modulo **Create your first cloud environment** a meno che un Owner non abbia attivato [Quick setup](/docs/it/claude-code-on-the-web#quick-setup-for-team-and-enterprise); mantieni i valori predefiniti del modulo e fai clic su **Create & finish** per ottenere lo stesso ambiente **Default**

30 30 

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

32 32 

costs.md +2 −2

Details

111| Il tuo ruolo | Cosa fa `/usage-credits` |111| Il tuo ruolo | Cosa fa `/usage-credits` |

112| :- | :- |112| :- | :- |

113| Sottoscrittore Pro o Max | Apre [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai nel browser. Nella sua sezione **Usage credits** puoi attivare o disattivare i crediti di utilizzo e controllare il saldo dei crediti, la spesa di questo mese e il tuo limite di spesa mensile |113| Sottoscrittore Pro o Max | Apre [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai nel browser. Nella sua sezione **Usage credits** puoi attivare o disattivare i crediti di utilizzo e controllare il saldo dei crediti, la spesa di questo mese e il tuo limite di spesa mensile |

114| Membro Team o Enterprise con accesso alla fatturazione | Apre le impostazioni di utilizzo della tua organizzazione, [**Admin settings > Usage**](https://claude.ai/admin-settings/usage), nel browser |114| Membro Team o Enterprise con accesso alla fatturazione | Apre le impostazioni di utilizzo della tua organizzazione, [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), nel browser |

115| Membro Team o Enterprise senza accesso alla fatturazione | Ti chiede di confermare, quindi invia una richiesta agli amministratori della tua organizzazione. Prima della v2.1.211, Claude Code ha inviato la richiesta senza un passaggio di conferma |115| Membro Team o Enterprise senza accesso alla fatturazione | Ti chiede di confermare, quindi invia una richiesta agli amministratori della tua organizzazione. Prima della v2.1.211, Claude Code ha inviato la richiesta senza un passaggio di conferma |

116 116 

117Per i membri Team e Enterprise senza accesso alla fatturazione, la conferma appare solo nelle sessioni interattive: in modalità non interattiva con il flag `-p` e da [Remote Control](/docs/it/remote-control), il comando non invia alcuna richiesta e ti dice di eseguirlo in una sessione interattiva.117Per i membri Team e Enterprise senza accesso alla fatturazione, la conferma appare solo nelle sessioni interattive: in modalità non interattiva con il flag `-p` e da [Remote Control](/docs/it/remote-control), il comando non invia alcuna richiesta e ti dice di eseguirlo in una sessione interattiva.


229* **"Hai raggiunto il tuo limite di sessione" o "Hai raggiunto il tuo limite settimanale"**: una finestra di utilizzo basata su posto in un piano di abbonamento, condivisa su tutti i modelli, quindi lo sviluppatore non può ripristinare l'accesso cambiando modelli con `/model`. Il messaggio mostra quando la finestra si ripristina. Dopo il messaggio specifico del modello "Hai raggiunto il tuo limite Opus" o "Hai raggiunto il tuo limite Sonnet", cambiare a un modello al di fuori di quella famiglia con `/model` mantiene lo sviluppatore al lavoro. Vedi [errori di limite di utilizzo](/docs/it/errors#youve-hit-your-session-limit). Quello che lo sviluppatore può fare nel frattempo:229* **"Hai raggiunto il tuo limite di sessione" o "Hai raggiunto il tuo limite settimanale"**: una finestra di utilizzo basata su posto in un piano di abbonamento, condivisa su tutti i modelli, quindi lo sviluppatore non può ripristinare l'accesso cambiando modelli con `/model`. Il messaggio mostra quando la finestra si ripristina. Dopo il messaggio specifico del modello "Hai raggiunto il tuo limite Opus" o "Hai raggiunto il tuo limite Sonnet", cambiare a un modello al di fuori di quella famiglia con `/model` mantiene lo sviluppatore al lavoro. Vedi [errori di limite di utilizzo](/docs/it/errors#youve-hit-your-session-limit). Quello che lo sviluppatore può fare nel frattempo:

230 * Esegui `/usage-credits` per richiedere utilizzo oltre l'indennità, se hai i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) attivati.230 * Esegui `/usage-credits` per richiedere utilizzo oltre l'indennità, se hai i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) attivati.

231 * Su Claude Code v2.1.234 o successivo, [attendi e continua il compito interrotto automaticamente dopo il ripristino](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset); quella sezione elenca quando Claude Code avvia l'attesa da solo e quando lo sviluppatore lo seleziona da `/rate-limit-options`. Per controllare per la tua flotta se Claude Code avvia quell'attesa da solo, imposta [`autoContinueAtUsageLimit`](/docs/it/settings-reference#autocontinueatusagelimit) nelle [impostazioni gestite](/docs/it/settings#settings-precedence).231 * Su Claude Code v2.1.234 o successivo, [attendi e continua il compito interrotto automaticamente dopo il ripristino](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset); quella sezione elenca quando Claude Code avvia l'attesa da solo e quando lo sviluppatore lo seleziona da `/rate-limit-options`. Per controllare per la tua flotta se Claude Code avvia quell'attesa da solo, imposta [`autoContinueAtUsageLimit`](/docs/it/settings-reference#autocontinueatusagelimit) nelle [impostazioni gestite](/docs/it/settings#settings-precedence).

232* **"Hai raggiunto il tuo limite di spesa individuale", "limite di spesa mensile dell'organizzazione", o "budget condiviso del team"**: la richiesta dello sviluppatore verrebbe fatturata ai crediti di utilizzo, e quei crediti hanno raggiunto un limite di spesa che hai impostato. Per consentire allo sviluppatore di continuare, vai a [**Impostazioni Admin > Utilizzo**](https://claude.ai/admin-settings/usage) e aumenta il limite che il messaggio nomina. Quando il messaggio nomina anche un'ora di ripristino del piano, lo sviluppatore può invece attendere fino ad allora. Vedi il [riferimento degli errori](/docs/it/errors#youve-hit-your-monthly-spend-limit) per ogni variante.232* **"You've hit your individual spend limit", "org's monthly spend limit" o "team's shared budget"**: la richiesta dello sviluppatore verrebbe fatturata ai crediti di utilizzo, e quei crediti hanno raggiunto un limite di spesa che hai impostato. Per consentire allo sviluppatore di continuare, vai a [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) e aumenta il limite indicato dal messaggio. Quando il messaggio indica anche un'ora di ripristino del piano, lo sviluppatore può invece attendere fino ad allora. Vedi il [riferimento degli errori](/docs/it/errors#youve-hit-your-monthly-spend-limit) per ogni variante.

233* **Un messaggio di limite di spesa da un [gateway di app Claude](/docs/it/claude-apps-gateway)**: lo sviluppatore ha superato un limite di spesa che hai impostato sul tuo gateway self-hosted, e il gateway blocca le sue richieste fino al ripristino del periodo o fino a quando non aumenti il limite. Vedi [limiti di spesa del gateway](/docs/it/claude-apps-gateway-spend-limits) per i limiti, i programmi di ripristino e il messaggio che lo sviluppatore vede.233* **Un messaggio di limite di spesa da un [gateway di app Claude](/docs/it/claude-apps-gateway)**: lo sviluppatore ha superato un limite di spesa che hai impostato sul tuo gateway self-hosted, e il gateway blocca le sue richieste fino al ripristino del periodo o fino a quando non aumenti il limite. Vedi [limiti di spesa del gateway](/docs/it/claude-apps-gateway-spend-limits) per i limiti, i programmi di ripristino e il messaggio che lo sviluppatore vede.

234* **Un avviso di contesto o auto-compact**: non è un limite di utilizzo. La conversazione è cresciuta vicino alla [finestra auto-compact](/docs/it/model-config#set-the-auto-compact-window) della sessione, la soglia in cui Claude Code riassume la cronologia più vecchia per liberare spazio. Indirizza lo sviluppatore a [riduci l'utilizzo dei token](#reduce-token-usage).234* **Un avviso di contesto o auto-compact**: non è un limite di utilizzo. La conversazione è cresciuta vicino alla [finestra auto-compact](/docs/it/model-config#set-the-auto-compact-window) della sessione, la soglia in cui Claude Code riassume la cronologia più vecchia per liberare spazio. Indirizza lo sviluppatore a [riduci l'utilizzo dei token](#reduce-token-usage).

235* **Spesa inaspettatamente alta su un piano API o provider cloud**: di solito risale a sessioni lunghe che non sono mai state cancellate o a Opus lasciato come modello predefinito. Le abitudini con il maggiore impatto da condividere sono cancellare tra compiti non correlati e abbinare il modello al lavoro, entrambi coperti in [riduci l'utilizzo dei token](#reduce-token-usage).235* **Spesa inaspettatamente alta su un piano API o provider cloud**: di solito risale a sessioni lunghe che non sono mai state cancellate o a Opus lasciato come modello predefinito. Le abitudini con il maggiore impatto da condividere sono cancellare tra compiti non correlati e abbinare il modello al lavoro, entrambi coperti in [riduci l'utilizzo dei token](#reduce-token-usage).

Details

192Uno di questi mostra il testo completo:192Uno di questi mostra il testo completo:

193 193 

194* Premi `Ctrl+O` per aprire il [visualizzatore di trascrizioni](/docs/it/interactive-mode#transcript-viewer) e leggi il testo completo sotto il nome della sessione del mittente.194* Premi `Ctrl+O` per aprire il [visualizzatore di trascrizioni](/docs/it/interactive-mode#transcript-viewer) e leggi il testo completo sotto il nome della sessione del mittente.

195* Nel [rendering a schermo intero](/docs/it/fullscreen#use-the-mouse), fai clic su una riga di anteprima che omette parte del messaggio per espanderla sul posto.

195* In una sessione avviata con [`--verbose`](/docs/it/cli-reference#cli-flags), Claude Code mostra il testo completo invece dell'anteprima.196* In una sessione avviata con [`--verbose`](/docs/it/cli-reference#cli-flags), Claude Code mostra il testo completo invece dell'anteprima.

196 197 

197L'anteprima accorcia solo quello che vedi. Che tu lo espanda o no, Claude legge il messaggio completo.198L'anteprima accorcia solo quello che vedi. Che tu lo espanda o no, Claude legge il messaggio completo.

desktop.md +15 −15

Details

244 Cambia modalità di visualizzazione244 Cambia modalità di visualizzazione

245</h3>245</h3>

246 246 

247Le modalità di visualizzazione controllano quanti dettagli appaiono nella trascrizione della chat. Cambia modalità dal menu a discesa **Transcript view** accanto al pulsante di invio, o premi **Ctrl+O** su macOS o Windows per scorrere tra loro. La modalità Thinking appare nel menu a discesa solo dopo che Claude ha prodotto thinking nella sessione che stai visualizzando.247Le modalità di visualizzazione controllano quanti dettagli appaiono nella trascrizione della chat. Per cambiare modalità di visualizzazione, apri il menu della sessione dal cursore accanto al titolo della sessione e seleziona **Transcript view**, o premi **Ctrl+O** su macOS o Windows per scorrere tra loro. La modalità Thinking appare nel menu solo dopo che Claude ha prodotto ragionamento nella sessione che stai visualizzando.

248 248 

249| Modalità | Cosa mostra |249| Modalità | Cosa mostra |

250| - | - |250| - | - |


372 Gestisci le sessioni372 Gestisci le sessioni

373</h2>373</h2>

374 374 

375Ogni sessione è una conversazione indipendente con il suo proprio contesto e modifiche. Puoi eseguire più sessioni in parallelo, diramazioni di chat laterali, lasciare che Claude controlli e messaggi le tue altre sessioni, inviare il lavoro al cloud, o lasciare che Dispatch avvii sessioni per te dal tuo telefono.375Ogni sessione è una conversazione indipendente con il suo proprio contesto e modifiche. Puoi eseguire più sessioni in parallelo, aprire chat laterali, lasciare che Claude controlli e messaggi le tue altre sessioni, inviare il lavoro al cloud, o lasciare che Dispatch avvii sessioni per te dal tuo telefono.

376 376 

377<h3 id="work-in-parallel-with-sessions">377<h3 id="work-in-parallel-with-sessions">

378 Lavora in parallelo con le sessioni378 Lavora in parallelo con le sessioni

379</h3>379</h3>

380 380 

381Fai clic su **+ New session** nella barra laterale, o premi **Cmd+N** su macOS o **Ctrl+N** su Windows, per lavorare su più compiti in parallelo. Premi **Ctrl+Tab** e **Ctrl+Shift+Tab** per scorrere le sessioni nella barra laterale. Per i repository Git, seleziona l'opzione **worktree** accanto al nome del ramo per dare alla sessione la sua copia isolata del tuo progetto usando [Git worktrees](/docs/it/worktrees), in modo che le modifiche in una sessione non influiscano su altre sessioni fino a quando non le esegui il commit.381Fai clic su **+ New session** nella barra laterale, o premi **Cmd+N** su macOS o **Ctrl+N** su Windows, per lavorare su più compiti in parallelo. Premi **Ctrl+Tab** e **Ctrl+Shift+Tab** per scorrere le sessioni nella barra laterale. Per i repository Git, seleziona l'opzione **worktree** accanto al nome del branch per dare alla sessione la sua copia isolata del tuo progetto usando [Git worktrees](/docs/it/worktrees), in modo che le modifiche in una sessione non influiscano su altre sessioni fino a quando non ne esegui il commit.

382 382 

383Per visualizzare due sessioni contemporaneamente, tieni premuto **Cmd** su macOS o **Ctrl** su Windows e fai clic su una sessione nella barra laterale. La sessione si apre in un secondo riquadro accanto a quello che hai già aperto. Mentre la divisione è attiva, facendo clic su un'altra sessione della barra laterale si sostituisce il riquadro che ha il focus. Premi **Cmd+\\** su macOS o **Ctrl+\\** su Windows per chiudere il riquadro con focus e tornare a una singola sessione.383Per visualizzare due sessioni contemporaneamente, tieni premuto **Cmd** su macOS o **Ctrl** su Windows e fai clic su una sessione nella barra laterale. La sessione si apre in un secondo riquadro accanto a quello che hai già aperto. Mentre la divisione è attiva, facendo clic su un'altra sessione della barra laterale si sostituisce il riquadro che ha il focus. Premi **Cmd+\\** su macOS o **Ctrl+\\** su Windows per chiudere il riquadro con focus e tornare a una singola sessione.

384 384 

385I worktree sono archiviati in `<project-root>/.claude/worktrees/` per impostazione predefinita. Puoi cambiare questo in una directory personalizzata in Impostazioni → Claude Code sotto "Worktree location". Puoi anche impostare un prefisso di ramo che viene anteposto a ogni nome di ramo worktree, il che è utile per mantenere organizzati i rami creati da Claude. Per rimuovere un worktree quando hai finito, passa il mouse sulla sessione nella barra laterale e fai clic sull'icona di archivio. Per avere sessioni che si archiviano automaticamente quando il loro pull request si unisce o si chiude, attiva **Auto-archive after PR merge or close** in Impostazioni → Claude Code. Auto-archive si applica solo alle sessioni locali che hanno finito di funzionare.385I worktree sono archiviati in `<project-root>/.claude/worktrees/` per impostazione predefinita. Puoi cambiare questo in una directory personalizzata in Impostazioni → Claude Code sotto "Worktree location". Puoi anche impostare un prefisso di branch che viene anteposto a ogni nome di branch worktree, il che è utile per mantenere organizzati i branch creati da Claude. Per rimuovere un worktree quando hai finito, passa il mouse sulla sessione nella barra laterale e fai clic sull'icona di archivio. Per avere sessioni che si archiviano automaticamente quando viene eseguito il merge della loro pull request o quando questa viene chiusa, attiva **Auto-archive after PR merge or close** in Impostazioni → Claude Code. Auto-archive si applica solo alle sessioni locali che hanno finito di funzionare.

386 386 

387Per includere file gitignored come `.env` nei nuovi worktree, crea un [file `.worktreeinclude`](/docs/it/worktrees#copy-gitignored-files-into-worktrees) nella radice del tuo progetto.387Per includere file gitignored come `.env` nei nuovi worktree, crea un [file `.worktreeinclude`](/docs/it/worktrees#copy-gitignored-files-into-worktrees) nella radice del tuo progetto.

388 388 


410 Guarda le attività in background410 Guarda le attività in background

411</h3>411</h3>

412 412 

413Il pannello attività mostra il lavoro in background in esecuzione all'interno della sessione corrente: subagent, comandi shell in background e [flussi di lavoro dinamici](/docs/it/workflows). Aprilo dal menu **Views** o trascinalo nel tuo layout.413Il pannello attività mostra il lavoro in background in esecuzione all'interno della sessione corrente: subagent, comandi shell in background e [workflow dinamici](/docs/it/workflows). Aprilo dal menu **Views** o trascinalo nel tuo layout.

414 414 

415Fai clic su qualsiasi voce per vedere il suo output nel pannello subagent o fermarlo. Per vedere cosa stanno facendo altre sessioni, usa la [barra laterale](#work-in-parallel-with-sessions), o chiedi a Claude di [controllarle per te](#work-across-sessions).415Fai clic su qualsiasi voce per vedere il suo output nel pannello subagent o fermarlo. Per vedere cosa stanno facendo altre sessioni, usa la [barra laterale](#work-in-parallel-with-sessions), o chiedi a Claude di [controllarle per te](#work-across-sessions).

416 416 


418 Lavora tra le sessioni418 Lavora tra le sessioni

419</h3>419</h3>

420 420 

421Claude può elencare le tue altre sessioni della scheda Code, leggere cosa ognuna ha fatto, e inviare messaggi tra di loro. Chiedi in linguaggio naturale: "quale sessione ha toccato il refactor dell'autenticazione?", "cosa ha concluso la sessione API?", o "dì alla sessione dei pagamenti che lo schema è cambiato". Puoi anche chiedere a Claude di rinominare o archiviare una sessione. Claude archivia una sessione nello stesso modo in cui lo fa l'icona di archivio della barra laterale, quindi chiedigli di pulire le sessioni i cui PR si sono uniti.421Claude può elencare le tue altre sessioni della scheda Code, leggere cosa ognuna ha fatto, e inviare messaggi tra di loro. Chiedi in linguaggio naturale: "quale sessione ha toccato il refactor dell'autenticazione?", "cosa ha concluso la sessione API?", o "dì alla sessione dei pagamenti che lo schema è cambiato". Puoi anche chiedere a Claude di rinominare o archiviare una sessione. Claude archivia una sessione nello stesso modo in cui lo fa l'icona di archivio della barra laterale, quindi chiedigli di pulire le sessioni delle cui PR è stato eseguito il merge.

422 422 

423Attraverso questa superficie, Claude vede solo le sessioni che l'app desktop esegue da sola: locale, [SSH](#ssh-sessions), e sessioni [WSL](/docs/it/desktop-wsl) nella scheda Code. Claude non vede le sessioni cloud, o le sessioni che hai avviato dal CLI del terminale o dall'estensione VS Code, anche nei worktree dello stesso progetto, quindi con nove worktree del terminale aperti e due sessioni desktop, Claude che risponde in una di esse segnala l'altra sessione desktop. Claude non elenca mai la sessione da cui stai chiedendo. Per impostazione predefinita vede le 20 sessioni più recentemente attive e salta le sessioni archiviate a meno che non le chiedi. [La messaggistica tra sessioni](/docs/it/cross-session-messaging) consente separatamente a Claude di inviare messaggi alle [tue altre sessioni Claude Code](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach), incluse le sessioni del terminale.423Attraverso questa superficie, Claude vede solo le sessioni che l'app desktop esegue da sola: locale, [SSH](#ssh-sessions), e sessioni [WSL](/docs/it/desktop-wsl) nella scheda Code. Claude non vede le sessioni cloud, o le sessioni che hai avviato dal CLI del terminale o dall'estensione VS Code, anche nei worktree dello stesso progetto, quindi con nove worktree del terminale aperti e due sessioni desktop, Claude che risponde in una di esse segnala l'altra sessione desktop. Claude non elenca mai la sessione da cui stai chiedendo. Per impostazione predefinita vede le 20 sessioni più recentemente attive e salta le sessioni archiviate a meno che non le chiedi. [La messaggistica tra sessioni](/docs/it/cross-session-messaging) consente separatamente a Claude di inviare messaggi alle [tue altre sessioni Claude Code](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach), incluse le sessioni del terminale.

424 424 


426 426 

427Claude Code applica quattro comportamenti di sicurezza tra le sessioni:427Claude Code applica quattro comportamenti di sicurezza tra le sessioni:

428 428 

429* Prima di archiviare qualsiasi sessione, Claude ti chiede prima. Vedi la scheda di approvazione in ogni modalità di autorizzazione, incluse le autorizzazioni Auto e Bypass.429* Prima di archiviare qualsiasi sessione, Claude ti chiede prima. Vedi la scheda di approvazione in ogni modalità di permesso, inclusi i permessi Auto e Bypass.

430* Attraverso questa superficie, Claude non può inviare messaggi tra sessioni da una sessione che nessuno sta guardando, come un'esecuzione di attività pianificata, e non può consegnare messaggi in una.430* Attraverso questa superficie, Claude non può inviare messaggi tra sessioni da una sessione che nessuno sta guardando, come un'esecuzione di attività pianificata, e non può consegnare messaggi in una.

431* Claude Code controlla ogni messaggio da questa superficie rispetto ai [controlli in entrata](/docs/it/cross-session-messaging#control-inbound-messages) della sessione ricevente, anche quando la sessione ricevente non ha [messaggistica tra sessioni](/docs/it/cross-session-messaging#availability) stessa. Se imposti [`crossSessionInbound`](/docs/it/settings-reference#crosssessioninbound) su `refuse` nella sessione ricevente, Claude Code scarta i messaggi da questa superficie. Claude Code segnala il rifiuto all'app desktop Claude. Prima della v2.1.234, Claude Code scartava ogni messaggio da questa superficie a una sessione ricevente senza messaggistica tra sessioni.431* Claude Code controlla ogni messaggio da questa superficie rispetto ai [controlli in entrata](/docs/it/cross-session-messaging#control-inbound-messages) della sessione ricevente, anche quando la sessione ricevente non ha [messaggistica tra sessioni](/docs/it/cross-session-messaging#availability) stessa. Se imposti [`crossSessionInbound`](/docs/it/settings-reference#crosssessioninbound) su `refuse` nella sessione ricevente, Claude Code scarta i messaggi da questa superficie. Claude Code segnala il rifiuto all'app desktop Claude. Prima della v2.1.234, Claude Code scartava ogni messaggio da questa superficie a una sessione ricevente senza messaggistica tra sessioni.

432* Claude Code cita ogni messaggio in arrivo e lo attribuisce alla sessione che l'ha inviato, e Claude segue comunque le impostazioni di autorizzazione proprie della sessione ricevente quando agisce su uno.432* Claude Code cita ogni messaggio in arrivo e lo attribuisce alla sessione che l'ha inviato, e Claude segue comunque le impostazioni di permesso proprie della sessione ricevente quando agisce su uno.

433 433 

434Claude può anche suggerire nuove sessioni. Quando nota qualcosa che vale la pena correggere che è fuori portata per l'attività corrente, offre il lavoro come una scheda di attività nella chat. Fai clic sulla scheda per avviare quel lavoro in una nuova sessione con il suo proprio worktree; Claude continua la tua sessione corrente senza interruzioni.434Claude può anche suggerire nuove sessioni. Quando nota qualcosa che vale la pena correggere che è fuori portata per l'attività corrente, offre il lavoro come una scheda di attività nella chat. Fai clic sulla scheda per avviare quel lavoro in una nuova sessione con il suo proprio worktree; Claude continua la tua sessione corrente senza interruzioni.

435 435 


439 439 

440Per grandi refactor, suite di test, migrazioni o altre attività a lunga esecuzione, seleziona **Cloud** invece di **Local** quando avvii una sessione. Le sessioni cloud vengono eseguite sull'infrastruttura gestita da Anthropic per impostazione predefinita e continuano anche se chiudi l'app o spegni il computer. Torna indietro in qualsiasi momento per vedere i progressi o indirizzare Claude in una direzione diversa. Puoi anche monitorare le sessioni cloud da [claude.ai/code](https://claude.ai/code) o dall'[app mobile Claude](/docs/it/mobile).440Per grandi refactor, suite di test, migrazioni o altre attività a lunga esecuzione, seleziona **Cloud** invece di **Local** quando avvii una sessione. Le sessioni cloud vengono eseguite sull'infrastruttura gestita da Anthropic per impostazione predefinita e continuano anche se chiudi l'app o spegni il computer. Torna indietro in qualsiasi momento per vedere i progressi o indirizzare Claude in una direzione diversa. Puoi anche monitorare le sessioni cloud da [claude.ai/code](https://claude.ai/code) o dall'[app mobile Claude](/docs/it/mobile).

441 441 

442Le sessioni cloud supportano anche più repository. Dopo aver selezionato un ambiente cloud, fai clic sul pulsante **+** accanto al repository selezionato per aggiungere repository aggiuntivi alla sessione. Ogni repo ottiene il suo selettore di ramo. Questo è utile per compiti che si estendono su più codebase, come l'aggiornamento di una libreria condivisa e dei suoi consumatori.442Le sessioni cloud supportano anche più repository. Dopo aver selezionato un ambiente cloud, fai clic sul pulsante **+** accanto al repository selezionato per aggiungere repository aggiuntivi alla sessione. Ogni repo ottiene il suo selettore di branch. Questo è utile per compiti che si estendono su più codebase, come l'aggiornamento di una libreria condivisa e dei suoi consumatori.

443 443 

444Vedi [Usa Claude Code nel cloud](/docs/it/claude-code-on-the-web) per ulteriori informazioni su come funzionano le sessioni cloud. Quando un corpo di lavoro ha bisogno di molte sessioni cloud, seleziona **Projects** nella barra laterale per creare un [progetto](/docs/it/claude-projects), dove Claude avvia e traccia le sessioni per te da una conversazione.444Vedi [Usa Claude Code nel cloud](/docs/it/claude-code-on-the-web) per ulteriori informazioni su come funzionano le sessioni cloud. Quando un corpo di lavoro ha bisogno di molte sessioni cloud, seleziona **Projects** nella barra laterale per creare un [progetto](/docs/it/claude-projects), dove Claude avvia e traccia le sessioni per te da una conversazione.

445 445 


447 Continua su un'altra superficie447 Continua su un'altra superficie

448</h3>448</h3>

449 449 

450Il menu **Continue in**, accessibile dall'icona VS Code in basso a destra della barra degli strumenti della sessione, ti consente di spostare la tua sessione su un'altra superficie:450Per continuare una sessione altrove, apri il menu della sessione dalla freccia accanto al titolo della sessione o dalla riga della sessione nella barra laterale, quindi seleziona **Open in**:

451 451 

452* **Claude Code sul web**: invia la tua sessione locale per continuare l'esecuzione nel cloud. Desktop esegue il push del tuo ramo, genera un riepilogo della conversazione e crea una nuova sessione cloud con il contesto completo. Puoi quindi scegliere di archiviare la sessione locale o mantenerla. Questo richiede un albero di lavoro pulito e non è disponibile per le sessioni SSH.452* Seleziona **Cloud** per continuare la sessione come [sessione cloud](/docs/it/claude-code-on-the-web), con la tua conversazione trasferita sotto forma di riepilogo. Prima di confermare, la finestra di dialogo indica se vengono spostati anche i tuoi file e se questa sessione viene archiviata una volta che quella cloud è pronta. Non puoi spostare in questo modo una sessione eseguita tramite [SSH](#ssh-sessions) o in [WSL](/docs/it/desktop-wsl).

453* **Il tuo IDE**: apre il tuo progetto in un IDE supportato nella directory di lavoro corrente.453* Seleziona un editor installato o il tuo file manager per aprire lì la cartella della sessione su disco.

454 454 

455<h3 id="sessions-from-dispatch">455<h3 id="sessions-from-dispatch">

456 Sessioni da Dispatch456 Sessioni da Dispatch


462 462 

463In entrambi i casi, la sessione Code appare nella barra laterale della scheda Code con un badge **Dispatch**. Ricevi una notifica push sul tuo telefono quando finisce o ha bisogno della tua approvazione.463In entrambi i casi, la sessione Code appare nella barra laterale della scheda Code con un badge **Dispatch**. Ricevi una notifica push sul tuo telefono quando finisce o ha bisogno della tua approvazione.

464 464 

465Se hai [l'utilizzo del computer](#let-claude-use-your-computer) abilitato, le sessioni Code generate da Dispatch possono usarlo anche. Le approvazioni delle app in quelle sessioni scadono dopo 30 minuti e ripromptano, piuttosto che durare l'intera sessione come le sessioni Code regolari.465Se hai [l'utilizzo del computer](#let-claude-use-your-computer) abilitato, le sessioni Code generate da Dispatch possono usarlo anche. Le approvazioni delle app in quelle sessioni scadono dopo 30 minuti e vengono richieste di nuovo, piuttosto che durare l'intera sessione come le sessioni Code regolari.

466 466 

467Per la configurazione, l'accoppiamento e le impostazioni di Dispatch, vedi l'[articolo di aiuto di Dispatch](https://support.claude.com/en/articles/13947068). Dispatch richiede un piano Pro o Max e non è disponibile su piani Team o Enterprise.467Per la configurazione, l'accoppiamento e le impostazioni di Dispatch, vedi l'[articolo di aiuto di Dispatch](https://support.claude.com/en/articles/13947068). Dispatch richiede un piano Pro o Max e non è disponibile su piani Team o Enterprise.

468 468 


739 739 

740[Extended thinking](/docs/it/model-config#extended-thinking) è abilitato per impostazione predefinita, il che migliora le prestazioni su compiti di ragionamento complesso ma utilizza token aggiuntivi. Su Anthropic API, imposta `MAX_THINKING_TOKENS` a `0` nell'editor di ambiente locale per disattivare il thinking; questo non ha effetto su Opus 5.5, Sonnet 5.5 o sui Fable models, che utilizzano sempre extended thinking. Con il thinking disattivato su Anthropic API, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.740[Extended thinking](/docs/it/model-config#extended-thinking) è abilitato per impostazione predefinita, il che migliora le prestazioni su compiti di ragionamento complesso ma utilizza token aggiuntivi. Su Anthropic API, imposta `MAX_THINKING_TOKENS` a `0` nell'editor di ambiente locale per disattivare il thinking; questo non ha effetto su Opus 5.5, Sonnet 5.5 o sui Fable models, che utilizzano sempre extended thinking. Con il thinking disattivato su Anthropic API, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

741 741 

742Su modelli con [adaptive reasoning](/docs/it/model-config#adjust-effort-level), i valori `MAX_THINKING_TOKENS` diversi da `0` vengono ignorati perché il adaptive reasoning controlla la profondità del thinking. Su Opus 4.6 e Sonnet 4.6, imposta `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` a `1` per usare un budget di thinking fisso; Fable models, Sonnet 5 e versioni successive, e Opus 4.7 e versioni successive utilizzano sempre il adaptive reasoning e non hanno una modalità di budget fisso.742Sui modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level), Claude Code ignora il numero in sé in un valore positivo di `MAX_THINKING_TOKENS`, perché è invece il ragionamento adattivo a controllare la profondità del ragionamento. Su Opus 4.6 e Sonnet 4.6, imposta `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` a `1` per usare un budget di ragionamento fisso; i modelli Fable, Sonnet 5 e versioni successive, e Opus 4.7 e versioni successive utilizzano sempre il ragionamento adattivo e non hanno una modalità di budget fisso.

743 743 

744<h4 id="local-sessions-on-managed-devices">744<h4 id="local-sessions-on-managed-devices">

745 Local sessions on managed devices745 Local sessions on managed devices


1005| `--dangerously-skip-permissions` | Modalità Bypass permissions. Su piani Pro e Max, abilitala in Impostazioni → Claude Code → "Allow bypass permissions mode"; su piani Team ed Enterprise, la politica organizzativa la controlla |1005| `--dangerously-skip-permissions` | Modalità Bypass permissions. Su piani Pro e Max, abilitala in Impostazioni → Claude Code → "Allow bypass permissions mode"; su piani Team ed Enterprise, la politica organizzativa la controlla |

1006| `--add-dir` | Aggiungi più repo con il pulsante **+** nelle sessioni cloud |1006| `--add-dir` | Aggiungi più repo con il pulsante **+** nelle sessioni cloud |

1007| `--allowedTools`, `--disallowedTools` | Nessun equivalente per sessione. Le regole di autorizzazione nei [file di impostazioni](/docs/it/settings) si applicano ancora. |1007| `--allowedTools`, `--disallowedTools` | Nessun equivalente per sessione. Le regole di autorizzazione nei [file di impostazioni](/docs/it/settings) si applicano ancora. |

1008| `--verbose` | Modalità di visualizzazione [Verbose view mode](#switch-view-modes) nel menu a discesa della vista Transcript |1008| `--verbose` | [Modalità di visualizzazione Verbose](#switch-view-modes) |

1009| `--print`, `--output-format` | Non disponibile. Desktop è solo interattivo. |1009| `--print`, `--output-format` | Non disponibile. Desktop è solo interattivo. |

1010| `ANTHROPIC_MODEL` env var | Menu a discesa del modello accanto al pulsante di invio |1010| `ANTHROPIC_MODEL` env var | Menu a discesa del modello accanto al pulsante di invio |

1011| `MAX_THINKING_TOKENS` env var | Imposta nell'editor di ambiente locale. Vedi [configurazione dell'ambiente](#environment-configuration). |1011| `MAX_THINKING_TOKENS` env var | Imposta nell'editor di ambiente locale. Vedi [configurazione dell'ambiente](#environment-configuration). |

Details

92* Salvare uno screenshot con **Cmd+S** o una registrazione dello schermo con **Cmd+R**, utilizzando i pulsanti di acquisizione del riquadro o le scorciatoie da tastiera; i file vengono salvati sul tuo Desktop92* Salvare uno screenshot con **Cmd+S** o una registrazione dello schermo con **Cmd+R**, utilizzando i pulsanti di acquisizione del riquadro o le scorciatoie da tastiera; i file vengono salvati sul tuo Desktop

93* Interrompere lo streaming di un dispositivo senza spegnerlo facendo clic su **Detach simulator**, che riporta il riquadro allo stato **Attach simulator**93* Interrompere lo streaming di un dispositivo senza spegnerlo facendo clic su **Detach simulator**, che riporta il riquadro allo stato **Attach simulator**

94 94 

95La riga sotto il nome del dispositivo regola il flusso video dal simulatore. Abbassa **Frame rate** o **Resolution** se il riquadro affatica il tuo Mac, cambia **Encoding** tra H.264 e JPEG, oppure seleziona **FPS** per visualizzare la frequenza dei fotogrammi che il riquadro sta ricevendo. Queste impostazioni cambiano il modo in cui il riquadro visualizza il dispositivo, non il modo in cui l'app viene eseguita.95Per regolare il flusso video dal simulatore, apri il menu **Display** del riquadro. Abbassa **Frame rate** o **Resolution** se il riquadro affatica il tuo Mac. Entrambe le impostazioni cambiano il modo in cui il riquadro visualizza il dispositivo, non il modo in cui l'app viene eseguita.

96 96 

97Tu e Claude controllate lo stesso dispositivo, quindi i tuoi tocchi cambiano lo stato dell'app che Claude vede. Per fare in modo che Claude verifichi uno schermo specifico, navigaci toccando, quindi chiedi. Mentre Claude controlla il dispositivo, il riquadro mostra un badge **Claude is using this device** sopra lo schermo; aspetta che il badge scompaia prima di toccare, in modo che il risultato rifletta l'app piuttosto che il tuo input.97Tu e Claude controllate lo stesso dispositivo, quindi i tuoi tocchi cambiano lo stato dell'app che Claude vede. Per fare in modo che Claude verifichi uno schermo specifico, navigaci toccando, quindi chiedi. Mentre Claude controlla il dispositivo, il riquadro mostra un badge **Claude is using this device** sopra lo schermo; aspetta che il badge scompaia prima di toccare, in modo che il risultato rifletta l'app piuttosto che il tuo input.

98 98 

Details

135 135 

136**Pianifica il lavoro di Claude.** Configura delle [attività pianificate](/docs/it/desktop-scheduled-tasks) per eseguire Claude automaticamente a intervalli ricorrenti: una code review quotidiana ogni mattina, un audit settimanale delle dipendenze o un briefing che attinge dai tuoi strumenti collegati.136**Pianifica il lavoro di Claude.** Configura delle [attività pianificate](/docs/it/desktop-scheduled-tasks) per eseguire Claude automaticamente a intervalli ricorrenti: una code review quotidiana ogni mattina, un audit settimanale delle dipendenze o un briefing che attinge dai tuoi strumenti collegati.

137 137 

138**Amplia il lavoro quando sei pronto.** Apri [sessioni parallele](/docs/it/desktop#work-in-parallel-with-sessions) dalla barra laterale per lavorare su più attività contemporaneamente, facoltativamente ciascuna nel proprio worktree Git, e apri il [riquadro delle attività](/docs/it/desktop#watch-background-tasks) per osservare i subagent e i comandi in background che una sessione ha in esecuzione. Apri una [chat laterale](/docs/it/desktop#ask-a-side-question-without-derailing-the-session) per fare una domanda senza deviare il thread principale. Invia il [lavoro di lunga durata al cloud](/docs/it/desktop#run-long-running-tasks-in-the-cloud) in modo che continui anche se chiudi l'app, oppure [continua una sessione sul web o nel tuo IDE](/docs/it/desktop#continue-in-another-surface) se un'attività richiede più tempo del previsto. [Collega strumenti esterni](/docs/it/desktop#extend-claude-code) come GitHub, Slack e Linear per riunire il tuo workflow.138**Amplia il lavoro quando sei pronto.** Apri [sessioni parallele](/docs/it/desktop#work-in-parallel-with-sessions) dalla barra laterale per lavorare su più attività contemporaneamente, facoltativamente ciascuna nel proprio worktree Git, e apri il [riquadro delle attività](/docs/it/desktop#watch-background-tasks) per osservare i subagent e i comandi in background che una sessione ha in esecuzione. Apri una [chat laterale](/docs/it/desktop#ask-a-side-question-without-derailing-the-session) per fare una domanda senza deviare il thread principale. Invia il [lavoro di lunga durata al cloud](/docs/it/desktop#run-long-running-tasks-in-the-cloud) in modo che continui anche se chiudi l'app, oppure [sposta nel cloud una sessione che hai già avviato](/docs/it/desktop#continue-in-another-surface) se un'attività richiede più tempo del previsto. [Collega strumenti esterni](/docs/it/desktop#extend-claude-code) come GitHub, Slack e Linear per riunire il tuo workflow.

139 139 

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 Cosa fare dopo141 Cosa fare dopo

env-vars.md +403 −364

Details

124 Variabili124 Variabili

125</h2>125</h2>

126 126 

127Le variabili numeriche come timeout, budget di token e numero di nuovi tentativi accettano la notazione scientifica e le grafie con separatore di cifre oltre alle cifre semplici, tranne dove la riga di una variabile indica che accetta solo cifre semplici. Ad esempio, Claude Code legge `2e3` come 2000 e `64_000` come 64000. Prima della v2.1.211, queste grafie potevano impostare silenziosamente un valore molto più piccolo, ad esempio `1e6` impostava un timeout a 1.127Le variabili numeriche come timeout, budget di token e numero di nuovi tentativi accettano la notazione scientifica e le grafie con separatore delle cifre oltre alle cifre semplici, tranne quando la riga di una variabile indica che accetta solo cifre semplici. Ad esempio, Claude Code legge `2e3` come 2000 e `64_000` come 64000. Prima della v2.1.211, queste grafie potevano impostare silenziosamente un valore molto più piccolo, ad esempio `1e6` impostava un timeout a 1.

128 128 

129<Note>129<Note>

130 Per le variabili che attivano o disattivano un comportamento, imposta `1`, `true`, `yes` o `on` per attivarlo e `0`, `false`, `no` o `off` per disattivarlo, con qualsiasi combinazione di maiuscole e minuscole.130 Per le variabili che attivano o disattivano un comportamento, imposta `1`, `true`, `yes` o `on` per attivarlo e `0`, `false`, `no` o `off` per disattivarlo, con qualsiasi combinazione di maiuscole e minuscole.

131 131 

132 Alcune variabili verificano solo se le hai impostate o meno, quindi qualsiasi valore non vuoto, incluso `0`, attiva il comportamento, e lo disattivi rimuovendo la variabile o impostandola su un valore vuoto. Queste variabili funzionano in questo modo:132 Alcune variabili verificano solo se le hai impostate o meno, quindi qualsiasi valore non vuoto, incluso `0`, attiva il comportamento, e per disattivarlo devi rimuovere la variabile o impostarla su un valore vuoto. Queste variabili funzionano in questo modo:

133 133 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`


138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140 

141 Un'altra variabile ha una propria regola: `FORCE_HYPERLINK` legge un numero, quindi solo `0` la disattiva. Anche la riga di ciascuna variabile indica la propria regola.141 Un'altra variabile ha una regola propria: `FORCE_HYPERLINK` legge un numero, quindi solo `0` la disattiva. Anche la riga di ciascuna variabile indica la propria regola.

142</Note>142</Note>

143 143 

144| Variabile | Scopo |144| Variabile | Scopo |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | Chiave API inviata come header `X-Api-Key`. Quando è impostata, questa chiave viene usata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se hai effettuato l'accesso. In modalità non interattiva (`-p`), la chiave viene sempre usata quando presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sostituisca il tuo abbonamento. Per usare invece il tuo abbonamento, esegui `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | Chiave API inviata come header `X-Api-Key`. Quando è impostata, questa chiave viene usata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se hai effettuato l'accesso. In modalità non interattiva (`-p`), la chiave viene sempre usata quando è presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sostituisca il tuo abbonamento. Per usare invece il tuo abbonamento, esegui `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'header `Authorization` (al valore che imposti qui verrà aggiunto il prefisso `Bearer `) |147| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'header `Authorization` (al valore che imposti qui verrà anteposto `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Chiave API del workspace per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), generata nella Console AWS. Inviata come `x-api-key` e ha la precedenza su AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | Chiave API del workspace per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), generata nella AWS Console. Inviata come `x-api-key` e ha la precedenza su AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Sovrascrive l'URL dell'endpoint di [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Usala per regioni personalizzate o quando instradi le richieste tramite un [LLM gateway](/docs/it/llm-gateway). Il valore predefinito è `https://aws-external-anthropic.{region}.api.aws`. Claude Code risolve la regione con la [stessa precedenza usata su Amazon Bedrock](/docs/it/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | Sovrascrive l'URL dell'endpoint di [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Usala per regioni personalizzate o quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway). Il valore predefinito è `https://aws-external-anthropic.{region}.api.aws`. Claude Code determina la regione con la [stessa precedenza usata su Amazon Bedrock](/docs/it/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatoria per [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Inviata in ogni richiesta come header `anthropic-workspace-id` |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatoria per [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Inviata in ogni richiesta come header `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Sovrascrive l'endpoint API per instradare le richieste tramite un proxy o un gateway. Quando è impostata su un host non di prima parte, [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitato per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il tuo proxy inoltra i blocchi `tool_reference`. A partire dalla v2.1.196, [Remote Control](/docs/it/remote-control#requirements) è disabilitato quando questa variabile punta a un host diverso da `api.anthropic.com`, in linea con il suo comportamento su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Sovrascrive l'endpoint API per instradare le richieste attraverso un proxy o un gateway. Quando è impostata su un host non di prima parte, [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitato per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il tuo proxy inoltra i blocchi `tool_reference`. A partire dalla v2.1.196, [Remote Control](/docs/it/remote-control#requirements) è disabilitato quando questa variabile punta a un host diverso da `api.anthropic.com`, in linea con il suo comportamento su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Sovrascrive l'URL dell'endpoint di Amazon Bedrock. Usala per endpoint Amazon Bedrock personalizzati o quando instradi le richieste tramite un [LLM gateway](/docs/it/llm-gateway). Consulta [Amazon Bedrock](/docs/it/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Sovrascrive l'URL dell'endpoint di Amazon Bedrock. Usala per endpoint Amazon Bedrock personalizzati o quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway). Consulta [Amazon Bedrock](/docs/it/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sovrascrive l'URL dell'endpoint Amazon Bedrock Mantle. Consulta [Endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sovrascrive l'URL dell'endpoint di Amazon Bedrock Mantle. Consulta [Endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefisso del profilo di inferenza tra regioni (`us`, `eu`, `apac`, `jp`, `au` o `global`) che Claude Code prova per primo al posto di quello derivato dalla regione AWS. Ignorata nelle regioni AWS GovCloud. Richiede Claude Code v2.1.224 o successiva. Consulta [Amazon Bedrock](/docs/it/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefisso del profilo di inferenza cross-region (`us`, `eu`, `apac`, `jp`, `au` o `global`) che Claude Code prova per primo al posto di quello derivato dalla regione AWS. Ignorata nelle regioni AWS GovCloud. Richiede Claude Code v2.1.224 o successiva. Consulta [Amazon Bedrock](/docs/it/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Livello di servizio](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) di Amazon Bedrock (`default`, `flex` o `priority`). Inviato come header `X-Amzn-Bedrock-Service-Tier`. Consulta [Amazon Bedrock](/docs/it/amazon-bedrock#service-tiers) |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Livello di servizio](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) di Amazon Bedrock (`default`, `flex` o `priority`). Inviato come header `X-Amzn-Bedrock-Service-Tier`. Consulta [Amazon Bedrock](/docs/it/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Elenco separato da virgole di valori aggiuntivi dell'header `anthropic-beta` da includere nelle richieste API. Claude Code invia già gli header beta di cui ha bisogno; usa questa variabile per aderire a una [beta dell'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) prima che Claude Code aggiunga il supporto nativo. A differenza del [flag `--betas`](/docs/it/cli-reference#cli-flags), che richiede l'autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione, incluso l'abbonamento Claude.ai |156| `ANTHROPIC_BETAS` | Elenco separato da virgole di valori aggiuntivi dell'header `anthropic-beta` da includere nelle richieste API. Claude Code invia già gli header beta di cui ha bisogno; usa questa variabile per aderire a una [beta dell'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) prima che Claude Code ne aggiunga il supporto nativo. A differenza del [flag `--betas`](/docs/it/cli-reference#cli-flags), che richiede l'autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione, incluso l'abbonamento Claude.ai |

157| `ANTHROPIC_CUSTOM_HEADERS` | Header personalizzati da aggiungere alle richieste (formato `Name: Value`, separati da un ritorno a capo per più header). Se un nome o un valore contiene un carattere che un header HTTP non può trasportare, come una virgoletta curva o uno spazio a larghezza zero, la richiesta non riesce con un errore che identifica la coppia in base alla posizione. Richiede Claude Code v2.1.227 o successiva. [Invalid request header value](/docs/it/errors#invalid-request-header-value) elenca il set esatto di caratteri e dove viene eseguito il controllo. Un valore che imposta un header di credenziali, di organizzazione o tenant, di instradamento o di comportamento dell'API, come `Authorization` o `Host`, conta come [impostazione che richiede approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog) quando viene fornito dalle impostazioni gestite dal server. Dalle impostazioni di progetto o locali, un valore di questo tipo segue le [regole su quando si applicano i valori `env`](/docs/it/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | Header personalizzati da aggiungere alle richieste (formato `Name: Value`, separati da un a capo per più header). Se un nome o un valore contiene un carattere che un header HTTP non può trasportare, come una virgoletta curva o uno spazio a larghezza zero, la richiesta fallisce con un errore che identifica la coppia in base alla posizione. Richiede Claude Code v2.1.227 o successiva. [Invalid request header value](/docs/it/errors#invalid-request-header-value) elenca l'esatto insieme di caratteri e dove viene eseguito il controllo. Un valore che imposta un header di credenziali, organizzazione o tenant, instradamento o comportamento dell'API, come `Authorization` o `Host`, conta come [impostazione che richiede approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog) quando viene fornito dalle impostazioni gestite dal server. Dalle impostazioni di progetto o locali, un tale valore segue le [regole su quando si applicano i valori `env`](/docs/it/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID del modello da aggiungere come voce personalizzata nel selettore `/model`. Usala per rendere selezionabile un modello non standard o specifico di un gateway senza sostituire gli alias integrati. Consulta [Configurazione del modello](/docs/it/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID del modello da aggiungere come voce personalizzata nel selettore `/model`. Usala per rendere selezionabile un modello non standard o specifico di un gateway senza sostituire gli alias integrati. Consulta [Configurazione del modello](/docs/it/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrizione visualizzata per la voce del modello personalizzato nel selettore `/model`. Il valore predefinito è `Custom model (<model-id>)` quando non è impostata |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrizione visualizzata per la voce del modello personalizzato nel selettore `/model`. Se non è impostata, il valore predefinito è `Custom model (<model-id>)` |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome visualizzato per la voce del modello personalizzato nel selettore `/model`. Quando non è impostata, la voce mostra il nome del modello se Claude Code [riconosce l'ID](/docs/it/model-config#customize-pinned-model-display-and-capabilities), altrimenti l'ID del modello |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome visualizzato per la voce del modello personalizzato nel selettore `/model`. Se non è impostata, la voce mostra il nome del modello se Claude Code [riconosce l'ID](/docs/it/model-config#customize-pinned-model-display-and-capabilities), altrimenti l'ID del modello |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello personalizzato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [capacità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello personalizzato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID del modello a cui si risolve l'alias `fable` e ID che Claude Code riconosce come modello Fable per il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui provider di terze parti. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID del modello a cui si risolve l'alias `fable`, e l'ID che Claude Code riconosce come modello Fable per il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui provider di terze parti. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Fable fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Fable fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome visualizzato per il modello Fable fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome visualizzato per il modello Fable fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Fable fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [capacità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Fable fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID del modello a cui si risolve l'alias `haiku`, usato anche per le [funzionalità in background](/docs/it/costs#background-token-usage). Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID del modello a cui si risolve l'alias `haiku`, usato anche per le [funzionalità in background](/docs/it/costs#background-token-usage). Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Haiku fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Haiku fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome visualizzato per il modello Haiku fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome visualizzato per il modello Haiku fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Haiku fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [capacità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Haiku fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | Modello con cui si avviano per impostazione predefinita le nuove sessioni. Richiede Claude Code v2.1.236 o successiva. Consulta [Impostare un modello predefinito per le nuove sessioni](/docs/it/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | Modello con cui le nuove sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva. Consulta [Impostare un modello predefinito per le nuove sessioni](/docs/it/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID del modello a cui si risolve l'alias `opus` e che `opusplan` usa mentre il Plan Mode è attivo. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID del modello a cui si risolve l'alias `opus`, e che `opusplan` usa mentre il Plan Mode è attivo. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Opus fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Opus fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome visualizzato per il modello Opus fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome visualizzato per il modello Opus fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Opus fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [capacità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Opus fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID del modello a cui si risolve l'alias `sonnet` e che `opusplan` usa quando il Plan Mode non è attivo. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID del modello a cui si risolve l'alias `sonnet`, e che `opusplan` usa quando il Plan Mode non è attivo. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Sonnet fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Sonnet fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome visualizzato per il modello Sonnet fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome visualizzato per il modello Sonnet fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Sonnet fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [capacità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Sonnet fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID della regola di federazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando la imposti insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno priorità rispetto alla credenziale di `/login`. Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID della regola di federazione per la [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando la imposti insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno priorità sulle credenziali di `/login`. Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Chiave API per l'autenticazione Microsoft Foundry (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Chiave API per l'autenticazione con Microsoft Foundry (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Token bearer per l'autenticazione Microsoft Foundry, come un token di accesso Microsoft Entra. Claude Code lo invia come header `Authorization: Bearer`. Ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita di Azure. Consulta [Microsoft Foundry](/docs/it/microsoft-foundry). Richiede Claude Code v2.1.203 o successiva |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer token per l'autenticazione con Microsoft Foundry, come un token di accesso Microsoft Entra. Claude Code lo invia come header `Authorization: Bearer`. Ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita di Azure. Consulta [Microsoft Foundry](/docs/it/microsoft-foundry). Richiede Claude Code v2.1.203 o successiva |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL di base completo della risorsa Microsoft Foundry (ad esempio, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL di base completo per la risorsa Microsoft Foundry (ad esempio, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Claude Code [rifiuta un URL o un nome host](/docs/it/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Obbligatoria se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostata (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Claude Code [rifiuta un URL o un nome host](/docs/it/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Obbligatoria se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostata (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Nome dell'impostazione del modello da usare (consulta [Configurazione del modello](/docs/it/model-config#environment-variables)) |184| `ANTHROPIC_MODEL` | Nome dell'impostazione del modello da usare (consulta [Configurazione del modello](/docs/it/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | ID dell'organizzazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | ID dell'organizzazione per la [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Nome del profilo Anthropic con cui autenticarsi, come uno creato da [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) o [accedendo a un account Console senza una chiave API](/docs/it/authentication#sign-in-without-an-api-key). Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | Nome del profilo Anthropic con cui autenticarti, come uno creato da [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) o [accedendo a un account Console senza chiave API](/docs/it/authentication#sign-in-without-an-api-key). Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATA] Nome del [modello di classe Haiku per le attività in background](/docs/it/costs) |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATA] Nome del [modello di classe Haiku per le attività in background](/docs/it/costs) |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sovrascrive la regione AWS per il modello di classe Haiku quando usi Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, ha effetto solo quando è impostata anche `ANTHROPIC_DEFAULT_HAIKU_MODEL` o la deprecata `ANTHROPIC_SMALL_FAST_MODEL`, poiché altrimenti Amazon Bedrock esegue le attività in background sul [modello Sonnet predefinito o sul modello principale](/docs/it/amazon-bedrock#4-pin-model-versions) nella regione della sessione |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sovrascrive la regione AWS per il modello di classe Haiku quando usi Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, ha effetto solo quando è impostata anche `ANTHROPIC_DEFAULT_HAIKU_MODEL` o la deprecata `ANTHROPIC_SMALL_FAST_MODEL`, poiché altrimenti Amazon Bedrock esegue le attività in background sul [modello Sonnet predefinito o sul modello principale](/docs/it/amazon-bedrock#4-pin-model-versions) nella regione della sessione |

189| `ANTHROPIC_VERTEX_BASE_URL` | Sovrascrive l'URL dell'endpoint di Google Cloud's Agent Platform. Usala per endpoint personalizzati di Google Cloud's Agent Platform o quando instradi le richieste tramite un [LLM gateway](/docs/it/llm-gateway). Consulta [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Sovrascrive l'URL dell'endpoint di Google Cloud's Agent Platform. Usala per endpoint Google Cloud's Agent Platform personalizzati o quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway). Consulta [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID del progetto GCP a cui sono indirizzate le richieste di Google Cloud's Agent Platform. Consulta [Configurare le credenziali GCP](/docs/it/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID del progetto GCP a cui sono indirizzate le richieste a Google Cloud's Agent Platform. Consulta [Configurare le credenziali GCP](/docs/it/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID del workspace per la [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala quando la tua regola di federazione è limitata a più di un workspace, così lo scambio di token sa quale workspace usare come destinazione |191| `ANTHROPIC_WORKSPACE_ID` | ID del workspace per la [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala quando la tua regola di federazione è limitata a più di un workspace, in modo che lo scambio di token sappia quale workspace usare |

192| `API_FORCE_IDLE_TIMEOUT` | Sovrascrive il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Imposta `0` per disattivare il timeout, ad esempio quando un [gateway](/docs/it/llm-gateway) lento o un modello locale fa pause più lunghe di 5 minuti tra un chunk e l'altro, oppure `1` per mantenerlo attivo per ogni provider. Quando non è impostata, il timeout è attivo sui provider diversi dall'API Anthropic diretta, da [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e da Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostata. I [watchdog dello streaming](/docs/it/network-config#streaming-idle-watchdogs) funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando imposti `0` qui |192| `API_FORCE_IDLE_TIMEOUT` | Sovrascrive il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Imposta `0` per disattivare il timeout, ad esempio quando un [gateway](/docs/it/llm-gateway) lento o un modello locale si ferma per più di 5 minuti tra un blocco e l'altro, oppure `1` per mantenerlo attivo per ogni provider. Se non è impostata, il timeout è attivo sui provider diversi dall'API Anthropic diretta, da [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e da Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostata. I [watchdog dello streaming](/docs/it/network-config#streaming-idle-watchdogs) funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando imposti `0` qui |

193| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, ovvero 10 minuti; massimo: 2147483647). Aumentalo quando le richieste vanno in timeout su reti lente o quando instradi le richieste tramite un proxy. I valori superiori al massimo causano l'overflow del timer sottostante e fanno fallire immediatamente le richieste |193| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, ovvero 10 minuti; massimo: 2147483647). Aumentalo quando le richieste vanno in timeout su reti lente o quando instradi il traffico attraverso un proxy. I valori superiori al massimo causano l'overflow del timer sottostante e fanno fallire immediatamente le richieste |

194| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API di Amazon Bedrock per l'autenticazione (consulta [Chiavi API di Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |194| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API di Amazon Bedrock per l'autenticazione (consulta [Chiavi API di Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 120000, ovvero 2 minuti). Un valore predefinito superiore a 30 minuti diventa anche il [limite di tempo predefinito per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 120000, ovvero 2 minuti). Un valore predefinito superiore a 30 minuti diventa anche il [limite di tempo predefinito per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |

196| `BASH_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri dell'output bash che Claude Code rilegge nel risultato di un comando (predefinito: 30000; massimo: 150000). Se imposti l'impostazione [`bashOutputMaxChars`](/docs/it/settings-reference#bashoutputmaxchars), Claude Code ignora questa variabile. Consulta [Limiti di output](/docs/it/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri dell'output di bash che Claude Code rilegge nel risultato di un comando (predefinito: 30000; massimo: 150000). Se imposti l'impostazione [`bashOutputMaxChars`](/docs/it/settings-reference#bashoutputmaxchars), Claude Code ignora questa variabile. Consulta [Limiti dell'output](/docs/it/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 600000, ovvero 10 minuti). Il limite effettivo è il maggiore tra questo valore e `BASH_DEFAULT_TIMEOUT_MS`. Un limite effettivo superiore a 2 ore diventa anche il [limite di tempo massimo per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |197| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 600000, ovvero 10 minuti). Il limite effettivo è il maggiore tra questo valore e `BASH_DEFAULT_TIMEOUT_MS`. Un limite effettivo superiore a 2 ore diventa anche il [limite di tempo massimo per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP per il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, log e tracce vengono inviati lì anziché agli exporter configurati. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP per il [tracciamento beta dettagliato](/docs/it/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, log e tracce vengono inviati lì invece che agli exporter configurati. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Imposta su `1` per forzare [`claude --cloud`](/docs/it/claude-code-on-the-web#send-local-repositories-without-github) a creare un bundle del tuo repository locale e caricarlo anziché clonarlo dal suo remote |199| `CCR_FORCE_BUNDLE` | Imposta `1` per forzare [`claude --cloud`](/docs/it/claude-code-on-the-web#send-local-repositories-without-github) a impacchettare e caricare il tuo repository locale invece di clonarlo dal suo remote |

200| `CLAUDECODE` | Impostata su `1` nei sottoprocessi avviati da Claude Code (strumenti Bash e PowerShell, sessioni tmux, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline), sottoprocessi dei [server MCP](/docs/it/mcp) stdio). Anche le estensioni IDE la impostano nei loro terminali integrati. Usala per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso avviato da Claude Code. Per verificare se il processo corrente è stato avviato direttamente da una chiamata a uno strumento o da un hook, anziché all'interno di un server MCP stdio avviato da Claude Code, usa invece `CLAUDE_CODE_CHILD_SESSION` |200| `CLAUDECODE` | Impostata su `1` nei sottoprocessi avviati da Claude Code (strumenti Bash e PowerShell, sessioni tmux, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline), sottoprocessi dei [server MCP](/docs/it/mcp) stdio). Anche le estensioni IDE la impostano nei loro terminali integrati. Usala per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso avviato da Claude Code. Per verificare se il processo corrente è stato avviato direttamente da una chiamata a uno strumento o da un hook, anziché all'interno di un server MCP stdio avviato da Claude Code, usa invece `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Quanti millisecondi prima della continuazione automatica compare il conto alla rovescia sullo schermo in una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di continuazione automatica. Non ha effetto a meno che la continuazione automatica non sia attiva; consulta l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successiva |201| `CLAUDE_AFK_COUNTDOWN_MS` | Quanti millisecondi prima della continuazione automatica compare il conto alla rovescia sullo schermo in una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di continuazione automatica. Non ha effetto a meno che la continuazione automatica non sia attiva; consulta l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successiva |

202| `CLAUDE_AFK_TIMEOUT_MS` | Quanti millisecondi di inattività prima che una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta continui automaticamente senza di te. La continuazione automatica è disattivata per impostazione predefinita; attivala con l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout). Questa variabile è un override per demo e test automatizzati: quando è impostata, ha la precedenza su quell'impostazione e attiva la continuazione automatica anche quando l'impostazione non è impostata o è `never`. Impostare `0` non disattiva il timeout; chiude immediatamente la finestra di dialogo. Nelle v2.1.198 e v2.1.199, la continuazione automatica era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successiva |202| `CLAUDE_AFK_TIMEOUT_MS` | Quanti millisecondi di inattività prima che una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta prosegua automaticamente senza di te. La continuazione automatica è disattivata per impostazione predefinita; attivala con l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout). Questa variabile è un override per demo e test automatizzati: quando è impostata, ha la precedenza su quell'impostazione e attiva la continuazione automatica anche quando l'impostazione non è impostata o vale `never`. Impostare `0` non disattiva il timeout; chiude immediatamente la finestra di dialogo. Nelle versioni v2.1.198 e v2.1.199, la continuazione automatica era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successiva |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Imposta su `1` per disabilitare tutti i tipi di [subagent](/docs/it/sub-agents) integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti dell'SDK che vogliono partire da zero. Questo rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata allo strumento Agent omette `subagent_type`. Una chiamata di questo tipo non riesce quindi con [`subagent_type is required`](/docs/it/errors#subagent-type-is-required) |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Imposta `1` per disabilitare tutti i tipi di [subagent](/docs/it/sub-agents) integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti dell'SDK che vogliono partire da zero. Rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata allo strumento Agent omette `subagent_type`. Una chiamata di questo tipo fallisce quindi con [`subagent_type is required`](/docs/it/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Imposta su `1` per omettere il prefisso `mcp__<server>__` dai nomi degli strumenti dei server MCP creati dall'SDK. Gli strumenti usano i loro nomi originali. Solo per l'uso dell'SDK |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Imposta `1` per omettere il prefisso `mcp__<server>__` dai nomi degli strumenti dei server MCP creati tramite SDK. Gli strumenti usano i loro nomi originali. Solo per l'uso con l'SDK |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumenti `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog dello stream è attivo, il valore predefinito aumenta di conseguenza, come descritto in [Gestire le risposte API lente o bloccate](/docs/it/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Il timer si azzera a ogni evento di avanzamento dello streaming; se non arriva alcun avanzamento entro la finestra, Claude Code interrompe il subagent e segnala lo stallo al genitore |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumenti `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog dello stream è attivo, il valore predefinito aumenta di conseguenza, come descritto in [Gestire risposte API lente o bloccate](/docs/it/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Il timer si azzera a ogni evento di avanzamento dello streaming; se non arriva alcun avanzamento entro la finestra, Claude Code interrompe il subagent e segnala lo stallo al genitore |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale (1-100) della finestra di compattazione automatica alla quale si attiva la compattazione automatica. Usa valori più bassi come `50` per compattare prima; la variabile non può alzare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo nelle sessioni che [compattano prima del limite di contesto del modello](/docs/it/model-config#context-window-and-auto-compaction). Si applica sia alle conversazioni principali sia ai subagent |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale (1-100) della finestra di compattazione automatica alla quale si attiva la compattazione automatica. Usa valori più bassi come `50` per compattare prima; la variabile non può alzare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo nelle sessioni che [compattano prima del limite di contesto del modello](/docs/it/model-config#context-window-and-auto-compaction). Si applica sia alle conversazioni principali sia ai subagent |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Imposta su `1` per forzare l'attivazione dello spostamento automatico in background delle attività degli agenti a lunga esecuzione. Quando è attivo, i subagent vengono spostati in background dopo circa due minuti di esecuzione. Attiva anche lo [spostamento automatico in background delle chiamate lunghe agli strumenti MCP](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) in modalità non interattiva su Claude Code v2.1.212 o successiva |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Imposta `1` per forzare l'attivazione dello spostamento automatico in background delle attività degli agenti di lunga durata. Quando è attiva, i subagent vengono spostati in background dopo circa due minuti di esecuzione. Attiva anche lo [spostamento automatico in background delle chiamate lunghe agli strumenti MCP](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) in modalità non interattiva su Claude Code v2.1.212 o successiva |

208| `CLAUDE_AX_PREPARK_MS` | In [modalità screen reader](/docs/it/accessibility), quanti millisecondi Claude Code attende prima di scrivere una riga nuova o modificata. Predefinito `0`, quindi Claude Code non attende. Prima della v2.1.287, il valore predefinito era `50`. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successiva |208| `CLAUDE_AX_PREPARK_MS` | In [modalità screen reader](/docs/it/accessibility), quanti millisecondi Claude Code attende prima di scrivere una riga nuova o modificata. Predefinito `0`, quindi Claude Code non attende. Prima della v2.1.287, il valore predefinito era `50`. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successiva |

209| `CLAUDE_AX_SCREEN_READER` | Imposta su `1` per generare un output adatto agli screen reader: testo semplice senza bordi decorativi né animazioni. Imposta su `0` per forzare la disattivazione della modalità screen reader anche quando [`axScreenReader`](/docs/it/settings-reference#axscreenreader) è `true`. Il flag [`--ax-screen-reader`](/docs/it/cli-reference#cli-flags) ha la precedenza. Richiede Claude Code v2.1.181 o successiva |209| `CLAUDE_AX_SCREEN_READER` | Imposta `1` per generare un output adatto agli screen reader: testo semplice senza bordi decorativi né animazioni. Imposta `0` per forzare la disattivazione della modalità screen reader anche quando [`axScreenReader`](/docs/it/settings-reference#axscreenreader) è `true`. Il flag [`--ax-screen-reader`](/docs/it/cli-reference#cli-flags) ha la precedenza. Richiede Claude Code v2.1.181 o successiva |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | In [modalità screen reader](/docs/it/accessibility), per quanti millisecondi Claude Code trattiene il primo rendering dell'interfaccia dopo la riga di conferma dell'avvio, così il tuo screen reader può leggere la riga per intero prima che nuovo output la interrompa. Predefinito `3000`. Imposta `0` per eseguire il rendering immediatamente. Claude Code limita l'attesa a `600000` (10 minuti). La tua prima pressione di un tasto termina l'attesa in anticipo. Richiede Claude Code v2.1.217 o successiva |210| `CLAUDE_AX_STARTUP_QUIET_MS` | In [modalità screen reader](/docs/it/accessibility), per quanti millisecondi Claude Code trattiene il primo rendering dell'interfaccia dopo la riga di conferma dell'avvio, in modo che il tuo screen reader possa leggere la riga per intero prima che un nuovo output la interrompa. Predefinito `3000`. Imposta `0` per eseguire il rendering immediatamente. Claude Code limita l'attesa a `600000` (10 minuti). La tua prima pressione di un tasto termina anticipatamente l'attesa. Richiede Claude Code v2.1.217 o successiva |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Torna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Torna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi per il watchdog di inattività dello streaming a livello di byte; quando è impostata, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia invariato il watchdog a livello di evento. Claude Code limita questa variabile a un valore compreso tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successiva |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi per il watchdog di inattività dello streaming a livello di byte; quando è impostata, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia invariato il watchdog a livello di evento. Claude Code limita questa variabile a un valore tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successiva |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Percorso di un file che uno strumento esterno, come un listener del blocco schermo, crea quando sblocchi lo schermo ed elimina quando lo blocchi. Finché il file esiste, Claude Code salta le [notifiche push mobili di Remote Control](/docs/it/remote-control#mobile-push-notifications), così smetti di ricevere notifiche push mentre usi attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per ogni evento che attiva una notifica push anziché interrogarlo periodicamente. Richiede Claude Code v2.1.181 o successiva |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Percorso di un file che uno strumento esterno, come un listener del blocco schermo, crea quando sblocchi lo schermo ed elimina quando lo blocchi. Finché il file esiste, Claude Code salta le [notifiche push mobili di Remote Control](/docs/it/remote-control#mobile-push-notifications), così smetti di ricevere notifiche push mentre stai usando attivamente il computer. Quando il file è assente o non leggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per ogni evento che attiva una notifica push, anziché interrogarlo periodicamente. Richiede Claude Code v2.1.181 o successiva |

214| `CLAUDE_CODE_ACCESSIBILITY` | Imposta su `1` per mantenere visibile il cursore nativo del terminale e disabilitare l'indicatore del cursore a testo invertito. Consente agli ingranditori dello schermo come Zoom di macOS di seguire la posizione del cursore |214| `CLAUDE_CODE_ACCESSIBILITY` | Imposta `1` per mantenere visibile il cursore nativo del terminale e disabilitare l'indicatore del cursore a testo invertito. Consente ai programmi di ingrandimento dello schermo come Zoom di macOS di seguire la posizione del cursore |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Imposta su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Imposta `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Imposta su `1` per ridisegnare l'intero schermo a ogni frame nel [rendering a schermo intero](/docs/it/fullscreen) anziché inviare aggiornamenti incrementali. Usala se la modalità a schermo intero mostra frammenti di testo obsoleti o fuori posto. Claude Code la attiva automaticamente per le sessioni in background e per la [vista agenti](/docs/it/agent-view) su Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Imposta `1` per ridisegnare l'intero schermo a ogni frame nel [rendering a schermo intero](/docs/it/fullscreen) invece di inviare aggiornamenti incrementali. Usala se la modalità a schermo intero mostra frammenti di testo obsoleti o fuori posto. Claude Code la attiva automaticamente per le sessioni in background e per la [vista agenti](/docs/it/agent-view) su Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Imposta su `1` per inviare il parametro [effort](/docs/it/model-config#adjust-effort-level) con ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come compatibile con effort. Usala quando instradi le richieste tramite un [LLM gateway](/docs/it/llm-gateway) o un provider di terze parti che serve i modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort a livello di API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, restano comunque esclusi, così le richieste non falliscono |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Imposta `1` per inviare il parametro [effort](/docs/it/model-config#adjust-effort-level) in ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come compatibile con effort. Usala quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway) o un provider di terze parti che serve i modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort a livello di API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, restano esclusi, così le richieste non falliscono |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervallo in millisecondi con cui le credenziali devono essere aggiornate (quando usi [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper)) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervallo in millisecondi con cui le credenziali devono essere aggiornate (quando usi [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Imposta su `0` per impedire a Claude Code di aprire automaticamente il browser quando viene pubblicato un nuovo [artefatto](/docs/it/artifacts#create-an-artifact) |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Imposta `0` per impedire a Claude Code di aprire automaticamente il browser quando viene pubblicato un nuovo [artefatto](/docs/it/artifacts#create-an-artifact) |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Imposta su `0` per impedire a Claude di leggere e rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact). Non ha effetto quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha [disattivato gli artefatti](/docs/it/artifacts#availability). Richiede Claude Code v2.1.221 o successiva |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Imposta `0` per impedire a Claude di leggere e rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact). Non ha effetto quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha [disattivato gli artefatti](/docs/it/artifacts#availability). Richiede Claude Code v2.1.221 o successiva |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Imposta su `0` per impedire a Claude di [rispondere autonomamente ai commenti che gli vengono inviati](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Richiede Claude Code v2.1.228 o successiva |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Imposta `0` per impedire a Claude di [rispondere autonomamente ai commenti che gli vengono inviati](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Richiede Claude Code v2.1.228 o successiva |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Imposta su `0` per omettere il [blocco di attribuzione](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), che contiene la versione del client e un'impronta del prompt, dall'inizio del prompt di sistema. La cache su una connessione diretta all'API Anthropic non è influenzata in nessun caso. In alcune configurazioni a connessione diretta, Claude Code mantiene il blocco nelle richieste al classificatore della [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) anche quando imposti `0`. In [Blocco di attribuzione del prompt di sistema](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), verifica quali connessioni e credenziali sono interessate. Prima della v2.1.181 il blocco includeva un token per richiesta sugli URL di base personalizzati e sulle connessioni Microsoft Foundry, quindi in quelle versioni impostala su `0` quando il tuo LLM gateway memorizza nella cache in base al corpo della richiesta o inoltra le richieste a un provider di terze parti, oppure quando ti connetti direttamente a Microsoft Foundry |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Imposta `0` per omettere il [blocco di attribuzione](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), che contiene la versione del client e un'impronta del prompt, dall'inizio del prompt di sistema. La cache su una connessione diretta all'API Anthropic non viene influenzata in nessun caso. In alcune configurazioni con connessione diretta, Claude Code mantiene il blocco nelle richieste al classificatore della [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) anche quando imposti `0`. In [Blocco di attribuzione del prompt di sistema](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), verifica quali connessioni e credenziali sono interessate. Prima della v2.1.181 il blocco includeva un token per richiesta sugli URL di base personalizzati e sulle connessioni Microsoft Foundry, quindi in quelle versioni impostala su `0` quando il tuo gateway LLM memorizza nella cache in base al corpo della richiesta o inoltra le richieste a un provider di terze parti, oppure quando ti connetti direttamente a Microsoft Foundry |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è attiva, secondi tra i promemoria a Claude per controllare i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ancora in esecuzione. Accetta solo un intero semplice da `1` a `86400`; qualsiasi altro valore o grafia viene letto come non impostato. Quando non è impostata, non ci sono promemoria di controllo. Richiede Claude Code v2.1.248 o successiva |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Rimossa nella v2.1.283. Usa invece `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Imposta la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) in token, da `100000` a `1000000`. Accetta solo un intero semplice come `500000`: un valore come `500k` viene letto come `500` e portato al minimo di 100K. La finestra effettiva è inoltre limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, sul flag `--autocompact` e sull'impostazione `autoCompactWindow`. Il valore `used_percentage` della riga di stato viene sempre misurato rispetto all'intera finestra di contesto del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Imposta la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) in token, da `100000` a `1000000`. Accetta solo un intero semplice come `500000`: un valore come `500k` viene letto come `500` e portato al minimo di 100K. La finestra effettiva è inoltre limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, sul flag `--autocompact` e sull'impostazione `autoCompactWindow`. Il valore `used_percentage` della riga di stato si misura sempre rispetto all'intera finestra di contesto del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sovrascrive la [connessione IDE](/docs/it/vs-code) automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando viene avviato all'interno del terminale integrato di un IDE supportato. Imposta su `false` per impedirlo. Imposta su `true` per forzare un tentativo di connessione quando il rilevamento automatico non riesce, ad esempio quando tmux nasconde il terminale padre. Ha la precedenza sull'impostazione di configurazione globale [`autoConnectIde`](/docs/it/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sovrascrive la [connessione automatica all'IDE](/docs/it/vs-code). Per impostazione predefinita, Claude Code si connette automaticamente quando viene avviato nel terminale integrato di un IDE supportato. Imposta `false` per impedirlo. Imposta `true` per forzare un tentativo di connessione quando il rilevamento automatico fallisce, ad esempio quando tmux nasconde il terminale padre. Ha la precedenza sull'impostazione di configurazione globale [`autoConnectIde`](/docs/it/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controlla se Claude Code chiede al server di [esaminare le azioni della modalità auto](/docs/it/permission-modes#server-side-classifier-review). Imposta su `0` per usare invece le richieste al classificatore di Claude Code stesso. Su una connessione diretta all'API Anthropic, richiede la v2.1.281 o successiva. La sezione collegata elenca quali sessioni interpellano il server quando la variabile non è impostata, e da quale versione. Richiede Claude Code v2.1.271 o successiva |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controlla se Claude Code chiede al server di [esaminare le azioni della modalità auto](/docs/it/permission-modes#server-side-classifier-review). Imposta `0` per usare invece le richieste al classificatore di Claude Code. Su una connessione diretta all'API Anthropic, richiede la v2.1.281 o successiva. La sezione collegata elenca quali sessioni interpellano il server quando la variabile non è impostata, e da quale versione. Richiede Claude Code v2.1.271 o successiva |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo in millisecondi che Claude Code attende affinché la catena predefinita di provider di credenziali AWS produca le credenziali prima che la richiesta non riesca con [`AWS default-chain credential resolve timed out`](/docs/it/errors#aws-default-chain-credential-resolve-timed-out) (predefinito: `60000`). Aumentalo quando un passaggio della tua catena richiede legittimamente più tempo, come un accesso SSO basato su browser con MFA tramite un wrapper come `aws-vault`. Si applica ovunque Claude Code firmi con la catena predefinita: [Amazon Bedrock](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint). Richiede Claude Code v2.1.207 o successiva |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo in millisecondi che Claude Code attende affinché la catena predefinita di provider di credenziali AWS produca le credenziali prima che la richiesta fallisca con [`AWS default-chain credential resolve timed out`](/docs/it/errors#aws-default-chain-credential-resolve-timed-out) (predefinito: `60000`). Aumentalo quando un passaggio della tua catena richiede legittimamente più tempo, come un accesso SSO basato su browser con MFA tramite un wrapper come `aws-vault`. Si applica ovunque Claude Code firmi con la catena predefinita: [Amazon Bedrock](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint). Richiede Claude Code v2.1.207 o successiva |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Imposta su `0` per disattivare il [diff dei file modificati durante l'esecuzione di un comando Bash](/docs/it/hooks#bash), oppure `1` per registrarlo in ogni modalità di permesso. Ha la precedenza sull'impostazione [`bashEditDiffEnabled`](/docs/it/settings-reference#basheditdiffenabled). Richiede Claude Code v2.1.269 o successiva |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Imposta `0` per disattivare il [diff dei file modificati durante l'esecuzione di un comando Bash](/docs/it/hooks#bash), oppure `1` per registrarlo in ogni modalità di permesso. Ha la precedenza sull'impostazione [`bashEditDiffEnabled`](/docs/it/settings-reference#basheditdiffenabled). Richiede Claude Code v2.1.269 o successiva |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Imposta su `0` per fare in modo che una sessione non interattiva segnali al suo host uno stato inattivo alla fine di ogni turno, anche mentre il lavoro in background è ancora in esecuzione. Per impostazione predefinita, la sessione continua a segnalare uno stato di esecuzione oltre la fine del turno mentre il lavoro in background, come un agente in background o un'esecuzione di un [workflow](/docs/it/workflows), è ancora attivo. In questo modo un host che osserva lo stato, come un elenco di sessioni remote, non annuncia che Claude è in attesa del tuo input a metà lavoro. I comandi shell in background, come un server di sviluppo, non mantengono lo stato di esecuzione. Il valore predefinito dello stato di esecuzione e la disattivazione con `0` richiedono Claude Code v2.1.269 o successiva; nelle versioni precedenti, imposta `1` per mantenere lo stato di esecuzione |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Imposta `0` per fare in modo che una sessione non interattiva segnali al suo host uno stato inattivo alla fine di ogni turno, anche mentre è ancora in esecuzione del lavoro in background. Per impostazione predefinita, la sessione continua a segnalare uno stato di esecuzione oltre la fine del turno finché il lavoro in background, come un agente in background o un'esecuzione di un [workflow](/docs/it/workflows), è ancora attivo. Questo evita che un host che monitora lo stato, come un elenco di sessioni remote, annunci che Claude è in attesa del tuo input nel mezzo del lavoro. I comandi di shell in background, come un server di sviluppo, non mantengono lo stato di esecuzione. Lo stato di esecuzione predefinito e la disattivazione con `0` richiedono Claude Code v2.1.269 o successiva; nelle versioni precedenti, imposta `1` per mantenere lo stato di esecuzione |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Impostata automaticamente nei sottoprocessi dello strumento Bash e dei [comandi hook](/docs/it/hooks) mentre la sessione ha una connessione [Remote Control](/docs/it/remote-control) attiva, e rimossa quando la connessione termina. Il valore è l'ID della sessione nel formato `session_`, lo stesso identificatore che compare nell'URL `claude.ai/code` della sessione, così uno script può rimandare alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successiva. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), leggi invece `CLAUDE_CODE_REMOTE_SESSION_ID` |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Impostata automaticamente nei sottoprocessi dello strumento Bash e dei [comandi degli hook](/docs/it/hooks) mentre la sessione ha una connessione [Remote Control](/docs/it/remote-control) attiva, e rimossa al termine della connessione. Il valore è l'ID della sessione nella forma `session_`, lo stesso identificatore che compare nell'URL `claude.ai/code` della sessione, così uno script può rimandare alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successiva. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), leggi invece `CLAUDE_CODE_REMOTE_SESSION_ID` |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Imposta su `0` per fare in modo che Claude Code legga il byte `0x08`, scritto anche `^H`, come un semplice Backspace, oppure `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono il comportamento predefinito della piattaforma. Per impostazione predefinita, Claude Code lo legge come Ctrl+Backspace su Windows, tranne quando `TERM_PROGRAM` è `mintty` o `TERM` è `cygwin`, e come semplice Backspace su macOS e Linux. Imposta `0` in un terminale Windows in cui [Backspace elimina un'intera parola](/docs/it/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Imposta `0` per fare in modo che Claude Code legga il byte `0x08`, scritto anche `^H`, come semplice Backspace, oppure `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono l'impostazione predefinita della piattaforma. Per impostazione predefinita, Claude Code lo legge come Ctrl+Backspace su Windows, tranne quando `TERM_PROGRAM` è `mintty` o `TERM` è `cygwin`, e come semplice Backspace su macOS e Linux. Imposta `0` in un terminale Windows in cui [Backspace elimina un'intera parola](/docs/it/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole delle origini dei certificati CA per le connessioni TLS. `bundled` è il set di CA Mozilla incluso in Claude Code. `system` è l'archivio attendibile del sistema operativo, letto solo sui runtime con `tls.getCACertificates`: il binario nativo, oppure Node 22.15 o successivo per le installazioni npm. Consulta [Archivio dei certificati CA](/docs/it/network-config#ca-certificate-store). Il valore predefinito è `bundled,system` |232| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole delle fonti dei certificati CA per le connessioni TLS. `bundled` è il set di CA Mozilla fornito con Claude Code. `system` è l'archivio attendibile del sistema operativo, letto solo sui runtime con `tls.getCACertificates`: il binario nativo, oppure Node 22.15 o successivo per le installazioni tramite npm. Consulta [Archivio dei certificati CA](/docs/it/network-config#ca-certificate-store). Il valore predefinito è `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Impostata su `1` nei sottoprocessi che Claude Code avvia tramite gli strumenti Bash, PowerShell e Monitor, i comandi degli [hook](/docs/it/hooks) e i comandi della [riga di stato](/docs/it/statusline). Non è impostata per i sottoprocessi dei [server MCP](/docs/it/mcp) stdio, che sono di lunga durata e sopravvivono alla sessione che li ha avviati. A differenza di `CLAUDECODE`, viene impostata solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione annidata da un `claude` di primo livello avviato in un terminale integrato in un IDE. Una TUI `claude` interattiva annidata avviata in questo modo viene esclusa automaticamente da `--resume`, `--continue`, dalla cronologia con la freccia su e dall'elenco `claude agents`. Le sessioni non interattive `claude -p` vengono comunque salvate. Imposta `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per sovrascrivere questa esclusione. Richiede Claude Code v2.1.172 o successiva |233| `CLAUDE_CODE_CHILD_SESSION` | Impostata su `1` nei sottoprocessi che Claude Code avvia tramite gli strumenti Bash, PowerShell e Monitor, i comandi degli [hook](/docs/it/hooks) e i comandi della [riga di stato](/docs/it/statusline). Non viene impostata per i sottoprocessi dei [server MCP](/docs/it/mcp) stdio, che hanno una lunga durata e sopravvivono alla sessione che li ha avviati. A differenza di `CLAUDECODE`, viene impostata solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione annidata da un `claude` di primo livello avviato in un terminale integrato nell'IDE. Una TUI `claude` interattiva annidata avviata in questo modo viene automaticamente esclusa da `--resume`, `--continue`, dalla cronologia con freccia su e dall'elenco `claude agents`. Le sessioni non interattive `claude -p` vengono comunque salvate. Imposta `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per ignorare questa esclusione. Richiede Claude Code v2.1.172 o successiva |

234| `CLAUDE_CODE_CLIENT_CERT` | Percorso del file del certificato client per l'autenticazione mTLS |234| `CLAUDE_CODE_CLIENT_CERT` | Percorso del file del certificato client per l'autenticazione mTLS |

235| `CLAUDE_CODE_CLIENT_KEY` | Percorso del file della chiave privata del client per l'autenticazione mTLS |235| `CLAUDE_CODE_CLIENT_KEY` | Percorso del file della chiave privata del client per l'autenticazione mTLS |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase per la CLAUDE\_CODE\_CLIENT\_KEY crittografata (facoltativa) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase per la CLAUDE\_CODE\_CLIENT\_KEY crittografata (facoltativa) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Rimossa nella v2.1.186 e ora non ha alcun effetto. In precedenza impostava un timeout separato per la fase di connessione, TLS e header di risposta di una richiesta API in streaming. Usa `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase degli header di risposta di una richiesta in streaming, consulta `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Rimossa nella v2.1.186 e ora senza effetto. In precedenza impostava un timeout separato per la fase di connessione, TLS e header della risposta di una richiesta API in streaming. Usa `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase degli header della risposta di una richiesta in streaming, consulta `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sovrascrive il percorso del file di log di debug. Nonostante il nome, si tratta di un percorso di file, non di una directory. Richiede che la modalità debug sia abilitata separatamente tramite `--debug`, `/debug` o la variabile d'ambiente `DEBUG`: impostare solo questa variabile non abilita il logging. Il flag [`--debug-file`](/docs/it/cli-reference#cli-flags) fa entrambe le cose insieme. Il valore predefinito è `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sovrascrive il percorso del file di log di debug. Nonostante il nome, si tratta di un percorso di file, non di una directory. Richiede che la modalità di debug sia attivata separatamente tramite `--debug`, `/debug` o la variabile d'ambiente `DEBUG`: impostare solo questa variabile non attiva i log. Il flag [`--debug-file`](/docs/it/cli-reference#cli-flags) fa entrambe le cose contemporaneamente. Il valore predefinito è `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello minimo di log scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della riga di stato, oppure alza a `error` per ridurre il rumore |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello minimo di log scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta `verbose` per includere diagnostica ad alto volume come l'output completo del comando della riga di stato, oppure alza a `error` per ridurre il rumore |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Imposta su `1` per disabilitare il supporto della [finestra di contesto da 1M](/docs/it/model-config#extended-context). Quando è impostata, le varianti dei modelli da 1M non sono disponibili nel selettore dei modelli e Claude Code limita a una finestra da 200K le sessioni sui modelli con una finestra nativa da 1M, come [Sonnet 5.5](/docs/it/model-config#sonnet-5-5-and-sonnet-5-context-window) e i modelli Fable; consulta [Contesto esteso](/docs/it/model-config#extended-context) per sapere come viene applicato il limite. Utile per gli ambienti enterprise con requisiti di conformità. Per il suo ruolo nella correzione della finestra per un ID modello `[1m]` non riconosciuto, consulta [Correggere la finestra per un gateway o un ID modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Imposta `1` per disabilitare il supporto della [finestra di contesto da 1M](/docs/it/model-config#extended-context). Quando è impostata, le varianti del modello da 1M non sono disponibili nel selettore dei modelli e Claude Code limita a una finestra da 200K le sessioni sui modelli con una finestra nativa da 1M, come [Sonnet 5.5](/docs/it/model-config#sonnet-5-5-and-sonnet-5-context-window) e i modelli Fable; consulta [Contesto esteso](/docs/it/model-config#extended-context) per sapere come viene applicato il limite. Utile per ambienti aziendali con requisiti di conformità. Per il suo ruolo nella correzione della finestra per un ID di modello `[1m]` non riconosciuto, consulta [Correggere la finestra per un gateway o un ID di modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Imposta su `1` per disabilitare il [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) su Opus 4.6 e Sonnet 4.6 e ripiegare sul budget di ragionamento fisso controllato da `MAX_THINKING_TOKENS`. Non ha effetto sui [modelli Fable](/docs/it/model-config#extended-thinking), su Sonnet 5 e successivi o su Opus 4.7 e successivi, che usano sempre il ragionamento adattivo |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Imposta `1` per disabilitare il [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) su Opus 4.6 e Sonnet 4.6 e ripiegare sul budget di ragionamento fisso controllato da `MAX_THINKING_TOKENS`. Non ha effetto sui [modelli Fable](/docs/it/model-config#extended-thinking), su Sonnet 5 e successivi o su Opus 4.7 e successivi, che usano sempre il ragionamento adattivo |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Imposta su `1` per impedire a Claude Code di unire chiave per chiave i blocchi `env` delle [impostazioni gestite](/docs/it/managed-settings#precedence-within-the-managed-tier) tra le origini di amministrazione, così si applica solo l'intero blocco `env` dell'origine con priorità più alta, come prima della v2.1.223. 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.223 o successiva |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Imposta `1` per impedire a Claude Code di unire per chiave i blocchi `env` delle [impostazioni gestite](/docs/it/managed-settings#precedence-within-the-managed-tier) provenienti da più fonti di amministrazione, in modo che si applichi solo l'intero blocco `env` della fonte con la priorità più alta, come prima della v2.1.223. 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.223 o successiva |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Imposta su `1` per disabilitare lo [strumento advisor](/docs/it/advisor). Il comando `/advisor` diventa non disponibile, qualsiasi `advisorModel` configurato viene ignorato e il flag `--advisor` viene accettato ma non ha effetto, così gli script esistenti che lo passano continuano a funzionare senza errori |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Imposta `1` per disabilitare lo [strumento advisor](/docs/it/advisor). Il comando `/advisor` diventa non disponibile, qualsiasi `advisorModel` configurato viene ignorato e il flag `--advisor` viene accettato ma non ha effetto, così gli script esistenti che lo passano continuano a funzionare senza errori |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Imposta su `1` per disattivare gli [agenti in background e la vista agenti](/docs/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all'impostazione [`disableAgentView`](/docs/it/settings-reference#disableagentview) |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Imposta `1` per disattivare gli [agenti in background e la vista agenti](/docs/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all'impostazione [`disableAgentView`](/docs/it/settings-reference#disableagentview) |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/docs/it/fullscreen) e usare il renderer classico della schermata principale. La conversazione rimane nello scrollback nativo del tuo terminale, così `Cmd+f` e la modalità copia di tmux funzionano come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/docs/it/settings-reference#tui). Puoi anche cambiare con `/tui default`. Non si applica alle sessioni in background aperte dalla [vista agenti](/docs/it/agent-view), che usano sempre il rendering a schermo intero |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta `1` per disabilitare il [rendering a schermo intero](/docs/it/fullscreen) e usare il classico renderer sullo schermo principale. La conversazione resta nello scrollback nativo del tuo terminale, così `Cmd+f` e la modalità copia di tmux funzionano come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/docs/it/settings-reference#tui). Puoi anche cambiare con `/tui default`. Non si applica alle sessioni in background aperte dalla [vista agenti](/docs/it/agent-view), che usano sempre il rendering a schermo intero |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Imposta su `1` per disattivare lo strumento [Artifact](/docs/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Una volta impostata, nessun file di impostazioni riattiva lo strumento. Per disattivare invece lo strumento da un file di impostazioni, imposta [`enableArtifact`](/docs/it/settings-reference#enableartifact) su `false`; anche la chiave deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact) lo disattiva |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Imposta `1` per disattivare lo strumento [Artifact](/docs/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Una volta impostata, nessun file di impostazioni riattiva lo strumento. Per disattivare invece lo strumento da un file di impostazioni, imposta [`enableArtifact`](/docs/it/settings-reference#enableartifact) su `false`; anche la chiave deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact) lo disattiva |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Imposta su `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice anziché essere espanse nel contenuto del file |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Imposta `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Imposta su `1` per fare in modo che un processo Claude Code esegua autonomamente il proprio comando [`gcpAuthRefresh`](/docs/it/settings-reference#gcpauthrefresh) o [`awsAuthRefresh`](/docs/it/settings-reference#awsauthrefresh) anziché attendere mentre lo esegue un altro processo. Richiede Claude Code v2.1.286 o successiva |248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Imposta `1` per fare in modo che un processo Claude Code esegua direttamente il proprio comando [`gcpAuthRefresh`](/docs/it/settings-reference#gcpauthrefresh) o [`awsAuthRefresh`](/docs/it/settings-reference#awsauthrefresh) invece di attendere mentre un altro processo lo esegue. Richiede Claude Code v2.1.286 o successiva |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Imposta su `1` per disabilitare la [memoria automatica](/docs/it/memory#auto-memory). Imposta su `0` per forzare l'attivazione della memoria automatica anche quando la modalità `--bare` o [`autoMemoryEnabled: false`](/docs/it/settings-reference#automemoryenabled) la disabiliterebbero. Quando è disabilitata, Claude non crea né carica i file di memoria automatica |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Imposta `1` per disabilitare la [memoria automatica](/docs/it/memory#auto-memory). Imposta `0` per forzare l'attivazione della memoria automatica anche quando la modalità `--bare` o [`autoMemoryEnabled: false`](/docs/it/settings-reference#automemoryenabled) la disabiliterebbero. Quando è disabilitata, Claude non crea né carica i file della memoria automatica |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disabilitare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` degli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta `1` per disabilitare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` negli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Imposta su `1` per impedire a Claude Code di trattare una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) con un header `Content-Type` mancante o vuoto come il flusso di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia rimosso l'header da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche lo stream come server-sent events; Claude Code legge quindi il corpo senza header come server-sent events. Richiede Claude Code v2.1.239 o successiva |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Imposta `1` per impedire a Claude Code di trattare una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) con un header `Content-Type` mancante o vuoto come il flusso di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia eliminato l'header da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche lo stream come server-sent events; Claude Code legge quindi il corpo senza header come server-sent events. Richiede Claude Code v2.1.239 o successiva |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Imposta su `1` per saltare il controllo che verifica che una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un [gateway o un proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configura il gateway per inoltrare l'header `Content-Type` e il corpo senza modifiche anziché impostare questa variabile. Richiede Claude Code v2.1.208 o successiva |252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Imposta `1` per saltare il controllo che verifica che una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un [gateway o un proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configura il gateway in modo che inoltri l'header `Content-Type` e il corpo senza modificarli invece di impostare questa variabile. Richiede Claude Code v2.1.208 o successiva |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Imposta su `1` per arrestare i comandi shell in background in esecuzione, i workflow dinamici e, a partire dalla v2.1.198, i subagent in background di una [sessione in background](/docs/it/agent-view) quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, anziché passarli al processo successivo della sessione. Riguarda solo quel passaggio: spostare una sessione in background con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) trasferisce comunque il lavoro in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successiva |253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Imposta `1` per arrestare i comandi di shell in background, i workflow dinamici e, a partire dalla v2.1.198, i subagent in background in esecuzione in una [sessione in background](/docs/it/agent-view) quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di passarli al processo successivo della sessione. Influisce solo su quel passaggio: spostare una sessione in background con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) trasferisce comunque il lavoro in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successiva |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Imposta su `1` per impedire a Claude Code di terminare i [comandi shell in background](/docs/it/interactive-mode#background-bash-commands) in caso di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è rimasta inattiva per 30 minuti senza turni o subagent in esecuzione. Windows non dispone di un segnale di pressione sulla memoria, quindi lì questa variabile non ha effetto. Richiede Claude Code v2.1.193 o successiva |254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Imposta `1` per impedire a Claude Code di terminare i [comandi di shell in background](/docs/it/interactive-mode#background-bash-commands) in caso di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è rimasta inattiva per 30 minuti senza turni o subagent in esecuzione. Windows non ha un segnale di pressione sulla memoria, quindi lì questa variabile non ha effetto. Richiede Claude Code v2.1.193 o successiva |

255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disabilitare le [skill](/docs/it/skills) 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 da plugin, `.claude/skills/` e `.claude/commands/` non sono interessate. Equivalente all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta `1` per disabilitare le [skill](/docs/it/skills) e i workflow inclusi in Claude Code: le skill incluse e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma vengono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; per nasconderlo usa invece `DISABLE_DOCTOR_COMMAND`. Le skill provenienti dai plugin, da `.claude/skills/` e da `.claude/commands/` non sono interessate. Equivalente all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |

256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Imposta su `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](/docs/it/chrome) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Richiede Claude Code v2.1.257 o successiva |256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Imposta `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](/docs/it/chrome) omettendo la sezione su Chrome del prompt di sistema e la [skill inclusa](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Richiede Claude Code v2.1.257 o successiva |

257| `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 di memoria automatica |257| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta `1` per impedire il caricamento nel contesto di qualsiasi file di memoria CLAUDE.md, inclusi i file di memoria dell'utente, del progetto e della memoria automatica |

258| `CLAUDE_CODE_DISABLE_CRON` | Imposta su `1` per disabilitare le [attività pianificate](/docs/it/scheduled-tasks). 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 |258| `CLAUDE_CODE_DISABLE_CRON` | Imposta `1` per disabilitare le [attività pianificate](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse quelle già in esecuzione a metà sessione |

259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Imposta su `1` per disattivare il limite di tempo sulle richieste di conferma per la [rimozione di percorsi critici](/docs/it/permission-modes#critical-paths). In modalità `auto` Claude Code invia quindi queste rimozioni al classificatore, e in modalità `bypassPermissions` la richiesta di conferma attende la tua risposta. 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 |259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Imposta `1` per disattivare il limite di tempo sulle richieste di conferma per la [rimozione di percorsi critici](/docs/it/permission-modes#critical-paths). In modalità `auto`, Claude Code invia quindi queste rimozioni al classificatore, e in modalità `bypassPermissions` la richiesta attende la tua risposta. 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 |

260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere dalle richieste API gli header di richiesta `anthropic-beta` di pre-rilascio, 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 con un errore `Extra inputs are not permitted`. [Disabilitare le funzionalità di pre-rilascio](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) elenca ciò che la variabile rimuove, incluso [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search), e ciò che Claude Code continua a inviare |260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta `1` per rimuovere dalle richieste API gli header di richiesta `anthropic-beta` pre-release, i campi del corpo associati a essi e i campi beta dello schema degli strumenti come `defer_loading` ed `eager_input_streaming`. Usala quando un gateway proxy rifiuta le richieste con un errore `Unexpected value(s)` per l'header `anthropic-beta` o con un errore `Extra inputs are not permitted`. [Disabilitare le funzionalità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) elenca ciò che la variabile rimuove, incluso [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search), e ciò che Claude Code continua a inviare |

261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Imposta su `1` per disabilitare i [subagent Explore e Plan](/docs/it/sub-agents#built-in-subagents) integrati. Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente anziché 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 successiva |261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Imposta `1` per disabilitare i [subagent Explore e Plan](/docs/it/sub-agents#built-in-subagents) integrati. Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge direttamente i file anziché avviare gli agenti Explore e Plan. I subagent personalizzati chiamati `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 successiva |

262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disabilitare la [modalità veloce](/docs/it/fast-mode) |262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta `1` per disabilitare la [modalità veloce](/docs/it/fast-mode) |

263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disabilitare i sondaggi sulla qualità della sessione "How is Claude doing?". I sondaggi sono disabilitati 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 anziché disabilitarli del tutto, usa l'impostazione [`feedbackSurveyRate`](/docs/it/settings-reference#feedbacksurveyrate). Consulta [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) |263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta `1` per disabilitare i sondaggi sulla qualità della sessione "How is Claude doing?". I sondaggi sono disabilitati 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 disabilitarli del tutto, usa l'impostazione [`feedbackSurveyRate`](/docs/it/settings-reference#feedbacksurveyrate). Consulta [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) |

264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disabilitare il [checkpointing](/docs/it/checkpointing) dei file. Il comando `/rewind` non potrà ripristinare le modifiche al codice. Sovrascrive l'impostazione [`fileCheckpointingEnabled`](/docs/it/settings-reference#filecheckpointingenabled) |264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta `1` per disabilitare il [checkpointing](/docs/it/checkpointing) dei file. Il comando `/rewind` non sarà in grado di ripristinare le modifiche al codice. Sovrascrive l'impostazione [`fileCheckpointingEnabled`](/docs/it/settings-reference#filecheckpointingenabled) |

265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Imposta su `1` per rimuovere dal contesto di Claude le istruzioni integrate sul workflow di commit e PR e lo snapshot dello stato git. Utile quando usi le tue skill per il workflow git. Quando è impostata, ha la precedenza sull'impostazione [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) |265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Imposta `1` per rimuovere dal contesto di Claude le istruzioni integrate sul workflow di commit e PR e lo snapshot dello stato di git. Utile quando usi skill personalizzate per il workflow git. Quando è impostata, ha la precedenza sull'impostazione [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) |

266| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Imposta su `1` per impedire la rimappatura automatica di Opus 4.0 e 4.1 alla versione attuale di Opus sull'API Anthropic. Usala quando vuoi intenzionalmente fissare un modello precedente. La rimappatura non viene eseguita su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry |266| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Imposta `1` per impedire a Claude Code di leggere gli script passati a una shell con `-c`, come `bash -c 'rm -rf ~'`, alla ricerca di rimozioni di [percorsi critici](/docs/it/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code controlla comunque le destinazioni costituite da variabili di shell e parametri posizionali in quegli script, e gli altri controlli sui percorsi critici continuano a essere eseguiti. 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.288 o successiva |

267| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Imposta su `1` per impedire a Claude Code su [Amazon Bedrock](/docs/it/amazon-bedrock#when-a-model-is-disabled-mid-session) e [Google Cloud's Agent Platform](/docs/it/google-vertex-ai#when-a-model-is-disabled-mid-session) di passare a un modello precedente quando il tuo account perde l'accesso al modello di una sessione a metà sessione; la richiesta rifiutata non riesce invece subito. Una [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) che configuri cambia comunque modello in caso di rifiuto, e i [controlli dei modelli all'avvio](/docs/it/amazon-bedrock#startup-model-checks) ripiegano comunque su un altro modello all'avvio. Richiede Claude Code v2.1.285 o successiva |267| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Imposta `1` per impedire la rimappatura automatica di Opus 4.0 e 4.1 alla versione corrente di Opus sull'API Anthropic. Usala quando vuoi intenzionalmente fissare un modello più vecchio. La rimappatura non viene eseguita su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry |

268| `CLAUDE_CODE_DISABLE_MOUSE` | Imposta su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` funziona ancora. Usala per mantenere il comportamento nativo di copia alla selezione del tuo terminale |268| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Imposta `1` per impedire a Claude Code su [Amazon Bedrock](/docs/it/amazon-bedrock#when-a-model-is-disabled-mid-session) e [Google Cloud's Agent Platform](/docs/it/google-vertex-ai#when-a-model-is-disabled-mid-session) di passare a un modello più vecchio quando il tuo account perde l'accesso al modello di una sessione a metà sessione; la richiesta rifiutata fallisce invece immediatamente. Una [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) che configuri passa comunque a un altro modello in caso di quel rifiuto, e i [controlli del modello all'avvio](/docs/it/amazon-bedrock#startup-model-checks) ripiegano comunque su un fallback all'avvio. Richiede Claude Code v2.1.285 o successiva |

269| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Imposta su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento con la rotellina del mouse. Usala quando vuoi che lo scorrimento con la rotellina funzioni in Claude Code ma non vuoi che i clic posizionino il cursore, espandano l'output degli strumenti o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando sono impostate entrambe. Richiede Claude Code v2.1.195 o successiva |269| `CLAUDE_CODE_DISABLE_MOUSE` | Imposta `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` funziona ancora. Usala per mantenere il comportamento nativo del tuo terminale di copia alla selezione |

270| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Imposta su `1` per impedire a Claude Code di rileggere il [certificato e la chiave client mTLS](/docs/it/network-config#mtls-authentication) quando una richiesta API non riesce con un errore a livello di connessione, come un reset della connessione o un errore dell'handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo alla successiva applicazione delle impostazioni o al successivo avvio. Richiede Claude Code v2.1.232 o successiva |270| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Imposta `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento con la rotellina del mouse. Usala quando vuoi che lo scorrimento con la rotellina funzioni in Claude Code ma non vuoi che i clic posizionino il cursore, espandano l'output degli strumenti o aprano link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando sono impostate entrambe. Richiede Claude Code v2.1.195 o successiva |

271| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Imposta su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: aggiornamenti automatici, telemetria, segnalazione degli errori, il comando `/feedback`, il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), le note di rilascio, i controlli del [badge di stato di PR e MR](/docs/it/interactive-mode#pr-review-status) e i controlli di disponibilità come quello della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni in background delle origini `command` dei plugin](/docs/it/plugins/loading#when-a-command-source-re-runs), che sono comandi locali anziché traffico di rete, perché possono attivare installazioni di dipendenze. **Impostarla su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili di attivazione/disattivazione; rimuovi la variabile per consentirlo di nuovo. Disabilita anche il recupero dei feature flag, il che rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). L'installazione automatica del marketplace ufficiale dei plugin non è inclusa; disabilitala con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sul [rilevamento dei modelli del gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha una propria attivazione esplicita |271| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Imposta `1` per impedire a Claude Code di rileggere il [certificato e la chiave client mTLS](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un reset della connessione o un errore dell'handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo la volta successiva in cui applica le impostazioni o al successivo avvio. Richiede Claude Code v2.1.232 o successiva |

272| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Imposta su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming non riesce a metà stream. Gli errori di streaming vengono invece propagati al livello dei nuovi tentativi. Utile quando un proxy o un gateway fa sì che il fallback produca un'esecuzione duplicata degli strumenti |272| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Impostala su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: aggiornamenti automatici, telemetria, segnalazione degli errori, il comando `/feedback`, il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), le note di rilascio, i controlli del [badge di stato di PR e MR](/docs/it/interactive-mode#pr-review-status) e i controlli di disponibilità come quello della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Arresta anche le [esecuzioni in background delle sorgenti `command` dei plugin](/docs/it/plugins/loading#when-a-command-source-re-runs), che sono comandi locali e non traffico di rete, perché possono attivare installazioni di dipendenze. **Impostarla su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili di attivazione/disattivazione; rimuovi la variabile per consentirlo di nuovo. Disabilita anche il recupero dei feature flag, il che rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). L'installazione automatica del marketplace di plugin ufficiale non è inclusa; disabilitala con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sul [rilevamento dei modelli del gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha una propria attivazione esplicita |

273| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Imposta su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre stai digitando nel terminale o il terminale ha il focus. Per impostazione predefinita lo strumento salta sia la notifica desktop sia la [notifica push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva attività recente della tastiera o il focus sul terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere la notifica push mobile quando rileva che sei attivo. Richiede Claude Code v2.1.193 o successiva |273| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Imposta `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà dello stream. Gli errori di streaming vengono invece propagati al livello dei nuovi tentativi. Utile quando un proxy o un gateway fa sì che il fallback produca un'esecuzione duplicata degli strumenti |

274| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Imposta su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo su una macchina. Se la variabile è impostata in quel momento, Claude Code salta la registrazione in modo permanente. Rimuovere la variabile in seguito non annulla il salto. Esegui `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |274| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Imposta `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre stai digitando nel terminale o quando è in primo piano. Per impostazione predefinita, lo strumento salta sia la notifica desktop sia la [notifica push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva attività recente della tastiera o il terminale in primo piano. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere la notifica push mobile quando rileva che sei attivo. Richiede Claude Code v2.1.193 o successiva |

275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Imposta su `1` per impedire a Claude Code di eseguire i tuoi [hook `Notification` per le richieste di permesso senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code invia queste richieste alla callback `canUseTool` dell'Agent SDK, che è il modo in cui Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni del terminale. Richiede Claude Code v2.1.233 o successiva |275| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Imposta `1` per disabilitare la registrazione automatica del marketplace di plugin ufficiale. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo su una macchina. Se la variabile è impostata in quel momento, Claude Code salta la registrazione in modo permanente. Rimuovere la variabile in seguito non annulla l'omissione. Esegui `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |

276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Imposta su `1` per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni in container o CI che non devono caricare skill fornite dall'operatore |276| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Imposta `1` per impedire a Claude Code di eseguire i tuoi [hook `Notification` per le richieste di permesso senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è il modo in cui Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni da terminale. Richiede Claude Code v2.1.233 o successiva |

277| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Imposta su `1` per disattivare il controllo dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) che nega i comandi integrati di `cmd` `rd`, `rmdir`, `del` ed `erase` su un [percorso di sistema](/docs/it/permission-modes#remove-item-in-powershell), come la radice di un'unità o la tua directory home. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.283 o successiva |277| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Imposta `1` per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni in container o CI che non devono caricare skill fornite dall'operatore |

278| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Imposta su `1` per impedire a Claude Code di inviare il campo di output strutturato `output_config.format` e il valore `anthropic-beta` associato, per un [LLM gateway](/docs/it/llm-gateway-protocol#feature-pass-through) il cui upstream li rifiuta. Lascia attive le altre funzionalità di pre-rilascio che [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) disattiva. Richiede Claude Code v2.1.288 o successiva |278| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Imposta `1` per disattivare il controllo dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) che nega i comandi integrati di `cmd` `rd`, `rmdir`, `del` ed `erase` su un [percorso di sistema](/docs/it/permission-modes#remove-item-in-powershell), come la radice di un'unità o la tua directory home. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.283 o successiva |

279| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Imposta su `1` per disattivare il controllo dei [percorsi critici](/docs/it/permission-modes#critical-paths) per un `rm` ricorsivo il cui target è interamente l'output di una sostituzione di comando, come `rm -rf "$(pwd)"`. Gli altri controlli dei percorsi critici continuano a essere eseguiti. 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 |279| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Imposta `1` per disattivare il [cambio automatico di modello quando un classificatore di sicurezza segnala una richiesta](/docs/it/model-config#automatic-model-fallback), il comportamento controllato dall'impostazione [`switchModelsOnFlag`](/docs/it/settings-reference#switchmodelsonflag) |

280| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Imposta su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta in background al modello piccolo/veloce che [genera il titolo della sessione](/docs/it/sessions#name-your-sessions) |280| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Imposta `1` per impedire a Claude Code di inviare il campo di output strutturato `output_config.format` e il valore `anthropic-beta` associato, per un [gateway LLM](/docs/it/llm-gateway-protocol#feature-pass-through) il cui upstream li rifiuta. Lascia attive le altre funzionalità pre-release che [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) disattiva. Richiede Claude Code v2.1.288 o successiva |

281| `CLAUDE_CODE_DISABLE_THINKING` | Imposta su `1` per omettere completamente il parametro `thinking` dalle richieste API. È un'opzione di compatibilità per proxy e gateway che rifiutano il parametro. Sui modelli che ragionano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque ragionare. Per disabilitare esplicitamente il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, usa invece `MAX_THINKING_TOKENS=0`. Nessuna delle due variabili disattiva il ragionamento su Opus 5.5, Sonnet 5.5 o sui modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), anche `MAX_THINKING_TOKENS=0` omette il parametro, quindi lì le due variabili si comportano allo stesso modo |281| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Imposta `1` per disattivare il controllo sui [percorsi critici](/docs/it/permission-modes#critical-paths) per un `rm` ricorsivo la cui destinazione è interamente l'output di una sostituzione di comando, come `rm -rf "$(pwd)"`. Gli altri controlli sui percorsi critici continuano a essere eseguiti. 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 |

282| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Imposta su `1` per saltare la [compattazione automatica](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di un [LLM gateway](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta in base alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può invece correggere la finestra presunta; consulta [Correggere la finestra per un gateway o un ID modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per sapere quando si applica ciascuna variabile. Richiede Claude Code v2.1.223 o successiva |282| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Imposta `1` per disabilitare gli aggiornamenti automatici del titolo del terminale basati sul contesto della conversazione. Salta anche la richiesta in background al modello piccolo/veloce che [genera un titolo della sessione](/docs/it/sessions#name-your-sessions) |

283| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Imposta su `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) ed eseguire il rendering di ogni messaggio della trascrizione. Usala se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero comparire i messaggi |283| `CLAUDE_CODE_DISABLE_THINKING` | Imposta `1` per omettere completamente il parametro `thinking` dalle richieste API. È un'opzione di compatibilità per proxy e gateway che rifiutano il parametro. Sui modelli che ragionano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque ragionare. Per disabilitare esplicitamente il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, usa invece `MAX_THINKING_TOKENS=0`. Nessuna delle due variabili disattiva il ragionamento su Opus 5.5, Sonnet 5.5 o sui modelli Fable, sui quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), anche `MAX_THINKING_TOKENS=0` omette il parametro, quindi lì le due variabili si comportano allo stesso modo |

284| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Imposta su `1` per disattivare lo strumento [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior). Lo strumento [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) resta disponibile. Richiede Claude Code v2.1.285 o successiva |284| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Imposta `1` per saltare la [compattazione automatica](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di un [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta in base alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può invece correggere la finestra presunta; consulta [Correggere la finestra per un gateway o un ID di modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per sapere quando si applica ciascuna variabile. Richiede Claude Code v2.1.223 o successiva |

285| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Imposta su `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente anziché tramite il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell [in esecuzione in background](/docs/it/tools-reference#background-commands) di [passare al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [sposti la sessione in background](/docs/it/agent-view#from-inside-a-session). Se imposti la variabile, un comando PowerShell in background si arresta quando il processo della sessione termina. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successiva |285| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Imposta `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) ed eseguire il rendering di ogni messaggio nella trascrizione. Usala se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero comparire i messaggi |

286| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Imposta su `1` per disabilitare i [workflow](/docs/it/workflows#turn-workflows-off). Equivalente all'impostazione [`disableWorkflows`](/docs/it/settings-reference#disableworkflows) |286| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Imposta `1` per disattivare lo strumento [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior). Lo strumento [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) resta disponibile. Richiede Claude Code v2.1.285 o successiva |

287| `CLAUDE_CODE_EFFORT_LEVEL` | Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max` oppure `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e sulle impostazioni `modelSettings` ed `effortLevel`. Un limite [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) si applica comunque. Consulta [Regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level) |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Imposta `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente invece che tramite il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell [in esecuzione in background](/docs/it/tools-reference#background-commands) di [passare al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [sposti la sessione in background](/docs/it/agent-view#from-inside-a-session). Se imposti la variabile, un comando PowerShell in background si arresta quando il processo della sessione termina. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successiva |

288| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Accettata per compatibilità con le versioni precedenti e non ha effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e le sessioni del [Claude apps gateway](/docs/it/claude-apps-gateway) con accesso effettuato. Dalla v2.1.158 alla v2.1.206, era necessario impostarla su `1` per rendere disponibile la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) su quei provider |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Imposta `1` per disabilitare i [workflow](/docs/it/workflows#turn-workflows-off). Equivalente all'impostazione [`disableWorkflows`](/docs/it/settings-reference#disableworkflows) |

289| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sovrascrive la disponibilità del [riepilogo della sessione](/docs/it/interactive-mode#session-recap). Imposta su `0` per forzare la disattivazione dei riepiloghi indipendentemente dall'opzione di `/config`. Imposta su `1` per forzare l'attivazione dei riepiloghi quando [`awaySummaryEnabled`](/docs/it/settings-reference#awaysummaryenabled) è `false`. Ha la precedenza sull'impostazione e sull'opzione di `/config` |289| `CLAUDE_CODE_EFFORT_LEVEL` | Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max`, oppure `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e sulle impostazioni `modelSettings` ed `effortLevel`. Un limite [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) si applica comunque. Consulta [Regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level) |

290| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Imposta a `1` per aggiornare lo stato dei plugin ai confini dei turni in [modalità non interattiva](/docs/it/headless) dopo il completamento di un'installazione in background. Disattivata per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, invalidando il [prompt caching](/docs/it/prompt-caching) per quel turno |290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Accettata per compatibilità con le versioni precedenti e non ha alcun effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e le sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) con accesso effettuato. Dalla v2.1.158 alla v2.1.206, era necessario impostarla su `1` per rendere disponibile la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) su quei provider |

291| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta a `1` per indirizzare il sondaggio sulla qualità della sessione "How is Claude doing?" al tuo [collector OpenTelemetry](/docs/it/monitoring-usage) quando il traffico non essenziale diretto ad Anthropic è bloccato. Le valutazioni del sondaggio vengono emesse solo come eventi OTEL verso il collector configurato. In questa modalità nessun dato del sondaggio viene inviato ad Anthropic. Si applica quando è impostata `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la policy dell'organizzazione sul feedback del prodotto hanno la precedenza |291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sovrascrive la disponibilità del [riepilogo della sessione](/docs/it/interactive-mode#session-recap). Imposta su `0` per forzare la disattivazione dei riepiloghi indipendentemente dall'interruttore in `/config`. Imposta su `1` per forzare l'attivazione dei riepiloghi quando [`awaySummaryEnabled`](/docs/it/settings-reference#awaysummaryenabled) è `false`. Ha la precedenza sull'impostazione e sull'interruttore in `/config` |

292| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate agli strumenti vengono trasmessi in streaming dall'API mentre Claude li genera. Con questa opzione disattivata, un input di grandi dimensioni come la scrittura di un file lungo arriva solo dopo che Claude ha finito di generarlo, il che può dare l'impressione che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su Amazon Bedrock e Agent Platform di Google Cloud, abilitato per modello dove il container distribuito lo supporta. Imposta a `0` per disattivarlo. Imposta a `1` per forzarne l'attivazione quando l'instradamento passa attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Microsoft Foundry e sulle connessioni tramite [gateway](/docs/it/llm-gateway) |292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Imposta su `1` per aggiornare lo stato dei plugin ai confini dei turni in [modalità non interattiva](/docs/it/headless) dopo il completamento di un'installazione in background. Disattivata per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, il che invalida il [prompt caching](/docs/it/prompt-caching) per quel turno |

293| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Imposta a `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del tuo gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivato per impostazione predefinita perché i gateway basati su una chiave API condivisa mostrerebbero altrimenti a ogni utente tutti i modelli a cui la chiave può accedere. I modelli rilevati vengono comunque filtrati da un'allowlist [`availableModels`](/docs/it/settings-reference#availablemodels) ricevuta dalla sessione; distribuisci l'elenco tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), poiché [la distribuzione gestita dal server non è disponibile nelle configurazioni con gateway](/docs/it/server-managed-settings#platform-availability) |293| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta su `1` per indirizzare il sondaggio sulla qualità della sessione "How is Claude doing?" al tuo [collector OpenTelemetry](/docs/it/monitoring-usage) quando il traffico non essenziale diretto ad Anthropic è bloccato. Le valutazioni del sondaggio vengono emesse solo come eventi OTEL verso il collector configurato. In questa modalità nessun dato del sondaggio viene inviato ad Anthropic. Si applica quando è impostata `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la policy dell'organizzazione sul feedback del prodotto hanno la precedenza |

294| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimossa nella v2.1.142, quando il valore predefinito della [modalità veloce](/docs/it/fast-mode) è passato da Opus 4.6 a Opus 4.7 |294| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate agli strumenti vengono trasmessi in streaming dall'API mentre Claude li genera. Se è disattivata, un input di grandi dimensioni per uno strumento, come la scrittura di un file lungo, arriva solo dopo che Claude ha finito di generarlo, e può sembrare che il processo sia bloccato. Attivata per impostazione predefinita sull'API di Anthropic. Su Amazon Bedrock e Agent Platform di Google Cloud, è attivata per ogni modello in cui il container distribuito la supporta. Imposta su `0` per disattivarla. Imposta su `1` per forzarne l'attivazione quando il traffico passa per un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivata per impostazione predefinita su Microsoft Foundry e sulle connessioni tramite [gateway](/docs/it/llm-gateway) |

295| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Imposta a `false` per disattivare i suggerimenti di prompt, le previsioni in grigio che compaiono nell'input del prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quella scritta dall'interruttore **Prompt suggestions** in `/config`. Claude Code inoltre [sospende i suggerimenti quando il tuo account è vicino al proprio limite di utilizzo o lo ha raggiunto](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Imposta a `true` per mantenerli attivi finché non raggiungi il limite. Richiede Claude Code v2.1.238 o successiva. Vedi [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |295| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Imposta su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del tuo gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivata per impostazione predefinita perché, altrimenti, i gateway basati su una chiave API condivisa mostrerebbero a ogni utente tutti i modelli a cui la chiave può accedere. I modelli rilevati vengono comunque filtrati da un'allowlist [`availableModels`](/docs/it/settings-reference#availablemodels) ricevuta dalla sessione; distribuisci l'elenco tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), poiché [la distribuzione gestita dal server non è disponibile nelle configurazioni con gateway](/docs/it/server-managed-settings#platform-availability) |

296| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di monitoraggio delle attività fornisce Claude Code nelle [sessioni che li prevedono](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Imposta a `0` per ottenere invece lo strumento legacy `TodoWrite`. Vedi [Elenco delle attività](/docs/it/interactive-mode#task-list) |296| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimossa nella v2.1.142, quando il modello predefinito della [modalità veloce](/docs/it/fast-mode) è passato da Opus 4.6 a Opus 4.7 |

297| `CLAUDE_CODE_ENABLE_TELEMETRY` | Imposta a `1` per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Necessaria prima di configurare gli exporter OTel. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Vedi [Monitoraggio](/docs/it/monitoring-usage) |297| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Imposta su `false` per disattivare i suggerimenti di prompt, le previsioni in grigio che compaiono nel campo di input del prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quella scritta dall'interruttore **Prompt suggestions** in `/config`. Claude Code inoltre [sospende i suggerimenti quando il tuo account è vicino al limite di utilizzo o lo ha raggiunto](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Imposta su `true` per mantenerli attivi finché non raggiungi il limite. Richiede Claude Code v2.1.238 o successiva. Consulta [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |

298| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Imposta a `1` per ottenere gli strumenti di monitoraggio delle attività su ogni modello. Senza di essa, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successiva |298| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività fornisce Claude Code nelle [sessioni che li prevedono](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Imposta su `0` per usare invece lo strumento legacy `TodoWrite`. Consulta [Elenco delle attività](/docs/it/interactive-mode#task-list) |

299| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da attendere dopo che il ciclo di query diventa inattivo prima di uscire automaticamente. Utile per workflow automatizzati e script che usano la modalità SDK |299| `CLAUDE_CODE_ENABLE_TELEMETRY` | Imposta su `1` per attivare la raccolta di dati OpenTelemetry per metriche e logging. Necessaria prima di configurare gli exporter OTel. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

300| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Imposta a `1` per abilitare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |300| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Imposta su `1` per avere gli strumenti di tracciamento delle attività su ogni modello. Senza di essa, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successiva |

301| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da incorporare nel livello superiore del corpo di ogni richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella tua shell si applica anche alle [sessioni in background](/docs/it/agent-view) che avvii con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e usavano qualunque copia avesse ereditato il processo supervisore in background |301| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da attendere dopo che il ciclo delle query diventa inattivo prima di uscire automaticamente. Utile per workflow automatizzati e script che usano la modalità SDK |

302| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sovrascrive il limite di token predefinito per le letture di file. Utile quando devi leggere file più grandi per intero |302| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Imposta su `1` per attivare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disattivati per impostazione predefinita |

303| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Imposta a `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione in `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione di Claude Code. Usala quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o da un launcher in background avviato inizialmente dallo strumento Bash di Claude Code, fa sì che una vera sessione di primo livello venga classificata erroneamente come annidata. A partire dalla v2.1.178, Claude Code rileva automaticamente il caso tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Rispettata anche nella v2.1.169 e precedenti; non ha effetto nelle v2.1.170 e v2.1.171, in cui il rilevamento delle sessioni annidate che sovrascrive era stato rimosso |303| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore del corpo di ogni richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella tua shell si applica anche alle [sessioni in background](/docs/it/agent-view) che avvii con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e usavano la copia ereditata dal processo supervisore in background |

304| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Imposta a `1` per forzare il rendering barrato di `~~text~~` nelle risposte di Claude quando il tuo terminale lo supporta ma non viene rilevato automaticamente, ad esempio tramite SSH senza inoltro di `TERM_PROGRAM`. Senza questa variabile, i terminali non rilevati mostrano i marcatori `~~` letterali invece di visualizzare il testo barrato. Richiede Claude Code v2.1.186 o successiva |304| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sovrascrive il limite di token predefinito per la lettura dei file. Utile quando devi leggere per intero file di dimensioni maggiori |

305| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Imposta a `1` per forzare l'abilitazione dell'[output sincronizzato](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) in modalità privata DEC 2026 quando il tuo terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono alla verifica delle capacità. Non ha effetto in tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al [rendering a schermo intero](/docs/it/fullscreen), questa variabile non cambia il renderer |305| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Imposta su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione in `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione di Claude Code. Usala quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o da un launcher in background avviato inizialmente dallo strumento Bash di Claude Code, fa sì che una sessione di primo livello autentica venga erroneamente classificata come annidata. A partire dalla v2.1.178, Claude Code rileva automaticamente il caso di tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Viene rispettata anche nella v2.1.169 e precedenti; non ha effetto nelle v2.1.170 e v2.1.171, in cui il rilevamento delle sessioni annidate che sovrascrive era stato rimosso |

306| `CLAUDE_CODE_FORK_SUBAGENT` | Controlla la [modalità fork](/docs/it/sub-agents#turn-fork-mode-on-or-off), che consente a Claude di generare autonomamente [subagent forkati](/docs/it/sub-agents#fork-the-current-conversation) ed è attiva per impostazione predefinita solo nelle sessioni interattive. Imposta a `1` per attivarla anche in `claude -p` e nell'Agent SDK, oppure a `0` per disattivarla in ogni tipo di sessione. Puoi eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. Il valore predefinito interattivo richiede Claude Code v2.1.232 o successiva; nelle versioni precedenti, imposta la variabile a `1` per attivare la modalità fork |306| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Imposta su `1` per forzare la visualizzazione barrata di `~~text~~` nelle risposte di Claude quando il tuo terminale la supporta ma non viene rilevato automaticamente, ad esempio tramite SSH senza inoltro di `TERM_PROGRAM`. Senza questa variabile, i terminali non rilevati mostrano i marcatori `~~` letterali invece di visualizzare il testo barrato. Richiede Claude Code v2.1.186 o successiva |

307| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Imposta a `1` per emettere il testo e i blocchi di ragionamento dei [subagent](/docs/it/sub-agents) nell'output di `claude -p --output-format stream-json`, lo stesso comportamento del flag [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags). Usa la variabile quando un harness invoca `claude` e non può passare il flag direttamente. A differenza del flag, che termina con un errore al di fuori della modalità non interattiva con output stream-json, la variabile viene ignorata in quei casi, così le invocazioni annidate continuano a funzionare quando è impostata a livello di processo. Richiede Claude Code v2.1.211 o successiva |307| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Imposta su `1` per forzare l'attivazione dell'[output sincronizzato](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) in DEC private mode 2026 quando il tuo terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono alla verifica delle funzionalità. Non ha effetto in tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al [rendering a schermo intero](/docs/it/fullscreen), questa variabile non cambia il renderer |

308| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Imposta a `1` per inviare gli [header di suggerimento per il gateway](/docs/it/llm-gateway-protocol#gateway-hint-headers), come `x-claude-code-request-class` e `x-claude-code-compaction`, su un proxy personalizzato o su un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Imposta a `0` per smettere di inviarli su ogni connessione, inclusa una connessione diretta all'API Anthropic, dove Claude Code li invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successiva |308| `CLAUDE_CODE_FORK_SUBAGENT` | Controlla la [modalità fork](/docs/it/sub-agents#turn-fork-mode-on-or-off), che consente a Claude di generare autonomamente [subagent fork](/docs/it/sub-agents#fork-the-current-conversation) ed è attiva per impostazione predefinita solo nelle sessioni interattive. Imposta su `1` per attivarla anche in `claude -p` e nell'Agent SDK, oppure su `0` per disattivarla in ogni tipo di sessione. Puoi eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. Il comportamento predefinito nelle sessioni interattive richiede Claude Code v2.1.232 o successiva; nelle versioni precedenti, imposta la variabile su `1` per attivare la modalità fork |

309| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in millisecondi per la richiesta di [rilevamento dei modelli del gateway](/docs/it/llm-gateway-protocol#model-discovery) che `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` attiva (predefinito: `3000`). Aumentalo quando il tuo gateway impiega più di tre secondi per rispondere a `/v1/models` all'avvio. Accetta solo cifre semplici; `0`, valori negativi e altre scritture mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successiva |309| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Imposta su `1` per emettere i blocchi di testo e di ragionamento dei [subagent](/docs/it/sub-agents) nell'output di `claude -p --output-format stream-json`, con lo stesso comportamento del flag [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags). Usa la variabile quando un harness invoca `claude` e non può passare il flag direttamente. A differenza del flag, che termina con un errore al di fuori della modalità non interattiva con output stream-json, in quei casi la variabile viene ignorata, in modo che le invocazioni annidate continuino a funzionare quando è impostata per l'intero processo. Richiede Claude Code v2.1.211 o successiva |

310| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso dell'eseguibile Git Bash (`bash.exe`). Usala quando Git Bash è installato ma non si trova nel tuo PATH. Se il percorso non esiste o il file non si chiama `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e rileva automaticamente Git Bash come se non fosse impostata, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code terminava all'avvio quando il percorso non esisteva e usava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Vedi [Configurazione su Windows](/docs/it/setup#set-up-on-windows) |310| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Imposta su `1` per inviare gli [header di suggerimento per il gateway](/docs/it/llm-gateway-protocol#gateway-hint-headers), come `x-claude-code-request-class` e `x-claude-code-compaction`, su un proxy personalizzato o su un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Imposta su `0` per smettere di inviarli su ogni connessione, inclusa una connessione diretta all'API di Anthropic, dove Claude Code li invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successiva |

311| `CLAUDE_CODE_GLOB_HIDDEN` | Imposta a `false` per escludere i dotfile dai risultati quando Claude invoca lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior). Inclusi per impostazione predefinita. Non influisce sul completamento automatico dei file con `@`, su `ls`, Grep o Read |311| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in millisecondi per la richiesta di [rilevamento dei modelli del gateway](/docs/it/llm-gateway-protocol#model-discovery) attivata da `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (predefinito: `3000`). Aumentalo quando il tuo gateway impiega più di tre secondi per rispondere a `/v1/models` all'avvio. Accetta solo cifre semplici; `0`, i valori negativi e le altre scritture mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successiva |

312| `CLAUDE_CODE_GLOB_NO_IGNORE` | Imposta a `false` per fare in modo che lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior) rispetti i pattern di `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti, inclusi quelli ignorati da git. Non influisce sul completamento automatico dei file con `@`, che ha la propria [impostazione `respectGitignore`](/docs/it/settings-reference#respectgitignore) |312| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso dell'eseguibile di Git Bash (`bash.exe`). Usala quando Git Bash è installato ma non si trova nel tuo PATH. Se il percorso non esiste o il file non si chiama `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e rileva automaticamente Git Bash come se non fosse impostata, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code terminava all'avvio quando il percorso non esisteva e usava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Consulta [Configurazione su Windows](/docs/it/setup#set-up-on-windows) |

313| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per il rilevamento dei file dello strumento Glob. Predefinito: 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |313| `CLAUDE_CODE_GLOB_HIDDEN` | Imposta su `false` per escludere i dotfile dai risultati quando Claude invoca lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior). Inclusi per impostazione predefinita. Non influisce sul completamento automatico dei file con `@`, su `ls`, su Grep o su Read |

314| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Quanti minuti il lavoro in background può tenere in attesa un obiettivo attivo prima che Claude Code [chieda a Claude di verificarlo](/docs/it/goal#background-work-defers-evaluation). Predefinito `30`. Imposta `0` per disattivare le verifiche. Indica minuti interi in cifre semplici, al massimo `10080`, ovvero una settimana. Claude Code tratta qualsiasi altro valore come non impostato e usa quello predefinito. Richiede Claude Code v2.1.234 o successiva |314| `CLAUDE_CODE_GLOB_NO_IGNORE` | Imposta su `false` per fare in modo che lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior) rispetti i pattern di `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti, inclusi quelli ignorati da Git. Non influisce sul completamento automatico dei file con `@`, che ha una propria [impostazione `respectGitignore`](/docs/it/settings-reference#respectgitignore) |

315| `CLAUDE_CODE_HIDE_CWD` | Imposta a `1` per nascondere la directory di lavoro nel logo di avvio. Utile per condivisioni dello schermo o registrazioni in cui il percorso espone il nome utente del tuo sistema operativo |315| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per il rilevamento dei file dello strumento Glob. Il valore predefinito è 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |

316| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sovrascrive l'indirizzo host usato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso l'instradamento da WSL a Windows |316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Per quanti minuti il lavoro in background può tenere in attesa un obiettivo attivo prima che Claude Code [chieda a Claude di controllarlo](/docs/it/goal#background-work-defers-evaluation). Predefinito `30`. Imposta `0` per disattivare i controlli. Indica minuti interi in cifre semplici, al massimo `10080`, cioè una settimana. Claude Code tratta qualsiasi altro valore come non impostato e usa il valore predefinito. Richiede Claude Code v2.1.234 o successiva |

317| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Imposta a `1` per saltare l'installazione automatica delle estensioni IDE. Equivale a impostare [`autoInstallIdeExtension`](/docs/it/settings-reference#autoinstallideextension) su `false` |317| `CLAUDE_CODE_HIDE_CWD` | Imposta su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per condivisioni dello schermo o registrazioni in cui il percorso rivela il nome utente del sistema operativo |

318| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Imposta a `1` per saltare la convalida delle voci del lockfile IDE durante la connessione. Usala quando la connessione automatica non riesce a trovare il tuo IDE nonostante sia in esecuzione |318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sovrascrive l'indirizzo host usato per connettersi all'estensione dell'IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso l'instradamento da WSL a Windows |

319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quanti [subagent](/docs/it/sub-agents#concurrent-subagent-limit) possono essere in esecuzione in una sessione prima che lo strumento Agent si rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi la variabile può modificare il limite ma non disabilitarlo. Richiede Claude Code v2.1.217 o successiva |319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Imposta su `1` per saltare l'installazione automatica delle estensioni IDE. Equivale a impostare [`autoInstallIdeExtension`](/docs/it/settings-reference#autoinstallideextension) su `false` |

320| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sovrascrive la dimensione della finestra di contesto che Claude Code presume per il modello attivo. A partire dalla v2.1.193, il modo in cui si applica dipende da come Claude Code risolve l'ID del modello; vedi [Correggere la finestra per un gateway o un ID modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Usala quando instradi verso un modello tramite `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione integrata per il suo nome |320| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Imposta su `1` per saltare la convalida delle voci del file di lock dell'IDE durante la connessione. Usala quando la connessione automatica non riesce a trovare il tuo IDE nonostante sia in esecuzione |

321| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quanti [subagent](/docs/it/sub-agents#concurrent-subagent-limit) possono essere in esecuzione in una sessione prima che lo strumento Agent si rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi la variabile può modificare il limite ma non disattivarlo. Richiede Claude Code v2.1.217 o successiva |

322| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sovrascrive la dimensione della finestra di contesto che Claude Code presuppone per il modello attivo. A partire dalla v2.1.193, il modo in cui si applica dipende da come Claude Code risolve l'ID del modello; consulta [Correggere la finestra per un gateway o un ID di modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Usala quando instradi verso un modello tramite `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione integrata prevista per il suo nome |

321| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Lunghezza massima in caratteri di ogni descrizione di strumento MCP e delle istruzioni di ogni server MCP che Claude Code invia al modello (predefinito: 2048). Claude Code [tronca il testo più lungo](/docs/it/mcp#for-mcp-server-authors). Accetta un numero intero positivo in cifre semplici. Qualsiasi altro valore viene ignorato e si applica il valore predefinito. Richiede Claude Code v2.1.280 o successiva |323| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Lunghezza massima in caratteri di ogni descrizione di strumento MCP e delle istruzioni di ogni server MCP che Claude Code invia al modello (predefinito: 2048). Claude Code [tronca il testo più lungo](/docs/it/mcp#for-mcp-server-authors). Accetta un numero intero positivo in cifre semplici. Qualsiasi altro valore viene ignorato e si applica il valore predefinito. Richiede Claude Code v2.1.280 o successiva |

322| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Imposta il numero massimo di token di output per la maggior parte delle richieste. Valori predefiniti e limiti variano in base al modello; vedi [token di output massimi](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code riduce al limite un valore che supera il limite di un modello. Per un ID modello che Claude Code non riesce a ricondurre a un modello noto, il valore predefinito è 32000 e il limite è 128000. Aumentare questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la [compattazione automatica](/docs/it/costs#reduce-token-usage) |324| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e i limiti variano in base al modello; consulta [token di output massimi](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code riduce al limite un valore superiore al limite del modello. Per un ID di modello che Claude Code non riesce a ricondurre a un modello noto, il valore predefinito è 32000 e il limite è 128000. Aumentare questo valore riduce la finestra di contesto effettivamente disponibile prima che si attivi la [compattazione automatica](/docs/it/costs#reduce-token-usage) |

323| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrive il numero di nuovi tentativi per le richieste API non riuscite (predefinito: 10). Limitato a 15 a partire dalla v2.1.186; a partire dalla v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Per le sessioni non presidiate che devono attendere durante interruzioni più lunghe, imposta invece `CLAUDE_CODE_RETRY_WATCHDOG` |325| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrive il numero di nuovi tentativi per le richieste API non riuscite (predefinito: 10). Limitato a 15 a partire dalla v2.1.186; a partire dalla v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Per le sessioni non presidiate che devono attendere durante interruzioni più lunghe, imposta invece `CLAUDE_CODE_RETRY_WATCHDOG` |

324| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Rimossa nella v2.1.224 e ora senza effetto. In precedenza limitava il numero totale di [subagent](/docs/it/sub-agents) che Claude poteva generare con lo strumento Agent in una sessione (predefinito: 200); generarne oltre il limite falliva con `Subagent spawn limit reached`. Il [limite di subagent simultanei](/docs/it/sub-agents#concurrent-subagent-limit) e il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) si applicano ancora |326| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Rimossa nella v2.1.224 e ora non ha alcun effetto. In precedenza limitava il numero totale di [subagent](/docs/it/sub-agents) che Claude poteva generare con lo strumento Agent in una sessione (predefinito: 200); la generazione oltre il limite falliva con `Subagent spawn limit reached`. Il [limite di subagent simultanei](/docs/it/sub-agents#concurrent-subagent-limit) e il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) si applicano ancora |

325| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Numero di [livelli di subagent](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) consentiti sotto la conversazione principale (predefinito: 3). Con il valore predefinito, i subagent possono generare i propri subagent e un subagent al terzo livello non può generarne altri; imposta `1` per disattivare l'annidamento. Dalla v2.1.217 alla v2.1.218, il valore predefinito era 1, quindi un subagent non poteva generarne di propri a meno che non aumentassi il limite; la v2.1.219 ha portato il valore predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi il limite può essere modificato ma non rimosso. Richiede Claude Code v2.1.217 o successiva |327| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Numero di [livelli di subagent](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) consentiti sotto la conversazione principale (predefinito: 3). Con il valore predefinito, i subagent possono generare i propri subagent, e un subagent al terzo livello non può generarne altri; imposta `1` per disattivare l'annidamento. Dalla v2.1.217 alla v2.1.218, il valore predefinito era 1, quindi un subagent non poteva generarne di propri a meno che non aumentassi il limite; la v2.1.219 ha portato il valore predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi il limite può essere modificato ma non rimosso. Richiede Claude Code v2.1.217 o successiva |

326| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |328| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |

327| `CLAUDE_CODE_MAX_TURNS` | Limita il numero di turni agentici quando non viene passato un limite esplicito. Equivale a passare [`--max-turns`](/docs/it/cli-reference#cli-flags), che ha la precedenza quando sono impostati entrambi. Un valore che non è un intero positivo viene rifiutato all'avvio con un errore invece di essere trattato come assenza di limite |329| `CLAUDE_CODE_MAX_TURNS` | Limita il numero di turni agentici quando non viene passato alcun limite esplicito. Equivale a passare [`--max-turns`](/docs/it/cli-reference#cli-flags), che ha la precedenza quando sono impostati entrambi. Un valore che non è un numero intero positivo viene rifiutato all'avvio con un errore anziché essere trattato come assenza di limite |

328| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite al numero totale di chiamate [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) che una sessione può effettuare (predefinito: 200). Quando Claude raggiunge il limite, ulteriori chiamate WebSearch restituiscono un avviso che gli indica di proseguire con le informazioni già raccolte. Accetta un numero intero positivo senza limite superiore. Qualsiasi altro valore viene ignorato e si applica il valore predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successiva |330| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite al numero totale di chiamate a [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) che una sessione può effettuare (predefinito: 200). Quando Claude raggiunge il limite, le ulteriori chiamate a WebSearch restituiscono un avviso che gli indica di continuare con le informazioni già raccolte. Accetta un numero intero positivo senza limite superiore. Qualsiasi altro valore viene ignorato e si applica il valore predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successiva |

329| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Imposta a `1` per avviare i server MCP stdio solo con un ambiente di base sicuro più l'`env` configurato per il server, invece di ereditare l'ambiente della tua shell |331| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Imposta su `1` per avviare i server MCP stdio solo con un ambiente di base sicuro più l'`env` configurato per il server, invece di ereditare l'ambiente della tua shell |

330| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo trascorso in millisecondi prima che una chiamata a uno strumento MCP ancora in esecuzione [passi a un'attività in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) (predefinito: 120000, ovvero 2 minuti). Imposta a `0` per disattivare il passaggio automatico in background. Richiede Claude Code v2.1.212 o successiva |332| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo trascorso in millisecondi prima che una chiamata a uno strumento MCP ancora in esecuzione [passi a un'attività in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) (predefinito: 120000, ovvero 2 minuti). Imposta su `0` per disattivare il passaggio automatico in background. Richiede Claude Code v2.1.212 o successiva |

331| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Per quanto tempo in millisecondi il primo turno di una sessione [non interattiva](/docs/it/headless) attende i server MCP che si stanno ancora connettendo, al posto dell'[attesa del primo turno](/docs/it/agent-sdk/mcp#connection-timing) predefinita. Quando è impostata, l'attesa copre tutti i server in sospeso. Imposta a `0` per saltare l'attesa. Un server [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) mantiene la propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successiva |333| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Per quanti millisecondi il primo turno di una sessione [non interattiva](/docs/it/headless) attende i server MCP che si stanno ancora connettendo, al posto dell'[attesa predefinita del primo turno](/docs/it/agent-sdk/mcp#connection-timing). Quando è impostata, l'attesa riguarda tutti i server in sospeso. Imposta su `0` per saltare l'attesa. Un server [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) mantiene la propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successiva |

332| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout di inattività in millisecondi per le chiamate agli strumenti MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o [connettore claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) non invia alcuna risposta né notifica di avanzamento per questo intervallo, la chiamata allo strumento si interrompe con un errore invece di attendere il `MCP_TOOL_TIMEOUT` complessivo. Sovrascrive i valori predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Imposta a `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono portati a un secondo e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 aumenta la finestra di inattività di quel server ad almeno il valore di `timeout`. Non si applica ai server IDE né ai server SDK in-process. Richiede Claude Code v2.1.187 o successiva. Prima della v2.1.203, i server stdio erano esclusi dal timeout di inattività |334| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout di inattività in millisecondi per le chiamate agli strumenti MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o un [connettore claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) non invia alcuna risposta né alcuna notifica di avanzamento per questo intervallo, la chiamata allo strumento si interrompe con un errore invece di attendere il `MCP_TOOL_TIMEOUT` complessivo. Sovrascrive i valori predefiniti per tipo di trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Imposta su `0` per disattivare il controllo di inattività. I valori inferiori a 1000 vengono portati a un secondo, e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 porta la finestra di inattività di quel server almeno al valore di `timeout`. Non si applica ai server IDE né ai server SDK in-process. Richiede Claude Code v2.1.187 o successiva. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività |

333| `CLAUDE_CODE_MESSAGING_SOCKET` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket inbox](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta il percorso di quel socket verso hook e comandi Bash quando associa il socket. In una sessione che si avvia con la messaggistica attiva, Claude Code associa il socket prima che venga eseguito qualsiasi hook. Le altre sessioni sulla macchina recapitano i messaggi a questo percorso. Ogni sessione esporta il proprio socket invece di uno ereditato da un processo padre, e i messaggi in arrivo su di esso passano attraverso i [controlli in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) della sessione. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.224 o successiva |335| `CLAUDE_CODE_MESSAGING_SOCKET` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket della casella di posta](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta il percorso di quel socket verso gli hook e i comandi Bash quando associa il socket. In una sessione che si avvia con la messaggistica attiva, Claude Code associa il socket prima che venga eseguito qualsiasi hook. Le altre sessioni sulla macchina recapitano i messaggi a questo percorso. Ogni sessione esporta il proprio socket anziché uno ereditato da un processo padre, e i messaggi che vi arrivano passano attraverso i [controlli in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) della sessione. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.224 o successiva |

334| `CLAUDE_CODE_MESSAGING_TOKEN` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket inbox](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta questo token per sessione verso hook e comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che scrive sul socket può inviare `{"type":"auth","token":"<token>"}` come prima riga per dimostrare di appartenere alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non si apra con una riga valida. Le [regole sui processi figli propri](/docs/it/cross-session-messaging#the-sessions-inbox-socket) indicano quando Claude Code consulta il token. Ogni sessione esporta il proprio token, mai uno ereditato da una sessione padre. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.228 o successiva |336| `CLAUDE_CODE_MESSAGING_TOKEN` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket della casella di posta](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta questo token per sessione verso gli hook e i comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che scrive sul socket può inviare `{"type":"auth","token":"<token>"}` come prima riga per dimostrare di appartenere alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non inizi con una riga valida. Le [regole sui processi figli propri](/docs/it/cross-session-messaging#the-sessions-inbox-socket) indicano quando Claude Code consulta il token. Ogni sessione esporta il proprio token, mai uno ereditato da una sessione padre. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.228 o successiva |

335| `CLAUDE_CODE_NATIVE_CURSOR` | Imposta a `1` per mostrare il cursore del terminale in corrispondenza del punto di inserimento invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e focus del terminale |337| `CLAUDE_CODE_NATIVE_CURSOR` | Imposta su `1` per mostrare il cursore nativo del terminale nel punto di inserimento invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggiamento, forma e focus del terminale |

336| `CLAUDE_CODE_NEW_INIT` | Imposta a `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, tra cui CLAUDE.md, skill e hook, prima di esplorare il codebase e scriverli. Senza questa variabile, `/init` genera automaticamente un CLAUDE.md senza chiedere nulla |338| `CLAUDE_CODE_NEW_INIT` | Imposta su `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare il codebase e scriverli. Senza questa variabile, `/init` genera automaticamente un CLAUDE.md senza chiedere nulla |

337| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Imposta a `1` per scrivere l'output del terminale attraverso un secondo file descriptor non bloccante, in modo che un terminale che smette di leggere, come un riquadro tmux in control mode in pausa o una connessione SSH bloccata, non possa bloccare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successiva |339| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Imposta su `1` per scrivere l'output del terminale tramite un secondo file descriptor non bloccante, in modo che un terminale che smette di leggere, come un riquadro tmux in control mode in pausa o una connessione SSH bloccata, non possa bloccare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successiva |

338| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quante volte Claude Code invia di nuovo una [richiesta non in streaming](/docs/it/errors#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Con `0`, la richiesta fallisce al primo timeout. Non impostata per impostazione predefinita, quindi è `CLAUDE_CODE_MAX_RETRIES` a limitare questi nuovi invii. Vedi [Regolare il comportamento dei nuovi tentativi](/docs/it/errors#tune-retry-behavior) per il timeout. Richiede Claude Code v2.1.285 o successiva |340| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quante volte Claude Code reinvia una [richiesta non in streaming](/docs/it/errors#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Con `0`, la richiesta fallisce al primo timeout. Non impostata per impostazione predefinita, quindi è `CLAUDE_CODE_MAX_RETRIES` a limitare questi reinvii. Consulta [Regolare il comportamento dei nuovi tentativi](/docs/it/errors#tune-retry-behavior) per il timeout. Richiede Claude Code v2.1.285 o successiva |

339| `CLAUDE_CODE_NO_FLICKER` | Imposta a `1` per abilitare il [rendering a schermo intero](/docs/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene stabile la memoria nelle conversazioni lunghe. Sovrascrive l'impostazione [`tui`](/docs/it/settings-reference#tui); puoi anche passarvi con `/tui fullscreen` |341| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per attivare il [rendering a schermo intero](/docs/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene costante l'uso della memoria nelle conversazioni lunghe. Sovrascrive l'impostazione [`tui`](/docs/it/settings-reference#tui); puoi anche passare a questa modalità con `/tui fullscreen` |

340| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token di aggiornamento OAuth per l'autenticazione Claude.ai. Quando è impostato, `claude auth login` scambia direttamente questo token invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell'autenticazione in ambienti automatizzati |342| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token di aggiornamento OAuth per l'autenticazione Claude.ai. Quando è impostata, `claude auth login` scambia direttamente questo token invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per predisporre l'autenticazione in ambienti automatizzati |

341| `CLAUDE_CODE_OAUTH_SCOPES` | Scope OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatoria quando è impostata `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |343| `CLAUDE_CODE_OAUTH_SCOPES` | Scope OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatoria quando è impostata `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

342| `CLAUDE_CODE_OAUTH_TOKEN` | Token di accesso OAuth per l'autenticazione claude.ai. Alternativa a `/login` per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali memorizzate nel portachiavi. Generane uno con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token). A meno che tu non esegua [`/login`](/docs/it/authentication#authentication-precedence), Claude Code usa il token impostato per l'intera sessione. Per sostituire un token scaduto, generane uno nuovo e riavvia |344| `CLAUDE_CODE_OAUTH_TOKEN` | Token di accesso OAuth per l'autenticazione claude.ai. Alternativa a `/login` per l'SDK e gli ambienti automatizzati. Ha la precedenza sulle credenziali memorizzate nel portachiavi. Generane uno con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token). A meno che tu non esegua [`/login`](/docs/it/authentication#authentication-precedence), Claude Code usa il token che hai impostato per l'intera sessione. Per sostituire un token scaduto, generane uno nuovo e riavvia |

343| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Rimossa nella v2.1.160 e ora senza effetto. In precedenza fissava la [modalità veloce](/docs/it/fast-mode) su Claude Opus 4.6 invece del valore predefinito attuale. Opus 4.6 non supporta più la modalità veloce |345| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Rimossa nella v2.1.160 e ora non ha alcun effetto. In precedenza fissava la [modalità veloce](/docs/it/fast-mode) su Claude Opus 4.6 invece che sul modello predefinito corrente. Opus 4.6 non supporta più la modalità veloce |

344| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Lunghezza massima degli attributi OpenTelemetry che trasportano contenuti (risposte del modello, contenuti degli strumenti, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, ovvero 60 KB). Aumentala solo se il tuo backend di telemetria accetta valori di attributo superiori a 64 KB, oppure riducila per diminuire il volume di telemetria. Richiede Claude Code v2.1.214 o successiva. Vedi [Monitoraggio](/docs/it/monitoring-usage) |346| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Lunghezza massima degli attributi OpenTelemetry che contengono contenuti (risposte del modello, contenuti degli strumenti, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, cioè 60 KB). Aumentala solo se il tuo backend di telemetria accetta valori di attributo superiori a 64 KB, oppure riducila per diminuire il volume della telemetria. Richiede Claude Code v2.1.214 o successiva. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

345| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Imposta a `1` per scrivere su stderr gli errori diagnostici degli exporter OpenTelemetry. Per impostazione predefinita questi errori compaiono solo con `--debug`, quindi un exporter configurato in modo errato, ad esempio per una collisione di porta di Prometheus, altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successiva. Vedi [Monitoraggio](/docs/it/monitoring-usage) |347| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Imposta su `1` per scrivere su stderr gli errori diagnostici dell'exporter OpenTelemetry. Per impostazione predefinita questi errori compaiono solo con `--debug`, quindi un exporter configurato in modo errato, ad esempio con una collisione sulla porta di Prometheus, altrimenti fallisce in modo silenzioso. Richiede Claude Code v2.1.179 o successiva. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

346| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo svuotamento degli span OpenTelemetry in sospeso (predefinito: 5000). Vedi [Monitoraggio](/docs/it/monitoring-usage) |348| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo svuotamento degli span OpenTelemetry in sospeso (predefinito: 5000). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

347| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo per l'aggiornamento degli header OpenTelemetry dinamici in millisecondi (predefinito: 1740000 / 29 minuti). Vedi [Header dinamici](/docs/it/monitoring-usage#dynamic-headers) |349| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo in millisecondi per l'aggiornamento degli header OpenTelemetry dinamici (predefinito: 1740000 / 29 minuti). Consulta [Header dinamici](/docs/it/monitoring-usage#dynamic-headers) |

348| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi entro cui l'exporter OpenTelemetry deve terminare all'arresto (predefinito: 2000). Aumentalo se le metriche vengono perse all'uscita. Vedi [Monitoraggio](/docs/it/monitoring-usage) |350| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi entro cui l'exporter OpenTelemetry deve terminare alla chiusura (predefinito: 2000). Aumentalo se le metriche vengono perse all'uscita. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

349| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Imposta a `1` per consentire a Claude Code di eseguire in background il comando di aggiornamento del tuo gestore di pacchetti quando è disponibile una nuova versione. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedi [Aggiornamenti automatici](/docs/it/setup#auto-updates) |351| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Imposta su `1` per consentire a Claude Code di eseguire in background il comando di aggiornamento del tuo package manager quando è disponibile una nuova versione. Si applica alle installazioni tramite Homebrew e WinGet. Gli altri package manager continuano a mostrare il comando di aggiornamento senza eseguirlo. Consulta [Aggiornamenti automatici](/docs/it/setup#auto-updates) |

350| `CLAUDE_CODE_PERFORCE_MODE` | Imposta a `1` per abilitare la protezione in scrittura compatibile con Perforce. Quando è impostata, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione non ha il bit di scrittura del proprietario, che Perforce rimuove dai file sincronizzati finché `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento delle modifiche di Perforce |352| `CLAUDE_CODE_PERFORCE_MODE` | Imposta su `1` per attivare la protezione in scrittura compatibile con Perforce. Quando è impostata, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione non ha il bit di scrittura per il proprietario, che Perforce rimuove dai file sincronizzati finché `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento delle modifiche di Perforce |

351| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sovrascrive la directory radice dei plugin. Nonostante il nome, imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory di questo percorso. Predefinito: `~/.claude/plugins` |353| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sovrascrive la directory radice dei plugin. Nonostante il nome, imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory di questo percorso. Il valore predefinito è `~/.claude/plugins` |

352| `CLAUDE_CODE_PLUGIN_DIRS` | Directory dei plugin da caricare per la sessione, ognuna caricata nel modo in cui la caricherebbe un flag [`--plugin-dir`](/docs/it/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Separa più percorsi con `:` su Unix o `;` su Windows. Indica ogni percorso come percorso assoluto o fallo iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successiva. Vedi [Caricare un plugin per una sessione](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) |354| `CLAUDE_CODE_PLUGIN_DIRS` | Directory dei plugin da caricare per la sessione, ciascuna caricata come la caricherebbe un flag [`--plugin-dir`](/docs/it/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Separa più percorsi con `:` su Unix o `;` su Windows. Indica ogni percorso come percorso assoluto o fallo iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successiva. Consulta [Caricare un plugin per una sola sessione](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) |

353| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per la clonazione o l'aggiornamento di un marketplace di plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Vedi [Git clone timed out](/docs/it/plugins/troubleshooting#git-clone-timed-out-after-120s) |355| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per la clonazione o l'aggiornamento di un marketplace di plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Consulta [Git clone timed out](/docs/it/plugins/troubleshooting#git-clone-timed-out-after-120s) |

354| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Imposta a `1` per saltare il tentativo di nuova clonazione e continuare a usare il checkout esistente del marketplace quando un aggiornamento del marketplace non riesce a raggiungere il remoto o ad autenticarsi. Utile in ambienti offline o air-gapped in cui una nuova clonazione fallirebbe allo stesso modo. Vedi [Gli aggiornamenti del marketplace non riescono in ambienti offline](/docs/it/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |356| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Imposta su `1` per saltare il tentativo di nuova clonazione e continuare a usare il checkout esistente del marketplace quando un aggiornamento del marketplace non riesce a raggiungere il remoto o ad autenticarsi. Utile in ambienti offline o air-gapped in cui una nuova clonazione fallirebbe allo stesso modo. Consulta [Gli aggiornamenti del marketplace falliscono negli ambienti offline](/docs/it/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

355| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta a `1` per clonare le sorgenti in forma abbreviata GitHub `owner/repo` tramite HTTPS invece che SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare tramite HTTPS anziché SSH le sorgenti GitHub in forma abbreviata `owner/repo`. Si applica all'installazione e all'aggiornamento dei plugin, nonché a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |

356| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso di una o più directory seed dei plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Usala per includere una directory dei plugin prepopolata in un'immagine container. Claude Code registra i marketplace da queste directory all'avvio e usa i plugin già in cache senza clonarli di nuovo. Vedi [Prepopolare i plugin per i container](/docs/it/plugins/org#seed-containers-and-ci) |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso di una o più directory seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Usala per includere in un'immagine container una directory di plugin prepopolata. Claude Code registra i marketplace da queste directory all'avvio e usa i plugin già presenti nella cache senza clonarli di nuovo. Consulta [Prepopolare i plugin per i container](/docs/it/plugins/org#seed-containers-and-ci) |

357| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Imposta a `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando avvia PowerShell per chiamate agli strumenti, hook e comandi della riga di stato, rispettando invece l'execution policy effettiva della macchina. Per impostazione predefinita Claude Code aggira l'execution policy a livello di processo, in modo che gli script `.ps1` e le importazioni di moduli funzionino sulle installazioni Windows con il valore predefinito Restricted. Il bypass a livello di processo non sovrascrive mai i Criteri di gruppo `MachinePolicy` o `UserPolicy`, indipendentemente da questa impostazione |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Imposta su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando avvia PowerShell per le chiamate agli strumenti, gli hook e i comandi della riga di stato, rispettando invece la execution policy effettiva della macchina. Per impostazione predefinita Claude Code aggira la execution policy a livello di processo, in modo che gli script `.ps1` e le importazioni di moduli funzionino nelle installazioni di Windows con il valore predefinito Restricted. L'aggiramento a livello di processo non sovrascrive mai le Group Policy `MachinePolicy` o `UserPolicy`, indipendentemente da questa impostazione |

358| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Tetto in millisecondi per l'attesa inattiva di subagent e workflow in background dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude esegue un turno per gestire un risultato in background. Predefinito: `600000`, ovvero 10 minuti. Quando l'attesa inattiva raggiunge il tetto, Claude Code smette di attendere le attività in background rimanenti ed esce. Imposta a `0` per attendere indefinitamente. Questo limite è separato dal periodo di tolleranza di cinque secondi che si applica alle semplici shell in background. Richiede Claude Code v2.1.182 o successiva |360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite massimo in millisecondi per l'attesa inattiva dei subagent e dei workflow in background dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude esegue un turno per gestire un risultato in background. Predefinito: `600000`, ovvero 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di attendere le attività in background rimanenti ed esce. Imposta su `0` per attendere indefinitamente. Questo limite è separato dal periodo di tolleranza di cinque secondi che si applica alle semplici shell in background. Richiede Claude Code v2.1.182 o successiva |

359| `CLAUDE_CODE_PROCESS_WRAPPER` | Avvia i processi che Claude Code lancia dal proprio binario, come il servizio in background che ospita le sessioni di [agent view](/docs/it/agent-view), tramite un launcher aziendale indicato come prefisso argv, ad esempio `/opt/corp/launcher`. Impostala nel blocco `env` delle impostazioni utente o delle [impostazioni gestite](/docs/it/managed-settings), non come export della shell, in modo che il servizio in background scollegato la erediti; le impostazioni di progetto e locali non possono impostarla. Equivale all'[impostazione `processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successiva; questa variabile ha la precedenza quando sono impostate entrambe. L'estensione VS Code configura il proprio launcher separatamente tramite la sua impostazione `claudeProcessWrapper`. Ignorata su Windows. Vedi [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, ciò che il launcher copre e il contratto che il launcher deve rispettare. Richiede Claude Code v2.1.208 o successiva |361| `CLAUDE_CODE_PROCESS_WRAPPER` | Avvia i processi che Claude Code lancia dal proprio binario, come il servizio in background che ospita le sessioni di [agent view](/docs/it/agent-view), tramite un launcher aziendale indicato come prefisso argv, ad esempio `/opt/corp/launcher`. Impostala nel blocco `env` delle impostazioni utente o delle [impostazioni gestite](/docs/it/managed-settings), non come export della shell, in modo che il servizio in background scollegato la erediti; le impostazioni di progetto e locali non possono impostarla. Equivale all'[impostazione `processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successiva; questa variabile ha la precedenza quando sono impostate entrambe. L'estensione VS Code configura il proprio launcher separatamente tramite la sua impostazione `claudeProcessWrapper`. Ignorata su Windows. Consulta [Eseguire Claude Code tramite un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, ciò che il launcher copre e i requisiti che il launcher deve soddisfare. Richiede Claude Code v2.1.208 o successiva |

360| `CLAUDE_CODE_PROJECT_DIR_NAME` | Impostala insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory in `projects/` in cui Claude Code memorizza le trascrizioni e la memoria automatica di quella sessione, al posto di uno derivato dal percorso della directory di lavoro. Ad esempio, avviando Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` le memorizza in `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostata, e la legge solo dall'ambiente da cui avvii `claude`, mai da un [blocco `env` di un file di impostazioni](#in-settings-files). Vedi [Assegnare tu il nome alla directory del progetto](/docs/it/sessions#name-the-project-directory-yourself). Richiede Claude Code v2.1.234 o successiva |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | Impostala insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory in `projects/` in cui Claude Code archivia le trascrizioni e la memoria automatica di quella sessione, al posto di un nome derivato dal percorso della directory di lavoro. Ad esempio, avviare Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` le archivia in `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostata, e la legge solo dall'ambiente da cui avvii `claude`, mai dal [blocco `env` di un file di impostazioni](#in-settings-files). Consulta [Assegnare tu il nome alla directory del progetto](/docs/it/sessions#name-the-project-directory-yourself). Richiede Claude Code v2.1.234 o successiva |

361| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache dei prompt](/docs/it/prompt-caching#cache-lifetime) per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper che vengono eseguiti in linea con essi. Ha la precedenza sull'impostazione `promptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L'API fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache dei prompt](/docs/it/prompt-caching#cache-lifetime) per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper che vengono eseguiti in linea con essi. Ha la precedenza sull'impostazione `promptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` ha la precedenza su di essa. L'API addebita le scritture nella cache di 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |

362| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Imposta a `1` per propagare il trace context W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione riguarda l'header `traceparent` nelle richieste al modello e MCP HTTP e la variabile d'ambiente `TRACEPARENT` per i sottoprocessi Bash, PowerShell e degli hook. Per impostazione predefinita, la propagazione è abilitata solo con connessione diretta all'API Anthropic. Aggiunta nella v2.1.152. Vedi [Tracce (beta)](/docs/it/monitoring-usage#traces-beta) |364| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Imposta su `1` per propagare il contesto di tracciamento W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione riguarda l'header `traceparent` sulle richieste al modello e sulle richieste MCP HTTP, e la variabile d'ambiente `TRACEPARENT` per i sottoprocessi di Bash, PowerShell e degli hook. Per impostazione predefinita, la propagazione è attiva solo quando la connessione è diretta all'API di Anthropic. Aggiunta nella v2.1.152. Consulta [Trace (beta)](/docs/it/monitoring-usage#traces-beta) |

363| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostata dalle piattaforme host che incorporano Claude Code e gestiscono per suo conto l'instradamento del provider del modello. Quando è impostata, Claude Code ignora le variabili di selezione del provider, di endpoint e di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni, così le impostazioni utente non possono sovrascrivere l'instradamento dell'host. Claude Code ignora inoltre le chiavi di selezione del modello come `model`, `fallbackModel` e `modelOverrides` nelle [impostazioni gestite](/docs/it/managed-settings), qualunque sia la fonte gestita che le distribuisce, così la configurazione del modello dell'host ha la precedenza su un modello fissato nelle impostazioni gestite e non aggiornato. Claude Code ignora inoltre le variabili di selezione del modello come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL` in un blocco `env` gestito; un'allowlist [`availableModels`](/docs/it/model-config#restrict-model-selection) nelle impostazioni gestite si applica comunque, a meno che l'host non ne fornisca una propria. Claude Code salta inoltre la disattivazione automatica della telemetria che altrimenti applica sui provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Agent Platform di Google Cloud e Microsoft Foundry, quindi la telemetria segue la disattivazione standard tramite `DISABLE_TELEMETRY`. Vedi [Comportamenti predefiniti per provider API](/docs/it/data-usage#default-behaviors-by-api-provider) |365| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostata dalle piattaforme host che incorporano Claude Code e gestiscono per suo conto l'instradamento verso il provider del modello. Quando è impostata, Claude Code ignora le variabili di selezione del provider, di endpoint e di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni, in modo che le impostazioni utente non possano sovrascrivere l'instradamento dell'host. Claude Code ignora anche le chiavi di selezione del modello come `model`, `fallbackModel` e `modelOverrides` nelle [impostazioni gestite](/docs/it/managed-settings), qualunque sia la sorgente gestita che le fornisce, in modo che la configurazione del modello dell'host abbia la precedenza su un modello fissato obsoleto nelle impostazioni gestite. Claude Code ignora inoltre le variabili di selezione del modello come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL` in un blocco `env` gestito; un'allowlist [`availableModels`](/docs/it/model-config#restrict-model-selection) nelle impostazioni gestite si applica comunque, a meno che l'host non ne fornisca una propria. Claude Code salta inoltre la disattivazione automatica della telemetria che altrimenti applica sui provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Agent Platform di Google Cloud e Microsoft Foundry, quindi la telemetria segue la disattivazione standard tramite `DISABLE_TELEMETRY`. Consulta [Comportamenti predefiniti per provider API](/docs/it/data-usage#default-behaviors-by-api-provider) |

364| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Imposta a `1` per consentire al proxy di eseguire la risoluzione DNS al posto del chiamante. Opzione facoltativa per ambienti in cui il proxy deve gestire la risoluzione dei nomi host |366| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Imposta su `1` per consentire al proxy di eseguire la risoluzione DNS al posto del chiamante. Attivazione facoltativa per gli ambienti in cui il proxy deve gestire la risoluzione dei nomi host |

365| `CLAUDE_CODE_REMOTE` | Impostata automaticamente a `true` quando Claude Code è in esecuzione come [sessione cloud](/docs/it/claude-code-on-the-web). Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud |367| `CLAUDE_CODE_REMOTE` | Impostata automaticamente su `true` quando Claude Code è in esecuzione come [sessione cloud](/docs/it/claude-code-on-the-web). Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud |

366| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostata automaticamente nelle [sessioni cloud](/docs/it/claude-code-on-the-web) sull'ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Vedi [Collegare l'output alla sessione](/docs/it/cloud-environments#link-output-back-to-the-session) |368| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostata automaticamente nelle [sessioni cloud](/docs/it/claude-code-on-the-web) sull'ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Consulta [Collegare l'output alla sessione](/docs/it/cloud-environments#link-output-back-to-the-session) |

367| `CLAUDE_CODE_RESTRICTED` | Imposta a `1` per avviare la sessione in modalità limitata, come se passassi [`--restricted`](/docs/it/cli-reference#cli-flags). Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.248 o successiva |369| `CLAUDE_CODE_RESTRICTED` | Imposta su `1` per avviare la sessione in modalità con restrizioni, come se passassi [`--restricted`](/docs/it/cli-reference#cli-flags). Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.248 o successiva |

368| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Imposta a `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Usata in modalità SDK affinché il modello continui senza che l'SDK debba inviare di nuovo il prompt. Per disattivarla, rimuovi la variabile o impostala a `0`. Per il pannello chat di VS Code, vedi [Continuare le conversazioni dopo un ricaricamento](/docs/it/vs-code#continue-conversations-after-a-reload) |370| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Imposta su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Usata in modalità SDK affinché il modello continui senza che l'SDK debba reinviare il prompt. Per disattivarla, rimuovi la variabile o impostala su `0`. Per il pannello chat di VS Code, consulta [Continuare le conversazioni dopo un ricaricamento](/docs/it/vs-code#continue-conversations-after-a-reload) |

369| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione terminata a metà turno continui automaticamente alla ripresa. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e il relativo messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT`, e la sessione si avvia inattiva in modo che tu prosegua esplicitamente. Non impostata o `0` significa nessun limite, tranne per il fatto che un turno la cui ultima richiesta è fallita con un errore API riprende solo se tale errore risale a meno di sei ore prima. Un valore positivo limita ogni turno, inclusi questi; un valore negativo o non numerico applica un limite di un'ora. Gli script di avvio per agenti a lunga esecuzione possono impostarla affinché un riavvio su una vecchia trascrizione non riesegua un prompt obsoleto. Claude Code imposta autonomamente un limite di un'ora quando riavvia una sessione di [agent view](/docs/it/agent-view) andata in crash che ha ereditato la propria conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successiva |371| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione terminata a metà turno continui automaticamente alla ripresa. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e il relativo messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT`, e la sessione si avvia inattiva in modo che tu continui esplicitamente. Se non è impostata o vale `0` non c'è alcun limite, tranne per il fatto che un turno la cui ultima richiesta è fallita con un errore API riprende solo se quell'errore risale a meno di sei ore prima. Un valore positivo limita ogni turno, compresi quelli; un valore negativo o non numerico applica un limite di un'ora. Gli script di avvio per agenti a lunga esecuzione possono impostarla in modo che un riavvio su una trascrizione vecchia non riesegua un prompt obsoleto. Claude Code imposta autonomamente un limite di un'ora quando riavvia una sessione di [agent view](/docs/it/agent-view) andata in crash che ha ereditato la conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successiva |

370| `CLAUDE_CODE_RESUME_PROMPT` | Sovrascrive il messaggio di continuazione che Claude Code invia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` prosegue un turno interrotto invece di inviare di nuovo il suo prompt, oppure quando riprendi una [chiamata a uno strumento differita](/docs/it/hooks#defer-a-tool-call-for-later) con `-p`. Predefinito: `Continue from where you left off.`. Una stringa vuota usa il valore predefinito |372| `CLAUDE_CODE_RESUME_PROMPT` | Sovrascrive il messaggio di continuazione che Claude Code invia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua un turno interrotto invece di reinviarne il prompt, o quando riprendi una [chiamata a uno strumento rinviata](/docs/it/hooks#defer-a-tool-call-for-later) con `-p`. Il valore predefinito è `Continue from where you left off.`. Una stringa vuota usa il valore predefinito |

371| `CLAUDE_CODE_RETRY_WATCHDOG` | Imposta a `1` per le sessioni non presidiate come harness di valutazione, job CI o worker remoti. Riprova indefinitamente in caso di errori di capacità `429` e `529` invece di fallire dopo `CLAUDE_CODE_MAX_RETRIES` tentativi. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche se proviene da un [limite di spesa del gateway](/docs/it/errors#spend-limit-reached) che si reimposta secondo una pianificazione. Prima della v2.1.239, il watchdog riprovava indefinitamente in questi casi. Per le richieste in modalità veloce, vedi [Gestire i rate limit](/docs/it/fast-mode#handle-rate-limits). Il watchdog attende fino a 5 minuti tra un tentativo e l'altro, oppure fino al ripristino del limite quando la risposta riporta un orario di ripristino del rate limit, così una sessione che raggiunge un limite di utilizzo attende la fine della finestra rimanente. Nella v2.1.199 o successiva aumenta inoltre a 300 il numero predefinito di nuovi tentativi per altri errori transitori, come errori del server, timeout e connessioni interrotte, pari a circa tre ore di backoff, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successiva |373| `CLAUDE_CODE_RETRY_WATCHDOG` | Imposta su `1` per le sessioni non presidiate come harness di valutazione, job CI o worker remoti. Riprova indefinitamente in caso di errori di capacità `429` e `529` invece di fallire dopo `CLAUDE_CODE_MAX_RETRIES` tentativi. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche se proviene da un [limite di spesa del gateway](/docs/it/errors#spend-limit-reached) che si azzera secondo una pianificazione. Prima della v2.1.239, il watchdog riprovava indefinitamente anche in questi casi. Per le richieste in modalità veloce, consulta [Gestire i rate limit](/docs/it/fast-mode#handle-rate-limits). Il watchdog attende fino a 5 minuti tra un tentativo e l'altro, oppure fino all'azzeramento del limite quando la risposta contiene un orario di azzeramento del rate limit, quindi una sessione che raggiunge un limite di utilizzo attende la fine della finestra rimanente. Nella v2.1.199 o successiva aumenta anche a 300 il numero predefinito di nuovi tentativi per altri errori transitori, come errori del server, timeout e connessioni interrotte, pari a circa tre ore di backoff, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successiva |

372| `CLAUDE_CODE_SAFE_MODE` | Imposta a `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi e agenti personalizzati, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della riga di stato e di suggerimento dei file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione non funzionante. La policy delle impostazioni gestite si applica comunque, inclusi hook, riga di stato e comandi di suggerimento dei file configurati tramite policy; plugin gestiti, skill gestite, CLAUDE.md gestito e server MCP configurati tramite policy no. Equivale a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figli generati direttamente ereditano la variabile |374| `CLAUDE_CODE_SAFE_MODE` | Imposta su `1` per avviare in modalità provvisoria: CLAUDE.md, skill, plugin, hook, server MCP, comandi e agenti personalizzati, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della riga di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione danneggiata. La policy delle impostazioni gestite si applica comunque, inclusi gli hook, la riga di stato e i comandi dei suggerimenti di file configurati dalla policy; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla policy invece no. Equivale a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figli avviati direttamente ereditano la variabile |

373| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando è impostata `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Le chiavi sono sottostringhe confrontate con il testo del comando; i valori sono limiti interi di chiamate. Ad esempio, `{"deploy.sh": 2}` consente di chiamare `deploy.sh` al massimo due volte. La corrispondenza è basata su sottostringhe, quindi trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` vengono comunque conteggiati nel limite. Il fan-out a runtime tramite `xargs` o `find -exec` non viene rilevato; si tratta di un controllo di difesa in profondità |375| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando è impostata `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Le chiavi sono sottostringhe confrontate con il testo del comando; i valori sono limiti interi di chiamate. Ad esempio, `{"deploy.sh": 2}` consente di chiamare `deploy.sh` al massimo due volte. La corrispondenza si basa sulle sottostringhe, quindi trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` vengono comunque conteggiati nel limite. Le diramazioni a runtime tramite `xargs` o `find -exec` non vengono rilevate; si tratta di un controllo di difesa in profondità |

374| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato di trackpad e rotella nei terminali che già amplificano gli eventi della rotella. Imposta a `3` per allinearti a `vim` se il tuo terminale invia un evento di rotella per scatto senza amplificazione. Ignorata nel terminale degli IDE JetBrains, dove Claude Code usa la propria gestione dello scorrimento |376| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5`, per rallentare lo scorrimento accelerato del trackpad e della rotella nei terminali che già amplificano gli eventi della rotella. Imposta su `3` per allinearti a `vim` se il tuo terminale invia un evento della rotella per ogni scatto senza amplificazione. Ignorata nel terminale degli IDE JetBrains, dove Claude Code usa una propria gestione dello scorrimento |

375| `CLAUDE_CODE_SEND_FEEDBACK` | Imposta a `0` per disattivare il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) per una sessione. Imposta a `1` per attivarlo dove il tuo account ha già accesso; la variabile non può concedere l'accesso da sola, e gli altri interruttori che disattivano il feedback, come `DISABLE_FEEDBACK_COMMAND` e il valore `off` dell'impostazione [`feedbackDrafts`](/docs/it/settings-reference#feedbackdrafts), si applicano comunque |377| `CLAUDE_CODE_SEND_FEEDBACK` | Imposta su `0` per disattivare il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) per una sessione. Imposta su `1` per attivarlo dove il tuo account ha già accesso; la variabile non può concedere l'accesso di per sé, e gli altri interruttori che disattivano il feedback, come `DISABLE_FEEDBACK_COMMAND` e il valore `off` dell'impostazione [`feedbackDrafts`](/docs/it/settings-reference#feedbackdrafts), si applicano comunque |

376| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sovrascrive il budget di tempo in millisecondi per gli hook [SessionEnd](/docs/it/hooks#sessionend). Il valore è anche il timeout per ogni hook che non imposta un proprio `timeout`. Si applica all'uscita dalla sessione, a `/clear` e al cambio di sessione tramite `/resume` interattivo. Per impostazione predefinita il budget è di 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout degli hook forniti dai plugin non aumentano il budget |378| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sovrascrive il tempo disponibile in millisecondi per gli hook [SessionEnd](/docs/it/hooks#sessionend). Il valore è anche il timeout di ogni hook che non imposta un proprio `timeout`. Si applica all'uscita dalla sessione, a `/clear` e al cambio di sessione tramite `/resume` interattivo. Per impostazione predefinita il tempo disponibile è di 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout degli hook forniti dai plugin non aumentano il tempo disponibile |

377| `CLAUDE_CODE_SESSION_ID` | Impostata automaticamente sull'ID della sessione corrente nei sottoprocessi degli strumenti Bash e PowerShell, nei sottoprocessi dei [comandi hook](/docs/it/hooks) e nei sottoprocessi dei [server MCP](/docs/it/mcp) stdio. Per Bash, PowerShell e gli hook corrisponde al campo `session_id` nell'input JSON degli hook e viene aggiornata con `/clear`. Un sottoprocesso di server MCP mantiene l'ID con cui è stato avviato. Con `--resume <session-id>` riceve l'ID ripreso, in linea con hook e Bash. Con `--continue` o `--resume` senza un ID esplicito potrebbe ricevere invece l'ID iniziale di avvio. Usala per correlare script e strumenti esterni con la sessione di Claude Code che li ha avviati |379| `CLAUDE_CODE_SESSION_ID` | Impostata automaticamente sull'ID della sessione corrente nei sottoprocessi degli strumenti Bash e PowerShell, nei sottoprocessi dei [comandi hook](/docs/it/hooks) e nei sottoprocessi dei [server MCP](/docs/it/mcp) stdio. Per Bash, PowerShell e gli hook corrisponde al campo `session_id` nell'input JSON degli hook e viene aggiornata con `/clear`. Un sottoprocesso di un server MCP mantiene l'ID con cui è stato avviato. Con `--resume <session-id>` riceve l'ID ripreso, come gli hook e Bash. Con `--continue` o `--resume` senza un ID esplicito può ricevere invece l'ID dell'avvio iniziale. Usala per correlare script e strumenti esterni con la sessione di Claude Code che li ha avviati |

378| `CLAUDE_CODE_SHELL` | Imposta la shell che Claude Code usa per eseguire i comandi dello strumento Bash. Accetta un percorso a un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e ripiega sul rilevamento automatico. Il rilevamento automatico usa il tuo `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` e poi `bash` funzionante trovato nel tuo `PATH` e nei percorsi di installazione standard |380| `CLAUDE_CODE_SHELL` | Imposta la shell che Claude Code usa per eseguire i comandi dello strumento Bash. Accetta il percorso di un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e ripiega sul rilevamento automatico. Il rilevamento automatico usa il tuo `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` funzionante e poi il primo `bash` trovati nel tuo `PATH` e nei percorsi di installazione standard |

379| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso di comando che racchiude i comandi di shell avviati da Claude Code: chiamate allo strumento Bash, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline) e comandi di avvio dei [server MCP](/docs/it/mcp) stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per logging o audit. Impostare un semplice percorso di eseguibile come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come un singolo argomento quotato per la shell in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un semplice percorso di eseguibile compromette i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate allo strumento Bash, `$1` contiene l'intera invocazione della shell assemblata da Claude Code, inclusa la configurazione dell'ambiente, non solo il comando eseguito da Claude |381| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso di comando che racchiude i comandi di shell avviati da Claude Code: chiamate allo strumento Bash, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline) e comandi di avvio dei [server MCP](/docs/it/mcp) stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per il logging o l'audit. Impostare un semplice percorso di eseguibile come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come singolo argomento tra virgolette di shell in `$1`, quindi deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un semplice percorso di eseguibile impedisce il funzionamento dei server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate allo strumento Bash, `$1` contiene l'intera invocazione di shell assemblata da Claude Code, inclusa la configurazione dell'ambiente, non solo il comando eseguito da Claude |

380| `CLAUDE_CODE_SIMPLE` | Imposta a `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura file e modifica file. Gli strumenti MCP da `--mcp-config` restano disponibili. Disabilita il rilevamento automatico di hook, skill, comandi personalizzati, subagent, plugin installati, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory passata con `--add-dir` vengono comunque caricate. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l'autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivale a passare [`--bare`](/docs/it/headless#start-faster-with-bare-mode) |382| `CLAUDE_CODE_SIMPLE` | Imposta su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, di lettura file e di modifica file. Gli strumenti MCP provenienti da `--mcp-config` restano disponibili. Disattiva il rilevamento automatico di hook, skill, comandi personalizzati, subagent, plugin installati, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory che passi con `--add-dir` vengono comunque caricate. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l'autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivale a passare [`--bare`](/docs/it/headless#start-faster-with-bare-mode) |

381| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Imposta a `1` per usare un prompt di sistema più breve e descrizioni degli strumenti abbreviate su qualsiasi modello. Imposta a `0`, `false`, `no` o `off` per disattivarlo anche sui modelli in cui l'esperimento o la configurazione del server lo abiliterebbero altrimenti. Il set completo di strumenti, gli hook, i server MCP e il rilevamento di CLAUDE.md restano abilitati |383| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Imposta su `1` per usare un prompt di sistema più breve e descrizioni abbreviate degli strumenti su qualsiasi modello. Imposta su `0`, `false`, `no` o `off` per disattivarla anche sui modelli in cui l'esperimento o la configurazione del server la attiverebbero altrimenti. L'intero set di strumenti, gli hook, i server MCP e il rilevamento di CLAUDE.md restano attivi |

382| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Salta l'autenticazione lato client per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), per i gateway che firmano le richieste autonomamente |384| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Salta l'autenticazione lato client per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), per i gateway che firmano autonomamente le richieste |

383| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Imposta a `1` per disattivare la cache in-process delle credenziali risolte dalla catena predefinita di provider di credenziali AWS, così Claude Code risolve la catena a ogni richiesta API. Con la cache disattivata, un profilo basato su SSO richiede le credenziali a IAM Identity Center a ogni richiesta. Vedi [memorizzazione nella cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successiva |385| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Imposta su `1` per disattivare la cache in-process delle credenziali risolte dalla catena predefinita di provider di credenziali AWS, in modo che Claude Code risolva la catena a ogni richiesta API. Con la cache disattivata, un profilo basato su SSO richiede le credenziali a IAM Identity Center a ogni richiesta. Consulta [memorizzazione nella cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successiva |

384| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock (ad esempio, quando si usa un gateway LLM) |386| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock (ad esempio, quando usi un gateway LLM) |

385| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Imposta a `1` per considerare disponibile una verifica di disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) non riuscita, per le reti che bloccano la richiesta diretta della verifica a `api.anthropic.com`. Claude Code rispetta comunque una risposta "disabled by your organization" |387| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Imposta su `1` per considerare disponibile la [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) quando il controllo di disponibilità fallisce, per le reti che bloccano la richiesta diretta del controllo verso `api.anthropic.com`. Claude Code rispetta comunque una risposta "disabled by your organization" |

386| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Imposta a `1` per saltare la verifica lato client della disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), per i proxy che intercettano la richiesta della verifica invece di rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la tua organizzazione ha disabilitato la modalità veloce |388| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Imposta su `1` per saltare il controllo lato client della disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), per i proxy che intercettano la richiesta del controllo anziché rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la tua organizzazione ha disattivato la modalità veloce |

387| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Salta l'autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inserisce il proprio header `Authorization`. Claude Code invia le richieste senza una credenziale Azure e mantiene l'header `Authorization` che fornisci, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorata quando è impostata `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. Prima della v2.1.203, questa variabile impediva al client Microsoft Foundry di inviare richieste a meno che non fosse impostata anche una chiave API |389| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Salta l'autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inserisce un proprio header `Authorization`. Claude Code invia le richieste senza una credenziale Azure e preserva l'header `Authorization` che fornisci, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorata quando è impostata `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. Prima della v2.1.203, questa variabile impediva al client Microsoft Foundry di inviare richieste a meno che non fosse impostata anche una chiave API |

388| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando si usa un gateway LLM) |390| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando usi un gateway LLM) |

389| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | I [controlli dei modelli all'avvio](/docs/it/amazon-bedrock#startup-model-checks) su [Amazon Bedrock](/docs/it/amazon-bedrock) e [Agent Platform di Google Cloud](/docs/it/google-vertex-ai) memorizzano su questa macchina, per un massimo di un giorno, quali modelli hanno rilevato che il tuo account non può invocare. Imposta a `1` per disattivare questa memorizzazione. Richiede Claude Code v2.1.285 o successiva |391| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | I [controlli dei modelli all'avvio](/docs/it/amazon-bedrock#startup-model-checks) su [Amazon Bedrock](/docs/it/amazon-bedrock) e [Agent Platform di Google Cloud](/docs/it/google-vertex-ai) memorizzano su questa macchina, per un massimo di un giorno, quali modelli hanno rilevato che il tuo account non può invocare. Imposta su `1` per disattivare questa memorizzazione. Richiede Claude Code v2.1.285 o successiva |

390| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Imposta a `1` per non scrivere su disco la cronologia dei prompt e le trascrizioni delle sessioni. Le sessioni avviate con questa variabile impostata non compaiono in `--resume`, `--continue` né nella cronologia con la freccia su. Utile per sessioni temporanee basate su script |392| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Imposta su `1` per non scrivere su disco la cronologia dei prompt e le trascrizioni delle sessioni. Le sessioni avviate con questa variabile impostata non compaiono in `--resume`, `--continue` né nella cronologia accessibile con la freccia su. Utile per sessioni effimere eseguite da script |

391| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Salta l'autenticazione Google per Agent Platform di Google Cloud (ad esempio, quando si usa un gateway LLM) |393| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Salta l'autenticazione Google per Agent Platform di Google Cloud (ad esempio, quando usi un gateway LLM) |

392| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Imposta a `1` per fare in modo che una sessione avviata con `--output-format stream-json` scriva un [messaggio di risultato che indica perché Claude Code ha rifiutato di avviarsi](/docs/it/agent-sdk/typescript#startup_failure_reason) per gli errori di avvio che altrimenti terminano solo con stderr. Richiede Claude Code v2.1.274 o successiva |394| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Imposta su `1` per fare in modo che una sessione avviata con `--output-format stream-json` scriva un [messaggio di risultato che indica perché Claude Code si è rifiutato di avviarsi](/docs/it/agent-sdk/typescript#startup_failure_reason) per gli errori di avvio che altrimenti terminano solo con un output su stderr. Richiede Claude Code v2.1.274 o successiva |

393| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive in cui un hook [Stop](/docs/it/hooks#stop) o [SubagentStop](/docs/it/hooks#subagentstop) può impedire la fine del turno prima che Claude Code lo scavalchi e termini comunque il turno (predefinito: 8). Imposta a `0` per disabilitare il limite. Aumentalo se il tuo hook ha legittimamente bisogno di più iterazioni per risolversi |395| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive in cui un hook [Stop](/docs/it/hooks#stop) o [SubagentStop](/docs/it/hooks#subagentstop) può impedire la conclusione del turno prima che Claude Code lo sovrascriva e concluda comunque il turno (predefinito: 8). Imposta su `0` per disattivare il limite. Aumentalo se il tuo hook ha legittimamente bisogno di più iterazioni per arrivare a una soluzione |

394| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i compagni di un [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) e gli agenti dei [workflow](/docs/it/workflows) a cui non viene assegnato un modello in altro modo. Accetta un alias come `haiku` o un nome di modello completo. Due fonti hanno la precedenza su di essa: un modello che Claude passa quando genera l'agente e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare questo comportamento, imposta [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model). Vedi [Scegliere un modello](/docs/it/sub-agents#choose-a-model) per l'ordine completo. Impostarla su `inherit` equivale a lasciarla non impostata. Prima della v2.1.251, questa variabile sovrascriveva sia il modello per singola invocazione sia il campo `model` della definizione |396| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i membri dei [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) e gli agenti dei [workflow](/docs/it/workflows) a cui non è assegnato un modello in altro modo. Accetta un alias come `haiku` o un nome completo di modello. Due sorgenti hanno la precedenza su di essa: un modello che Claude passa quando genera l'agente e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare questo comportamento, imposta [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model). Consulta [Scegliere un modello](/docs/it/sub-agents#choose-a-model) per l'ordine completo. Impostarla su `inherit` equivale a lasciarla non impostata. Prima della v2.1.251, questa variabile sovrascriveva sia il modello per singola invocazione sia il campo `model` della definizione |

395| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Imposta a `1` per forzare un unico modello su subagent, compagni di team e agenti dei workflow. [Eseguire ogni subagent su un unico modello](/docs/it/sub-agents#run-every-subagent-on-one-model) indica di quale modello si tratta. Richiede Claude Code v2.1.257 o successiva |397| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Imposta su `1` per imporre un unico modello a subagent, membri del team e agenti dei workflow. [Eseguire ogni subagent su un unico modello](/docs/it/sub-agents#run-every-subagent-on-one-model) indica di quale modello si tratta. Richiede Claude Code v2.1.257 o successiva |

396| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache dei prompt](/docs/it/prompt-caching#cache-lifetime) per le richieste al di fuori della conversazione principale, come [subagent](/docs/it/sub-agents), workflow e lavoro in background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L'API fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |398| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache dei prompt](/docs/it/prompt-caching#cache-lifetime) per le richieste al di fuori della conversazione principale, come [subagent](/docs/it/sub-agents), workflow e lavoro in background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` ha la precedenza su di essa. L'API addebita le scritture nella cache di 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |

397| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Imposta a `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio): credenziali di Anthropic e dei provider cloud, qualsiasi altra variabile che Claude Code riconosce come credenziale e credenziali incorporate negli URL dei registri di pacchetti. Il processo Claude padre mantiene queste credenziali per le chiamate API, ma i processi figli non possono leggerle, riducendo l'esposizione ad attacchi di prompt injection che tentano di esfiltrare segreti tramite l'espansione della shell. Nella v2.1.251 o successiva, la rimozione elimina anche le variabili che puntano all'archivio di configurazione di Claude Code stesso (come `CLAUDE_CONFIG_DIR`), così un processo figlio non può individuare una directory di configurazione spostata. Lascia la rimozione non impostata se un sottoprocesso ha bisogno di queste variabili. Su Linux, esegue inoltre i sottoprocessi Bash in un namespace PID isolato, in modo che non possano leggere gli ambienti dei processi host tramite `/proc`; come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere i processi host né inviare loro segnali. `claude-code-action` la imposta automaticamente quando è configurato `allowed_non_write_users` |399| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Imposta su `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi avviati da Claude Code, come i comandi Bash, gli hook e i server MCP stdio. La pulizia riconosce una credenziale dal nome della variabile o dal suo valore, e lascia invariati i token GitHub e le impostazioni del proxy. Consulta [Cosa rimuove la pulizia dell'ambiente dei sottoprocessi](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la imposta automaticamente quando è configurato `allowed_non_write_users` |

398| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Imposta a `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell'installazione dei plugin prima della prima query. Senza di essa, i plugin vengono installati in background e potrebbero non essere disponibili al primo turno. Combinala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |400| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Imposta su `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell'installazione dei plugin prima della prima query. Senza questa variabile, i plugin vengono installati in background e potrebbero non essere disponibili al primo turno. Combinala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |

399| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona dei plugin. Quando viene superato, Claude Code prosegue senza plugin e registra un errore. Nessun valore predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |401| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona dei plugin. Quando viene superato, Claude Code procede senza plugin e registra un errore nel log. Nessun valore predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |

400| `CLAUDE_CODE_SYNC_SKILLS` | Imposta a `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi le skill abilitate per il tuo account claude.ai in quell'esecuzione e ne attenda l'elenco, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. I download veri e propri terminano in background e Claude attende il download di una skill quando invoca quella skill. Richiede l'autenticazione claude.ai. Le sessioni nel terminale in cui accedi con il tuo account claude.ai [scaricano queste skill](/docs/it/skills#where-synced-skills-load) in `~/.claude/skills/synced/` e le risincronizzano circa ogni 10 minuti senza questa variabile, quindi impostala solo quando un'esecuzione `-p` ha bisogno delle tue skill aggiornate alla prima query. Prima della v2.1.273, le sessioni nel terminale le scaricavano solo in un'esecuzione `-p` con questa variabile impostata. Il nome della cartella `synced` è [riservato a questo download](/docs/it/skills#where-skills-live). Prima della v2.1.227, le skill venivano scaricate direttamente in `~/.claude/skills/`. Claude Code applica [regole aggiuntive alle skill scaricate](/docs/it/skills#how-synced-skills-behave), ad esempio non esegue i loro comandi `!` sulla tua macchina |402| `CLAUDE_CODE_SYNC_SKILLS` | Imposta su `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi in quell'esecuzione le skill abilitate per il tuo account claude.ai e ne attenda l'elenco, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. I download veri e propri terminano in background, e Claude attende il download di una skill quando la invoca. Richiede l'autenticazione claude.ai. Le sessioni del terminale in cui accedi con il tuo account claude.ai [scaricano queste skill](/docs/it/skills#where-synced-skills-load) in `~/.claude/skills/synced/` e le risincronizzano circa ogni 10 minuti senza questa variabile, quindi impostala solo quando un'esecuzione `-p` ha bisogno delle tue skill aggiornate alla prima query. Prima della v2.1.273, le sessioni del terminale le scaricavano solo in un'esecuzione `-p` con questa variabile impostata. Il nome della cartella `synced` è [riservato a questo download](/docs/it/skills#where-skills-live). Prima della v2.1.227, le skill venivano scaricate direttamente in `~/.claude/skills/`. Claude Code applica [regole aggiuntive alle skill scaricate](/docs/it/skills#how-synced-skills-behave), come non eseguire i loro comandi `!` sulla tua macchina |

401| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per la risincronizzazione delle skill che viene eseguita a metà sessione quando un'app basata sull'[Agent SDK](/docs/it/agent-sdk/typescript#query-object) ricarica le skill (predefinito: 30000). Quando viene superato, il ricaricamento prosegue con le skill già arrivate e i download rimanenti terminano in background |403| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per la risincronizzazione delle skill che viene eseguita a metà sessione quando un'app basata sull'[Agent SDK](/docs/it/agent-sdk/typescript#query-object) ricarica le skill (predefinito: 30000). Quando viene superato, il ricaricamento prosegue con le skill già arrivate, e i download rimanenti terminano in background |

402| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in millisecondi entro cui la prima query attende l'elenco iniziale delle skill quando è impostata `CLAUDE_CODE_SYNC_SKILLS` (predefinito: 5000). Quando viene superato, la prima query viene eseguita con le skill già arrivate. I download terminano comunque in background e Claude attende il download di una skill quando invoca quella skill |404| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in millisecondi entro cui la prima query attende l'elenco iniziale delle skill quando è impostata `CLAUDE_CODE_SYNC_SKILLS` (predefinito: 5000). Quando viene superato, la prima query viene eseguita con le skill già arrivate. In ogni caso i download terminano in background, e Claude attende il download di una skill quando la invoca |

403| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Imposta a `false` per disabilitare l'evidenziazione della sintassi nell'output dei diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disabilitare l'evidenziazione anche nei blocchi di codice e nelle anteprime dei file, usa l'impostazione [`syntaxHighlightingDisabled`](/docs/it/settings-reference#syntaxhighlightingdisabled) |405| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Imposta su `false` per disattivare l'evidenziazione della sintassi nell'output dei diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disattivare l'evidenziazione anche nei blocchi di codice e nelle anteprime dei file, usa l'impostazione [`syntaxHighlightingDisabled`](/docs/it/settings-reference#syntaxhighlightingdisabled) |

404| `CLAUDE_CODE_TASK_LIST_ID` | Condivide un elenco di attività tra sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinarti su un elenco di attività condiviso, nelle [sessioni che dispongono degli strumenti Task](/docs/it/tools-reference#task-tool-availability). Vedi [Elenco delle attività](/docs/it/interactive-mode#task-list) |406| `CLAUDE_CODE_TASK_LIST_ID` | Condivide un elenco di attività tra sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinarle su un elenco di attività condiviso, nelle [sessioni che dispongono degli strumenti Task](/docs/it/tools-reference#task-tool-availability). Consulta [Elenco delle attività](/docs/it/interactive-mode#task-list) |

405| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sovrascrive, in millisecondi, per quanto tempo una sessione non interattiva attende all'uscita che il suo [team di agenti](/docs/it/agent-teams) termini lo smantellamento. Accetta da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il valore predefinito di 10000. Richiede Claude Code v2.1.206 o successiva |407| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sovrascrive, in millisecondi, quanto a lungo una sessione non interattiva attende all'uscita che il suo [team di agenti](/docs/it/agent-teams) termini lo smantellamento. Accetta valori da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il valore predefinito di 10000. Richiede Claude Code v2.1.206 o successiva |

406| `CLAUDE_CODE_TMPDIR` | Sovrascrive la directory temporanea usata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` a questo percorso su Unix, o `/claude/` su Windows. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash in [sandbox](/docs/it/sandboxing) ricevono un `$TMPDIR` di fallback breve nella posizione predefinita del sistema quando il tuo override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non in sandbox ereditano il `$TMPDIR` della tua shell quando è impostato. Su Windows nativo, quando la tua shell non imposta `$TMPDIR`, un comando Bash che fa riferimento a `$TMPDIR` riceve il tuo override, oppure `%TEMP%` se non ne hai impostato uno. I file temporanei di Claude Code usano sempre il tuo override. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |408| `CLAUDE_CODE_TMPDIR` | Sovrascrive la directory temporanea usata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` a questo percorso su Unix, oppure `/claude/` su Windows. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash in [sandbox](/docs/it/sandboxing) ricevono un `$TMPDIR` di fallback breve all'interno del percorso predefinito di sistema quando il tuo override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non in sandbox ereditano il `$TMPDIR` della tua shell quando è impostato. Su Windows nativo, quando la tua shell non imposta `$TMPDIR`, un comando Bash che fa riferimento a `$TMPDIR` riceve il tuo override, oppure `%TEMP%` quando non ne hai impostato uno. I file temporanei di Claude Code usano sempre il tuo override. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

407| `CLAUDE_CODE_TMUX_TRUECOLOR` | Imposta a qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. **Impostarla a `0` o `false` consente comunque il truecolor**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare il limite a 256 colori. Per impostazione predefinita, Claude Code limita a 256 colori quando `$TMUX` è impostata, perché tmux non inoltra le sequenze di escape truecolor a meno che non sia configurato per farlo. Impostala dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al tuo `~/.tmux.conf`. Vedi [Configurazione del terminale](/docs/it/terminal-config) per altre impostazioni di tmux |409| `CLAUDE_CODE_TMUX_TRUECOLOR` | Imposta su qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. **Impostarla su `0` o `false` consente comunque il truecolor**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare la limitazione a 256 colori. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostata, perché tmux non inoltra le sequenze di escape truecolor a meno che non sia configurato per farlo. Impostala dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al tuo `~/.tmux.conf`. Consulta [Configurazione del terminale](/docs/it/terminal-config) per altre impostazioni di tmux |

408| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Su Linux e WSL, imposta un elenco separato da virgole dei tipi di processi che Claude Code [esclude dal limite di memoria degli strumenti](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), come `mcp` o `lsp`. Imposta `none` per limitare ogni tipo, oppure `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene sotto il limite i comandi degli strumenti Bash, PowerShell e Monitor qualunque cosa tu elenchi. Richiede Claude Code v2.1.246 o successiva |410| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Su Linux e WSL, impostala su un elenco separato da virgole dei tipi di processi che Claude Code [esclude dal limite di memoria degli strumenti](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), come `mcp` o `lsp`. Imposta `none` per applicare il limite a ogni tipo, oppure `all-new` per applicarlo solo ai comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene sotto il limite i comandi degli strumenti Bash, PowerShell e Monitor indipendentemente da ciò che elenchi. Richiede Claude Code v2.1.246 o successiva |

409| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Su Linux e WSL, imposta una dimensione come `4G` per [limitare la memoria che i comandi degli strumenti Bash e PowerShell possono usare](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), e i comandi dello strumento Monitor nella v2.1.246 o successiva. Scrivi la dimensione in cifre semplici, da sola per un numero di byte o con un suffisso `K`, `M`, `G` o `T`. Imposta `0` o `off` per disattivare il limite. Dopo che il primo processo avviato da Claude Code ha attivato o disattivato il limite, un valore modificato ha effetto al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva |411| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Su Linux e WSL, impostala su una dimensione come `4G` per [limitare la memoria che i comandi degli strumenti Bash e PowerShell possono usare](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), e i comandi dello strumento Monitor nella v2.1.246 o successiva. Scrivi la dimensione in cifre semplici, da sole per un numero di byte o con un suffisso `K`, `M`, `G` o `T`. Imposta `0` o `off` per disattivare il limite. Una volta che il primo processo avviato da Claude Code ha attivato o disattivato il limite, un valore modificato ha effetto al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva |

410| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Scadenza in millisecondi prima che Claude Code annulli una finestra di dialogo che inoltra a un client remoto come un host [Remote Control](/docs/it/remote-control) o SDK, oppure la finestra di dialogo di approvazione per un [messaggio tra sessioni trattenuto](/docs/it/cross-session-messaging#control-inbound-messages); le richieste di permesso e le domande `AskUserQuestion` usano flussi propri e non sono regolate da questa variabile. In Claude Code v2.1.236 o successiva, limita anche la [richiesta di consenso ai crediti di utilizzo Fable](/docs/it/model-config#fable-and-usage-credits) a metà sessione in una sessione che potrebbe essere in esecuzione senza supervisione. [Controllare i messaggi in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) e [Sessioni non interattive](/docs/it/cross-session-messaging#non-interactive-sessions) descrivono tutte le regole di scadenza dei messaggi trattenuti, inclusi i casi in cui la scadenza non si applica. Sovrascrive l'impostazione [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry). `0` o un valore negativo disabilita la scadenza |412| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Imposta su `1` per limitare la crescita del [file della trascrizione](/docs/it/sessions#where-transcripts-are-stored) di una lunga sessione `-p` o dell'Agent SDK. Dopo ogni compattazione, una volta che il file supera i 5 MB, Claude Code rimuove la cronologia precedente a quella compattazione. La ripresa della sessione ripristina la stessa conversazione indipendentemente dal fatto che il file sia stato ridotto. Impostala nell'ambiente da cui avvii Claude Code, poiché un blocco `env` delle impostazioni non può attivarla. Richiede Claude Code v2.1.287 o successiva |

413| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Scadenza in millisecondi prima che Claude Code annulli una finestra di dialogo che inoltra a un client remoto come un host [Remote Control](/docs/it/remote-control) o SDK, oppure la finestra di approvazione per un [messaggio tra sessioni trattenuto](/docs/it/cross-session-messaging#control-inbound-messages); le richieste di permesso e le domande di `AskUserQuestion` usano i propri flussi e non sono regolate da questa variabile. In Claude Code v2.1.236 o successiva, limita anche la [richiesta di consenso ai crediti di utilizzo di Fable](/docs/it/model-config#fable-and-usage-credits) a metà sessione in una sessione che potrebbe essere in esecuzione senza supervisione. [Controllare i messaggi in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) e [Sessioni non interattive](/docs/it/cross-session-messaging#non-interactive-sessions) descrivono le regole complete di scadenza dei messaggi trattenuti, inclusi i casi in cui la scadenza non si applica. Sovrascrive l'impostazione [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry). `0` o un valore negativo disattiva la scadenza |

411| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usa [Claude Platform on AWS](/docs/it/claude-platform-on-aws) |414| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usa [Claude Platform on AWS](/docs/it/claude-platform-on-aws) |

412| `CLAUDE_CODE_USE_BEDROCK` | Usa [Amazon Bedrock](/docs/it/amazon-bedrock) |415| `CLAUDE_CODE_USE_BEDROCK` | Usa [Amazon Bedrock](/docs/it/amazon-bedrock) |

413| `CLAUDE_CODE_USE_FOUNDRY` | Usa [Microsoft Foundry](/docs/it/microsoft-foundry) |416| `CLAUDE_CODE_USE_FOUNDRY` | Usa [Microsoft Foundry](/docs/it/microsoft-foundry) |

414| `CLAUDE_CODE_USE_MANTLE` | Usa l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock |417| `CLAUDE_CODE_USE_MANTLE` | Usa l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock |

415| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Imposta a `1` per rilevare comandi personalizzati, subagent e stili di output usando le API dei file di Node.js invece di ripgrep. Impostala se il binario ripgrep incluso non è disponibile o è bloccato nel tuo ambiente. Non influisce su Grep né sugli strumenti di ricerca dei file |418| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Imposta su `1` per rilevare comandi personalizzati, subagent e stili di output usando le API per i file di Node.js invece di ripgrep. Impostala se il binario ripgrep incluso non è disponibile o è bloccato nel tuo ambiente. Non influisce su Grep né sugli strumenti di ricerca dei file |

416| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta a `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; imposta a `1` per abilitarlo nelle sessioni Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, oppure a `0` per disattivarlo. Su Linux, macOS e WSL, imposta a `1` per abilitarlo, il che richiede `pwsh` nel tuo `PATH`. Quando è abilitato su Windows, Claude può eseguire comandi PowerShell in modo nativo invece di passare da Git Bash. Vedi [Strumento PowerShell](/docs/it/tools-reference#powershell-tool) |419| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento viene attivato automaticamente; imposta su `0` per disattivarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; imposta su `1` per attivarlo nelle sessioni Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, oppure su `0` per disattivarlo. Su Linux, macOS e WSL, imposta su `1` per attivarlo, il che richiede `pwsh` nel tuo `PATH`. Quando è attivo su Windows, Claude può eseguire i comandi PowerShell in modo nativo invece di passare per Git Bash. Consulta [Strumento PowerShell](/docs/it/tools-reference#powershell-tool) |

417| `CLAUDE_CODE_USE_VERTEX` | Usa [Agent Platform di Google Cloud](/docs/it/google-vertex-ai) |420| `CLAUDE_CODE_USE_VERTEX` | Usa [Agent Platform di Google Cloud](/docs/it/google-vertex-ai) |

418| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Imposta il numero di millisecondi per cui [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) mantiene nella cache la risposta di ogni URL recuperato. Il valore predefinito è `900000`, ovvero 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra scrittura mantengono il valore predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva |421| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Imposta il numero di millisecondi per cui [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) mantiene nella cache la risposta di ciascun URL recuperato. Il valore predefinito è `900000`, cioè 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra grafia mantiene il valore predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successivo |

419| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superiore in millisecondi per quanto tempo [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) attende il download di una pagina, inclusi gli eventuali reindirizzamenti che segue. Un download non completato entro quel tempo fallisce con un errore di scadenza. Il valore predefinito è `300000`, ovvero cinque minuti. Imposta a `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra scrittura mantengono il valore predefinito. Richiede Claude Code v2.1.268 o successiva |422| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite massimo in millisecondi per quanto tempo [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) attende il download di una pagina, inclusi gli eventuali reindirizzamenti che segue. Un download non completato entro quel tempo fallisce con un errore di scadenza. Il valore predefinito è `300000`, cioè cinque minuti. Imposta `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra grafia mantiene il valore predefinito. Richiede Claude Code v2.1.268 o successivo |

423| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è impostato su `1`, quanto tempo Claude Code attende prima di ogni promemoria a Claude per controllare i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ancora in esecuzione. Accetta una o più attese separate da virgole in secondi interi da `1` a `86400`, come `600` o `600,1800,3600`. Ogni valore è l'attesa prima del promemoria successivo, e l'ultimo valore si ripete. Accetta solo cifre semplici; qualsiasi altro valore o grafia viene letto come non impostato. Quando non è impostata, non ci sono promemoria. Richiede Claude Code v2.1.283 o successivo |

420| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quanti agenti esegue contemporaneamente una singola esecuzione di un [workflow](/docs/it/workflows), da `1` a `256`. Per impostazione predefinita, un'esecuzione esegue fino a 16 agenti contemporaneamente, meno quando Claude Code ha meno CPU disponibili; le chiamate `agent()` in coda attendono uno slot libero. La trascrizione di ogni agente in esecuzione rimane nella memoria di Claude Code, quindi valori più alti aumentano l'uso di memoria. Accetta solo cifre semplici; i valori fuori intervallo e le altre grafie mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successivo |424| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quanti agenti esegue contemporaneamente una singola esecuzione di un [workflow](/docs/it/workflows), da `1` a `256`. Per impostazione predefinita, un'esecuzione esegue fino a 16 agenti contemporaneamente, meno quando Claude Code ha meno CPU disponibili; le chiamate `agent()` in coda attendono uno slot libero. La trascrizione di ogni agente in esecuzione rimane nella memoria di Claude Code, quindi valori più alti aumentano l'uso di memoria. Accetta solo cifre semplici; i valori fuori intervallo e le altre grafie mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successivo |

421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superiore in millisecondi del tempo che un agente di un [workflow](/docs/it/workflows) attende che inizi la prima risposta di un agente fratello con lo stesso prefisso prima di inviare la propria prima richiesta. Quando un fan-out avvia diversi agenti che condividono un [prefisso della prompt cache](/docs/it/workflows#prompt-caching-in-a-fan-out), Claude Code trattiene tutti gli agenti tranne il primo fino a questo tempo, in modo che gli altri leggano il prefisso memorizzato nella cache invece di elaborarlo ciascuno senza cache. Valore predefinito `5000`. Imposta a `0` per disattivare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostata, gli agenti non attendono mai. Richiede Claude Code v2.1.229 o successivo |425| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite massimo in millisecondi per quanto tempo un agente di un [workflow](/docs/it/workflows) attende che inizi la prima risposta di un agente fratello con lo stesso prefisso prima di inviare la propria prima richiesta. Quando un fan-out avvia diversi agenti che condividono un [prefisso della cache del prompt](/docs/it/workflows#prompt-caching-in-a-fan-out), Claude Code trattiene tutti gli agenti tranne il primo fino a questo tempo, in modo che gli altri leggano il prefisso dalla cache invece di elaborarlo ciascuno senza cache. Valore predefinito `5000`. Imposta `0` per disabilitare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostata, gli agenti non attendono mai. Richiede Claude Code v2.1.229 o successivo |

422| `CLAUDE_CONFIG_DIR` | Sovrascrive la directory di configurazione (predefinita: `~/.claude`). Tutte le impostazioni, la cronologia delle sessioni e i plugin sono archiviati in questo percorso. Per le credenziali, consulta [dove Claude Code archivia le credenziali](/docs/it/authentication#credential-management). Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |426| `CLAUDE_CONFIG_DIR` | Sovrascrive la directory di configurazione (predefinita: `~/.claude`). Tutte le impostazioni, la cronologia delle sessioni e i plugin sono archiviati in questo percorso. Per le credenziali, consulta [dove Claude Code archivia le credenziali](/docs/it/authentication#credential-management). Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

423| `CLAUDE_DISABLE_ADOPT` | Imposta a `1` per interrompere il lavoro in background in corso invece di trasferirlo quando metti una sessione in background premendo `←` o con [`/background`](/docs/it/agent-view#from-inside-a-session). Claude Code ti chiede conferma prima di mettere in background, poi interrompe le attività che altrimenti verrebbero trasferite. Richiede Claude Code v2.1.195 o successivo |427| `CLAUDE_DISABLE_ADOPT` | Imposta su `1` per interrompere il lavoro in background in corso invece di trasferirlo quando metti una sessione in background premendo `←` o con [`/background`](/docs/it/agent-view#from-inside-a-session). Claude Code ti chiede conferma prima di passare in background, poi interrompe le attività che altrimenti verrebbero trasferite. Richiede Claude Code v2.1.195 o successivo |

424| `CLAUDE_EFFORT` | Impostata automaticamente nei sottoprocessi dello strumento Bash e nei comandi degli hook al [livello di sforzo](/docs/it/model-config#adjust-effort-level) in vigore quando il sottoprocesso si avvia: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli [hook](/docs/it/hooks). Impostata solo quando il modello corrente supporta il parametro effort |428| `CLAUDE_EFFORT` | Impostata automaticamente nei sottoprocessi dello strumento Bash e nei comandi degli hook sul [livello di sforzo](/docs/it/model-config#adjust-effort-level) in vigore all'avvio del sottoprocesso: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli [hook](/docs/it/hooks). Impostata solo quando il modello corrente supporta il parametro effort |

425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Imposta a `1` per forzare l'attivazione del watchdog di inattività dello streaming a livello di byte, oppure a `0` per forzarne la disattivazione. `0` disattiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle connessioni in cui tale scadenza è attiva. Quando non è impostata, il watchdog è attivo per impostazione predefinita per le connessioni dirette all'API Anthropic e a [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e per le risposte in streaming sulle connessioni tramite [gateway](/docs/it/gateways) raggiunte con `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non era attivo su quelle connessioni tramite gateway, quindi il watchdog a livello di evento poteva segnalare uno stallo anche mentre arrivavano i ping keep-alive. Per i timeout e il modo in cui interagiscono i timer, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |429| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Imposta su `1` per forzare l'abilitazione del watchdog di inattività dello streaming a livello di byte, oppure su `0` per forzarne la disabilitazione. `0` disattiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle connessioni in cui tale scadenza è attiva. Quando non è impostata, il watchdog è abilitato per impostazione predefinita per le connessioni dirette all'API Anthropic e a [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e per le risposte in streaming sulle connessioni tramite [gateway](/docs/it/gateways) raggiunte attraverso `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non era attivo su quelle connessioni tramite gateway, quindi il watchdog a livello di evento poteva segnalare uno stallo anche mentre arrivavano i ping keep-alive. Per i timeout e l'interazione tra i timer, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |

426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Imposta a `1` per attivare il watchdog di inattività dello streaming a livello di byte sulle risposte `vnd.amazon.eventstream` di Amazon Bedrock, il che attiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle richieste in streaming di Bedrock. Disattivata per impostazione predefinita. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |430| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Imposta su `1` per abilitare il watchdog di inattività dello streaming a livello di byte sulle risposte `vnd.amazon.eventstream` di Amazon Bedrock, il che abilita anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle richieste in streaming di Bedrock. Disattivata per impostazione predefinita. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

427| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Imposta a `0` per forzare la disattivazione del watchdog di inattività dello streaming a livello di evento, oppure a `1` per forzarne l'attivazione. Quando non è impostata, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il valore predefinito in assenza di impostazione era controllato dal server sull'API Anthropic diretta e disattivato sugli altri provider. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che funzionano insieme a questo, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |431| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Imposta su `0` per forzare la disabilitazione del watchdog di inattività dello streaming a livello di evento, oppure su `1` per forzarne l'abilitazione. Quando non è impostata, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il valore predefinito in assenza di impostazione era controllato dal server sull'API Anthropic diretta e disattivato sugli altri provider. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che funzionano insieme a questo, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |

428| `CLAUDE_ENV_FILE` | Percorso di uno script shell il cui contenuto Claude Code esegue prima di ogni comando Bash nello stesso processo della shell, in modo che gli export nel file siano visibili al comando. Usala per mantenere l'attivazione di virtualenv o conda tra i comandi. Viene anche popolata dinamicamente dagli hook [SessionStart](/docs/it/hooks#persist-environment-variables), [Setup](/docs/it/hooks#setup), [CwdChanged](/docs/it/hooks#cwdchanged) e [FileChanged](/docs/it/hooks#filechanged) |432| `CLAUDE_ENV_FILE` | Percorso di uno script shell il cui contenuto Claude Code esegue prima di ogni comando Bash nello stesso processo shell, in modo che gli export nel file siano visibili al comando. Usala per mantenere l'attivazione di virtualenv o conda tra i comandi. Viene anche popolata dinamicamente dagli hook [SessionStart](/docs/it/hooks#persist-environment-variables), [Setup](/docs/it/hooks#setup), [CwdChanged](/docs/it/hooks#cwdchanged) e [FileChanged](/docs/it/hooks#filechanged) |

429| `CLAUDE_JOB_DIR` | Impostata da Claude Code in ogni [sessione in background](/docs/it/agent-view) sulla directory `~/.claude/jobs/<id>` di quella sessione. I comandi shell eseguiti dalla sessione la ereditano. Scrivi i file temporanei in [`$CLAUDE_JOB_DIR/tmp`](/docs/it/agent-view#where-state-is-stored). Le chiamate `Write` ed `Edit` di Claude in quella posizione non richiedono permessi, e la directory viene rimossa quando la sessione viene eliminata |433| `CLAUDE_JOB_DIR` | Impostata da Claude Code in ogni [sessione in background](/docs/it/agent-view) sulla directory `~/.claude/jobs/<id>` di quella sessione. I comandi shell eseguiti dalla sessione la ereditano. Scrivi i file temporanei in [`$CLAUDE_JOB_DIR/tmp`](/docs/it/agent-view#where-state-is-stored). Le chiamate `Write` ed `Edit` di Claude in quella posizione non richiedono permesso, e la directory viene rimossa quando la sessione viene eliminata |

430| `CLAUDE_PID` | Claude Code la imposta al proprio ID di processo nei sottoprocessi che avvia: i comandi degli strumenti Bash e PowerShell e i comandi degli hook. Su Linux, l'integrazione shell dello strumento Bash la usa per rifiutare un pattern `pkill` che corrisponderebbe al processo stesso di Claude Code; consulta [il riferimento agli errori](/docs/it/errors#pkill-pattern-matches-the-claude-code-process). Leggila dai tuoi script per identificare deliberatamente il processo padre di Claude Code o inviargli segnali. Richiede Claude Code v2.1.214 o successivo |434| `CLAUDE_PID` | Claude Code la imposta sul proprio ID di processo nei sottoprocessi che avvia: i comandi degli strumenti Bash e PowerShell e i comandi degli hook. Su Linux, l'integrazione shell dello strumento Bash la usa per rifiutare un pattern `pkill` che corrisponderebbe al processo stesso di Claude Code; consulta [il riferimento degli errori](/docs/it/errors#pkill-pattern-matches-the-claude-code-process). Leggila dai tuoi script per identificare o inviare segnali deliberatamente al processo padre di Claude Code. Richiede Claude Code v2.1.214 o successivo |

431| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi delle sessioni [Remote Control](/docs/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Il valore predefinito è l'hostname della tua macchina, che produce nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |435| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi delle sessioni [Remote Control](/docs/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Il valore predefinito è l'hostname della tua macchina, che produce nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |

432| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Scadenza in millisecondi per il primo byte della risposta di una richiesta in streaming, sulle connessioni in cui è attiva la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs). Per il modo in cui Claude Code la limita, il tempo extra che aggiunge per i body di richiesta di grandi dimensioni e il modo in cui sceglie la scadenza quando non la imposti, consulta [No response from API](/docs/it/errors#no-response-from-api). Richiede Claude Code v2.1.242 o successivo |436| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Scadenza in millisecondi per il primo byte di risposta di una richiesta in streaming, sulle connessioni in cui è attiva la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs). Per come Claude Code la limita, il tempo extra che aggiunge per i corpi di richiesta di grandi dimensioni e come sceglie la scadenza quando la lasci non impostata, consulta [No response from API](/docs/it/errors#no-response-from-api). Richiede Claude Code v2.1.242 o successivo |

433| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che i watchdog di inattività dello streaming a livello di evento e di byte chiudano una connessione in stallo. Quando imposti esplicitamente questa variabile, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente portati al minimo per assorbire le pause del ragionamento esteso e il buffering dei proxy, e il watchdog a livello di byte limita il valore a 30 minuti. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` ha la precedenza su questa variabile per il watchdog a livello di byte. Per i valori predefiniti di ciascun watchdog quando la variabile non è impostata, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |437| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che i watchdog di inattività dello streaming a livello di evento e di byte chiudano una connessione in stallo. Quando imposti esplicitamente questa variabile, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente portati al minimo per assorbire le pause prolungate di ragionamento e il buffering dei proxy, e il watchdog a livello di byte limita il valore a 30 minuti. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` ha la precedenza su questa variabile per il watchdog a livello di byte. Per i valori predefiniti di ciascun watchdog in assenza di impostazione, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |

434| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Rimossa nella v2.1.260 e ora senza effetto. In precedenza limitava per quanto tempo, in millisecondi, poteva essere eseguito un [comando shell in background](/docs/it/interactive-mode#background-bash-commands) avviato da un [subagent](/docs/it/sub-agents), con un valore predefinito di 60 minuti. Consulta [le regole sulla durata dei comandi in background](/docs/it/tools-reference#background-commands) |438| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Rimossa nella v2.1.260 e ora senza effetto. In precedenza limitava, in millisecondi, per quanto tempo poteva essere eseguito un [comando shell in background](/docs/it/interactive-mode#background-bash-commands) avviato da un [subagent](/docs/it/sub-agents), con un valore predefinito di 60 minuti. Consulta [le regole sulla durata dei comandi in background](/docs/it/tools-reference#background-commands) |

435| `DEBUG` | Imposta a `1` per attivare la modalità debug, equivalente all'avvio con [`--debug`](/docs/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, oppure nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori veri `1`, `true`, `yes` e `on` attivano la modalità debug, quindi i pattern di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano |439| `DEBUG` | Imposta su `1` per abilitare la modalità debug, equivalente all'avvio con [`--debug`](/docs/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, oppure nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori veri `1`, `true`, `yes` e `on` abilitano la modalità debug, quindi pattern di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano |

436| `DISABLE_AUTOUPDATER` | Imposta a `1` per disattivare gli aggiornamenti automatici in background. Il comando manuale `claude update` funziona comunque. Usa `DISABLE_UPDATES` per bloccare entrambi |440| `DISABLE_AUTOUPDATER` | Imposta su `1` per disabilitare gli aggiornamenti automatici in background. Il comando manuale `claude update` funziona ancora. Usa `DISABLE_UPDATES` per bloccare entrambi |

437| `DISABLE_AUTO_COMPACT` | Imposta a `1` per disattivare la compattazione automatica quando ti avvicini al limite del contesto. Il comando manuale `/compact` resta disponibile. Usala quando vuoi un controllo esplicito su quando avviene la compattazione. Sovrascrive l'impostazione [`autoCompactEnabled`](/docs/it/settings-reference#autocompactenabled) |441| `DISABLE_AUTO_COMPACT` | Imposta su `1` per disabilitare la compattazione automatica quando ci si avvicina al limite del contesto. Il comando manuale `/compact` rimane disponibile. Usala quando vuoi un controllo esplicito su quando avviene la compattazione. Sovrascrive l'impostazione [`autoCompactEnabled`](/docs/it/settings-reference#autocompactenabled) |

438| `DISABLE_COMPACT` | Imposta a `1` per disattivare tutta la compattazione: sia la compattazione automatica sia il comando manuale `/compact` |442| `DISABLE_COMPACT` | Imposta su `1` per disabilitare ogni compattazione: sia la compattazione automatica sia il comando manuale `/compact` |

439| `DISABLE_COST_WARNINGS` | Imposta a `1` per disattivare i messaggi di avviso sui costi |443| `DISABLE_COST_WARNINGS` | Imposta su `1` per disabilitare i messaggi di avviso sui costi |

440| `DISABLE_DOCTOR_COMMAND` | Imposta a `1` per nascondere la skill di controllo della configurazione [`/doctor`](/docs/it/commands#all-commands) e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non devono eseguire la diagnostica della configurazione da una sessione. Non influisce sul comando da terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva il comando della schermata di diagnostica `/doctor` |444| `DISABLE_DOCTOR_COMMAND` | Imposta su `1` per nascondere la skill di controllo della configurazione [`/doctor`](/docs/it/commands#all-commands) e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire la diagnostica della configurazione da una sessione. Non influisce sul comando da terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva il comando della schermata di diagnostica `/doctor` |

441| `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 |445| `DISABLE_ERROR_REPORTING` | Imposta su qualsiasi valore non vuoto, come `1`, per disattivare la segnalazione degli errori. **Impostarla su `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la segnalazione degli errori |

442| `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 |446| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta su `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i rate limit |

443| `DISABLE_FEEDBACK_COMMAND` | Imposta a `1` per disattivare il comando `/feedback` e il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior). Disattiva anche `/bug` e `/share`, che inviano segnalazioni tramite lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando era disattivato con ogni nome. È accettato anche il vecchio nome `DISABLE_BUG_COMMAND` |447| `DISABLE_FEEDBACK_COMMAND` | Imposta su `1` per disabilitare il comando `/feedback` e il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior). Disabilita anche `/bug` e `/share`, che inviano segnalazioni attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando veniva disabilitato con ogni nome. È accettato anche il nome precedente `DISABLE_BUG_COMMAND` |

444| `DISABLE_GROWTHBOOK` | Imposta a `1` o `true` per disattivare il recupero dei feature flag di GrowthBook e usare i valori predefiniti del codice per ogni flag. Questo rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). Impostarla a `0` o `false` lascia attivo il recupero. Il logging degli eventi di telemetria rimane attivo a meno che non sia impostata anche `DISABLE_TELEMETRY` |448| `DISABLE_GROWTHBOOK` | Imposta su `1` o `true` per disabilitare il recupero dei feature flag di GrowthBook e usare i valori predefiniti del codice per ogni flag. Questo rende non disponibili [Remote Control](/docs/it/remote-control#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. Il log degli eventi di telemetria rimane attivo a meno che non sia impostata anche `DISABLE_TELEMETRY` |

445| `DISABLE_INSTALLATION_CHECKS` | Imposta a `1` per disattivare gli avvisi di installazione. Usala solo quando gestisci manualmente il percorso di installazione, poiché può nascondere problemi nelle installazioni standard |449| `DISABLE_INSTALLATION_CHECKS` | Imposta su `1` per disabilitare gli avvisi di installazione. Usala solo quando gestisci manualmente il percorso di installazione, poiché può nascondere problemi con le installazioni standard |

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

447| `DISABLE_INTERLEAVED_THINKING` | Imposta a `1` per impedire l'invio dell'header beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il [ragionamento intercalato](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |451| `DISABLE_INTERLEAVED_THINKING` | Imposta su `1` per impedire 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) |

448| `DISABLE_LOGIN_COMMAND` | Imposta a `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |452| `DISABLE_LOGIN_COMMAND` | Imposta su `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |

449| `DISABLE_LOGOUT_COMMAND` | Imposta a `1` per nascondere il comando `/logout` |453| `DISABLE_LOGOUT_COMMAND` | Imposta su `1` per nascondere il comando `/logout` |

450| `DISABLE_PROMPT_CACHING` | Imposta a `1` per disattivare il [prompt caching](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |454| `DISABLE_PROMPT_CACHING` | Imposta su `1` per disabilitare il [prompt caching](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |

451| `DISABLE_PROMPT_CACHING_FABLE` | Imposta a `1` per disattivare il prompt caching per i modelli Fable |455| `DISABLE_PROMPT_CACHING_FABLE` | Imposta su `1` per disabilitare il prompt caching per i modelli Fable |

452| `DISABLE_PROMPT_CACHING_HAIKU` | Imposta a `1` per disattivare il prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching), ovunque venga eseguito |456| `DISABLE_PROMPT_CACHING_HAIKU` | Imposta su `1` per disabilitare il prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching), ovunque venga eseguito |

453| `DISABLE_PROMPT_CACHING_OPUS` | Imposta a `1` per disattivare il prompt caching per il [modello Opus predefinito](/docs/it/prompt-caching#disable-prompt-caching) |457| `DISABLE_PROMPT_CACHING_OPUS` | Imposta su `1` per disabilitare il prompt caching per il [modello Opus predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

454| `DISABLE_PROMPT_CACHING_SONNET` | Imposta a `1` per disattivare il prompt caching per il [modello Sonnet predefinito](/docs/it/prompt-caching#disable-prompt-caching) |458| `DISABLE_PROMPT_CACHING_SONNET` | Imposta su `1` per disabilitare il prompt caching per il [modello Sonnet predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

455| `DISABLE_TELEMETRY` | Imposta a qualsiasi valore non vuoto, come `1`, per disattivare la telemetria. **Impostarla a `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi Bash. Disattiva anche il [recupero dei feature flag](#features-that-need-feature-flag-fetching). Consulta [Disattivare la telemetria per la tua organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |459| `DISABLE_TELEMETRY` | Imposta su qualsiasi valore non vuoto, come `1`, per disattivare la telemetria. **Impostarla su `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi Bash. Disabilita anche il [recupero dei feature flag](#features-that-need-feature-flag-fetching). Consulta [Disattivare la telemetria per la tua organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |

456| `DISABLE_UPDATES` | Imposta a `1` per bloccare tutti gli aggiornamenti, inclusi i comandi manuali `claude update` e `claude install`. Più restrittiva di `DISABLE_AUTOUPDATER`. Usala quando distribuisci Claude Code tramite i tuoi canali e gli utenti non devono aggiornarlo autonomamente |460| `DISABLE_UPDATES` | Imposta su `1` per bloccare tutti gli aggiornamenti, inclusi i comandi manuali `claude update` e `claude install`. Più restrittiva di `DISABLE_AUTOUPDATER`. Usala quando distribuisci Claude Code attraverso i tuoi canali e gli utenti non devono aggiornarlo autonomamente |

457| `DISABLE_UPGRADE_COMMAND` | Imposta a `1` per nascondere il comando `/upgrade` |461| `DISABLE_UPGRADE_COMMAND` | Imposta su `1` per nascondere il comando `/upgrade` |

458| `DO_NOT_TRACK` | Imposta a `1` per disattivare la telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, anche sul [recupero dei feature flag](#features-that-need-feature-flag-fetching). Claude Code legge questa variabile come un booleano standard, quindi `0` lascia attiva la telemetria, e la rispetta come convenzione trasversale riconosciuta da molte CLI per sviluppatori |462| `DO_NOT_TRACK` | Imposta su `1` per disattivare la telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso sul [recupero dei feature flag](#features-that-need-feature-flag-fetching). Claude Code legge questa variabile come un booleano standard, quindi `0` lascia attiva la telemetria, e la rispetta come convenzione trasversale riconosciuta da molte CLI per sviluppatori |

459| `ENABLE_BETA_TRACING_DETAILED` | Imposta a `1`, insieme a `BETA_TRACING_ENDPOINT`, per attivare il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta), che aggiunge attributi di span contenenti contenuti e lo span `claude_code.hook`. Le sessioni CLI interattive richiedono inoltre che la tua organizzazione sia inclusa nella allowlist della beta. Entrambe le variabili vengono ignorate nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |463| `ENABLE_BETA_TRACING_DETAILED` | Imposta su `1`, insieme a `BETA_TRACING_ENDPOINT`, per attivare il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta), che aggiunge attributi di span con contenuto e lo span `claude_code.hook`. Le sessioni CLI interattive richiedono inoltre che la tua organizzazione sia nella allowlist della beta. Entrambe le variabili vengono ignorate nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

460| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta a `false` per impedire a Claude Code di recuperare i [server MCP di claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). Attiva per impostazione predefinita per gli utenti che hanno effettuato l'accesso. Per disattivarli per progetto o per organizzazione, imposta invece [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) nelle impostazioni |464| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta su `false` per impedire a Claude Code di recuperare i [server MCP di claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). Abilitata per impostazione predefinita per gli utenti che hanno effettuato l'accesso. Per disabilitarla per progetto o per organizzazione, imposta invece [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) nelle impostazioni |

461| `ENABLE_PROMPT_CACHING_1H` | Imposta a `1` per richiedere un [TTL della prompt cache](/docs/it/prompt-caching#cache-lifetime) di 1 ora invece dei 5 minuti predefiniti. Pensata per gli utenti con chiave API, [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) e [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Gli utenti con abbonamento entro l'utilizzo incluso ricevono automaticamente il TTL di 1 ora sulla [conversazione principale](/docs/it/prompt-caching#which-ttl-each-request-gets). Gli utenti con abbonamento che attingono ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) possono impostarla per mantenere il TTL di 1 ora. Le scritture nella cache di 1 ora sono fatturate a una tariffa più alta. Per scegliere invece il TTL per gruppo di richieste, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile |465| `ENABLE_PROMPT_CACHING_1H` | Imposta su `1` per richiedere un [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) di 1 ora invece dei 5 minuti predefiniti. Pensata per gli utenti con chiave API, [Amazon Bedrock](/docs/it/amazon-bedrock), [Agent Platform di Google Cloud](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) e [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Gli utenti con abbonamento entro l'utilizzo incluso ricevono automaticamente il TTL di 1 ora sulla [conversazione principale](/docs/it/prompt-caching#which-ttl-each-request-gets). Gli utenti con abbonamento che attingono ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) possono impostarla per mantenere il TTL di 1 ora. Le scritture nella cache di 1 ora sono fatturate a una tariffa più alta. Per scegliere invece il TTL per gruppo di richieste, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile |

462| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecata. Usa invece `ENABLE_PROMPT_CACHING_1H` |466| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecata. Usa invece `ENABLE_PROMPT_CACHING_1H` |

463| `ENABLE_TOOL_SEARCH` | Controlla la [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search). Se non è impostata, Claude Code rinvia il caricamento di tutti gli strumenti MCP per impostazione predefinita. Li carica comunque subito sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, su un deploy di Microsoft Foundry ospitato su Azure e quando `ANTHROPIC_BASE_URL` punta a un host non first-party. `true` rinvia sempre il caricamento e invia l'header beta, tranne sugli stessi modelli di Agent Platform e deploy di Microsoft Foundry; le richieste falliscono sui proxy che non supportano `tool_reference`. `auto` carica subito gli strumenti quando le loro definizioni rientrano nel 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica subito tutti gli strumenti. Un valore impostato da te viene ignorato quando è impostata `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. Prima della v2.1.221, Claude Code disattivava la ricerca degli strumenti per tutti i modelli su Google Cloud's Agent Platform a meno che non impostassi questa variabile a `true` |467| `ENABLE_TOOL_SEARCH` | Controlla [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search). Se non è impostata, Claude Code rinvia tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo sui modelli dell'Agent Platform di Google Cloud precedenti alla generazione Claude 4.5, su un deploy di Microsoft Foundry ospitato su Azure e quando `ANTHROPIC_BASE_URL` punta a un host non first-party. `true` rinvia sempre e invia l'header beta, tranne su quegli stessi modelli dell'Agent Platform e deploy di Microsoft Foundry; le richieste falliscono sui proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti rientrano nel 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore impostato da te viene ignorato quando è impostata `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli sull'Agent Platform di Google Cloud a meno che questa variabile non fosse impostata su `true` |

464| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Imposta a qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di riprovare in caso di errori di sovraccarico ripetuti per ogni modello quando non è configurato alcun modello di fallback. **Impostarla a `0` o `false` attiva comunque questo comportamento**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare il comportamento predefinito dei nuovi tentativi. Senza di essa, Claude Code smette di riprovare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando ti autentichi con una chiave API o un [provider di terze parti](/docs/it/third-party-integrations) anziché con un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) che hai configurato in caso di errori di sovraccarico ripetuti per qualsiasi modello primario, quindi questa variabile non influisce sul passaggio a un modello di fallback |468| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Imposta su qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di riprovare in caso di errori di sovraccarico ripetuti per ogni modello quando non è configurato alcun modello di fallback. **Impostarla su `0` o `false` la abilita comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare il comportamento predefinito dei nuovi tentativi. Senza di essa, Claude Code smette di riprovare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando ti autentichi con una chiave API o un [provider di terze parti](/docs/it/third-party-integrations) anziché con un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla tua [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) configurata in caso di errori di sovraccarico ripetuti per qualsiasi modello principale, quindi questa variabile non influisce sul passaggio a un modello di fallback |

465| `FORCE_AUTOUPDATE_PLUGINS` | Imposta a `1` per forzare gli aggiornamenti automatici dei plugin anche quando l'aggiornamento automatico principale è disattivato tramite `DISABLE_AUTOUPDATER` |469| `FORCE_AUTOUPDATE_PLUGINS` | Imposta su `1` per forzare gli aggiornamenti automatici dei plugin anche quando l'aggiornamento automatico principale è disabilitato tramite `DISABLE_AUTOUPDATER` |

466| `FORCE_HYPERLINK` | Imposta a `1` per attivare i collegamenti ipertestuali OSC 8 cliccabili quando il tuo terminale li supporta ma non viene rilevato automaticamente, oppure a `0` per disattivarli. Quando non è impostata, Claude Code attiva i collegamenti ipertestuali solo quando rileva il supporto del terminale. Claude Code interpreta questo valore come un numero, non come un booleano, quindi un valore come `false`, `no` o `off` attiva i collegamenti ipertestuali anziché disattivarli. Il [badge della PR o della merge request](/docs/it/interactive-mode#pr-review-status) nel footer viene visualizzato come collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del terminale, ad esempio tramite SSH. Imposta `0` per visualizzare il badge come testo semplice |470| `FORCE_HYPERLINK` | Imposta su `1` per abilitare i collegamenti ipertestuali OSC 8 cliccabili quando il tuo terminale li supporta ma non viene rilevato automaticamente, oppure su `0` per disabilitarli. Quando non è impostata, Claude Code abilita i collegamenti ipertestuali solo quando rileva il supporto del terminale. Claude Code interpreta questo valore come un numero, non come un booleano, quindi un valore come `false`, `no` o `off` abilita i collegamenti ipertestuali anziché disabilitarli. Il [badge della PR o della merge request](/docs/it/interactive-mode#pr-review-status) nel piè di pagina viene visualizzato come collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del terminale, ad esempio tramite SSH. Imposta `0` per visualizzare il badge come testo semplice |

467| `FORCE_PROMPT_CACHING_5M` | Imposta a `1` per forzare il TTL della prompt cache di 5 minuti anche quando altrimenti si applicherebbe il TTL di 1 ora. Sovrascrive `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl` |471| `FORCE_PROMPT_CACHING_5M` | Imposta su `1` per forzare il TTL della cache del prompt di 5 minuti anche quando altrimenti si applicherebbe il TTL di 1 ora. Sovrascrive `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl` |

468| `HTTP_PROXY` | Specifica il server proxy HTTP per le connessioni di rete |472| `HTTP_PROXY` | Specifica il server proxy HTTP per le connessioni di rete |

469| `HTTPS_PROXY` | Specifica il server proxy HTTPS per le connessioni di rete |473| `HTTPS_PROXY` | Specifica il server proxy HTTPS per le connessioni di rete |

470| `IS_DEMO` | Imposta a qualsiasi valore non vuoto, come `1`, per attivare la modalità demo: nasconde la tua email e il nome dell'organizzazione dall'intestazione e dall'output di `/status`, e salta l'onboarding. **Impostarla a `0` o `false` attiva comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per disattivarla. Utile quando trasmetti in streaming o registri una sessione |474| `IS_DEMO` | Imposta su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde la tua email e il nome dell'organizzazione dall'intestazione e dall'output di `/status`, e salta l'onboarding. **Impostarla su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per disattivarla. Utile quando trasmetti in streaming o registri una sessione |

471| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code mostra un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) usano invece quel limite di caratteri per il contenuto testuale, ma il contenuto di tipo immagine di quegli strumenti è comunque soggetto a questa variabile (predefinito: 25000) |475| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code mostra un avviso quando l'output supera i 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) usano invece quel limite di caratteri per il contenuto testuale, ma il contenuto immagine di quegli strumenti è comunque soggetto a questa variabile (predefinito: 25000) |

472| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto a [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi falliti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di un [workflow](/docs/it/workflows) non supera la convalida. Il valore predefinito è 5, un primo tentativo più quattro nuovi tentativi |476| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la validazione rispetto a [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi falliti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di un [workflow](/docs/it/workflows) non supera la validazione. Il valore predefinito è 5, un primo tentativo più quattro nuovi tentativi |

473| `MAX_THINKING_TOKENS` | Budget fisso di token per il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token in meno rispetto al numero massimo di token di output della richiesta e mai sotto 1.024. Consulta `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per sapere come viene impostato quel limite. Quando non è impostata e il ragionamento è attivo, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la propria profondità di ragionamento, e gli altri modelli usano il limite. Imposta a `0` per disattivare il ragionamento sull'API Anthropic, tranne su Opus 5.5, Sonnet 5.5 e i modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), `0` omette invece il parametro `thinking`. Con il ragionamento disattivato sull'API Anthropic, Claude Code invia effort `high` anziché un livello superiore ai modelli che sa [non accettare quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Claude Code ignora i valori diversi da zero sui modelli con ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |477| `MAX_THINKING_TOKENS` | Budget fisso di token per il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token in meno rispetto al numero massimo di token di output della richiesta e mai sotto 1.024. Consulta `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non è impostata e il ragionamento è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono autonomamente la profondità del ragionamento, e gli altri modelli usano il limite. Imposta `0` per disabilitare il ragionamento sull'API Anthropic, tranne su Opus 5.5, Sonnet 5.5 e i modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), `0` omette invece il parametro `thinking`. Con il ragionamento disattivato sull'API Anthropic, Claude Code invia effort `high` invece di un livello più alto ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Per un valore positivo, Claude Code ignora il numero stesso sui modelli con ragionamento adattivo, tranne quando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |

474| `MCP_CLIENT_SECRET` | Client secret OAuth per i server MCP che richiedono [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita la richiesta interattiva quando aggiungi un server con `--client-secret` |478| `MCP_CLIENT_SECRET` | Client secret OAuth per i server MCP che richiedono [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita la richiesta interattiva quando aggiungi un server con `--client-secret` |

475| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio attende la connessione dei server MCP prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che completano la connessione. Imposta a `0` per fare in modo che Claude Code attenda la connessione dei server prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque attendere l'avvio, tranne quando vengono serviti dalla [cache di discovery](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code attende inoltre i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passi esplicitamente [`--mcp-config`](/docs/it/cli-reference#cli-flags), l'attesa ha una scadenza più lunga; consulta la voce di quel flag per l'eccezione relativa ai server in cache |479| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio attende la connessione dei server MCP prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che terminano. Imposta `0` per fare in modo che Claude Code attenda la connessione dei server prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque attendere l'avvio, tranne quando serviti dalla [cache di discovery](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code attende anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passi esplicitamente [`--mcp-config`](/docs/it/cli-reference#cli-flags), l'attesa ha una scadenza più lunga; consulta la voce di quel flag per l'eccezione dei server nella cache |

476| `MCP_CONNECT_TIMEOUT_MS` | Per quanto tempo, in millisecondi, l'avvio MCP bloccante attende il batch di connessioni prima di acquisire uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinta da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |480| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo l'avvio MCP bloccante attende, in millisecondi, il gruppo di connessioni prima di acquisire l'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinta da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |

477| `MCP_DISCOVERY_CACHE` | Attiva o disattiva la [cache di discovery MCP](/docs/it/mcp#server-status-detail). Con la cache attiva, un server HTTP o SSE remoto che hai già usato può mostrare lo [stato `cached`](/docs/it/mcp#server-status-detail), e Claude Code lo connette alla sua prima chiamata a uno strumento invece che all'avvio. La cache è disattivata per impostazione predefinita a meno che un rilascio graduale non l'abbia attivata per il tuo account. Imposta a `1` per attivarla, oppure a `0` per mantenerla disattivata anche quando il rilascio l'ha attivata. Prima della v2.1.238, la cache era attiva per impostazione predefinita. Lo stato `cached` richiede Claude Code v2.1.221 o successivo |481| `MCP_DISCOVERY_CACHE` | Attiva o disattiva la [cache di discovery MCP](/docs/it/mcp#server-status-detail). Con la cache attiva, un server HTTP o SSE remoto che hai già usato può mostrare lo [stato `cached`](/docs/it/mcp#server-status-detail), e Claude Code lo connette alla sua prima chiamata a uno strumento invece che all'avvio. La cache è disattivata per impostazione predefinita a meno che un rilascio graduale non l'abbia abilitata per il tuo account. Imposta `1` per attivarla, oppure `0` per mantenerla disattivata anche quando il rilascio l'ha abilitata. Prima della v2.1.238, la cache era attiva per impostazione predefinita. Lo stato `cached` richiede Claude Code v2.1.221 o successivo |

478| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Età massima, in secondi, di una voce della [cache di discovery](/docs/it/mcp#server-status-detail) (predefinito: 14400, ovvero 4 ore). A un avvio in cui la voce è più vecchia di tale valore, Claude Code la scarta e connette il server all'avvio, come fa con la cache disattivata. Claude Code limita il valore a 7 giorni. Prima della v2.1.238, il valore predefinito era 86400, ovvero 24 ore, e Claude Code non limitava il valore |482| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Età massima, in secondi, di una voce della [cache di discovery](/docs/it/mcp#server-status-detail) (predefinito: 14400, cioè 4 ore). A un avvio in cui la voce è più vecchia di così, Claude Code la scarta e connette il server all'avvio, come fa con la cache disattivata. Claude Code limita il valore a 7 giorni. Prima della v2.1.238, il valore predefinito era 86400, cioè 24 ore, e Claude Code non limitava il valore |

479| `MCP_DISCOVERY_CACHE_STRIKES` | A un avvio in cui una voce della [cache di discovery](/docs/it/mcp#server-status-detail) è più vecchia di `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la aggiorna in background. Questa variabile imposta quanti aggiornamenti consecutivi possono fallire prima che Claude Code scarti la voce e connetta invece il server all'avvio successivo (predefinito: 1). Aumentala se la tua connessione di rete cade occasionalmente, in modo che un singolo aggiornamento fallito non scarti la voce. Richiede Claude Code v2.1.238 o successivo |483| `MCP_DISCOVERY_CACHE_STRIKES` | A un avvio in cui una voce della [cache di discovery](/docs/it/mcp#server-status-detail) è più vecchia di `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la aggiorna in background. Questa variabile imposta quanti aggiornamenti consecutivi possono fallire prima che Claude Code scarti la voce e connetta invece il server all'avvio successivo (predefinito: 1). Aumentala se la tua connessione di rete cade occasionalmente, in modo che un singolo aggiornamento fallito non scarti la voce. Richiede Claude Code v2.1.238 o successivo |

480| `MCP_DISCOVERY_CACHE_TTL_S` | Secondi durante i quali Claude Code usa una voce della [cache di discovery](/docs/it/mcp#server-status-detail) senza aggiornarla (predefinito: 900). A un avvio in cui la voce è più vecchia di tale valore, Claude Code la usa comunque ma la aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code invece la scarta. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che per impostazione predefinita è 4 ore. Prima della v2.1.238, Claude Code non limitava il valore |484| `MCP_DISCOVERY_CACHE_TTL_S` | Secondi per i quali Claude Code usa una voce della [cache di discovery](/docs/it/mcp#server-status-detail) senza aggiornarla (predefinito: 900). A un avvio in cui la voce è più vecchia di così, Claude Code la usa comunque ma la aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la scarta invece. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che è di 4 ore per impostazione predefinita. Prima della v2.1.238, Claude Code non limitava il valore |

481| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, in alternativa a `--callback-port` quando aggiungi un server MCP con [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials) |485| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando aggiungi un server MCP con [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials) |

482| `MCP_PROTOCOL_NEGOTIATION` | Solo sul [runtime client MCP v2](/docs/it/mcp#mcp-client-runtimes), indica se Claude Code sonda i server per la revisione del protocollo MCP 2026-07-28. Imposta `auto` per sondare i server HTTP, i connettori claude.ai e i server stdio, oppure `legacy` per non sondarne nessuno. Con la variabile non impostata, Claude Code sonda i server descritti in [Runtime client MCP](/docs/it/mcp#mcp-client-runtimes). Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successiva |486| `MCP_PROTOCOL_NEGOTIATION` | Solo sul [runtime client MCP v2](/docs/it/mcp#mcp-client-runtimes), se Claude Code sonda i server per la revisione del protocollo MCP 2026-07-28. Imposta `auto` per sondare i server HTTP, i connettori claude.ai e i server stdio, oppure `legacy` per non sondarne nessuno. Con la variabile non impostata, Claude Code sonda i server descritti in [Runtime client MCP](/docs/it/mcp#mcp-client-runtimes). Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successivo |

483| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |487| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |

484| `MCP_SDK_GENERATION` | Fissa il [runtime client MCP](/docs/it/mcp#mcp-client-runtimes) con cui questo processo si connette ai server MCP: `v1`, basato su MCP TypeScript SDK 1.x, oppure `v2`, basato su [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Senza la variabile, Claude Code usa v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 verifica l'issuer che un server OAuth MCP restituisce nella sua risposta di autorizzazione e, quando non corrisponde, fa fallire l'accesso con un errore che inizia con `Issuer mismatch in authorization response`. Il runtime v1 non esegue questo controllo. Se imposti un valore non riconosciuto, Claude Code lo ignora e scrive un avviso nel log di debug. Claude Code legge il valore una volta per processo. Richiede Claude Code v2.1.218 o successivo |488| `MCP_SDK_GENERATION` | Fissa il [runtime client MCP](/docs/it/mcp#mcp-client-runtimes) con cui questo processo si connette ai server MCP: `v1`, basato su MCP TypeScript SDK 1.x, oppure `v2`, basato su [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Senza la variabile, Claude Code usa v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 verifica l'issuer che un server OAuth MCP restituisce nella sua risposta di autorizzazione e fa fallire l'accesso con un errore che inizia con `Issuer mismatch in authorization response` quando non corrisponde. Il runtime v1 non esegue questa verifica. Se imposti un valore non riconosciuto, Claude Code lo ignora e scrive un avviso nel log di debug. Claude Code legge il valore una volta per processo. Richiede Claude Code v2.1.218 o successivo |

485| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |489| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |

486| `MCP_TIMEOUT` | Timeout in millisecondi per l'avvio del server MCP (predefinito: 30000, ovvero 30 secondi) |490| `MCP_TIMEOUT` | Timeout in millisecondi per l'avvio del server MCP (predefinito: 30000, cioè 30 secondi) |

487| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione degli strumenti MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore di claude.ai, ogni richiesta va inoltre in timeout dopo 60 secondi per impostazione predefinita; imposta questa variabile, o il `timeout` per server, sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout complessivo di esecuzione dello strumento ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sovrascrive questo valore per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate agli strumenti di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo minimo richiede Claude Code v2.1.203 o successivo. Per la variabile di ambiente, i valori inferiori a 1000 vengono portati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |491| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione degli strumenti MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, anche ogni richiesta va in timeout dopo 60 secondi per impostazione predefinita; imposta questa variabile, o il `timeout` per server, sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout complessivo di esecuzione dello strumento ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sovrascrive questo valore per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate agli strumenti di quel server, in modo che `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompa mai prima; questa soglia minima richiede Claude Code v2.1.203 o successivo. Per la variabile d'ambiente, i valori inferiori a 1000 vengono portati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |

488| `NO_PROXY` | Elenco di domini e IP verso cui le richieste verranno inviate direttamente, bypassando il proxy |492| `NO_PROXY` | Elenco di domini e IP a cui le richieste verranno inviate direttamente, bypassando il proxy |

489| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard dell'SDK OpenTelemetry sulla lunghezza dei valori degli attributi. Claude Code limita gli attributi di telemetria contenenti contenuti al minore tra questo valore e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento resti entro il limite dell'SDK. Claude Code legge allo stesso modo le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, e il valore impostato più piccolo si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |493| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard dell'SDK OpenTelemetry sulla lunghezza dei valori degli attributi. Claude Code limita gli attributi di telemetria con contenuto al minore tra questo valore e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento rimanga entro il limite dell'SDK. Claude Code legge allo stesso modo le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, e il valore impostato più piccolo si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |

490| `OTEL_LOG_ASSISTANT_RESPONSES` | Imposta a `1` per includere il testo della risposta del modello negli eventi di log OpenTelemetry `assistant_response`. Quando non è impostata, Claude Code usa invece il valore di `OTEL_LOG_USER_PROMPTS`. Imposta a `0` per mantenere le risposte oscurate anche quando `OTEL_LOG_USER_PROMPTS` è impostata. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Richiede Claude Code v2.1.193 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |494| `OTEL_LOG_ASSISTANT_RESPONSES` | Imposta su `1` per includere il testo della risposta del modello negli eventi di log OpenTelemetry `assistant_response`. Quando non è impostata, Claude Code usa invece il valore di `OTEL_LOG_USER_PROMPTS`. Imposta `0` per mantenere le risposte oscurate anche quando `OTEL_LOG_USER_PROMPTS` è impostata. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Richiede Claude Code v2.1.193 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |

491| `OTEL_LOG_MANAGED_SETTINGS` | Imposta a `1` per aggiungere le impostazioni gestite oscurate, e un digest SHA-256 delle impostazioni prima dell'oscuramento, agli eventi di log OpenTelemetry `managed_settings_resolved`. Disattivata per impostazione predefinita. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite; un valore nelle impostazioni di progetto o locali non la attiva. Richiede Claude Code v2.1.274 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |495| `OTEL_LOG_MANAGED_SETTINGS` | Imposta su `1` per aggiungere le impostazioni gestite oscurate, e un digest SHA-256 delle impostazioni prima dell'oscuramento, agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitata per impostazione predefinita. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite; un valore nelle impostazioni di progetto o locali non la attiva. Richiede Claude Code v2.1.274 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |

492| `OTEL_LOG_RAW_API_BODIES` | Emette il JSON delle richieste e delle risposte dell'API Messages di Anthropic come eventi di log `api_request_body` / `api_response_body`. Imposta a `1` per i body inline troncati al limite di contenuto, oppure a `file:<dir>` per scrivere su disco i body non troncati ed emettere invece un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disattivata per impostazione predefinita; i body includono l'intera cronologia della conversazione. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |496| `OTEL_LOG_RAW_API_BODIES` | Emette il JSON delle richieste e delle risposte dell'API Messages di Anthropic come eventi di log `api_request_body` / `api_response_body`. Imposta `1` per corpi inline troncati al limite di contenuto, oppure `file:<dir>` per scrivere su disco i corpi non troncati ed emettere invece un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitata per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |

493| `OTEL_LOG_TOOL_CONTENT` | Imposta a `1` per includere il contenuto degli strumenti nell'evento span OpenTelemetry `tool.output`. Gli attributi degli span trasportano il contenuto degli strumenti in base ai [propri controlli](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracing](/docs/it/monitoring-usage#traces-beta). Disattivata per impostazione predefinita per proteggere i dati sensibili. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), fatta eccezione per i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |497| `OTEL_LOG_TOOL_CONTENT` | Imposta su `1` per includere il contenuto degli strumenti nell'evento di span OpenTelemetry `tool.output`. Gli attributi di span contengono il contenuto degli strumenti in base ai [propri controlli](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracing](/docs/it/monitoring-usage#traces-beta). Disabilitata per impostazione predefinita per proteggere i dati sensibili. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |

494| `OTEL_LOG_TOOL_DETAILS` | Imposta a `1` per includere gli argomenti di input degli strumenti; i nomi dei server MCP; i nomi dei workflow creati dagli utenti; le stringhe di errore grezze in caso di errori degli strumenti; la `category` del rifiuto negli eventi `api_refusal`; i nomi reali di agenti, skill, plugin e server MCP nelle [metriche di costo e token](/docs/it/monitoring-usage#cost-counter); e altri dettagli degli strumenti nelle metriche, nelle tracce e nei log di OpenTelemetry. Disattivata per impostazione predefinita per proteggere le PII. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), fatta eccezione per i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |498| `OTEL_LOG_TOOL_DETAILS` | Imposta su `1` per includere gli argomenti di input degli strumenti; i nomi dei server MCP; i nomi dei workflow creati dagli utenti; le stringhe di errore grezze in caso di errori degli strumenti; la `category` del rifiuto negli eventi `api_refusal`; i nomi reali di agenti, skill, plugin e server MCP nelle [metriche di costo e token](/docs/it/monitoring-usage#cost-counter); e altri dettagli degli strumenti nelle metriche, nelle tracce e nei log OpenTelemetry. Disabilitata per impostazione predefinita per proteggere le PII. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

495| `OTEL_LOG_USER_PROMPTS` | Imposta a `1` per includere il testo dei prompt dell'utente nelle tracce e nei log di OpenTelemetry. Disattivata per impostazione predefinita (i prompt vengono oscurati). Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), fatta eccezione per i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |499| `OTEL_LOG_USER_PROMPTS` | Imposta su `1` per includere il testo dei prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitata per impostazione predefinita (i prompt vengono oscurati). Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

496| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Imposta a `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |500| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Imposta su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

497| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Imposta a `true` per includere l'entrypoint della sessione negli attributi delle metriche (predefinito: escluso). Aggiunta nella v2.1.152. Consulta [Monitoraggio](/docs/it/monitoring-usage) |501| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Imposta su `true` per includere l'entrypoint della sessione negli attributi delle metriche (predefinito: escluso). Aggiunta nella v2.1.152. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

498| `OTEL_METRICS_INCLUDE_REPOSITORY` | Imposta a `true` per contrassegnare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Consulta [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |502| `OTEL_METRICS_INCLUDE_REPOSITORY` | Imposta su `true` per contrassegnare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Consulta [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |

499| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partire dalla v2.1.161, Claude Code associa le chiavi di `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei datapoint delle metriche. Imposta a `false` per escluderle (predefinito: incluse). Consulta [Monitoraggio](/docs/it/monitoring-usage#multi-team-organization-support) |503| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partire dalla v2.1.161, Claude Code associa le chiavi di `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei datapoint delle metriche. Imposta su `false` per escluderle (predefinito: incluse). Consulta [Monitoraggio](/docs/it/monitoring-usage#multi-team-organization-support) |

500| `OTEL_METRICS_INCLUDE_SESSION_ID` | Imposta a `false` per escludere l'ID della sessione dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |504| `OTEL_METRICS_INCLUDE_SESSION_ID` | Imposta su `false` per escludere l'ID di sessione dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

501| `OTEL_METRICS_INCLUDE_VERSION` | Imposta a `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |505| `OTEL_METRICS_INCLUDE_VERSION` | Imposta su `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

502| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sovrascrive il budget di caratteri per i metadati delle skill mostrati allo [strumento Skill](/docs/it/skills#control-who-invokes-a-skill). Il budget si adatta dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per compatibilità con le versioni precedenti |506| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sovrascrive il budget di caratteri per i metadati delle skill mostrati allo [strumento Skill](/docs/it/skills#control-who-invokes-a-skill). Il budget si adatta dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per retrocompatibilità |

503| `TASK_MAX_OUTPUT_LENGTH` | Rimossa nella v2.1.277 e ora senza effetto, insieme allo strumento `TaskOutput` di cui determinava la dimensione. In precedenza impostava il numero massimo di caratteri dell'output di un'[attività in background](/docs/it/tools-reference#background-commands) che lo strumento `TaskOutput` conservava. Claude legge invece il file di output di un'attività in background con `Read` |507| `TASK_MAX_OUTPUT_LENGTH` | Rimossa nella v2.1.277 e ora senza effetto, insieme allo strumento `TaskOutput` di cui definiva la dimensione. In precedenza impostava il numero massimo di caratteri dell'output di un'[attività in background](/docs/it/tools-reference#background-commands) che lo strumento `TaskOutput` conservava. Claude legge invece il file di output di un'attività in background con `Read` |

504| `USE_BUILTIN_RIPGREP` | Imposta a `0` per usare `rg` installato nel sistema invece di `rg` incluso con Claude Code |508| `USE_BUILTIN_RIPGREP` | Imposta su `0` per usare `rg` installato nel sistema invece di `rg` incluso con Claude Code |

505| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sovrascrive la regione per Claude 3.5 Haiku quando usi Google Cloud's Agent Platform |509| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sovrascrive la regione per Claude 3.5 Haiku quando usi l'Agent Platform di Google Cloud |

506| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sovrascrive la regione per Claude 3.5 Sonnet quando usi Google Cloud's Agent Platform |510| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sovrascrive la regione per Claude 3.5 Sonnet quando usi l'Agent Platform di Google Cloud |

507| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sovrascrive la regione per Claude 3.7 Sonnet quando usi Google Cloud's Agent Platform |511| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sovrascrive la regione per Claude 3.7 Sonnet quando usi l'Agent Platform di Google Cloud |

508| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sovrascrive la regione per Claude 4.0 Opus quando usi Google Cloud's Agent Platform |512| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sovrascrive la regione per Claude 4.0 Opus quando usi l'Agent Platform di Google Cloud |

509| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sovrascrive la regione per Claude 4.0 Sonnet quando usi Google Cloud's Agent Platform |513| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sovrascrive la regione per Claude 4.0 Sonnet quando usi l'Agent Platform di Google Cloud |

510| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sovrascrive la regione per Claude 4.1 Opus quando usi Google Cloud's Agent Platform |514| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sovrascrive la regione per Claude 4.1 Opus quando usi l'Agent Platform di Google Cloud |

511| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sovrascrive la regione per Claude Opus 4.5 quando usi Google Cloud's Agent Platform |515| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sovrascrive la regione per Claude Opus 4.5 quando usi l'Agent Platform di Google Cloud |

512| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sovrascrive la regione per Claude Sonnet 4.5 quando usi Google Cloud's Agent Platform |516| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sovrascrive la regione per Claude Sonnet 4.5 quando usi l'Agent Platform di Google Cloud |

513| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sovrascrive la regione per Claude Opus 4.6 quando usi Google Cloud's Agent Platform |517| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sovrascrive la regione per Claude Opus 4.6 quando usi l'Agent Platform di Google Cloud |

514| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sovrascrive la regione per Claude Sonnet 4.6 quando usi Google Cloud's Agent Platform |518| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sovrascrive la regione per Claude Sonnet 4.6 quando usi l'Agent Platform di Google Cloud |

515| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sovrascrive la regione per Claude Opus 4.7 quando usi Google Cloud's Agent Platform |519| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sovrascrive la regione per Claude Opus 4.7 quando usi l'Agent Platform di Google Cloud |

516| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sovrascrive la regione per Claude Opus 4.8 quando usi Google Cloud's Agent Platform |520| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sovrascrive la regione per Claude Opus 4.8 quando usi l'Agent Platform di Google Cloud |

517| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sovrascrive la regione per Claude Opus 5.5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.280 |521| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sovrascrive la regione per Claude Opus 5.5 quando usi l'Agent Platform di Google Cloud. Aggiunta nella v2.1.280 |

518| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5.5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.284 |522| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5.5 quando usi l'Agent Platform di Google Cloud. Aggiunta nella v2.1.284 |

519| `VERTEX_REGION_CLAUDE_5_OPUS` | Sovrascrive la regione per Claude Opus 5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.219 |523| `VERTEX_REGION_CLAUDE_5_OPUS` | Sovrascrive la regione per Claude Opus 5 quando usi l'Agent Platform di Google Cloud. Aggiunta nella v2.1.219 |

520| `VERTEX_REGION_CLAUDE_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.197 |524| `VERTEX_REGION_CLAUDE_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5 quando usi l'Agent Platform di Google Cloud. Aggiunta nella v2.1.197 |

521| `VERTEX_REGION_CLAUDE_FABLE_5` | Sovrascrive la regione per Claude Fable 5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.170 |525| `VERTEX_REGION_CLAUDE_FABLE_5` | Sovrascrive la regione per Claude Fable 5 quando usi l'Agent Platform di Google Cloud. Aggiunta nella v2.1.170 |

522| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sovrascrive la regione per Claude Fable 5.1 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.257 |526| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sovrascrive la regione per Claude Fable 5.1 quando usi l'Agent Platform di Google Cloud. Aggiunta nella v2.1.257 |

523| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sovrascrive la regione per Claude Haiku 4.5 quando usi Google Cloud's Agent Platform |527| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sovrascrive la regione per Claude Haiku 4.5 quando usi l'Agent Platform di Google Cloud |

524 528 

525Sono supportate anche le variabili standard dell'exporter OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e le varianti specifiche per segnale). Consulta [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.529Sono supportate anche le variabili standard degli exporter OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e le varianti specifiche per segnale). Consulta [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.

526 530 

527Imposta `CLAUDE_CODE_ENABLE_TELEMETRY` e le variabili OpenTelemetry che attivano l'esportazione, ne scelgono la destinazione o acquisiscono contenuti nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Claude Code [le ignora nelle impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), fatta eccezione per i valori di disattivazione descritti in quella sezione. `OTEL_RESOURCE_ATTRIBUTES` e le variabili di intervallo, timeout e compressione dell'esportazione, come `OTEL_METRIC_EXPORT_INTERVAL`, si applicano comunque dalle impostazioni di progetto e locali.531Imposta `CLAUDE_CODE_ENABLE_TELEMETRY` e le variabili OpenTelemetry che attivano l'esportazione, ne scelgono la destinazione o acquisiscono contenuti nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Claude Code [le ignora nelle impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. `OTEL_RESOURCE_ATTRIBUTES` e le variabili di intervallo, timeout e compressione dell'esportazione, come `OTEL_METRIC_EXPORT_INTERVAL`, si applicano comunque dalle impostazioni di progetto e locali.

532 

533<h2 id="what-the-subprocess-environment-scrub-removes">

534 Cosa rimuove la pulizia dell'ambiente dei sottoprocessi

535</h2>

536 

537Quando imposti [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) su `1`, Claude Code rimuove le credenziali dagli ambienti dei sottoprocessi che avvia, come i comandi Bash, gli hook e i server MCP stdio. Questo riduce ciò che un attacco di prompt injection può leggere tramite l'espansione della shell. Il processo di Claude Code mantiene le credenziali per le proprie chiamate API.

538 

539La pulizia riconosce una credenziale dal nome della variabile o dalla forma del suo valore, quindi usala come un livello insieme a [regole di permesso](/docs/it/permissions) ristrette, anziché come unico controllo.

540 

541La tabella mostra cosa fa la pulizia con alcune variabili di esempio:

542 

543| Variabile di esempio | Cosa fa la pulizia |

544| :- | :- |

545| `ANTHROPIC_API_KEY`, `AWS_SECRET_ACCESS_KEY` | La rimuove |

546| `NPM_TOKEN`, `DB_PASSWORD` | La rimuove, perché il nome sembra quello di una credenziale |

547| `DATABASE_URL` che contiene una password | La rimuove, perché il valore sembra una credenziale |

548| `PIP_INDEX_URL` o `NPM_CONFIG_REGISTRY` che contiene una password | Mantiene l'URL e ne elimina nome utente e password |

549| `CLAUDE_CONFIG_DIR` | La rimuove. Richiede Claude Code v2.1.251 o successivo |

550| `GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN` | La lascia invariata, in modo che `gh` e gli script che chiamano l'API di GitHub continuino a funzionare |

551| `HTTP_PROXY`, `HTTPS_PROXY` | La lascia invariata, inclusi [nome utente e password nell'URL](/docs/it/network-config#basic-authentication). La [sandbox](/docs/it/sandboxing#network-isolation) può impostare autonomamente queste variabili per i comandi eseguiti in sandbox |

552| `GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>` | La lascia invariata, qualunque cosa contenga |

553| Un segreto il cui nome di variabile e il cui valore non sembrano una credenziale | Lo lascia invariato |

554 

555Poiché la pulizia lascia invariato `GITHUB_TOKEN`, assegna a un job di GitHub Actions i `permissions` più ristretti di cui ha bisogno. Per rimuovere un token GitHub dai comandi Bash eseguiti in sandbox, aggiungi una voce `deny` in [`sandbox.credentials`](/docs/it/sandboxing#protect-credentials).

556 

557Lascia la pulizia non impostata se un sottoprocesso ha bisogno di una delle variabili rimosse.

558 

559Su Linux, la pulizia esegue inoltre i sottoprocessi Bash in un namespace PID isolato, in modo che non possano leggere gli ambienti dei processi host tramite `/proc`. Come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere i processi host né inviare loro segnali.

528 560 

529<h2 id="features-that-need-feature-flag-fetching">561<h2 id="features-that-need-feature-flag-fetching">

530 Funzionalità che richiedono il recupero dei feature flag562 Funzionalità che richiedono il recupero dei feature flag

531</h2>563</h2>

532 564 

533Claude Code attiva alcune funzionalità tramite feature flag che recupera da Anthropic. Claude Code salta questo recupero in queste sessioni:565Claude Code attiva alcune funzionalità tramite feature flag che recupera da Anthropic. Claude Code salta questo recupero nelle seguenti sessioni:

534 566 

535* Una sessione in cui impostate `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`; la riga di ogni variabile nella [tabella delle variabili](#variables) indica quali valori disattivano il recupero567* 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 recupero

536* Una sessione su un [provider di terze parti](/docs/it/third-party-integrations), come Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, o Microsoft Foundry, a meno che una piattaforma host che incorpora Claude Code non imposti `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`568* Una sessione su un [provider di terze parti](/docs/it/third-party-integrations), 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`

537* Una sessione di [gateway delle app Claude](/docs/it/claude-apps-gateway)569* Una sessione del [gateway delle app Claude](/docs/it/claude-apps-gateway)

538 570 

539Con il recupero disattivato, non potete:571Con il recupero disattivato, non puoi:

540 572 

541* Eseguire [`/auto-mode-setup`](/docs/it/auto-mode-config#generate-environment-entries) per elaborare le voci `autoMode.environment`573* Eseguire [`/auto-mode-setup`](/docs/it/auto-mode-config#generate-environment-entries) per creare una bozza delle voci `autoMode.environment`

542* Utilizzare [Remote Control](/docs/it/remote-control) con `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK` impostati. Per `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consultate i [requisiti di Remote Control](/docs/it/remote-control#requirements)574* Usare [Remote Control](/docs/it/remote-control) con `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK` impostati. Per `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulta i [requisiti di Remote Control](/docs/it/remote-control#requirements)

543* [Inviare messaggi alle sessioni oltre questa macchina](/docs/it/cross-session-messaging#message-sessions-on-other-machines) quando [Remote Control](/docs/it/remote-control#requirements) non è disponibile. La messaggistica tra sessioni su questa macchina funziona con il recupero disattivato575* [Inviare messaggi a sessioni al di fuori di questa macchina](/docs/it/cross-session-messaging#message-sessions-on-other-machines) quando [Remote Control](/docs/it/remote-control#requirements) non è disponibile. La messaggistica tra sessioni su questa macchina funziona con il recupero disattivato

544* Eseguire [`claude import` o il comando `/import`](/docs/it/cli-reference#cli-commands)576* Eseguire [`claude import` o il comando `/import`](/docs/it/cli-reference#cli-commands)

545* Eseguire [`/skill-doctor`](/docs/it/skills#find-unused-skills) o aprire il suo rapporto nella scheda **Stats** di `/plugin`577* Eseguire [`/skill-doctor`](/docs/it/skills#find-unused-skills) o aprirne il report nella scheda **Stats** di `/plugin`

546* Sincronizzare le [skill](/docs/it/skills#where-synced-skills-load) e i [plugin](/docs/it/plugins/loading#synced-plugins) abilitati per il vostro account claude.ai nelle vostre sessioni di terminale578* Sincronizzare le [skill](/docs/it/skills#where-synced-skills-load) e i [plugin](/docs/it/plugins/loading#synced-plugins) abilitati per il tuo account claude.ai nelle sessioni del terminale

547* Utilizzare [lo strumento advisor](/docs/it/advisor#requirements)579* Usare [lo strumento advisor](/docs/it/advisor#requirements)

548* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)580* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)

549* Far leggere a Claude [l'artefatto pubblico di un'altra organizzazione](/docs/it/artifacts#read-an-artifact-shared-with-you)581* Far leggere a Claude [l'artefatto pubblico di un'altra organizzazione](/docs/it/artifacts#read-an-artifact-shared-with-you)

550* Far sondare a Claude Code i server dei connettori claude.ai o i server stdio per [la revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes) a meno che non imposti `MCP_PROTOCOL_NEGOTIATION=auto`582* Far sondare a Claude Code i server dei connettori claude.ai o i server stdio per la [revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes), a meno che tu non imposti `MCP_PROTOCOL_NEGOTIATION=auto`

551* Ottenere lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) per impostazione predefinita per gli account claude.ai e Console su Windows con Git Bash installato; Claude Code instrada i comandi della shell attraverso Git Bash a meno che non impostiate `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Su Windows senza Git Bash, lo strumento rimane attivo583* Ottenere lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) per impostazione predefinita per gli account claude.ai e Console su Windows con Git Bash installato; Claude Code instrada i comandi della shell tramite Git Bash a meno che tu non imposti `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Su Windows senza Git Bash, lo strumento resta attivo

552* Ottenere il [feedback elaborato da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), che Claude Code attiva tramite un flag recuperato584* Ottenere il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), che Claude Code attiva tramite un flag recuperato

553* Far [trattare a Claude i grandi incollamenti come testo incollato piuttosto che digitato](/docs/it/terminal-config#how-claude-treats-pasted-text); il contenuto dietro un segnaposto `[Pasted text #N]` raggiunge Claude senza marcatura585* Fare in modo che Claude [tratti i contenuti incollati di grandi dimensioni come testo incollato anziché digitato](/docs/it/terminal-config#how-claude-treats-pasted-text); il contenuto dietro un segnaposto `[Pasted text #N]` raggiunge Claude senza contrassegni

554* Avere Claude Code [escludere i tool MCP il cui schema di input l'API rifiuterebbe](/docs/it/mcp#tools-with-invalid-input-schemas); invia comunque lo schema, e una richiesta che lo include fallisce con [un errore 400 che nomina il tool in base alla sua posizione](/docs/it/errors#tool-input-schema-is-invalid)586* Fare in modo che Claude Code [escluda gli strumenti MCP il cui schema di input verrebbe rifiutato dall'API](/docs/it/mcp#tools-with-invalid-input-schemas); Claude Code invia comunque lo schema, e una richiesta che lo include fallisce con [un errore 400 che identifica lo strumento in base alla sua posizione](/docs/it/errors#tool-input-schema-is-invalid)

555 587 

556<h3 id="first-session-after-an-install-or-upgrade">588<h3 id="first-session-after-an-install-or-upgrade">

557 Prima sessione dopo un'installazione o un aggiornamento589 Prima sessione dopo un'installazione o un aggiornamento

558</h3>590</h3>

559 591 

560Nella vostra prima sessione dopo aver installato Claude Code, o aggiornato a una versione che aggiunge una funzionalità, una [funzionalità con gate flag](#features-that-need-feature-flag-fetching) può mancare. Quella sessione può anche avviarsi in una diversa [modalità di autorizzazione](/docs/it/permission-modes#which-mode-a-session-starts-in) rispetto alle vostre sessioni successive. Claude Code recupera i flag durante quella sessione, quindi la vostra sessione successiva ha la funzionalità e la modalità di autorizzazione iniziale usuale.592Nella prima sessione dopo aver installato Claude Code, o dopo aver eseguito l'aggiornamento a una versione che aggiunge una funzionalità, una [funzionalità controllata da flag](#features-that-need-feature-flag-fetching) può mancare. Quella sessione può anche avviarsi in una [modalità di permesso](/docs/it/permission-modes#which-mode-a-session-starts-in) diversa da quella delle sessioni successive. Quando Claude Code recupera i flag durante quella sessione, li salva sulla macchina, quindi la sessione successiva su quella macchina dispone della funzionalità e della consueta modalità di permesso iniziale.

593 

594Dopo una nuova installazione, in una sessione non interattiva come `claude -p`, l'Agent SDK o l'estensione VS Code, Claude Code può acquisire i flag prima di [scegliere la modalità di permesso iniziale](/docs/it/permission-modes#which-mode-a-session-starts-in), ma non sempre li attende.

595 

596In configurazioni come queste, anche le sessioni successive alla prima si avviano senza flag recuperati di recente:

597 

598* **Un ambiente pulito a ogni esecuzione**: se ogni esecuzione parte in un container CI, o in qualsiasi altro ambiente privo dei flag salvati da una sessione precedente, ogni esecuzione è una prima sessione

599* **Un token del gateway senza chiave API**: se ti autentichi con `ANTHROPIC_AUTH_TOKEN` e nessuna chiave API, e `ANTHROPIC_BASE_URL` punta a un host diverso da quello di Anthropic, come un [gateway LLM](/docs/it/llm-gateway), Claude Code non dispone di credenziali con cui recuperare i flag

561 600 

562Dopo un'installazione pulita, in una sessione non interattiva come `claude -p`, l'Agent SDK, o l'estensione VS Code, Claude Code può comunque recuperare i flag prima di [scegliere la modalità di autorizzazione iniziale](/docs/it/permission-modes#which-mode-a-session-starts-in).601Per scegliere la modalità di permesso in cui si avviano le sessioni in queste configurazioni, consulta [Avviare in una modalità di permesso diversa](/docs/it/permission-modes#start-in-a-different-mode).

563 602 

564<h2 id="see-also">603<h2 id="see-also">

565 Vedi anche604 Vedi anche

errors.md +19 −1

Details

366| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Avvisi di configurazione](#malformed-tool-content-rule) |366| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Avvisi di configurazione](#malformed-tool-content-rule) |

367| `... is not matched by file permission checks` | [Avvisi di configurazione](#is-not-matched-by-file-permission-checks) |367| `... is not matched by file permission checks` | [Avvisi di configurazione](#is-not-matched-by-file-permission-checks) |

368| `... has a wildcard before the rest of the command` | [Avvisi di configurazione](#has-a-wildcard-before-the-rest-of-the-command) |368| `... has a wildcard before the rest of the command` | [Avvisi di configurazione](#has-a-wildcard-before-the-rest-of-the-command) |

369| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Avvisi di configurazione](#denying-bash-also-turns-off-the-powershell-tool) |

369| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Avvisi di configurazione](#the-200k-limit-isnt-enforced) |370| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Avvisi di configurazione](#the-200k-limit-isnt-enforced) |

370| `[claude-code:unrecognized_model]` | [Avvisi di configurazione](#unrecognized-model-id-on-a-request) |371| `[claude-code:unrecognized_model]` | [Avvisi di configurazione](#unrecognized-model-id-on-a-request) |

371| `Stale sandbox mask files left by a killed session` | [Avvisi di configurazione](#stale-sandbox-mask-files-left-by-a-killed-session) |372| `Stale sandbox mask files left by a killed session` | [Avvisi di configurazione](#stale-sandbox-mask-files-left-by-a-killed-session) |


846**Cosa fare:**847**Cosa fare:**

847 848 

848* Su Pro e Max, aumenta il tuo limite di spesa mensile in [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai, o esegui `/usage-credits`849* Su Pro e Max, aumenta il tuo limite di spesa mensile in [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai, o esegui `/usage-credits`

849* Su Team ed Enterprise, aumenta il limite in [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) se gestisci la fatturazione, o chiedi a un amministratore di farlo. `/usage-credits` invia quella richiesta al tuo amministratore per te850* Su Team ed Enterprise, aumenta il limite in [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) se gestisci la fatturazione, o chiedi a un amministratore di farlo. `/usage-credits` invia quella richiesta al tuo amministratore per te

850* Per il limite di un canale, chiedi a un proprietario dell'organizzazione o al manager del canale di aumentarlo su claude.ai. Vedi [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) nella documentazione Claude Tag851* Per il limite di un canale, chiedi a un proprietario dell'organizzazione o al manager del canale di aumentarlo su claude.ai. Vedi [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) nella documentazione Claude Tag

851* Se il messaggio nomina un'ora di ripristino per la finestra del tuo piano, puoi aspettare invece852* Se il messaggio nomina un'ora di ripristino per la finestra del tuo piano, puoi aspettare invece

852* Esegui `/usage` per vedere le finestre del tuo piano e quando ciascuna si ripristina853* Esegui `/usage` per vedere le finestre del tuo piano e quando ciascuna si ripristina


5636 5637 

5637In una [sessione in background](/docs/it/agent-view) o con `--output-format json` o `stream-json`, Claude Code scrive l'avviso al log di debug invece di stderr, quindi l'output letto dalla macchina rimane pulito. Eseguire con `--debug` per catturarlo in `~/.claude/debug/<session-id>.txt`. Prima della v2.1.246, Claude Code accettava queste regole senza un avviso.5638In una [sessione in background](/docs/it/agent-view) o con `--output-format json` o `stream-json`, Claude Code scrive l'avviso al log di debug invece di stderr, quindi l'output letto dalla macchina rimane pulito. Eseguire con `--debug` per catturarlo in `~/.claude/debug/<session-id>.txt`. Prima della v2.1.246, Claude Code accettava queste regole senza un avviso.

5638 5639 

5640<h3 id="denying-bash-also-turns-off-the-powershell-tool">

5641 Denying Bash also turns off the PowerShell tool

5642</h3>

5643 

5644Hai rimosso l'intero strumento Bash, ad esempio con `--disallowedTools Bash` oppure con una [regola deny](/docs/it/permissions#match-all-uses-of-a-tool) `Bash` o `Bash(*)` senza altre specifiche in uno dei tuoi file di impostazioni. Su Windows con Git Bash installato, [negare Bash disattiva anche lo strumento PowerShell](/docs/it/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), quindi la sessione si avvia senza alcuno strumento shell. Claude Code stampa questo avviso all'avvio:

5645 

5646```text theme={null}

5647Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.

5648```

5649 

5650**Cosa fare:**

5651 

5652* Per far usare PowerShell a Claude, imposta [`CLAUDE_CODE_USE_POWERSHELL_TOOL`](/docs/it/env-vars) su `1` nel tuo ambiente o nel blocco `env` di un file di impostazioni, come mostrato in [Attivare lo strumento PowerShell](/docs/it/tools-reference#enable-the-powershell-tool). Lo strumento PowerShell resta quindi attivo insieme alla tua regola deny per Bash.

5653* Per bloccare comandi specifici invece dell'intero strumento, sostituisci la voce `Bash` generica con regole circoscritte come `Bash(git push *)` nello stesso file di impostazioni o flag. Claude mantiene lo strumento Bash, e lo strumento PowerShell resta disattivato finché non imposti anche la variabile o aggiungi una [regola di permesso `PowerShell`](/docs/it/permissions#powershell) circoscritta.

5654 

5655In una [sessione in background](/docs/it/agent-view) o con `--output-format json` o `stream-json`, Claude Code scrive l'avviso nel log di debug anziché su stderr. Esegui con `--debug` per acquisirlo in `~/.claude/debug/<session-id>.txt`. Prima della v2.1.287, Claude Code disattivava lo strumento PowerShell allo stesso modo senza stampare alcun avviso.

5656 

5639<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">5657<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">

5640 crossSessionInbound deve essere uno di accept, hold, refuse5658 crossSessionInbound deve essere uno di accept, hold, refuse

5641</h3>5659</h3>

fast-mode.md +2 −2

Details

138* **Solo API Anthropic o abbonamento**: la modalità veloce è disponibile tramite l'API Anthropic Console e per i piani di abbonamento Claude utilizzando i crediti di utilizzo. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o Claude Platform su AWS. Le organizzazioni Console devono anche avere [accesso alla modalità veloce provisioning](#enable-fast-mode-for-your-organization).138* **Solo API Anthropic o abbonamento**: la modalità veloce è disponibile tramite l'API Anthropic Console e per i piani di abbonamento Claude utilizzando i crediti di utilizzo. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o Claude Platform su AWS. Le organizzazioni Console devono anche avere [accesso alla modalità veloce provisioning](#enable-fast-mode-for-your-organization).

139* **Crediti di utilizzo abilitati per i piani di abbonamento**: su un piano Pro, Max, Team o Enterprise, il tuo account deve avere i [crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription) abilitati, che consente la fatturazione oltre l'utilizzo incluso nel tuo piano. Finché non sono abilitati, `/fast` mostra "Fast mode requires usage credits". Come abilitarli dipende dal tuo piano:139* **Crediti di utilizzo abilitati per i piani di abbonamento**: su un piano Pro, Max, Team o Enterprise, il tuo account deve avere i [crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription) abilitati, che consente la fatturazione oltre l'utilizzo incluso nel tuo piano. Finché non sono abilitati, `/fast` mostra "Fast mode requires usage credits". Come abilitarli dipende dal tuo piano:

140 * Su Pro e Max, abilitali nella sezione **Usage credits** di [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai, oppure esegui `/usage-credits` per aprire quella pagina.140 * Su Pro e Max, abilitali nella sezione **Usage credits** di [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai, oppure esegui `/usage-credits` per aprire quella pagina.

141 * Su Team e Enterprise, un membro con accesso alla fatturazione li abilita per l'organizzazione in [**Admin settings > Usage**](https://claude.ai/admin-settings/usage), e un membro senza accesso esegue `/usage-credits` per inviare una richiesta agli amministratori dell'organizzazione.141 * Su Team e Enterprise, un membro con accesso alla fatturazione li abilita per l'organizzazione in [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), e un membro senza accesso esegue `/usage-credits` per inviare una richiesta agli amministratori dell'organizzazione.

142 142 

143<Note>143<Note>

144 L'utilizzo della modalità veloce viene fatturato direttamente dai crediti di utilizzo, anche se hai un utilizzo rimanente nel tuo piano.144 L'utilizzo della modalità veloce viene fatturato direttamente dai crediti di utilizzo, anche se hai un utilizzo rimanente nel tuo piano.


165* **Console** (clienti API): un amministratore la abilita in [Preferenze Claude Code](https://platform.claude.com/claude-code/preferences). La modalità veloce è in [anteprima di ricerca](#research-preview), quindi la tua organizzazione deve anche avere accesso alla modalità veloce provisioning prima che le richieste di modalità veloce abbiano successo. Per ottenere l'accesso, contatta il tuo account manager o iscriviti alla lista d'attesa, come descritto in [modalità veloce sull'API Claude](https://platform.claude.com/docs/en/build-with-claude/fast-mode).165* **Console** (clienti API): un amministratore la abilita in [Preferenze Claude Code](https://platform.claude.com/claude-code/preferences). La modalità veloce è in [anteprima di ricerca](#research-preview), quindi la tua organizzazione deve anche avere accesso alla modalità veloce provisioning prima che le richieste di modalità veloce abbiano successo. Per ottenere l'accesso, contatta il tuo account manager o iscriviti alla lista d'attesa, come descritto in [modalità veloce sull'API Claude](https://platform.claude.com/docs/en/build-with-claude/fast-mode).

166 166 

167 Senza accesso provisioning, l'API rifiuta ogni richiesta di modalità veloce con un 429, e Claude Code tratta ogni rifiuto come un [limite di velocità della modalità veloce](#handle-rate-limits). A differenza del cooldown di un limite di velocità, i rifiuti continuano fino a quando l'accesso non viene provisioning.167 Senza accesso provisioning, l'API rifiuta ogni richiesta di modalità veloce con un 429, e Claude Code tratta ogni rifiuto come un [limite di velocità della modalità veloce](#handle-rate-limits). A differenza del cooldown di un limite di velocità, i rifiuti continuano fino a quando l'accesso non viene provisioning.

168* **Claude AI** (Team e Enterprise): un proprietario la abilita in [Admin Settings > Claude Code](https://claude.ai/admin-settings/claude-code)168* **Claude AI** (Team e Enterprise): un Owner la abilita in [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code)

169 169 

170Un'altra opzione per disabilitare completamente la modalità veloce è impostare `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Vedi [Variabili di ambiente](/docs/it/env-vars).170Un'altra opzione per disabilitare completamente la modalità veloce è impostare `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Vedi [Variabili di ambiente](/docs/it/env-vars).

171 171 

Details

248| **Subagents** | Quando generati | Contesto fresco con skills specificate, o la conversazione principale per un [fork](/docs/it/sub-agents#fork-the-current-conversation) | Isolato dalla sessione principale |248| **Subagents** | Quando generati | Contesto fresco con skills specificate, o la conversazione principale per un [fork](/docs/it/sub-agents#fork-the-current-conversation) | Isolato dalla sessione principale |

249| **Hooks** | Al trigger | Niente (viene eseguito esternamente) | Zero, a meno che l'hook non restituisca contesto aggiuntivo |249| **Hooks** | Al trigger | Niente (viene eseguito esternamente) | Zero, a meno che l'hook non restituisca contesto aggiuntivo |

250 250 

251\*Per impostazione predefinita, le descrizioni delle skills si caricano all'inizio della sessione in modo che Claude possa decidere quando utilizzarle. Impostate `disable-model-invocation: true` nel frontmatter di una skill per nasconderla completamente a Claude fino a quando non la invocate manualmente. Per una skill che non avete scritto, impostate [`skillOverrides`](/docs/it/skills#override-skill-visibility-from-settings) nelle impostazioni per fare lo stesso senza modificare il suo file.251\*Imposta [`disable-model-invocation: true`](/docs/it/skills#control-who-invokes-a-skill) nel frontmatter di una skill per tenere la sua descrizione fuori dal contesto di Claude. Per una skill che non hai scritto, imposta [`skillOverrides`](/docs/it/skills#override-skill-visibility-from-settings) nelle impostazioni per fare lo stesso senza modificare il suo file.

252 252 

253<h3 id="understand-how-features-load">253<h3 id="understand-how-features-load">

254 Comprendete come le funzionalità si caricano254 Comprendete come le funzionalità si caricano


278 278 

279 **Cosa si carica:** Per le skills invocabili dal modello, Claude vede nomi e descrizioni in ogni richiesta. Quando invocate una skill con `/<name>` o Claude la carica automaticamente, il contenuto completo si carica nella vostra conversazione.279 **Cosa si carica:** Per le skills invocabili dal modello, Claude vede nomi e descrizioni in ogni richiesta. Quando invocate una skill con `/<name>` o Claude la carica automaticamente, il contenuto completo si carica nella vostra conversazione.

280 280 

281 **Come Claude sceglie le skills:** Claude abbina il vostro compito alle descrizioni delle skills per decidere quali sono rilevanti. Se le descrizioni sono vaghe o si sovrappongono, Claude potrebbe caricare la skill sbagliata o perderne una che aiuterebbe. Per dire a Claude di utilizzare una skill specifica, invocatela con `/<name>`. Le skills con `disable-model-invocation: true` sono invisibili a Claude fino a quando non le invocate.281 **Come Claude sceglie le skill:** Claude confronta il tuo compito con le descrizioni delle skill per decidere quali sono rilevanti. Se le descrizioni sono vaghe o si sovrappongono, Claude potrebbe caricare la skill sbagliata o tralasciarne una che sarebbe utile. Per dire a Claude di utilizzare una skill specifica, invocala con `/<name>`.

282 282 

283 **Costo del contesto:** Basso fino a quando non vengono utilizzate. Le skills solo utente hanno costo zero fino a quando non vengono invocate.283 **Costo del contesto:** Basso fino a quando non vengono utilizzate. Le skills solo utente hanno costo zero fino a quando non vengono invocate.

284 284 

285 **Nei subagents:** Le skills funzionano diversamente nei subagents. Invece del caricamento su richiesta, le skills elencate nel campo `skills:` dell'agente vengono completamente precaricate nel suo contesto all'avvio. I subagents possono comunque scoprire e invocare skills di progetto, utente e plugin non elencate attraverso lo strumento Skill.285 **Nei subagents:** Le skills funzionano diversamente nei subagents. Invece del caricamento su richiesta, le skills elencate nel campo `skills:` dell'agente vengono completamente precaricate nel suo contesto all'avvio. I subagents possono comunque scoprire e invocare skills di progetto, utente e plugin non elencate attraverso lo strumento Skill.

286 286 

287 <Tip>Utilizzate `disable-model-invocation: true` per le skills con effetti collaterali. Questo risparmia contesto e assicura che solo voi le attiviate.</Tip>287 <Tip>Utilizza `disable-model-invocation: true` per le skill con effetti collaterali. Questo risparmia contesto e assicura che vengano eseguite solo quando le richiami per nome.</Tip>

288 </Tab>288 </Tab>

289 289 

290 <Tab title="Server MCP">290 <Tab title="Server MCP">

fullscreen.md +2 −2

Details

107* **Scorrere un elenco in overflow con la sua barra di scorrimento.** In pannelli di elenco come `/skills`, `/mcp` e l'elenco Installed di `/plugin`, una barra di scorrimento appare accanto a un elenco con più righe di quante ne stiano mentre il puntatore si trova sopra di esso. Fare clic sulla traccia per saltare a quel punto, o trascinare il pollice. Richiede Claude Code v2.1.281 o successivo.107* **Scorrere un elenco in overflow con la sua barra di scorrimento.** In pannelli di elenco come `/skills`, `/mcp` e l'elenco Installed di `/plugin`, una barra di scorrimento appare accanto a un elenco con più righe di quante ne stiano mentre il puntatore si trova sopra di esso. Fare clic sulla traccia per saltare a quel punto, o trascinare il pollice. Richiede Claude Code v2.1.281 o successivo.

108 * Dove la barra ha le frecce `↑` e `↓` alle estremità, fare clic su una freccia per scorrere di una singola riga, o tenerla premuta per continuare a scorrere. Le frecce richiedono Claude Code v2.1.286 o successivo.108 * Dove la barra ha le frecce `↑` e `↓` alle estremità, fare clic su una freccia per scorrere di una singola riga, o tenerla premuta per continuare a scorrere. Le frecce richiedono Claude Code v2.1.286 o successivo.

109* **Fare clic sulla riga `↑ N more` o `↓ N more` al bordo di un elenco** per saltare a quell'estremità dell'elenco senza scegliere un'opzione. Richiede Claude Code v2.1.286 o successivo.109* **Fare clic sulla riga `↑ N more` o `↓ N more` al bordo di un elenco** per saltare a quell'estremità dell'elenco senza scegliere un'opzione. Richiede Claude Code v2.1.286 o successivo.

110* **Fare clic su un risultato dello strumento compresso** per espanderlo e vedere l'output completo. Fare clic di nuovo per comprimerlo. La chiamata dello strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.110* **Fare clic su un risultato dello strumento compresso** per espanderlo e vedere l'output completo. Fare clic di nuovo per comprimerlo. La chiamata allo strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.

111 * Fare clic espande anche l'output di un comando shell `!`, sia un risultato troncato più vecchio che la riga di progresso in tempo reale mentre il comando è in esecuzione. Richiede Claude Code v2.1.257 o successivo.111 * Fare clic espande anche l'output di un comando shell `!`, sia un risultato troncato più vecchio che la riga di progresso in tempo reale mentre il comando è in esecuzione. Richiede Claude Code v2.1.257 o successivo.

112 * Fare clic espande anche una riga `Message from @<sender>` attenuata quando il mittente è un [collega di squadra](/docs/it/agent-teams) o un altro agente in esecuzione nella vostra sessione. La riga per un messaggio da [una delle vostre altre sessioni](/docs/it/cross-session-messaging#what-a-message-looks-like) mostra anche la prima riga del messaggio e non è cliccabile, quindi premete `Ctrl+o` per leggere quella.112 * Fare clic espande anche una riga `Message from @<sender>` attenuata quando il mittente è un [collega di squadra](/docs/it/agent-teams) o un altro agente in esecuzione nella tua sessione.

113* **Tenere premuto `Cmd` su macOS, o `Ctrl` su Linux e Windows, e fare clic su un URL o un percorso di file** per aprirlo. Gli URL semplici `http://` e `https://` si aprono nel browser, e i percorsi di file nell'output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell'applicazione predefinita. Un semplice clic senza il modificatore non apre i link, corrispondendo al comportamento nativo del terminale.113* **Tenere premuto `Cmd` su macOS, o `Ctrl` su Linux e Windows, e fare clic su un URL o un percorso di file** per aprirlo. Gli URL semplici `http://` e `https://` si aprono nel browser, e i percorsi di file nell'output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell'applicazione predefinita. Un semplice clic senza il modificatore non apre i link, corrispondendo al comportamento nativo del terminale.

114 * Claude Code esegue il rendering di un percorso di rete (UNC), come `\\server\share\file.ts`, come testo semplice senza link, perché aprire un percorso di rete può inviare le credenziali di Windows all'host che nomina.114 * Claude Code esegue il rendering di un percorso di rete (UNC), come `\\server\share\file.ts`, come testo semplice senza link, perché aprire un percorso di rete può inviare le credenziali di Windows all'host che nomina.

115 * Alcuni terminali macOS inoltrano `Cmd`+clic all'app in esecuzione invece di aprire il link da soli, e il protocollo del mouse del terminale non ha modo di codificare il tasto `Cmd`, quindi Claude Code riceve un semplice clic. In Ghostty, e in Warp su macOS, Claude Code lo rileva e consente a un semplice clic su un link di aprirlo, e tenere premuto `Cmd` funziona ancora.115 * Alcuni terminali macOS inoltrano `Cmd`+clic all'app in esecuzione invece di aprire il link da soli, e il protocollo del mouse del terminale non ha modo di codificare il tasto `Cmd`, quindi Claude Code riceve un semplice clic. In Ghostty, e in Warp su macOS, Claude Code lo rileva e consente a un semplice clic su un link di aprirlo, e tenere premuto `Cmd` funziona ancora.

Details

295 295 

296Quando questi controlli trovano un modello che il tuo progetto non può invocare, Claude Code ricorda il rifiuto su questa macchina per un massimo di un giorno, e durante quel tempo i lanci saltano il modello ricordato senza chiedere di nuovo ad Agent Platform. Claude Code controlla un rifiuto ricordato di un modello predefinito corrente di nuovo al lancio una volta che sono passati dieci minuti dall'ultimo controllo, quindi un valore predefinito che il tuo amministratore riabilita ritorna. Per disattivare la memoria, imposta [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/it/env-vars).296Quando questi controlli trovano un modello che il tuo progetto non può invocare, Claude Code ricorda il rifiuto su questa macchina per un massimo di un giorno, e durante quel tempo i lanci saltano il modello ricordato senza chiedere di nuovo ad Agent Platform. Claude Code controlla un rifiuto ricordato di un modello predefinito corrente di nuovo al lancio una volta che sono passati dieci minuti dall'ultimo controllo, quindi un valore predefinito che il tuo amministratore riabilita ritorna. Per disattivare la memoria, imposta [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/it/env-vars).

297 297 

298<h3 id="when-your-organization-enforces-a-model-allowlist">

299 Quando la tua organizzazione applica un'allowlist dei modelli

300</h3>

301 

302Se imposti [`enforceAvailableModels`](/docs/it/model-config#enforce-the-allowlist-for-the-default-model) nelle impostazioni gestite, i controlli del modello all'avvio usano solo i modelli consentiti dal tuo elenco `availableModels`. Questo richiede Claude Code v2.1.287 o successivo. Un elenco senza `enforceAvailableModels` non limita questi controlli.

303 

304I controlli confrontano ogni voce con l'ID modello che invierebbero ad Agent Platform, quindi scrivi l'elenco usando quegli ID. Questo esempio consente Opus 4.8 e Sonnet 4.5:

305 

306```json theme={null}

307{

308 "availableModels": ["claude-opus-4-8", "claude-sonnet-4-5@20250929"],

309 "enforceAvailableModels": true

310}

311```

312 

313Per alias, prefissi di versione e voci `modelOverrides`, consulta [Fissare i modelli per i deploy di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments).

314 

298<h3 id="when-a-model-is-disabled-mid-session">315<h3 id="when-a-model-is-disabled-mid-session">

299 Quando un modello è disabilitato durante la sessione316 Quando un modello è disabilitato durante la sessione

300</h3>317</h3>

headless.md +1 −1

Details

59| Aggiunte al prompt di sistema | `--append-system-prompt`, `--append-system-prompt-file` |59| Aggiunte al prompt di sistema | `--append-system-prompt`, `--append-system-prompt-file` |

60| Impostazioni | `--settings <file-or-json>` |60| Impostazioni | `--settings <file-or-json>` |

61| Server MCP | `--mcp-config <file-or-json>` |61| Server MCP | `--mcp-config <file-or-json>` |

62| Agenti personalizzati | `--agents <json>` |62| [Agenti personalizzati](/docs/it/sub-agents#choose-the-subagent-scope) | `--agents <file-or-json>` |

63| Un plugin | `--plugin-dir <path>`, `--plugin-url <url>` |63| Un plugin | `--plugin-dir <path>`, `--plugin-url <url>` |

64 64 

65La modalità bare limita anche ciò che accade durante l'esecuzione della sessione:65La modalità bare limita anche ciò che accade durante l'esecuzione della sessione:

hooks.md +46 −10

Details

438| Campo | Obbligatorio | Descrizione |438| Campo | Obbligatorio | Descrizione |

439| :- | :- | :- |439| :- | :- | :- |

440| `type` | sì | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"`, o `"agent"` |440| `type` | sì | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"`, o `"agent"` |

441| `if` | no | Sintassi della regola di permesso per filtrare quando questo hook viene eseguito, come `"Bash(git *)"` o `"Edit(*.ts)"`. Il comando hook viene eseguito solo se la chiamata dello strumento corrisponde al pattern. Vedi la tabella [Bash matching](#bash-if-matching) sotto per come i pattern Bash vengono valutati rispetto ai sottocomandi, `$()`, e backtick. Valutato solo su eventi dello strumento: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, e `PermissionDenied`. Su altri eventi, un hook con `if` impostato non viene mai eseguito. Utilizza la stessa sintassi delle [regole di permesso](/docs/it/permissions) |441| `if` | no | [Sintassi delle regole di permesso](/docs/it/permissions#permission-rule-syntax) per filtrare quando questo hook viene eseguito, come `"Bash(git *)"` o `"Edit(*.ts)"`. Il comando hook viene eseguito solo se la chiamata allo strumento corrisponde al pattern. Vedi la [tabella di corrispondenza Bash](#bash-if-matching) per come i pattern Bash vengono valutati rispetto ai sottocomandi, `$()`, e backtick. Valutato solo su eventi dello strumento: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, e `PermissionDenied`. Su altri eventi, un hook con `if` impostato non viene mai eseguito |

442| `timeout` | no | Secondi prima di annullare. Claude Code non lo applica su un hook di comando che esegui con [`async: true`](#run-hooks-in-the-background). Impostazioni predefinite: 600 per `command`, `http`, e `mcp_tool`; 30 per `prompt`; 60 per `agent`. Claude Code abbassa l'impostazione predefinita di `command`, `http`, e `mcp_tool` a 30 su [`UserPromptSubmit`](#userpromptsubmit), [`PreModelSwitch`](#premodelswitch), e [`PostModelSwitch`](#postmodelswitch), e a 10 su [`MessageDisplay`](#messagedisplay). Gli hook [`SessionEnd`](#sessionend) condividono un budget di 1,5 secondi; se le tue impostazioni impostano un `timeout` per hook più lungo, Claude Code aumenta il budget per corrispondere, fino a 60 secondi |442| `timeout` | no | Secondi prima di annullare. Claude Code non lo applica su un hook di comando che esegui con [`async: true`](#run-hooks-in-the-background). Impostazioni predefinite: 600 per `command`, `http`, e `mcp_tool`; 30 per `prompt`; 60 per `agent`. Claude Code abbassa l'impostazione predefinita di `command`, `http`, e `mcp_tool` a 30 su [`UserPromptSubmit`](#userpromptsubmit), [`PreModelSwitch`](#premodelswitch), e [`PostModelSwitch`](#postmodelswitch), e a 10 su [`MessageDisplay`](#messagedisplay). Gli hook [`SessionEnd`](#sessionend) condividono un budget di 1,5 secondi; se le tue impostazioni impostano un `timeout` per hook più lungo, Claude Code aumenta il budget per corrispondere, fino a 60 secondi |

443| `statusMessage` | no | Messaggio spinner personalizzato visualizzato mentre l'hook viene eseguito |443| `statusMessage` | no | Messaggio spinner personalizzato visualizzato mentre l'hook viene eseguito |

444| `once` | no | Se `true`, Claude Code rimuove l'hook dopo la sua prima esecuzione riuscita. Un'esecuzione che fallisce, blocca con codice di uscita 2, o scade lascia l'hook in posizione, quindi viene eseguito di nuovo al prossimo evento corrispondente. Onorato solo per gli hook dichiarati nel [frontmatter dello skill](#hooks-in-skills-and-agents); ignorato nei file di impostazioni e nel frontmatter dell'agente |444| `once` | no | Se `true`, Claude Code rimuove l'hook dopo la sua prima esecuzione riuscita. Un'esecuzione che fallisce, blocca con codice di uscita 2, o scade lascia l'hook in posizione, quindi viene eseguito di nuovo al prossimo evento corrispondente. Onorato solo per gli hook dichiarati nel [frontmatter dello skill](#hooks-in-skills-and-agents); ignorato nei file di impostazioni e nel frontmatter dell'agente |


447 447 

448In una condizione `if` per uno strumento di file, un pattern di directory a segmento singolo come `"Edit(src/**)"` corrisponde solo alla directory `src` nella directory di lavoro e ai file sotto di essa. Per corrispondere a una directory denominata `src` a qualsiasi profondità, scrivi `"Edit(**/src/**)"`. Prima di v2.1.214, `"Edit(src/**)"` corrispondeva a una directory denominata `src` a qualsiasi profondità sotto la directory di lavoro.448In una condizione `if` per uno strumento di file, un pattern di directory a segmento singolo come `"Edit(src/**)"` corrisponde solo alla directory `src` nella directory di lavoro e ai file sotto di essa. Per corrispondere a una directory denominata `src` a qualsiasi profondità, scrivi `"Edit(**/src/**)"`. Prima di v2.1.214, `"Edit(src/**)"` corrispondeva a una directory denominata `src` a qualsiasi profondità sotto la directory di lavoro.

449 449 

450<span id="bash-if-matching" />Per i pattern Bash, se il tuo comando hook viene eseguito dipende dalla forma del pattern e dal comando Bash che Claude sta invocando. Gli assegnamenti `VAR=value` iniziali vengono rimossi prima della corrispondenza.450<h4 id="bash-if-matching">

451 Come i pattern `if` corrispondono ai comandi Bash

452</h4>

453 

454Per i pattern Bash nel [campo `if`](#common-fields), se il tuo comando hook viene eseguito dipende dalla forma del pattern e dal comando Bash che Claude sta invocando. Gli assegnamenti `VAR=value` iniziali vengono rimossi prima della corrispondenza.

451 455 

452| Pattern `if` | Comando Bash | L'hook viene eseguito? | Perché |456| Pattern `if` | Comando Bash | L'hook viene eseguito? | Perché |

453| :- | :- | :- | :- |457| :- | :- | :- | :- |


1913 1917 

1914| Campo | Tipo | Esempio | Descrizione |1918| Campo | Tipo | Esempio | Descrizione |

1915| :- | :- | :- | :- |1919| :- | :- | :- | :- |

1916| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Domande da presentare, ciascuna con una stringa `question`, un breve `header`, un array `options` e un flag `multiSelect` facoltativo |1920| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false}]` | Domande da presentare, ciascuna con una stringa `question`, un breve `header`, un array `options` e un flag facoltativo `multiSelect` |

1917| `answers` | object | `{"Which framework?": "React"}` | Facoltativo. Associa il testo della domanda all'etichetta dell'opzione selezionata. Le risposte a selezione multipla uniscono le etichette con virgole. Claude non imposta questo campo; forniscilo tramite `updatedInput` per rispondere in modo programmatico |1921| `answers` | object | `{"Which framework?": "React"}` | Facoltativo. Associa il testo della domanda all'etichetta dell'opzione selezionata. Le risposte a selezione multipla uniscono le etichette con virgole. Claude non imposta questo campo; forniscilo tramite `updatedInput` per rispondere in modo programmatico |

1918 1922 

1919<h5 id="exitplanmode">1923<h5 id="exitplanmode">


1965}1969}

1966```1970```

1967 1971 

1968<span id="allow-with-updatedinput" />1972<Note>

1973 In precedenza PreToolUse usava i campi di primo livello `decision` e `reason`, ma questi sono deprecati per questo evento. Usa invece `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. I valori deprecati `"approve"` e `"block"` corrispondono rispettivamente a `"allow"` e `"deny"`. Altri eventi come PostToolUse e Stop continuano a usare `decision` e `reason` di primo livello come formato attuale.

1974</Note>

1969 1975 

1970In [modalità non interattiva](/docs/it/headless) con il flag `-p`, Claude Code offre `AskUserQuestion` e `ExitPlanMode` solo quando l'esecuzione ha un [host dei permessi](/docs/it/headless#turn-off-permission-prompts-in-unattended-runs) che riceva la richiesta, come un callback `canUseTool` dell'Agent SDK. Questi strumenti richiedono l'interazione dell'utente. Restituire `permissionDecision: "allow"` insieme a `updatedInput` soddisfa questo requisito: l'hook legge l'input dello strumento da stdin, raccoglie la risposta tramite la tua interfaccia e la restituisce in `updatedInput` così lo strumento viene eseguito senza chiedere. Restituire solo `"allow"` non è sufficiente per questi strumenti. Per `AskUserQuestion`, restituisci l'array `questions` originale e aggiungi un oggetto [`answers`](#askuserquestion) che associ il testo di ogni domanda alla risposta scelta.1976<h4 id="allow-with-updatedinput">

1977 Strumenti che richiedono l'interazione dell'utente

1978</h4>

1971 1979 

1972Uno strumento MCP che il suo server contrassegna con [`_meta["anthropic/requiresUserInteraction"]`](/docs/it/mcp#require-approval-for-a-specific-tool) è più restrittivo: un hook non può saltarne la richiesta di approvazione con `"allow"`, con o senza `updatedInput`, perché Claude Code non può verificare che l'hook abbia raccolto l'interazione di cui lo strumento ha bisogno.1980`AskUserQuestion` e `ExitPlanMode` richiedono l'interazione dell'utente. In [modalità non interattiva](/docs/it/headless) con il flag `-p`, Claude Code li offre solo quando l'esecuzione ha un [host dei permessi](/docs/it/headless#turn-off-permission-prompts-in-unattended-runs) che riceve la richiesta, come un callback `canUseTool` dell'Agent SDK.

1973 1981 

1974<Note>1982Un hook `PreToolUse` soddisfa questo requisito quando fa quanto segue:

1975 PreToolUse in precedenza usava i campi di primo livello `decision` e `reason`, ma questi sono deprecati per questo evento. Usa invece `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. I valori deprecati `"approve"` e `"block"` corrispondono rispettivamente a `"allow"` e `"deny"`. Altri eventi come PostToolUse e Stop continuano a usare `decision` e `reason` di primo livello come formato attuale.1983 

1976</Note>19841. Legge l'input dello strumento da stdin

19852. Raccoglie la risposta tramite la tua interfaccia utente

19863. Restituisce `permissionDecision: "allow"` insieme a `updatedInput` contenente la risposta, così lo strumento viene eseguito senza chiedere conferma

1987 

1988Restituire solo `"allow"` non è sufficiente per questi strumenti.

1989 

1990Per `AskUserQuestion`, restituisci l'array `questions` originale e aggiungi un oggetto [`answers`](#askuserquestion) che associa il testo di ogni domanda alla risposta scelta. Questo output risponde a una domanda con `React`:

1991 

1992```json theme={null}

1993{

1994 "hookSpecificOutput": {

1995 "hookEventName": "PreToolUse",

1996 "permissionDecision": "allow",

1997 "updatedInput": {

1998 "questions": [

1999 {

2000 "question": "Which framework?",

2001 "header": "Framework",

2002 "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}],

2003 "multiSelect": false

2004 }

2005 ],

2006 "answers": {"Which framework?": "React"}

2007 }

2008 }

2009}

2010```

2011 

2012Uno strumento MCP che il suo server contrassegna con [`_meta["anthropic/requiresUserInteraction"]`](/docs/it/mcp#require-approval-for-a-specific-tool) è più restrittivo: un hook non può saltarne la richiesta di approvazione con `"allow"`, con o senza `updatedInput`, perché Claude Code non può verificare che l'hook abbia raccolto l'interazione di cui lo strumento ha bisogno.

1977 2013 

1978<h4 id="defer-a-tool-call-for-later">2014<h4 id="defer-a-tool-call-for-later">

1979 Differire una chiamata a uno strumento2015 Differire una chiamata a uno strumento


2000 "deferred_tool_use": {2036 "deferred_tool_use": {

2001 "id": "toolu_01abc",2037 "id": "toolu_01abc",

2002 "name": "AskUserQuestion",2038 "name": "AskUserQuestion",

2003 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React"}, {"label": "Vue"}], "multiSelect": false }] }2039 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false }] }

2004 }2040 }

2005}2041}

2006```2042```

Details

470* Il vostro account è vicino o al limite di utilizzo. Per mantenere i suggerimenti attivi fino a quando non raggiungete il limite, impostate [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/it/env-vars) su `true`. Prima della v2.1.238, Claude Code li saltava vicino al limite anche con la variabile impostata su `true`470* Il vostro account è vicino o al limite di utilizzo. Per mantenere i suggerimenti attivi fino a quando non raggiungete il limite, impostate [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/it/env-vars) su `true`. Prima della v2.1.238, Claude Code li saltava vicino al limite anche con la variabile impostata su `true`

471* In un [agent team](/docs/it/agent-teams), nelle sessioni dei compagni di squadra per impostazione predefinita. La sessione del lead mostra i suggerimenti471* In un [agent team](/docs/it/agent-teams), nelle sessioni dei compagni di squadra per impostazione predefinita. La sessione del lead mostra i suggerimenti

472 472 

473L'avviso `Showing fewer prompt suggestions · use one to bring them back` significa che Claude Code mostra i suggerimenti meno spesso perché ne hai lasciati molti di fila inutilizzati. Per tornare alla frequenza abituale, usa un suggerimento oppure imposta [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/it/env-vars) su `true`.

474 

473In modalità stampa, Claude Code non genera suggerimenti per impostazione predefinita. Passate [`--prompt-suggestions`](/docs/it/cli-reference#cli-flags) con `-p "<prompt>" --output-format stream-json --verbose` per fare in modo che Claude Code emetta un messaggio `prompt_suggestion` dopo ogni turno che ne genera uno. Il generatore salta anche le conversazioni molto brevi e le cache di prompt fredde qui, quindi una singola query `-p` breve potrebbe non emetterne nessuna.475In modalità stampa, Claude Code non genera suggerimenti per impostazione predefinita. Passate [`--prompt-suggestions`](/docs/it/cli-reference#cli-flags) con `-p "<prompt>" --output-format stream-json --verbose` per fare in modo che Claude Code emetta un messaggio `prompt_suggestion` dopo ogni turno che ne genera uno. Il generatore salta anche le conversazioni molto brevi e le cache di prompt fredde qui, quindi una singola query `-p` breve potrebbe non emetterne nessuna.

474 476 

475<h3 id="turn-prompt-suggestions-off">477<h3 id="turn-prompt-suggestions-off">

keybindings.md +4 −0

Details

464| :- | :- | :- |464| :- | :- | :- |

465| `agents:switchView` | Ctrl+S | Cambia il [raggruppamento della sessione](/docs/it/agent-view#organize-the-list) tra stato e directory |465| `agents:switchView` | Ctrl+S | Cambia il [raggruppamento della sessione](/docs/it/agent-view#organize-the-list) tra stato e directory |

466| `agents:togglePin` | Ctrl+T | [Fissa o scollega](/docs/it/agent-view#organize-the-list) la sessione selezionata |466| `agents:togglePin` | Ctrl+T | [Fissa o scollega](/docs/it/agent-view#organize-the-list) la sessione selezionata |

467| `agents:find` | Ctrl+F | Trova le sessioni per nome, con il [filtro `n:`](/docs/it/agent-view#filter-sessions). Richiede v2.1.288 o successiva |

468| `agents:rename` | Ctrl+R | [Rinomina](/docs/it/agent-view#organize-the-list) la sessione selezionata. Richiede v2.1.288 o successiva |

469| `agents:previousGroup` | Ctrl+Su, Meta+Su | Salta all'[intestazione di gruppo](/docs/it/agent-view#organize-the-list) precedente. Richiede v2.1.288 o successiva |

470| `agents:nextGroup` | Ctrl+Giù, Meta+Giù | Salta all'intestazione di gruppo successiva. Richiede v2.1.288 o successiva |

467 471 

468Mentre la vista agente è aperta, Claude Code utilizza l'associazione `Agents` per qualsiasi tasto che il contesto `Agents` associa, e ignora un'associazione `Chat` o `Global` sulla stessa chiave. Ad esempio, premere Ctrl+S nella vista agente cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito `chat:stash`.472Mentre la vista agente è aperta, Claude Code utilizza l'associazione `Agents` per qualsiasi tasto che il contesto `Agents` associa, e ignora un'associazione `Chat` o `Global` sulla stessa chiave. Ad esempio, premere Ctrl+S nella vista agente cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito `chat:stash`.

469 473 

managed-mcp.md +61 −29

Details

282 282 

283Gli allowlist e i denylist filtrano quali server configurati sono autorizzati a caricarsi. Non sono un registro: un server deve comunque essere aggiunto da un utente, un plugin o la tua organizzazione prima che uno dei due elenchi si applichi ad esso.283Gli allowlist e i denylist filtrano quali server configurati sono autorizzati a caricarsi. Non sono un registro: un server deve comunque essere aggiunto da un utente, un plugin o la tua organizzazione prima che uno dei due elenchi si applichi ad esso.

284 284 

285I server che la tua organizzazione fornisce tramite `managedMcpServers` si caricano senza una voce di allowlist, e [Come viene valutato un server](#how-a-server-is-evaluated) copre i server `managed-mcp.json`. Il denylist si applica a ogni server indipendentemente da dove proviene, ad eccezione delle voci in-process `type: "sdk"`.285I server che la tua organizzazione fornisce tramite `managedMcpServers` si caricano senza una voce di allowlist, e [I server che saltano il controllo dell'allowlist](#servers-that-skip-the-allowlist-check) copre i server `managed-mcp.json`. La denylist si applica a ogni server indipendentemente da dove proviene, ad eccezione delle voci in-process `type: "sdk"`.

286 286 

287Per distribuire server agli utenti, utilizza [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) o [`managedMcpServers`](#provide-servers-through-managed-settings). Entrambi gli elenchi filtrano anche i server passati con il flag CLI [`--mcp-config`](/docs/it/cli-reference#cli-flags), ad eccezione delle voci in-process `type: "sdk"`; `--strict-mcp-config` limita quali file di configurazione si caricano e non aggira nessuno dei due elenchi.287Per distribuire server agli utenti, utilizza [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) o [`managedMcpServers`](#provide-servers-through-managed-settings). Entrambi gli elenchi filtrano anche i server passati con il flag CLI [`--mcp-config`](/docs/it/cli-reference#cli-flags), ad eccezione delle voci in-process `type: "sdk"`; `--strict-mcp-config` limita quali file di configurazione si caricano e non aggira nessuno dei due elenchi.

288 288 


308| :- | :- | :- |308| :- | :- | :- |

309| `serverUrl` | Un URL di server remoto, esatto o con wildcard `*` | Server HTTP e SSE |309| `serverUrl` | Un URL di server remoto, esatto o con wildcard `*` | Server HTTP e SSE |

310| `serverCommand` | Il comando esatto e gli argomenti che avviano un server stdio | Server stdio |310| `serverCommand` | Il comando esatto e gli argomenti che avviano un server stdio | Server stdio |

311| `serverName` | L'etichetta assegnata dall'utente. Solo corrispondenza esatta; i wildcard non vengono espansi | Entrambi i tipi, ma vedi l'Avvertenza di seguito |311| `serverName` | L'etichetta assegnata dall'utente. Solo corrispondenza esatta; i wildcard non vengono espansi | Entrambi i tipi, ma vedi [Come corrispondono le voci `serverName`](#how-servername-entries-match) |

312 312 

313Lasciare `allowedMcpServers` non impostato è diverso dall'impostarlo su un array vuoto:313Lasciare `allowedMcpServers` non impostato è diverso dall'impostarlo su un array vuoto:

314 314 

315| Impostazione | Non impostato (predefinito) | Array vuoto `[]` | Popolato |315| Impostazione | Non impostato (predefinito) | Array vuoto `[]` | Popolato |

316| :- | :- | :- | :- |316| :- | :- | :- | :- |

317| `allowedMcpServers` | Tutti i server consentiti | Nessun server consentito, a parte [quelli che saltano il controllo dell'allowlist](#how-a-server-is-evaluated) | Solo i server corrispondenti consentiti, a parte [quelli che saltano il controllo dell'allowlist](#how-a-server-is-evaluated) |317| `allowedMcpServers` | Tutti i server consentiti | Nessun server consentito, a parte [quelli che saltano il controllo dell'allowlist](#servers-that-skip-the-allowlist-check) | Solo i server corrispondenti consentiti, a parte [quelli che saltano il controllo dell'allowlist](#servers-that-skip-the-allowlist-check) |

318| `deniedMcpServers` | Nessun server bloccato | Nessun server bloccato | Server corrispondenti bloccati |318| `deniedMcpServers` | Nessun server bloccato | Nessun server bloccato | Server corrispondenti bloccati |

319 319 

320Vedi [Voci non valide nelle impostazioni gestite](/docs/it/managed-settings#invalid-entries-in-managed-settings) per sapere cosa accade quando una voce non supera la convalida dello schema.320Vedi [Voci non valide nelle impostazioni gestite](/docs/it/managed-settings#invalid-entries-in-managed-settings) per sapere cosa accade quando una voce non supera la convalida dello schema.

321 321 

322<h4 id="how-servername-entries-match">

323 Come corrispondono le voci `serverName`

324</h4>

325 

326Una voce `serverName` corrisponde esattamente all'etichetta assegnata dall'utente, senza wildcard.

327 

322<Warning>328<Warning>

323 Una voce `serverName`, in uno dei due elenchi, non è un controllo di sicurezza. Il nome è l'etichetta che un utente assegna quando esegue `claude mcp add` o modifica un file di configurazione, non il server sottostante, quindi un utente può chiamare qualsiasi server `github`. Per i connettori claude.ai il nome è il nome visualizzato restituito da claude.ai, che può cambiare. Per applicare quali server effettivamente vengono eseguiti, aggiungi voci `serverCommand` o `serverUrl`.329 Una voce `serverName`, in uno dei due elenchi, non è un controllo di sicurezza. Il nome è l'etichetta che un utente assegna quando esegue `claude mcp add` o modifica un file di configurazione, non il server sottostante, quindi un utente può chiamare qualsiasi server `github`. Per i connettori claude.ai il nome è il nome visualizzato restituito da claude.ai, che può cambiare. Per applicare quali server effettivamente vengono eseguiti, aggiungi voci `serverCommand` o `serverUrl`.

324</Warning>330</Warning>


330 336 

331Per disattivare tutti i connettori claude.ai che Claude Code recupera da solo, vedi [`disableClaudeAiConnectors`](/docs/it/mcp#disable-claude-ai-connectors).337Per disattivare tutti i connettori claude.ai che Claude Code recupera da solo, vedi [`disableClaudeAiConnectors`](/docs/it/mcp#disable-claude-ai-connectors).

332 338 

333<h3 id="how-a-server-is-evaluated">339<h4 id="how-servercommand-entries-match">

334 Come viene valutato un server340 Come corrispondono le voci `serverCommand`

335</h3>341</h4>

336 

337Prima di caricare un server, incluso uno da `managed-mcp.json`, Claude Code esegue i tre controlli di seguito in ordine. Li esegue di nuovo quando un utente ricollega un server o riattiva uno disabilitato in `/mcp`. I server in-process `type: "sdk"`, che l'[app che ha avviato la sessione registra](/docs/it/mcp#how-connectors-reach-claude-code), saltano tutti e tre.

338 

3391. **Unisci gli elenchi.** Le voci di allowlist e denylist da ogni ambito di impostazioni si combinano in un allowlist e un denylist. Quando `allowManagedMcpServersOnly` è `true`, viene mantenuto solo l'allowlist gestito; il denylist si unisce sempre da ogni ambito. Quando è presente più di una fonte gestita, [Le chiavi lette da ogni fonte admin](/docs/it/managed-settings#keys-read-from-every-admin-source) dice quali di esse forniscono gli elenchi dell'ambito gestito.

3402. **Controlla il denylist.** Un server che corrisponde a qualsiasi voce del denylist, per URL, comando o nome, viene bloccato. Nulla sostituisce una corrispondenza del denylist.

3413. **Controlla l'allowlist.** Se `allowedMcpServers` non è impostato da nessuna parte, ogni server che ha superato il denylist si carica. Se è impostato, ciò a cui il server deve corrispondere dipende dal suo tipo, mostrato nella tabella di seguito.

342 

343 Tre gruppi di server saltano questo controllo:

344 342 

345 * I server dell'organizzazione: ogni voce `managedMcpServers` e qualsiasi voce `managed-mcp.json` i cui valori non utilizzano l'espansione `${VAR}`.343Una voce `serverCommand` contiene il comando e i suoi argomenti come un unico array, come in `{ "serverCommand": ["npx", "-y", "server"] }`. Claude Code confronta quell'array con il comando e gli argomenti nella configurazione del server:

346 * Server integrati, come Claude in Chrome, il server `ide` a cui Claude Code si connette in un IDE VS Code o JetBrains in esecuzione, e i server che la CLI stessa configura.

347 * I tool Slack di una sessione [Claude Tag](/docs/it/claude-tag): i server che utilizza per leggere il thread e pubblicare le sue risposte si caricano senza una voce di allowlist.

348 344 

349 Un server `managed-mcp.json` che utilizza l'espansione `${VAR}` nel suo comando, argomenti, `env`, URL o intestazioni viene comunque controllato. Lo stesso vale per ogni server che un utente, un plugin, o claude.ai aggiunge, e ogni server che un utente passa con `--mcp-config`.345* **I comandi corrispondono esattamente.** Ogni argomento, in ordine. `["npx", "-y", "server"]` non corrisponde a `["npx", "server"]` o `["npx", "-y", "server", "--flag"]`.

346* **Il blocco `env` non viene confrontato.** `["node", "server.js"]` corrisponde a un server che esegue quel comando con qualsiasi valore `env`. Alcune variabili d'ambiente cambiano ciò che `node` carica all'avvio. Per impostare tu stesso i valori `env`, definisci il server in [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json).

350 347 

351| Tipo di server | Consentito quando corrisponde |348<h4 id="how-serverurl-entries-match">

352| :- | :- |349 Come corrispondono le voci `serverUrl`

353| Remoto (HTTP o SSE) | Una voce `serverUrl`. Una corrispondenza `serverName` conta solo quando l'allowlist non contiene voci `serverUrl` |350</h4>

354| Stdio | Una voce `serverCommand`. Una corrispondenza `serverName` conta solo quando l'allowlist non contiene voci `serverCommand` |

355 351 

356Tre regole di corrispondenza si applicano all'interno di questi controlli:352Gli URL supportano wildcard `*` ovunque nel modello, incluso lo schema. La corrispondenza del nome host non distingue tra maiuscole e minuscole e ignora un punto FQDN finale, quindi `https://Mcp.Example.com/*` corrisponde a `https://mcp.example.com/api`. I percorsi rimangono sensibili alle maiuscole e minuscole.

357 353 

358* **I comandi corrispondono esattamente.** Ogni argomento, in ordine. `["npx", "-y", "server"]` non corrisponde a `["npx", "server"]` o `["npx", "-y", "server", "--flag"]`.354La tabella mostra cosa consentono i modelli comuni:

359* **I valori `serverCommand` e `serverUrl` si espandono prima della corrispondenza.** Sia la voce della policy che il valore configurato del server passano attraverso l'espansione [`${VAR}` e `${VAR:-default}`](/docs/it/mcp#environment-variable-expansion-in-mcp-json), quindi una voce scritta come `["${HOME}/bin/server"]` corrisponde a una configurazione del server che utilizza lo stesso riferimento o il percorso espanso. Su Windows, fai riferimento a una variabile di ambiente impostata lì, come `${USERPROFILE}` invece di `${HOME}`. I valori `serverName` corrispondono letteralmente e non si espandono mai. I due lati leggono ambienti diversi; [Come si espandono le voci della policy](#how-policy-entries-expand) copre quale e come differiscono le voci di allowlist e denylist.

360* **Gli URL supportano wildcard `*`** ovunque nel modello, incluso lo schema. La corrispondenza del nome host non distingue tra maiuscole e minuscole e ignora un punto FQDN finale, quindi `https://Mcp.Example.com/*` corrisponde a `https://mcp.example.com/api`. I percorsi rimangono sensibili alle maiuscole e minuscole.

361 355 

362| Modello | Consente |356| Modello | Consente |

363| :- | :- |357| :- | :- |


368| `*://mcp.example.com/*` | Qualsiasi schema a un dominio specifico |362| `*://mcp.example.com/*` | Qualsiasi schema a un dominio specifico |

369 363 

370<h4 id="how-policy-entries-expand">364<h4 id="how-policy-entries-expand">

371 Come si espandono le voci della policy365 Variabili d'ambiente nelle voci `serverCommand` e `serverUrl`

372</h4>366</h4>

373 367 

374Il valore configurato del server si espande dall'ambiente del processo live, come il resto di `.mcp.json`. Una voce della policy si espande da un ambiente bloccato invece, quindi una variabile impostata da un file di impostazioni di progetto o utente non può cambiare cosa significa una voce di allowlist. Poiché una voce della policy dipende comunque dal valore della shell di avvio per qualsiasi variabile a cui fa riferimento, utilizza URL e comandi letterali per le voci su cui conti per l'applicazione.368I valori `serverCommand` e `serverUrl` si espandono prima della corrispondenza. Sia la voce della policy che il valore configurato del server passano attraverso l'[espansione `${VAR}` e `${VAR:-default}`](/docs/it/mcp#environment-variable-expansion-in-mcp-json), quindi una voce scritta come `["${HOME}/bin/server"]` corrisponde a una configurazione del server che utilizza lo stesso riferimento o il percorso espanso. I valori `serverName` corrispondono letteralmente e non si espandono mai.

369 

370I due lati leggono ambienti diversi:

371 

372* **Il valore configurato del server**: si espande dall'ambiente del processo live, come il resto di `.mcp.json`

373* **Una voce della policy**: si espande da un ambiente bloccato, quindi una variabile impostata da un file di impostazioni di progetto o utente non può cambiare cosa significa una voce di allowlist

374 

375Poiché una voce della policy dipende comunque dal valore della shell di avvio per qualsiasi variabile a cui fa riferimento, utilizza URL e comandi letterali per le voci su cui conti per l'applicazione.

376 

377Su Windows, fai riferimento a una variabile d'ambiente impostata lì, come `${USERPROFILE}` invece di `${HOME}`.

378 

379I due elenchi si espandono in modo diverso:

375 380 

376| Elenco di voci | Si espande da | Espansione che cambierebbe lo schema, l'host o l'ambito del percorso di una voce URL |381| Elenco di voci | Si espande da | Espansione che cambierebbe lo schema, l'host o l'ambito del percorso di una voce URL |

377| - | - | - |382| - | - | - |

378| `allowedMcpServers` | L'ambiente da cui Claude Code è stato avviato, più i valori `env` dalle impostazioni gestite | Claude Code ignora la voce |383| `allowedMcpServers` | L'ambiente da cui Claude Code è stato avviato, più i valori `env` dalle impostazioni gestite | Claude Code ignora la voce |

379| `deniedMcpServers` | Lo stesso, e una variabile senza valore di avvio e nessun `:-default` si riempie dalle impostazioni file al di fuori del repository, come impostazioni utente o gestite, che solo allargano ciò che la voce corrisponde | La voce corrisponde comunque |384| `deniedMcpServers` | Lo stesso, e una variabile senza valore di avvio e nessun `:-default` si riempie dalle impostazioni file al di fuori del repository, come impostazioni utente o gestite, che solo allargano ciò che la voce corrisponde | La voce corrisponde comunque |

380 385 

381Richiede Claude Code v2.1.219 o successivo.386L'ambiente bloccato e le regole in questa tabella richiedono Claude Code v2.1.219 o successivo.

387 

388<h3 id="how-a-server-is-evaluated">

389 Come viene valutato un server

390</h3>

391 

392Prima di caricare un server, incluso uno da `managed-mcp.json`, Claude Code esegue i tre controlli di seguito in ordine. Li esegue di nuovo quando un utente ricollega un server o riattiva uno disabilitato in `/mcp`. I server in-process `type: "sdk"`, che l'[app che ha avviato la sessione registra](/docs/it/mcp#how-connectors-reach-claude-code), saltano tutti e tre.

393 

3941. **Merge degli elenchi.** Le voci di allowlist e denylist di ogni ambito di impostazioni si combinano in un'unica allowlist e un'unica denylist. Quando `allowManagedMcpServersOnly` è `true`, viene mantenuta solo l'allowlist gestita; per la denylist il merge avviene sempre da ogni ambito. Quando è presente più di una fonte gestita, [Le chiavi lette da ogni fonte di amministrazione](/docs/it/managed-settings#keys-read-from-every-admin-source) indica quali di esse forniscono gli elenchi dell'ambito gestito.

3952. **Controlla la denylist.** Un server che corrisponde a qualsiasi voce della denylist, per URL, comando o nome, viene bloccato. Nulla ha la precedenza su una corrispondenza della denylist.

3963. **Controlla l'allowlist.** [Alcuni server saltano questo controllo](#servers-that-skip-the-allowlist-check). Se `allowedMcpServers` non è impostato da nessuna parte, ogni server che ha superato la denylist si carica. Se è impostato, ciò a cui il server deve corrispondere dipende dal suo tipo, mostrato nella tabella di seguito.

397 

398| Tipo di server | Consentito quando corrisponde |

399| :- | :- |

400| Remoto (HTTP o SSE) | Una voce `serverUrl`. Una corrispondenza `serverName` conta solo quando l'allowlist non contiene voci `serverUrl` |

401| Stdio | Una voce `serverCommand`. Una corrispondenza `serverName` conta solo quando l'allowlist non contiene voci `serverCommand` |

402 

403<h4 id="servers-that-skip-the-allowlist-check">

404 I server che saltano il controllo dell'allowlist

405</h4>

406 

407Tre gruppi di server saltano il controllo dell'allowlist, oltre ai server in-process `type: "sdk"` che saltano [tutti e tre i controlli](#how-a-server-is-evaluated):

408 

409* I server dell'organizzazione: ogni voce `managedMcpServers` e qualsiasi voce `managed-mcp.json` i cui valori non utilizzano l'espansione `${VAR}`.

410* Server integrati, come Claude in Chrome, il server `ide` a cui Claude Code si connette in un IDE VS Code o JetBrains in esecuzione, e i server che la CLI stessa configura.

411* Gli strumenti Slack di una sessione [Claude Tag](/docs/it/claude-tag): i server che utilizza per leggere il thread e pubblicare le sue risposte si caricano senza una voce di allowlist.

412 

413Un server `managed-mcp.json` che utilizza l'espansione `${VAR}` nel suo comando, argomenti, `env`, URL o intestazioni viene comunque controllato. Claude Code controlla anche ogni server che un utente, un plugin o claude.ai aggiunge, e ogni server che un utente passa con `--mcp-config`.

382 414 

383<h3 id="example-configuration">415<h3 id="example-configuration">

384 Configurazione di esempio416 Configurazione di esempio

Details

271 Su Claude Code v2.1.273 o successivo, mentre `allowManagedMcpServersOnly` è attivo, l'elenco `allowedMcpServers` dalla fonte admin con ranking più alto che ne imposta uno si applica e blocca quello del padre, come una [chiave cross-source](#keys-read-from-every-admin-source). L'elenco del padre si applica solo quando nessuna fonte admin ne imposta uno. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte fornisce ogni chiave sotto `"merge"`. Prima della v2.1.223, un valore in qualsiasi fonte admin bloccava quello del padre271 Su Claude Code v2.1.273 o successivo, mentre `allowManagedMcpServersOnly` è attivo, l'elenco `allowedMcpServers` dalla fonte admin con ranking più alto che ne imposta uno si applica e blocca quello del padre, come una [chiave cross-source](#keys-read-from-every-admin-source). L'elenco del padre si applica solo quando nessuna fonte admin ne imposta uno. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte fornisce ogni chiave sotto `"merge"`. Prima della v2.1.223, un valore in qualsiasi fonte admin bloccava quello del padre

272* Per `availableModels`, Claude Code applica il valore nelle impostazioni gestite che applica e blocca un elenco fornito dal padre272* Per `availableModels`, Claude Code applica il valore nelle impostazioni gestite che applica e blocca un elenco fornito dal padre

273* Per `strictKnownMarketplaces`, Claude Code allo stesso modo applica l'elenco nelle impostazioni gestite che applica e blocca uno fornito dal padre. L'elenco del padre si applica solo quando nessuna fonte gestita applicata ne imposta uno. Richiede Claude Code v2.1.282 o successivo273* Per `strictKnownMarketplaces`, Claude Code allo stesso modo applica l'elenco nelle impostazioni gestite che applica e blocca uno fornito dal padre. L'elenco del padre si applica solo quando nessuna fonte gestita applicata ne imposta uno. Richiede Claude Code v2.1.282 o successivo

274* Per `allowedProviders`, un elenco nella [fonte gestita selezionata](#which-managed-source-claude-code-uses) blocca uno fornito dal padre, e con l'opt-in `"merge"` di [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) lo fa un elenco in qualsiasi fonte admin. Richiede Claude Code v2.1.285 o successivo

274* Un `blockedMarketplaces` fornito dal padre si applica in aggiunta a qualsiasi blocklist che una fonte gestita imposta. Richiede Claude Code v2.1.282 o successivo275* Un `blockedMarketplaces` fornito dal padre si applica in aggiunta a qualsiasi blocklist che una fonte gestita imposta. Richiede Claude Code v2.1.282 o successivo

275 276 

276<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">277<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">


301I file di impostazioni propri di uno sviluppatore, i valori `--settings` e i file di progetto non sostituiscono mai un valore gestito; le [eccezioni](/docs/it/settings#exceptions-to-managed-settings-precedence) permettono solo a un valore di livello inferiore più restrittivo di contare. Questi casi stanno al di fuori di quella regola:302I file di impostazioni propri di uno sviluppatore, i valori `--settings` e i file di progetto non sostituiscono mai un valore gestito; le [eccezioni](/docs/it/settings#exceptions-to-managed-settings-precedence) permettono solo a un valore di livello inferiore più restrittivo di contare. Questi casi stanno al di fuori di quella regola:

302 303 

303* **Il modello per una sessione**: un `model` gestito è un predefinito, non un blocco. `--model` e `ANTHROPIC_MODEL` scelgono ancora il modello per quella sessione, quindi distribuisci [`availableModels`](/docs/it/settings-reference#availablemodels) per limitare la scelta.304* **Il modello per una sessione**: un `model` gestito è un predefinito, non un blocco. `--model` e `ANTHROPIC_MODEL` scelgono ancora il modello per quella sessione, quindi distribuisci [`availableModels`](/docs/it/settings-reference#availablemodels) per limitare la scelta.

305* **La finestra di compattazione automatica per una sessione**: anche un [`autoCompactWindow`](/docs/it/settings-reference#autocompactwindow) gestito è un predefinito. Il flag `--autocompact` e la variabile `CLAUDE_CODE_AUTO_COMPACT_WINDOW` impostano ancora la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) per quella sessione.

304* **Diritti admin locali**: uno sviluppatore che è un amministratore sulla macchina può modificare la fonte gestita stessa, motivo per cui gli strumenti MDM possono ridistribuire il profilo o il file su una pianificazione e motivo per cui il registro HKLM e il dominio delle preferenze gestite di macOS esistono.306* **Diritti admin locali**: uno sviluppatore che è un amministratore sulla macchina può modificare la fonte gestita stessa, motivo per cui gli strumenti MDM possono ridistribuire il profilo o il file su una pianificazione e motivo per cui il registro HKLM e il dominio delle preferenze gestite di macOS esistono.

305* **La cache gestita dal server**: le impostazioni gestite dal server provengono dai server di Anthropic, e una modifica alla cache locale [dura solo fino al prossimo recupero riuscito](/docs/it/server-managed-settings#security-considerations).307* **La cache gestita dal server**: le impostazioni gestite dal server provengono dai server di Anthropic, e una modifica alla cache locale [dura solo fino al prossimo recupero riuscito](/docs/it/server-managed-settings#security-considerations).

306* **Altri strumenti**: le impostazioni gestite vincolano solo Claude Code. Uno sviluppatore che chiama l'API da un altro strumento non è sotto di esse.308* **Altri strumenti**: le impostazioni gestite vincolano solo Claude Code. Uno sviluppatore che chiama l'API da un altro strumento non è sotto di esse.


324* `(remote)`: impostazioni server-managed da claude.ai o un gateway326* `(remote)`: impostazioni server-managed da claude.ai o un gateway

325* `(plist)` o `(HKLM)`: una policy MDM o del sistema operativo327* `(plist)` o `(HKLM)`: una policy MDM o del sistema operativo

326* `(file)`, `(drop-ins)`, o `(file + drop-ins)`: `managed-settings.json`, la directory drop-in, o entrambi328* `(file)`, `(drop-ins)`, o `(file + drop-ins)`: `managed-settings.json`, la directory drop-in, o entrambi

327* `(remote + file, merged)`, o un altro elenco che termina in `, merged`: la tua organizzazione [compone ogni fonte gestita](#compose-every-managed-source), e Claude Code ha unito le fonti elencate nella policy. Una fonte inferiore può ancora fornire variabili `env` senza apparire nell'elenco. Richiede Claude Code v2.1.242 o successivo329* `(remote + file, merged)`, o un altro elenco che termina in `, merged`: la tua organizzazione [compone ogni fonte gestita](#compose-every-managed-source), e Claude Code ha eseguito il merge delle fonti elencate nella policy. Una fonte inferiore può ancora fornire variabili `env` senza apparire nell'elenco. Richiede Claude Code v2.1.242 o successivo

328* `(HKCU)`: il fallback del registro scrivibile dall'utente330* `(HKCU)`: il fallback del registro scrivibile dall'utente

329* `(parent process)`: un [host di embedding](#let-an-embedding-host-add-policy) ha fornito impostazioni restrittive331* `(parent process)`: un [host di embedding](#let-an-embedding-host-add-policy) ha fornito impostazioni restrittive

330* `(helper)`: un [`policyHelper`](/docs/it/settings-reference#policyhelper) configurato dalla fonte MDM o file selezionata332* `(helper)`: un [`policyHelper`](/docs/it/settings-reference#policyhelper) configurato dalla fonte MDM o file selezionata


346 Trova voci che Claude Code ha eliminato348 Trova voci che Claude Code ha eliminato

347</h3>349</h3>

348 350 

349Se il tuo file di impostazioni gestite, profilo MDM, valore di registro, o payload server-managed non supera la convalida dello schema, Claude Code prima salta le singole voci che può riparare, come una regola di autorizzazione non valida, e avvisa di ognuna. Claude Code quindi elimina qualsiasi valore che ancora non supera, a meno che il valore appartenga a una delle chiavi che [falliscono chiuse](#keys-that-fail-closed) invece.351Se il tuo file di impostazioni gestite, profilo MDM, valore di registro, o payload server-managed non supera la convalida dello schema, Claude Code prima salta le singole voci che può riparare, come una regola di permesso non valida, e avvisa di ognuna. Claude Code quindi elimina qualsiasi valore che ancora non supera, a meno che il valore appartenga a una delle chiavi che [falliscono chiuse](#keys-that-fail-closed) invece.

350 352 

351Claude Code è più rigoroso con il `managedSettings` che un [`policyHelper`](/docs/it/settings-reference#policyhelper) emette: fa le stesse riparazioni di voce, ma qualsiasi violazione dello schema che sopravvive fa fallire l'intera esecuzione dell'helper, e all'avvio Claude Code rifiuta di avviarsi, lo stesso che per un helper che esce con non-zero.353Claude Code è più rigoroso con il `managedSettings` che un [`policyHelper`](/docs/it/settings-reference#policyhelper) emette: fa le stesse riparazioni di voce, ma qualsiasi violazione dello schema che sopravvive fa fallire l'intera esecuzione dell'helper, e all'avvio Claude Code rifiuta di avviarsi, lo stesso che per un helper che esce con non-zero.

352 354 

353Quando un file di impostazioni gestite, un file drop-in, un plist MDM, o un valore di registro HKLM è presente ma non può essere analizzato come un oggetto JSON, Claude Code rifiuta di avviarsi e stampa [un errore che nomina la fonte](/docs/it/errors#managed-settings-document-could-not-be-parsed), anche quando un'altra fonte admin distribuisce una policy valida. Ogni fonte fallisce in questo modo quando:355Quando un file di impostazioni gestite, un file drop-in, un plist MDM, o un valore di registro HKLM è presente ma non può essere analizzato come un oggetto JSON, Claude Code rifiuta di avviarsi e stampa [un errore che nomina la fonte](/docs/it/errors#managed-settings-document-could-not-be-parsed), anche quando un'altra fonte di amministrazione distribuisce una policy valida. Ogni fonte fallisce in questo modo quando:

354 356 

355* **File di impostazioni gestite o file drop-in**: il file non è JSON valido, o il suo livello superiore non è un oggetto357* **File di impostazioni gestite o file drop-in**: il file non è JSON valido, o il suo livello superiore non è un oggetto

356* **MDM plist**: il `plutil` di macOS segnala il plist malformato, o il suo contenuto convertito non è un oggetto JSON358* **MDM plist**: il `plutil` di macOS segnala il plist malformato, o il suo contenuto convertito non è un oggetto JSON


362* Un file di impostazioni gestite vuoto conta come `{}`.364* Un file di impostazioni gestite vuoto conta come `{}`.

363* Un valore malformato nella chiave di registro HKCU scrivibile dall'utente non blocca mai l'avvio. Claude Code lo segnala come un avviso in `/status` e `claude doctor` invece.365* Un valore malformato nella chiave di registro HKCU scrivibile dall'utente non blocca mai l'avvio. Claude Code lo segnala come un avviso in `/status` e `claude doctor` invece.

364 366 

365Quando un file di impostazioni gestite, un file drop-in, una directory `managed-settings.d/`, un profilo MDM, o un valore di registro HKLM esiste ma non può essere letto, e nessuna fonte admin fornisce una policy, quello che accade dipende dal motivo per cui la lettura non è riuscita:367Quando un file di impostazioni gestite, un file drop-in, una directory `managed-settings.d/`, un profilo MDM, o un valore di registro HKLM esiste ma non può essere letto, e nessuna fonte di amministrazione fornisce una policy, quello che accade dipende dal motivo per cui la lettura non è riuscita:

366 368 

367* Se il sistema operativo ha negato la lettura, ad esempio su un file solo root, ogni sessione si avvia senza le policy di quella fonte. `/status` e `claude doctor` registrano l'errore, e un'esecuzione con `-p` lo stampa anche su stderr.369* Se il sistema operativo ha negato la lettura, ad esempio su un file solo root, ogni sessione si avvia senza le policy di quella fonte. `/status` e `claude doctor` registrano l'errore, e un'esecuzione con `-p` lo stampa anche su stderr.

368* Per qualsiasi altro errore di lettura, come un errore di I/O, ogni sessione esce all'avvio con [un messaggio per contattare un amministratore](/docs/it/errors#unable-to-read-managed-policy-settings).370* Per qualsiasi altro errore di lettura, come un errore di I/O, ogni sessione esce all'avvio con [un messaggio per contattare un amministratore](/docs/it/errors#unable-to-read-managed-policy-settings).


398 400 

399| Campo | Comportamento quando presente ma non valido |401| Campo | Comportamento quando presente ma non valido |

400| :- | :- |402| :- | :- |

401| `allowedMcpServers` | Applicato come un allowlist vuoto fino a quando il valore non viene corretto, quindi nessun server MCP che gli utenti aggiungono viene ammesso. I server che la tua organizzazione distribuisce tramite [`managedMcpServers`](/docs/it/settings-reference#managedmcpservers) si caricano ancora, e i server `managed-mcp.json` si caricano per [How a server is evaluated](/docs/it/managed-mcp#how-a-server-is-evaluated). Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. |403| `allowedMcpServers` | Applicato come un'allowlist vuota fino a quando il valore non viene corretto, quindi nessun server MCP che gli utenti aggiungono viene ammesso. I server che la tua organizzazione distribuisce tramite [`managedMcpServers`](/docs/it/settings-reference#managedmcpservers) si caricano ancora, e i server `managed-mcp.json` si caricano secondo [Servers that skip the allowlist check](/docs/it/managed-mcp#servers-that-skip-the-allowlist-check). Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. |

402| [`allowedProviders`](/docs/it/settings-reference#allowedproviders) | Applicato come un allowlist vuoto fino a quando il valore non viene corretto, quindi ogni provider API viene rifiutato e Claude Code non si avvia sulla macchina. Se solo una voce individuale non è un nome di provider noto, Claude Code elimina e segnala quella voce e applica il resto. |404| [`allowedProviders`](/docs/it/settings-reference#allowedproviders) | Applicato come un'allowlist vuota fino a quando il valore non viene corretto, quindi ogni provider API viene rifiutato e Claude Code non si avvia sulla macchina. Se solo una voce individuale non è un nome di provider noto, Claude Code elimina e segnala quella voce e applica il resto. |

403| `allowedHttpHookUrls` | Claude Code applica un [allowlist](/docs/it/settings-reference#allowedhttphookurls) gestito vuoto fino a quando non correggi il valore, quindi un hook HTTP viene eseguito solo se un altro file di impostazioni elenca il suo URL. Se solo una voce individuale non è valida, Claude Code rimuove quella voce e applica il resto. |405| `allowedHttpHookUrls` | Claude Code applica un'[allowlist](/docs/it/settings-reference#allowedhttphookurls) gestita vuota fino a quando non correggi il valore, quindi un hook HTTP viene eseguito solo se un altro file di impostazioni elenca il suo URL. Se solo una voce individuale non è valida, Claude Code rimuove quella voce e applica il resto. |

404| `httpHookAllowedEnvVars` | Claude Code applica un [allowlist](/docs/it/settings-reference#httphookallowedenvvars) gestito vuoto fino a quando non correggi il valore, quindi una variabile di intestazione viene interpolata solo se un altro file di impostazioni la nomina. Se solo una voce individuale non è valida, Claude Code rimuove quella voce e applica il resto. |406| `httpHookAllowedEnvVars` | Claude Code applica un'[allowlist](/docs/it/settings-reference#httphookallowedenvvars) gestita vuota fino a quando non correggi il valore, quindi una variabile di intestazione viene interpolata solo se un altro file di impostazioni la nomina. Se solo una voce individuale non è valida, Claude Code rimuove quella voce e applica il resto. |

405| `allowedChannelPlugins` | Claude Code applica un allowlist vuoto fino a quando non correggi il valore, quindi nessun plugin di canale passato a `--channels` viene ammesso. Se solo una voce individuale non è valida, rimuove quella voce e applica il resto. |407| `allowedChannelPlugins` | Claude Code applica un'allowlist vuota fino a quando non correggi il valore, quindi nessun plugin di canale passato a `--channels` viene ammesso. Se solo una voce individuale non è valida, rimuove quella voce e applica il resto. |

406| `strictKnownMarketplaces` | Applicato come un allowlist vuoto fino a quando il valore non viene corretto, quindi nessuna [fonte marketplace](/docs/it/plugins/org#restrict-what-users-can-install) viene ammessa. Una voce individuale che non è valida o non può essere applicata, come una regex `hostPattern` che non si compila, viene rimossa e il sottoinsieme valido viene applicato. |408| `strictKnownMarketplaces` | Applicato come un'allowlist vuota fino a quando il valore non viene corretto, quindi nessuna [fonte marketplace](/docs/it/plugins/org#restrict-what-users-can-install) viene ammessa. Una voce individuale che non è valida o non può essere applicata, come una regex `hostPattern` che non si compila, viene rimossa e il sottoinsieme valido viene applicato. |

407| `availableModels` | Applicato come un allowlist vuoto fino a quando non viene corretto, quindi solo il modello Default è disponibile; una voce non stringa viene rimossa e il sottoinsieme valido viene applicato. |409| `availableModels` | Applicato come un'allowlist vuota fino a quando non viene corretto, quindi solo il modello Default è disponibile; una voce non stringa viene rimossa e il sottoinsieme valido viene applicato. |

408| [`availableModelsMatch`](/docs/it/settings-reference#availablemodelsmatch) | Trattato come `exact` fino a quando il valore non viene corretto. |410| [`availableModelsMatch`](/docs/it/settings-reference#availablemodelsmatch) | Trattato come `exact` fino a quando il valore non viene corretto. |

409| `forceLoginOrgUUID` | Nessuna organizzazione è autorizzata ad accedere fino a quando il valore non viene corretto. |411| `forceLoginOrgUUID` | Nessuna organizzazione è autorizzata ad accedere fino a quando il valore non viene corretto. |

410| `gatewayInternalNetworks` | Quando il valore non valido proviene dalla fonte gestita più alta sulla macchina, `/login` rifiuta ogni nuovo accesso [cloud gateway](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) su quella macchina fino a quando il valore non viene corretto. |412| `gatewayInternalNetworks` | Quando il valore non valido proviene dalla fonte gestita più alta sulla macchina, `/login` rifiuta ogni nuovo accesso [cloud gateway](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) su quella macchina fino a quando il valore non viene corretto. |


417| `strictPluginOnlyCustomization` | Trattato come `true`, bloccando tutte e quattro le superfici, quando il valore non è né un booleano né un array. Una voce di array che questa versione non riconosce come una superficie non blocca nulla; una nota di stato conta tali voci in modo che tu possa controllarle per errori di battitura. |419| `strictPluginOnlyCustomization` | Trattato come `true`, bloccando tutte e quattro le superfici, quando il valore non è né un booleano né un array. Una voce di array che questa versione non riconosce come una superficie non blocca nulla; una nota di stato conta tali voci in modo che tu possa controllarle per errori di battitura. |

418| `enabledPlugins` | Una voce non valida viene eliminata con un avviso e le altre voci rimangono applicate. Un valore che non è una mappa di ID plugin, o il cui ogni voce non è valida, viene eliminato completamente con un avviso. |420| `enabledPlugins` | Una voce non valida viene eliminata con un avviso e le altre voci rimangono applicate. Un valore che non è una mappa di ID plugin, o il cui ogni voce non è valida, viene eliminato completamente con un avviso. |

419 421 

420`allowedHttpHookUrls` e `httpHookAllowedEnvVars` si uniscono tra i file di impostazioni, quindi le voci nelle tue impostazioni utente, progetto o locale si applicano ancora mentre l'elenco gestito è vuoto.422Per `allowedHttpHookUrls` e `httpHookAllowedEnvVars` viene eseguito il merge tra i file di impostazioni, quindi le voci nelle tue impostazioni utente, progetto o locale si applicano ancora mentre l'elenco gestito è vuoto.

421 423 

422I fallback per queste due chiavi e per `allowedChannelPlugins` richiedono Claude Code v2.1.267 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictKnownMarketplaces` e `blockedMarketplaces` richiedono Claude Code v2.1.277 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictPluginOnlyCustomization` e `enabledPlugins` richiedono Claude Code v2.1.282 o successivo.424I fallback per queste due chiavi e per `allowedChannelPlugins` richiedono Claude Code v2.1.267 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictKnownMarketplaces` e `blockedMarketplaces` richiedono Claude Code v2.1.277 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictPluginOnlyCustomization` e `enabledPlugins` richiedono Claude Code v2.1.282 o successivo.

423 425 

424`requiredMinimumVersion` e `requiredMaximumVersion` falliscono aperti per design: un valore non valido viene eliminato piuttosto che applicato.426`requiredMinimumVersion` e `requiredMaximumVersion` falliscono aperti per design: un valore non valido viene eliminato piuttosto che applicato.

425 427 

426Questa tolleranza si applica solo alle impostazioni gestite. I file di impostazioni utente, progetto e locale rimangono rigorosi: un file il cui JSON o forma di livello superiore non supera la convalida viene rifiutato completamente e segnalato, e una voce individuale che fallisce, come una regola di autorizzazione malformata, viene saltata con un avviso mentre il resto del file si applica.428Questa tolleranza si applica solo alle impostazioni gestite. I file di impostazioni utente, progetto e locale rimangono rigorosi: un file il cui JSON o forma di livello superiore non supera la convalida viene rifiutato completamente e segnalato, e una voce individuale che fallisce, come una regola di permesso malformata, viene saltata con un avviso mentre il resto del file si applica.

427 429 

428<h4 id="invalid-values-inside-sandbox">430<h4 id="invalid-values-inside-sandbox">

429 Invalid values inside `sandbox`431 Invalid values inside `sandbox`


437* Se `failIfUnavailable` non è valido, Claude Code elimina il valore piuttosto che trattarlo come `true`, quindi un valore illeggibile non ferma mai le sessioni dall'avviarsi in tutta la tua flotta.439* Se `failIfUnavailable` non è valido, Claude Code elimina il valore piuttosto che trattarlo come `true`, quindi un valore illeggibile non ferma mai le sessioni dall'avviarsi in tutta la tua flotta.

438* Claude Code tratta ogni altro booleano non valido come il valore che mantiene la sandbox più rigorosa fino a quando non lo correggi. Una chiave che attiva la sandbox o una delle sue restrizioni, come `enabled` o `network.allowManagedDomainsOnly`, conta come `true`. Una chiave che la allenta, come `allowUnsandboxedCommands`, conta come `false`.440* Claude Code tratta ogni altro booleano non valido come il valore che mantiene la sandbox più rigorosa fino a quando non lo correggi. Una chiave che attiva la sandbox o una delle sue restrizioni, come `enabled` o `network.allowManagedDomainsOnly`, conta come `true`. Una chiave che la allenta, come `allowUnsandboxedCommands`, conta come `false`.

439* In un elenco al di fuori di `credentials`, come `excludedCommands` o `network.allowedDomains`, Claude Code elimina una voce non valida e mantiene il resto dell'elenco. Un elenco che non è un array, o che non ha alcuna voce valida, non si applica affatto.441* In un elenco al di fuori di `credentials`, come `excludedCommands` o `network.allowedDomains`, Claude Code elimina una voce non valida e mantiene il resto dell'elenco. Un elenco che non è un array, o che non ha alcuna voce valida, non si applica affatto.

440* Mentre `network.deniedDomains` o qualsiasi voce in esso non è valido, Claude Code inoltre trattiene `network.allowedDomains`, quindi l'allowlist gestito non concede nulla fino a quando non correggi l'elenco di negazione.442* Mentre `network.deniedDomains` o qualsiasi voce in esso non è valido, Claude Code inoltre trattiene `network.allowedDomains`, quindi l'allowlist gestita non concede nulla fino a quando non correggi l'elenco di negazione.

441* Mentre `filesystem.denyRead`, `filesystem.denyWrite`, o qualsiasi voce in uno di essi non è valido, Claude Code inoltre trattiene sia `filesystem.allowRead` che `filesystem.allowWrite` fino a quando non correggi l'elenco di negazione.443* Mentre `filesystem.denyRead`, `filesystem.denyWrite`, o qualsiasi voce in uno di essi non è valido, Claude Code inoltre trattiene sia `filesystem.allowRead` che `filesystem.allowWrite` fino a quando non correggi l'elenco di negazione.

442 444 

443<span id="managed-only-settings" />445<span id="managed-only-settings" />

model-config.md +2 −1

Details

285* **[Fallback automatico del modello](#automatic-model-fallback)**: un fallback il cui target è escluso non viene eseguito, quindi la richiesta contrassegnata termina con un rifiuto285* **[Fallback automatico del modello](#automatic-model-fallback)**: un fallback il cui target è escluso non viene eseguito, quindi la richiesta contrassegnata termina con un rifiuto

286* **[Classificatore della modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode)**: il valore predefinito Claude Sonnet 5 del classificatore si applica solo quando l'allowlist consente Sonnet 5. Quando è escluso, il classificatore viene eseguito sul modello della sessione, che l'allowlist già governa, o su un modello Opus quando la sessione viene eseguita su un [modello Fable](#work-with-fable). Su provider diversi dall'API Anthropic, quel fallback Opus viene eseguito sul modello che imposti in `ANTHROPIC_DEFAULT_OPUS_MODEL` o altrimenti su Opus 5, senza consultare l'allowlist. Richiede Claude Code v2.1.210 o successivo286* **[Classificatore della modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode)**: il valore predefinito Claude Sonnet 5 del classificatore si applica solo quando l'allowlist consente Sonnet 5. Quando è escluso, il classificatore viene eseguito sul modello della sessione, che l'allowlist già governa, o su un modello Opus quando la sessione viene eseguita su un [modello Fable](#work-with-fable). Su provider diversi dall'API Anthropic, quel fallback Opus viene eseguito sul modello che imposti in `ANTHROPIC_DEFAULT_OPUS_MODEL` o altrimenti su Opus 5, senza consultare l'allowlist. Richiede Claude Code v2.1.210 o successivo

287* **[Modalità veloce](/docs/it/fast-mode)**: l'abilitazione della modalità veloce viene rifiutata quando il modello su cui la sessione verrebbe eseguita in seguito è al di fuori dell'allowlist287* **[Modalità veloce](/docs/it/fast-mode)**: l'abilitazione della modalità veloce viene rifiutata quando il modello su cui la sessione verrebbe eseguita in seguito è al di fuori dell'allowlist

288* **Fallback di disponibilità su Amazon Bedrock e Agent Platform di Google Cloud**: quando il tuo account perde l'accesso a un modello a metà sessione, il passaggio a un altro modello salta i modelli esclusi. I controlli del modello all'avvio su [Amazon Bedrock](/docs/it/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) e su [Agent Platform di Google Cloud](/docs/it/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) saltano i modelli esclusi solo quando le impostazioni gestite impostano anche [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)

288 289 

289```json theme={null}290```json theme={null}

290{291{


766| :- | :- |767| :- | :- |

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

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

769| Disabilita tramite una variabile di ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il pensiero su Anthropic API tranne sui modelli Opus 5.5, Sonnet 5.5 e Fable. Su [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette il parametro `thinking`, e i modelli di ragionamento adattivo potrebbero comunque pensare. Altri valori si applicano solo con un [budget di pensiero fisso](#adaptive-reasoning-and-fixed-thinking-budgets) |770| Disattiva tramite una variabile d'ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il ragionamento su Anthropic API tranne che su Opus 5.5, Sonnet 5.5 e sui modelli Fable. Sui [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette invece il parametro `thinking`, e i modelli con ragionamento adattivo potrebbero comunque ragionare |

770 771 

771Non puoi disattivare il pensiero sui modelli Opus 5.5, Sonnet 5.5 o Fable. L'attivazione/disattivazione della sessione e una salvata `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` non hanno effetto lì, e il modello decide per passo quanto pensare in base al livello di sforzo. La sessione toggle e la riga `/config` mostrano `Thinking can't be turned off` per questi modelli invece di offrire l'interruttore, e un salvato `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` non ha effetto lì. Su questi modelli, il modello decide per passo quanto pensare in base al livello di sforzo. L'impostazione salvata si applica di nuovo quando passi a un modello che l'accetta.772Non puoi disattivare il pensiero sui modelli Opus 5.5, Sonnet 5.5 o Fable. L'attivazione/disattivazione della sessione e una salvata `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` non hanno effetto lì, e il modello decide per passo quanto pensare in base al livello di sforzo. La sessione toggle e la riga `/config` mostrano `Thinking can't be turned off` per questi modelli invece di offrire l'interruttore, e un salvato `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` non ha effetto lì. Su questi modelli, il modello decide per passo quanto pensare in base al livello di sforzo. L'impostazione salvata si applica di nuovo quando passi a un modello che l'accetta.

772 773 

Details

358 358 

359<span id="new-context-gates" />359<span id="new-context-gates" />

360 360 

361**Attributi di contenuto con il tracing beta dettagliato**

362 

361<Note>363<Note>

362 Attributi aggiuntivi che portano contenuto come `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` e `response.model_output` vengono emessi solo quando il tracing beta dettagliato è attivo. Non fanno parte dello schema di span stabile.364 Attributi aggiuntivi che portano contenuto come `new_context`, `system_reminders`, `system_prompt_preview`, `user_system_prompt`, `tool_input` e `response.model_output` vengono emessi solo quando il tracing beta dettagliato è attivo. Non fanno parte dello schema di span stabile.

365</Note>

363 366 

364 Il gate su `new_context` dipende da quale span lo porta, e ogni copia viene troncata al limite di contenuto (60 KB per impostazione predefinita). Sullo span `claude_code.tool` porta il risultato di quella chiamata dello strumento, qualunque sia lo strumento, e richiede `OTEL_LOG_TOOL_CONTENT=1`. Sullo span `claude_code.interaction` porta il prompt dell'utente, e sullo span `claude_code.llm_request` i nuovi messaggi dell'utente e i risultati dello strumento di quella richiesta. Entrambi richiedono `OTEL_LOG_USER_PROMPTS=1`.367Questi attributi compaiono sugli span seguenti, e `Controllato da` nomina la variabile di cui un attributo ha bisogno in aggiunta al tracing beta dettagliato. I valori più lunghi del limite di contenuto (60 KB per impostazione predefinita) vengono troncati.

365 368 

366 `user_system_prompt` richiede inoltre `OTEL_LOG_USER_PROMPTS=1`. Porta solo il testo del prompt di sistema che fornisci tramite l'opzione SDK `systemPrompt` o i flag `--system-prompt` e `--append-system-prompt`, troncato al limite di contenuto (60 KB per impostazione predefinita), ed è emesso una volta per sessione piuttosto che per richiesta.369| Attributo | Span | Descrizione | Controllato da |

367</Note>370| - | - | - | - |

371| `new_context` | `claude_code.interaction` | Il prompt dell'utente | `OTEL_LOG_USER_PROMPTS` |

372| `new_context` | `claude_code.llm_request` | I nuovi messaggi dell'utente e i risultati degli strumenti inviati con la richiesta | `OTEL_LOG_USER_PROMPTS` |

373| `system_reminders` | `claude_code.llm_request` | Il testo dei [promemoria di sistema](/docs/it/glossary#system-reminder) tra i nuovi messaggi della richiesta | `OTEL_LOG_USER_PROMPTS` |

374| `system_prompt_preview` | `claude_code.llm_request` | I primi 500 caratteri del prompt di sistema completo inviato con la richiesta | `OTEL_LOG_USER_PROMPTS` |

375| `user_system_prompt` | `claude_code.llm_request` | Solo il testo del prompt di sistema che fornisci tramite l'opzione SDK `systemPrompt` o i flag `--system-prompt` e `--append-system-prompt`. Emesso una volta per sessione piuttosto che per richiesta | `OTEL_LOG_USER_PROMPTS` |

376| `response.model_output` | `claude_code.llm_request` | Testo della risposta del modello alla richiesta | `OTEL_LOG_USER_PROMPTS` |

377| `new_context` | `claude_code.tool` | Il risultato della chiamata allo strumento, qualunque sia lo strumento | `OTEL_LOG_TOOL_CONTENT` |

378| `tool_input` | `claude_code.tool` | L'input serializzato della chiamata allo strumento | `OTEL_LOG_TOOL_DETAILS` |

379 

380Con il tracing beta dettagliato e `OTEL_LOG_USER_PROMPTS=1`, Claude Code emette anche un evento `claude_code.system_prompt` che porta il prompt di sistema completo, troncato al limite di contenuto. Arriva la prima volta che una sessione invia ciascun prompt di sistema distinto, e di nuovo dopo la compattazione.

368 381 

369<h3 id="dynamic-headers">382<h3 id="dynamic-headers">

370 Intestazioni dinamiche383 Intestazioni dinamiche


797* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)810* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

798* `prompt_length`: Lunghezza del prompt811* `prompt_length`: Lunghezza del prompt

799* `prompt`: Contenuto del prompt. Redatto per impostazione predefinita. Imposta `OTEL_LOG_USER_PROMPTS=1` per includerlo812* `prompt`: Contenuto del prompt. Redatto per impostazione predefinita. Imposta `OTEL_LOG_USER_PROMPTS=1` per includerlo

813* `prompt_text`: Stesso valore di `prompt`, oscurato con la stessa condizione. Un backend che memorizza i nomi degli attributi con punti come oggetti annidati legge `prompt.id` come `id` all'interno di un oggetto chiamato `prompt` e può perdere la stringa del prompt. In quel caso leggi invece `prompt_text`. Richiede Claude Code v2.1.287 o versioni successive

800* `message.uuid`: UUID del messaggio utente risultante, corrispondente all'entry della trascrizione persistente. Assente sui dispatching dei comandi, che possono produrre zero o molti messaggi. Richiede Claude Code v2.1.214 o successivo814* `message.uuid`: UUID del messaggio utente risultante, corrispondente all'entry della trascrizione persistente. Assente sui dispatching dei comandi, che possono produrre zero o molti messaggi. Richiede Claude Code v2.1.214 o successivo

801* `command_name`: Nome del comando quando il prompt ne invoca uno. I nomi dei comandi incorporati e in bundle come `compact` o `debug` vengono emessi così come sono; gli alias come `reset` vengono emessi come digitati piuttosto che il nome canonico. I nomi dei comandi personalizzati, dei plugin e MCP si riducono a `custom` o `mcp` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato815* `command_name`: Nome del comando quando il prompt ne invoca uno. I nomi dei comandi incorporati e in bundle come `compact` o `debug` vengono emessi così come sono; gli alias come `reset` vengono emessi come digitati piuttosto che il nome canonico. I nomi dei comandi personalizzati, dei plugin e MCP si riducono a `custom` o `mcp` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato

802* `command_source`: Origine del comando quando presente: `builtin`, `custom`, o `mcp`. I comandi forniti dai plugin vengono segnalati come `custom`816* `command_source`: Origine del comando quando presente: `builtin`, `custom`, o `mcp`. I comandi forniti dai plugin vengono segnalati come `custom`


1694* L'esportazione OpenTelemetry al tuo backend è opt-in e richiede una configurazione esplicita. Per la telemetria operazionale separata di Anthropic e come disabilitarla, vedi [Data usage](/docs/it/data-usage#telemetry-services)1708* L'esportazione OpenTelemetry al tuo backend è opt-in e richiede una configurazione esplicita. Per la telemetria operazionale separata di Anthropic e come disabilitarla, vedi [Data usage](/docs/it/data-usage#telemetry-services)

1695* I contenuti dei file grezzi e i frammenti di codice non sono inclusi nelle metriche o negli eventi. I percorsi di traccia degli span sono un percorso dati separato: vedi il punto `OTEL_LOG_TOOL_CONTENT` di seguito1709* I contenuti dei file grezzi e i frammenti di codice non sono inclusi nelle metriche o negli eventi. I percorsi di traccia degli span sono un percorso dati separato: vedi il punto `OTEL_LOG_TOOL_CONTENT` di seguito

1696* Quando autenticato tramite OAuth, `user.email` è incluso negli attributi di telemetria, inviato solo all'endpoint OTel che configuri, mai ad Anthropic. Se questo è una preoccupazione per la tua organizzazione, lavora con il tuo backend di telemetria per filtrare o oscurare questo campo1710* Quando autenticato tramite OAuth, `user.email` è incluso negli attributi di telemetria, inviato solo all'endpoint OTel che configuri, mai ad Anthropic. Se questo è una preoccupazione per la tua organizzazione, lavora con il tuo backend di telemetria per filtrare o oscurare questo campo

1697* Il contenuto del prompt dell'utente non viene raccolto per impostazione predefinita. Viene registrata solo la lunghezza del prompt. Per includere il contenuto del prompt, imposta `OTEL_LOG_USER_PROMPTS=1`. Sotto la traccia beta dettagliata questa variabile raggiunge più lontano del testo del prompt: controlla anche l'[attributo span `new_context`](#new-context-gates), che porta i risultati dello strumento sullo span `claude_code.llm_request`1711* Il contenuto del prompt dell'utente non viene raccolto per impostazione predefinita. Viene registrata solo la lunghezza del prompt. Per includere il contenuto del prompt, imposta `OTEL_LOG_USER_PROMPTS=1`. Quando abilitato:

1698* Il testo della risposta dell'assistente non viene raccolto per impostazione predefinita. Viene registrata solo la lunghezza della risposta. Per includere il testo della risposta, imposta `OTEL_LOG_ASSISTANT_RESPONSES=1`. Come tutti i dati OpenTelemetry da Claude Code, il testo della risposta viene inviato solo all'endpoint OTel che configuri, mai ad Anthropic. Quando questa variabile non è impostata, `OTEL_LOG_USER_PROMPTS` viene utilizzato come fallback, quindi imposta `OTEL_LOG_ASSISTANT_RESPONSES=0` se desideri il contenuto del prompt senza il contenuto della risposta1712 * Gli eventi `user_prompt` portano il testo del prompt in due attributi, `prompt` e [`prompt_text`](#user-prompt-event). Se nel tuo collector elimini o mascheri il testo del prompt dell'evento in base al nome dell'attributo, indica entrambi gli attributi nella regola

1713 

1714 Questo processore `attributes` di OpenTelemetry Collector elimina entrambi gli attributi nelle pipeline che lo elencano:

1715 

1716 ```yaml theme={null}

1717 processors:

1718 attributes/drop-prompt-text:

1719 actions:

1720 - key: prompt

1721 action: delete

1722 - key: prompt_text

1723 action: delete

1724 ```

1725 

1726 * Con il [tracing](#traces-beta) attivo, lo span `claude_code.interaction` porta il testo del prompt nel suo attributo `user_prompt`

1727 

1728 * Sotto la traccia beta dettagliata, gli span portano anche i nuovi messaggi dell'utente, i risultati degli strumenti e i promemoria di sistema inviati con ogni richiesta, il testo del prompt di sistema e l'output del modello. [Attributi di contenuto sotto la traccia beta dettagliata](#new-context-gates) elenca ciascun attributo. L'evento `claude_code.system_prompt` porta il prompt di sistema completo

1729* Il testo della risposta dell'assistente non viene raccolto per impostazione predefinita. Viene registrata solo la lunghezza della risposta. Per includere il testo della risposta, imposta `OTEL_LOG_ASSISTANT_RESPONSES=1`. Come tutti i dati OpenTelemetry da Claude Code, il testo della risposta viene inviato solo all'endpoint OTel che configuri, mai ad Anthropic. Quando questa variabile non è impostata, `OTEL_LOG_USER_PROMPTS` viene utilizzato come fallback, quindi imposta `OTEL_LOG_ASSISTANT_RESPONSES=0` se desideri il contenuto del prompt senza il contenuto della risposta negli eventi. Sotto la traccia beta dettagliata, lo span `claude_code.llm_request` porta comunque l'output del modello in [`response.model_output`](#new-context-gates), che segue `OTEL_LOG_USER_PROMPTS` anziché questa variabile

1699* Gli argomenti di input dello strumento e i parametri non vengono registrati per impostazione predefinita. Per includerli, imposta `OTEL_LOG_TOOL_DETAILS=1`. Per i server integrati di Claude Desktop, nelle sessioni di cui Claude Desktop è proprietario, `tool_decision` e `tool_result` portano la coppia `mcp_server_name`/`mcp_tool_name`, nomi creati dall'host piuttosto che contenuto degli argomenti, anche con il flag disattivato. L'eccezione richiede Claude Code v2.1.214 o successivo. Questi dati vengono inviati solo all'endpoint OTEL che configuri, mai ad Anthropic. Gli argomenti potrebbero comunque contenere valori sensibili, quindi configura il tuo backend di telemetria per filtrare o oscurare questi attributi secondo necessità. Quando abilitato:1730* Gli argomenti di input dello strumento e i parametri non vengono registrati per impostazione predefinita. Per includerli, imposta `OTEL_LOG_TOOL_DETAILS=1`. Per i server integrati di Claude Desktop, nelle sessioni di cui Claude Desktop è proprietario, `tool_decision` e `tool_result` portano la coppia `mcp_server_name`/`mcp_tool_name`, nomi creati dall'host piuttosto che contenuto degli argomenti, anche con il flag disattivato. L'eccezione richiede Claude Code v2.1.214 o successivo. Questi dati vengono inviati solo all'endpoint OTEL che configuri, mai ad Anthropic. Gli argomenti potrebbero comunque contenere valori sensibili, quindi configura il tuo backend di telemetria per filtrare o oscurare questi attributi secondo necessità. Quando abilitato:

1700 * Gli eventi `tool_result` e `tool_decision` includono un attributo `tool_parameters` con comandi Bash, nomi dei server MCP e dello strumento, e nomi delle skill. I campi come `full_command` vengono emessi non troncati1731 * Gli eventi `tool_result` e `tool_decision` includono un attributo `tool_parameters` con comandi Bash, nomi dei server MCP e dello strumento, e nomi delle skill. I campi come `full_command` vengono emessi non troncati

1701 * Gli eventi `tool_result` includono inoltre un attributo `tool_input` con percorsi di file, URL, modelli di ricerca e altri argomenti. I singoli valori superiori a 512 caratteri vengono troncati e il totale è limitato a circa 4 K caratteri1732 * Gli eventi `tool_result` includono inoltre un attributo `tool_input` con percorsi di file, URL, modelli di ricerca e altri argomenti. I singoli valori superiori a 512 caratteri vengono troncati e il totale è limitato a circa 4 K caratteri

1702 * Gli eventi `user_prompt` includono il `command_name` verbatim per i comandi personalizzati, plugin e MCP1733 * Gli eventi `user_prompt` includono il `command_name` verbatim per i comandi personalizzati, plugin e MCP

1703 * Gli [contatori di costo e token](#cost-counter) e gli eventi `api_request`, `api_error` e `api_refusal` portano nomi reali di agente, skill, plugin e server MCP e strumento nei loro attributi di attribuzione1734 * I [contatori di costo e token](#cost-counter) e gli eventi `api_request`, `api_error` e `api_refusal` portano nomi reali di agente, skill, plugin e server MCP e strumento nei loro attributi di attribuzione

1704 * Gli span di traccia includono lo stesso attributo `tool_input` e attributi derivati dall'input come `file_path`, con lo stesso troncamento di `tool_input`1735 * Lo span `claude_code.tool` porta attributi derivati dall'input come `file_path`. Sotto la traccia beta dettagliata porta anche un attributo [`tool_input`](#new-context-gates)

1705* Il contenuto dello strumento non viene registrato negli span di traccia per impostazione predefinita. Per includerlo, imposta `OTEL_LOG_TOOL_CONTENT=1`. Lo span `claude_code.tool` quindi porta un [evento span `tool.output`](#tool-output-span-event) con contenuti di file grezzi, output dei comandi Bash e ciò che restituiscono gli strumenti MCP, WebFetch e WebSearch, troncato al limite di contenuto (60 KB per impostazione predefinita) per attributo. I risultati degli strumenti MCP, WebFetch e WebSearch richiedono Claude Code v2.1.283 o successivo. Il contenuto dello strumento raggiunge anche gli span attraverso [`new_context`, il cui gate differisce per span](#new-context-gates). Configura il tuo backend di telemetria per filtrare o oscurare questi attributi secondo necessità1736* Il contenuto dello strumento non viene registrato negli span di traccia per impostazione predefinita. Per includerlo, imposta `OTEL_LOG_TOOL_CONTENT=1`. Lo span `claude_code.tool` quindi porta un [evento span `tool.output`](#tool-output-span-event) con contenuti di file grezzi, output dei comandi Bash e ciò che restituiscono gli strumenti MCP, WebFetch e WebSearch, troncato al limite di contenuto (60 KB per impostazione predefinita) per attributo. I risultati degli strumenti MCP, WebFetch e WebSearch richiedono Claude Code v2.1.283 o successivo. Il contenuto dello strumento raggiunge anche gli span attraverso [`new_context`, il cui gate differisce per span](#new-context-gates). Configura il tuo backend di telemetria per filtrare o oscurare questi attributi secondo necessità

1706* I corpi grezzi della richiesta e della risposta dell'API Anthropic Messages non vengono registrati per impostazione predefinita. Per includerli, imposta `OTEL_LOG_RAW_API_BODIES` nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Viene ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). I corpi contengono l'intera cronologia della conversazione, incluso il prompt di sistema, ogni turno precedente dell'utente e dell'assistente, e risultati degli strumenti, quindi l'abilitazione di questa opzione implica il consenso a tutto ciò che gli altri flag di contenuto `OTEL_LOG_*` rivelerebbero. Claude Code oscura sempre il contenuto del pensiero esteso di Claude in questi corpi, indipendentemente da altre impostazioni. Il valore che imposti determina come Claude Code fornisce i corpi:1737* I corpi grezzi della richiesta e della risposta dell'API Anthropic Messages non vengono registrati per impostazione predefinita. Per includerli, imposta `OTEL_LOG_RAW_API_BODIES` nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Viene ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). I corpi contengono l'intera cronologia della conversazione, incluso il prompt di sistema, ogni turno precedente dell'utente e dell'assistente, e risultati degli strumenti, quindi l'abilitazione di questa opzione implica il consenso a tutto ciò che gli altri flag di contenuto `OTEL_LOG_*` rivelerebbero. Claude Code oscura sempre il contenuto del pensiero esteso di Claude in questi corpi, indipendentemente da altre impostazioni. Il valore che imposti determina come Claude Code fornisce i corpi:

1707 * Con `=1`, Claude Code emette eventi di log `api_request_body` e `api_response_body` per ogni chiamata API. L'attributo `body` degli eventi porta il payload serializzato in JSON, troncato al limite di contenuto (60 KB per impostazione predefinita)1738 * Con `=1`, Claude Code emette eventi di log `api_request_body` e `api_response_body` per ogni chiamata API. L'attributo `body` degli eventi porta il payload serializzato in JSON, troncato al limite di contenuto (60 KB per impostazione predefinita)

Details

67 Quale modalità inizia una sessione67 Quale modalità inizia una sessione

68</h2>68</h2>

69 69 

70Quando avvii una nuova sessione in un terminale, Claude Code prende la modalità di autorizzazione dal primo di questi che si applica:70Quando avvii una nuova sessione in un terminale, Claude Code prende la modalità di permesso dal primo di questi che si applica:

71 71 

721. Il flag `--permission-mode`, o `--dangerously-skip-permissions`721. Il flag `--permission-mode`, o `--dangerously-skip-permissions`

73 73 


77 77 

783. L'impostazione predefinita integrata783. L'impostazione predefinita integrata

79 79 

80Le conversazioni che l'estensione VS Code avvia seguono il proprio elenco dell'estensione in [Cambia modalità di autorizzazione](#switch-permission-modes). Per la modalità di autorizzazione in cui Claude Code avvia una sessione ripresa, vedi [modalità di autorizzazione al ripristino](/docs/it/sessions#permission-mode-on-resume).80Le conversazioni che l'estensione VS Code avvia seguono il proprio elenco dell'estensione in [Cambia modalità di permesso](#switch-permission-modes). Per la modalità di permesso in cui Claude Code avvia una sessione ripresa, vedi [modalità di permesso al ripristino](/docs/it/sessions#permission-mode-on-resume).

81 81 

82L'impostazione predefinita integrata `auto` richiede Claude Code v2.1.228 o successivo su macOS, Linux e WSL, e v2.1.233 o successivo su Windows nativo. Su versioni precedenti, l'impostazione predefinita integrata è Manual.82L'impostazione predefinita integrata `auto` richiede Claude Code v2.1.228 o successivo su macOS, Linux e WSL, e v2.1.233 o successivo su Windows nativo. Su versioni precedenti, l'impostazione predefinita integrata è Manual.

83 83 

84L'impostazione predefinita integrata dipende da come esegui Claude Code. La prima riga che corrisponde alla tua sessione si applica. La tabella copre le sessioni che avvii in un terminale o tramite l'estensione VS Code; per l'app desktop e claude.ai, vedi le schede Desktop e Web in [Cambia modalità di autorizzazione](#switch-permission-modes).84L'impostazione predefinita integrata dipende da come esegui Claude Code. La prima riga che corrisponde alla tua sessione si applica. La tabella copre le sessioni che avvii in un terminale o tramite l'estensione VS Code; per l'app desktop e claude.ai, vedi le schede Desktop e Web in [Cambia modalità di permesso](#switch-permission-modes).

85 85 

86| Come esegui Claude Code | Modalità di autorizzazione iniziale integrata |86| Come esegui Claude Code | Modalità di permesso iniziale integrata |

87| :- | :- |87| :- | :- |

88| Un file di impostazioni imposta `disableAutoMode` su `"disable"` | `default` |88| Un file di impostazioni imposta `disableAutoMode` su `"disable"` | `default` |

89| `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/permissions#permission-modes) | `default` in sessioni che [recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). In sessioni che non lo fanno, come su un provider di terze parti o con telemetria disattivata, `auto` con Claude Code v2.1.285 o successivo e `default` su versioni precedenti. Una sessione in un'organizzazione la cui politica nega l'impostazione predefinita `auto` inizia in `default` invece |89| `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/permissions#permission-modes) | `default` in sessioni che [recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). In sessioni che non lo fanno, come su un provider di terze parti o con telemetria disattivata, `auto` con Claude Code v2.1.285 o successivo e `default` su versioni precedenti. Una sessione in un'organizzazione la cui politica nega l'impostazione predefinita `auto` inizia in `default` invece |

90| In un terminale o tramite l'[estensione VS Code](/docs/it/vs-code) | `auto` con Claude Code v2.1.283 o successivo; su versioni precedenti, `auto` su piani Pro, Max, o Team in sessioni che [recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), e `default` altrimenti |90| In un terminale o tramite l'[estensione VS Code](/docs/it/vs-code) | `auto` con Claude Code v2.1.283 o successivo; su versioni precedenti, `auto` su piani Pro, Max, o Team in sessioni che [recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), e `default` altrimenti |

91 91 

92Nella tua [prima sessione dopo un'installazione o aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade), Claude Code può scegliere la modalità di autorizzazione iniziale prima che arrivino i suoi flag di funzionalità. Quella sessione può iniziare in una modalità di autorizzazione diversa da quella che la tabella fornisce, e la tua sessione successiva corrisponde alla tabella.92Nella tua [prima sessione dopo un'installazione o aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade), Claude Code può scegliere la modalità di permesso iniziale prima che arrivino i suoi flag di funzionalità. Quella sessione può iniziare in una modalità di permesso diversa da quella che la tabella fornisce.

93 93 

94Quando il flag, un file di impostazioni, o l'impostazione predefinita integrata seleziona `auto` ma la modalità auto non è disponibile per la sessione, Claude Code avvia la sessione in Manual invece. La modalità auto non è disponibile quando la sessione non soddisfa i [requisiti di disponibilità](#eliminate-prompts-with-auto-mode), come un file di impostazioni che la disattiva o un modello che non la supporta, o quando Anthropic l'ha temporaneamente disattivata lato server.94Quando il flag, un file di impostazioni, o l'impostazione predefinita integrata seleziona `auto` ma la modalità auto non è disponibile per la sessione, Claude Code avvia la sessione in Manual invece. La modalità auto non è disponibile quando la sessione non soddisfa i [requisiti di disponibilità](#eliminate-prompts-with-auto-mode), come un file di impostazioni che la disattiva o un modello che non la supporta, o quando Anthropic l'ha temporaneamente disattivata lato server.

95 95 


101Se il tuo `~/.claude/settings.json` imposta un `defaultMode` diverso da `auto` e nessun altro file di impostazioni ne imposta uno, le tue sessioni continuano a iniziare in quella modalità. Su piani Pro, Max e Team, e in sessioni che [non recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), Claude Code chiede una volta, nel terminale o nell'estensione VS Code, se cambiare l'impostazione in modalità auto. Se rifiuti, la tua impostazione rimane come è.101Se il tuo `~/.claude/settings.json` imposta un `defaultMode` diverso da `auto` e nessun altro file di impostazioni ne imposta uno, le tue sessioni continuano a iniziare in quella modalità. Su piani Pro, Max e Team, e in sessioni che [non recuperano flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), Claude Code chiede una volta, nel terminale o nell'estensione VS Code, se cambiare l'impostazione in modalità auto. Se rifiuti, la tua impostazione rimane come è.

102 102 

103<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

104 Inizia in una modalità di autorizzazione diversa104 Inizia in una modalità di permesso diversa

105</h3>105</h3>

106 106 

107Puoi impostare la modalità di autorizzazione iniziale per una sessione, o come impostazione predefinita per ogni sessione su una macchina, in un progetto, o in un'organizzazione. Quando più di un file di impostazioni imposta `permissions.defaultMode`, la [precedenza delle impostazioni](/docs/it/settings#settings-precedence) decide, quindi un valore di progetto o gestito supera `~/.claude/settings.json`. Per cambiare la modalità di autorizzazione di una sessione già in esecuzione, vedi [Cambia modalità di autorizzazione](#switch-permission-modes).107Puoi impostare la modalità di permesso iniziale per una sessione, o come impostazione predefinita per ogni sessione su una macchina, in un progetto, o in un'organizzazione. Quando più di un file di impostazioni imposta `permissions.defaultMode`, la [precedenza delle impostazioni](/docs/it/settings#settings-precedence) decide, quindi un valore di progetto o gestito ha la precedenza su `~/.claude/settings.json`. Per cambiare la modalità di permesso di una sessione già in esecuzione, vedi [Cambia modalità di permesso](#switch-permission-modes).

108 108 

109| Per impostare la modalità di autorizzazione iniziale per | Fai questo |109| Per impostare la modalità di permesso iniziale per | Fai questo |

110| :- | :- |110| :- | :- |

111| Una sessione che stai per avviare | Passa la modalità di autorizzazione come flag, ad esempio `claude --permission-mode default` |111| Una sessione che stai per avviare | Passa la modalità di permesso come flag, ad esempio `claude --permission-mode default` |

112| Ogni sessione di terminale che avvii su questa macchina | Imposta `permissions.defaultMode` in `~/.claude/settings.json`. Per quello che l'estensione VS Code legge, vedi [Cambia modalità di autorizzazione](#switch-permission-modes) |112| Ogni sessione di terminale che avvii su questa macchina | Imposta `permissions.defaultMode` in `~/.claude/settings.json`. Per quello che l'estensione VS Code legge, vedi [Cambia modalità di permesso](#switch-permission-modes) |

113| Ogni sessione di terminale che avvii in un progetto | Imposta `permissions.defaultMode` nel `.claude/settings.json` del progetto. Le sessioni che avvii in un terminale rispettano ogni valore tranne `auto` e `bypassPermissions`; le sessioni che l'estensione VS Code avvia non leggono le impostazioni del progetto per la modalità di autorizzazione iniziale |113| Ogni sessione di terminale che avvii in un progetto | Imposta `permissions.defaultMode` nel `.claude/settings.json` del progetto. Le sessioni che avvii in un terminale rispettano ogni valore tranne `auto` e `bypassPermissions`; le sessioni che l'estensione VS Code avvia non leggono le impostazioni del progetto per la modalità di permesso iniziale |

114| Ogni sessione di terminale nella tua organizzazione | Imposta `permissions.defaultMode` nelle [impostazioni gestite](/docs/it/managed-settings). Le sessioni di terminale iniziano in quella modalità e le persone possono comunque passare alla modalità auto; per quello che l'estensione VS Code legge, vedi [Cambia modalità di autorizzazione](#switch-permission-modes). Per rimuovere la modalità auto in modo che nessuno possa selezionarla, imposta `permissions.disableAutoMode` su `"disable"` invece |114| Ogni sessione di terminale nella tua organizzazione | Imposta `permissions.defaultMode` nelle [impostazioni gestite](/docs/it/managed-settings). Le sessioni di terminale iniziano in quella modalità e le persone possono comunque passare alla modalità auto; per quello che l'estensione VS Code legge, vedi [Cambia modalità di permesso](#switch-permission-modes). Per rimuovere la modalità auto in modo che nessuno possa selezionarla, imposta `permissions.disableAutoMode` su `"disable"` invece |

115 115 

116Questo esempio fa sì che ogni sessione di terminale sulla tua macchina inizi in modalità Manual, il cui valore di configurazione è `default`. Salvalo in `~/.claude/settings.json`:116Questo esempio fa sì che ogni sessione di terminale sulla tua macchina inizi in modalità Manual, il cui valore di configurazione è `default`. Salvalo in `~/.claude/settings.json`:

117 117 


676* `.devcontainer`676* `.devcontainer`

677* `.yarn`677* `.yarn`

678* `.mvn`678* `.mvn`

679* `.claude`, ad eccezione di `.claude/worktrees` dove Claude memorizza i propri git worktrees679* `.claude`, ad eccezione di `.claude/worktrees` dove Claude memorizza i propri git worktree, e ad eccezione dei file markdown nella directory della [memoria automatica](/docs/it/memory#storage-location) di Claude in una sessione avviata senza `--restricted`

680* Una directory caricata con [`--plugin-dir`](/docs/it/plugins/mods/create#change-a-mod-with-claude), perché Claude Code ricarica ed esegue il codice di un mod da essa quando un file cambia680* Una directory caricata con [`--plugin-dir`](/docs/it/plugins/mods/create#change-a-mod-with-claude), perché Claude Code ricarica ed esegue il codice di un mod da essa quando un file cambia

681 681 

682File protetti:682File protetti:


739Claude Code guarda anche dentro questi costrutti:739Claude Code guarda anche dentro questi costrutti:

740 740 

741* **Comandi annidati**: una subshell con `(...)`, un gruppo di parentesi graffe con `{ ...; }`, sostituzione di comando con `$(...)` o backtick, o sostituzione di processo con `<(...)`. Claude Code trova una rimozione di percorso critico indipendentemente dal fatto che si trovi dentro la forma annidata, come in `(rm -rf ~)` o `echo "$(rm -rf ~)"`, o altrove nello stesso comando.741* **Comandi annidati**: una subshell con `(...)`, un gruppo di parentesi graffe con `{ ...; }`, sostituzione di comando con `$(...)` o backtick, o sostituzione di processo con `<(...)`. Claude Code trova una rimozione di percorso critico indipendentemente dal fatto che si trovi dentro la forma annidata, come in `(rm -rf ~)` o `echo "$(rm -rf ~)"`, o altrove nello stesso comando.

742* **Script inline**: Claude Code controlla uno script passato a una shell come `sh -c` o `bash -c` per la variabile shell e i target di parametro posizionale [](#other-targets-that-count-as-critical-paths).742* **Script inline**: uno script passato a `sh`, `bash`, `zsh` o a una shell POSIX simile con `-c`, come in `bash -c 'rm -rf ~'`.

743 * Quando lo script è tra doppi apici, la shell che invoca espande le sue variabili prima che la shell interna riceva lo script. In `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;`, il comando si espande a una rimozione dalla radice del filesystem una volta per ogni corrispondenza, e Claude Code lo tratta come una rimozione di percorso critico.743 * Quando lo script è tra doppi apici, la shell che invoca espande le sue variabili prima che la shell interna riceva lo script. In `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;`, il comando si espande a una rimozione dalla radice del filesystem una volta per ogni corrispondenza, e Claude Code lo tratta come una rimozione di percorso critico.

744 * Uno script tra apici singoli che lega `$1` a un valore reale, come fa `sh -c 'rm -rf "$1"/*' _ {}`, non viene contrassegnato.744 * Uno script tra apici singoli che lega `$1` a un valore reale, come fa `sh -c 'rm -rf "$1"/*' _ {}`, non viene segnalato.

745 

746Per disattivare il controllo su un percorso critico digitato direttamente in uno script `-c`, come `~`, imposta [`CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT=1`](/docs/it/env-vars#variables) nell'ambiente che avvia Claude Code.

745 747 

746<h3 id="rewrite-a-flagged-command">748<h3 id="rewrite-a-flagged-command">

747 Riscrivi un comando contrassegnato749 Riscrivi un comando contrassegnato

Details

336| `version` | string | Per un'installazione marketplace, la [versione che Claude Code ha calcolato](/docs/it/plugins/loading#versions-and-updates) all'installazione. Per un plugin solo sessione, della directory skills o sincronizzato, il `version` del manifest, o `unknown` quando non ne dichiara uno |336| `version` | string | Per un'installazione marketplace, la [versione che Claude Code ha calcolato](/docs/it/plugins/loading#versions-and-updates) all'installazione. Per un plugin solo sessione, della directory skills o sincronizzato, il `version` del manifest, o `unknown` quando non ne dichiara uno |

337| `scope` | string | `user`, `project`, `local` o `managed` per installazioni; `user` o `project` per plugin della directory skills; `session` per plugin solo sessione; `synced` per plugin sincronizzati da claude.ai |337| `scope` | string | `user`, `project`, `local` o `managed` per installazioni; `user` o `project` per plugin della directory skills; `session` per plugin solo sessione; `synced` per plugin sincronizzati da claude.ai |

338| `enabled` | boolean | Se il plugin è abilitato nelle tue impostazioni unite |338| `enabled` | boolean | Se il plugin è abilitato nelle tue impostazioni unite |

339| `installPath` | string | Directory da cui il plugin si carica |339| `installPath` | string | Directory da cui il plugin si carica, tranne per un plugin che le sessioni [caricano sul posto](/docs/it/plugins/loading#in-place-and-copied-plugins) dalla cartella del suo marketplace |

340| `readFromFolder` | string | Per un plugin che le sessioni [caricano sul posto](/docs/it/plugins/loading#in-place-and-copied-plugins) dalla cartella del suo marketplace, la directory di origine del plugin all'interno di quella cartella. Richiede Claude Code v2.1.289 o successivo |

341| `folderVersion` | string | Con `readFromFolder`, il `version` del plugin così come Claude Code lo ha caricato da quella cartella, che può differire dal campo `version` sopra. Assente quando il plugin non si è caricato o non dichiara alcuna versione. Richiede Claude Code v2.1.289 o successivo |

340| `installedAt` | string | Timestamp ISO dell'installazione. Solo installazioni marketplace |342| `installedAt` | string | Timestamp ISO dell'installazione. Solo installazioni marketplace |

341| `lastUpdated` | string | Timestamp ISO dell'ultimo aggiornamento. Solo installazioni marketplace |343| `lastUpdated` | string | Timestamp ISO dell'ultimo aggiornamento. Solo installazioni marketplace |

342| `projectPath` | string | Progetto a cui appartiene l'installazione. Solo ambito `project` e `local` |344| `projectPath` | string | Progetto a cui appartiene l'installazione. Solo ambito `project` e `local` |


637 * Una directory denominata `.claude`: le directory `skills`, `agents` e `commands` al suo interno639 * Una directory denominata `.claude`: le directory `skills`, `agents` e `commands` al suo interno

638 * Qualsiasi altra directory: quelle tre directory sotto il suo `.claude`640 * Qualsiasi altra directory: quelle tre directory sotto il suo `.claude`

639 641 

642Quando la directory contiene sia un `.claude-plugin/marketplace.json` sia un `.claude-plugin/plugin.json`, Claude Code convalida il marketplace e anche il manifest e i file dei componenti del plugin. Questo richiede Claude Code v2.1.289 o successivo.

643 

640Claude Code non segue i collegamenti simbolici all'interno della directory che nomini. Cosa fa dipende da dove si trova il collegamento:644Claude Code non segue i collegamenti simbolici all'interno della directory che nomini. Cosa fa dipende da dove si trova il collegamento:

641 645 

642* **Una directory `skills`, `agents` o `commands` collegata sotto la root del plugin o `.claude`**: Claude Code avverte che nulla in essa è stato letto.646* **Una directory `skills`, `agents` o `commands` collegata sotto la root del plugin o `.claude`**: Claude Code avverte che nulla in essa è stato letto.


647 651 

648* **Un `SKILL.md` alla root del plugin**: quando esegui `claude plugin validate` su una directory plugin, Claude Code non controlla un `SKILL.md` alla root del plugin652* **Un `SKILL.md` alla root del plugin**: quando esegui `claude plugin validate` su una directory plugin, Claude Code non controlla un `SKILL.md` alla root del plugin

649* **Un `CLAUDE.md` alla root del plugin**: in un'esecuzione plugin, Claude Code avverte anche di un `CLAUDE.md` alla root del plugin653* **Un `CLAUDE.md` alla root del plugin**: in un'esecuzione plugin, Claude Code avverte anche di un `CLAUDE.md` alla root del plugin

650* **File plugin in un'esecuzione marketplace**: da una directory marketplace, Claude Code non apre i file skill, agente, comando o hook dei plugin, né i file dei server MCP che includono. Per trovare errori in quei file, convalida ogni directory plugin654* **File plugin in un'esecuzione marketplace**: da una directory marketplace, Claude Code non apre i file skill, agente, comando o hook dei plugin che il marketplace elenca in altre directory, né i file dei server MCP che includono. Per trovare errori in quei file, convalida ogni directory plugin

651 655 

652<h4 id="output-and-exit-codes">656<h4 id="output-and-exit-codes">

653 Output e codici di uscita657 Output e codici di uscita

Details

100 Greet the user warmly and ask how you can help them today.100 Greet the user warmly and ask how you can help them today.

101 ```101 ```

102 102 

103 La riga `disable-model-invocation: true` significa che Claude non esegue la skill da solo, quindi solo tu la attivi. Rimuovi quella riga da una skill che vuoi che Claude esegua da solo. Il comando della skill combina il nome del plugin e il nome della skill, quindi esegui questo come `/my-first-plugin:hello`. Per gli altri campi del frontmatter, vedi il [riferimento del frontmatter della skill](/docs/it/skills#frontmatter-reference).103 La riga `disable-model-invocation: true` significa che Claude non esegue la skill da solo. Rimuovi quella riga da una skill che vuoi che Claude esegua da solo. Il comando della skill combina il nome del plugin e il nome della skill, quindi esegui questo come `/my-first-plugin:hello`. Per gli altri campi del frontmatter, vedi il [riferimento del frontmatter della skill](/docs/it/skills#frontmatter-reference).

104 </Step>104 </Step>

105 105 

106 <Step title="Convalidare il plugin">106 <Step title="Convalidare il plugin">

Details

215 215 

216Per rilasciare una nuova versione agli utenti, cambia il `version` del plugin. Gli utenti ottengono una nuova copia solo quando la versione calcolata del plugin differisce da quella che hanno. Quella versione viene da `plugin.json` per primo, poi dalla voce del marketplace, per [Versions and updates](/docs/it/plugins/loading#versions-and-updates).216Per rilasciare una nuova versione agli utenti, cambia il `version` del plugin. Gli utenti ottengono una nuova copia solo quando la versione calcolata del plugin differisce da quella che hanno. Quella versione viene da `plugin.json` per primo, poi dalla voce del marketplace, per [Versions and updates](/docs/it/plugins/loading#versions-and-updates).

217 217 

218Un plugin che gli utenti [load in place](/docs/it/plugins/loading#find-plugins-on-disk) da un marketplace che hanno aggiunto come directory locale non è controllato da `version`. Carica i tuoi file attuali a ogni avvio di sessione, qualunque sia la sua stringa di versione.218Un plugin che gli utenti [load in place](/docs/it/plugins/loading#find-plugins-on-disk) da un marketplace che hanno aggiunto da un percorso locale non è controllato da `version`. Carica i tuoi file attuali a ogni avvio di sessione, qualunque sia la sua stringa di versione.

219 219 

220Per ogni installazione diversa da un caricamento in place o uno da una source `command`, aumenta `version` a ogni rilascio o omettilo:220Per ogni installazione diversa da un caricamento in place o uno da una source `command`, aumenta `version` a ogni rilascio o omettilo:

221 221 

Details

208Claude Code carica alcuni plugin in-place da dove li mantieni e copia il resto nella cache, secondo la loro origine:208Claude Code carica alcuni plugin in-place da dove li mantieni e copia il resto nella cache, secondo la loro origine:

209 209 

210* **Plugin `--plugin-dir` e della directory di competenze**: la directory si carica in-place e non viene mai copiata. Un archivio `--plugin-url` o un `.zip` di `--plugin-dir` viene estratto in una directory temporanea della sessione prima210* **Plugin `--plugin-dir` e della directory di competenze**: la directory si carica in-place e non viene mai copiata. Un archivio `--plugin-url` o un `.zip` di `--plugin-dir` viene estratto in una directory temporanea della sessione prima

211* **Plugin con percorso relativo in un marketplace che hai aggiunto da una directory locale**: il plugin si carica in-place dal suo percorso dentro la cartella del marketplace. Le tue modifiche alla directory di origine hanno effetto al prossimo avvio della sessione o `/reload-plugins`, e non hai bisogno di aumentare la versione. I processi hook del plugin e i server MCP e LSP ricevono un `CLAUDE_PLUGIN_ROOT` che punta alla directory di origine. Per le sue dipendenze del pacchetto Node.js, vedi [Quando viene eseguita l'installazione della dipendenza](#when-the-dependency-install-runs)211* **Plugin con percorso relativo in un marketplace che hai aggiunto da un percorso locale**: il plugin si carica in-place dal suo percorso dentro la cartella del marketplace. Le tue modifiche alla directory di origine hanno effetto al prossimo avvio della sessione o `/reload-plugins`, e non hai bisogno di aumentare la versione. I processi hook del plugin e i server MCP e LSP ricevono un `CLAUDE_PLUGIN_ROOT` che punta alla directory di origine. Per le sue dipendenze del pacchetto Node.js, vedi [Quando viene eseguita l'installazione della dipendenza](#when-the-dependency-install-runs)

212* **Plugin con origine `command` in [modalità link](/docs/it/plugins/marketplace-reference#command-plugin-source)**: la directory che il comando ha stampato si carica in-place, attraverso i link nella voce della cache212* **Plugin con origine `command` in [modalità link](/docs/it/plugins/marketplace-reference#command-plugin-source)**: la directory che il comando ha stampato si carica in-place, attraverso i link nella voce della cache

213* **Ogni altro plugin marketplace**: Claude Code copia il plugin in `cache/<marketplace>/<plugin>/<version>/` all'installazione e carica quella copia. I file al di fuori della directory del plugin non vengono copiati, quindi quando uno script dentro un plugin copiato legge un percorso sopra la radice del plugin, come `../shared`, non li trova213* **Ogni altro plugin marketplace**: Claude Code copia il plugin in `cache/<marketplace>/<plugin>/<version>/` all'installazione e carica quella copia. I file al di fuori della directory del plugin non vengono copiati, quindi quando uno script dentro un plugin copiato legge un percorso sopra la radice del plugin, come `../shared`, non li trova

214 214 


250* Quando Claude Code aggiorna un plugin a una nuova versione250* Quando Claude Code aggiorna un plugin a una nuova versione

251* All'avvio della sessione quando un plugin abilitato non è ancora in cache, come su una nuova macchina251* All'avvio della sessione quando un plugin abilitato non è ancora in cache, come su una nuova macchina

252 252 

253Per un plugin con percorso relativo [caricato in-place](#in-place-and-copied-plugins) da un marketplace di directory locale, Claude Code non installa le dipendenze nella directory di origine. Installale lì tu stesso, o da un hook in [`${CLAUDE_PLUGIN_DATA}`](/docs/it/plugins/components#path-variables-and-persistent-data).253Per un plugin con percorso relativo [caricato in-place](#in-place-and-copied-plugins) da un marketplace che hai aggiunto da un percorso locale, Claude Code non installa le dipendenze nella directory di origine. Installale lì tu stesso, o da un hook in [`${CLAUDE_PLUGIN_DATA}`](/docs/it/plugins/components#path-variables-and-persistent-data).

254 254 

255L'installazione viene eseguita solo quando la directory radice del plugin contiene sia un `package.json` che un lockfile supportato.255L'installazione viene eseguita solo quando la directory radice del plugin contiene sia un `package.json` che un lockfile supportato.

256 256 


315 315 

316Un manifest che fissa `"version"` è un modo in cui la versione calcolata rimane la stessa attraverso i commit. Vedi [Come Claude Code calcola la versione](#how-claude-code-computes-the-version) per l'ordine di risoluzione.316Un manifest che fissa `"version"` è un modo in cui la versione calcolata rimane la stessa attraverso i commit. Vedi [Come Claude Code calcola la versione](#how-claude-code-computes-the-version) per l'ordine di risoluzione.

317 317 

318Un plugin [caricato in-place](#in-place-and-copied-plugins) da un marketplace di directory locale carica i suoi file di origine attuali ad ogni avvio della sessione, qualunque cosa dica la sua stringa di versione. Per un plugin da un [marketplace ospitato su claude.ai](/docs/it/plugins/install#add-from-claude-ai), la versione che claude.ai registra per il plugin è la sua versione, e il `version` del manifest non viene letto.318Un plugin [caricato in-place](#in-place-and-copied-plugins) da un marketplace che hai aggiunto da un percorso locale carica i suoi file di origine attuali ad ogni avvio della sessione, qualunque cosa dica la sua stringa di versione. Per un plugin da un [marketplace ospitato su claude.ai](/docs/it/plugins/install#add-from-claude-ai), la versione che claude.ai registra per il plugin è la sua versione, e il `version` del manifest non viene letto.

319 319 

320<h3 id="how-claude-code-computes-the-version">320<h3 id="how-claude-code-computes-the-version">

321 Come Claude Code calcola la versione321 Come Claude Code calcola la versione

Details

199 `version`199 `version`

200</h3>200</h3>

201 201 

202Una stringa di versione, non controllata rispetto a semver. Impostarla fissa il plugin a quella versione finché non la cambiate; vedere [Versions and updates](/docs/it/plugins/loading#versions-and-updates). Un plugin con una [`command` source](/docs/it/plugins/marketplace-reference), un plugin da un [marketplace ospitato su claude.ai](/docs/it/plugins/install#add-from-claude-ai), e un plugin [caricato in place](/docs/it/plugins/loading#find-plugins-on-disk) da un marketplace aggiunto come directory locale non sono fissati da questo campo.202Una stringa di versione, non controllata rispetto a semver. Impostarla fissa il plugin a quella versione finché non la cambi; vedi [Versions and updates](/docs/it/plugins/loading#versions-and-updates). Un plugin con una [`command` source](/docs/it/plugins/marketplace-reference), un plugin da un [marketplace ospitato su claude.ai](/docs/it/plugins/install#add-from-claude-ai), e un plugin [caricato in place](/docs/it/plugins/loading#find-plugins-on-disk) da un marketplace aggiunto da un percorso locale non sono fissati da questo campo.

203 203 

204<h3 id="metadata">204<h3 id="metadata">

205 `metadata`205 `metadata`

Details

434| `Link`, `Code`, `Markdown` | Un link con `href` e un `label` facoltativo, un blocco di codice e testo formattato come le risposte di Claude. `Markdown` riceve il suo contenuto nella prop `text`, non in `children`, e richiede una `key` quando passi `onLinkPress`. | Ovunque |434| `Link`, `Code`, `Markdown` | Un link con `href` e un `label` facoltativo, un blocco di codice e testo formattato come le risposte di Claude. `Markdown` riceve il suo contenuto nella prop `text`, non in `children`, e richiede una `key` quando passi `onLinkPress`. | Ovunque |

435| `Input`, `Select` | Un campo di testo e un menu a discesa | Terminale, Desktop |435| `Input`, `Select` | Un campo di testo e un menu a discesa | Terminale, Desktop |

436| `Svg` | Un documento SVG | Desktop |436| `Svg` | Un documento SVG | Desktop |

437| `Client` | Un'area disegnata da un secondo file tuo, per animazioni e input del puntatore. Quel file non riceve alcuna API dei mod. Raggiunge i tuoi hook solo inviando dati, che arrivano come evento `ui.message`. | Terminale, Desktop |437| `Client` | Un'area disegnata da un secondo file tuo, per animazioni e input del puntatore. Quel file non riceve alcuna API dei mod. Raggiunge i tuoi hook inviando dati, che arrivano come evento `ui.message`. Se non riesce a caricarsi, a disegnare o a essere eseguito, i tuoi hook ricevono un evento [`ui.fault`](/docs/it/plugins/mods/reference#interface). | Terminale, Desktop |

438| `Raster`, `Image` | Una [griglia di celle colorate](#draw-a-grid-of-colored-cells) e un'immagine | Terminale |438| `Raster`, `Image` | Una [griglia di celle colorate](#draw-a-grid-of-colored-cells) e un'immagine | Terminale |

439 439 

440Se il tuo modulo è un file `.tsx` o `.jsx`, puoi scrivere l'albero in JSX. Prima destruttura gli elementi da `$.ui.resolve(e)`.440Se il tuo modulo è un file `.tsx` o `.jsx`, puoi scrivere l'albero in JSX. Prima destruttura gli elementi da `$.ui.resolve(e)`.


664 Quando Claude Code ridisegna senza che venga richiesto664 Quando Claude Code ridisegna senza che venga richiesto

665</h3>665</h3>

666 666 

667Claude Code esegue di nuovo il tuo hook `ui.render` quando cambiano le prop del sito o quando cambia la larghezza del terminale. Non esegue l'hook in base a un timer, e non può sapere quando cambia una variabile nel tuo modulo.667Claude Code esegue di nuovo il tuo hook `ui.render` quando cambiano le prop del sito o quando cambia la larghezza del terminale. Quando un `Client` nel sito fallisce e il tuo mod gestisce [`ui.fault`](/docs/it/plugins/mods/reference#interface), Claude Code esegue l'hook ancora una volta dopo che i tuoi hook `ui.fault` hanno restituito il risultato, così il tuo hook `ui.render` può escludere il `Client`. Non esegue l'hook in base a un timer, e non può sapere quando cambia una variabile nel tuo modulo.

668 668 

669<h3 id="redraw-when-your-data-changes">669<h3 id="redraw-when-your-data-changes">

670 Ridisegnare quando i tuoi dati cambiano670 Ridisegnare quando i tuoi dati cambiano

Details

6 6 

7> Riferimento completo per i mod di Claude Code: struttura del modulo degli hook, eventi, metodi dell'API dei mod, punti di rendering, elementi per superficie, limiti e impostazioni.7> Riferimento completo per i mod di Claude Code: struttura del modulo degli hook, eventi, metodi dell'API dei mod, punti di rendering, elementi per superficie, limiti e impostazioni.

8 8 

9Consulta qualsiasi evento che un [mod](/docs/it/plugins/mods/overview) può gestire, qualsiasi metodo dell'API dei mod che può chiamare o qualsiasi punto di rendering in cui può disegnare, per la CLI di Claude Code e l'app Desktop a partire dalla v2.1.287. Ogni voce riporta il nome e una descrizione di una riga e, dove presente, rimanda alla sezione della guida che lo spiega.9Consulta qualsiasi evento che un [mod](/docs/it/plugins/mods/overview) può gestire, qualsiasi metodo dell'API dei mod che può chiamare o qualsiasi punto di rendering in cui può disegnare, per la CLI di Claude Code e l'app Desktop a partire dalla v2.1.289. Ogni voce riporta il nome e una descrizione di una riga e, dove presente, rimanda alla sezione della guida che lo spiega.

10 10 

11<Note>11<Note>

12 Il riferimento completo sono le [dichiarazioni TypeScript per i mod](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) di Claude Code, che descrivono ogni evento, metodo ed elemento, con esempi. La copia su GitHub può essere più vecchia della versione di Claude Code che hai installato. Quando le due non coincidono, fai affidamento sulla [copia che Claude Code scrive per la tua versione](/docs/it/plugins/mods/create#get-the-types-for-your-build).12 Il riferimento completo sono le [dichiarazioni TypeScript per i mod](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) di Claude Code, che descrivono ogni evento, metodo ed elemento, con esempi. La copia su GitHub può essere più vecchia della versione di Claude Code che hai installato. Quando le due non coincidono, fai affidamento sulla [copia che Claude Code scrive per la tua versione](/docs/it/plugins/mods/create#get-the-types-for-your-build).


128 Subagent128 Subagent

129</h3>129</h3>

130 130 

131Gli eventi dei subagent si attivano quando un tipo di subagent viene offerto a Claude e quando un subagent sta per avviarsi:131Gli eventi dei subagent si attivano quando un tipo di subagent viene offerto a Claude e quando un subagent o un membro di un team di agenti sta per avviarsi:

132 132 

133| Evento | Si attiva quando | Un hook può restituire |133| Evento | Si attiva quando | Un hook può restituire |

134| :- | :- | :- |134| :- | :- | :- |

135| `agent.offer` | Un tipo di subagent viene offerto a Claude | `{ isOffered: false }` per non renderlo disponibile |135| `agent.offer` | Un tipo di subagent viene offerto a Claude | `{ isOffered: false }` per non renderlo disponibile |

136| `agent.spawn` | Un subagent sta per avviarsi | `{ model }` oppure `{ deny: reason }` |136| `agent.spawn` | Un subagent o un membro di un [team di agenti](/docs/it/agent-teams) sta per avviarsi. Per un membro del team, `e.isTeammate` è `true`. | `next({ ...e, model })` per sceglierne il modello, oppure `{ deny: reason }` |

137 137 

138<h3 id="interface">138<h3 id="interface">

139 Interfaccia139 Interfaccia


149| `ui.focus`, `ui.scroll` | Il controllo con il focus o la posizione di scorrimento di un pannello o della banda sta per cambiare |149| `ui.focus`, `ui.scroll` | Il controllo con il focus o la posizione di scorrimento di un pannello o della banda sta per cambiare |

150| `ui.close` | Un pannello sta per chiudersi. `e.id` è il pannello e `e.origin.kind` è `plugin`, `person` o `unload`. |150| `ui.close` | Un pannello sta per chiudersi. `e.id` è il pannello e `e.origin.kind` è `plugin`, `person` o `unload`. |

151| [`ui.message`](/docs/it/plugins/mods/interface#build-a-tree-from-elements) | Un elemento `Client` invia dati al proprio mod |151| [`ui.message`](/docs/it/plugins/mods/interface#build-a-tree-from-elements) | Un elemento `Client` invia dati al proprio mod |

152| [`ui.fault`](/docs/it/plugins/mods/interface#redraw-when-something-changes) | Un elemento `Client` disegnato dal tuo mod non è riuscito a caricarsi, a essere disegnato o a essere eseguito. `e.phase` è `load`, `render` o `run`, e `e.reason` è il messaggio di errore. Richiede Claude Code v2.1.289 o versioni successive. |

152 153 

153<h3 id="other-mods">154<h3 id="other-mods">

154 Altri mod155 Altri mod


192| Namespace | Metodi |193| Namespace | Metodi |

193| :- | :- |194| :- | :- |

194| `$.plugin` | `name`, `root`: il nome e la directory di questo plugin |195| `$.plugin` | `name`, `root`: il nome e la directory di questo plugin |

195| [`$.ui`](/docs/it/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `blit` |196| [`$.ui`](/docs/it/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |

196| [`$.command`](/docs/it/plugins/mods/api#add-a-command) | `register`, `run`, `list` |197| [`$.command`](/docs/it/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

197| [`$.tool`](/docs/it/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |198| [`$.tool`](/docs/it/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

198| `$.agent` | `register`, `spawn`, `list` |199| `$.agent` | `register`, `spawn`, `list` |


276 277 

277| Limite | Valore |278| Limite | Valore |

278| :- | :- |279| :- | :- |

279| Il tempo di esecuzione proprio di un hook per un evento, senza contare il tempo trascorso dentro `next` o in una chiamata all'API dei mod diversa da `$.clock.sleep` | 10 secondi |280| Il tempo di esecuzione proprio di un hook per un evento, senza contare il tempo trascorso dentro `next` o in una chiamata all'API dei mod diversa da `$.clock.sleep` | 10 secondi, o 50 millisecondi per un hook `prompt.edit` |

280| Il tempo di esecuzione di un gestore `.catch` | 1 secondo |281| Il tempo di esecuzione di un gestore `.catch` | 1 secondo |

281| Tutti gli hook `session.end` insieme | 1,5 secondi |282| Tutti gli hook `session.end` insieme | Quanto il [budget dell'hook SessionEnd](/docs/it/hooks#sessionend-input), 1,5 secondi a meno che tu non lo modifichi, contati da quando terminano gli hook `SessionEnd` delle tue impostazioni |

282| Timeout di `$.process.run` | 30 secondi per impostazione predefinita, 10 minuti al massimo |283| Timeout di `$.process.run` | 30 secondi per impostazione predefinita, 10 minuti al massimo |

283| `maxTokens` di `$.model.complete` | 1024 per impostazione predefinita, fino a 64.000 o al limite di output del modello |284| `maxTokens` di `$.model.complete` | 1024 per impostazione predefinita, fino a 64.000 o al limite di output del modello |

284| `$.fs.read` e `$.fs.write` | 4 MiB per un singolo file |285| `$.fs.read` e `$.fs.write` | 4 MiB per un singolo file |

Details

1016 1016 

1017Controlla queste cause in ordine:1017Controlla queste cause in ordine:

1018 1018 

1019* **La skill imposta `disable-model-invocation: true`**: con quel campo impostato, solo tu puoi invocare la skill. La skill del template in [Create your first plugin](/docs/it/plugins/create#create-your-first-plugin) lo imposta. Rimuovi la riga da una skill che vuoi che Claude invochi da solo. [Control who invokes a skill](/docs/it/skills#control-who-invokes-a-skill) copre il campo1019* **La skill imposta `disable-model-invocation: true`**: la skill del template in [Create your first plugin](/docs/it/plugins/create#create-your-first-plugin) lo imposta. Rimuovi la riga da una skill che vuoi che Claude invochi da solo. [Control who invokes a skill](/docs/it/skills#control-who-invokes-a-skill) copre il campo

1020* **La descrizione non corrisponde a come le persone chiedono**: lavora attraverso i controlli in [Skill not triggering](/docs/it/skills#skill-not-triggering)1020* **La descrizione non corrisponde a come le persone chiedono**: lavora attraverso i controlli in [Skill not triggering](/docs/it/skills#skill-not-triggering)

1021* **La descrizione è troncata**: quando molte skill sono installate, Claude Code accorcia le descrizioni per adattarsi al budget dei caratteri dell'elenco, che può eliminare le parole chiave di cui Claude ha bisogno per abbinare una richiesta. Vedi [Skill descriptions are cut short](/docs/it/skills#skill-descriptions-are-cut-short)1021* **La descrizione è troncata**: quando molte skill sono installate, Claude Code accorcia le descrizioni per adattarsi al budget dei caratteri dell'elenco, che può eliminare le parole chiave di cui Claude ha bisogno per abbinare una richiesta. Vedi [Skill descriptions are cut short](/docs/it/skills#skill-descriptions-are-cut-short)

1022 1022 

sandboxing.md +1 −1

Details

463 463 

464Il mascheramento richiede quanto segue:464Il mascheramento richiede quanto segue:

465 465 

466* **Terminazione TLS**: il proxy sostituisce il valore reale all'interno del contenuto delle richieste, quindi deve poterlo vedere. Imposta [`network.tlsTerminate`](/docs/it/settings-reference#sandbox-network-tlsterminate) in modo che il proxy termini direttamente il TLS. Senza di esso, il mascheramento fallisce senza esporre nulla: il comando vede comunque solo la sentinella, ma la sentinella raggiunge il server invariata e l'autenticazione fallisce. Claude Code segnala questa configurazione errata all'avvio.466* **Terminazione TLS**: il proxy sostituisce il valore reale all'interno del contenuto delle richieste, quindi deve poterlo vedere. Imposta [`network.tlsTerminate`](/docs/it/settings-reference#sandbox-network-tlsterminate) in modo che il proxy termini direttamente il TLS. Senza di esso, il mascheramento fallisce senza esporre nulla: il comando vede comunque solo la sentinella, ma la sentinella raggiunge il server invariata e l'autenticazione fallisce. Per verificare questa configurazione errata, esegui `claude doctor` nel terminale e cerca l'avviso `TLS termination is unavailable`.

467* **Una destinazione consentita**: ogni voce `mask` può elencare `injectHosts`, gli host che il valore reale può raggiungere. Il proxy inserisce le credenziali solo nelle connessioni ammesse dall'[allowlist dei domini](#network-isolation), quindi ogni host `injectHosts` deve essere raggiungibile anche tramite `network.allowedDomains`. Per una voce `mask` senza `injectHosts`, il proxy sostituisce il valore reale nelle richieste verso ogni host in `network.allowedDomains`.467* **Una destinazione consentita**: ogni voce `mask` può elencare `injectHosts`, gli host che il valore reale può raggiungere. Il proxy inserisce le credenziali solo nelle connessioni ammesse dall'[allowlist dei domini](#network-isolation), quindi ogni host `injectHosts` deve essere raggiungibile anche tramite `network.allowedDomains`. Per una voce `mask` senza `injectHosts`, il proxy sostituisce il valore reale nelle richieste verso ogni host in `network.allowedDomains`.

468* **Un ambito di impostazioni attendibile**: il mascheramento autorizza il proxy a inviare la tua credenziale reale altrove, quindi Claude Code rispetta le voci `mask`, `network.tlsTerminate`, [`credentials.allowPlaintextInject`](/docs/it/settings-reference#sandbox-credentials-allowplaintextinject), `awsPairs` e `sigv4` solo dalle impostazioni utente, dalle impostazioni gestite e dal flag `--settings`. Li ignora nei file `.claude/settings.json` o `.claude/settings.local.json` di un repository. Quando il tuo amministratore distribuisce voci `mask`, `network.tlsTerminate` o `credentials.allowPlaintextInject` tramite impostazioni gestite dal server, queste vengono considerate [impostazioni che richiedono approvazione](/docs/it/server-managed-settings#security-approval-dialogs).468* **Un ambito di impostazioni attendibile**: il mascheramento autorizza il proxy a inviare la tua credenziale reale altrove, quindi Claude Code rispetta le voci `mask`, `network.tlsTerminate`, [`credentials.allowPlaintextInject`](/docs/it/settings-reference#sandbox-credentials-allowplaintextinject), `awsPairs` e `sigv4` solo dalle impostazioni utente, dalle impostazioni gestite e dal flag `--settings`. Li ignora nei file `.claude/settings.json` o `.claude/settings.local.json` di un repository. Quando il tuo amministratore distribuisce voci `mask`, `network.tlsTerminate` o `credentials.allowPlaintextInject` tramite impostazioni gestite dal server, queste vengono considerate [impostazioni che richiedono approvazione](/docs/it/server-managed-settings#security-approval-dialogs).

469 469 

Details

195 195 

196Il runner segnala anche l'opt-in ad Anthropic quando si registra, stampando `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` all'avvio. La segnalazione dell'opt-in richiede Claude Code v2.1.267 o successivo, e le versioni precedenti accettano il flag senza segnalarlo o stampare quella riga. Ogni sessione su un runner con opt-in usa quindi o git gestito da Anthropic o l'URL del proxy per sessione. Quando una sessione usa l'URL del proxy per sessione, il runner registra una riga `[runner:warn]` dicendo così.196Il runner segnala anche l'opt-in ad Anthropic quando si registra, stampando `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` all'avvio. La segnalazione dell'opt-in richiede Claude Code v2.1.267 o successivo, e le versioni precedenti accettano il flag senza segnalarlo o stampare quella riga. Ogni sessione su un runner con opt-in usa quindi o git gestito da Anthropic o l'URL del proxy per sessione. Quando una sessione usa l'URL del proxy per sessione, il runner registra una riga `[runner:warn]` dicendo così.

197 197 

198<h4 id="github-api-access-without-the-github-cli">

199 Accesso all'API di GitHub senza la GitHub CLI

200</h4>

201 

202Se l'immagine del tuo runner non include la GitHub CLI, Claude Code può fornire un `gh` integrato, così Claude può comunque aprire pull request, commentare e leggere i risultati della CI. Il `gh` integrato è pensato per i runner che usano git gestito da Anthropic. Supporta un solo comando, `gh api`, che chiama la REST API di GitHub. Richiede Claude Code v2.1.287 o successivo nell'immagine del runner.

203 

204Questo comando apre una pull request al posto di `gh pr create`. Il `gh` integrato compila `{owner}` e `{repo}` per il repository corrente:

205 

206```bash theme={null}

207gh api repos/{owner}/{repo}/pulls -f title='Fix' -f head='my-branch' -f base='main'

208```

209 

210* **Credenziali**: il `gh` integrato invia le sue richieste REST attraverso git gestito da Anthropic, che fornisce la credenziale GitHub dal lato di Anthropic, quindi l'immagine non ha bisogno di alcun token GitHub per esso

211* **Quali sessioni lo ottengono**: Anthropic decide per ogni sessione se git gestito da Anthropic serve il `gh` della sessione. Quando lo fa, la riga `[runner:session] governed git ACTIVE` che il runner registra per la sessione mostra `gh_path_shim=true`. Quando non lo fa, la sessione non ha `gh`

212* **`jq`**: installa `jq` nell'immagine se vuoi che `--jq` funzioni

213* **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars)**: se l'ambiente della sessione la imposta, Claude Code non fornisce il `gh` integrato e la sessione non ha `gh`

214 

215Quando l'immagine include la GitHub CLI, le sessioni usano quella.

216 

198<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">217<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

199 Affida un'autorità di certificazione privata a git gestito da Anthropic218 Affida un'autorità di certificazione privata a git gestito da Anthropic

200</h4>219</h4>

Details

117claude -p "your message" --cloud <session-id>117claude -p "your message" --cloud <session-id>

118```118```

119 119 

120Per `<session-id>`, passate l'ID bare `session_...` o `cse_...` oppure l'URL claude.ai/code della sessione. Un invio riuscito stampa `Sent to cloud session.` con l'ID della sessione e un link di visualizzazione. I moduli di ID accettati, l'output JSON, i requisiti dell'account e della policy, e il riferimento agli errori si trovano su [Send follow-ups from the CLI](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli), poiché il comando funziona allo stesso modo contro le sessioni ospitate da Anthropic.120Per `<session-id>`, passa l'ID semplice `session_...` o `cse_...` oppure l'URL claude.ai/code della sessione. Un invio riuscito stampa `Sent to cloud session.` con l'ID della sessione e un link di visualizzazione. I formati di ID accettati, l'output JSON e i requisiti dell'account e della policy si trovano in [Inviare follow-up dalla CLI](/docs/it/claude-code-on-the-web#send-follow-ups-from-the-cli), poiché il comando funziona allo stesso modo con le sessioni ospitate da Anthropic.

121 121 

122<h2 id="what’s-next">122<h2 id="what’s-next">

123 Cosa c'è dopo123 Cosa c'è dopo

Details

6 6 

7> Configurare centralmente Claude Code per la vostra organizzazione tramite impostazioni consegnate dal server, senza richiedere infrastrutture di gestione dei dispositivi.7> Configurare centralmente Claude Code per la vostra organizzazione tramite impostazioni consegnate dal server, senza richiedere infrastrutture di gestione dei dispositivi.

8 8 

9Le impostazioni gestite dal server consentono ai proprietari dell'organizzazione di configurare centralmente Claude Code da [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) nella console claude.ai. I client di Claude Code recuperano automaticamente queste impostazioni quando gli utenti si autenticano con un accesso idoneo su una piattaforma dove la consegna gestita dal server è supportata. Vedere [Disponibilità della piattaforma](#platform-availability) per le credenziali e le piattaforme che si qualificano.9Le impostazioni gestite dal server consentono ai proprietari dell'organizzazione di configurare centralmente Claude Code da [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) nella console claude.ai. I client di Claude Code recuperano automaticamente queste impostazioni quando gli utenti si autenticano con una credenziale idonea su una piattaforma dove la consegna gestita dal server è supportata. Consulta [Disponibilità della piattaforma](#platform-availability) per le credenziali e le piattaforme che si qualificano.

10 10 

11<Note>11<Note>

12 Le impostazioni gestite dal server sono disponibili per i clienti di [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise).12 Le impostazioni gestite dal server sono disponibili per i clienti di [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise).


41 41 

42<Steps>42<Steps>

43 <Step title="Aprire la console di amministrazione">43 <Step title="Aprire la console di amministrazione">

44 Nella console claude.ai, andare a [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).44 Nella console claude.ai, vai a [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).

45 45 

46 Se il collegamento vi reindirizza a una pagina Admin Settings diversa invece della pagina Claude Code, il vostro account non dispone del ruolo richiesto. I ruoli Admin e altri ruoli non-Owner non possono visualizzare o modificare le impostazioni gestite, quindi chiedete a un Owner o Primary Owner nella vostra organizzazione di apportare la modifica. Vedere [Controllo di accesso](#access-control).46 Se il collegamento ti reindirizza a una pagina Organization settings diversa invece della pagina Claude Code, il tuo account non dispone del ruolo richiesto. I ruoli Admin e gli altri ruoli non-Owner non possono visualizzare o modificare le impostazioni gestite, quindi chiedi a un Owner o Primary Owner della tua organizzazione di apportare la modifica. Consulta [Controllo di accesso](#access-control).

47 </Step>47 </Step>

48 48 

49 <Step title="Definire le impostazioni">49 <Step title="Definire le impostazioni">

50 Aggiungere la configurazione come JSON. Tutte le [impostazioni disponibili in `settings.json`](/docs/it/settings-reference#all-settings) sono supportate eccetto quelle limitate alla distribuzione delle politiche a livello del sistema operativo; vedere [Limitazioni attuali](#current-limitations) per questo breve elenco. Questo include [hooks](/docs/it/hooks), [variabili di ambiente](/docs/it/env-vars), e [impostazioni solo gestite](/docs/it/managed-settings#managed-only-settings) come `allowManagedPermissionRulesOnly`.50 Aggiungi la configurazione come JSON. Tutte le [impostazioni disponibili in `settings.json`](/docs/it/settings-reference#all-settings) sono supportate eccetto quelle limitate alla distribuzione delle politiche a livello del sistema operativo; consulta [Limitazioni attuali](#current-limitations) per questo breve elenco. Questo include [hook](/docs/it/hooks), [variabili d'ambiente](/docs/it/env-vars) e [impostazioni solo gestite](/docs/it/managed-settings#managed-only-settings) come `allowManagedPermissionRulesOnly`.

51 51 

52 Questo esempio applica un elenco di negazione delle autorizzazioni, impedisce agli utenti di ignorare le autorizzazioni e limita le regole di autorizzazione a quelle definite nelle impostazioni gestite. La regola `Bash(curl *)` corrisponde a `curl` [come Claude lo scrive](/docs/it/permissions#bash-rule-limits), non a `/usr/bin/curl` o `sh -c 'curl …'`; per l'applicazione della rete che non dipende dal testo del comando, aggiungere un [blocco `sandbox` con `allowManagedDomainsOnly`](/docs/it/sandboxing#configure-the-sandbox-for-your-organization).52 Questo esempio applica un elenco di negazione delle autorizzazioni, impedisce agli utenti di ignorare le autorizzazioni e limita le regole di autorizzazione a quelle definite nelle impostazioni gestite. La regola `Bash(curl *)` corrisponde a `curl` [come Claude lo scrive](/docs/it/permissions#bash-rule-limits), non a `/usr/bin/curl` o `sh -c 'curl …'`; per l'applicazione della rete che non dipende dal testo del comando, aggiungere un [blocco `sandbox` con `allowManagedDomainsOnly`](/docs/it/sandboxing#configure-the-sandbox-for-your-organization).

53 53 

sessions.md +1 −0

Details

292| [Assegna un nome alla directory `<project>` tu stesso](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/it/env-vars) | Variabile di ambiente |292| [Assegna un nome alla directory `<project>` tu stesso](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/it/env-vars) | Variabile di ambiente |

293| Cambia la conservazione di 30 giorni | [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays) | `settings.json` |293| Cambia la conservazione di 30 giorni | [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays) | `settings.json` |

294| Imposta un limite di età per [i trascritti di Claude Desktop e Cowork](/docs/it/claude-directory#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](/docs/it/settings-reference#desktopsessioncleanupperioddays) | Impostazioni utente, impostazioni gestite, o `--settings` |294| Imposta un limite di età per [i trascritti di Claude Desktop e Cowork](/docs/it/claude-directory#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](/docs/it/settings-reference#desktopsessioncleanupperioddays) | Impostazioni utente, impostazioni gestite, o `--settings` |

295| Limita quanto può crescere il file di trascrizione di una sessione `-p` o dell'Agent SDK | [`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`](/docs/it/env-vars) | Variabile d'ambiente |

295| Sopprimere le scritture di trascritto in tutte le modalità | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/it/env-vars) | Variabile di ambiente |296| Sopprimere le scritture di trascritto in tutte le modalità | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/it/env-vars) | Variabile di ambiente |

296| Sopprimere le scritture per un'esecuzione non interattiva | [`--no-session-persistence`](/docs/it/cli-reference) | Flag CLI con `claude -p` |297| Sopprimere le scritture per un'esecuzione non interattiva | [`--no-session-persistence`](/docs/it/cli-reference) | Flag CLI con `claude -p` |

297 298 

Details

990 990 

991Quando la tua organizzazione distribuisce qualsiasi impostazione gestita, Claude Code legge questa chiave solo dalla fonte gestita e la ignora negli altri tuoi file.991Quando la tua organizzazione distribuisce qualsiasi impostazione gestita, Claude Code legge questa chiave solo dalla fonte gestita e la ignora negli altri tuoi file.

992 992 

993Per come questa chiave si applica ai controlli del modello all'avvio, vedi [Amazon Bedrock](/docs/it/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) e [Agent Platform di Google Cloud](/docs/it/google-vertex-ai#when-your-organization-enforces-a-model-allowlist).

994 

993* **Scope**: [`Any file`](#scopes)995* **Scope**: [`Any file`](#scopes)

994* **Type**: Boolean996* **Type**: Boolean

995 * `true`: quando **Default** si risolverebbe a un modello al di fuori di `availableModels`, Claude Code lo risolve al primo modello disponibile nell'elenco997 * `true`: quando **Default** si risolverebbe a un modello al di fuori di `availableModels`, Claude Code lo risolve al primo modello disponibile nell'elenco


3135* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/it/sessions#name-the-project-directory-yourself), che Claude Code legge solo dall'ambiente di avvio, viene ignorata in ogni file; richiede la v2.1.234 o successiva.3137* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/it/sessions#name-the-project-directory-yourself), che Claude Code legge solo dall'ambiente di avvio, viene ignorata in ogni file; richiede la v2.1.234 o successiva.

3136* [`CLAUDE_CODE_RESTRICTED`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, viene ignorata in ogni file.3138* [`CLAUDE_CODE_RESTRICTED`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, viene ignorata in ogni file.

3137* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, viene ignorata in ogni file. La variabile richiede Claude Code v2.1.283 o successiva.3139* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, viene ignorata in ogni file. La variabile richiede Claude Code v2.1.283 o successiva.

3138* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` e `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, vengono ignorate in ogni file.3140* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`, `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` e `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT`](/docs/it/env-vars#variables), che Claude Code legge solo dall'ambiente di avvio, vengono ignorate in ogni file.

3139 3141 

3140<h3 id="filecheckpointingenabled">3142<h3 id="filecheckpointingenabled">

3141 `fileCheckpointingEnabled`3143 `fileCheckpointingEnabled`

skills.md +16 −3

Details

561 561 

562Per impostazione predefinita, sia tu che Claude potete invocare qualsiasi skill. Puoi digitare `/skill-name` per invocarla direttamente, e Claude può caricarla automaticamente quando rilevante per la tua conversazione. Due campi frontmatter ti permettono di limitare questo:562Per impostazione predefinita, sia tu che Claude potete invocare qualsiasi skill. Puoi digitare `/skill-name` per invocarla direttamente, e Claude può caricarla automaticamente quando rilevante per la tua conversazione. Due campi frontmatter ti permettono di limitare questo:

563 563 

564* **`disable-model-invocation: true`**: Solo tu puoi invocare la skill. Usa questo per flussi di lavoro con effetti collaterali o che vuoi controllare il timing, come `/commit`, `/deploy` o `/send-slack-message`. Non vuoi che Claude decida di distribuire perché il tuo codice sembra pronto.564* **`disable-model-invocation: true`**: Claude non può invocare la skill di propria iniziativa. Usa questo per workflow con effetti collaterali o di cui vuoi controllare il timing, come `/commit`, `/deploy` o `/send-slack-message`. Non vuoi che Claude decida di fare il deploy perché il tuo codice sembra pronto.

565 565 

566* **`user-invocable: false`**: Solo Claude può invocare la skill. Usa questo per conoscenze di background che non sono azionabili come comando. Una skill `legacy-system-context` spiega come funziona un vecchio sistema. Claude dovrebbe saperlo quando rilevante, ma `/legacy-system-context` non è un'azione significativa per gli utenti da intraprendere.566* **`user-invocable: false`**: Solo Claude può invocare la skill. Usa questo per conoscenze di background che non sono azionabili come comando. Una skill `legacy-system-context` spiega come funziona un vecchio sistema. Claude dovrebbe saperlo quando rilevante, ma `/legacy-system-context` non è un'azione significativa per gli utenti da intraprendere.

567 567 

568Questo esempio crea una skill di distribuzione che solo tu puoi attivare. Se imposti `disable-model-invocation: true`, Claude non può eseguire la skill automaticamente:568Questo esempio crea una skill di deploy. Se imposti `disable-model-invocation: true`, Claude non può eseguire la skill automaticamente:

569 569 

570```yaml theme={null}570```yaml theme={null}

571---571---


589| Frontmatter | Puoi invocare | Claude può invocare | Quando caricato nel contesto |589| Frontmatter | Puoi invocare | Claude può invocare | Quando caricato nel contesto |

590| :- | :- | :- | :- |590| :- | :- | :- | :- |

591| (predefinito) | Sì | Sì | Descrizione sempre nel contesto, skill completa si carica quando invocata |591| (predefinito) | Sì | Sì | Descrizione sempre nel contesto, skill completa si carica quando invocata |

592| `disable-model-invocation: true` | Sì | No | Descrizione non nel contesto, skill completa si carica quando la invochi |592| `disable-model-invocation: true` | Sì | Non di propria iniziativa | Descrizione non nel contesto, skill completa si carica quando invocata |

593| `user-invocable: false` | No | Sì | Descrizione sempre nel contesto, skill completa si carica quando invocata |593| `user-invocable: false` | No | Sì | Descrizione sempre nel contesto, skill completa si carica quando invocata |

594 594 

595<Note>595<Note>

596 In una sessione regolare, le descrizioni delle skills vengono caricate nel contesto in modo che Claude sappia cosa è disponibile, ma il contenuto completo della skill si carica solo quando invocato. [Subagent con skills precaricate](/docs/it/sub-agents#preload-skills-into-subagents) funzionano diversamente: il contenuto completo della skill viene iniettato all'avvio.596 In una sessione regolare, le descrizioni delle skills vengono caricate nel contesto in modo che Claude sappia cosa è disponibile, ma il contenuto completo della skill si carica solo quando invocato. [Subagent con skills precaricate](/docs/it/sub-agents#preload-skills-into-subagents) funzionano diversamente: il contenuto completo della skill viene iniettato all'avvio.

597</Note>597</Note>

598 598 

599<h4 id="where-you-write-the-skill’s-name">

600 Dove scrivi il nome della skill

601</h4>

602 

603Per eseguire direttamente una skill, metti il suo nome all'inizio del messaggio. Dopo del testo normale, il nome dà a Claude il permesso di eseguire la skill ma non la esegue:

604 

605| Dove | Esempio | Cosa succede |

606| :- | :- | :- |

607| All'inizio del messaggio | `/deploy staging` | Claude Code esegue direttamente la skill |

608| Dopo del testo normale, come parola separata senza punteggiatura attaccata | `go ahead and /deploy to staging` | Niente viene eseguito direttamente. Il nome vale come tuo permesso per quel messaggio: Claude può eseguire la skill mentre risponde, e valuta dalle tue parole se gliel'hai chiesto |

609 

610Per parlare della skill senza permetterne l'esecuzione, ometti la barra.

611 

599<h3 id="skill-content-lifecycle">612<h3 id="skill-content-lifecycle">

600 Ciclo di vita del contenuto della skill613 Ciclo di vita del contenuto della skill

601</h3>614</h3>

sub-agents.md +1 −1

Details

632 632 

633Il contenuto completo di ogni skill elencata viene iniettato nel contesto del subagent all'avvio. Questo campo controlla quali skills vengono precaricate, non quali skills il subagent può accedere: senza di esso, il subagent può comunque scoprire e invocare skills di progetto, utente e plugin tramite lo strumento Skill durante l'esecuzione. Per impedire a un subagent di invocare skills interamente, ometta `Skill` dall'elenco [`tools`](#available-tools) o aggiunga a `disallowedTools`.633Il contenuto completo di ogni skill elencata viene iniettato nel contesto del subagent all'avvio. Questo campo controlla quali skills vengono precaricate, non quali skills il subagent può accedere: senza di esso, il subagent può comunque scoprire e invocare skills di progetto, utente e plugin tramite lo strumento Skill durante l'esecuzione. Per impedire a un subagent di invocare skills interamente, ometta `Skill` dall'elenco [`tools`](#available-tools) o aggiunga a `disallowedTools`.

634 634 

635Non può precaricare skills che impostano [`disable-model-invocation: true`](/docs/it/skills#control-who-invokes-a-skill), poiché il precaricamento attinge dallo stesso insieme di skills che Claude può invocare. Questo include la skill `/verify` in bundle: solo lei può eseguirla, quindi non può essere precaricata nemmeno.635Non puoi precaricare skill che impostano [`disable-model-invocation: true`](/docs/it/skills#control-who-invokes-a-skill), poiché il precaricamento attinge dallo stesso insieme di skill che Claude può invocare. Questo include la skill inclusa `/verify`, che Claude non può eseguire di propria iniziativa.

636 636 

637Se una skill elencata è mancante o disabilitata, ad esempio dalla politica della sua organizzazione, Claude Code la salta e registra un avviso nel log di debug.637Se una skill elencata è mancante o disabilitata, ad esempio dalla politica della sua organizzazione, Claude Code la salta e registra un avviso nel log di debug.

638 638 

Details

487 487 

488Claude Code avvia PowerShell con `-ExecutionPolicy Bypass` solo a livello di processo, quindi gli script `.ps1` e le importazioni di moduli funzionano sulle installazioni Windows predefinite senza modificare la politica della macchina. Il bypass a livello di processo non sostituisce la Criteri di gruppo `MachinePolicy` o `UserPolicy`, quindi le politiche aziendali rimangono in vigore. Per rispettare la politica di esecuzione effettiva della macchina, impostare `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`.488Claude Code avvia PowerShell con `-ExecutionPolicy Bypass` solo a livello di processo, quindi gli script `.ps1` e le importazioni di moduli funzionano sulle installazioni Windows predefinite senza modificare la politica della macchina. Il bypass a livello di processo non sostituisce la Criteri di gruppo `MachinePolicy` o `UserPolicy`, quindi le politiche aziendali rimangono in vigore. Per rispettare la politica di esecuzione effettiva della macchina, impostare `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`.

489 489 

490<h3 id="bash-deny-rules-also-turn-off-the-powershell-tool">

491 Le regole di negazione di Bash disattivano anche lo strumento PowerShell

492</h3>

493 

494Su Windows con Git Bash installato, negare Bash disattiva anche lo strumento PowerShell per la sessione. Questo vale sia per le regole con ambito limitato come `Bash(git push *)` sia per un semplice `Bash`, e per le regole provenienti da uno dei tuoi file di impostazioni o da `--disallowedTools`. Claude Code si comporta così perché una regola `Bash` non limita lo strumento PowerShell, che ha [le proprie regole di permesso](/docs/it/permissions#powershell). Con PowerShell attivo, Claude potrebbe eseguire lì ciò che la tua regola nega in Bash.

495 

496Per mantenere attivo lo strumento PowerShell insieme a una regola di negazione di Bash, esegui una di queste operazioni:

497 

498* Imposta `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` nel tuo ambiente o nel blocco `env` di un file di impostazioni, come mostrato in [Abilitare lo strumento PowerShell](#enable-the-powershell-tool).

499* Aggiungi una [regola di permesso `PowerShell`](/docs/it/permissions#powershell) con ambito limitato a un file di impostazioni, come una regola di negazione `PowerShell(git push *)`.

500 

501Senza una di queste, una regola di negazione di Bash con ambito limitato lascia disponibile lo strumento Bash, e Claude Code disattiva PowerShell senza alcun avviso. Una regola che rimuove l'intero strumento Bash lascia Claude senza alcuno strumento shell per la sessione.

502 

490<h3 id="shell-selection-in-settings-hooks-and-skills">503<h3 id="shell-selection-in-settings-hooks-and-skills">

491 Shell selection in settings, hooks, and skills504 Shell selection in settings, hooks, and skills

492</h3>505</h3>

Details

62La connessione di GitHub è un passaggio una tantum. Se usi già la GitHub CLI, puoi [farlo dal tuo terminale](#connect-from-your-terminal) invece che dal browser.62La connessione di GitHub è un passaggio una tantum. Se usi già la GitHub CLI, puoi [farlo dal tuo terminale](#connect-from-your-terminal) invece che dal browser.

63 63 

64<Note>64<Note>

65 Nei piani Team ed Enterprise, il passaggio **Sign in with GitHub** funziona solo dopo che un [Owner](/docs/it/server-managed-settings#access-control) della tua organizzazione Claude attiva il connettore GitHub in [**Admin settings > Connectors**](https://claude.ai/admin-settings/connectors). Fino ad allora, quel passaggio mostra "GitHub access is required for Claude Code on the web" invece di un pulsante di accesso. Dopo che il connettore è attivo, ricarica [claude.ai/code](https://claude.ai/code) e ricomincia dal primo passaggio. Un secondo interruttore, [Quick web setup](/docs/it/claude-code-on-the-web#github-authentication-options) in [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code), è facoltativo: con esso attivo, `/web-setup` funziona e l'onboarding crea l'ambiente per i membri.65 Nei piani Team ed Enterprise, il passaggio **Sign in with GitHub** funziona solo dopo che un [Owner](/docs/it/server-managed-settings#access-control) della tua organizzazione Claude attiva il connettore GitHub in [**Organization settings > Connectors**](https://claude.ai/admin-settings/connectors). Fino ad allora, quel passaggio mostra "GitHub access is required for Claude Code cloud sessions" invece di un pulsante di accesso. Dopo che il connettore è attivo, ricarica [claude.ai/code](https://claude.ai/code) e ricomincia dal primo passaggio. Un secondo interruttore, [Quick setup](/docs/it/claude-code-on-the-web#quick-setup-for-team-and-enterprise) in [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code), è facoltativo: con esso attivo, `/web-setup` funziona e l'onboarding crea l'ambiente per i membri.

66</Note>66</Note>

67 67 

68<Steps>68<Steps>


84 Un [cloud environment](/docs/it/cloud-environments) è la configurazione salvata che controlla quale accesso di rete Claude ha durante le sessioni e cosa viene eseguito quando una sessione si avvia. Quello che accade dopo che connetti GitHub dipende dal tuo piano:84 Un [cloud environment](/docs/it/cloud-environments) è la configurazione salvata che controlla quale accesso di rete Claude ha durante le sessioni e cosa viene eseguito quando una sessione si avvia. Quello che accade dopo che connetti GitHub dipende dal tuo piano:

85 85 

86 * **Pro e Max**: l'onboarding crea un ambiente denominato **Default** per te.86 * **Pro e Max**: l'onboarding crea un ambiente denominato **Default** per te.

87 * **Team ed Enterprise**: l'onboarding mostra un modulo **Create your first cloud environment**. Lascia il nome precompilato e l'accesso alla rete invariati e fai clic su **Create & finish** per creare l'ambiente **Default**. Se un Owner ha attivato [Quick web setup](/docs/it/claude-code-on-the-web#github-authentication-options), l'onboarding crea **Default** per te invece.87 * **Team ed Enterprise**: l'onboarding mostra un modulo **Create your first cloud environment**. Lascia il nome precompilato e l'accesso alla rete invariati e fai clic su **Create & finish** per creare l'ambiente **Default**. Se un Owner ha attivato [Quick setup](/docs/it/claude-code-on-the-web#quick-setup-for-team-and-enterprise), l'onboarding crea **Default** per te invece.

88 88 

89 **Default** utilizza [`Trusted` network access](/docs/it/cloud-environments#access-levels): le sessioni raggiungono [registri di pacchetti comuni](/docs/it/cloud-environments#default-allowed-domains) e altri domini nella lista di autorizzazione, e nient'altro attraverso la rete della sessione. Vedi [Installed tools](/docs/it/cloud-environments#installed-tools) per quello che è disponibile senza alcuna configurazione.89 **Default** utilizza [`Trusted` network access](/docs/it/cloud-environments#access-levels): le sessioni raggiungono [registri di pacchetti comuni](/docs/it/cloud-environments#default-allowed-domains) e altri domini nella lista di autorizzazione, e nient'altro attraverso la rete della sessione. Vedi [Installed tools](/docs/it/cloud-environments#installed-tools) per quello che è disponibile senza alcuna configurazione.

90 90 


96 Connetti dal tuo terminale96 Connetti dal tuo terminale

97</h3>97</h3>

98 98 

99Se usi già la GitHub CLI (`gh`), puoi connettere GitHub per le sessioni cloud dal tuo terminale. Questo richiede la [Claude Code CLI](/docs/it/quickstart). Nei piani Team ed Enterprise, `/web-setup` è disponibile solo dopo che un Owner attiva [Quick web setup](/docs/it/claude-code-on-the-web#github-authentication-options).99Se usi già la GitHub CLI (`gh`), puoi connettere GitHub per le sessioni cloud dal tuo terminale. Questo richiede la [Claude Code CLI](/docs/it/quickstart). Nei piani Team ed Enterprise, `/web-setup` è disponibile solo dopo che un Owner attiva [Quick setup](/docs/it/claude-code-on-the-web#quick-setup-for-team-and-enterprise).

100 100 

101Quando esegui `/web-setup`, Claude Code legge il token che `gh auth token` stampa, ti chiede di confermare e invia il token ad Anthropic. Anthropic lo archivia crittografato con il tuo account claude.ai e le tue sessioni cloud lo utilizzano per l'accesso a GitHub fino a quando non lo [rimuovi](#remove-the-web-setup-token). Una sessione cloud che avvii tu stesso può quindi accedere a qualsiasi repository a cui quel token può accedere, senza alcuna installazione dell'App Claude GitHub. I thread in un [progetto](/docs/it/claude-projects#set-up-github-access) hanno ancora bisogno dell'App.101Quando esegui `/web-setup`, Claude Code legge il token che `gh auth token` stampa, ti chiede di confermare e invia il token ad Anthropic. Anthropic lo archivia crittografato con il tuo account claude.ai e le tue sessioni cloud lo utilizzano per l'accesso a GitHub fino a quando non lo [rimuovi](#remove-the-web-setup-token). Una sessione cloud che avvii tu stesso può quindi accedere a qualsiasi repository a cui quel token può accedere, senza alcuna installazione dell'App Claude GitHub. I thread in un [progetto](/docs/it/claude-projects#set-up-github-access) hanno ancora bisogno dell'App.

102 102 


259 259 

260Se l'hai digitato all'interno di Claude Code e il menu dei comandi mostra `No commands match "/web-setup"`, o l'invio restituisce `Unknown command: /web-setup`, il comando è nascosto perché un requisito non è soddisfatto. La causa è solitamente che sei autenticato con una chiave API o un provider di terze parti invece di un abbonamento claude.ai. Esegui `/login` per accedere con il tuo account claude.ai.260Se l'hai digitato all'interno di Claude Code e il menu dei comandi mostra `No commands match "/web-setup"`, o l'invio restituisce `Unknown command: /web-setup`, il comando è nascosto perché un requisito non è soddisfatto. La causa è solitamente che sei autenticato con una chiave API o un provider di terze parti invece di un abbonamento claude.ai. Esegui `/login` per accedere con il tuo account claude.ai.

261 261 

262Nei piani Team e Enterprise, il comando è nascosto per impostazione predefinita: il [Quick web setup toggle](/docs/it/claude-code-on-the-web#github-authentication-options) è disattivato fino a quando un proprietario non lo attiva. Mentre è disattivato, [connetti GitHub dal browser](#connect-github) invece.262Nei piani Team e Enterprise, il comando è nascosto per impostazione predefinita: l'[interruttore Quick setup](/docs/it/claude-code-on-the-web#quick-setup-for-team-and-enterprise) è disattivato fino a quando un proprietario non lo attiva. Mentre è disattivato, [connetti GitHub dal browser](#connect-github) invece.

263 263 

264Il comando è anche nascosto in altri due casi:264Il comando è anche nascosto in altri due casi:

265 265