Documentation — Spybara

admin-setup.md +1 −1

Details

167 167

168* [Quickstart](/docs/it/quickstart): procedura dettagliata della prima sessione dall'installazione al lavoro con un progetto168* [Quickstart](/docs/it/quickstart): procedura dettagliata della prima sessione dall'installazione al lavoro con un progetto

169* [Common workflows](/docs/it/common-workflows): modelli per attività quotidiane come revisione del codice, refactoring e debug169* [Common workflows](/docs/it/common-workflows): modelli per attività quotidiane come revisione del codice, refactoring e debug

170* [Claude 101](https://anthropic.skilljar.com/claude-101) e [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action): corsi di Anthropic Academy a ritmo autonomo170* [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action): corsi gratuiti a ritmo autonomo su [Claude Academy](https://academy.claude.com/)

171 171

172Per i problemi di accesso, indirizza gli sviluppatori alla [risoluzione dei problemi di autenticazione](/docs/it/troubleshoot-install#login-and-authentication). Le correzioni più comuni sono:172Per i problemi di accesso, indirizza gli sviluppatori alla [risoluzione dei problemi di autenticazione](/docs/it/troubleshoot-install#login-and-authentication). Le correzioni più comuni sono:

173 173

advisor.md +8 −8

Details

56* Esegui `/advisor` con un modello, come `/advisor opus`, per impostarlo.56* Esegui `/advisor` con un modello, come `/advisor opus`, per impostarlo.

57* Esegui `/advisor off` per disattivarlo.57* Esegui `/advisor off` per disattivarlo.

58 58

59Claude Code non invoca un advisor salvato che l'allowlist [`availableModels`](/docs/it/model-config#restrict-model-selection) della tua organizzazione esclude. Per usare l'advisor, scegli un modello consentito con `/advisor`. Claude Code salva comunque un advisor che il tuo modello principale attuale non supporta. Quell'advisor si attiva dopo che passi a un modello principale [compatibile](#choose-an-advisor-model) con [`/model`](/docs/it/model-config#setting-your-model).59Claude Code non invoca un advisor salvato che l'allowlist [`availableModels`](/docs/it/model-config#restrict-model-selection) della tua organizzazione esclude. Per usare l'advisor, scegli un modello consentito con `/advisor`. Claude Code salva comunque un advisor che il tuo modello principale attuale non supporta. Quell'advisor si attiva dopo che passi a un modello principale [compatibile](#choose-an-advisor-model) con [`/model`](/docs/it/model-config#setting-your-model). Se l'API ha già rifiutato l'advisor salvato nella conversazione corrente, rimane disattivato fino a `/clear` o `/compact`, anche dopo aver cambiato modelli.

60 60

61Su alcuni piani, Fable come advisor ha anche bisogno del tuo [consenso una tantum per fatturare l'utilizzo di Fable ai crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits). Per sapere cosa fa `/advisor fable` prima di aver dato quel consenso, vedi [Advisor Fable e crediti di utilizzo](#fable-advisor-and-usage-credits).61Su alcuni piani, Fable come advisor ha anche bisogno del tuo [consenso una tantum per fatturare l'utilizzo di Fable ai crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits). Per sapere cosa fa `/advisor fable` prima di aver dato quel consenso, vedi [Advisor Fable e crediti di utilizzo](#fable-advisor-and-usage-credits).

62 62

98L'advisor deve essere almeno altrettanto capace del modello principale. Gli advisor accettati per ogni modello principale sono:98L'advisor deve essere almeno altrettanto capace del modello principale. Gli advisor accettati per ogni modello principale sono:

99 99

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

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

110 110

111Fable 5.1 richiede Claude Code v2.1.257 o successivo. Entrambi i modelli Fable richiedono [accesso a Fable](/docs/it/model-config#work-with-fable).111Fable 5.1 richiede Claude Code v2.1.257 o successivo. Entrambi i modelli Fable richiedono [accesso a Fable](/docs/it/model-config#work-with-fable).

112 112

113Imposta l'advisor come `fable`, `opus`, o `sonnet`. Questi alias si risolvono nella versione predefinita integrata di Claude Code per ogni famiglia di modelli, che avanza con le nuove versioni di Claude Code. Puoi anche passare un ID modello completo come `claude-opus-5`.113Imposta l'advisor come `fable`, `opus`, o `sonnet`. Questi alias si risolvono nella versione predefinita integrata di Claude Code per ogni famiglia di modelli, che avanza con le nuove versioni di Claude Code. Puoi anche passare un ID modello completo come `claude-opus-5-5`.

114 114

115I subagent ereditano l'advisor configurato e applicano lo stesso controllo di accoppiamento rispetto al loro modello.115I subagent ereditano l'advisor configurato e applicano lo stesso controllo di accoppiamento rispetto al loro modello.

116 116

117Claude Code convalida l'accoppiamento prima di inviare una richiesta e l'API lo convalida di nuovo:117Claude Code convalida l'accoppiamento prima di inviare una richiesta e l'API lo convalida di nuovo:

118 118

119* Per un advisor che la tabella elenca come rifiutato, Claude Code non lo allega alle richieste del modello principale. L'output del comando `/advisor` e una notifica mostrano questo. I subagent il cui modello soddisfa l'accoppiamento possono comunque utilizzare l'advisor.119* Per un advisor che la tabella elenca come rifiutato, Claude Code non lo allega alle richieste del modello principale. L'output del comando `/advisor` e una notifica mostrano questo. I subagent il cui modello soddisfa l'accoppiamento possono comunque utilizzare l'advisor.

120* Per un advisor che la tabella elenca come fallimento con un errore API, Claude Code lo allega e l'API lo rifiuta. Ogni richiesta fallisce con `'<advisor model>' cannot be used as an advisor when the request model is '<main model>'` finché non modifichi l'advisor con `/advisor` o lo disattivi.120* Per un advisor che la tabella elenca come rifiutato dall'API, Claude Code lo allega e l'API lo rifiuta. Claude Code quindi rinvia quella richiesta senza l'advisor e il resto della conversazione procede senza uno, quindi non vedi alcun errore e non ottieni alcuna chiamata advisor. Scegli un advisor accettato con `/advisor`; il cambiamento ha effetto dopo `/clear` o `/compact` e nelle nuove sessioni.

121* Se il modello principale o l'advisor è un modello che Claude Code non riconosce, l'advisor non è allegato.121* Se il modello principale o l'advisor è un modello che Claude Code non riconosce, l'advisor non è allegato.

122 122

123<h3 id="fable-advisor-and-usage-credits">123<h3 id="fable-advisor-and-usage-credits">

195 195

196Lo strumento advisor richiede tutti i seguenti:196Lo strumento advisor richiede tutti i seguenti:

197 197

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

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

200* **Recupero del feature flag**: Claude Code attiva l'advisor tramite un feature flag che recupera da Anthropic. In una sessione in cui è impostata una variabile che disattiva il recupero dei flag, come `DISABLE_TELEMETRY`, l'advisor rimane disattivato. Vedere [Funzionalità che richiedono il recupero del feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching).200* **Recupero del feature flag**: Claude Code attiva l'advisor tramite un feature flag che recupera da Anthropic. In una sessione in cui è impostata una variabile che disattiva il recupero dei flag, come `DISABLE_TELEMETRY`, l'advisor rimane disattivato. Vedere [Funzionalità che richiedono il recupero del feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching).

201 201

agent-sdk/configuration.md +3 −1

Details

189TypeScript ha anche `applyFlagSettings()` e `updateSettings()`:189TypeScript ha anche `applyFlagSettings()` e `updateSettings()`:

190 190

191* **`applyFlagSettings()`**: applica le impostazioni in fase di esecuzione, come in `await session.applyFlagSettings({ effortLevel: "high" })`. Il metodo accetta chiavi di file di impostazioni piuttosto che campi di opzioni, quindi controllate il riferimento [`applyFlagSettings()`](/docs/it/agent-sdk/typescript#applyflagsettings) per lo schema e per quali chiavi hanno effetto durante la sessione.191* **`applyFlagSettings()`**: applica le impostazioni in fase di esecuzione, come in `await session.applyFlagSettings({ effortLevel: "high" })`. Il metodo accetta chiavi di file di impostazioni piuttosto che campi di opzioni, quindi controllate il riferimento [`applyFlagSettings()`](/docs/it/agent-sdk/typescript#applyflagsettings) per lo schema e per quali chiavi hanno effetto durante la sessione.

192* **`updateSettings()`**: scrive un insieme di chiavi consentite nel file di impostazioni locali del progetto, come in `await session.updateSettings("localSettings", { outputStyle: "Explanatory" })`. Le chiavi scritte hanno effetto sulla richiesta successiva della sessione e persistono per le sessioni successive che caricano le impostazioni `local`. La riga del metodo nella [tabella dei metodi](/docs/it/agent-sdk/typescript#methods) nomina le chiavi consentite e il floor della versione.192* **`updateSettings()`**: scrive una chiave consentita in un file di impostazioni. Il riferimento [`updateSettings()`](/docs/it/agent-sdk/typescript#updatesettings) nomina la chiave che ogni sorgente accetta e il floor della versione.

193 * Passate `"localSettings"` per scrivere il file di impostazioni locali del progetto, come in `await session.updateSettings("localSettings", { outputStyle: "Explanatory" })`. La chiave scritta ha effetto sulla richiesta successiva della sessione e persiste per le sessioni successive che caricano le impostazioni `local`.

194 * Passate `"userSettings"` per scrivere `effortLevel`, l'unica chiave che la sorgente accetta. Claude Code la salva come il livello di sforzo predefinito per il modello corrente della sessione, e lo sforzo della sessione in esecuzione non cambia.

193 195

194L'esempio seguente esegue una sessione a due turni, cambia la configurazione tra i turni e stampa il modello che ha risposto a ogni turno. In TypeScript, il flusso del prompt tiene il secondo messaggio fino a quando i setter non hanno funzionato, e il secondo turno viene eseguito sul nuovo modello.196L'esempio seguente esegue una sessione a due turni, cambia la configurazione tra i turni e stampa il modello che ha risposto a ogni turno. In TypeScript, il flusso del prompt tiene il secondo messaggio fino a quando i setter non hanno funzionato, e il secondo turno viene eseguito sul nuovo modello.

195 197

agent-sdk/cost-tracking.md +18 −8

Details

37 37

38* **Chiamata `query()`:** una singola invocazione della funzione `query()` dell'SDK. Una singola chiamata può coinvolgere più fasi: Claude risponde, utilizza strumenti, ottiene risultati e risponde di nuovo. Ogni chiamata produce un messaggio [`result`](/docs/it/agent-sdk/typescript#sdkresultmessage) alla fine, tranne in [modalità input streaming](/docs/it/agent-sdk/streaming-vs-single-mode), dove una chiamata `query()` comporta più turni dell'utente e ogni turno emette il proprio messaggio `result`.38* **Chiamata `query()`:** una singola invocazione della funzione `query()` dell'SDK. Una singola chiamata può coinvolgere più fasi: Claude risponde, utilizza strumenti, ottiene risultati e risponde di nuovo. Ogni chiamata produce un messaggio [`result`](/docs/it/agent-sdk/typescript#sdkresultmessage) alla fine, tranne in [modalità input streaming](/docs/it/agent-sdk/streaming-vs-single-mode), dove una chiamata `query()` comporta più turni dell'utente e ogni turno emette il proprio messaggio `result`.

39* **Fase:** un singolo ciclo richiesta/risposta all'interno di una chiamata `query()`. Ogni fase produce messaggi dell'assistente con utilizzo dei token.39* **Fase:** un singolo ciclo richiesta/risposta all'interno di una chiamata `query()`. Ogni fase produce messaggi dell'assistente con utilizzo dei token.

40* **Sessione:** una serie di chiamate `query()` collegate da un ID di sessione (utilizzando l'opzione `resume`). Ogni chiamata `query()` all'interno di una sessione segnala il proprio costo in modo indipendente.40* **Sessione:** una serie di chiamate `query()` collegate da un ID di sessione tramite l'opzione `resume`. I risultati di una chiamata ripresa segnalano la spesa totale della sessione, non solo quella della chiamata stessa. Vedere [Accumulare i costi su più chiamate](#accumulate-costs-across-multiple-calls) per come i totali si trasferiscono.

41 41

42Il diagramma seguente mostra il flusso di messaggi da una singola chiamata `query()`, con l'utilizzo dei token segnalato ad ogni fase e la stima cumulativa alla fine:42Il diagramma seguente mostra il flusso di messaggi da una singola chiamata `query()`, con l'utilizzo dei token segnalato ad ogni fase e la stima cumulativa alla fine:

43 43

51 </Step>51 </Step>

52 52

53 <Step title="Il messaggio risultato fornisce la stima cumulativa">53 <Step title="Il messaggio risultato fornisce la stima cumulativa">

54 Quando la chiamata `query()` si completa, l'SDK emette un messaggio risultato con `total_cost_usd` e `usage` cumulativo, tipizzato come [`SDKResultMessage`](/docs/it/agent-sdk/typescript#sdkresultmessage) in TypeScript e [`ResultMessage`](/docs/it/agent-sdk/python#resultmessage) in Python. Se si effettuano più chiamate `query()`, ad esempio in una sessione multi-turno, ogni risultato riflette solo il costo di quella singola chiamata. Se è necessario solo il totale stimato, è possibile ignorare l'utilizzo per fase e leggere questo singolo valore.54 Quando la chiamata `query()` si completa, l'SDK emette un messaggio risultato con `total_cost_usd` e `usage` cumulativo, tipizzato come [`SDKResultMessage`](/docs/it/agent-sdk/typescript#sdkresultmessage) in TypeScript e [`ResultMessage`](/docs/it/agent-sdk/python#resultmessage) in Python. Se è necessario solo il totale stimato, è possibile ignorare l'utilizzo per fase e leggere questo singolo valore.

56 Se si effettuano più chiamate `query()` indipendenti, ogni risultato riflette solo il costo di quella singola chiamata. Una chiamata che riprende una sessione conta anche la spesa precedente della sessione.

55 57

56 In modalità input streaming, ogni turno emette il proprio messaggio risultato. Vedere [Tracciare i costi in modalità input streaming](#track-costs-in-streaming-input-mode) per come leggere i totali delle chiamate in quella modalità.58 In modalità input streaming, ogni turno emette il proprio messaggio risultato. Vedere [Tracciare i costi in modalità input streaming](#track-costs-in-streaming-input-mode) per come leggere i totali delle chiamate in quella modalità.

57 </Step>59 </Step>

64In [modalità di input in streaming](/docs/it/agent-sdk/streaming-vs-single-mode), una singola chiamata `query()` contiene più turni utente e ogni turno emette il proprio messaggio di risultato. I campi del risultato differiscono in ambito:66In [modalità di input in streaming](/docs/it/agent-sdk/streaming-vs-single-mode), una singola chiamata `query()` contiene più turni utente e ogni turno emette il proprio messaggio di risultato. I campi del risultato differiscono in ambito:

65 67

66* **`usage`**: copre solo quel turno, e all'interno di esso solo il ciclo principale dell'agente, non eventuali subagenti che ha eseguito.68* **`usage`**: copre solo quel turno, e all'interno di esso solo il ciclo principale dell'agente, non eventuali subagenti che ha eseguito.

~~67* **`total_cost_usd` e `modelUsage`, o `model_usage` in Python**: portano il totale cumulativo per l'intera chiamata fino a quel momento.~~69* **`total_cost_usd` e `modelUsage`, o `model_usage` in Python**: portano il totale cumulativo per l'intera chiamata fino a quel momento, più qualsiasi spesa ripristinata quando la chiamata ha ripreso una sessione.

68 70

69In una chiamata in cui la vostra app non invia mai `/clear`, `/reset`, o `/new`, leggete il risultato più recente per i totali della chiamata piuttosto che sommare i risultati.71In una chiamata in cui la vostra app non invia mai `/clear`, `/reset`, o `/new`, leggete il risultato più recente per i totali della chiamata piuttosto che sommare i risultati.

70 72

78 80

79In TypeScript, l'SDK emette anche un [`SDKConversationResetMessage`](/docs/it/agent-sdk/typescript#sdkconversationresetmessage) ad ogni ripristino, quindi potete rilevare i ripristini dal flusso. In Python, l'SDK emette analogamente un `ConversationResetMessage`. Prima della versione Python SDK v0.2.137, l'iteratore Python ha eliminato quel messaggio, quindi su quelle versioni contate i ripristini voi stessi dai turni `/clear` che la vostra app invia.81In TypeScript, l'SDK emette anche un [`SDKConversationResetMessage`](/docs/it/agent-sdk/typescript#sdkconversationresetmessage) ad ogni ripristino, quindi potete rilevare i ripristini dal flusso. In Python, l'SDK emette analogamente un `ConversationResetMessage`. Prima della versione Python SDK v0.2.137, l'iteratore Python ha eliminato quel messaggio, quindi su quelle versioni contate i ripristini voi stessi dai turni `/clear` che la vostra app invia.

80 82

~~81`maxBudgetUsd` (TypeScript) o `max_budget_usd` (Python) viene confrontato con lo stesso totale cumulativo, quindi un `/clear` avvia anche il budget da capo.~~83`maxBudgetUsd` (TypeScript) o `max_budget_usd` (Python) conta solo la spesa della chiamata stessa: i totali ripristinati da una sessione ripresa non contano rispetto ad esso, e un `/clear` avvia il budget da capo.

82 84

83<h2 id="get-the-total-cost-of-a-query">85<h2 id="get-the-total-cost-of-a-query">

84 Ottenere il costo totale di una query86 Ottenere il costo totale di una query

85</h2>87</h2>

86 88

87Il messaggio di risultato, tipizzato come [`SDKResultMessage`](/docs/it/agent-sdk/typescript#sdkresultmessage) in TypeScript e [`ResultMessage`](/docs/it/agent-sdk/python#resultmessage) in Python, segna la fine del ciclo dell'agente per una chiamata `query()`. Include `total_cost_usd`, il costo stimato cumulativo su tutti i passaggi in quella chiamata. In Python il campo è tipizzato come opzionale, quindi verificate che non sia `None` prima di leggerlo. I risultati di successo e di errore lo portano entrambi, anche se il risultato finale di un [crash della sessione](#recover-totals-after-a-session-crash) potrebbe portarlo azzerato.89Il messaggio di risultato, tipizzato come [`SDKResultMessage`](/docs/it/agent-sdk/typescript#sdkresultmessage) in TypeScript e [`ResultMessage`](/docs/it/agent-sdk/python#resultmessage) in Python, segna la fine del ciclo dell'agente per una chiamata `query()`. Include `total_cost_usd`, il costo stimato cumulativo su tutti i passaggi in quella chiamata. Una chiamata che riprende una sessione conta anche la spesa precedente della sessione. Due avvertenze si applicano quando leggete il valore:

91* In Python il campo è tipizzato come opzionale, quindi verificate che non sia `None` prima di leggerlo.

92* I risultati di successo e di errore lo portano entrambi, anche se il risultato finale di un [crash della sessione](#recover-totals-after-a-session-crash) potrebbe portarlo azzerato.

88 93

89Se utilizzate sessioni per effettuare più chiamate `query()`, ogni risultato riflette solo il costo di quella singola chiamata. In modalità di input in streaming, leggete i totali delle chiamate come descritto in [Track costs in streaming input mode](#track-costs-in-streaming-input-mode).94In modalità di input in streaming, leggete i totali delle chiamate come descritto in [Track costs in streaming input mode](#track-costs-in-streaming-input-mode).

90 95

91I tre campi a livello di risultato differiscono in ciò che contano quando l'agente genera [subagenti](/docs/it/agent-sdk/subagents). Utilizzate `modelUsage`, o `model_usage` in Python, per la contabilità dei token dell'intero albero; il campo `usage` sottoconta non appena si verifica l'annidamento.96I tre campi a livello di risultato differiscono in ciò che contano quando l'agente genera [subagenti](/docs/it/agent-sdk/subagents). Utilizzate `modelUsage`, o `model_usage` in Python, per la contabilità dei token dell'intero albero; il campo `usage` sottoconta non appena si verifica l'annidamento.

92 97

232 Accumulare i costi su più chiamate237 Accumulare i costi su più chiamate

233</h2>238</h2>

234 239

235Ogni chiamata `query()` restituisce il suo `total_cost_usd`. L'SDK non fornisce un totale a livello di sessione, quindi se la vostra applicazione effettua più chiamate `query()`, ad esempio in una sessione multi-turno o tra diversi utenti, accumulate i totali voi stessi. In modalità input streaming, leggete il totale di ogni chiamata come descritto in [Track costs in streaming input mode](#track-costs-in-streaming-input-mode). Per una chiamata che si è conclusa con un crash, vedere [Recover totals after a session crash](#recover-totals-after-a-session-crash).240Ogni chiamata `query()` restituisce `total_cost_usd` sui suoi risultati. Come combinare i valori dipende dal fatto che le chiamate condividano una sessione:

241

242* **Chiamate indipendenti, senza opzione `resume` o `continue`**: ogni risultato copre solo la propria chiamata, quindi aggiungete i totali voi stessi, come fanno gli esempi seguenti.

243* **Chiamate che riprendono la stessa sessione**: Claude Code salva i totali della sessione nel suo [transcript](/docs/it/sessions#where-transcripts-are-stored) quando il processo esce normalmente e li ripristina quando una chiamata successiva riprende o effettua il fork della sessione. Ogni risultato include già la spesa precedente della sessione. Leggete l'ultimo risultato per il totale della sessione; sommare i risultati conta due volte la spesa ripristinata. Prima della v2.1.277, una sessione che avevate ripreso tramite l'SDK o `claude -p` iniziava i suoi totali a zero, quindi i risultati di ogni chiamata coprivano solo quella chiamata.

244

245In modalità input streaming, leggete il totale di ogni chiamata come descritto in [Track costs in streaming input mode](#track-costs-in-streaming-input-mode). Per una chiamata che si è conclusa con un crash, vedere [Recover totals after a session crash](#recover-totals-after-a-session-crash).

236 246

237I seguenti esempi eseguono due chiamate `query()` in sequenza, aggiungono il `total_cost_usd` di ogni chiamata a un totale progressivo e stampano sia il costo per singola chiamata che il costo combinato:247I seguenti esempi eseguono due chiamate `query()` in sequenza, aggiungono il `total_cost_usd` di ogni chiamata a un totale progressivo e stampano sia il costo per singola chiamata che il costo combinato:

238 248

338 348

339Quando il processo Claude Code si arresta in modo anomalo, emette un risultato `error_during_execution` finale e esce, sia in modalità input single-shot che in streaming. Quel risultato può portare `usage`, `total_cost_usd` e `modelUsage` azzerati, quindi recuperare i totali della chiamata da ciò che è arrivato prima. Il passaggio 1 recupera i totali completi ogni volta che esiste un risultato precedente; il fallback nel passaggio 2 recupera solo i token di input e cache del ciclo principale.349Quando il processo Claude Code si arresta in modo anomalo, emette un risultato `error_during_execution` finale e esce, sia in modalità input single-shot che in streaming. Quel risultato può portare `usage`, `total_cost_usd` e `modelUsage` azzerati, quindi recuperare i totali della chiamata da ciò che è arrivato prima. Il passaggio 1 recupera i totali completi ogni volta che esiste un risultato precedente; il fallback nel passaggio 2 recupera solo i token di input e cache del ciclo principale.

340 350

3411. Utilizzare il risultato del turno prima dell'arresto anomalo. In modalità input streaming, contiene il totale in esecuzione dall'inizio della chiamata o dall'ultimo [`/clear`](#track-costs-in-streaming-input-mode). Passare al passaggio 2 invece quando quel risultato non può aiutarti:3511. Utilizzare il risultato del turno prima dell'arresto anomalo. In modalità input streaming, contiene il totale in esecuzione descritto in [Track costs in streaming input mode](#track-costs-in-streaming-input-mode). Passare al passaggio 2 invece quando quel risultato non può aiutarti:

342 * La chiamata era single-shot, quindi non esiste alcun risultato precedente.352 * La chiamata era single-shot, quindi non esiste alcun risultato precedente.

343 * L'arresto anomalo è avvenuto al primo turno.353 * L'arresto anomalo è avvenuto al primo turno.

344 * Il turno prima dell'arresto anomalo era il `/clear` stesso, quindi il suo risultato copre solo il ripristino.354 * Il turno prima dell'arresto anomalo era il `/clear` stesso, quindi il suo risultato copre solo il ripristino.

agent-sdk/hosting.md +1 −1

Details

10 10

11Questa pagina copre l'auto-hosting sulla tua infrastruttura. Per Dockerfile distribuibili e manifesti Kubernetes, consulta il [hosting cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting).11Questa pagina copre l'auto-hosting sulla tua infrastruttura. Per Dockerfile distribuibili e manifesti Kubernetes, consulta il [hosting cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting).

12 12

13Se non hai bisogno di controllo dell'infrastruttura, isolamento personalizzato o del tuo piano dati, considera invece gli [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview): un'API REST ospitata dove Anthropic esegue l'agente e la sandbox, quindi la tua applicazione invia eventi e riceve i risultati in streaming senza infrastruttura di hosting da gestire.13Se non hai bisogno di eseguire il ciclo dell'agente sulla tua infrastruttura, considera invece gli [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview). Anthropic ospita il ciclo dell'agente e la tua applicazione invia eventi e riceve risultati in streaming attraverso gli SDK client o l'API REST. L'esecuzione degli strumenti viene eseguita in una sandbox cloud gestita da Anthropic o in una [sandbox auto-ospitata](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) sulla tua infrastruttura.

14 14

15<h2 id="the-subprocess-model">15<h2 id="the-subprocess-model">

16 Il modello subprocess16 Il modello subprocess

agent-sdk/modifying-system-prompts.md +4 −0

Details

387* Se includete il marcatore più di una volta, il primo è la divisione e l'SDK rimuove gli altri.387* Se includete il marcatore più di una volta, il primo è la divisione e l'SDK rimuove gli altri.

388* Se lasciate fuori il marcatore, l'SDK unisce tutte le stringhe in un blocco, lo stesso che passare una stringa.388* Se lasciate fuori il marcatore, l'SDK unisce tutte le stringhe in un blocco, lo stesso che passare una stringa.

389 389

390Con i flag [`--system-prompt` o `--system-prompt-file`](/docs/it/cli-reference#system-prompt-flags) della CLI, il prompt è una stringa, quindi non c'è un array per portare il marcatore. Includete una riga contenente solo `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` tra le parti statiche e per richiesta. Claude Code divide il prompt alla prima riga di questo tipo nei due blocchi e rimuove quella riga. Richiede Claude Code v2.1.275 o successivo.

391

392Nell'SDK, preferite la forma array, che porta il confine senza una riga marcatore.

393

390<h3 id="change-the-prompt-of-an-existing-session">394<h3 id="change-the-prompt-of-an-existing-session">

391 Cambiare il prompt di una sessione esistente395 Cambiare il prompt di una sessione esistente

392</h3>396</h3>

agent-sdk/overview.md +8 −8

Details

12 Confronta l'Agent SDK con altri strumenti Claude12 Confronta l'Agent SDK con altri strumenti Claude

13</h2>13</h2>

14 14

~~15L'Agent SDK, la CLI, il Client SDK e gli Managed Agents si adattano a esigenze diverse. Utilizza la tabella per trovare quello che corrisponde a ciò che stai costruendo.~~15L'Agent SDK, la CLI, il Client SDK e gli Managed Agents differiscono per chi esegue l'agente, cosa è incluso di default e come lo raggiungi. Trova la riga che corrisponde a come desideri costruire ed eseguire il tuo.

16 16

17| Se stai... | Usa | Perché |17| Desideri | Usa | Cosa ottieni |

18| ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |18| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

19| Costruendo un agente senza implementare il tool loop da solo | **Agent SDK** | Una libreria che esegue il ciclo dell'agente nel tuo processo, in Python o TypeScript. |19| Incorporare l'agente di Claude Code nella tua applicazione Python o TypeScript, in un processo che gestisci | **Agent SDK** | Una libreria che esegue il binario di Claude Code, con le [capacità](#capabilities) di Claude Code, come strumenti integrati, permessi, sessioni e hooks. |

20| Facendo sviluppo interattivo o eseguendo attività una tantum da un terminale | [**Claude Code CLI**](/docs/it/overview) | L'interfaccia del terminale, costruita per l'uso interattivo quotidiano. |20| Fare sviluppo interattivo o eseguire attività una tantum da un terminale | [**Claude Code CLI**](/docs/it/overview) | L'interfaccia del terminale, costruita per l'uso interattivo quotidiano. |

21| Chiamando l'API direttamente e implementando il tool loop da solo | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Accesso diretto all'API Anthropic piuttosto che a Claude Code. Implementi il tool loop da solo. |21| Chiamare l'API Claude direttamente dal tuo codice | [**Client SDK**](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) | Accesso diretto all'API Claude da uno qualsiasi dei linguaggi del client SDK. Scrivi il tool loop da solo, oppure lascia che il [tool runner](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner) beta del client SDK lo gestisca. |

22| Eseguendo agenti a lunga durata o asincroni senza gestire la tua sandbox o infrastruttura di sessione | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | API REST ospitata, un prodotto separato dall'Agent SDK. Anthropic esegue l'agente e la sandbox. |22| Avere Anthropic ospitare l'agente, configurato tramite l'API Claude | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | Un harness agente ospitato che esegue il ciclo dell'agente, con sessioni in una sandbox cloud gestita da Anthropic o una [sandbox auto-ospitata](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) sulla tua infrastruttura. Usalo dall'[SDK per il tuo linguaggio](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk), dalla CLI `ant`, o dall'API REST. |

23 23

24L'SDK è disponibile come libreria solo per Python e TypeScript. Per guidare lo stesso ciclo dell'agente da un altro linguaggio, [esegui la CLI come sottoprocesso](/docs/it/headless) con il flag `-p` e `--output-format json`.24Per guidare lo stesso ciclo dell'agente da un linguaggio diverso da Python o TypeScript, [esegui la CLI come sottoprocesso](/docs/it/headless) con il flag `-p` e `--output-format json`.

25 25

26<h2 id="capabilities">26<h2 id="capabilities">

27 Capacità27 Capacità

agent-sdk/python.md +12 −30

Details

906| `session_id` | `str \| None` | `None` | Usa un ID di sessione specifico invece di uno generato automaticamente. Deve essere un UUID valido. Non può essere combinato con `continue_conversation` o `resume` a meno che `fork_session` non sia anche impostato |906| `session_id` | `str \| None` | `None` | Usa un ID di sessione specifico invece di uno generato automaticamente. Deve essere un UUID valido. Non può essere combinato con `continue_conversation` o `resume` a meno che `fork_session` non sia anche impostato |

908| `max_budget_usd` | `float \| None` | `None` | Interrompi la query quando la stima del costo lato client raggiunge questo valore in USD. Confrontato con la stessa stima di `total_cost_usd`. Per le avvertenze di accuratezza e il comportamento di ripristino, vedi [Traccia costo e utilizzo](/docs/it/agent-sdk/cost-tracking) |908| `max_budget_usd` | `float \| None` | `None` | Interrompi la query quando la stima del costo lato client raggiunge questo valore in USD. Conta solo la spesa della chiamata stessa; i totali ripristinati da una sessione ripresa non contano. Per le avvertenze di accuratezza e il comportamento di ripristino, vedi [Traccia costo e utilizzo](/docs/it/agent-sdk/cost-tracking) |

909| `disallowed_tools` | `list[str]` | `[]` | Strumenti da negare. Un nome semplice come `"Bash"` rimuove lo strumento dal contesto di Claude. Una regola con ambito come `"Bash(rm *)"` lascia lo strumento disponibile e nega le chiamate corrispondenti in ogni modalità di autorizzazione, incluso `bypassPermissions`, per il comando [come scritto](/docs/it/permissions#bash-rule-limits). Vedi [Autorizzazioni](/docs/it/agent-sdk/permissions#allow-and-deny-rules) |909| `disallowed_tools` | `list[str]` | `[]` | Strumenti da negare. Un nome semplice come `"Bash"` rimuove lo strumento dal contesto di Claude. Una regola con ambito come `"Bash(rm *)"` lascia lo strumento disponibile e nega le chiamate corrispondenti in ogni modalità di autorizzazione, incluso `bypassPermissions`, per il comando [come scritto](/docs/it/permissions#bash-rule-limits). Vedi [Autorizzazioni](/docs/it/agent-sdk/permissions#allow-and-deny-rules) |

1487Usa con il campo `betas` in `ClaudeAgentOptions` per abilitare le funzionalità beta.1487Usa con il campo `betas` in `ClaudeAgentOptions` per abilitare le funzionalità beta.

1488 1488

1489<Warning>1489<Warning>

1490 La beta `context-1m-2025-08-07` è ritirata a partire dal 30 aprile 2026. Passare questo header con Claude Sonnet 4.5 o Sonnet 4 non ha effetto, e le richieste che superano la finestra di contesto standard di 200k token restituiscono un errore. Per utilizzare una finestra di contesto di 1M token, esegui la migrazione a [Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7, o Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), che includono 1M di contesto a prezzi standard senza header beta richiesto.1490 La beta `context-1m-2025-08-07` è ritirata a partire dal 30 aprile 2026. Passare questo header con Claude Sonnet 4.5 o Sonnet 4 non ha effetto, e le richieste che superano la finestra di contesto standard di 200k token restituiscono un errore. Per utilizzare una finestra di contesto di 1M token, esegui la migrazione a [Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7, o Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), che includono 1M di contesto a prezzi standard senza header beta richiesto.

1491</Warning>1491</Warning>

1492 1492

1493<h3 id="mcpsdkserverconfig">1493<h3 id="mcpsdkserverconfig">

1799 1799

1800Il dict `model_usage` mappa i nomi dei modelli all'utilizzo per modello. Copre ogni chiamata di modello effettuata attraverso la pipeline di query: il ciclo principale, i subagenti e le chiamate interne come la compattazione e gli agenti Workflow. Le chiamate helper al di fuori di quella pipeline, come il classificatore di permessi e le richieste di conteggio dei token, sono escluse da `model_usage`. Tratta `model_usage` come una stima, non come un estratto conto di fatturazione.1800Il dict `model_usage` mappa i nomi dei modelli all'utilizzo per modello. Copre ogni chiamata di modello effettuata attraverso la pipeline di query: il ciclo principale, i subagenti e le chiamate interne come la compattazione e gli agenti Workflow. Le chiamate helper al di fuori di quella pipeline, come il classificatore di permessi e le richieste di conteggio dei token, sono escluse da `model_usage`. Tratta `model_usage` come una stima, non come un estratto conto di fatturazione.

1801 1801

1802In [modalità input streaming](/docs/it/agent-sdk/streaming-vs-single-mode), `model_usage` e `total_cost_usd` sono cumulativi tra i turni, quindi leggi il risultato più recente piuttosto che sommare tra i risultati. Vedi [Traccia i costi in modalità input streaming](/docs/it/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) per i ripristini e [Recupera i totali dopo un crash della sessione](/docs/it/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) per i risultati azzerati.1802In [modalità input streaming](/docs/it/agent-sdk/streaming-vs-single-mode), `model_usage` e `total_cost_usd` sono cumulativi tra i turni, quindi leggi il risultato più recente piuttosto che sommare tra i risultati. Una chiamata che riprende una sessione conta anche i [totali ripristinati dalle chiamate precedenti della sessione](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Vedi [Traccia i costi in modalità input streaming](/docs/it/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) per i ripristini e [Recupera i totali dopo un crash della sessione](/docs/it/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) per i risultati azzerati.

1803 1803

1804Ogni valore in `model_usage` è un TypedDict `ModelUsage`, importato tramite `from claude_agent_sdk.types import ModelUsage`. Le sue chiavi usano camelCase perché l'SDK passa il valore attraverso senza modifiche dal processo CLI sottostante, corrispondendo al tipo TypeScript [`ModelUsage`](/docs/it/agent-sdk/typescript#modelusage):1804Ogni valore in `model_usage` è un TypedDict `ModelUsage`, importato tramite `from claude_agent_sdk.types import ModelUsage`. Le sue chiavi usano camelCase perché l'SDK passa il valore attraverso senza modifiche dal processo CLI sottostante, corrispondendo al tipo TypeScript [`ModelUsage`](/docs/it/agent-sdk/typescript#modelusage):

1805 1805

2923 "command": str | None, # Script shell; ogni riga stdout è un evento, exit termina il monitoraggio2923 "command": str | None, # Script shell; ogni riga stdout è un evento, exit termina il monitoraggio

2924 "ws": dict | None, # Origine WebSocket: {"url": str, "protocols": list[str] | None}; ogni frame di testo è un evento2924 "ws": dict | None, # Origine WebSocket: {"url": str, "protocols": list[str] | None}; ogni frame di testo è un evento

2925 "description": str, # Breve descrizione mostrata nelle notifiche2925 "description": str, # Breve descrizione mostrata nelle notifiche

2926 "timeout_ms": int | None, # Termina dopo questa scadenza (default 300000, max 3600000)2926 "timeout_ms": int | None, # Scadenza in millisecondi (default 300000, max 3600000; la scadenza effettiva è al massimo 1800000)

2927 "persistent": bool | None, # Esegui per la durata della sessione; ferma con TaskStop

2928}2927}

2929```2928```

2930 2929

2933```python theme={null}2932```python theme={null}

2934{2933{

2935 "taskId": str, # ID dell'attività di monitoraggio in background2934 "taskId": str, # ID dell'attività di monitoraggio in background

2936 "timeoutMs": int, # Scadenza del timeout in millisecondi (0 quando persistente)2935 "timeoutMs": int, # La scadenza effettiva del monitoraggio in millisecondi

2937 "persistent": bool | None, # True quando in esecuzione fino a TaskStop o fine sessione2936 "persistent": bool | None, # False: ogni monitoraggio ha una scadenza

2938}2937}

2939```2938```

2940 2939

3350 TaskOutput3349 TaskOutput

3351</h3>3350</h3>

3352 3351

3353**Nome dello strumento:** `TaskOutput`. Il nome precedente `BashOutput` è ancora accettato come alias.3352Rimosso in Claude Code v2.1.277. In precedenza recuperava l'output da un'attività in background o completata in esecuzione, con `BashOutput` accettato come alias; Claude legge il file di output di un'attività in background con `Read` invece.

3354 3353

3355<Note>`TaskOutput` è deprecato; preferisci `Read` sul percorso del file di output del compito. Gli schemi sottostanti rimangono validi per hook e gestori di autorizzazione che incontrano lo strumento.</Note>3354Una voce `disallowed_tools` o una regola di negazione che ancora nomina uno dei due nomi viene ignorata senza un avviso.

~~3356~~

3357**Input:**

~~3358~~

3359```python theme={null}

3360{

3361 "task_id": str, # L'ID del compito da cui ottenere l'output

3362 "block": bool, # Se attendere il completamento (default True)

3363 "timeout": int, # Tempo di attesa massimo in ms (default 30000)

3364}

3365```

~~3366~~

3367**Output:**

~~3368~~

3369```python theme={null}

3370{

3371 "retrieval_status": "success" | "timeout" | "not_ready", # Se l'output è stato recuperato

3372 "task": dict | None, # Dettagli del compito: task_id, task_type, status, description, output, più campi specifici del tipo come exitCode

3373}

3374```

3375 3355

3376<h3 id="taskstop">3356<h3 id="taskstop">

3377 TaskStop3357 TaskStop

3632| :-------------------------- | :---------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |3612| :-------------------------- | :---------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

3635| `excludedCommands` | `list[str]` | `[]` | Comandi che sempre bypassano le restrizioni della sandbox (ad es. `["docker"]`). Questi vengono eseguiti senza sandbox automaticamente senza coinvolgimento del modello |3615| `excludedCommands` | `list[str]` | `[]` | Comandi che bypassano le restrizioni della sandbox, come `["docker *"]`. Questi vengono eseguiti senza sandbox automaticamente senza coinvolgimento del modello; [`sandbox.excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) copre quando una voce si applica |

3636| `allowUnsandboxedCommands` | `bool` | `True` | Consenti al modello di richiedere l'esecuzione di comandi al di fuori della sandbox. Quando `True`, il modello può impostare `dangerouslyDisableSandbox` nell'input dello strumento, che ricade nel [sistema di autorizzazioni](#permissions-fallback-for-unsandboxed-commands) |3616| `allowUnsandboxedCommands` | `bool` | `True` | Consenti al modello di richiedere l'esecuzione di comandi al di fuori della sandbox. Quando `True`, il modello può impostare `dangerouslyDisableSandbox` nell'input dello strumento, che ricade nel [sistema di autorizzazioni](#permissions-fallback-for-unsandboxed-commands) |

3737 Fallback delle autorizzazioni per i comandi senza sandbox3717 Fallback delle autorizzazioni per i comandi senza sandbox

3738</h3>3718</h3>

3739 3719

3740Quando `allowUnsandboxedCommands` è abilitato, il modello può richiedere di eseguire comandi al di fuori della sandbox impostando `dangerouslyDisableSandbox: True` nell'input dello strumento. Queste richieste ricadono nel sistema di autorizzazioni esistente, il che significa che il tuo handler `can_use_tool` verrà invocato, permettendoti di implementare una logica di autorizzazione personalizzata. I comandi elencati in `excludedCommands` invece bypassano la sandbox automaticamente, senza coinvolgimento del modello; vedi [`SandboxSettings`](#sandboxsettings).3720Quando `allowUnsandboxedCommands` è abilitato, il modello può richiedere di eseguire comandi al di fuori della sandbox impostando `dangerouslyDisableSandbox: True` nell'input dello strumento. Queste richieste ricadono nel sistema di autorizzazioni esistente, il che significa che il tuo handler `can_use_tool` verrà invocato, permettendoti di implementare una logica di autorizzazione personalizzata.

3721

3722Le tue voci `excludedCommands` invece bypassano la sandbox senza coinvolgimento del modello; [`sandbox.excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) copre quando una voce si applica.

3741 3723

3742L'esempio seguente registra ogni richiesta senza sandbox e la nega a meno che la tua logica di autorizzazione non la consenta:3724L'esempio seguente registra ogni richiesta senza sandbox e la nega a meno che la tua logica di autorizzazione non la consenta:

3743 3725

agent-sdk/subagents.md +2 −2

Details

648| :---------- | :------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |648| :---------- | :------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

649| Profondità | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/it/env-vars) | `3` livelli di subagent sotto l'agente principale. `1` impedisce ai subagent di generare altri subagent | Lascia un subagent al livello inferiore incapace di generare, quindi esegue il lavoro delegato da solo. Vedere [subagent annidati](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) |649| Profondità | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/it/env-vars) | `3` livelli di subagent sotto l'agente principale. `1` impedisce ai subagent di generare altri subagent | Lascia un subagent al livello inferiore incapace di generare, quindi esegue il lavoro delegato da solo. Vedere [subagent annidati](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) |

650| Concorrenza | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/it/env-vars) | `20` subagent in esecuzione contemporaneamente, contando ogni subagent che Claude genera con lo strumento Agent | Rifiuta di generare un altro subagent, restituendo `Concurrent subagent limit reached`, finché il conteggio in esecuzione non scende al di sotto del limite. Le sessioni con [ultracode](/docs/it/model-config#adjust-effort-level) attivo non vengono mai rifiutate. Vedere il [limite di subagent concorrenti](/docs/it/sub-agents#concurrent-subagent-limit) |650| Concorrenza | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/it/env-vars) | `20` subagent in esecuzione contemporaneamente, contando ogni subagent che Claude genera con lo strumento Agent | Rifiuta di generare un altro subagent, restituendo `Concurrent subagent limit reached`, finché il conteggio in esecuzione non scende al di sotto del limite. Le sessioni con [ultracode](/docs/it/model-config#adjust-effort-level) attivo non vengono mai rifiutate. Vedere il [limite di subagent concorrenti](/docs/it/sub-agents#concurrent-subagent-limit) |

651| Spesa | `maxBudgetUsd` in TypeScript, `max_budget_usd` in Python | Nessun limite. Confrontato con `total_cost_usd`, quindi le richieste dei subagent contano | Applica il limite in tre modi: rifiuta di generare più subagent, restituendo `Budget limit reached`, arresta i subagent in background ancora in esecuzione e termina la query con il sottotipo di risultato `error_max_budget_usd`. Per il comportamento dei limiti in una sessione, vedere [turni e budget](/docs/it/agent-sdk/agent-loop#turns-and-budget) |651| Spesa | `maxBudgetUsd` in TypeScript, `max_budget_usd` in Python | Nessun limite. Conta la spesa della chiamata, incluse le richieste dei subagent | Applica il limite in tre modi: rifiuta di generare più subagent, restituendo `Budget limit reached`, arresta i subagent in background ancora in esecuzione e termina la query con il sottotipo di risultato `error_max_budget_usd`. Per il comportamento dei limiti in una sessione, vedere [turni e budget](/docs/it/agent-sdk/agent-loop#turns-and-budget) |

652 652

653I due SDK trattano l'opzione `env` diversamente: TypeScript SDK sostituisce l'ambiente del sottoprocesso con esso, quindi diffondere `process.env` in esso per mantenere variabili come `PATH`, mentre Python SDK lo unisce all'ambiente ereditato. Questo esempio disattiva l'annidamento, consente al massimo cinque subagent alla volta e arresta la query una volta che la spesa stimata raggiunge \$5:653I due SDK trattano l'opzione `env` diversamente: TypeScript SDK sostituisce l'ambiente del sottoprocesso con esso, quindi diffondere `process.env` in esso per mantenere variabili come `PATH`, mentre Python SDK lo unisce all'ambiente ereditato. Questo esempio disattiva l'annidamento, consente al massimo cinque subagent alla volta e arresta la query una volta che la spesa stimata raggiunge \$5:

654 654

747 747

748Se Claude completa i compiti direttamente invece di delegare al tuo subagente:748Se Claude completa i compiti direttamente invece di delegare al tuo subagente:

749 749

750* **Usa prompt espliciti**: menziona il subagente per nome nel tuo prompt, ad esempio "Usa l'agente code-reviewer per..."750* **Usa prompt espliciti**: menziona il subagente per nome nel tuo prompt, ad esempio "Usa l'agente code-reviewer per controllare il modulo di autenticazione"

751* **Scrivi una descrizione chiara**: spiega esattamente quando utilizzare il subagente in modo che Claude possa abbinare i compiti in modo appropriato751* **Scrivi una descrizione chiara**: spiega esattamente quando utilizzare il subagente in modo che Claude possa abbinare i compiti in modo appropriato

752 752

753<h3 id="filesystem-based-agents-not-loading">753<h3 id="filesystem-based-agents-not-loading">

agent-sdk/typescript.md +123 −83

Details

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

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

314 314

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

504| `extraArgs` | `Record<string, string \| null>` | `{}` | Argomenti aggiuntivi |504| `extraArgs` | `Record<string, string \| null>` | `{}` | Argomenti aggiuntivi |

505| `fallbackModel` | `string` | `undefined` | Modello da utilizzare se il modello primario fallisce. Accetta un elenco separato da virgole. Per l'ordine e il limite, vedi [Fallback model chains](/docs/it/model-config#fallback-model-chains). Per indicazioni, vedi [Scegli un modello](/docs/it/agent-sdk/configuration#choose-a-model) |505| `fallbackModel` | `string` | `undefined` | Modello da utilizzare se il modello primario fallisce. Accetta un elenco separato da virgole. Per l'ordine e il limite, vedi [Fallback model chains](/docs/it/model-config#fallback-model-chains). Per indicazioni, vedi [Scegli un modello](/docs/it/agent-sdk/configuration#choose-a-model) |

507| `forwardSubagentText` | `boolean` | `false` | Inoltra i blocchi di testo e pensiero del subagent come messaggi di assistente e utente con `parent_tool_use_id` impostato, in modo che i consumer possano rendere una trascrizione nidificata. Senza questa opzione, Claude Code emette blocchi `tool_use` e `tool_result` del subagent ma non testo o pensiero. I messaggi dai subagent a ogni profondità di nidificazione vengono inoltrati su Claude Code v2.1.219 e successivi; prima di v2.1.219, solo i messaggi dai subagent di profondità-1 apparivano |507| `forwardSubagentText` | `boolean` | `false` | Inoltra i blocchi di testo e pensiero del subagent come messaggi di assistente e utente con `parent_tool_use_id` impostato, in modo che i consumer possano rendere una trascrizione nidificata. Senza questa opzione, Claude Code emette blocchi `tool_use` e `tool_result` del subagent ma non testo o pensiero. I messaggi dai subagent a ogni profondità di nidificazione vengono inoltrati su Claude Code v2.1.219 e successivi; prima di v2.1.219, solo i messaggi dai subagent di profondità-1 apparivano. I messaggi dei subagent che una skill con fork genera, e delle skill con fork nidificate, richiedono v2.1.275 o successivo |

508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Callback hook per gli eventi |508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Callback hook per gli eventi |

509| `includeHookEvents` | `boolean` | `false` | Includi gli eventi del ciclo di vita hook nel flusso di messaggi come [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage), e [`SDKHookResponseMessage`](#sdkhookresponsemessage). Gli eventi del ciclo di vita per gli hook `SessionStart` e `Setup` sono sempre inclusi e non necessitano di questa opzione. Alcuni eventi hook, come `Notification`, `SessionEnd`, `PreCompact`, e `PostCompact`, non producono mai un `SDKHookStartedMessage`, anche con questa opzione. Per questi eventi, Claude Code emette comunque un `SDKHookProgressMessage` mentre un hook di comando che viene eseguito per più di un secondo produce output, ed emette un `SDKHookResponseMessage` solo quando un hook [che viene eseguito in background](/docs/it/hooks#run-hooks-in-the-background) termina |509| `includeHookEvents` | `boolean` | `false` | Includi gli eventi del ciclo di vita hook nel flusso di messaggi come [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage), e [`SDKHookResponseMessage`](#sdkhookresponsemessage). Gli eventi del ciclo di vita per gli hook `SessionStart` e `Setup` sono sempre inclusi e non necessitano di questa opzione. Alcuni eventi hook, come `Notification`, `SessionEnd`, `PreCompact`, e `PostCompact`, non producono mai un `SDKHookStartedMessage`, anche con questa opzione. Per questi eventi, Claude Code emette comunque un `SDKHookProgressMessage` mentre un hook di comando che viene eseguito per più di un secondo produce output, ed emette un `SDKHookResponseMessage` solo quando un hook [che viene eseguito in background](/docs/it/hooks#run-hooks-in-the-background) termina |

511| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout in millisecondi per ogni chiamata `sessionStore.load()` e `sessionStore.listSubkeys()` durante la materializzazione del resume. Se l'adapter non si stabilizza entro questa finestra, la query fallisce invece di bloccarsi. Ignorato quando `sessionStore` non è impostato |511| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout in millisecondi per ogni chiamata `sessionStore.load()` e `sessionStore.listSubkeys()` durante la materializzazione del resume. Se l'adapter non si stabilizza entro questa finestra, la query fallisce invece di bloccarsi. Ignorato quando `sessionStore` non è impostato |

512| `managedSettings` | `Settings` | `undefined` | Impostazioni a livello di policy che il tuo processo host fornisce alla sessione generata. Su macchine con impostazioni gestite distribuite dall'amministratore, Claude Code ignora queste a meno che la fonte gestita di priorità più alta dell'amministratore non imposti `parentSettingsBehavior: 'merge'`, e non le unisce mai mentre un [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite. I valori uniti passano attraverso un filtro solo restrittivo; [Limita le impostazioni padre](/docs/it/claude-apps-gateway#restrict-parent-settings) copre ciò che il filtro ammette e i blocchi `allowManaged*Only`. Un host che imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars) ha tre chiavi lette direttamente da questo payload: la sua [configurazione del modello](/docs/it/model-config#restrict-model-selection) su Claude Code v2.1.222 o successivo, [`modelPricing`](/docs/it/settings-reference#modelpricing) quando nessuna fonte gestita lo imposta su v2.1.246 o successivo, e la sua voce `ENABLE_TOOL_SEARCH` env su v2.1.247 o successivo |512| `managedSettings` | `Settings` | `undefined` | Impostazioni a livello di policy che il tuo processo host fornisce alla sessione generata. Su macchine con impostazioni gestite distribuite dall'amministratore, Claude Code ignora queste a meno che la fonte gestita di priorità più alta dell'amministratore non imposti `parentSettingsBehavior: 'merge'`, e non le unisce mai mentre un [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite. I valori uniti passano attraverso un filtro solo restrittivo; [Limita le impostazioni padre](/docs/it/claude-apps-gateway#restrict-parent-settings) copre ciò che il filtro ammette e i blocchi `allowManaged*Only`. Un host che imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars) ha tre chiavi lette direttamente da questo payload: la sua [configurazione del modello](/docs/it/model-config#restrict-model-selection) su Claude Code v2.1.222 o successivo, [`modelPricing`](/docs/it/settings-reference#modelpricing) quando nessuna fonte gestita lo imposta su v2.1.246 o successivo, e la sua voce `ENABLE_TOOL_SEARCH` env su v2.1.247 o successivo |

513| `maxBudgetUsd` | `number` | `undefined` | Interrompi la query quando la stima del costo lato client raggiunge questo valore in USD. Confrontato con la stessa stima di `total_cost_usd`. Per le avvertenze di accuratezza e il comportamento di reset, vedi [Traccia costo e utilizzo](/docs/it/agent-sdk/cost-tracking) |513| `maxBudgetUsd` | `number` | `undefined` | Interrompi la query quando la stima del costo lato client raggiunge questo valore in USD. Conta solo la spesa della chiamata stessa; i totali ripristinati da una sessione ripresa non contano. Per le avvertenze di accuratezza e il comportamento di reset, vedi [Traccia costo e utilizzo](/docs/it/agent-sdk/cost-tracking) |

516| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Configurazioni del server MCP |516| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Configurazioni del server MCP |

526| `planModeInstructions` | `string` | `undefined` | Istruzioni di flusso di lavoro personalizzate per la modalità plan. Quando `permissionMode` è `'plan'`, questa stringa sostituisce il corpo del flusso di lavoro della modalità plan predefinito. La CLI lo avvolge comunque con il preambolo di applicazione di sola lettura e il footer del protocollo ExitPlanMode |526| `planModeInstructions` | `string` | `undefined` | Istruzioni di flusso di lavoro personalizzate per la modalità plan. Quando `permissionMode` è `'plan'`, questa stringa sostituisce il corpo del flusso di lavoro della modalità plan predefinito. La CLI lo avvolge comunque con il preambolo di applicazione di sola lettura e il footer del protocollo ExitPlanMode |

528| `projectConfigRoot` | `string` | `undefined` | Percorso assoluto del checkout attendibile di cui `cwd` è un worktree. Claude Code legge le impostazioni del progetto, `.mcp.json`, e i comandi, agenti, skill, flussi di lavoro, routine e stili di output del progetto `.claude/` da questa directory invece che da `cwd`, e imposta `CLAUDE_PROJECT_DIR` su di essa. Gli hook, gli script helper come `apiKeyHelper`, e i server MCP stdio iniziano con questa directory come loro directory di lavoro. I file `CLAUDE.md` e `.claude/rules/` caricano comunque da `cwd`. Richiede Claude Code v2.1.275 o successivo |

528| `promptSuggestions` | `boolean` | `false` | Abilita i suggerimenti di prompt. Dopo un turno, Claude Code emette un messaggio `prompt_suggestion` che trasporta un prompt utente previsto successivo. Claude Code non genera suggerimenti per alcuni turni, come quando il tuo account è vicino o al limite di utilizzo. Vedi [Quando Claude Code salta i suggerimenti](/docs/it/interactive-mode#when-claude-code-skips-suggestions) |529| `promptSuggestions` | `boolean` | `false` | Abilita i suggerimenti di prompt. Dopo un turno, Claude Code emette un messaggio `prompt_suggestion` che trasporta un prompt utente previsto successivo. Claude Code non genera suggerimenti per alcuni turni, come quando il tuo account è vicino o al limite di utilizzo. Vedi [Quando Claude Code salta i suggerimenti](/docs/it/interactive-mode#when-claude-code-skips-suggestions) |

530| `resumeDropsTurn` | `string` | `undefined` | Con `resumeSessionAt`: l'UUID del prompt del turno che il resume di troncamento intende scartare. Claude Code rifiuta il resume quando l'intervallo scartato contiene qualcosa non attribuibile a quel turno, come messaggi in coda assorbiti o notifiche di attività, e nomina il flag `--resume-drops-turn` nel messaggio di rifiuto. Solo l'Agent SDK e i resume in modalità print leggono la coppia. Richiede Claude Code v2.1.223 o successivo |531| `resumeDropsTurn` | `string` | `undefined` | Con `resumeSessionAt`: l'UUID del prompt del turno che il resume di troncamento intende scartare. Claude Code rifiuta il resume quando l'intervallo scartato contiene qualcosa non attribuibile a quel turno, come messaggi in coda assorbiti o notifiche di attività, e nomina il flag `--resume-drops-turn` nel messaggio di rifiuto. Solo l'Agent SDK e i resume in modalità print leggono la coppia. Richiede Claude Code v2.1.223 o successivo |

600 : Settings[K] | null;601 : Settings[K] | null;

601 }): Promise<void>;602 }): Promise<void>;

602 updateSettings(603 updateSettings(

603 source: 'localSettings',604 source: 'localSettings' | 'userSettings',

604 settings: Record<string, unknown>,605 settings: Record<string, unknown>,

605 ): Promise<void>;606 ): Promise<void>;

606 initializationResult(): Promise<SDKControlInitializeResponse>;607 initializationResult(): Promise<SDKControlInitializeResponse>;

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

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

623 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;624 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;

625 readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;

624 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;626 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;

625 stopTask(taskId: string): Promise<void>;627 stopTask(taskId: string): Promise<void>;

626 close(): void;628 close(): void;

639| `setModel()` | Cambia il modello (disponibile solo in modalità di input in streaming). Passare `undefined` o la stringa `"default"` ripristina il [modello predefinito di Claude Code](/docs/it/model-config) |641| `setModel()` | Cambia il modello (disponibile solo in modalità di input in streaming). Passare `undefined` o la stringa `"default"` ripristina il [modello predefinito di Claude Code](/docs/it/model-config) |

640| `setMaxThinkingTokens()` | *Deprecato:* Usa l'opzione `thinking` invece. Cambia i token di pensiero massimi. Passare `null` ripristina il pensiero al predefinito della sessione: un override mid-session viene cancellato, e il pensiero rimane disattivato per le sessioni che lo hanno disabilitato |642| `setMaxThinkingTokens()` | *Deprecato:* Usa l'opzione `thinking` invece. Cambia i token di pensiero massimi. Passare `null` ripristina il pensiero al predefinito della sessione: un override mid-session viene cancellato, e il pensiero rimane disattivato per le sessioni che lo hanno disabilitato |

641| `applyFlagSettings(settings)` | Unisce le impostazioni nel livello flag settings della sessione a runtime (disponibile solo in modalità di input in streaming). Vedi [`applyFlagSettings()`](#applyflagsettings) |643| `applyFlagSettings(settings)` | Unisce le impostazioni nel livello flag settings della sessione a runtime (disponibile solo in modalità di input in streaming). Vedi [`applyFlagSettings()`](#applyflagsettings) |

642| `updateSettings(source, settings)` | Unisce le impostazioni nel file di impostazioni locali del progetto, `.claude/settings.local.json`; hanno effetto sulla richiesta successiva. Accetta solo `source: 'localSettings'` e un set di chiavi consentite, attualmente `outputStyle`, con valori stringa; l'eliminazione di una chiave non è supportata. Rifiuta su trasporti remoti e in sessioni il cui [`settingSources`](#options) esclude `local`. Richiede TypeScript SDK v0.3.257 o successivo, che raggruppa Claude Code v2.1.257 |644| `updateSettings(source, settings)` | Scrive una chiave consentita nel file di impostazioni locali del progetto o nel file di impostazioni utente, in modo che il valore persista per le sessioni successive. Vedi [`updateSettings()`](#updatesettings). Richiede TypeScript SDK v0.3.257 o successivo, che raggruppa Claude Code v2.1.257 |

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

644| `reinitialize()` | Invia di nuovo la richiesta di controllo `initialize` alla CLI in esecuzione e restituisce un risultato fresco invece del risultato memorizzato nella cache della prima connessione. Usalo dopo un gap di trasporto, come il ricollegamento a una sessione dopo una disconnessione, in modo che le richieste di permesso in sospeso raggiungano di nuovo il tuo callback `canUseTool`. Rendi il callback idempotente per ID di richiesta, perché una richiesta la cui risposta è stata persa viene inviata di nuovo. Richiede Claude Code v2.1.195 o successivo |646| `reinitialize()` | Invia di nuovo la richiesta di controllo `initialize` alla CLI in esecuzione e restituisce un risultato fresco invece del risultato memorizzato nella cache della prima connessione. Usalo dopo un gap di trasporto, come il ricollegamento a una sessione dopo una disconnessione, in modo che le richieste di permesso in sospeso raggiungano di nuovo il tuo callback `canUseTool`. Rendi il callback idempotente per ID di richiesta, perché una richiesta la cui risposta è stata persa viene inviata di nuovo. Richiede Claude Code v2.1.195 o successivo |

645| `supportedCommands()` | Restituisce i comandi disponibili. Da Agent SDK v0.3.216 l'elenco riflette i cambiamenti di comando mid-session; vedi [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |647| `supportedCommands()` | Restituisce i comandi disponibili. Da Agent SDK v0.3.216 l'elenco riflette i cambiamenti di comando mid-session; vedi [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |

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

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

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

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

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

655| `setMcpServers(servers)` | Sostituisci dinamicamente l'insieme dei server MCP per questa sessione. Si risolve con un [`McpSetServersResult`](#mcpsetserversresult) che nomina quali server sono stati aggiunti e rimossi, e eventuali errori |657| `setMcpServers(servers)` | Sostituisci dinamicamente l'insieme dei server MCP per questa sessione. Si risolve con un [`McpSetServersResult`](#mcpsetserversresult) che nomina quali server sono stati aggiunti e rimossi, e eventuali errori |

658| `readMcpResource(serverName, uri)` | *Alpha.* Legge una risorsa MCP Apps `ui://` da un server MCP connesso in modo che la tua applicazione possa rendere il widget di uno strumento. Si risolve con un [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Richiede TypeScript Agent SDK v0.3.280 o successivo |

658| `close()` | Chiudi la query e termina il processo sottostante. Termina forzatamente la query e pulisce tutte le risorse |661| `close()` | Chiudi la query e termina il processo sottostante. Termina forzatamente la query e pulisce tutte le risorse |

673 676

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

675 678

676Le chiamate successive uniscono superficialmente le chiavi di livello superiore. Una seconda chiamata con `{ permissions: {...} }` sostituisce l'intero oggetto `permissions` dalla chiamata precedente piuttosto che unirsi profondamente in esso. Per cancellare una chiave dal livello flag, passa `null` per quella chiave. La maggior parte delle chiavi ricade quindi su fonti di precedenza inferiore. Un `model` cancellato si ripristina al [modello predefinito di Claude Code](/docs/it/model-config), anche quando un file di impostazioni imposta `model`. Passare `undefined` non ha effetto perché la serializzazione JSON lo elimina.679Le chiamate successive uniscono superficialmente le chiavi di livello superiore. Una seconda chiamata con `{ permissions: {...} }` sostituisce l'intero oggetto `permissions` dalla chiamata precedente piuttosto che unirsi profondamente in esso.

680

681Per cancellare una chiave che hai impostato con `applyFlagSettings()`, passa `null` per quella chiave. La maggior parte delle chiavi ricade quindi su un valore che l'opzione `settings` di `query()` ha impostato all'avvio, quindi su fonti di precedenza inferiore. Un `model` cancellato si ripristina al [modello predefinito di Claude Code](/docs/it/model-config), anche quando un file di impostazioni imposta `model`. Passare `undefined` non ha effetto perché la serializzazione JSON lo elimina.

682

683Tre chiavi oltre a `model` ripristinano lo stato della sessione invece di ricadere:

684

685* `effortLevel: null` restituisce la sessione al livello di sforzo predefinito del modello, non all'opzione `effort` di `query()` o a un `effortLevel` da un file di impostazioni.

686* `agent: null` esegue il thread principale senza agente, a partire dal turno successivo, piuttosto che ripristinare l'opzione `agent` di `query()` o un `agent` da un file di impostazioni. Se l'agente cancellato aveva applicato il suo modello, la sessione ritorna al modello che ha risolto all'avvio.

687* `ultracode: null` disattiva ultracode, come `false` fa, piuttosto che ripristinare un valore `ultracode` da un file di impostazioni. La sessione mantiene il suo livello di sforzo corrente, quindi passa `effortLevel` nella stessa chiamata per cambiarlo.

677 688

678Disponibile solo in modalità di input in streaming, lo stesso vincolo di `setModel()` e `setPermissionMode()`.689Disponibile solo in modalità di input in streaming, lo stesso vincolo di `setModel()` e `setPermissionMode()`.

679 690

695 `applyFlagSettings()` è solo TypeScript. L'SDK Python non espone un metodo equivalente.706 `applyFlagSettings()` è solo TypeScript. L'SDK Python non espone un metodo equivalente.

696</Note>707</Note>

697 708

709<h4 id="updatesettings">

710 `updateSettings()`

711</h4>

712

713Scrive una chiave consentita in un file di impostazioni su disco, in modo che il valore persista per le sessioni successive che caricano quella fonte. Ogni fonte accetta una chiave, con un valore stringa:

714

715* **`"localSettings"`**: accetta `outputStyle` e lo unisce nel file di impostazioni locali del progetto, `.claude/settings.local.json`. Il nuovo stile ha effetto sulla richiesta successiva della sessione.

716* **`"userSettings"`**: accetta `effortLevel` e lo salva come [livello di sforzo](/docs/it/model-config#adjust-effort-level) predefinito per il modello corrente della sessione, sotto [`modelSettings`](/docs/it/settings-reference#modelsettings) nel file di impostazioni utente. Passare `max` non scrive nulla, perché `max` è solo per sessione. La sessione in esecuzione mantiene il suo livello di sforzo corrente comunque, quindi chiama [`applyFlagSettings()`](#applyflagsettings) quando vuoi anche cambiare quello. Questa fonte richiede TypeScript SDK v0.3.277 o successivo, che raggruppa Claude Code v2.1.277.

717

718La chiamata rifiuta quando la richiesta trasporta qualsiasi altra chiave, quando la sessione viene eseguita su un trasporto remoto, e quando il [`settingSources`](#options) della sessione esclude la fonte che nomini. L'eliminazione di una chiave non è supportata.

719

698<h3 id="warmquery">720<h3 id="warmquery">

699 `WarmQuery`721 `WarmQuery`

700</h3>722</h3>

942 964

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

944 966

967<h3 id="sdkcontrolmcpreadresourceresponse">

968 `SDKControlMcpReadResourceResponse`

969</h3>

970

971Tipo di ritorno di [`readMcpResource()`](#query-object), che trasporta il risultato `resources/read` del server MCP. Richiede TypeScript Agent SDK v0.3.280 o successivo.

972

973```typescript theme={null}

974type SDKControlMcpReadResourceResponse = {

975 contents: {

976 uri: string;

977 mimeType?: string;

978 text?: string;

979 blob?: string;

980 _meta?: Record<string, unknown>;

981 }[];

982};

983```

984

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

986

987Ogni voce `contents` è un elemento di contenuto come il server lo ha inviato. `blob` contiene dati base64 per un elemento binario, e `_meta` è il `_meta` dell'elemento stesso, dove un server MCP Apps mette il `ui.csp` e `ui.permissions` della risorsa. I contenuti sono HTML di terze parti non attendibile, quindi rendili in una sandbox.

988

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

946 `AgentDefinition`990 `AgentDefinition`

947</h3>991</h3>

1368 uuid?: UUID;1412 uuid?: UUID;

1369 session_id?: string;1413 session_id?: string;

1370 message: MessageParam; // Dall'SDK Anthropic1414 message: MessageParam; // Dall'SDK Anthropic

1415 pasted_content?: MessageParam["content"][];

1371 parent_tool_use_id: string | null;1416 parent_tool_use_id: string | null;

1372 isSynthetic?: boolean;1417 isSynthetic?: boolean;

1373 shouldQuery?: boolean;1418 shouldQuery?: boolean;

1374 tool_use_result?: unknown;1419 tool_use_result?: unknown;

1375 origin?: SDKMessageOrigin;1420 origin?: SDKMessageOrigin;

1421 inline_pastes?: string[];

1376};1422};

1377```1423```

1378 1424

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

1426

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

1380 1428

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

1384 1432

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

1386 1434

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

1436

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

1388 `SDKUserMessageReplay`1438 `SDKUserMessageReplay`

1389</h3>1439</h3>

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

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

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

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

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

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

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

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

1513 1563

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

1515 1565

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

1567

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

1517 1569

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

1519 1571

1664 1716

1665`source` su ogni voce `mcp_servers`: da dove proviene la definizione del server, con gli stessi valori di [`McpServerStatus`](#mcpserverstatus)'s `source`. Richiede Agent SDK v0.3.274 o successivo.1717`source` su ogni voce `mcp_servers`: da dove proviene la definizione del server, con gli stessi valori di [`McpServerStatus`](#mcpserverstatus)'s `source`. Richiede Agent SDK v0.3.274 o successivo.

1666 1718

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

1720

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

1668 1722

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

1670 1724

1932 | {1986 | {

1933 kind: "task-notification";1987 kind: "task-notification";

1934 subkind?: "scheduled-trigger" | "peer-send-message";1988 subkind?: "scheduled-trigger" | "peer-send-message";

1989 fireReason?: string;

1935 }1990 }

1936 | { kind: "coordinator" }1991 | { kind: "coordinator" }

1937 | { kind: "auto-continuation" }1992 | { kind: "auto-continuation" }

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

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

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

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

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

1952 Task-notification subkinds2007 Task-notification subkinds

1953</h3>2008</h3>

1954 2009

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

2011

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

2013*

2014

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

2016

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

2018

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

1956 2020

1957* `scheduled-trigger`: la notifica è il prompt memorizzato di una [routine](/docs/it/routines), consegnato perché uno dei trigger della routine si è attivato: il suo programma, il suo [trigger API](/docs/it/routines#add-an-api-trigger), il suo [trigger GitHub](/docs/it/routines#add-a-github-trigger), o **Esegui ora**. Claude Code inquadra questi al modello come l'attività assegnata della sessione, con un avviso diverso dall'[avviso che altre notifiche di attività contengono](#sdktasknotificationmessage).2021<h4 id="declare-a-scheduled-run">

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

2023</h4>

1959 2024

1960Ogni altra notifica di attività non ha `subkind`. Questo include [attività programmate](/docs/it/scheduled-tasks) che si attivano sulla tua stessa macchina, [attività PR](/docs/it/claude-code-on-the-web#how-claude-responds-to-pr-activity) consegnate in una sessione, e eventi in background come un'attività finita. I messaggi dallo strumento [`SendMessage`](/docs/it/cross-session-messaging) tra sessioni non sono notifiche di attività affatto: che provengano da una sessione sulla stessa macchina o attraverso i server Anthropic da un'altra macchina, Claude Code dà loro `kind: "peer"` e i [campi di origine peer](#peer-origin-fields).2025Se la tua applicazione esegue prompt secondo il suo programma, dichiara ogni esecuzione in modo che Claude Code inquadri il turno al modello come un'attività programmata piuttosto che come input dal vivo dell'utente. Avvia la sessione con `CLAUDE_CODE_HOST_SCHEDULED_RUN` impostato a `1` in [`env`](#options), quindi invia il [`SDKUserMessage`](#sdkusermessage) dell'esecuzione con `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` e senza `isSynthetic`. Claude Code ignora la dichiarazione in un processo avviato senza quella variabile. Ignora anche in un processo il cui ambiente contiene [`CLAUDECODE`](/docs/it/env-vars) o `CLAUDE_CODE_CHILD_SESSION`. Claude Code mantiene `fireReason` solo quando il valore è 1 a 32 lettere minuscole o trattini bassi. Richiede TypeScript Agent SDK v0.3.280 o successivo.

1961 2026

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

1963 Peer origin fields2028 Peer origin fields

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

1967 2032

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

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

2035

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

2037

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

1971* `name`: il nome di visualizzazione del mittente, normalizzato da Claude Code: rimuove i punti di codice di controllo, formato, surrogato e separatore di riga o paragrafo Unicode, quindi taglia il risultato e lo limita a 64 punti di codice con un'ellissi. Richiede Claude Code v2.1.205 o successivo.2039*

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

1973* `fromSession`: l'ID sessione del mittente apribile dall'host, impostato dall'host del mittente in modo che la tua interfaccia utente possa collegarsi di nuovo alla sessione di invio. Come `from`, è asserito dal mittente: usalo solo come destinazione di navigazione, e non trattarlo come prova dell'identità del mittente. Richiede Claude Code v2.1.216 o successivo.2041`name`: il nome di visualizzazione del mittente, normalizzato da Claude Code: rimuove i punti di codice di controllo, formato, surrogato e separatore di riga o paragrafo Unicode, quindi taglia il risultato e lo limita a 64 punti di codice con un'ellissi. Richiede Claude Code v2.1.205 o successivo.

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

2043*

2044

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

2046

2047*

2048

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

2050

2051*

2052

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

1975 2054

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

1977 Tipi di hook2056 Tipi di hook

2837 | ReadMcpResourceInput2916 | ReadMcpResourceInput

2838 | RefreshMcpToolsInput2917 | RefreshMcpToolsInput

2839 | RemoteTriggerInput2918 | RemoteTriggerInput

2840 | REPLInput

2841 | ReportFindingsInput2919 | ReportFindingsInput

2842 | ScheduleWakeupInput2920 | ScheduleWakeupInput

2843 | ShowOnboardingRolePickerInput2921 | ShowOnboardingRolePickerInput

2844 | TaskCreateInput2922 | TaskCreateInput

2845 | TaskGetInput2923 | TaskGetInput

2846 | TaskListInput2924 | TaskListInput

2847 | TaskOutputInput

2848 | TaskStopInput2925 | TaskStopInput

2849 | TaskUpdateInput2926 | TaskUpdateInput

2850 | TodoWriteInput2927 | TodoWriteInput

2939 3016

2940Esegue una fonte di background e consegna ogni evento a Claude in modo che possa reagire senza polling: `command` esegue uno script e emette un evento per riga stdout, e `ws` apre un WebSocket e emette un evento per frame di testo. Fornisci esattamente uno tra `command` o `ws`. La fonte `ws` richiede Claude Code v2.1.195 o successivo.3017Esegue una fonte di background e consegna ogni evento a Claude in modo che possa reagire senza polling: `command` esegue uno script e emette un evento per riga stdout, e `ws` apre un WebSocket e emette un evento per frame di testo. Fornisci esattamente uno tra `command` o `ws`. La fonte `ws` richiede Claude Code v2.1.195 o successivo.

2941 3018

2942`timeout_ms` è la scadenza del watch in millisecondi. Predefinito a 300000, e la scadenza effettiva è al massimo 1800000, che è 30 minuti. Alla scadenza il watch termina e Claude riceve un avviso in modo che possa avviare un nuovo watch se ne ha ancora bisogno.3019`timeout_ms` è la scadenza del watch in millisecondi. Predefinito a 300000 e accetta valori fino a 3600000. La scadenza effettiva è al massimo 1800000, che è 30 minuti, quindi un valore accettato più grande viene accorciato a quello. Alla scadenza il watch termina e Claude riceve un avviso in modo che possa avviare un nuovo watch se ne ha ancora bisogno.

2943 3020

2944Il tipo esportato contrassegna `timeout_ms` come obbligatorio perché lo schema riempie il valore predefinito; una chiamata che lo omette convalida.3021Il tipo esportato contrassegna `timeout_ms` come obbligatorio perché lo schema riempie il valore predefinito; una chiamata che lo omette convalida.

2945 3022

2949 TaskOutput3026 TaskOutput

2950</h3>3027</h3>

2951 3028

2952**Nome del tool:** `TaskOutput`3029Rimosso in Claude Code v2.1.277, insieme al suo tipo `TaskOutputInput`. In precedenza recuperava l'output da un'attività di background in esecuzione o completata; Claude legge il file di output di un'attività di background con `Read` invece.

~~2953~~

2954<Note>`TaskOutput` è deprecato; preferisci `Read` sul percorso del file di output dell'attività. Gli schemi sottostanti rimangono validi per gli hook e i gestori di permessi che incontrano il tool.</Note>

~~2955~~

2956```typescript theme={null}

2957type TaskOutputInput = {

2958 task_id: string;

2959 block: boolean;

2960 timeout: number;

2961};

2962```

2963 3030

2964Recupera l'output da un'attività di background in esecuzione o completata.3031Una voce `disallowedTools` o una regola di negazione che ancora nomina `TaskOutput` viene ignorata senza un avviso.

2965 3032

2966<h3 id="edit">3033<h3 id="edit">

2967 Edit3034 Edit

3456 REPL3523 REPL

3457</h3>3524</h3>

3458 3525

3459**Nome del tool:** `REPL`3526Rimosso in v2.1.275. Fino a v2.1.274, uno strumento sperimentale `REPL` poteva essere attivato con `CLAUDE_CODE_REPL=1` nell'[opzione `env`](#options).

~~3460~~

3461```typescript theme={null}

3462type REPLInput = {

3463 code: string;

3464 description?: string;

3465 timeout?: number;

3466};

3467```

~~3468~~

3469Esegue il codice JavaScript in un REPL persistente. Lo stato persiste tra le chiamate e top-level await è supportato. `timeout` è in millisecondi, con un valore predefinito di 30000 e un massimo di 600000.

~~3470~~

3471I tipi vengono esportati, ma il tool è disattivato nelle sessioni SDK a meno che non imposti `CLAUDE_CODE_REPL=1` nell'[opzione `env`](#options). Richiede anche l'eseguibile `claude` basato su Bun che il programma di installazione nativo fornisce.

3472 3527

3473<h3 id="reportfindings">3528<h3 id="reportfindings">

3474 ReportFindings3529 ReportFindings

3514 action?: "publish" | "list";3569 action?: "publish" | "list";

3515 file_path?: string;3570 file_path?: string;

3516 favicon?: string;3571 favicon?: string;

3572 icon?: string;

3517 limit?: number;3573 limit?: number;

3518 scope?: "mine" | "shared" | "all";3574 scope?: "mine" | "shared" | "all";

3519 title?: string;3575 title?: string;

3526};3582};

3527```3583```

3528 3584

3529Pubblica un file `.html` o `.md` locale come pagina di artifact ospitata, o elenca gli artifact pubblicati dell'utente. Ometti `action` o passa `"publish"` per pubblicare `file_path`, che è obbligatorio per l'azione di pubblicazione insieme a `favicon`, uno o due emoji che contrassegnano l'artifact nella galleria dell'utente. `title` nomina la pagina pubblicata nella scheda del browser e nella galleria quando il file HTML non ha un tag `<title>`. `url` indirizza un artifact esistente da aggiornare sul posto invece di crearne uno nuovo.3585Pubblica un file `.html` o `.md` locale come pagina di artifact ospitata, o elenca gli artifact pubblicati dell'utente. Ometti `action` o passa `"publish"` per pubblicare `file_path`, che è obbligatorio per l'azione di pubblicazione. Ogni campo di seguito si applica a una pubblicazione:

3586

3587* `icon`: una parola generica breve per l'icona della scheda del browser dell'artifact, come `chart` o `map`. Claude la include su una prima pubblicazione e la omette su un aggiornamento, il che mantiene l'icona memorizzata dell'artifact.

3588* `favicon`: deprecato, e Claude lo omette.

3589* `title`: nomina la pagina pubblicata nella scheda del browser e nella galleria quando il file HTML non ha un tag `<title>`.

3590* `url`: indirizza un artifact esistente da aggiornare sul posto invece di crearne uno nuovo.

3530 3591

3531`force` è un'ultima risorsa di sovrascrittura che scarta una versione più recente che un'altra sessione ha pubblicato. In caso di conflitto, la pubblicazione non riuscita restituisce il contenuto più recente; Claude unisce le sue modifiche a quel contenuto, o rilegge l'artifact, e pubblica di nuovo. Passa `force` solo quando l'utente chiede esplicitamente di scartare quella versione.3592`force` è un'ultima risorsa di sovrascrittura che scarta una versione più recente che un'altra sessione ha pubblicato. In caso di conflitto, la pubblicazione non riuscita restituisce il contenuto più recente; Claude unisce le sue modifiche a quel contenuto, o rilegge l'artifact, e pubblica di nuovo. Passa `force` solo quando l'utente chiede esplicitamente di scartare quella versione.

3532 3593

3663 | ReadMcpResourceOutput3724 | ReadMcpResourceOutput

3664 | RefreshMcpToolsOutput3725 | RefreshMcpToolsOutput

3665 | RemoteTriggerOutput3726 | RemoteTriggerOutput

3666 | REPLOutput

3667 | ReportFindingsOutput3727 | ReportFindingsOutput

3668 | ScheduleWakeupOutput3728 | ScheduleWakeupOutput

3669 | ShowOnboardingRolePickerOutput3729 | ShowOnboardingRolePickerOutput

4513 4573

4514Restituisce i dettagli di consegna, incluso se una notifica push o locale è stata inviata e perché la consegna è stata saltata.4574Restituisce i dettagli di consegna, incluso se una notifica push o locale è stata inviata e perché la consegna è stata saltata.

4515 4575

4516<h3 id="repl-2">

4517 REPL

4518</h3>

~~4519~~

4520**Nome del tool:** `REPL`

~~4521~~

4522```typescript theme={null}

4523type REPLOutput = {

4524 code: string;

4525 result: {

4526 [k: string]: unknown;

4527 };

4528 stdout: string;

4529 stderr: string;

4530 error?: string;

4531 registeredTools?: string[];

4532 images?: {

4533 base64: string;

4534 mediaType: string;

4535 }[];

4536 documents?: {

4537 base64: string;

4538 }[];

4539};

4540```

~~4541~~

4542Restituisce il risultato dell'esecuzione, l'output della console acquisito, e qualsiasi immagine o documento esposto da chiamate `Read` interne.

~~4543~~

4544<h3 id="reportfindings-2">4576<h3 id="reportfindings-2">

4545 ReportFindings4577 ReportFindings

4546</h3>4578</h3>

4864```4896```

4865 4897

4866<Warning>4898<Warning>

4867 La beta `context-1m-2025-08-07` è ritirata a partire dal 30 aprile 2026. Passare questo valore con Claude Sonnet 4.5 o Sonnet 4 non ha effetto, e le richieste che superano la finestra di contesto standard di 200k token restituiscono un errore. Per usare una finestra di contesto di 1M token, esegui la migrazione a [Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7, o Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), che includono 1M di contesto ai prezzi standard senza intestazione beta richiesta.4899 La beta `context-1m-2025-08-07` è ritirata a partire dal 30 aprile 2026. Passare questo valore con Claude Sonnet 4.5 o Sonnet 4 non ha effetto, e le richieste che superano la finestra di contesto standard di 200k token restituiscono un errore. Per usare una finestra di contesto di 1M token, esegui la migrazione a [Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7, o Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), che includono 1M di contesto ai prezzi standard senza intestazione beta richiesta.

4868</Warning>4900</Warning>

4869 4901

4870<h3 id="slashcommand">4902<h3 id="slashcommand">

4879 description: string;4911 description: string;

4880 argumentHint: string;4912 argumentHint: string;

4881 aliases?: string[];4913 aliases?: string[];

4914 builtin?: boolean;

4882};4915};

4883```4916```

4884 4917

4918`builtin` è `true` su una riga quando il comando è proprio di Claude Code e digitare `/name` lo esegue. È assente per un comando definito da un utente, progetto, plugin, o server MCP, e per un comando in bundle che uno di quelli [sostituisce per nome](/docs/it/skills#resolve-skills-that-share-a-name). Richiede Agent SDK v0.3.277 o successivo.

4919

4885<h3 id="modelinfo">4920<h3 id="modelinfo">

4886 `ModelInfo`4921 `ModelInfo`

4887</h3>4922</h3>

4988 destructive?: boolean;5023 destructive?: boolean;

4989 openWorld?: boolean;5024 openWorld?: boolean;

4990 };5025 };

5026 _meta?: Record<string, unknown>;

4991 }[];5027 }[];

4992};5028};

4993```5029```

4994 5030

4995`source` dice da dove proviene la definizione del server, con gli stessi valori e regola di fiducia di [`McpServerProvenance`](#mcpserverprovenance) `source`. Il campo richiede Agent SDK v0.3.274 o successivo ed è assente nelle versioni precedenti.5031`source` dice da dove proviene la definizione del server, con gli stessi valori e regola di fiducia di [`McpServerProvenance`](#mcpserverprovenance) `source`. Il campo richiede Agent SDK v0.3.274 o successivo ed è assente nelle versioni precedenti.

4996 5032

5033`_meta` su una voce `tools` contiene i membri MCP Apps di `_meta` di quel tool, quindi la tua applicazione può trovare la risorsa `ui://` da rendere con [`readMcpResource()`](#query-object). Claude Code passa attraverso l'oggetto `ui` e la stringa deprecata `ui/resourceUri`, e trattiene ogni altra chiave. All'interno di `ui`, `resourceUri` è una stringa `ui://` e `visibility` è un array di `"model"` e `"app"` quando il server li imposta, e qualsiasi altro membro passa attraverso invariato. Claude Code scarta entrambe le chiavi quando il valore è malformato, e omette `_meta` da un tool che non dichiara nessuno. Il campo è presente solo quando le [`capabilities`](#sdksystemmessage) del messaggio di inizializzazione includono `mcp_tool_ui_meta_v1`, e richiede TypeScript Agent SDK v0.3.280 o successivo.

5034

4997<h3 id="mcpserverstatusconfig">5035<h3 id="mcpserverstatusconfig">

4998 `McpServerStatusConfig`5036 `McpServerStatusConfig`

4999</h3>5037</h3>

5738```5776```

5739 5777

5741| :-------------------------- | :---------------------------------------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |5779| :-------------------------- | :---------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

5745| `excludedCommands` | `string[]` | `[]` | Comandi che sempre bypassano le restrizioni della sandbox (ad esempio, `['docker']`). Questi vengono eseguiti senza sandbox automaticamente senza coinvolgimento del modello |5783| `excludedCommands` | `string[]` | `[]` | Comandi che bypassano le restrizioni della sandbox, come `['docker *']`. Questi vengono eseguiti senza sandbox automaticamente senza coinvolgimento del modello; [`sandbox.excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) copre quando una voce si applica |

5746| `allowUnsandboxedCommands` | `boolean` | `true` | Consenti al modello di richiedere l'esecuzione di comandi al di fuori della sandbox. Quando `true`, il modello può impostare `dangerouslyDisableSandbox` nell'input del tool, che ricade nel [sistema di permessi](#permissions-fallback-for-unsandboxed-commands) |5784| `allowUnsandboxedCommands` | `boolean` | `true` | Consenti al modello di richiedere l'esecuzione di comandi al di fuori della sandbox. Quando `true`, il modello può impostare `dangerouslyDisableSandbox` nell'input del tool, che ricade nel [sistema di permessi](#permissions-fallback-for-unsandboxed-commands) |

5849 Fallback dei permessi per i comandi senza sandbox5887 Fallback dei permessi per i comandi senza sandbox

5850</h3>5888</h3>

5851 5889

5852Quando `allowUnsandboxedCommands` è abilitato, il modello può richiedere di eseguire comandi al di fuori della sandbox impostando `dangerouslyDisableSandbox: true` nell'input del tool. Queste richieste ricadono nel sistema di permessi esistente, il che significa che il tuo handler `canUseTool` viene invocato, permettendoti di implementare la logica di autorizzazione personalizzata. I comandi elencati in `excludedCommands` invece bypassano la sandbox automaticamente, senza coinvolgimento del modello; vedi [`SandboxSettings`](#sandboxsettings).5890Quando `allowUnsandboxedCommands` è abilitato, il modello può richiedere di eseguire comandi al di fuori della sandbox impostando `dangerouslyDisableSandbox: true` nell'input del tool. Queste richieste ricadono nel sistema di permessi esistente, il che significa che il tuo handler `canUseTool` viene invocato, permettendoti di implementare la logica di autorizzazione personalizzata.

5891

5892Le tue voci `excludedCommands` invece escono dalla sandbox senza coinvolgimento del modello; [`sandbox.excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) copre quando una voce si applica.

5853 5893

5854Nell'esempio seguente, `isCommandAuthorized` rappresenta un controllo di autorizzazione che definisci.5894Nell'esempio seguente, `isCommandAuthorized` rappresenta un controllo di autorizzazione che definisci.

5855 5895

agent-teams.md +0 −4

Details

14 14

15Prima di configurare un team, verificate se un'opzione più leggera fa il lavoro. I [Subagents](/docs/it/sub-agents) lavorano all'interno di una singola sessione, e con la [messaggistica tra sessioni](/docs/it/cross-session-messaging) Claude può passare i risultati tra le sessioni che eseguite voi stessi.15Prima di configurare un team, verificate se un'opzione più leggera fa il lavoro. I [Subagents](/docs/it/sub-agents) lavorano all'interno di una singola sessione, e con la [messaggistica tra sessioni](/docs/it/cross-session-messaging) Claude può passare i risultati tra le sessioni che eseguite voi stessi.

16 16

~~17<Note>~~

18 Questa pagina descrive i team di agenti a partire da v2.1.178. Con `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` impostato, la generazione di un compagno di team non richiede più un passaggio di configurazione, e la pulizia avviene automaticamente quando la sessione esce. Prima di v2.1.178, chiedevate a Claude di creare e denominare un team per primo, e Claude utilizzava i tool `TeamCreate` e `TeamDelete` per configurarlo e rimuoverlo. Entrambi i tool non esistono più. L'input `team_name` sul tool Agent è accettato ma ignorato, e il campo `team_name` in `TaskCreated`, `TaskCompleted`, e `TeammateIdle` [hook payloads](/docs/it/hooks#taskcreated) porta il nome derivato dalla sessione ed è deprecato.

~~19</Note>~~

21<h2 id="when-to-use-agent-teams">17<h2 id="when-to-use-agent-teams">

22 Quando utilizzare i team di agenti18 Quando utilizzare i team di agenti

23</h2>19</h2>

amazon-bedrock.md +6 −6

Details

291 291

292Impostare queste variabili di ambiente su ID modello Amazon Bedrock specifici.292Impostare queste variabili di ambiente su ID modello Amazon Bedrock specifici.

293 293

294Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Amazon Bedrock si risolve in Opus 5, e senza `ANTHROPIC_DEFAULT_SONNET_MODEL`, l'alias `sonnet` si risolve in Sonnet 4.5. Questo esempio fissa ogni alias a una versione specifica:294Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Amazon Bedrock si risolve in Opus 5.5, e senza `ANTHROPIC_DEFAULT_SONNET_MODEL`, l'alias `sonnet` si risolve in Sonnet 4.5. Questo esempio fissa ogni alias a una versione specifica:

295 295

296```bash theme={null}296```bash theme={null}

297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'

304Per mantenere i modelli predefiniti integrati e modificare solo il loro prefisso preferito, impostare [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) invece di fissare. La differenza si mostra in ciò a cui l'alias `opus` si risolve:304Per mantenere i modelli predefiniti integrati e modificare solo il loro prefisso preferito, impostare [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) invece di fissare. La differenza si mostra in ciò a cui l'alias `opus` si risolve:

305 305

307| :------------------------------------------------------------ | :-------------------------------------------------------------------------------------- |307| :------------------------------------------------------------ | :---------------------------------------------------------------------------------------- |

308| `ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` | `us.anthropic.claude-opus-4-8`, l'ID esatto che hai fissato |308| `ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` | `us.anthropic.claude-opus-4-8`, l'ID esatto che hai fissato |

309| `ANTHROPIC_BEDROCK_REGION_PREFIX=eu` | `eu.anthropic.claude-opus-5`, il valore predefinito integrato con il prefisso preferito |309| `ANTHROPIC_BEDROCK_REGION_PREFIX=eu` | `eu.anthropic.claude-opus-5-5`, il valore predefinito integrato con il prefisso preferito |

310 310

311Per gli ID modello attuali e legacy, vedere [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Per l'elenco completo delle variabili di ambiente di fissaggio, vedere [Configurazione del modello](/docs/it/model-config#pin-models-for-third-party-deployments).311Per gli ID modello attuali e legacy, vedere [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Per l'elenco completo delle variabili di ambiente di fissaggio, vedere [Configurazione del modello](/docs/it/model-config#pin-models-for-third-party-deployments).

312 312

314 314

315| Tipo di modello | Modello predefinito |315| Tipo di modello | Modello predefinito |

316| :--------------------- | :------------------------------------------------------------------------------------------ |316| :--------------------- | :------------------------------------------------------------------------------------------ |

319 319

320Le attività in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello di classe Haiku. Su Amazon Bedrock, Claude Code utilizza il modello Sonnet predefinito per le attività in background perché Haiku potrebbe non essere abilitato in ogni account o regione. Due selezioni cambiano quale modello li trasporta:320Le attività in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello di classe Haiku. Su Amazon Bedrock, Claude Code utilizza il modello Sonnet predefinito per le attività in background perché Haiku potrebbe non essere abilitato in ogni account o regione. Due selezioni cambiano quale modello li trasporta:

326 I modelli Opus hanno un prezzo per token più elevato rispetto ai modelli Sonnet, quindi una distribuzione che non fissa un modello primario viene fatturata alla tariffa Opus una volta che si aggiorna alla versione 2.1.207 o successiva. Per mantenere Sonnet 4.5 come modello primario, impostare `ANTHROPIC_MODEL` al suo ID modello completo. Una distribuzione che indirizza il valore predefinito con `ANTHROPIC_DEFAULT_SONNET_MODEL` e non imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` mantiene il modello Sonnet indirizzato come valore predefinito.326 I modelli Opus hanno un prezzo per token più elevato rispetto ai modelli Sonnet, quindi una distribuzione che non fissa un modello primario viene fatturata alla tariffa Opus una volta che si aggiorna alla versione 2.1.207 o successiva. Per mantenere Sonnet 4.5 come modello primario, impostare `ANTHROPIC_MODEL` al suo ID modello completo. Una distribuzione che indirizza il valore predefinito con `ANTHROPIC_DEFAULT_SONNET_MODEL` e non imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` mantiene il modello Sonnet indirizzato come valore predefinito.

327</Warning>327</Warning>

328 328

329Nella versione 2.1.207 fino a 2.1.218, il modello primario su Amazon Bedrock era predefinito su Opus 4.8 e l'alias `opus` si risolveva in Opus 4.8. Prima della versione 2.1.207, il modello primario era predefinito su Sonnet 4.5, l'alias `opus` si risolveva in Opus 4.6 e le attività in background utilizzavano sempre il modello primario.329Prima della versione 2.1.280, il modello primario su Amazon Bedrock era predefinito su Opus 5 e l'alias `opus` si risolveva in Opus 5 dalla versione 2.1.219. Nella versione 2.1.207 fino a 2.1.218, il modello primario su Amazon Bedrock era predefinito su Opus 4.8 e l'alias `opus` si risolveva in Opus 4.8. Prima della versione 2.1.207, il modello primario era predefinito su Sonnet 4.5, l'alias `opus` si risolveva in Opus 4.6 e le attività in background utilizzavano sempre il modello primario.

330 330

331Per personalizzare ulteriormente i modelli, utilizzare uno di questi metodi:331Per personalizzare ulteriormente i modelli, utilizzare uno di questi metodi:

332 332

405```bash theme={null}405```bash theme={null}

406export ANTHROPIC_BEDROCK_REGION_PREFIX=global406export ANTHROPIC_BEDROCK_REGION_PREFIX=global

407# In a us-* region, the primary model now resolves to407# In a us-* region, the primary model now resolves to

408# global.anthropic.claude-opus-5 instead of us.anthropic.claude-opus-5408# global.anthropic.claude-opus-5-5 instead of us.anthropic.claude-opus-5-5

409```409```

410 410

411Il prefisso preferito è una preferenza, non una garanzia, indipendentemente dal fatto che provenga dalla vostra regione o dalla variabile. Il modo in cui Claude Code lo applica dipende dal fatto che possa verificare la disponibilità del profilo nel vostro account:411Il prefisso preferito è una preferenza, non una garanzia, indipendentemente dal fatto che provenga dalla vostra regione o dalla variabile. Il modo in cui Claude Code lo applica dipende dal fatto che possa verificare la disponibilità del profilo nel vostro account:

artifacts.md +2 −2

Details

347Gli artifact richiedono ogni condizione di seguito. Quando una non è soddisfatta, Claude scrive un file HTML locale o dice che non può pubblicare.347Gli artifact richiedono ogni condizione di seguito. Quando una non è soddisfatta, Claude scrive un file HTML locale o dice che non può pubblicare.

348 348

349| Requirement | Available when |349| Requirement | Available when |

350| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |350| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

351| Plan | Pro, Max, Team o Enterprise. Sui piani Pro e Max, gli artifact sono privati per te fino a quando non li condividi, e non si applica alcuna gestione amministrativa. Sui piani Team, gli artifact sono abilitati per impostazione predefinita. Sui piani Enterprise, un Owner [li abilita](#manage-artifacts-for-your-organization) nelle impostazioni admin di claude.ai. |351| Plan | Pro, Max, Team o Enterprise. Sui piani Pro e Max, gli artifact sono privati per te fino a quando non li condividi, e non si applica alcuna gestione amministrativa. Sui piani Team, gli artifact sono abilitati per impostazione predefinita. Sui piani Enterprise, un Owner [li abilita](#manage-artifacts-for-your-organization) nelle impostazioni admin di claude.ai. |

352| Authentication | La sessione è supportata da un account claude.ai: accedi con `/login` nell'app CLI o desktop. Le sessioni Claude Tag sono autenticate attraverso l'identità dell'agente, quindi non è necessario alcun passaggio. Le sessioni che utilizzano una chiave API, [gateway token](/docs/it/llm-gateway) o credenziale del provider cloud non possono pubblicare. |352| Authentication | La sessione è supportata da un account claude.ai: accedi con `/login` nell'app CLI o desktop. Le sessioni Claude Tag sono autenticate attraverso l'identità dell'agente, quindi non è necessario alcun passaggio. Le sessioni che utilizzano una chiave API, [gateway token](/docs/it/llm-gateway) o credenziale del provider cloud non possono pubblicare. |

353| Model provider | Anthropic API. Non disponibile su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) o [Microsoft Foundry](/docs/it/microsoft-foundry). |353| Model provider | Anthropic API. Non disponibile su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) o [Microsoft Foundry](/docs/it/microsoft-foundry). |

354| Organization policy | Le chiavi di crittografia gestite dal cliente (CMEK), HIPAA e [Zero Data Retention](/docs/it/zero-data-retention) non sono abilitate per l'organizzazione. |354| Organization policy | Le chiavi di crittografia gestite dal cliente (CMEK), HIPAA e [Zero Data Retention](/docs/it/zero-data-retention) non sono abilitate per l'organizzazione. |

355| Surface | Claude Code CLI versione 2.1.183 o successiva, o l'app desktop Claude versione 1.13576.0 o successiva. Le sessioni [Claude Tag](https://claude.com/docs/claude-tag/overview) possono anche pubblicare artifact quando sia Claude Tag che gli artifact sono abilitati per l'organizzazione. Disabilitato per impostazione predefinita in contesti [Agent SDK](/docs/it/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars) è impostato. |355| Surface | Claude Code CLI o l'app desktop Claude versione 1.13576.0 o successiva. Le sessioni [Claude Tag](https://claude.com/docs/claude-tag/overview) possono anche pubblicare artifact quando sia Claude Tag che gli artifact sono abilitati per l'organizzazione. Disabilitato per impostazione predefinita in contesti [Agent SDK](/docs/it/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars) è impostato. |

356 356

357<h2 id="disable-artifacts">357<h2 id="disable-artifacts">

358 Disattivare gli artifact358 Disattivare gli artifact

authentication.md +2 −2

Details

53 53

54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) offrono la migliore esperienza per le organizzazioni che utilizzano Claude Code. I membri del team ottengono accesso sia a Claude Code che a Claude sul web con fatturazione centralizzata e gestione del team.54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) offrono la migliore esperienza per le organizzazioni che utilizzano Claude Code. I membri del team ottengono accesso sia a Claude Code che a Claude sul web con fatturazione centralizzata e gestione del team.

55 55

~~56* **Claude for Teams**: piano self-service con funzionalità di collaborazione, strumenti di amministrazione e gestione della fatturazione. Ideale per team più piccoli.~~56* **Claude for Teams**: piano self-service con funzionalità di collaborazione, strumenti di amministrazione, SSO, gestione della fatturazione e [impostazioni gestite dal server](/docs/it/server-managed-settings) per la configurazione Claude Code a livello organizzativo. Ideale per team più piccoli.

57* **Claude for Enterprise**: aggiunge SSO, domain capture, autorizzazioni basate su ruoli, API di conformità e impostazioni di policy gestite per configurazioni Claude Code a livello organizzativo. Ideale per organizzazioni più grandi con requisiti di sicurezza e conformità.57* **Claude for Enterprise**: aggiunge domain capture, autorizzazioni basate su ruoli e API di conformità. Ideale per organizzazioni più grandi con requisiti di sicurezza e conformità.

58 58

59<Steps>59<Steps>

60 <Step title="Sottoscrivete">60 <Step title="Sottoscrivete">

claude-code-on-the-web.md +1 −1

Details

250 250

251Le sessioni cloud supportano [comandi integrati](/docs/it/commands) che producono output di testo. I comandi che vengono eseguiti solo nell'interfaccia del terminale, come `/plugin` o `/resume`, non sono disponibili. I comandi che aprono un selettore o un pannello nel terminale si comportano diversamente nelle sessioni cloud:251Le sessioni cloud supportano [comandi integrati](/docs/it/commands) che producono output di testo. I comandi che vengono eseguiti solo nell'interfaccia del terminale, come `/plugin` o `/resume`, non sono disponibili. I comandi che aprono un selettore o un pannello nel terminale si comportano diversamente nelle sessioni cloud:

252 252

253* **`/model`, `/effort`, `/color` e `/rename`**: passare il valore come argomento, ad esempio `/model sonnet`, invece di aprire il selettore del terminale o il cursore. Le forme di argomento richiedono Claude Code v2.1.205 o successivo nell'ambiente della sessione e seguono le [note di disponibilità](/docs/it/commands#all-commands) di ciascun comando: `/effort` segnala `Not applied` mentre il [launch-default effort hold](/docs/it/model-config#adjust-effort-level) di un modello è in vigore.253* **`/model`, `/effort`, `/color` e `/rename`**: passare il valore come argomento, ad esempio `/model sonnet`, invece di aprire il selettore del terminale o il cursore. Le forme di argomento richiedono Claude Code v2.1.205 o successivo nell'ambiente della sessione e seguono le [note di disponibilità](/docs/it/commands#all-commands) di ciascun comando.

254* **`/fast`**: attiva/disattiva la [modalità veloce](/docs/it/fast-mode#use-fast-mode-in-cloud-sessions) per la sessione quando la modalità veloce è [disponibile nel vostro account](/docs/it/fast-mode#requirements). Richiede Claude Code v2.1.271 o successivo nell'ambiente della sessione.254* **`/fast`**: attiva/disattiva la [modalità veloce](/docs/it/fast-mode#use-fast-mode-in-cloud-sessions) per la sessione quando la modalità veloce è [disponibile nel vostro account](/docs/it/fast-mode#requirements). Richiede Claude Code v2.1.271 o successivo nell'ambiente della sessione.

255* **`/config`**: nel vostro browser su claude.ai/code, apre la sezione Claude Code delle impostazioni invece di impostare un valore, e il testo dopo il comando, incluso `key=value`, viene ignorato. Per modificare un'impostazione per una sessione cloud, impostare una [variabile di ambiente](/docs/it/cloud-environments#set-environment-variables) nell'ambiente, oppure in una sessione con un repository, eseguire il commit della chiave nel file `.claude/settings.json` di quel repository. [Impostazioni nelle sessioni cloud](/docs/it/settings#settings-in-cloud-sessions) elenca cosa legge ogni sessione.255* **`/config`**: nel vostro browser su claude.ai/code, apre la sezione Claude Code delle impostazioni invece di impostare un valore, e il testo dopo il comando, incluso `key=value`, viene ignorato. Per modificare un'impostazione per una sessione cloud, impostare una [variabile di ambiente](/docs/it/cloud-environments#set-environment-variables) nell'ambiente, oppure in una sessione con un repository, eseguire il commit della chiave nel file `.claude/settings.json` di quel repository. [Impostazioni nelle sessioni cloud](/docs/it/settings#settings-in-cloud-sessions) elenca cosa legge ogni sessione.

256 256

claude-directory.md +26 −8

Details

1451L'explorer copre i file che crei e modifichi. Alcuni file correlati si trovano altrove:1451L'explorer copre i file che crei e modifichi. Alcuni file correlati si trovano altrove:

1452 1452

1454| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1454| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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 e dati per plugin, gestiti dai comandi `claude plugin`. Per un plugin installato da un marketplace con [fonte `command`](/docs/it/plugin-marketplaces#command-sources) 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-reference#plugin-caching-and-file-resolution) dalla sua directory di origine piuttosto che da una copia cache. Vedi [plugin caching](/docs/it/plugins-reference#plugin-caching-and-file-resolution) 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-reference#synced-plugins) vengono scaricati in `~/.claude/plugins/synced/`. Per un plugin installato da un marketplace con [fonte `command`](/docs/it/plugin-marketplaces#command-sources) 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-reference#plugin-caching-and-file-resolution) dalla sua directory di origine piuttosto che da una copia cache. Vedi [plugin caching](/docs/it/plugins-reference#plugin-caching-and-file-resolution) 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

1516| [`themes/*.json`](#ce-themes) | Solo globale | | Temi di colore personalizzati | [Custom themes](/docs/it/terminal-config#create-a-custom-theme) |1516| [`themes/*.json`](#ce-themes) | Solo globale | | Temi di colore personalizzati | [Custom themes](/docs/it/terminal-config#create-a-custom-theme) |

1517 1517

1518<h2 id="frontmatter-fields-by-file">

1519 Campi frontmatter per file

1520</h2>

1521

1522Skills, file di comando, subagent, stili di output e regole leggono la loro configurazione da YAML [frontmatter](/docs/it/glossary#frontmatter) nella parte superiore del file, e ognuno accetta il proprio set di campi. Questa tabella elenca i nomi dei campi per ogni file e collega ai riferimenti che li descrivono.

1523

1524| File | Campi frontmatter | Riferimento |

1525| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |

1526| `skills/<name>/SKILL.md` | `name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility` | [Skill frontmatter](/docs/it/skills#frontmatter-reference) |

1527| `commands/*.md` | I campi skill eccetto `name` e `paths` | [Skill frontmatter](/docs/it/skills#frontmatter-reference) |

1528| `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental` | [Subagent frontmatter](/docs/it/sub-agents#supported-frontmatter-fields) |

1529| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [Output style frontmatter](/docs/it/output-styles#frontmatter) |

1530| `rules/*.md` | `paths` | [Rule frontmatter](/docs/it/memory#rules-frontmatter-reference) |

1531

1532Gli agenti forniti in un [plugin](/docs/it/plugins-reference#plugin-agent-frontmatter) rispettano un sottoinsieme dei campi subagent.

1533

1518<h2 id="troubleshoot-configuration">1534<h2 id="troubleshoot-configuration">

1519 Risolvi i problemi di configurazione1535 Risolvi i problemi di configurazione

1520</h2>1536</h2>

1534Claude Code elimina i file nei percorsi di seguito una volta che sono più vecchi di [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), purché possa determinare in modo sicuro il periodo di conservazione. L'impostazione predefinita è 30 giorni e il minimo è 1; impostare `0` genera un errore di convalida. Lo stesso limite di età si applica alla rimozione automatica dei [worktrees orfani](/docs/it/worktrees#clean-up-subagent-and-background-session-worktrees).1550Claude Code elimina i file nei percorsi di seguito una volta che sono più vecchi di [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), purché possa determinare in modo sicuro il periodo di conservazione. L'impostazione predefinita è 30 giorni e il minimo è 1; impostare `0` genera un errore di convalida. Lo stesso limite di età si applica alla rimozione automatica dei [worktrees orfani](/docs/it/worktrees#clean-up-subagent-and-background-session-worktrees).

1535 1551

1537| ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1553| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1538| `projects/<project>/<session>.jsonl` | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |1554| `projects/<project>/<session>.jsonl` | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |

1539| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Una trascrizione precedente per la sessione che Claude Code ha messo da parte invece di sovrascriverla o eliminarla. Non appare nel selettore di sessione |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Una trascrizione precedente per la sessione che Claude Code ha messo da parte invece di sovrascriverla o eliminarla. Non appare nel selettore di sessione |

1540| `projects/<project>/<session>/subagents/` | Trascrizioni di conversazione [Subagent](/docs/it/sub-agents), rimosse con la trascrizione della sessione padre quando scade |1556| `projects/<project>/<session>/subagents/` | Trascrizioni di conversazione [Subagent](/docs/it/sub-agents), rimosse con la trascrizione della sessione padre quando scade |

1543| `plans/` | File di piano scritti durante la [Plan Mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) |1559| `plans/` | File di piano scritti durante la [Plan Mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) |

1544| `debug/` | Log di debug per sessione, scritti mentre il debug logging è attivo, ad esempio quando inizi con [`--debug`](/docs/it/cli-reference#cli-flags) o esegui `/debug` |1560| `debug/` | Log di debug per sessione, scritti mentre il debug logging è attivo, ad esempio quando inizi con [`--debug`](/docs/it/cli-reference#cli-flags) o esegui `/debug` |

1546| `image-cache/<session>/` | Immagini allegate. Ad ogni pulizia, Claude Code rimuove le directory di tutte le altre sessioni, indipendentemente dalla loro età. |1562| `image-cache/<session>/` | Immagini allegate salvate da Claude Code v2.1.274 e versioni precedenti. Le versioni successive salvano le immagini incollate e allegate al di fuori di `~/.claude`, in una directory `images/` per ogni sessione nella directory temporanea che [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) controlla. La pulizia rimuove le directory di altre sessioni rimaste qui, indipendentemente dalla loro età. |

1547| `uploads/<session>/` | File che allega dal web o dall'app mobile, e foto che allega dall'app mobile, quando messaggia una sessione [Remote Control](/docs/it/remote-control). Un allegato a una [sessione cloud](/docs/it/claude-code-on-the-web) viene salvato nell'ambiente cloud della sessione stessa, non sulla tua macchina. |1563| `uploads/<session>/` | File che allega dal web o dall'app mobile, e foto che allega dall'app mobile, quando messaggia una sessione [Remote Control](/docs/it/remote-control). Un allegato a una [sessione cloud](/docs/it/claude-code-on-the-web) viene salvato nell'ambiente cloud della sessione stessa, non sulla tua macchina. |

1552| `feedback-bundles/` | Archivi di trascrizione redatti scritti da `/feedback` su provider di terze parti o quando nessuna credenziale Anthropic è configurata, per l'invio al tuo team di account Anthropic |1568| `feedback-bundles/` | Archivi di trascrizione redatti scritti da `/feedback` su provider di terze parti o quando nessuna credenziale Anthropic è configurata, per l'invio al tuo team di account Anthropic |

1553| `feedback/drafts/` | [Feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) in coda in attesa della tua revisione in `/feedback`. Pulito dopo `cleanupPeriodDays` o 30 giorni, a seconda di quale sia più breve. Quando la coda raggiunge il limite di 10 bozze, Claude Code elimina la bozza più vecchia per fare spazio. |1569| `feedback/drafts/` | [Feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) in coda in attesa della tua revisione in `/feedback`. Pulito dopo `cleanupPeriodDays` o 30 giorni, a seconda di quale sia più breve. Quando la coda raggiunge il limite di 10 bozze, Claude Code elimina la bozza più vecchia per fare spazio. |

1554| `usage-data/` | `report.html` e copie di report con timestamp scritte da [`/insights`](/docs/it/costs#analyze-your-usage-patterns), più dati di analisi per sessione memorizzati nella cache utilizzati per costruirli |1570| `usage-data/` | `report.html` e copie di report con timestamp scritte da [`/insights`](/docs/it/costs#analyze-your-usage-patterns), più dati di analisi per sessione memorizzati nella cache utilizzati per costruirli |

1555| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/it/skills#how-synced-skills-behave) e [plugins](/docs/it/plugins-reference#synced-plugins) sincronizzati da claude.ai che Claude Code ha rimosso. Spostati qui invece di essere eliminati in modo che tu possa recuperare i file |1571| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/it/skills#how-synced-skills-behave) e [plugins](/docs/it/plugins-reference#synced-plugins) sincronizzati da claude.ai che Claude Code ha rimosso, ad esempio dopo che ne hai disattivato uno su claude.ai o hai smesso di sincronizzare. I file rimangono qui in modo che tu possa recuperarli fino a quando la pulizia non li elimina |

1556| `todos/`, `statsig/`, `logs/` | Directory legacy da versioni precedenti. Non più scritte. La pulizia rimuove i loro contenuti e poi la directory vuota. |1572| `todos/`, `statsig/`, `logs/` | Directory legacy da versioni precedenti. Non più scritte. La pulizia rimuove i loro contenuti e poi la directory vuota. |

1557 1573

1558I file di sessione in `sessions/`, la memoria automatica e le trascrizioni di Claude Desktop e Cowork seguono ciascuno la propria regola di conservazione:1574I file di sessione in `sessions/`, la memoria automatica e le trascrizioni di Claude Desktop e Cowork seguono ciascuno la propria regola di conservazione:

1610* Righe di prompt corrispondenti in `history.jsonl`1626* Righe di prompt corrispondenti in `history.jsonl`

1611* La voce del progetto in `~/.claude.json`1627* La voce del progetto in `~/.claude.json`

1612 1628

1629Le immagini che hai incollato o allegato nelle sessioni del progetto sono archiviate nella directory temporanea di Claude Code piuttosto che in `~/.claude`, quindi la pulizia non le rimuove. La [pulizia della conservazione](#cleaned-up-automatically) le elimina una volta che sono più vecchie di `cleanupPeriodDays`.

1630

1613Il comando stampa il piano di eliminazione completo e chiede conferma prima di rimuovere qualsiasi cosa.1631Il comando stampa il piano di eliminazione completo e chiede conferma prima di rimuovere qualsiasi cosa.

1614 1632

1615Gli esempi di seguito utilizzano `~/work/my-repo` come segnaposto. Sostituiscilo con il percorso del tuo progetto. Se nessuno stato corrisponde al percorso, il comando stampa un errore e esce con stato 1.1633Gli esempi di seguito utilizzano `~/work/my-repo` come segnaposto. Sostituiscilo con il percorso del tuo progetto. Se nessuno stato corrisponde al percorso, il comando stampa un errore e esce con stato 1.

1660Puoi anche eliminare manualmente uno qualsiasi dei percorsi di dati dell'applicazione sopra, a parte i [file di stato da mantenere](#state-files-to-keep). Le nuove sessioni non sono interessate. La tabella di seguito mostra cosa perdi per le sessioni passate.1678Puoi anche eliminare manualmente uno qualsiasi dei percorsi di dati dell'applicazione sopra, a parte i [file di stato da mantenere](#state-files-to-keep). Le nuove sessioni non sono interessate. La tabella di seguito mostra cosa perdi per le sessioni passate.

1661 1679

1662| Elimina | Perdi |1680| Elimina | Perdi |

1663| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1681| -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1664| `~/.claude/projects/` | Ripresa, continuazione e rewind per le sessioni passate, e memoria automatica per ogni progetto |1682| `~/.claude/projects/` | Ripresa, continuazione e rewind per le sessioni passate, e memoria automatica per ogni progetto |

1665| `~/.claude/history.jsonl` | Richiamo del prompt con freccia su, ricerca nella cronologia `Ctrl+R` e completamento dei comandi shell `!` |1683| `~/.claude/history.jsonl` | Richiamo del prompt con freccia su, ricerca nella cronologia `Ctrl+R` e completamento dei comandi shell `!` |

1666| `~/.claude/paste-cache/` | Testo incollato nei prompt richiamati; vedi [incolla contenuto di grandi dimensioni](/docs/it/terminal-config#paste-large-content) |1684| `~/.claude/paste-cache/` | Testo incollato nei prompt richiamati; vedi [incolla contenuto di grandi dimensioni](/docs/it/terminal-config#paste-large-content) |

1677| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | La possibilità di recuperare [skills sincronizzate](/docs/it/skills#how-synced-skills-behave) e [plugins sincronizzati](/docs/it/plugins-reference#synced-plugins) che Claude Code ha rimosso |1695| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | La possibilità di recuperare [skills sincronizzate](/docs/it/skills#how-synced-skills-behave) e [plugins sincronizzati](/docs/it/plugins-reference#synced-plugins) che Claude Code ha rimosso |

1678| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/image-cache/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Nulla di visibile all'utente |1696| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Nulla di visibile all'utente |

1679| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/` | Nulla. Directory legacy non scritte dalle versioni correnti. |1697| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Nulla. Directory legacy non scritte dalle versioni correnti. |

1680 1698

1681Non eliminare `~/.claude.json`, `~/.claude/settings.json` o `~/.claude/plugins/`: contengono la tua autenticazione, preferenze e plugin installati.1699Non eliminare `~/.claude.json`, `~/.claude/settings.json` o `~/.claude/plugins/`: contengono la tua autenticazione, preferenze e plugin installati.

1682 1700

claude-platform-on-aws.md +1 −1

Details

282 282

283Claude Platform on AWS utilizza gli stessi ID modello dell'API Claude diretta.283Claude Platform on AWS utilizza gli stessi ID modello dell'API Claude diretta.

284 284

285Gli alias predefiniti `fable`, `opus`, `sonnet` e `haiku` si risolvono alle impostazioni predefinite integrate di Claude Code per Claude Platform on AWS, che possono essere in ritardo rispetto alla versione più recente. Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` si risolve in Opus 5. Prima della v2.1.219, si risolveva in Opus 4.8, e prima della v2.1.207 in Opus 4.7.285Gli alias predefiniti `fable`, `opus`, `sonnet` e `haiku` si risolvono alle impostazioni predefinite integrate di Claude Code per Claude Platform on AWS, che possono essere in ritardo rispetto alla versione più recente. Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` si risolve in Opus 5.5. Prima della v2.1.280, si risolveva in Opus 5 dalla v2.1.219, in Opus 4.8 dalla v2.1.207, e in Opus 4.7 prima di ciò.

286 286

287Se si distribuisce Claude Code a un team, fissare esplicitamente gli ID modello in modo che un nuovo rilascio non sposti tutti contemporaneamente:287Se si distribuisce Claude Code a un team, fissare esplicitamente gli ID modello in modo che un nuovo rilascio non sposti tutti contemporaneamente:

288 288

claude-projects.md +42 −42

Details

56* **Thread**: i lavoratori. Ognuno è una [sessione cloud](/docs/it/claude-code-on-the-web) separata con la propria finestra di contesto che fa un pezzo di lavoro sul proprio branch, apre una pull request quando il lavoro lo richiede, e riporta alla conversazione quando finisce.56* **Thread**: i lavoratori. Ognuno è una [sessione cloud](/docs/it/claude-code-on-the-web) separata con la propria finestra di contesto che fa un pezzo di lavoro sul proprio branch, apre una pull request quando il lavoro lo richiede, e riporta alla conversazione quando finisce.

57* **Quello con cui ogni thread inizia**:57* **Quello con cui ogni thread inizia**:

58 * I repository e i file del project, più le sue [istruzioni e memoria](#give-a-project-standing-context)58 * I repository e i file del project, più le sue [istruzioni e memoria](#give-a-project-standing-context)

59 * Il `CLAUDE.md`, le skills e i plugins in [ognuno dei repository del project](#what-threads-pick-up-from-your-repositories), e in un project con un repository, anche le regole di permesso e gli hook di quel repository59 * Il `CLAUDE.md` e le skills in [ognuno dei repository del project](#what-threads-pick-up-from-your-repositories), e in un project con un repository, anche le regole di permesso e gli hook di quel repository

60 * I [connectors](#get-skills-plugins-connectors-and-tools-into-threads) sul tuo account claude.ai60 * I [connectors](#get-skills-plugins-connectors-and-tools-into-threads) sul tuo account claude.ai

61 * Un [cloud environment](#choose-an-environment-for-threads) che imposta il suo accesso di rete, le variabili di ambiente, le credenziali API e gli strumenti installati61 * Un [cloud environment](#choose-an-environment-for-threads) che imposta il suo accesso di rete, le variabili di ambiente, le credenziali API e gli strumenti installati

62* **Il riquadro Overview**: dove [vedi tutti i thread contemporaneamente](#see-what-needs-you-in-overview) e quali di loro ti servono. Le sue altre schede sono **Library** per i file che hai aggiunto e i file che i thread hanno prodotto, **Pull requests** per quelli che i thread hanno aperto, e **Routines** per il lavoro programmato nel project.62* **Il riquadro Overview**: dove [vedi tutti i thread contemporaneamente](#see-what-needs-you-in-overview) e quali di loro ti servono. Le sue altre schede sono **Library** per i file che hai aggiunto e i file che i thread hanno prodotto, **Pull requests** per quelli che i thread hanno aperto, e **Routines** per il lavoro programmato nel project.

276Ogni approvazione copre quel prompt, o il resto di quel thread se scegli l'opzione più ampia. Per lasciare che ogni thread esegua determinati comandi senza chiedere, o per bloccarne alcuni, aggiungi [regole di permesso](/docs/it/permissions) al `.claude/settings.json` del repository. I thread le applicano solo in un project con un repository; vedi [Cosa i thread raccolgono dai tuoi repository](#what-threads-pick-up-from-your-repositories).276Ogni approvazione copre quel prompt, o il resto di quel thread se scegli l'opzione più ampia. Per lasciare che ogni thread esegua determinati comandi senza chiedere, o per bloccarne alcuni, aggiungi [regole di permesso](/docs/it/permissions) al `.claude/settings.json` del repository. I thread le applicano solo in un project con un repository; vedi [Cosa i thread raccolgono dai tuoi repository](#what-threads-pick-up-from-your-repositories).

277 277

278<h2 id="give-a-project-standing-context">278<h2 id="give-a-project-standing-context">

279 Dai a un project un contesto permanente279 Fornire contesto permanente al progetto

280</h2>280</h2>

281 281

282La project memory, le istruzioni del project e i repository, i file e l'ambiente del project portano il contesto attraverso i thread. Imposti ognuno una volta e si applica a ogni nuovo thread.282La memoria del progetto, le istruzioni del progetto e i repository, i file e l'ambiente del progetto portano il contesto tra i thread. Imposti ciascuno una sola volta e si applica a ogni nuovo thread.

283 283

285| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |285| :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

286| Project memory | Note che Claude tiene sul project, come requisiti, decisioni e ostacoli, memorizzate come file. Ogni thread legge il file di indice `MEMORY.md` quando inizia e apre gli altri file quando ne ha bisogno | Chiedi a Claude nella conversazione del project o in qualsiasi thread di ricordare un requisito, una decisione o un ostacolo, o di dimenticarne uno. Leggi, modifica ed elimina i file in **Project settings > Memory** |286| Memoria del progetto | Note che Claude mantiene sul progetto, come requisiti, decisioni e insidie, archiviate come file. Ogni thread legge il file di indice `MEMORY.md` quando inizia e apre gli altri file quando ne ha bisogno | Chiedi a Claude nella conversazione del progetto o in qualsiasi thread di ricordare un requisito, una decisione o un'insidia, oppure di dimenticarla. Leggi, modifica ed elimina i file in **Project settings > Memory** |

287| Project instructions | Testo inviato a ogni nuovo thread e a Claude nella conversazione del project, fino a 16.000 caratteri. [Scrivi le istruzioni del project](#write-project-instructions) copre cosa metterci | **Project settings > Memory > Project instructions**, o chiedi a Claude di cambiare le istruzioni |287| Istruzioni del progetto | Testo inviato a ogni nuovo thread e a Claude nella conversazione del progetto, fino a 16.000 caratteri. [Write project instructions](#write-project-instructions) copre cosa inserirvi | **Project settings > Memory > Project instructions**, oppure chiedi a Claude di modificare le istruzioni |

288| Repository, file e ambiente | I repository che ogni thread clona, le cartelle e i file che ogni thread può leggere sotto `/mnt/project-files`, e il cloud environment in cui i thread vengono eseguiti | Repository e ambiente in **Project settings > Environment**, o chiedi a Claude nella conversazione di aggiungere un repository al project. File e cartelle da **Add** sulla scheda **Library** in **Overview** |288| Repository, file e ambiente | I repository che ogni thread clona, le cartelle e i file che ogni thread può leggere in `/mnt/project-files`, e l'ambiente cloud in cui vengono eseguiti i thread | Repository e ambiente in **Project settings > Environment**, oppure chiedi a Claude nella conversazione di aggiungere un repository al progetto. File e cartelle da **Add** nella scheda **Library** in **Overview** |

289 289

290**Project settings > Memory** elenca questi file sotto **Auto memory**, perché Claude li scrive da solo mentre lavora nel project. Sono separati dalla [auto memory](/docs/it/memory) che Claude Code tiene sulla tua macchina, anche se entrambi usano un indice `MEMORY.md`. La project memory è anche separata dai file `CLAUDE.md` nei repository del project. Ogni thread legge ancora quei file `CLAUDE.md` dal suo clone quando inizia, quindi metti le istruzioni su un repository nel suo `CLAUDE.md` e le note sul project nella project memory.290**Project settings > Memory** elenca questi file in **Auto memory**, perché Claude li scrive da solo mentre lavora nel progetto. Sono separati dall'[auto memory](/docs/it/memory) che Claude Code mantiene sulla tua macchina, anche se entrambi utilizzano un indice `MEMORY.md`. La memoria del progetto è anche separata dai file `CLAUDE.md` nei repository del progetto. Ogni thread legge comunque quei file `CLAUDE.md` dal suo clone quando inizia, quindi inserisci le istruzioni su un repository nel suo `CLAUDE.md` e le note sul progetto nella memoria del progetto.

291 291

292<h3 id="write-project-instructions">292<h3 id="write-project-instructions">

293 Scrivi le istruzioni del project293 Scrivi le istruzioni del progetto

294</h3>294</h3>

295 295

296Le istruzioni del project sono il briefing da cui ogni nuovo thread inizia. Fai clic sull'icona dell'ingranaggio nell'intestazione del project per aprire **Project settings**, quindi vai a **Memory > Project instructions**. Un briefing utile copre:296Le istruzioni del progetto sono il briefing da cui ogni nuovo thread inizia. Fai clic sull'icona dell'ingranaggio nell'intestazione del progetto per aprire **Project settings**, quindi vai a **Memory > Project instructions**. Un briefing utile copre:

297 297

298* A cosa serve il project298* A cosa serve il progetto

299* Dove accade il lavoro: quali repository, quale branch da cui iniziare, come denominare le pull request299* Dove avviene il lavoro: quali repository, da quale branch iniziare, come denominare le pull request

300* Come un thread controlla il suo lavoro prima di chiamarlo fatto300* Come un thread verifica il proprio lavoro prima di considerarlo completato

301* Cosa fare quando qualcosa di cui ha bisogno manca301* Cosa fare quando manca qualcosa di cui ha bisogno

302* Cosa ha bisogno della tua approvazione prima302* Cosa ha bisogno della tua approvazione prima

303 303

304Ad esempio:304Ad esempio:

305 305

306```text theme={null}306```text theme={null}

307Questo project mantiene la latenza p95 per l'API dei pagamenti sotto 200 ms: profiling, correzioni di query e caching, e gli aggiornamenti delle dipendenze che vengono con loro, nel repository payments-api.307Questo progetto mantiene la latenza p95 per l'API dei pagamenti sotto 200 ms: profiling, correzioni di query e caching, e gli upgrade delle dipendenze che ne derivano, nel repository payments-api.

308 308

309- Crea un branch da main e apri una pull request in bozza per thread.309- Crea un branch da main e apri una pull request in bozza per thread.

310- Prima di chiamare il lavoro fatto, esegui `make test` e `make lint` e incolla le righe di riepilogo nel tuo messaggio finale.310- Prima di considerare il lavoro completato, esegui `make test` e `make lint` e incolla le righe di riepilogo nel tuo messaggio finale.

311- Se non puoi raggiungere qualcosa di cui hai bisogno, come un repository, un segreto, un'API o un connector, dì esattamente cosa manca nel tuo primo messaggio e fermati. Non sostituire, simulare o indovinare.311- Se non riesci a raggiungere qualcosa di cui hai bisogno, come un repository, un secret, un'API o un connettore, dichiara esattamente cosa manca nel tuo primo messaggio e fermati. Non sostituire, simulare o indovinare.

312- Non unire, force-push o cambiare la configurazione CI senza chiedermi nel thread.312- Non eseguire merge, force-push o modificare la configurazione CI senza chiedermi nel thread.

313```313```

314 314

315Le regole su un repository, come i suoi comandi di build, appartengono al `CLAUDE.md` di quel repository, che ogni thread legge quando il repository fa parte del project. Una volta che il lavoro è in corso, quando correggi un thread, dì anche a Claude di ricordare la correzione: va in [project memory](#give-a-project-standing-context) e i thread successivi iniziano con essa.315Le regole su un repository, come i suoi comandi di build, appartengono al `CLAUDE.md` di quel repository, che ogni thread legge quando il repository fa parte del progetto. Una volta che il lavoro è in corso, quando correggi un thread, chiedi anche a Claude di ricordare la correzione: va nella [memoria del progetto](#give-a-project-standing-context) e i thread successivi iniziano con essa.

316 316

317<h3 id="decide-which-repositories-to-add">317<h3 id="decide-which-repositories-to-add">

318 Decidi quali repository aggiungere318 Decidi quali repository aggiungere

319</h3>319</h3>

320 320

321I repository che aggiungi a un project vengono con tutto in loro, il loro codice, `CLAUDE.md` e skills, in ogni thread. I repository che non aggiungi sono ancora a portata di mano: un thread può aggiungerne uno a se stesso quando il suo compito ne ha bisogno. La maggior parte dei project usa entrambi:321I repository che aggiungi a un progetto vengono forniti con tutto ciò che contengono, il loro codice, `CLAUDE.md` e skills, in ogni thread. I repository che non aggiungi sono comunque raggiungibili: un thread può aggiungerne uno a se stesso quando il suo compito lo richiede. La maggior parte dei progetti utilizza entrambi:

322 322

323* **Aggiungilo al project**, nella finestra di dialogo **New project**, in **Project settings > Environment**, o chiedendo a Claude nella conversazione di aggiungerlo al project. Ogni thread da allora in poi lo clona e inizia con il suo `CLAUDE.md` e le skills caricate, indipendentemente dal fatto che il compito lo tocchi. Passare da un repository a più repository cambia anche cosa i thread prendono dal `.claude/settings.json` di ogni repository; vedi [Cosa i thread raccolgono dai tuoi repository](#what-threads-pick-up-from-your-repositories).323* **Aggiungilo al progetto**, nella finestra di dialogo **New project**, in **Project settings > Environment**, oppure chiedendo a Claude nella conversazione di aggiungerlo al progetto. Ogni thread da quel momento in poi lo clona e inizia con il suo `CLAUDE.md` e le sue skills caricati, indipendentemente dal fatto che il compito lo tocchi o meno. Passare da un repository a diversi cambia anche ciò che i thread prendono dal `.claude/settings.json` di ogni repository; vedi [What threads pick up from your repositories](#what-threads-pick-up-from-your-repositories).

324* **Lascialo fuori e lascia che i thread lo aggiungano quando necessario.** Un thread il cui compito ha bisogno di un repository che il project non ha può aggiungerlo a se stesso, e una nota nel thread dice che è stato aggiunto solo a questo thread. Il clone accade a metà del compito, quindi il `CLAUDE.md` e le skills di quel repository non erano lì quando il thread è iniziato. Il thread successivo inizia senza di esso di nuovo. Un repository che un thread aggiunge ha bisogno degli stessi [prerequisiti](#check-the-prerequisites) di un repository del project: l'app Claude GitHub installata su di esso e accesso push dal tuo account GitHub.324* **Lascialo fuori e lascia che i thread lo aggiungano quando necessario.** Un thread il cui compito richiede un repository che il progetto non ha può aggiungerlo a se stesso, e una nota nel thread dice che è stato aggiunto solo a questo thread. Il clone avviene a metà del compito, quindi il `CLAUDE.md` e le skills di quel repository non erano presenti quando il thread è iniziato. Il thread successivo inizia di nuovo senza di esso. Un repository che un thread aggiunge ha bisogno degli stessi [prerequisiti](#check-the-prerequisites) di un repository del progetto: l'app GitHub di Claude installata su di esso e accesso push dal tuo account GitHub.

325 325

326Un project non ha bisogno di un repository affatto. I suoi thread possono ancora ricercare, scrivere documenti e scrivere ed eseguire codice nella loro sandbox, e consegnano file alla scheda **Library**. Un thread lì può anche aggiungere un repository a se stesso quando un compito lo richiede.326Un progetto non ha bisogno di un repository affatto. I suoi thread possono comunque fare ricerche, scrivere documenti, scrivere ed eseguire codice nella loro sandbox, e consegnare file alla scheda **Library**. Un thread lì può anche aggiungere un repository a se stesso quando un compito lo richiede.

327 327

328Una volta che il project ha repository, Claude può solo aggiungere repository da un proprietario GitHub che il project usa già, indipendentemente dal fatto che lo aggiunga al project o un thread lo aggiunga a se stesso. Per portare un repository da un proprietario diverso, aggiungilo al project da solo in **Project settings > Environment**.328Una volta che il progetto ha repository, Claude può aggiungere solo repository da un proprietario GitHub che il progetto già utilizza, sia che aggiunga uno al progetto sia che un thread ne aggiunga uno a se stesso. Per portare un repository da un proprietario diverso, aggiungilo tu stesso al progetto in **Project settings > Environment**.

329 329

330Per un project che copre molti repository, come una funzione con codice server, web, mobile e desktop, aggiungi uno o due repository che quasi ogni compito tocca e nomina gli altri nelle [istruzioni del project](#write-project-instructions) in modo che Claude sappia dove vive il resto del codice. I thread iniziano quindi piccoli e tirano gli altri repository solo per i compiti che ne hanno bisogno.330Per un progetto che si estende su molti repository, come una funzionalità con codice server, web, mobile e desktop, aggiungi uno o due repository che quasi ogni compito tocca e nomina gli altri nelle [istruzioni del progetto](#write-project-instructions) in modo che Claude sappia dove vive il resto del codice. I thread iniziano quindi in piccolo e tirano in gli altri repository solo per i compiti che ne hanno bisogno.

331 331

332<h3 id="what-threads-pick-up-from-your-repositories">332<h3 id="what-threads-pick-up-from-your-repositories">

333 Cosa i thread raccolgono dai tuoi repository333 Cosa i thread prendono dai tuoi repository

334</h3>334</h3>

335 335

336Ogni thread clona ogni repository nel project e carica `CLAUDE.md`, skills e plugins da tutti loro. Le regole di permesso, gli hook e `env` vengono solo dal `.claude/settings.json` nella directory in cui il thread inizia: dentro il repository quando il project ne ha uno, e sopra i cloni quando ne ha più di uno, dove il file di nessun repository viene letto per loro.336Ogni thread clona ogni repository nel progetto e carica `CLAUDE.md` e skills da tutti loro. Le regole di permesso, gli hook e `env` provengono solo dal `.claude/settings.json` nella directory in cui il thread inizia: all'interno del repository quando il progetto ne ha uno, e sopra i cloni quando ne ha diversi, dove il file di nessun repository viene letto per loro.

337 337

339| :------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------ |339| :------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------- |

342| Plugin abilitati in `.claude/settings.json` | Caricati | Caricati da ogni repository. Se due repository non sono d'accordo su un plugin, impostalo in **Project settings > Plugins**, che ha la precedenza |342| Plugin abilitati in `.claude/settings.json` | Non caricati. Aggiungi il plugin in **Project settings > Plugins** | Non caricati. Aggiungi il plugin in **Project settings > Plugins** |

343| Regole di permesso, hook e `env` definiti in `.claude/settings.json` | Si applicano al thread, tranne le chiavi `env` che [nessuna sessione cloud onora](/docs/it/cloud-environments#what-carries-over-from-your-setup) | Non si applicano |343| Regole di permesso, hook e `env` definiti in `.claude/settings.json` | Si applicano al thread, tranne le chiavi `env` che [nessuna sessione cloud onora](/docs/it/cloud-environments#what-carries-over-from-your-setup) | Non si applicano |

344 344

345In un project con più repository, ogni clone è allegato al thread come una [directory aggiuntiva](/docs/it/memory#load-from-additional-directories) con il caricamento di `CLAUDE.md` attivato, che è il motivo per cui il `CLAUDE.md` e le skills di ogni repository si caricano all'inizio anche se il thread inizia sopra di loro. In entrambi i casi, gli hook che un plugin abilitato fornisce ancora vengono eseguiti, poiché i plugin si caricano da ogni repository. In un project con più repository, metti le regole permanenti nelle istruzioni del project e dai ai thread le variabili di ambiente attraverso il [cloud environment](#choose-an-environment-for-threads).345In un progetto con diversi repository, ogni clone è collegato al thread come una [directory aggiuntiva](/docs/it/memory#load-from-additional-directories) con il caricamento di `CLAUDE.md` attivato, motivo per cui il `CLAUDE.md` e le skills di ogni repository si caricano all'avvio anche se il thread inizia sopra di loro. In un tale progetto, inserisci le regole permanenti nelle istruzioni del progetto e fornisci ai thread le variabili di ambiente attraverso l'[ambiente cloud](#choose-an-environment-for-threads).

346 346

347<h3 id="choose-an-environment-for-threads">347<h3 id="choose-an-environment-for-threads">

348 Scegli un ambiente per i thread348 Scegli un ambiente per i thread

349</h3>349</h3>

350 350

351Ogni nuovo thread inizia nel [cloud environment](/docs/it/cloud-environments) del project. L'ambiente imposta quali domini i thread possono raggiungere, quali variabili di ambiente hanno, quali credenziali API vengono aggiunte alle loro richieste e cosa lo script di configurazione installa prima che Claude inizi. I thread usano un ambiente predefinito ospitato da Anthropic finché non ne scegli uno in **Project settings > Environment**.351Ogni nuovo thread inizia nell'[ambiente cloud](/docs/it/cloud-environments) del progetto. L'ambiente imposta quali domini i thread possono raggiungere, quali variabili di ambiente hanno, quali credenziali API vengono aggiunte alle loro richieste, e cosa lo script di setup installa prima che Claude inizi. I thread utilizzano un ambiente predefinito ospitato da Anthropic fino a quando non ne scegli uno in **Project settings > Environment**.

352 352

353Se i thread hanno bisogno di raggiungere un'API interna o un registro di pacchetti privato, o hanno bisogno di un token che la tua macchina normalmente tiene, cambia l'ambiente piuttosto che il project: vedi [Accesso di rete](/docs/it/cloud-environments#network-access), [Aggiungi credenziali API](/docs/it/cloud-environments#add-api-credentials) e [Script di configurazione](/docs/it/cloud-environments#setup-scripts).353Se i thread hanno bisogno di raggiungere un'API interna o un registro di pacchetti privato, o hanno bisogno di un token che la tua macchina normalmente contiene, cambia l'ambiente piuttosto che il progetto: vedi [Network access](/docs/it/cloud-environments#network-access), [Add API credentials](/docs/it/cloud-environments#add-api-credentials), e [Setup scripts](/docs/it/cloud-environments#setup-scripts).

354 354

355<h3 id="get-skills-plugins-connectors-and-tools-into-threads">355<h3 id="get-skills-plugins-connectors-and-tools-into-threads">

356 Ottieni skills, plugins, connectors e strumenti nei thread356 Ottieni skills, plugin, connettori e strumenti nei thread

357</h3>357</h3>

358 358

359I thread sono sessioni cloud, quindi non hanno le skills, i server MCP, i plugins e gli strumenti installati solo sulla tua macchina. Per rendere ognuno di questi disponibile ai thread:359I thread sono sessioni cloud, quindi non hanno le skills, i server MCP, i plugin e gli strumenti installati solo sulla tua macchina. Per rendere ciascuno di questi disponibile ai thread:

360 360

361* Skills, subagenti e comandi: committili a un repository che hai aggiunto al project, ad esempio una skill su `.claude/skills/<skill-name>/SKILL.md`. Ogni thread clona ogni repository nel project e carica `.claude/skills/`, `.claude/agents/` e `.claude/commands/` da ognuno di loro, quindi una skill committata a un repository è disponibile in ogni nuovo thread. I thread caricano anche le skills che abiliti per il tuo account claude.ai.361* Skills, subagenti e comandi: eseguine il commit in un repository che hai aggiunto al progetto, ad esempio una skill in `.claude/skills/<skill-name>/SKILL.md`. Ogni thread clona ogni repository nel progetto e carica `.claude/skills/`, `.claude/agents/` e `.claude/commands/` da ciascuno di loro, quindi una skill sottoposta a commit in un repository è disponibile in ogni nuovo thread. I thread caricano anche le skills che abiliti per il tuo account claude.ai.

362* Plugin: aggiungili in **Project settings > Plugins**; si caricano in ogni nuovo thread. I plugin che un repository dichiara nel suo `.claude/settings.json` si caricano anche; vedi [Cosa si trasporta dalla tua configurazione](/docs/it/cloud-environments#what-carries-over-from-your-setup).362* Plugin: aggiungili in **Project settings > Plugins**; si caricano in ogni nuovo thread. I plugin che un repository dichiara nel suo `.claude/settings.json` [non si caricano nei thread](/docs/it/cloud-environments#what-carries-over-from-your-setup), perché i thread sono sessioni cloud.

363* Server MCP: i thread ottengono i loro strumenti MCP dai connectors sul tuo account claude.ai, che sono server MCP che connetti una volta su [claude.ai/customize/connectors](https://claude.ai/customize/connectors) o attraverso il link **Manage connectors** in **Project settings > Environment**. Ogni thread può usarli tutti senza configurazione per project. La conversazione del project stessa non ha connectors, quindi invia il lavoro che ne ha bisogno come compito per un thread. In un project con un repository, i thread caricano anche i server MCP dal [`.mcp.json`](/docs/it/cloud-environments#what-carries-over-from-your-setup) di quel repository. [Come i connectors raggiungono Claude Code](/docs/it/mcp#how-connectors-reach-claude-code) elenca le regole per le sessioni cloud e le impostazioni che disattivano i connectors.363* Server MCP: i thread ottengono i loro strumenti MCP dai connettori sul tuo account claude.ai, che sono server MCP che colleghi una volta in [claude.ai/customize/connectors](https://claude.ai/customize/connectors) o attraverso il link **Manage connectors** in **Project settings > Environment**. Ogni thread può utilizzarli tutti senza alcuna configurazione per progetto. La conversazione del progetto stessa non ha connettori, quindi invia il lavoro che ne richiede uno come compito per un thread. In un progetto con un repository, i thread caricano anche i server MCP dal [`.mcp.json`](/docs/it/cloud-environments#what-carries-over-from-your-setup) di quel repository. [How connectors reach Claude Code](/docs/it/mcp#how-connectors-reach-claude-code) elenca le regole per le sessioni cloud e le impostazioni che disattivano i connettori.

364* Strumenti da riga di comando e pacchetti: installali nello [script di configurazione](/docs/it/cloud-environments#setup-scripts) dell'ambiente.364* Strumenti da riga di comando e pacchetti: installali nello [script di setup](/docs/it/cloud-environments#setup-scripts) dell'ambiente.

365 365

366Per vedere quali connectors ha un thread in esecuzione su claude.ai/code, apri il thread e seleziona **Connectors** dal menu **+** accanto alla sua casella di messaggio. Disattivare un connector lì lo rimuove da quel thread e rimane disattivato per i thread avviati in seguito finché non lo riattivi. Un thread raccoglie un connector che aggiungi o riconnetti dopo il prossimo messaggio che gli invii.366Per vedere quali connettori ha un thread in esecuzione in claude.ai/code, apri il thread e seleziona **Connectors** dal menu **+** accanto alla sua casella di messaggio. Disattivare un connettore lì lo rimuove da quel thread e lo salva come impostazione predefinita del tuo account, quindi i nuovi thread e le chat claude.ai iniziano senza di esso fino a quando non lo riattivi. Un thread raccoglie un connettore che aggiungi o riconnetti dopo il prossimo messaggio che gli invii.

367 367

368<h2 id="project-settings-reference">368<h2 id="project-settings-reference">

369 Riferimento delle impostazioni del project369 Riferimento delle impostazioni del project

cli-reference.md +4 −2

Details

93| `--exec` | Esegui un comando shell come lavoro in background supportato da PTY invece di avviare una sessione Claude. Usa con `--bg` per lanciare dalla shell | `claude --bg --exec 'pytest -x'` |93| `--exec` | Esegui un comando shell come lavoro in background supportato da PTY invece di avviare una sessione Claude. Usa con `--bg` per lanciare dalla shell | `claude --bg --exec 'pytest -x'` |

94| `--fallback-model` | Abilita il fallback automatico al modello specificato quando il modello primario è sovraccarico o non disponibile, ad esempio un modello ritirato. Accetta un elenco separato da virgole provato in ordine. Vedi [Catene di modelli di fallback](/docs/it/model-config#fallback-model-chains). Per mantenere una catena tra le sessioni, usa l'impostazione [`fallbackModel`](/docs/it/settings-reference#fallbackmodel), che questo flag sostituisce | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | Abilita il fallback automatico al modello specificato quando il modello primario è sovraccarico o non disponibile, ad esempio un modello ritirato. Accetta un elenco separato da virgole provato in ordine. Vedi [Catene di modelli di fallback](/docs/it/model-config#fallback-model-chains). Per mantenere una catena tra le sessioni, usa l'impostazione [`fallbackModel`](/docs/it/settings-reference#fallbackmodel), che questo flag sostituisce | `claude --fallback-model sonnet,haiku` |

95| `--fork-session` | Quando riprendi, crea un nuovo ID di sessione invece di riutilizzare l'originale (usa con `--resume` o `--continue`) | `claude --resume abc123 --fork-session` |95| `--fork-session` | Quando riprendi, crea un nuovo ID di sessione invece di riutilizzare l'originale (usa con `--resume` o `--continue`) | `claude --resume abc123 --fork-session` |

96| `--forward-subagent-text` | Emetti i blocchi di testo e pensiero dei [subagenti](/docs/it/sub-agents) nel flusso di output come messaggi `assistant` e `user` con `parent_tool_use_id` impostato, in modo da poter ricostruire la trascrizione di ogni subagente. Senza questo flag, Claude Code omette il testo e i blocchi di pensiero di un subagente che viene eseguito in [primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background). Richiede `--print` e `--output-format stream-json`. Claude Code inoltra anche i messaggi dai [subagenti annidati](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents), impostando `parent_tool_use_id` all'ID della chiamata dello strumento Agent che ha generato ognuno; questo richiede Claude Code v2.1.219 o successivo. La variabile di ambiente [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/it/env-vars) abilita lo stesso comportamento. Richiede Claude Code v2.1.211 o successivo | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |96| `--forward-subagent-text` | Emetti i blocchi di testo e pensiero dei [subagenti](/docs/it/sub-agents) nel flusso di output come messaggi `assistant` e `user` con `parent_tool_use_id` impostato, in modo da poter ricostruire la trascrizione di ogni subagente. Senza questo flag, Claude Code omette il testo e i blocchi di pensiero di un subagente che viene eseguito in [primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background). Richiede `--print` e `--output-format stream-json`. Claude Code inoltra anche i messaggi dai [subagenti annidati](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents), impostando `parent_tool_use_id` all'ID della chiamata dello strumento Agent o Skill che ha generato ognuno; questo richiede Claude Code v2.1.219 o successivo, e i messaggi dei subagenti che una skill biforcata genera, e delle skill biforcate annidate, richiedono v2.1.275 o successivo. La variabile di ambiente [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/it/env-vars) abilita lo stesso comportamento. Richiede Claude Code v2.1.211 o successivo | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

97| `--from-pr` | Apri il selettore di sessione filtrato alle sessioni collegate a una richiesta pull specifica. Accetta un numero PR, un URL PR GitHub o GitHub Enterprise, un URL di richiesta di merge GitLab, o un URL di richiesta pull Bitbucket. Le sessioni vengono collegate automaticamente quando Claude crea la richiesta pull | `claude --from-pr 123` |97| `--from-pr` | Apri il selettore di sessione filtrato alle sessioni collegate a una richiesta pull specifica. Accetta un numero PR, un URL PR GitHub o GitHub Enterprise, un URL di richiesta di merge GitLab, o un URL di richiesta pull Bitbucket. Le sessioni vengono collegate automaticamente quando Claude crea la richiesta pull | `claude --from-pr 123` |

98| `--ide` | Connettiti automaticamente all'IDE all'avvio se esattamente un IDE valido è disponibile | `claude --ide` |98| `--ide` | Connettiti automaticamente all'IDE all'avvio se esattamente un IDE valido è disponibile | `claude --ide` |

103| `--input-format` | Specifica il formato di input per la modalità print (opzioni: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |103| `--input-format` | Specifica il formato di input per la modalità print (opzioni: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

104| `--json-schema` | Ottieni output JSON convalidato corrispondente a uno JSON Schema dopo che l'agente completa il suo flusso di lavoro (solo modalità print). Vedi [output strutturati](/docs/it/agent-sdk/structured-outputs). Claude Code esce con un errore su uno schema non valido e accetta la parola chiave `format` come annotazione senza convalida lato client | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |104| `--json-schema` | Ottieni output JSON convalidato corrispondente a uno JSON Schema dopo che l'agente completa il suo flusso di lavoro (solo modalità print). Vedi [output strutturati](/docs/it/agent-sdk/structured-outputs). Claude Code esce con un errore su uno schema non valido e accetta la parola chiave `format` come annotazione senza convalida lato client | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

105| `--maintenance` | Esegui gli [hook di Setup](/docs/it/hooks#setup) con il matcher `maintenance` prima della sessione (solo modalità print) | `claude -p --maintenance "query"` |105| `--maintenance` | Esegui gli [hook di Setup](/docs/it/hooks#setup) con il matcher `maintenance` prima della sessione (solo modalità print) | `claude -p --maintenance "query"` |

106| `--max-budget-usd` | Importo massimo in dollari da spendere nelle chiamate API prima di fermarsi (solo modalità print). La spesa dai [subagenti](/docs/it/sub-agents) conta verso il limite. Una volta che la spesa raggiunge il limite, generare un altro subagente fallisce con `Budget limit reached`, e Claude Code ferma i subagenti in background ancora in esecuzione; i comportamenti di applicazione del limite richiedono Claude Code v2.1.217 o successivo | `claude -p --max-budget-usd 5.00 "query"` |106| `--max-budget-usd` | Importo massimo in dollari da spendere nelle chiamate API prima di fermarsi (solo modalità print). La spesa dai [subagenti](/docs/it/sub-agents) conta verso il limite. Quando torni a una conversazione con `--continue` o `--resume`, i totali [ripristinati da esecuzioni precedenti](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) non contano verso di esso. Una volta che la spesa raggiunge il limite, generare un altro subagente fallisce con `Budget limit reached`, e Claude Code ferma i subagenti in background ancora in esecuzione; i comportamenti di applicazione del limite richiedono Claude Code v2.1.217 o successivo | `claude -p --max-budget-usd 5.00 "query"` |

107| `--max-turns` | Limita il numero di turni agentici (solo modalità print). Esce con un errore quando il limite viene raggiunto. Nessun limite per impostazione predefinita. Con `--input-format stream-json`, un messaggio ancora in coda quando il limite termina un turno rimane in coda e inizia un nuovo turno con il suo proprio limite | `claude -p --max-turns 3 "query"` |107| `--max-turns` | Limita il numero di turni agentici (solo modalità print). Esce con un errore quando il limite viene raggiunto. Nessun limite per impostazione predefinita. Con `--input-format stream-json`, un messaggio ancora in coda quando il limite termina un turno rimane in coda e inizia un nuovo turno con il suo proprio limite | `claude -p --max-turns 3 "query"` |

108| `--mcp-config` | Carica i server MCP da file JSON o stringhe (separati da spazi). Quando passi questo flag con `-p`, Claude Code attende che i server ancora in sospeso si connettano prima di eseguire il primo turno, fino al timeout di avvio [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita; un server con un [elenco di strumenti memorizzato nella cache](/docs/it/mcp#managing-your-servers) salta l'attesa e si connette al primo utilizzo. L'attesa richiede Claude Code v2.1.221 o successivo | `claude --mcp-config ./mcp.json` |108| `--mcp-config` | Carica i server MCP da file JSON o stringhe (separati da spazi). Quando passi questo flag con `-p`, Claude Code attende che i server ancora in sospeso si connettano prima di eseguire il primo turno, fino al timeout di avvio [`MCP_TIMEOUT`](/docs/it/env-vars), 30 secondi per impostazione predefinita; un server con un [elenco di strumenti memorizzato nella cache](/docs/it/mcp#managing-your-servers) salta l'attesa e si connette al primo utilizzo. L'attesa richiede Claude Code v2.1.221 o successivo | `claude --mcp-config ./mcp.json` |

109| `--model` | Imposta il modello per la sessione corrente con un [alias di modello](/docs/it/model-config#model-aliases) come `sonnet`, `opus`, `haiku`, o `fable`, o il nome completo di un modello. Sostituisce l'impostazione [`model`](/docs/it/settings-reference#model) e [`ANTHROPIC_MODEL`](/docs/it/model-config#environment-variables) | `claude --model claude-sonnet-5` |109| `--model` | Imposta il modello per la sessione corrente con un [alias di modello](/docs/it/model-config#model-aliases) come `sonnet`, `opus`, `haiku`, o `fable`, o il nome completo di un modello. Sostituisce l'impostazione [`model`](/docs/it/settings-reference#model) e [`ANTHROPIC_MODEL`](/docs/it/model-config#environment-variables) | `claude --model claude-sonnet-5` |

157 157

158`--system-prompt` e `--system-prompt-file` si escludono a vicenda. I flag di aggiunta possono essere combinati con uno dei flag di sostituzione.158`--system-prompt` e `--system-prompt-file` si escludono a vicenda. I flag di aggiunta possono essere combinati con uno dei flag di sostituzione.

159 159

160Quando il testo di sostituzione combina istruzioni che sono le stesse su ogni esecuzione con contesto che cambia per esecuzione, aggiungi una riga contenente solo `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` tra le istruzioni e il contesto. Claude Code divide il prompt alla prima riga di questo tipo e rimuove quella riga, quindi la parte sopra rimane memorizzata nella cache mentre la parte sotto cambia. Richiede Claude Code v2.1.275 o successivo. [Memorizza nella cache la parte statica di un prompt personalizzato](/docs/it/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) elenca le configurazioni dove la divisione si applica.

161

160Scegli in base al fatto che l'identità predefinita di Claude Code si adatti ancora al tuo compito. Usa un flag di aggiunta quando Claude dovrebbe rimanere un assistente di codifica che segue anche le tue regole extra: istruzioni per invocazione, formattazione dell'output, o contesto di dominio per uno script `-p`. L'aggiunta preserva la guida dello strumento predefinito, le istruzioni di sicurezza e le convenzioni di codifica, quindi fornisci solo quello che differisce. Usa un flag di sostituzione quando la superficie, l'identità, o il modello di permesso differisce da quello di Claude Code, come un agente non di codifica in una pipeline che nessun umano guarda. La sostituzione elimina l'intero prompt predefinito, inclusa la guida dello strumento e le istruzioni di sicurezza, quindi assumi la responsabilità di qualsiasi cosa il tuo compito abbia ancora bisogno.162Scegli in base al fatto che l'identità predefinita di Claude Code si adatti ancora al tuo compito. Usa un flag di aggiunta quando Claude dovrebbe rimanere un assistente di codifica che segue anche le tue regole extra: istruzioni per invocazione, formattazione dell'output, o contesto di dominio per uno script `-p`. L'aggiunta preserva la guida dello strumento predefinito, le istruzioni di sicurezza e le convenzioni di codifica, quindi fornisci solo quello che differisce. Usa un flag di sostituzione quando la superficie, l'identità, o il modello di permesso differisce da quello di Claude Code, come un agente non di codifica in una pipeline che nessun umano guarda. La sostituzione elimina l'intero prompt predefinito, inclusa la guida dello strumento e le istruzioni di sicurezza, quindi assumi la responsabilità di qualsiasi cosa il tuo compito abbia ancora bisogno.

161 163

162Per persone persistenti che puoi alternare e condividere tra un progetto, usa gli [stili di output](/docs/it/output-styles). Per le convenzioni di progetto che Claude dovrebbe sempre seguire, usa [CLAUDE.md](/docs/it/memory). La [guida dell'Agent SDK sui prompt di sistema](/docs/it/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) copre la stessa decisione in maggiore profondità.164Per persone persistenti che puoi alternare e condividere tra un progetto, usa gli [stili di output](/docs/it/output-styles). Per le convenzioni di progetto che Claude dovrebbe sempre seguire, usa [CLAUDE.md](/docs/it/memory). La [guida dell'Agent SDK sui prompt di sistema](/docs/it/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) copre la stessa decisione in maggiore profondità.

cloud-environments.md +2 −2

Details

301| Il vostro `.claude/rules/` del repository | Sì | Parte del clone |301| Il vostro `.claude/rules/` del repository | Sì | Parte del clone |

302| Il vostro `.claude/skills/`, `.claude/agents/`, `.claude/commands/` del repository | Sì | Parte del clone |302| Il vostro `.claude/skills/`, `.claude/agents/`, `.claude/commands/` del repository | Sì | Parte del clone |

303| Plugin dichiarati in `.claude/settings.json` | Sì | Installati all'avvio della sessione dal [marketplace](/docs/it/plugin-marketplaces) che avete dichiarato. Richiede accesso di rete per raggiungere la fonte del marketplace |303| Plugin e marketplace dichiarati nel vostro `.claude/settings.json` del repository | No | Una sessione cloud non installa i plugin che un repository attiva sotto [`enabledPlugins`](/docs/it/settings-reference#enabledplugins), inclusi quelli dai marketplace che elenca sotto [`extraKnownMarketplaces`](/docs/it/settings-reference#extraknownmarketplaces). Abilitate il plugin per il vostro account claude.ai invece, in modo che Claude Code lo carichi come [plugin sincronizzato](/docs/it/plugins-reference#synced-plugins) |

304| Le [impostazioni gestite dal server](/docs/it/server-managed-settings) della vostra organizzazione | Sì | Recuperate dai server di Anthropic quando la sessione inizia. Consultate [Copertura della superficie](/docs/it/model-config#surface-coverage) per come `availableModels` viene applicato nelle sessioni cloud. Le impostazioni distribuite al vostro dispositivo tramite MDM o file di impostazioni gestite non si applicano, perché la sessione viene eseguita su una VM gestita da Anthropic; in un [ambiente self-hosted](/docs/it/self-hosted-environments), le sessioni leggono anche il file di impostazioni gestite nell'immagine runner, per [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) |304| Le [impostazioni gestite dal server](/docs/it/server-managed-settings) della vostra organizzazione | Sì | Recuperate dai server di Anthropic quando la sessione inizia. Consultate [Copertura della superficie](/docs/it/model-config#surface-coverage) per come `availableModels` viene applicato nelle sessioni cloud. Le impostazioni distribuite al vostro dispositivo tramite MDM o file di impostazioni gestite non si applicano, perché la sessione viene eseguita su una VM gestita da Anthropic; in un [ambiente self-hosted](/docs/it/self-hosted-environments), le sessioni leggono anche il file di impostazioni gestite nell'immagine runner, per [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) |

305| Il vostro `~/.claude/CLAUDE.md` utente | No | Vive sulla vostra macchina, non nel repository |305| Il vostro `~/.claude/CLAUDE.md` utente | No | Vive sulla vostra macchina, non nel repository |

306| Il vostro `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utente | No | Vivono sulla vostra macchina, non nel repository. Sottoponete a commit nel directory `.claude/` del repository. Le sessioni cloud caricano automaticamente le skill che abilitate su claude.ai |306| Il vostro `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` utente | No | Vivono sulla vostra macchina, non nel repository. Sottoponete a commit nel directory `.claude/` del repository. Le sessioni cloud caricano automaticamente le skill che abilitate su claude.ai |

307| Plugin abilitati solo nelle vostre impostazioni utente | No | L'`enabledPlugins` con ambito utente vive in `~/.claude/settings.json`. Dichiarateli nel `.claude/settings.json` del repository, o abilitateli per il vostro account claude.ai in modo che Claude Code li carichi come [plugin sincronizzati](/docs/it/plugins-reference#synced-plugins) |307| Plugin abilitati solo nelle vostre impostazioni utente | No | L'`enabledPlugins` con ambito utente vive in `~/.claude/settings.json` sulla vostra macchina. Abilitateli per il vostro account claude.ai invece, in modo che Claude Code li carichi come [plugin sincronizzati](/docs/it/plugins-reference#synced-plugins) |

308| Server MCP che avete aggiunto con `claude mcp add` all'ambito locale predefinito o all'ambito utente | No | Quelli scrivono su `~/.claude.json` sulla vostra macchina, non nel repository. Aggiungete il server con `claude mcp add --scope project`, che scrive il [`.mcp.json`](/docs/it/mcp#project-scope) del repository, e sottoponete a commit quel file. Una sessione con un repository lo carica |308| Server MCP che avete aggiunto con `claude mcp add` all'ambito locale predefinito o all'ambito utente | No | Quelli scrivono su `~/.claude.json` sulla vostra macchina, non nel repository. Aggiungete il server con `claude mcp add --scope project`, che scrive il [`.mcp.json`](/docs/it/mcp#project-scope) del repository, e sottoponete a commit quel file. Una sessione con un repository lo carica |

309| Variabili di trasporto nel vostro blocco `env` di `.claude/settings.json` del repository, come `NODE_EXTRA_CA_CERTS` e le [variabili del certificato client mTLS](/docs/it/network-config#mtls-authentication) | No | L'ambiente di hosting gestisce la connessione API della sessione, quindi Claude Code ignora queste chiavi e annota ogni chiave ignorata nel log di debug della sessione |309| Variabili di trasporto nel vostro blocco `env` di `.claude/settings.json` del repository, come `NODE_EXTRA_CA_CERTS` e le [variabili del certificato client mTLS](/docs/it/network-config#mtls-authentication) | No | L'ambiente di hosting gestisce la connessione API della sessione, quindi Claude Code ignora queste chiavi e annota ogni chiave ignorata nel log di debug della sessione |

310| Chiavi API e token per i servizi che Claude chiama | Sui piani Pro e Max, come [credenziali API](#add-api-credentials) | Aggiungete la chiave una volta sull'ambiente e il proxy dell'agente la allega alle richieste per gli host che elencate. Una chiave che il proxy dell'agente [non può allegare](#requests-that-never-get-the-credential), o qualsiasi chiave su un piano Team o Enterprise, rimane in una variabile di ambiente |310| Chiavi API e token per i servizi che Claude chiama | Sui piani Pro e Max, come [credenziali API](#add-api-credentials) | Aggiungete la chiave una volta sull'ambiente e il proxy dell'agente la allega alle richieste per gli host che elencate. Una chiave che il proxy dell'agente [non può allegare](#requests-that-never-get-the-credential), o qualsiasi chiave su un piano Team o Enterprise, rimane in una variabile di ambiente |

commands.md +6 −5

Details

26 26

27**Eseguire il lavoro in parallelo.** Claude delega i compiti laterali ai [subagenti](/docs/it/sub-agents), e `/tasks` elenca il lavoro in background della sessione corrente, inclusi i subagenti che hanno terminato. `/background` scollega l'intera sessione per continuare l'esecuzione come [agente in background](/docs/it/agent-view) e libera il terminale. Per una modifica di grandi dimensioni che si estende su tutto il codebase, `/batch` la scompone in unità indipendenti ed esegue ciascuna nel proprio [worktree](/docs/it/worktrees). Vedere [Eseguire agenti in parallelo](/docs/it/agents) per come questi approcci si relazionano.27**Eseguire il lavoro in parallelo.** Claude delega i compiti laterali ai [subagenti](/docs/it/sub-agents), e `/tasks` elenca il lavoro in background della sessione corrente, inclusi i subagenti che hanno terminato. `/background` scollega l'intera sessione per continuare l'esecuzione come [agente in background](/docs/it/agent-view) e libera il terminale. Per una modifica di grandi dimensioni che si estende su tutto il codebase, `/batch` la scompone in unità indipendenti ed esegue ciascuna nel proprio [worktree](/docs/it/worktrees). Vedere [Eseguire agenti in parallelo](/docs/it/agents) per come questi approcci si relazionano.

28 28

29**Prima di rilasciare.** `/diff` mostra cosa è cambiato. `/code-review` controlla il diff corrente per bug di correttezza e pulizie e può applicare i risultati con `--fix`; passare un numero di PR, come `/code-review high 1234`, per rivedere una pull request. `/review` è un alias. `/code-review ultra` esegue una revisione multi-agente nel cloud. `/security-review` controlla il diff per vulnerabilità di sicurezza.29**Prima di rilasciare.** `/diff` mostra cosa è cambiato. `/code-review` controlla il diff corrente per bug di correttezza e può applicare i risultati con `--fix`; passare un numero di PR, come `/code-review high 1234`, per rivedere una pull request. `/review` è un alias. `/code-review ultra` esegue una revisione multi-agente nel cloud. `/security-review` controlla il diff per vulnerabilità di sicurezza.

30 30

31**Tra le sessioni.** `/clear` inizia da zero su un nuovo compito mantenendo la memoria del progetto. `/resume` ritorna a una conversazione precedente, `/branch` crea un ramo di quella corrente per provare una direzione diversa, e `/fork` la copia in una nuova [sessione in background](/docs/it/agent-view). `/teleport` estrae una sessione web in questo terminale, e `/remote-control` consente di continuare questa sessione locale da un altro dispositivo.31**Tra le sessioni.** `/clear` inizia da zero su un nuovo compito mantenendo la memoria del progetto. `/resume` ritorna a una conversazione precedente, `/branch` crea un ramo di quella corrente per provare una direzione diversa, e `/fork` la copia in una nuova [sessione in background](/docs/it/agent-view). `/teleport` estrae una sessione web in questo terminale, e `/remote-control` consente di continuare questa sessione locale da un altro dispositivo.

32 32

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/it/skills#bundled-skills).** Caricare il materiale di riferimento di [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) per il linguaggio del vostro progetto. Si attiva anche automaticamente quando il vostro codice importa `anthropic` o `@anthropic-ai/sdk`. Eseguite `migrate` per aggiornare il codice Claude API esistente a un modello più recente. Eseguite `upgrade` per spostare la dipendenza Anthropic SDK del vostro progetto attraverso una versione principale, attualmente il pacchetto Python `anthropic` da 0.x a 1.x. Eseguite `managed-agents-onboard` per una procedura guidata che crea un nuovo Managed Agent. Eseguite `prompt-audit` per contrassegnare le istruzioni scritte per modelli più vecchi nei vostri prompt, skill e descrizioni di strumenti e proporre correzioni come diff. Eseguite `cost-optimize` per profilare dove va la spesa Claude API del vostro progetto e proporre risparmi da opzioni come prompt caching, riduzione di token di input e output non necessari, elaborazione batch, sforzo e scelta del modello, una modifica alla volta. Eseguite `build-eval` per costruire un set di eval per la vostra app basata su Claude, e `hillclimb` per migliorare iterativamente l'app rispetto a un eval esistente. Il sottocomando `prompt-audit` richiede Claude Code v2.1.221 o successivo, `upgrade` richiede v2.1.236 o successivo, `cost-optimize` richiede v2.1.247 o successivo, e `build-eval` e `hillclimb` richiedono v2.1.259 o successivo |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/it/skills#bundled-skills).** Caricare il materiale di riferimento di [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) per il linguaggio del vostro progetto. Si attiva anche automaticamente quando il vostro codice importa `anthropic` o `@anthropic-ai/sdk`. Eseguite `migrate` per aggiornare il codice Claude API esistente a un modello più recente. Eseguite `upgrade` per spostare la dipendenza Anthropic SDK del vostro progetto attraverso una versione principale, attualmente il pacchetto Python `anthropic` da 0.x a 1.x. Eseguite `managed-agents-onboard` per una procedura guidata che crea un nuovo Managed Agent. Eseguite `prompt-audit` per contrassegnare le istruzioni scritte per modelli più vecchi nei vostri prompt, skill e descrizioni di strumenti e proporre correzioni come diff. Eseguite `cost-optimize` per profilare dove va la spesa Claude API del vostro progetto e proporre risparmi da opzioni come prompt caching, riduzione di token di input e output non necessari, elaborazione batch, sforzo e scelta del modello, una modifica alla volta. Eseguite `build-eval` per costruire un set di eval per la vostra app basata su Claude, e `hillclimb` per migliorare iterativamente l'app rispetto a un eval esistente. Il sottocomando `prompt-audit` richiede Claude Code v2.1.221 o successivo, `upgrade` richiede v2.1.236 o successivo, `cost-optimize` richiede v2.1.247 o successivo, e `build-eval` e `hillclimb` richiedono v2.1.259 o successivo |

71| `/clear [name]` | Avviare una nuova conversazione con contesto vuoto. Passate un nome per etichettare la conversazione precedente nel selettore `/resume`. Per liberare contesto continuando la stessa conversazione, usate `/compact` invece. Riprendete la conversazione precedente con `/resume`, o, nello stesso processo Claude Code, ripristinatela dal [menu di rewind della voce sessione precedente](/docs/it/checkpointing#rewind-past-a-cleared-conversation). La voce di rewind richiede Claude Code v2.1.191 o successivo. Alias: `/reset`, `/new` |71| `/clear [name]` | Avviare una nuova conversazione con contesto vuoto. Passate un nome per etichettare la conversazione precedente nel selettore `/resume`. Per liberare contesto continuando la stessa conversazione, usate `/compact` invece. Riprendete la conversazione precedente con `/resume`, o, nello stesso processo Claude Code, ripristinatela dal [menu di rewind della voce sessione precedente](/docs/it/checkpointing#rewind-past-a-cleared-conversation). La voce di rewind richiede Claude Code v2.1.191 o successivo. Alias: `/reset`, `/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/it/skills#bundled-skills).** Rivedere il diff corrente, o un numero PR, ramo o percorso che passate, per bug di correttezza e opportunità di pulizia. Passate `--fix` per applicare i risultati, `--comment` per pubblicarli sulla PR GitHub o sulla merge request GitLab, o `ultra` per eseguire una profonda [revisione cloud](/docs/it/ultrareview). La pubblicazione su una merge request GitLab richiede Claude Code v2.1.257 o successivo. Con `ultra` su un target PR `github.com`, passate `--post` per preselezionare [la pubblicazione dei risultati finiti sulla PR](/docs/it/ultrareview#post-findings-to-the-pull-request) nella finestra di dialogo di avvio; `--post` richiede Claude Code v2.1.227 o successivo. Consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per i livelli di sforzo, il targeting e come si relaziona a `/simplify`. Alias: `/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/it/skills#bundled-skills).** Rivedere il diff corrente, o un numero PR, ramo o percorso che passate, per bug di correttezza. A seconda del vostro modello e livello di sforzo, la revisione copre anche opportunità di pulizia. Passate `--fix` per applicare i risultati, `--comment` per pubblicarli sulla PR GitHub o sulla merge request GitLab, o `ultra` per eseguire una profonda [revisione cloud](/docs/it/ultrareview). La pubblicazione su una merge request GitLab richiede Claude Code v2.1.257 o successivo. Con `ultra` su un target PR `github.com`, passate `--post` per preselezionare [la pubblicazione dei risultati finiti sulla PR](/docs/it/ultrareview#post-findings-to-the-pull-request) nella finestra di dialogo di avvio; `--post` richiede Claude Code v2.1.227 o successivo. Consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per i livelli di sforzo, il targeting e come si relaziona a `/simplify`. Alias: `/review` |

73| `/color [color\|default]` | Impostare il colore della barra dei prompt per la sessione corrente. Colori disponibili: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Usate `default` per ripristinare, o eseguite senza argomento per scegliere un colore casuale. Quando [Remote Control](/docs/it/remote-control) è connesso, il colore si sincronizza con claude.ai/code. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo |73| `/color [color\|default]` | Impostare il colore della barra dei prompt per la sessione corrente. Colori disponibili: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Usate `default` per ripristinare, o eseguite senza argomento per scegliere un colore casuale. Quando [Remote Control](/docs/it/remote-control) è connesso, il colore si sincronizza con claude.ai/code. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo |

74| `/compact [instructions]` | Liberare contesto riassumendo la conversazione finora. Facoltativamente passate istruzioni di focus per il riassunto. Consultate [come la compattazione gestisce regole, skill e file di memoria](/docs/it/context-window#what-survives-compaction) |74| `/compact [instructions]` | Liberare contesto riassumendo la conversazione finora. Facoltativamente passate istruzioni di focus per il riassunto. Consultate [come la compattazione gestisce regole, skill e file di memoria](/docs/it/context-window#what-survives-compaction) |

75| `/config [key=value ...]` | Aprire l'interfaccia [Impostazioni](/docs/it/settings) per regolare tema, modello, [stile di output](/docs/it/output-styles) e altre preferenze. Passate una o più coppie `key=value` per impostare un'impostazione direttamente senza aprire l'interfaccia, ad esempio `/config thinking=false`, `/config theme=dark`, o `/config model=sonnet`. La forma `key=value` funziona anche in modalità non interattiva (`-p`) e dall'app mobile Claude tramite [Remote Control](/docs/it/remote-control). La forma `key=value` non può attivare un'impostazione che richiede la vostra conferma nel pannello, come [`autoContinueAtUsageLimit`](/docs/it/interactive-mode#turn-automatic-continue-off), anche se può disattivarla. Eseguite `/config --help` per elencare le chiavi che accetta. Alias: `/settings` |75| `/config [key=value ...]` | Aprire l'interfaccia [Impostazioni](/docs/it/settings) per regolare tema, modello, [stile di output](/docs/it/output-styles) e altre preferenze. Passate una o più coppie `key=value` per impostare un'impostazione direttamente senza aprire l'interfaccia, ad esempio `/config thinking=false`, `/config theme=dark`, o `/config model=sonnet`. La forma `key=value` funziona anche in modalità non interattiva (`-p`) e dall'app mobile Claude tramite [Remote Control](/docs/it/remote-control). La forma `key=value` non può attivare un'impostazione che richiede la vostra conferma nel pannello, come [`autoContinueAtUsageLimit`](/docs/it/interactive-mode#turn-automatic-continue-off), anche se può disattivarla. Eseguite `/config --help` per elencare le chiavi che accetta. Alias: `/settings` |

85| `/desktop` | Continuare la sessione corrente nell'app Claude Code Desktop. Richiede macOS o Windows x64 e un abbonamento Claude. Alias: `/app` |85| `/desktop` | Continuare la sessione corrente nell'app Claude Code Desktop. Richiede macOS o Windows x64 e un abbonamento Claude. Alias: `/app` |

86| `/diff` | Rivedere le modifiche nel vostro albero di lavoro, inclusi i modifica che Claude ha fatto finora. Consultate [Rivedere le modifiche con /diff](/docs/it/interactive-mode#review-changes-with-%2Fdiff) |86| `/diff` | Rivedere le modifiche nel vostro albero di lavoro, inclusi i modifica che Claude ha fatto finora. Consultate [Rivedere le modifiche con /diff](/docs/it/interactive-mode#review-changes-with-%2Fdiff) |

87| `/doctor` | **[Skill](/docs/it/skills#bundled-skills).** Eseguire un controllo di configurazione che diagnostica i problemi e può risolverli. Controlla la salute dell'installazione, incluse installazioni duplicate o rimaste, problemi di `PATH` e file di impostazioni non analizzabili. Trova skill inutilizzate, server MCP e plugin rispetto al loro costo di contesto, contrassegna [hook](/docs/it/hooks) lenti e controlla una versione più recente sul vostro [canale di rilascio](/docs/it/setup#configure-release-channel). Deduplica i file `CLAUDE.md` locali rispetto a quelli archiviati, taglia i file [`CLAUDE.md`](/docs/it/memory#my-claude-md-is-too-large) archiviati tagliando il contenuto che Claude potrebbe derivare dal codebase, e migra la guida sempre caricata che rimane in [skill](/docs/it/skills) e file `CLAUDE.md` annidati che si caricano su richiesta. Offre anche di rendere [auto mode](/docs/it/permissions#permission-modes) il vostro predefinito e di [pre-approvare](/docs/it/permissions) comandi di sola lettura frequentemente negati. Segnala i risultati per primo e chiede conferma prima di cambiare qualsiasi cosa. Dal terminale, `claude doctor` stampa diagnostica di installazione di sola lettura senza avviare una sessione. Alias: `/checkup`. Il controllo di ridimensionamento `CLAUDE.md` richiede Claude Code v2.1.206 o successivo. Prima della v2.1.205, `/doctor` apriva una schermata di diagnostica di sola lettura e premere `f` inviava il rapporto a Claude |87| `/doctor` | **[Skill](/docs/it/skills#bundled-skills).** Eseguire un controllo di configurazione che diagnostica i problemi e può risolverli. Controlla la salute dell'installazione, incluse installazioni duplicate o rimaste, problemi di `PATH` e file di impostazioni non analizzabili. Trova skill inutilizzate, server MCP e plugin rispetto al loro costo di contesto, contrassegna [hook](/docs/it/hooks) lenti e controlla una versione più recente sul vostro [canale di rilascio](/docs/it/setup#configure-release-channel). Deduplica i file `CLAUDE.md` locali rispetto a quelli archiviati, taglia i file [`CLAUDE.md`](/docs/it/memory#my-claude-md-is-too-large) archiviati tagliando il contenuto che Claude potrebbe derivare dal codebase, e migra la guida sempre caricata che rimane in [skill](/docs/it/skills) e file `CLAUDE.md` annidati che si caricano su richiesta. Offre anche di rendere [auto mode](/docs/it/permissions#permission-modes) il vostro predefinito e di [pre-approvare](/docs/it/permissions) comandi di sola lettura frequentemente negati. Segnala i risultati per primo e chiede conferma prima di cambiare qualsiasi cosa. Dal terminale, `claude doctor` stampa diagnostica di installazione di sola lettura senza avviare una sessione. Alias: `/checkup`. Il controllo di ridimensionamento `CLAUDE.md` richiede Claude Code v2.1.206 o successivo. Prima della v2.1.205, `/doctor` apriva una schermata di diagnostica di sola lettura e premere `f` inviava il rapporto a Claude |

88| `/effort [level\|auto\|status]` | Impostare il [livello di sforzo](/docs/it/model-config#adjust-effort-level): `low` a `xhigh`, `max`, [`ultracode`](/docs/it/workflows#let-claude-decide-with-ultracode), o `auto`; `status` lo stampa. `max` e `ultracode` sono solo per sessione; la chiave [`ultracode`](/docs/it/settings-reference#ultracode) persiste. Eseguitelo mentre Claude sta rispondendo e, una volta confermato l'[avviso di cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla prossima richiesta in quel turno. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Funziona in `-p` al di fuori del [blocco di sforzo](/docs/it/model-config#adjust-effort-level) |88| `/effort [level\|auto\|status]` | Impostare il [livello di sforzo](/docs/it/model-config#adjust-effort-level): `low` a `xhigh`, `max`, [`ultracode`](/docs/it/workflows#let-claude-decide-with-ultracode), o `auto`; `status` lo stampa. `max` e `ultracode` sono solo per sessione; la chiave [`ultracode`](/docs/it/settings-reference#ultracode) persiste. Eseguitelo mentre Claude sta rispondendo e, una volta confermato l'[avviso di cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla prossima richiesta in quel turno. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Funziona in `-p` |

89| `/exit` | Uscire dalla CLI. In una [sessione in background](/docs/it/agent-view#attach-to-a-session) allegata, questo stacca e la sessione continua a funzionare. Alias: `/quit` |89| `/exit` | Uscire dalla CLI. In una [sessione in background](/docs/it/agent-view#attach-to-a-session) allegata, questo stacca e la sessione continua a funzionare. Alias: `/quit` |

90| `/export [filename]` | Esportare la conversazione corrente come testo semplice. Con un nome file, scrive direttamente in quel file. Senza, apre una finestra di dialogo per copiare negli appunti o salvare in un file |90| `/export [filename]` | Esportare la conversazione corrente come testo semplice. Con un nome file, scrive direttamente in quel file. Senza, apre una finestra di dialogo per copiare negli appunti o salvare in un file |

91| `/fast [on\|off]` | Attivare o disattivare la [modalità veloce](/docs/it/fast-mode). Eseguitelo mentre Claude sta rispondendo e Claude Code attiva la modalità veloce senza aspettare che il turno finisca, anche se il turno in esecuzione finisce alla sua velocità originale. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). La disponibilità in modalità non interattiva con `-p` è limitata; consultate [Attivare la modalità veloce](/docs/it/fast-mode#toggle-fast-mode). Richiede Claude Code v2.1.205 o successivo |91| `/fast [on\|off]` | Attivare o disattivare la [modalità veloce](/docs/it/fast-mode). Eseguitelo mentre Claude sta rispondendo e Claude Code attiva la modalità veloce senza aspettare che il turno finisca, anche se il turno in esecuzione finisce alla sua velocità originale. Prima della v2.1.242, Claude Code ha deciso da un flag di funzionalità che ha recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo ha sempre messo in coda in una sessione che non [recupera flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching). La disponibilità in modalità non interattiva con `-p` è limitata; consultate [Attivare la modalità veloce](/docs/it/fast-mode#toggle-fast-mode). Richiede Claude Code v2.1.205 o successivo |

127| `/reload-plugins [--force]` | Ricaricare tutti i [plugin](/docs/it/plugins) attivi per applicare le modifiche in sospeso senza riavviare. Segnala i conteggi per ogni componente ricaricato e contrassegna eventuali errori di caricamento. Quando il ricaricamento cambierebbe quali strumenti MCP sono caricati e invaliderebbe la cache del prompt, il comando avverte e salta a meno che non passiate `--force`. Disponibile anche in modalità non interattiva (`-p`), l'Agent SDK e l'app desktop, dove viene eseguito solo su input digitato direttamente nella sessione e non applica le modifiche del server MCP del plugin; richiede Claude Code v2.1.260 o successivo. Consultate [Applicare le modifiche del plugin senza riavviare](/docs/it/discover-plugins#apply-plugin-changes-without-restarting) |127| `/reload-plugins [--force]` | Ricaricare tutti i [plugin](/docs/it/plugins) attivi per applicare le modifiche in sospeso senza riavviare. Segnala i conteggi per ogni componente ricaricato e contrassegna eventuali errori di caricamento. Quando il ricaricamento cambierebbe quali strumenti MCP sono caricati e invaliderebbe la cache del prompt, il comando avverte e salta a meno che non passiate `--force`. Disponibile anche in modalità non interattiva (`-p`), l'Agent SDK e l'app desktop, dove viene eseguito solo su input digitato direttamente nella sessione e non applica le modifiche del server MCP del plugin; richiede Claude Code v2.1.260 o successivo. Consultate [Applicare le modifiche del plugin senza riavviare](/docs/it/discover-plugins#apply-plugin-changes-without-restarting) |

128| `/reload-skills` | Scansionare di nuovo le directory [skill](/docs/it/skills) e comandi in modo che le skill aggiunte o modificate su disco durante la sessione diventino disponibili senza riavviare. Segnala quante skill sono disponibili e quante sono state aggiunte o rimosse |128| `/reload-skills` | Scansionare di nuovo le directory [skill](/docs/it/skills) e comandi in modo che le skill aggiunte o modificate su disco durante la sessione diventino disponibili senza riavviare. Segnala quante skill sono disponibili e quante sono state aggiunte o rimosse |

129| `/remote-control` | Rendere questa sessione disponibile per [Remote Control](/docs/it/remote-control) da claude.ai. Eseguirlo mentre disconnessi stampa che Remote Control richiede un abbonamento claude.ai e vi dice come accedere; prima della v2.1.206 segnalava `Unknown command: /remote-control`. Alias: `/rc` |129| `/remote-control` | Rendere questa sessione disponibile per [Remote Control](/docs/it/remote-control) da claude.ai. Eseguirlo mentre disconnessi stampa che Remote Control richiede un abbonamento claude.ai e vi dice come accedere; prima della v2.1.206 segnalava `Unknown command: /remote-control`. Alias: `/rc` |

130| `/remote-env` | Scegliere l'ambiente predefinito per le [sessioni cloud](/docs/it/cloud-environments#select-an-environment-from-the-cli) |130| `/remote-env` | Scegliere l'ambiente predefinito per le [sessioni cloud](/docs/it/cloud-environments#select-an-environment-from-the-cli) che avviate dalla CLI |

131| `/rename [name]` | Rinominare la sessione corrente e mostrare il nome sulla barra dei prompt. Senza un nome, genera automaticamente uno dalla cronologia della conversazione. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo. Da ogni superficie di rinomina, inclusi claude.ai e l'app desktop, Claude Code sostituisce i caratteri di controllo e invisibili nel nuovo nome con spazi e limita il nome a 200 caratteri. Se il nome è vuoto una volta rimossi i caratteri invisibili, Claude Code lo rifiuta e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. La sostituzione dei caratteri e il limite di lunghezza richiedono Claude Code v2.1.221 o successivo. Se un'altra sessione live su questa macchina utilizza già un nome che passate, Claude Code applica [una variante di esso](/docs/it/sessions#name-your-sessions) invece |131| `/rename [name]` | Rinominare la sessione corrente e mostrare il nome sulla barra dei prompt. Senza un nome, genera automaticamente uno dalla cronologia della conversazione. Disponibile anche in modalità non interattiva (`-p`); richiede Claude Code v2.1.205 o successivo. Da ogni superficie di rinomina, inclusi claude.ai e l'app desktop, Claude Code sostituisce i caratteri di controllo e invisibili nel nuovo nome con spazi e limita il nome a 200 caratteri. Se il nome è vuoto una volta rimossi i caratteri invisibili, Claude Code lo rifiuta e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. La sostituzione dei caratteri e il limite di lunghezza richiedono Claude Code v2.1.221 o successivo. Se un'altra sessione live su questa macchina utilizza già un nome che passate, Claude Code applica [una variante di esso](/docs/it/sessions#name-your-sessions) invece |

132| `/resume [session]` | Riprendere una conversazione per ID o nome, o aprire il selettore di sessione. Le [sessioni in background](/docs/it/agent-view) appaiono nel selettore contrassegnate con `bg`; una che è ancora in esecuzione non può essere ripresa qui, quindi collegatevi da `claude agents` o fermatela lì per primo. Alias: `/continue` |132| `/resume [session]` | Riprendere una conversazione per ID o nome, o aprire il selettore di sessione. Le [sessioni in background](/docs/it/agent-view) appaiono nel selettore contrassegnate con `bg`; una che è ancora in esecuzione non può essere ripresa qui, quindi collegatevi da `claude agents` o fermatela lì per primo. Alias: `/continue` |

133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias di [`/code-review`](/docs/it/code-review#review-a-diff-locally): rivede il diff corrente, o un numero PR, ramo o percorso che passate, come `/review 1234`, e accetta gli stessi livelli di sforzo e flag. Senza un livello dato, la revisione riusa l'ultimo livello `low` attraverso `max` che avete digitato; consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per le regole esatte. Per una profonda revisione cloud, usate [`/code-review ultra`](/docs/it/ultrareview). Prima della v2.1.223, `/review` era un comando separato che eseguiva una revisione di una singola passata, di sola lettura di una pull request GitHub per numero, elencando i PR aperti da cui scegliere quando eseguito senza argomento; da v2.1.186 attraverso v2.1.201, eseguiva lo stesso motore multi-agente di `/code-review medium` |133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias di [`/code-review`](/docs/it/code-review#review-a-diff-locally): rivede il diff corrente, o un numero PR, ramo o percorso che passate, come `/review 1234`, e accetta gli stessi livelli di sforzo e flag. Senza un livello dato, la revisione riusa l'ultimo livello `low` attraverso `max` che avete digitato; consultate [Rivedere un diff localmente](/docs/it/code-review#review-a-diff-locally) per le regole esatte. Per una profonda revisione cloud, usate [`/code-review ultra`](/docs/it/ultrareview). Prima della v2.1.223, `/review` era un comando separato che eseguiva una revisione di una singola passata, di sola lettura di una pull request GitHub per numero, elencando i PR aperti da cui scegliere quando eseguito senza argomento; da v2.1.186 attraverso v2.1.201, eseguiva lo stesso motore multi-agente di `/code-review medium` |

156| `/theme` | Cambiare il tema del colore. Include un'opzione `auto` che corrisponde allo sfondo chiaro o scuro del vostro terminale, varianti chiare e scure, temi accessibili ai daltonici (daltonizzati), temi ANSI che utilizzano la tavolozza dei colori del vostro terminale, e qualsiasi [tema personalizzato](/docs/it/terminal-config#create-a-custom-theme) da `~/.claude/themes/` o plugin. Selezionate **New custom theme…** per crearne uno |156| `/theme` | Cambiare il tema del colore. Include un'opzione `auto` che corrisponde allo sfondo chiaro o scuro del vostro terminale, varianti chiare e scure, temi accessibili ai daltonici (daltonizzati), temi ANSI che utilizzano la tavolozza dei colori del vostro terminale, e qualsiasi [tema personalizzato](/docs/it/terminal-config#create-a-custom-theme) da `~/.claude/themes/` o plugin. Selezionate **New custom theme…** per crearne uno |

157| `/tui [default\|fullscreen]` | Impostare il renderer dell'interfaccia utente del terminale e riavviare in esso con la vostra conversazione intatta. `fullscreen` abilita il [renderer alt-screen senza sfarfallio](/docs/it/fullscreen). Senza argomento, stampa il renderer attivo |157| `/tui [default\|fullscreen]` | Impostare il renderer dell'interfaccia utente del terminale e riavviare in esso con la vostra conversazione intatta. `fullscreen` abilita il [renderer alt-screen senza sfarfallio](/docs/it/fullscreen). Senza argomento, stampa il renderer attivo |

158| `/ultraplan <prompt>` | Rimosso. Usate [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) invece. In precedenza inviava un'attività di pianificazione a una sessione di [Claude Code sul web](/docs/it/claude-code-on-the-web) per la revisione nel vostro browser |158| `/ultraplan <prompt>` | Rimosso. Usate [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) invece. In precedenza inviava un'attività di pianificazione a una sessione di [Claude Code sul web](/docs/it/claude-code-on-the-web) per la revisione nel vostro browser |

159| `/ultrareview [PR or branch]` | Eseguire una profonda revisione del codice multi-agente in una sandbox cloud con [ultrareview](/docs/it/ultrareview). Passate un riferimento PR per rivedere quella pull request, o un nome di ramo per cambiare la base di confronto. L'invocazione preferita è ora `/code-review ultra`, e `/ultrareview` rimane come alias. Include 3 esecuzioni gratuite su Pro e Max, quindi richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |159| `/ultrareview [PR or branch]` | Eseguire una profonda revisione del codice multi-agente in una sandbox cloud con [ultrareview](/docs/it/ultrareview). Passate un riferimento PR per rivedere quella pull request, o un nome di ramo o commit per cambiare la base di confronto. L'invocazione preferita è `/code-review ultra`, e `/ultrareview` è un alias. Include 3 esecuzioni gratuite su Pro e Max, quindi richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

160| `/update-config [request]` | **[Skill](/docs/it/skills#bundled-skills).** Descrivere un cambiamento di impostazioni, come consentire un comando, impostare una variabile di ambiente, o aggiungere un [hook](/docs/it/hooks), e Claude modifica il file [`settings.json`](/docs/it/settings) corrispondente. Per opzioni come tema e modello, usate `/config` invece |

160| `/upgrade` | Aprire la pagina di aggiornamento nel vostro browser per passare a un livello di piano superiore. Quando il browser non riesce ad aprirsi, il comando mostra un prompt di accesso senza stampare l'URL |161| `/upgrade` | Aprire la pagina di aggiornamento nel vostro browser per passare a un livello di piano superiore. Quando il browser non riesce ad aprirsi, il comando mostra un prompt di accesso senza stampare l'URL |

161| `/usage` | Mostrare il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Su un piano Pro, Max, Team o Enterprise, include un [breakdown di quello che conta rispetto ai vostri limiti di piano](/docs/it/costs#plan-usage-breakdown). `/cost` e `/stats` sono alias |162| `/usage` | Mostrare il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Su un piano Pro, Max, Team o Enterprise, include un [breakdown di quello che conta rispetto ai vostri limiti di piano](/docs/it/costs#plan-usage-breakdown). `/cost` e `/stats` sono alias |

162| `/usage-credits` | Configurare i crediti di utilizzo, o richiederli dal vostro amministratore, quando raggiungete un limite. Apre le vostre [impostazioni di fatturazione dei crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription) nel browser, tranne che i membri di Team ed Enterprise senza accesso alla fatturazione inviano invece una richiesta di crediti di utilizzo al loro amministratore dalla CLI, dopo aver confermato in una finestra di dialogo che la richiesta notifica i loro amministratori. Quando nessun browser può aprire la pagina di fatturazione, ad esempio su SSH, il comando stampa l'URL da visitare invece; questo richiede Claude Code v2.1.205 o successivo, e le versioni precedenti non mostravano nulla in quel caso. In precedenza `/extra-usage` |163| `/usage-credits` | Configurare i crediti di utilizzo, o richiederli dal vostro amministratore, quando raggiungete un limite. Apre le vostre [impostazioni di fatturazione dei crediti di utilizzo](/docs/it/costs#add-usage-credits-to-your-subscription) nel browser, tranne che i membri di Team ed Enterprise senza accesso alla fatturazione inviano invece una richiesta di crediti di utilizzo al loro amministratore dalla CLI, dopo aver confermato in una finestra di dialogo che la richiesta notifica i loro amministratori. Quando nessun browser può aprire la pagina di fatturazione, ad esempio su SSH, il comando stampa l'URL da visitare invece; questo richiede Claude Code v2.1.205 o successivo, e le versioni precedenti non mostravano nulla in quel caso. In precedenza `/extra-usage` |

communications-kit.md +4 −4

Details

107 📚 Quickstart · VS Code · Corso gratuito di 1 ora107 📚 Quickstart · VS Code · Corso gratuito di 1 ora

108 https://code.claude.com/docs/it/quickstart108 https://code.claude.com/docs/it/quickstart

109 https://code.claude.com/docs/it/vs-code109 https://code.claude.com/docs/it/vs-code

110 https://anthropic.skilljar.com/claude-code-in-action110 https://academy.claude.com/courses/claude-code-in-action

111 111

112 Domande → questo thread. [Owner] è il responsabile.112 Domande → questo thread. [Owner] è il responsabile.

113 ```113 ```

232 232

233Claude Code funziona sugli stessi modelli dell'app Claude, e potete cambiare a metà sessione. *Sonnet* è il cavallo da lavoro predefinito per il lavoro di funzionalità quotidiana, bug, test e revisioni. Raggiungete *Opus* su refactor su larga scala, debug complicati o qualsiasi cosa ad alto rischio. Scendete a *Haiku* per domande rapide, formattazione e modifiche meccaniche dove la velocità vince.233Claude Code funziona sugli stessi modelli dell'app Claude, e potete cambiare a metà sessione. *Sonnet* è il cavallo da lavoro predefinito per il lavoro di funzionalità quotidiana, bug, test e revisioni. Raggiungete *Opus* su refactor su larga scala, debug complicati o qualsiasi cosa ad alto rischio. Scendete a *Haiku* per domande rapide, formattazione e modifiche meccaniche dove la velocità vince.

234 234

235*Fable* è il modello più capace per i vostri compiti più difficili e lunghi; non è il default, quindi selezionatelo con `/model fable`, e notate che i contenuti di cybersecurity e biologia ricadono automaticamente su Opus. Opus 5 esegue i suoi stessi controlli, quindi i contenuti di cybersecurity contrassegnati cambiano modello e i contenuti di biologia contrassegnati vengono rifiutati.235*Fable* è il modello più capace per i vostri compiti più difficili e lunghi; non è il default, quindi selezionatelo con `/model fable`, e notate che i contenuti di cybersecurity e biologia ricadono automaticamente su Opus. Opus 5.5 e Opus 5 eseguono i loro stessi controlli: i contenuti contrassegnati di cybersecurity cambiano modello a un Opus precedente, tranne che i contenuti di biologia contrassegnati su Opus 5 vengono rifiutati.

236 236

237*Provalo ora:* digitate `/model` e scegliete Sonnet se non l'avete già fatto. È il default giusto per la maggior parte dei compiti.237*Provalo ora:* digitate `/model` e scegliete Sonnet se non l'avete già fatto. È il default giusto per la maggior parte dei compiti.

238 238

240```240```

241 241

242| Modello | Migliore per |242| Modello | Migliore per |

243| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |243| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

244| Fable | I compiti più difficili e lunghi. Solo opt-in: selezionatelo con `/model fable`. I contenuti di cybersecurity o biologia attivano [fallback automatico del modello a Opus](/docs/it/model-config#automatic-model-fallback) |244| Fable | I compiti più difficili e lunghi. Solo opt-in: selezionatelo con `/model fable`. I contenuti di cybersecurity o biologia attivano [fallback automatico del modello a Opus](/docs/it/model-config#automatic-model-fallback) |

245| Opus | Refactor su larga scala, debug complessi, decisioni architettoniche, cambiamenti ad alto rischio. Su Opus 5, i contenuti di cybersecurity o biologia attivano [fallback automatico del modello o un rifiuto](/docs/it/model-config#automatic-model-fallback) |245| Opus | Refactor su larga scala, debug complessi, decisioni architettoniche, cambiamenti ad alto rischio. Su Opus 5.5 e Opus 5, i contenuti di cybersecurity o biologia attivano [fallback automatico del modello o un rifiuto](/docs/it/model-config#automatic-model-fallback) |

246| Sonnet | Lavoro di funzionalità quotidiana, correzioni di bug, test, documentazione, revisione del codice. Default consigliato. |246| Sonnet | Lavoro di funzionalità quotidiana, correzioni di bug, test, documentazione, revisione del codice. Default consigliato. |

247| Haiku | Domande rapide, formattazione, modifiche meccaniche, iterazione rapida |247| Haiku | Domande rapide, formattazione, modifiche meccaniche, iterazione rapida |

248 248

context-window.md +3 −2

Details

35 tokens: 280,35 tokens: 280,

36 color: '#6B6964',36 color: '#6B6964',

37 vis: 'hidden',37 vis: 'hidden',

~~38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block at the very end of the system prompt.',~~38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block.',

39 link: null39 link: null

40 }, {40 }, {

41 t: 0.08,41 t: 0.08,

1589* **Prima di digitare qualcosa**: CLAUDE.md, memoria automatica, nomi degli strumenti MCP e descrizioni delle skill si caricano tutti nel contesto. I file [AGENTS.md](/docs/it/memory#agents-md) possono caricarsi anche loro, da soli o insieme a CLAUDE.md. La tua configurazione personale potrebbe aggiungere altro qui, come uno [stile di output](/docs/it/output-styles) o testo da [`--append-system-prompt`](/docs/it/cli-reference).1589* **Prima di digitare qualcosa**: CLAUDE.md, memoria automatica, nomi degli strumenti MCP e descrizioni delle skill si caricano tutti nel contesto. I file [AGENTS.md](/docs/it/memory#agents-md) possono caricarsi anche loro, da soli o insieme a CLAUDE.md. La tua configurazione personale potrebbe aggiungere altro qui, come uno [stile di output](/docs/it/output-styles) o testo da [`--append-system-prompt`](/docs/it/cli-reference).

1590* **Mentre Claude lavora**: ogni lettura di file si aggiunge al contesto, le [regole con ambito di percorso](/docs/it/memory#path-specific-rules) si caricano automaticamente insieme ai file corrispondenti e un [hook PostToolUse](/docs/it/hooks-guide) si attiva dopo ogni modifica.1590* **Mentre Claude lavora**: ogni lettura di file si aggiunge al contesto, le [regole con ambito di percorso](/docs/it/memory#path-specific-rules) si caricano automaticamente insieme ai file corrispondenti e un [hook PostToolUse](/docs/it/hooks-guide) si attiva dopo ogni modifica.

1591* **Il prompt di follow-up**: un [subagent](/docs/it/sub-agents) gestisce la ricerca nella sua propria finestra di contesto separata, quindi le letture di file di grandi dimensioni rimangono fuori dalla tua. Solo il riepilogo e un piccolo trailer di metadati tornano indietro.1591* **Il prompt di follow-up**: un [subagent](/docs/it/sub-agents) gestisce la ricerca nella sua propria finestra di contesto separata, quindi le letture di file di grandi dimensioni rimangono fuori dalla tua. Solo il riepilogo e un piccolo trailer di metadati tornano indietro.

1592* **Alla fine**: `/compact` sostituisce la conversazione con un riepilogo strutturato. La maggior parte del contenuto di avvio si ricarica automaticamente; la tabella sottostante mostra cosa accade a ogni meccanismo.1592* **Alla fine della procedura dettagliata**: esegui `/compact`, che sostituisce la conversazione con un riepilogo strutturato. La maggior parte del contenuto di avvio si ricarica automaticamente; la tabella sottostante mostra cosa accade a ogni meccanismo.

1593 1593

1594<h2 id="what-survives-compaction">1594<h2 id="what-survives-compaction">

1595 Cosa sopravvive alla compattazione1595 Cosa sopravvive alla compattazione

1602| Prompt di sistema e stile di output | Entrambi continuano ad applicarsi |1602| Prompt di sistema e stile di output | Entrambi continuano ad applicarsi |

1603| CLAUDE.md nella radice del progetto e regole senza ambito | Reinizializzato dal disco |1603| CLAUDE.md nella radice del progetto e regole senza ambito | Reinizializzato dal disco |

1604| Memoria automatica | Reinizializzato dal disco |1604| Memoria automatica | Reinizializzato dal disco |

1605| [Snapshot dello stato Git](/docs/it/settings-reference#includegitinstructions) | Claude Code legge uno nuovo dal tuo repository |

1605| Il piano che Claude ha scritto in [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) | Reinizializzato dal disco |1606| Il piano che Claude ha scritto in [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) | Reinizializzato dal disco |

1607| CLAUDE.md annidato nelle sottodirectory | Claude Code le ricarica mentre Claude legge i file in quella sottodirectory |1608| CLAUDE.md annidato nelle sottodirectory | Claude Code le ricarica mentre Claude legge i file in quella sottodirectory |

costs.md +4 −4

Details

37 37

38Questi totali si azzerano quando `/clear` avvia una nuova sessione, quindi il costo totale della sessione successiva ricomincia da \$0. Prima della v2.1.211, continuavano ad accumularsi attraverso `/clear` per la durata del processo Claude Code.38Questi totali si azzerano quando `/clear` avvia una nuova sessione, quindi il costo totale della sessione successiva ricomincia da \$0. Prima della v2.1.211, continuavano ad accumularsi attraverso `/clear` per la durata del processo Claude Code.

39 39

40Per una risposta dall'API Claude fatturata al [tasso di residenza dei dati](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) 1.1×, Claude Code moltiplica il prezzo di listino dei token di quella risposta per 1.1 nella cifra del costo della sessione. Claude Code segnala lo stesso totale nel [campo costo della riga di stato](/docs/it/statusline#cost-and-duration-tracking) e lo confronta con [`--max-budget-usd`](/docs/it/cli-reference#cli-flags). Prima della v2.1.239, Claude Code non applicava l'1.1× a quelle risposte, quindi la cifra del costo della sessione era inferiore alla fattura.40Per una risposta dall'API Claude fatturata al [tasso di residenza dei dati](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) 1.1×, Claude Code moltiplica il prezzo di listino dei token di quella risposta per 1.1 nella cifra del costo della sessione. Lo stesso totale appare nel [campo costo della riga di stato](/docs/it/statusline#cost-and-duration-tracking), e la cifra moltiplicata conta anche verso [`--max-budget-usd`](/docs/it/cli-reference#cli-flags). Prima della v2.1.239, Claude Code non applicava l'1.1× a quelle risposte, quindi la cifra del costo della sessione era inferiore alla fattura.

41 41

42<h4 id="prompt-cache-statistics">42<h4 id="prompt-cache-statistics">

43 Statistiche della cache dei prompt43 Statistiche della cache dei prompt

250 Riduci l'utilizzo dei token250 Riduci l'utilizzo dei token

251</h2>251</h2>

252 252

253I costi dei token si ridimensionano con la dimensione del contesto: più contesto Claude elabora, più token utilizzi. Claude Code ottimizza automaticamente i costi attraverso il [prompt caching](/docs/it/prompt-caching), che riduce i costi per il contenuto ripetuto come i prompt di sistema, e l'auto-compaction, che riassume la cronologia della conversazione quando ci si avvicina ai limiti del contesto.253I costi dei token si ridimensionano con la dimensione del contesto: più contesto Claude elabora, più token utilizzi. Claude Code ottimizza automaticamente i costi attraverso il [prompt caching](/docs/it/prompt-caching), che riduce i costi per il contenuto ripetuto come i prompt di sistema, e l'auto-compact, che riassume la cronologia della conversazione quando ci si avvicina ai limiti del contesto.

254 254

255Le seguenti strategie ti aiutano a mantenere il contesto piccolo e ridurre i costi per messaggio.255Le seguenti strategie ti aiutano a mantenere il contesto piccolo e ridurre i costi per messaggio.

256 256

275 Scegli il modello giusto275 Scegli il modello giusto

276</h3>276</h3>

277 277

278Sonnet gestisce bene la maggior parte dei compiti di codifica e costa meno di Opus. Riserva Opus per decisioni architettoniche complesse o ragionamento multi-step. Utilizza `/model` per cambiare modello a metà sessione, o imposta un valore predefinito in `/config`. Per semplici compiti subagent, specifica `model: haiku` nella tua [configurazione subagent](/docs/it/sub-agents#choose-a-model).278Sonnet gestisce bene la maggior parte dei compiti di codifica e costa meno di Opus. Riserva Opus per decisioni architettoniche complesse o ragionamento multi-step. Utilizza `/model` per cambiare modello a metà sessione, o imposta un valore predefinito in `/config`. Un passaggio a Opus si applica anche ai [subagent che ereditano il modello della tua sessione](/docs/it/model-config#setting-your-model). Per semplici compiti subagent, specifica `model: haiku` nella tua [configurazione subagent](/docs/it/sub-agents#choose-a-model).

279 279

280<h3 id="reduce-mcp-server-overhead">280<h3 id="reduce-mcp-server-overhead">

281 Riduci l'overhead del server MCP281 Riduci l'overhead del server MCP

359 359

360Il pensiero esteso è abilitato per impostazione predefinita perché migliora significativamente le prestazioni su compiti complessi di pianificazione e ragionamento. I token di pensiero vengono fatturati come token di output, e il budget predefinito può essere decine di migliaia di token per richiesta a seconda del modello.360Il pensiero esteso è abilitato per impostazione predefinita perché migliora significativamente le prestazioni su compiti complessi di pianificazione e ragionamento. I token di pensiero vengono fatturati come token di output, e il budget predefinito può essere decine di migliaia di token per richiesta a seconda del modello.

361 361

362Per compiti più semplici dove il ragionamento profondo non è necessario, puoi ridurre i costi abbassando il [livello di sforzo](/docs/it/model-config#adjust-effort-level) con `/effort` o in `/model`, o disabilitando il pensiero in `/config`. Non puoi disattivare il pensiero sui modelli Fable, che utilizzano sempre il pensiero esteso.362Per compiti più semplici dove il ragionamento profondo non è necessario, puoi ridurre i costi abbassando il [livello di sforzo](/docs/it/model-config#adjust-effort-level) con `/effort` o in `/model`, o disabilitando il pensiero in `/config`. Non puoi disattivare il pensiero su Opus 5.5 o sui modelli Fable, che utilizzano sempre il pensiero esteso.

363 363

364Sui modelli con un [budget di pensiero fisso](/docs/it/model-config#adaptive-reasoning-and-fixed-thinking-budgets), puoi anche abbassare il budget impostando la [variabile di ambiente](/docs/it/env-vars) `MAX_THINKING_TOKENS`, ad esempio `MAX_THINKING_TOKENS=8000`. I modelli di ragionamento adattivo ignorano i budget diversi da zero, quindi utilizza i livelli di sforzo lì.364Sui modelli con un [budget di pensiero fisso](/docs/it/model-config#adaptive-reasoning-and-fixed-thinking-budgets), puoi anche abbassare il budget impostando la [variabile di ambiente](/docs/it/env-vars) `MAX_THINKING_TOKENS`, ad esempio `MAX_THINKING_TOKENS=8000`. I modelli di ragionamento adattivo ignorano i budget diversi da zero, quindi utilizza i livelli di sforzo lì.

365 365

desktop.md +2 −2

Details

508 508

509Puoi limitare i plugin al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI.509Puoi limitare i plugin al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI.

510 510

511Il browser dei plugin non è disponibile nelle sessioni cloud e i plugin che installi dall'app desktop non sono disponibili per le sessioni cloud. Per usare un plugin in una sessione cloud, dichiara il plugin nel file `.claude/settings.json` del repository sotto [`enabledPlugins`](/docs/it/settings-reference#enabledplugins) in modo che Claude Code lo [installi all'avvio della sessione](/docs/it/cloud-environments#what-carries-over-from-your-setup), o abilitalo per il tuo account claude.ai in modo che Claude Code lo carichi come [plugin sincronizzato](/docs/it/plugins-reference#synced-plugins). I plugin non sono disponibili nelle sessioni WSL. Per il riferimento completo dei plugin inclusa la creazione dei tuoi plugin, vedi [plugins](/docs/it/plugins).511Il browser dei plugin non è disponibile nelle sessioni cloud e i plugin che installi dall'app desktop non sono disponibili per le sessioni cloud. Una sessione cloud inoltre non installa plugin che il file `.claude/settings.json` del repository dichiara, come spiega [What carries over from your setup](/docs/it/cloud-environments#what-carries-over-from-your-setup). Per usare un plugin in una sessione cloud, abilitalo per il tuo account claude.ai in modo che Claude Code lo carichi come [plugin sincronizzato](/docs/it/plugins-reference#synced-plugins). I plugin non sono disponibili nelle sessioni WSL. Per il riferimento completo dei plugin inclusa la creazione dei tuoi plugin, vedi [plugins](/docs/it/plugins).

512 512

513<h3 id="configure-preview-servers">513<h3 id="configure-preview-servers">

514 Configura server di anteprima514 Configura server di anteprima

735 735

736Per impostare variabili di ambiente per le sessioni locali e i server di sviluppo su qualsiasi piattaforma, apri il menu a discesa dell'ambiente nella casella del prompt, passa il mouse su **Local** e fai clic sull'icona dell'ingranaggio per aprire l'editor di ambiente locale. Le variabili che salvi qui vengono archiviate crittografate sulla tua macchina e si applicano a ogni sessione locale e server di anteprima che avvii. Puoi anche aggiungere variabili alla chiave `env` nel tuo file `~/.claude/settings.json`, anche se queste raggiungono solo le sessioni Claude e non i server di sviluppo. Vedi [variabili di ambiente](/docs/it/env-vars) per l'elenco completo delle variabili supportate.736Per impostare variabili di ambiente per le sessioni locali e i server di sviluppo su qualsiasi piattaforma, apri il menu a discesa dell'ambiente nella casella del prompt, passa il mouse su **Local** e fai clic sull'icona dell'ingranaggio per aprire l'editor di ambiente locale. Le variabili che salvi qui vengono archiviate crittografate sulla tua macchina e si applicano a ogni sessione locale e server di anteprima che avvii. Puoi anche aggiungere variabili alla chiave `env` nel tuo file `~/.claude/settings.json`, anche se queste raggiungono solo le sessioni Claude e non i server di sviluppo. Vedi [variabili di ambiente](/docs/it/env-vars) per l'elenco completo delle variabili supportate.

737 737

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

739 739

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

741 741

desktop-linux.md +1 −1

Details

16 Requisiti16 Requisiti

17</h2>17</h2>

18 18

~~19* Ubuntu 22.04 o versioni successive, oppure Debian 12 o versioni successive~~19* Una distribuzione basata su Debian: Ubuntu 22.04 o versioni successive, oppure Debian 12 o versioni successive

20* x86\_64 o arm6420* x86\_64 o arm64

21 21

22Altre distribuzioni basate su Debian che soddisfano questi requisiti potrebbero funzionare ma non sono ufficialmente testate. Su distribuzioni che non sono basate su Debian, come Fedora o Arch, eseguire la [CLI](/docs/it/setup#system-requirements) invece. Se lavorate su Windows con WSL 2, installate l'app desktop di Windows ed eseguite le sessioni all'interno della vostra distribuzione; vedere [Claude Code Desktop in WSL](/docs/it/desktop-wsl).22Altre distribuzioni basate su Debian che soddisfano questi requisiti potrebbero funzionare ma non sono ufficialmente testate. Su distribuzioni che non sono basate su Debian, come Fedora o Arch, eseguire la [CLI](/docs/it/setup#system-requirements) invece. Se lavorate su Windows con WSL 2, installate l'app desktop di Windows ed eseguite le sessioni all'interno della vostra distribuzione; vedere [Claude Code Desktop in WSL](/docs/it/desktop-wsl).

discover-plugins.md +7 −3

Details

42/plugin install github@claude-plugins-official42/plugin install github@claude-plugins-official

43```43```

44 44

45`/plugin` apre un pannello interattivo nella CLI del terminale. Se Claude risponde che `/plugin` non è disponibile in questo ambiente, utilizzate il [browser dei plugin](/docs/it/desktop#install-plugins) nell'app desktop di Claude, oppure dichiarate il plugin sotto [`enabledPlugins`](/docs/it/settings-reference#enabledplugins) in `.claude/settings.json` per le sessioni cloud.45`/plugin` apre un pannello interattivo nella CLI del terminale. Se Claude risponde che `/plugin` non è disponibile in questo ambiente, installate il plugin in un altro modo:

47* **App desktop Claude**: utilizzate il [browser dei plugin](/docs/it/desktop#install-plugins).

48* **Estensione VS Code**: installate dalla [finestra di dialogo **Manage plugins**](/docs/it/vs-code#manage-plugins).

49* **Sessioni cloud**: abilitate il plugin per il vostro account claude.ai in modo che Claude Code lo carichi come [plugin sincronizzato](/docs/it/plugins-reference#synced-plugins).

46 50

47Se l'installazione non riesce, abbinate il messaggio che Claude Code segnala:51Se l'installazione non riesce, abbinate il messaggio che Claude Code segnala:

48 52

360Claude Code cerca il plugin nella sua copia locale del catalogo del marketplace. Il modo in cui nominate il plugin controlla se Claude Code aggiorna prima quella copia:364Claude Code cerca il plugin nella sua copia locale del catalogo del marketplace. Il modo in cui nominate il plugin controlla se Claude Code aggiorna prima quella copia:

361 365

362* **Con un nome di marketplace**: quando installate `plugin-name@marketplace-name`, in una sessione o con `claude plugin install`, Claude Code aggiorna quel marketplace prima della ricerca. Claude Code esegue l'aggiornamento anche se avete disattivato [l'aggiornamento automatico](#configure-auto-updates) per il marketplace o impostato `DISABLE_AUTOUPDATER`. Prima della v2.1.232, Claude Code non aggiornava il marketplace prima della ricerca. Claude Code salta questo aggiornamento quando:366* **Con un nome di marketplace**: quando installate `plugin-name@marketplace-name`, in una sessione o con `claude plugin install`, Claude Code aggiorna quel marketplace prima della ricerca. Claude Code esegue l'aggiornamento anche se avete disattivato [l'aggiornamento automatico](#configure-auto-updates) per il marketplace o impostato `DISABLE_AUTOUPDATER`. Prima della v2.1.232, Claude Code non aggiornava il marketplace prima della ricerca. Claude Code salta questo aggiornamento quando:

363 * Il marketplace non è stato [aggiunto da GitHub, un altro host Git o un URL remoto](#add-marketplaces).367 * Il marketplace non è stato [aggiunto da GitHub, un altro host Git, un URL remoto](#add-marketplaces), o [claude.ai](#add-from-claude-ai).

364 * Una [directory seed](/docs/it/plugin-marketplaces#pre-populate-plugins-for-containers) fornisce il marketplace.368 * Una [directory seed](/docs/it/plugin-marketplaces#pre-populate-plugins-for-containers) fornisce il marketplace.

365 * Claude Code ha aggiornato il marketplace negli ultimi 30 secondi.369 * Claude Code ha aggiornato il marketplace negli ultimi 30 secondi.

366 * Avete impostato [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars).370 * Avete impostato [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars).

395 399

396La fonte assume [le stesse forme di `/plugin marketplace add`](#add-marketplaces), come GitHub `owner/repo`, un URL git o un percorso locale, tranne che non può contenere spazi. Fornite il nome del plugin senza un suffisso `@marketplace`.400La fonte assume [le stesse forme di `/plugin marketplace add`](#add-marketplaces), come GitHub `owner/repo`, un URL git o un percorso locale, tranne che non può contenere spazi. Fornite il nome del plugin senza un suffisso `@marketplace`.

397 401

398Se non avete ancora aggiunto quel marketplace, Claude Code mostra la fonte che ha risolto e vi chiede di confermare prima di aggiungerla. Rifiutare annulla l'installazione e non aggiunge nulla. Una volta aggiunto il marketplace, i dettagli del plugin si aprono e scegliete un [ambito di installazione](/docs/it/settings#where-settings-live).402Claude Code mostra la fonte che ha risolto e vi chiede di confermare prima di aggiungere il marketplace. Rifiutare annulla l'installazione e non aggiunge nulla. Una volta aggiunto il marketplace, i dettagli del plugin si aprono e scegliete un [ambito di installazione](/docs/it/settings#where-settings-live). Se la fonte corrisponde a un marketplace che avete già aggiunto, Claude Code salta la conferma e apre i dettagli del plugin in quel marketplace.

399 403

400<h2 id="manage-installed-plugins">404<h2 id="manage-installed-plugins">

401 Gestire i plugin installati405 Gestire i plugin installati

env-vars.md +302 −290

Details

124 Variabili124 Variabili

125</h2>125</h2>

126 126

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

128 128

129<Note>129<Note>

130 Per le variabili che attivano o disattivano un comportamento, impostare `1` o `true` per attivarlo e `0` o `false` per disattivarlo, in qualsiasi maiuscola.130 Per le variabili che attivano o disattivano un comportamento, impostare `1` o `true` per attivarlo e `0` o `false` per disattivarlo, in qualsiasi maiuscola.

131 131

132 Alcune variabili leggono solo se le avete impostate, quindi qualsiasi valore non vuoto incluso `0` attiva il comportamento, e disattivate il comportamento annullando l'impostazione della variabile o impostandola su un valore vuoto. Queste variabili funzionano in questo modo:132 Alcune variabili leggono solo se le avete impostate, quindi qualsiasi valore non vuoto incluso `0` attiva il comportamento, e disattivate il comportamento non impostando la variabile o impostandola 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 la sua regola: `FORCE_HYPERLINK` legge un numero, quindi solo `0` la disattiva. Ogni riga della variabile dichiara anche la sua regola.141 Un'altra variabile ha la sua regola: `FORCE_HYPERLINK` legge un numero, quindi solo `0` la disattiva. La riga di ogni variabile dichiara anche la sua regola.

142</Note>142</Note>

143 143

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

146| `ANTHROPIC_API_KEY` | Chiave API inviata come intestazione `X-Api-Key`. Quando impostata, questa chiave viene utilizzata al posto del vostro abbonamento Claude Pro, Max, Team o Enterprise anche se siete connessi. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente. In modalità interattiva, vi viene chiesto di approvare la chiave una volta prima che sostituisca il vostro abbonamento. Per utilizzare il vostro abbonamento, eseguite `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | Chiave API inviata come intestazione `X-Api-Key`. Quando impostata, questa chiave viene utilizzata al posto del vostro abbonamento Claude Pro, Max, Team o Enterprise anche se siete connessi. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente. In modalità interattiva, vi viene chiesto di approvare la chiave una volta prima che sostituisca il vostro abbonamento. Per utilizzare il vostro abbonamento, eseguite `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'intestazione `Authorization` (il valore che impostate qui sarà preceduto da `Bearer `) |147| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'intestazione `Authorization` (il valore che impostate qui sarà preceduto da `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Chiave API dell'area di lavoro 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 dell'area di lavoro 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 |

149| `ANTHROPIC_AWS_BASE_URL` | Sostituire l'URL dell'endpoint [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Utilizzare per regioni personalizzate o quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway). Impostazione predefinita: `https://aws-external-anthropic.{region}.api.aws`. Claude Code risolve la regione con la [stessa precedenza di Amazon Bedrock](/docs/it/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | Sostituire l'URL dell'endpoint [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Utilizzare per aree personalizzate o quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway). Impostazione predefinita: `https://aws-external-anthropic.{region}.api.aws`. Claude Code risolve l'area con la [stessa precedenza di Amazon Bedrock](/docs/it/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatorio per [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Inviato su ogni richiesta come intestazione `anthropic-workspace-id` |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatorio per [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Inviato su ogni richiesta come intestazione `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Sostituire l'endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, [la ricerca degli strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitata per impostazione predefinita. Impostare `ENABLE_TOOL_SEARCH=true` se il vostro proxy inoltra i blocchi `tool_reference`. A partire dalla v2.1.196, [Remote Control](/docs/it/remote-control#requirements) è disabilitato quando questo punta a un host diverso da `api.anthropic.com`, corrispondendo al suo comportamento su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Sostituire l'endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, [ricerca strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitata per impostazione predefinita. Impostare `ENABLE_TOOL_SEARCH=true` se il vostro proxy inoltra blocchi `tool_reference`. A partire dalla v2.1.196, [Remote Control](/docs/it/remote-control#requirements) è disabilitato quando questo punta a un host diverso da `api.anthropic.com`, corrispondendo al suo comportamento su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Sostituire l'URL dell'endpoint Amazon Bedrock. Utilizzare per endpoint Amazon Bedrock personalizzati o quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway). Vedere [Amazon Bedrock](/docs/it/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Sostituire l'URL dell'endpoint Amazon Bedrock. Utilizzare per endpoint Amazon Bedrock personalizzati o quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway). Vedere [Amazon Bedrock](/docs/it/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sostituire l'URL dell'endpoint Amazon Bedrock Mantle. Vedere [Endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sostituire l'URL dell'endpoint Amazon Bedrock Mantle. Vedere [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. Ignorato nelle regioni AWS GovCloud. Richiede Claude Code v2.1.224 o successivo. Vedere [Amazon Bedrock](/docs/it/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefisso del profilo di inferenza tra aree (`us`, `eu`, `apac`, `jp`, `au`, o `global`) che Claude Code prova per primo al posto di quello derivato dall'area AWS. Ignorato nelle aree AWS GovCloud. Richiede Claude Code v2.1.224 o successivo. Vedere [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) Amazon Bedrock (`default`, `flex`, o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Vedere [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) Amazon Bedrock (`default`, `flex`, o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Vedere [Amazon Bedrock](/docs/it/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Elenco separato da virgole di valori di intestazione `anthropic-beta` aggiuntivi da includere nelle richieste API. Claude Code invia già gli header beta di cui ha bisogno; utilizzare questo per aderire a un [beta 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 di intestazione `anthropic-beta` aggiuntivi da includere nelle richieste API. Claude Code invia già gli intestazioni beta di cui ha bisogno; utilizzare questo per aderire a un [beta 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 |

157| `ANTHROPIC_CUSTOM_HEADERS` | Intestazioni personalizzate da aggiungere alle richieste (formato `Name: Value`, separato da newline per più intestazioni). Se un nome o un valore contiene un carattere che un'intestazione HTTP non può trasportare, come una virgoletta ricurva o uno spazio a larghezza zero, la richiesta fallisce con un errore che identifica la coppia per posizione. Richiede Claude Code v2.1.227 o successivo. [Invalid request header value](/docs/it/errors#invalid-request-header-value) elenca l'insieme esatto di caratteri e dove viene eseguito il controllo. Un valore che imposta un'intestazione di credenziale, organizzazione o tenant, instradamento o comportamento API, come `Authorization` o `Host`, conta come un [impostazione che necessita approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog) quando le impostazioni gestite dal server la consegnano. Dalle impostazioni di progetto o locali, tale valore segue le [regole per quando si applicano i valori `env`](/docs/it/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | Intestazioni personalizzate da aggiungere alle richieste (formato `Name: Value`, separato da nuova riga per più intestazioni). Se un nome o un valore contiene un carattere che un'intestazione HTTP non può trasportare, come una virgoletta ricurva o uno spazio di larghezza zero, la richiesta fallisce con un errore che identifica la coppia per posizione. Richiede Claude Code v2.1.227 o successivo. [Invalid request header value](/docs/it/errors#invalid-request-header-value) elenca l'insieme esatto di caratteri e dove viene eseguito il controllo. Un valore che imposta un'intestazione di credenziale, organizzazione o tenant, instradamento o comportamento API, come `Authorization` o `Host`, conta come un [impostazione che necessita approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog) quando le impostazioni gestite dal server la consegnano. Dalle impostazioni di progetto o locali, tale valore segue le [regole per quando i valori `env` si applicano](/docs/it/settings-reference#when-claude-code-applies-env-values) |

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

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrizione di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Impostazione predefinita: `Custom model (<model-id>)` quando non impostato |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrizione di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Impostazione predefinita: `Custom model (<model-id>)` quando non impostato |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Quando non impostato, 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 di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Quando non impostato, la voce mostra il nome del modello se Claude Code [riconosce l'ID](/docs/it/model-config#customize-pinned-model-display-and-capabilities), e l'ID del modello altrimenti |

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

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

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Fable bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Fable bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome di visualizzazione per il modello Fable bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, altrimenti l'ID bloccato. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome di visualizzazione per il modello Fable bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

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

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

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Haiku bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Haiku bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome di visualizzazione per il modello Haiku bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, altrimenti l'ID bloccato. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome di visualizzazione per il modello Haiku bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

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

170| `ANTHROPIC_DEFAULT_MODEL` | Modello su cui iniziano le nuove sessioni per impostazione predefinita. Richiede Claude Code v2.1.236 o successivo. Vedere [Impostare un modello predefinito per le nuove sessioni](/docs/it/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | Modello su cui le nuove sessioni iniziano per impostazione predefinita. Richiede Claude Code v2.1.236 o successivo. Vedere [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 modello a cui si risolve l'alias `opus`, e che `opusplan` utilizza mentre Plan Mode è attivo. Vedere [Configurazione del modello](/docs/it/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID modello a cui l'alias `opus` si risolve, e che `opusplan` utilizza mentre Plan Mode è attivo. Vedere [Configurazione del modello](/docs/it/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Opus bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Opus bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome di visualizzazione per il modello Opus bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, altrimenti l'ID bloccato. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome di visualizzazione per il modello Opus bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

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

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

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Sonnet bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Sonnet bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome di visualizzazione per il modello Sonnet bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, altrimenti l'ID bloccato. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome di visualizzazione per il modello Sonnet bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

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

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID regola di federazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando lo impostate insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno la precedenza sulla vostra credenziale `/login`. Vedere [precedenza di autenticazione](/docs/it/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID regola di federazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando lo impostate insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno la precedenza sulla vostra credenziale `/login`. Vedere [precedenza di autenticazione](/docs/it/authentication#authentication-precedence) |

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

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Obbligatorio se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostato (vedere [Microsoft Foundry](/docs/it/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Obbligatorio se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostato (vedere [Microsoft Foundry](/docs/it/microsoft-foundry)) |

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

185| `ANTHROPIC_ORGANIZATION_ID` | ID organizzazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostatelo insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Vedere [precedenza di autenticazione](/docs/it/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | ID organizzazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostatelo insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Vedere [precedenza di 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]\(/it/authentication#sign-in-without-an-api-key). Vedere [precedenza di 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 da [accesso a un account Console senza chiave API](/docs/it/authentication#sign-in-without-an-api-key). Vedere [precedenza di autenticazione](/docs/it/authentication#authentication-precedence) |

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

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sostituire la regione AWS per il modello di classe Haiku quando si utilizza Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, questo ha effetto solo quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` o il deprecato `ANTHROPIC_SMALL_FAST_MODEL` è impostato, poiché Amazon Bedrock altrimenti esegue attività di background sul [modello Sonnet predefinito o sul modello primario](/docs/it/amazon-bedrock#4-pin-model-versions) nella regione della sessione |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sostituire l'area AWS per il modello di classe Haiku quando si utilizza Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, questo ha effetto solo quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` o il deprecato `ANTHROPIC_SMALL_FAST_MODEL` è anche impostato, poiché Amazon Bedrock altrimenti esegue attività in background sul [modello Sonnet predefinito o sul modello primario](/docs/it/amazon-bedrock#4-pin-model-versions) nell'area della sessione |

189| `ANTHROPIC_VERTEX_BASE_URL` | Sostituire l'URL dell'endpoint Google Cloud's Agent Platform. Utilizzare per endpoint Google Cloud's Agent Platform personalizzati o quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway). Vedere [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Sostituire l'URL dell'endpoint Google Cloud's Agent Platform. Utilizzare per endpoint Google Cloud's Agent Platform personalizzati o quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway). Vedere [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |

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

191| `ANTHROPIC_WORKSPACE_ID` | ID area di lavoro per [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostatelo quando la vostra regola di federazione è limitata a più di un'area di lavoro in modo che lo scambio di token sappia quale area di lavoro scegliere come destinazione |191| `ANTHROPIC_WORKSPACE_ID` | ID area di lavoro per [federazione dell'identità del carico di lavoro](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostatelo quando la vostra regola di federazione è limitata a più di un'area di lavoro in modo che lo scambio di token sappia quale area di lavoro scegliere come destinazione |

192| `API_FORCE_IDLE_TIMEOUT` | Sostituire il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Impostare a `0` per disattivare il timeout, ad esempio quando un [gateway](/docs/it/llm-gateway) lento o un modello locale fa una pausa più lunga di 5 minuti tra i chunk, o `1` per mantenerlo attivo per ogni provider. Quando non impostato, il timeout è attivo su provider diversi dall'API Anthropic diretto e [Claude Platform on AWS](/docs/it/claude-platform-on-aws). I [watchdog di streaming](/docs/it/network-config#streaming-idle-watchdogs) funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando impostate `0` qui |192| `API_FORCE_IDLE_TIMEOUT` | Sostituire il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Impostare su `0` per disattivare il timeout, ad esempio quando un [gateway](/docs/it/llm-gateway) lento o un modello locale fa una pausa più lunga di 5 minuti tra i chunk, o `1` per mantenerlo attivo per ogni provider. Quando non impostato, il timeout è attivo su provider diversi dall'API Anthropic diretta e [Claude Platform on AWS](/docs/it/claude-platform-on-aws). I [watchdog di flusso](/docs/it/network-config#streaming-idle-watchdogs) funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando impostate `0` qui |

193| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumentare quando le richieste scadono su reti lente o quando si instrada attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste |193| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumentare quando le richieste scadono su reti lente o quando si instrada attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste |

194| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API Amazon Bedrock per l'autenticazione (vedere [Chiavi API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |194| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API Amazon Bedrock per l'autenticazione (vedere [Chiavi API 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 i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti) |195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti) |

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

197| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti). Il limite effettivo è il maggiore tra questo e `BASH_DEFAULT_TIMEOUT_MS` |197| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti). Il limite effettivo è il maggiore tra questo e `BASH_DEFAULT_TIMEOUT_MS` |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP per [tracciamento beta dettagliato](/docs/it/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, i log e le tracce vanno lì invece che agli esportatori configurati. Impostatelo nella vostra shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP per [tracciamento beta dettagliato](/docs/it/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, i log e le tracce vanno lì invece che agli esportatori configurati. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Impostare a `1` per forzare [`claude --cloud`](/docs/it/claude-code-on-the-web#send-local-repositories-without-github) a raggruppare e caricare il vostro repository locale invece di clonarlo dal suo remoto |199| `CCR_FORCE_BUNDLE` | Impostare su `1` per forzare [`claude --cloud`](/docs/it/claude-code-on-the-web#send-local-repositories-without-github) a raggruppare e caricare il vostro repository locale invece di clonarlo dal suo remoto |

200| `CLAUDECODE` | Impostare a `1` nei sottoprocessi che Claude Code genera (strumenti Bash e PowerShell, sessioni tmux, comandi [hook](/docs/it/hooks), comandi [status line](/docs/it/statusline), sottoprocessi [server MCP](/docs/it/mcp) stdio). Le estensioni IDE impostano anche questo nei loro terminali integrati. Utilizzare per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso generato da Claude Code. Per verificare se il processo corrente è stato generato direttamente da una chiamata di strumento o hook, piuttosto che all'interno di un server MCP stdio che Claude Code ha avviato, utilizzare `CLAUDE_CODE_CHILD_SESSION` |200| `CLAUDECODE` | Impostare su `1` nei sottoprocessi che Claude Code genera (strumenti Bash e PowerShell, sessioni tmux, comandi [hook](/docs/it/hooks), comandi [linea di stato](/docs/it/statusline), sottoprocessi [server MCP](/docs/it/mcp) stdio). Le estensioni IDE impostano anche questo nei loro terminali integrati. Utilizzare per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso generato da Claude Code. Per verificare se il processo corrente è stato generato direttamente da una chiamata di strumento o hook, piuttosto che all'interno di un server MCP stdio che Claude Code ha avviato, utilizzare `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Quanti millisecondi prima del auto-continue il countdown sullo schermo appare su una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di auto-continue. Non ha effetto a meno che l'auto-continue non sia attivo; vedere l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successivo |201| `CLAUDE_AFK_COUNTDOWN_MS` | Quanti millisecondi prima dell'auto-continuazione il conto alla rovescia sullo schermo appare su una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di auto-continuazione. Non ha effetto a meno che l'auto-continuazione non sia attiva; vedere l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successivo |

202| `CLAUDE_AFK_TIMEOUT_MS` | Quanti millisecondi di tempo di inattività prima che una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta continui automaticamente senza di voi. L'auto-continue è disattivato per impostazione predefinita; aderire con l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout). Questa variabile è un override per demo e test automatizzati: quando impostata, ha la precedenza su tale impostazione e attiva l'auto-continue anche quando l'impostazione non è impostata o è `never`. L'impostazione di `0` non disattiva il timeout; chiude la finestra di dialogo immediatamente. Nella v2.1.198 e v2.1.199, l'auto-continue era attivo per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successivo |202| `CLAUDE_AFK_TIMEOUT_MS` | Quanti millisecondi di tempo di inattività prima che una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta continui automaticamente senza di voi. L'auto-continuazione è disattivata per impostazione predefinita; aderire con l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout). Questa variabile è un override per demo e test automatizzati: quando impostata, ha la precedenza su tale impostazione e attiva l'auto-continuazione anche quando l'impostazione non è impostata o è `never`. L'impostazione di `0` non disattiva il timeout; chiude la finestra di dialogo immediatamente. Nella v2.1.198 e v2.1.199, l'auto-continuazione era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successivo |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Impostare a `1` per disabilitare tutti i tipi di [subagent](/docs/it/sub-agents) incorporati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti SDK che desiderano una lavagna pulita. Questo rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata dello strumento Agent omette `subagent_type`. Tale chiamata fallisce quindi con [`subagent_type is required`](/docs/it/errors#subagent-type-is-required) |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Impostare su `1` per disabilitare tutti i tipi di [subagent](/docs/it/sub-agents) incorporati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti SDK che desiderano una lavagna pulita. Questo rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata dello strumento Agent omette `subagent_type`. Tale chiamata fallisce quindi con [`subagent_type is required`](/docs/it/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Impostare a `1` per saltare il prefisso `mcp__<server>__` sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Impostare su `1` per saltare il prefisso `mcp__<server>__` sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumentate `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog di streaming è attivo, il predefinito aumenta con esso, come [Gestire risposte API lente o bloccate](/docs/it/agent-sdk/typescript#handle-slow-or-stalled-api-responses) descrive. Il timer si ripristina su ogni evento di progresso di streaming; se nessun progresso arriva 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 aumentate `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog di flusso è attivo, il predefinito aumenta con esso, come [Gestire risposte API lente o bloccate](/docs/it/agent-sdk/typescript#handle-slow-or-stalled-api-responses) descrive. Il timer si ripristina su ogni evento di progresso di streaming; se nessun progresso arriva entro la finestra, Claude Code interrompe il subagent e segnala lo stallo al genitore |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Impostare la percentuale (1-100) della finestra di auto-compact in cui si attiva la auto-compattazione. Utilizzare valori inferiori come `50` per compattare prima; la variabile non può aumentare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo alle 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 che ai subagent |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Impostare la percentuale (1-100) della finestra di auto-compattazione in cui si attiva la compattazione automatica. Utilizzare valori inferiori come `50` per compattare prima; la variabile non può aumentare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo alle 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 che ai subagent |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Impostare a `1` per forzare l'abilitazione dello sfondo automatico dei compiti agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo aver eseguito per circa due minuti. Abilita anche l'[abilitazione automatica dello sfondo delle lunghe chiamate di strumenti MCP](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) in modalità non interattiva su Claude Code v2.1.212 o successivo |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Impostare su `1` per forzare l'abilitazione dello sfondo automatico dei compiti agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l'esecuzione per circa due minuti. Abilita anche [lo sfondo automatico delle lunghe chiamate di strumenti MCP](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) in modalità non interattiva su Claude Code v2.1.212 o successivo |

208| `CLAUDE_AX_PREPARK_MS` | In [modalità lettore di schermo](/docs/it/accessibility#what-your-screen-reader-hears), quanti millisecondi Claude Code aspetta, con il cursore all'inizio della riga, prima di scrivere una riga nuova o modificata. Predefinito `50`. Impostare `0` per scrivere immediatamente. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successivo |208| `CLAUDE_AX_PREPARK_MS` | In [modalità lettore di schermo](/docs/it/accessibility#what-your-screen-reader-hears), quanti millisecondi Claude Code aspetta, con il cursore all'inizio della riga, prima di scrivere una riga nuova o modificata. Predefinito `50`. Impostare `0` per scrivere immediatamente. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successivo |

209| `CLAUDE_AX_SCREEN_READER` | Impostare a `1` per eseguire il rendering dell'output compatibile con il lettore di schermo: testo piatto senza bordi decorativi o animazioni. Impostare a `0` per forzare la disattivazione della modalità lettore di schermo 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 successivo |209| `CLAUDE_AX_SCREEN_READER` | Impostare su `1` per eseguire il rendering dell'output compatibile con il lettore di schermo: testo piatto senza bordi decorativi o animazioni. Impostare su `0` per forzare la disattivazione della modalità lettore di schermo 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 successivo |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | In [modalità lettore di schermo](/docs/it/accessibility), quanti millisecondi Claude Code mantiene il primo rendering dell'interfaccia dopo la riga di conferma di avvio, in modo che il vostro lettore di schermo possa pronunciare la riga completamente prima che il nuovo output l'interrompa. Predefinito `3000`. Impostare `0` per eseguire il rendering immediatamente. Claude Code limita la tenuta a `600000` (10 minuti). La vostra prima pressione di tasto termina la tenuta in anticipo. Richiede Claude Code v2.1.217 o successivo |210| `CLAUDE_AX_STARTUP_QUIET_MS` | In [modalità lettore di schermo](/docs/it/accessibility), quanti millisecondi Claude Code mantiene il primo rendering dell'interfaccia dopo la riga di conferma di avvio, in modo che il vostro lettore di schermo possa pronunciare la riga completamente prima che il nuovo output l'interrompa. Predefinito `3000`. Impostare `0` per eseguire il rendering immediatamente. Claude Code limita la sospensione a `600000` (10 minuti). La vostra prima pressione di tasto termina la sospensione in anticipo. Richiede Claude Code v2.1.217 o successivo |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Tornare alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Tornare 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à di streaming a livello di byte; quando impostato, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia il watchdog a livello di evento invariato. Claude Code limita questa variabile tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successivo |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi per il watchdog di inattività di flusso a livello di byte; quando impostato, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia il watchdog a livello di evento invariato. Claude Code limita questa variabile tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successivo |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Percorso a un file che uno strumento esterno, come un listener di blocco dello schermo, crea quando sbloccare lo schermo e elimina quando lo blocca. Mentre il file esiste, Claude Code salta le [notifiche push mobili di Remote Control](/docs/it/remote-control#mobile-push-notifications), quindi smettete di ricevere push mentre state utilizzando attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per evento di attivazione push piuttosto che eseguire il polling. Richiede Claude Code v2.1.181 o successivo |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Percorso a un file che uno strumento esterno, come un listener di blocco dello schermo, crea quando sbloccare lo schermo e elimina quando lo blocca. Mentre il file esiste, Claude Code salta [notifiche push mobili di Remote Control](/docs/it/remote-control#mobile-push-notifications), quindi smettete di ricevere push mentre state utilizzando attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per evento di attivazione push piuttosto che eseguire il polling. Richiede Claude Code v2.1.181 o successivo |

214| `CLAUDE_CODE_ACCESSIBILITY` | Impostare a `1` per mantenere visibile il cursore del terminale nativo e disabilitare l'indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore |214| `CLAUDE_CODE_ACCESSIBILITY` | Impostare su `1` per mantenere visibile il cursore del terminale nativo e disabilitare l'indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Impostare a `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` | Impostare 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 |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Impostare a `1` per ridisegnare l'intero schermo su ogni frame nel [rendering a schermo intero](/docs/it/fullscreen) invece di inviare aggiornamenti incrementali. Utilizzare se la modalità a schermo intero mostra frammenti di testo stantii o posizionati male. Claude Code abilita questo automaticamente per le sessioni di background e [agent view](/docs/it/agent-view) su Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Impostare su `1` per ridisegnare l'intero schermo su ogni frame nel [rendering a schermo intero](/docs/it/fullscreen) invece di inviare aggiornamenti incrementali. Utilizzare se la modalità a schermo intero mostra frammenti di testo stantii o posizionati male. Claude Code abilita questo automaticamente per le sessioni in background e [visualizzazione agente](/docs/it/agent-view) su Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Impostare a `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 capace di effort. Utilizzare quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway) o provider di terze parti che servono modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort all'API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1, e Haiku 4.5, sono comunque esclusi in modo che le richieste non falliscano |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Impostare 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 in grado di supportare lo sforzo. Utilizzare quando si instrada attraverso un [gateway LLM](/docs/it/llm-gateway) o provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort all'API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1, e Haiku 4.5, sono comunque esclusi in modo che le richieste non falliscano |

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

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

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

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Impostare a `0` per impedire a Claude di [rispondere da solo ai commenti inviatigli](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Richiede Claude Code v2.1.228 o successivo |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Impostare su `0` per impedire a Claude di [rispondere da solo ai commenti inviatigli](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Richiede Claude Code v2.1.228 o successivo |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Impostare a `0` per omettere il [blocco di attribuzione](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), che trasporta la versione del client e un'impronta digitale del prompt, dall'inizio del prompt di sistema. La memorizzazione in cache su una connessione diretta all'API Anthropic non è interessata in entrambi i casi. In alcuni setup di connessione diretta, Claude Code mantiene il blocco sulle richieste del classificatore [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) anche quando impostate `0`. In [System prompt attribution block](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), controllate quali connessioni e credenziali questo copre. Prima della v2.1.181 il blocco includeva un token per richiesta su URL di base personalizzati e connessioni Microsoft Foundry, quindi su quelle versioni impostatelo a `0` quando il vostro gateway LLM memorizza in cache il corpo della richiesta o inoltra le richieste a un provider di terze parti, o quando vi connettete a Microsoft Foundry direttamente |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Impostare su `0` per omettere il [blocco di attribuzione](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), che trasporta la versione del client e un'impronta digitale del prompt, dall'inizio del prompt di sistema. La memorizzazione in cache su una connessione diretta all'API Anthropic non è interessata in entrambi i casi. In alcuni setup di connessione diretta, Claude Code mantiene il blocco sulle richieste del classificatore [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) anche quando impostate `0`. In [Blocco di attribuzione del prompt di sistema](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), controllate quali connessioni e credenziali questo copre. Prima della v2.1.181 il blocco includeva un token per richiesta su URL di base personalizzati e connessioni Microsoft Foundry, quindi su quelle versioni impostatelo su `0` quando il vostro gateway LLM memorizza in cache il corpo della richiesta o inoltra le richieste a un provider di terze parti, o quando vi connettete a Microsoft Foundry direttamente |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è abilitato, secondi tra i promemoria a Claude di controllare i [subagent di background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ancora in esecuzione. Accetta un numero intero semplice da `1` a `86400` solo; qualsiasi altro valore o ortografia legge come non impostato. Quando non impostato, non ci sono promemoria di check-in. Richiede Claude Code v2.1.248 o successivo |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è abilitato, secondi tra i promemoria a Claude di controllare i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ancora in esecuzione. Accetta un numero intero semplice da `1` a `86400` solo; qualsiasi altro valore o ortografia legge come non impostato. Quando non impostato, non ci sono promemoria di check-in. Richiede Claude Code v2.1.248 o successivo |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Impostare la [finestra di auto-compact](/docs/it/model-config#set-the-auto-compact-window) in token, da `100000` a `1000000`. Accetta un numero intero semplice come `500000` solo: un valore come `500k` legge come `500` e si limita al minimo di 100K. La finestra effettiva è anche limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, il flag `--autocompact`, e l'impostazione `autoCompactWindow`. La percentuale `used_percentage` della status line misura sempre contro la finestra di contesto completa del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Impostare la [finestra di auto-compattazione](/docs/it/model-config#set-the-auto-compact-window) in token, da `100000` a `1000000`. Accetta un numero intero semplice come `500000` solo: un valore come `500k` legge come `500` e si limita al minimo di 100K. La finestra effettiva è anche limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, il flag `--autocompact` e l'impostazione `autoCompactWindow`. La percentuale `used_percentage` della linea di stato misura sempre contro la finestra di contesto completa del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sostituire la [connessione IDE](/docs/it/vs-code) automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all'interno del terminale integrato di un IDE supportato. Impostare a `false` per prevenire questo. Impostare a `true` per forzare un tentativo di connessione quando l'auto-rilevamento fallisce, come quando tmux oscura il terminale genitore. Ha la precedenza sull'impostazione di configurazione globale [`autoConnectIde`](/docs/it/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sostituire la [connessione IDE](/docs/it/vs-code) automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all'interno del terminale integrato di un IDE supportato. Impostare su `false` per impedire questo. Impostare su `true` per forzare un tentativo di connessione quando l'auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale genitore. Ha la precedenza sull'impostazione di configurazione globale [`autoConnectIde`](/docs/it/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo in millisecondi che Claude Code aspetta affinché il provider di credenziali predefinito AWS produca 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`). Aumentare quando un passaggio nella vostra catena ha legittimamente bisogno di più tempo, come un accesso SSO basato su browser con MFA attraverso 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 successivo |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controlla se Claude Code chiede al server di [rivedere le azioni della modalità auto](/docs/it/permission-modes#server-side-classifier-review). Quando non impostato, Claude Code chiede al server su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, e quando puntate `ANTHROPIC_BASE_URL` a un gateway LLM o proxy. Impostare su `0` per utilizzare le richieste del classificatore di Claude Code. Non letto su una connessione diretta all'API Anthropic. Richiede Claude Code v2.1.271 o successivo; chiedere al server per impostazione predefinita richiede v2.1.278 o successivo |

227| `CLAUDE_CODE_BASH_EDIT_DIFF` | Impostare a `0` per disattivare il [diff dei file che un comando Bash ha modificato](/docs/it/hooks#bash), o `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 successivo |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo in millisecondi che Claude Code aspetta affinché la catena del provider di credenziali predefinito AWS produca 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`). Aumentare quando un passaggio nella vostra catena ha legittimamente bisogno di più tempo, come un accesso SSO basato su browser con MFA attraverso 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 successivo |

228| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Impostato automaticamente nei sottoprocessi dello strumento Bash e [comando hook](/docs/it/hooks) mentre la sessione ha una connessione [Remote Control](/docs/it/remote-control) attiva, e rimosso quando la connessione termina. Il valore è l'ID della sessione in forma `session_`, lo stesso identificatore che appare nell'URL `claude.ai/code` della sessione, in modo che uno script possa collegarsi di nuovo alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successivo. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), leggere `CLAUDE_CODE_REMOTE_SESSION_ID` |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Impostare su `0` per disattivare il [diff dei file che sono cambiati mentre un comando Bash era in esecuzione](/docs/it/hooks#bash), o `1` per registrarlo in ogni modalità di autorizzazione. Ha la precedenza sull'impostazione [`bashEditDiffEnabled`](/docs/it/settings-reference#basheditdiffenabled). Richiede Claude Code v2.1.269 o successivo |

229| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Impostare a `0` per fare in modo che Claude Code legga il byte `0x08`, anche scritto `^H`, come Backspace semplice, o `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 Backspace semplice su macOS e Linux. Impostare `0` in un terminale Windows dove [Backspace elimina un'intera parola](/docs/it/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Impostare su `0` per fare in modo che una sessione non interattiva segnali uno stato di inattività al suo host 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 [workflow](/docs/it/workflows) è ancora attivo. Questo impedisce a un host che osserva lo stato, come un elenco di sessioni remote, di annunciare che Claude sta aspettando il vostro input a metà lavoro. I comandi shell in background, come un server di sviluppo, non mantengono lo stato di esecuzione. Il predefinito dello stato di esecuzione e l'opt-out di `0` richiedono Claude Code v2.1.269 o successivo; su versioni precedenti, impostare `1` per mantenere lo stato di esecuzione |

230| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole di fonti di certificati CA per le connessioni TLS. `bundled` è l'insieme Mozilla CA fornito con Claude Code. `system` è l'archivio di fiducia del sistema operativo, letto solo su runtime con `tls.getCACertificates`: il binario nativo, o Node 22.15 o successivo per le installazioni npm. Vedere [Archivio di certificati CA](/docs/it/network-config#ca-certificate-store). L'impostazione predefinita è `bundled,system` |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Impostato automaticamente nei sottoprocessi dello strumento Bash e [comando hook](/docs/it/hooks) mentre la sessione ha una connessione [Remote Control](/docs/it/remote-control) attiva, e rimosso quando la connessione termina. Il valore è l'ID della sessione in forma `session_`, lo stesso identificatore che appare nell'URL `claude.ai/code` della sessione, quindi uno script può collegarsi di nuovo alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successivo. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), leggere `CLAUDE_CODE_REMOTE_SESSION_ID` |

231| `CLAUDE_CODE_CHILD_SESSION` | Impostato a `1` nei sottoprocessi che Claude Code genera tramite gli strumenti Bash, PowerShell e Monitor, i comandi [hook](/docs/it/hooks), e i comandi [status line](/docs/it/statusline). Non impostato per i sottoprocessi [server MCP](/docs/it/mcp) stdio, che sono di lunga durata e sopravvivono alla sessione che li ha generati. A differenza di `CLAUDECODE`, questo è impostato solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione nidificata da un `claude` di primo livello avviato in un terminale integrato IDE. Un `claude` TUI interattivo nidificato avviato in questo modo è automaticamente escluso da `--resume`, `--continue`, cronologia freccia su, e l'elenco `claude agents`. Le sessioni non interattive `claude -p` persistono ancora. Impostare `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per ignorare questa esclusione. Richiede Claude Code v2.1.172 o successivo |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Impostare su `0` per fare in modo che Claude Code legga il byte `0x08`, anche scritto `^H`, come Backspace semplice, o `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono il 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 Backspace semplice su macOS e Linux. Impostare `0` in un terminale Windows dove [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 di fonti di certificati CA per le connessioni TLS. `bundled` è l'insieme Mozilla CA fornito con Claude Code. `system` è l'archivio di fiducia del sistema operativo, letto solo su runtime con `tls.getCACertificates`: il binario nativo, o Node 22.15 o successivo per le installazioni npm. Vedere [Archivio di certificati CA](/docs/it/network-config#ca-certificate-store). Il predefinito è `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Impostato su `1` nei sottoprocessi che Claude Code genera tramite gli strumenti Bash, PowerShell e Monitor, comandi [hook](/docs/it/hooks) e comandi [linea di stato](/docs/it/statusline). Non impostato per i sottoprocessi [server MCP](/docs/it/mcp) stdio, che sono di lunga durata e sopravvivono alla sessione che li ha generati. A differenza di `CLAUDECODE`, questo è impostato solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione nidificata da un `claude` di primo livello avviato in un terminale integrato IDE. Una `claude` TUI interattiva nidificata avviata in questo modo è automaticamente esclusa da `--resume`, `--continue`, cronologia freccia su e l'elenco `claude agents`. Le sessioni non interattive `claude -p` persistono comunque. Impostare `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per ignorare questa esclusione. Richiede Claude Code v2.1.172 o successivo |

235| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Rimosso nella v2.1.186 e ora un no-op. In precedenza impostava un timeout separato per la fase di connessione, TLS e intestazione di risposta di una richiesta API in streaming. Utilizzare `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase di intestazione di risposta di una richiesta in streaming, vedere `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Rimosso nella v2.1.186 e ora un no-op. In precedenza impostava un timeout separato per la fase di connessione, TLS e intestazione di risposta di una richiesta API in streaming. Utilizzare `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase di intestazione di risposta di una richiesta in streaming, vedere `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

236| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sostituire il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede che la modalità debug sia abilitata separatamente tramite `--debug`, `/debug`, o la variabile di ambiente `DEBUG`: impostare solo questa variabile non abilita la registrazione. Il flag [`--debug-file`](/docs/it/cli-reference#cli-flags) fa entrambi contemporaneamente. Impostazione predefinita: `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sostituire il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede l'abilitazione della modalità debug separatamente tramite `--debug`, `/debug` o la variabile di ambiente `DEBUG`: l'impostazione di questa variabile da sola non abilita la registrazione. Il flag [`--debug-file`](/docs/it/cli-reference#cli-flags) fa entrambi contemporaneamente. Impostazione predefinita: `~/.claude/debug/<session-id>.txt` |

237| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Impostare a `verbose` per includere diagnostica ad alto volume come l'output completo del comando della status line, o aumentare a `error` per ridurre il rumore |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Impostare su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della linea di stato, o aumentare a `error` per ridurre il rumore |

238| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Impostare a `1` per disabilitare il supporto della [finestra di contesto 1M](/docs/it/model-config#extended-context). Quando impostato, le varianti del modello 1M non sono disponibili nel selettore del modello, e Claude Code mantiene le sessioni su modelli con una finestra nativa 1M, come [Sonnet 5](/docs/it/model-config#sonnet-5-context-window) e i modelli Fable, a una finestra 200K; vedere [Extended context](/docs/it/model-config#extended-context) per come viene applicato il blocco. Utile per ambienti aziendali con requisiti di conformità. Per il suo ruolo nel correggere la finestra per un ID modello `[1m]` non riconosciuto, vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Impostare su `1` per disabilitare il supporto della [finestra di contesto 1M](/docs/it/model-config#extended-context). Quando impostato, le varianti del modello 1M non sono disponibili nel selettore del modello, e Claude Code mantiene le sessioni su modelli con una finestra nativa 1M, come [Sonnet 5](/docs/it/model-config#sonnet-5-context-window) e i modelli Fable, a una finestra 200K; vedere [Contesto esteso](/docs/it/model-config#extended-context) per come viene applicato il blocco. Utile per gli ambienti aziendali con requisiti di conformità. Per il suo ruolo nel correggere la finestra per un ID modello non riconosciuto `[1m]`, vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

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

240| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Impostare a `1` per impedire a Claude Code di unire i blocchi `env` delle [impostazioni gestite](/docs/it/managed-settings#precedence-within-the-managed-tier) per chiave tra le fonti di amministrazione, in modo che si applichi solo il blocco `env` della fonte con la priorità più alta, come prima della v2.1.223. Impostatelo nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia consegnata attraverso un blocco `env` delle impostazioni. Richiede Claude Code v2.1.223 o successivo |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Impostare su `1` per impedire a Claude Code di unire i blocchi `env` delle [impostazioni gestite](/docs/it/managed-settings#precedence-within-the-managed-tier) per chiave tra le fonti di amministrazione, in modo che si applichi solo il blocco `env` della fonte con la priorità più alta, come prima della v2.1.223. Impostatelo nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia consegnata attraverso un blocco `env` delle impostazioni. Richiede Claude Code v2.1.223 o successivo |

241| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Impostare a `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, in modo che gli script esistenti che lo passano continuino a funzionare senza errori |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Impostare 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, quindi gli script esistenti che lo passano continuano a funzionare senza errori |

242| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Impostare a `1` per disattivare gli [agenti di background e agent view](/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` | Impostare su `1` per disattivare [agenti in background e visualizzazione agente](/docs/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all'impostazione [`disableAgentView`](/docs/it/settings-reference#disableagentview) |

243| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Impostare a `1` per disabilitare il [rendering a schermo intero](/docs/it/fullscreen) e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del vostro terminale in modo che `Cmd+f` e la modalità di copia tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e l'impostazione [`tui`](/docs/it/settings-reference#tui). Potete anche passare con `/tui default`. Non si applica alle sessioni di background aperte da [agent view](/docs/it/agent-view), che utilizzano sempre il rendering a schermo intero |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Impostare su `1` per disabilitare il [rendering a schermo intero](/docs/it/fullscreen) e utilizzare il renderer della schermata principale classica. La conversazione rimane nella cronologia nativa del vostro terminale in modo che `Cmd+f` e la modalità di copia tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e l'impostazione [`tui`](/docs/it/settings-reference#tui). Potete anche passare con `/tui default`. Non si applica alle sessioni in background aperte da [visualizzazione agente](/docs/it/agent-view), che utilizzano sempre il rendering a schermo intero |

244| `CLAUDE_CODE_DISABLE_ARTIFACT` | Impostare a `1` per disattivare lo strumento [Artifact](/docs/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Una volta impostato, nessun file di impostazioni riattiva lo strumento. Per disattivare lo strumento da un file di impostazioni, impostare [`enableArtifact`](/docs/it/settings-reference#enableartifact) a `false`; la chiave deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact) lo disattiva anche |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Impostare 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 impostato, nessun file di impostazioni riattiva lo strumento. Per disattivare lo strumento da un file di impostazioni, impostare [`enableArtifact`](/docs/it/settings-reference#enableartifact) su `false`; la chiave deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact) lo disattiva anche |

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

246| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Impostare a `1` per disabilitare la [memoria automatica](/docs/it/memory#auto-memory). Impostare a `0` per forzare la memoria automatica anche quando la modalità `--bare` o [`autoMemoryEnabled: false`](/docs/it/settings-reference#automemoryenabled) la disabiliterebbero altrimenti. Quando disabilitata, Claude non crea o carica i file di memoria automatica |248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Impostare su `1` per disabilitare la [memoria automatica](/docs/it/memory#auto-memory). Impostare su `0` per forzare la memoria automatica anche quando la modalità `--bare` o [`autoMemoryEnabled: false`](/docs/it/settings-reference#automemoryenabled) la disabiliterebbero altrimenti. Quando disabilitata, Claude non crea o carica i file di memoria automatica |

247| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Impostare a `1` per disabilitare tutta la funzionalità di attività di background, incluso il parametro `run_in_background` sugli strumenti Bash e subagent, l'auto-backgrounding, e la scorciatoia Ctrl+B |249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Impostare su `1` per disabilitare tutta la funzionalità di attività in background, incluso il parametro `run_in_background` sugli strumenti Bash e subagent, l'auto-backgrounding e la scorciatoia Ctrl+B |

248| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Impostare a `1` per impedire a Claude Code di trattare una risposta in streaming [Amazon Bedrock](/docs/it/amazon-bedrock) con un'intestazione `Content-Type` mancante o vuota come il flusso di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia eliminato l'intestazione da una risposta altrimenti non modificata, in modo che decodifichi il corpo e lo streaming continui a funzionare. Impostare questo solo per un gateway che anche ri-emette il flusso come server-sent events; Claude Code legge il corpo senza intestazione come server-sent events. Richiede Claude Code v2.1.239 o successivo |250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Impostare su `1` per impedire a Claude Code di trattare una risposta in streaming [Amazon Bedrock](/docs/it/amazon-bedrock) con un'intestazione `Content-Type` mancante o vuota come flusso di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia eliminato l'intestazione da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostare questo solo per un gateway che anche ri-emette il flusso come server-sent events; Claude Code legge il corpo senza intestazione come server-sent events. Richiede Claude Code v2.1.239 o successivo |

249| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Impostare a `1` per saltare il controllo che una risposta in streaming [Amazon Bedrock](/docs/it/amazon-bedrock) trasporta il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta trasporta un content-type diverso, Claude Code fallisce la richiesta con un errore che nomina quel tipo, il che significa che un [gateway o proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurare il gateway per inoltrare l'intestazione `Content-Type` e il corpo non modificati piuttosto che impostare questa variabile. Richiede Claude Code v2.1.208 o successivo |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Impostare su `1` per saltare il controllo che una risposta in streaming [Amazon Bedrock](/docs/it/amazon-bedrock) trasporta il tipo di contenuto `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta trasporta un tipo di contenuto diverso, Claude Code fallisce la richiesta con un errore che nomina quel tipo, il che significa che un [gateway o proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurare il gateway per inoltrare l'intestazione `Content-Type` e il corpo senza modifiche piuttosto che impostare questa variabile. Richiede Claude Code v2.1.208 o successivo |

250| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Impostare a `1` per impedire ai comandi shell di background in esecuzione di una [sessione di background](/docs/it/agent-view), ai flussi di lavoro dinamici, e, a partire dalla v2.1.198, ai subagent di background quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di trasferirli al processo successivo della sessione. Influisce solo su quel trasferimento: lo sfondo di una sessione con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) continua a trasportare il lavoro in volo, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successivo |252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Impostare su `1` per impedire ai comandi shell in background in esecuzione di una [sessione in background](/docs/it/agent-view), flussi di lavoro dinamici, e, a partire dalla v2.1.198, subagent in background quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di consegnarli al processo successivo della sessione. Influisce solo su quel passaggio: lo sfondo di una sessione con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) continua a trasportare il lavoro in volo, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successivo |

251| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Impostare a `1` per impedire a Claude Code di terminare i [comandi shell di background](/docs/it/interactive-mode#background-bash-commands) quando il sistema operativo segnala pressione di memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina una shell di background avviata nella sessione principale su un segnale di pressione di memoria una volta che la sessione è stata inattiva per 30 minuti e nessun turno o subagent è in esecuzione. Windows non ha un segnale di pressione di memoria, quindi questa variabile non ha effetto lì. Richiede Claude Code v2.1.193 o successivo |253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Impostare su `1` per impedire a Claude Code di terminare i [comandi shell in background](/docs/it/interactive-mode#background-bash-commands) sotto pressione di memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione di memoria critica e la sessione è stata inattiva per 30 minuti senza turno o subagent in esecuzione. Windows non ha un segnale di pressione di memoria, quindi questa variabile non ha effetto lì. Richiede Claude Code v2.1.193 o successivo |

252| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Impostare a `1` per disabilitare le [skills](/docs/it/skills) e i flussi di lavoro inclusi con Claude Code: le skills e i flussi di lavoro raggruppati vengono rimossi completamente, mentre i comandi incorporati come `/init` rimangono digitabili ma sono nascosti dal modello. `/doctor` rimane digitabile come i comandi incorporati; nasconderlo con `DISABLE_DOCTOR_COMMAND`. Le skills dai plugin, `.claude/skills/`, e `.claude/commands/` non sono interessate. Equivalente all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Impostare su `1` per disabilitare le [skill](/docs/it/skills) e i flussi di lavoro inclusi con Claude Code: le skill e i flussi di lavoro raggruppati vengono rimossi completamente, mentre i comandi incorporati come `/init` rimangono digitabili ma nascosti dal modello. `/doctor` rimane digitabile come i comandi incorporati; nasconderlo con `DISABLE_DOCTOR_COMMAND`. Le skill dai plugin, `.claude/skills/` e `.claude/commands/` non sono interessate. Equivalente all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |

253| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Impostare a `1` per mantenere disponibili gli strumenti del browser [Claude in Chrome](/docs/it/chrome) mentre si omette la sezione Chrome del prompt di sistema e la [skill raggruppata](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono la loro guida del browser. Richiede Claude Code v2.1.257 o successivo |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Impostare su `1` per mantenere disponibili gli strumenti del browser [Claude in Chrome](/docs/it/chrome) mentre si omette la sezione Chrome del prompt di sistema e la skill [bundled](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono la loro guida del browser. Richiede Claude Code v2.1.257 o successivo |

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

255| `CLAUDE_CODE_DISABLE_CRON` | Impostare a `1` per disabilitare i [compiti programmati](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e qualsiasi compito già programmato smette di attivarsi, inclusi i compiti che sono già in esecuzione a metà sessione |257| `CLAUDE_CODE_DISABLE_CRON` | Impostare su `1` per disabilitare i [compiti programmati](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e qualsiasi compito già programmato smette di attivarsi, inclusi i compiti che sono già in esecuzione a metà sessione |

256| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Impostare a `1` per rimuovere gli header di richiesta `anthropic-beta` specifici di Anthropic e i campi dello schema dello strumento beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizzare quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. [La ricerca degli strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitata e tutti gli strumenti MCP si caricano in anticipo, anche quando impostate `ENABLE_TOOL_SEARCH`. Su Claude Code v2.1.227 o successivo, le [impostazioni gestite](/docs/it/managed-settings) possono mantenere la ricerca degli strumenti attiva. [Disabilitare le capacità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) copre dove si applica l'override |258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Impostare su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema dello strumento beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizzare quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. [Ricerca strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitata e tutti gli strumenti MCP si caricano in anticipo, anche quando impostate `ENABLE_TOOL_SEARCH`. Su Claude Code v2.1.227 o successivo, le [impostazioni gestite](/docs/it/managed-settings) possono mantenere la ricerca degli strumenti attiva. [Disabilitare le capacità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) copre dove si applica l'override |

257| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Impostare a `1` per disabilitare i [subagent Explore e Plan incorporati](/docs/it/sub-agents#built-in-subagents). Claude esplora con i suoi strumenti di ricerca o il subagent di uso generale, e la [modalità plan](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente piuttosto che lanciare agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent incorporato in Agent SDK o modalità non interattiva, utilizzare `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successivo |259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Impostare su `1` per disabilitare i [subagent Explore e Plan](/docs/it/sub-agents#built-in-subagents) incorporati. Claude esplora con i suoi strumenti di ricerca o il subagent di uso generale, e la [modalità piano](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente piuttosto che lanciare agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent incorporato in Agent SDK o modalità non interattiva, utilizzare `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successivo |

259| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Impostare a `1` per disabilitare i sondaggi sulla qualità della sessione "Come sta andando Claude?". I sondaggi sono anche disabilitati quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non aderisca di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizzare l'impostazione [`feedbackSurveyRate`](/docs/it/settings-reference#feedbacksurveyrate). Vedere [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) |261| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Impostare su `1` per disabilitare i sondaggi sulla qualità della sessione "Come sta andando Claude?". I sondaggi sono anche disabilitati quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non aderisca di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizzare l'impostazione [`feedbackSurveyRate`](/docs/it/settings-reference#feedbacksurveyrate). Vedere [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) |

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

261| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Impostare a `1` per rimuovere le istruzioni di flusso di lavoro di commit e PR incorporate e lo snapshot dello stato git dal prompt di sistema di Claude. Utile quando si utilizzano le proprie skill di flusso di lavoro git. Ha la precedenza sull'impostazione [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) quando impostato |263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Impostare su `1` per rimuovere le istruzioni di flusso di lavoro di commit e PR incorporate e lo snapshot dello stato git dal contesto di Claude. Utile quando si utilizzano le proprie skill di flusso di lavoro git. Ha la precedenza sull'impostazione [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) quando impostato |

262| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Impostare a `1` per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull'API Anthropic. Utilizzare quando desiderate intenzionalmente bloccare un modello più vecchio. Il remapping non viene eseguito su Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry |264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Impostare su `1` per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull'API Anthropic. Utilizzare quando desiderate intenzionalmente bloccare un modello più vecchio. Il remapping non viene eseguito su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry |

263| `CLAUDE_CODE_DISABLE_MOUSE` | Impostare a `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Utilizzare per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale |265| `CLAUDE_CODE_DISABLE_MOUSE` | Impostare su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Utilizzare per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale |

264| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Impostare a `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento della rotella del mouse. Utilizzare quando desiderate che lo scorrimento della rotella funzioni all'interno di Claude Code ma non desiderate che i clic posizionino il cursore, espandano l'output dello strumento o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambi sono impostati. Richiede Claude Code v2.1.195 o successivo |266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Impostare su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento della rotella del mouse. Utilizzare quando desiderate che lo scorrimento della rotella funzioni all'interno di Claude Code ma non desiderate che i clic posizionino il cursore, espandano l'output dello strumento o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambi sono impostati. Richiede Claude Code v2.1.195 o successivo |

265| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Impostare a `1` per impedire a Claude Code di rileggere il [certificato client mTLS e la chiave](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un reset della connessione o un errore di handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo quando applica successivamente le impostazioni o al prossimo avvio. Richiede Claude Code v2.1.232 o successivo |267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Impostare su `1` per impedire a Claude Code di rileggere il [certificato client mTLS e la chiave](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un ripristino della connessione o un errore di handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo quando applica successivamente le impostazioni o al prossimo avvio. Richiede Claude Code v2.1.232 o successivo |

266| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Impostare a qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: auto-aggiornamenti, telemetria, segnalazione di errori, il comando `/feedback`, [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), note di rilascio, i controlli del [badge di stato PR e MR](/docs/it/interactive-mode#pr-review-status), e controlli di disponibilità come il controllo della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni di background delle fonti di comando del plugin](/docs/it/plugin-marketplaces#when-claude-code-re-runs-the-command), che sono comandi locali piuttosto che traffico di rete, perché possono attivare installazioni di dipendenze. **L'impostazione a `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per consentirlo di nuovo. Disabilita anche il recupero dei flag di funzionalità, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. L'auto-installazione del marketplace ufficiale dei plugin non è coperta; disabilitarla con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sulla [scoperta del modello gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha il suo opt-in |268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Impostare su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: auto-aggiornamenti, telemetria, segnalazione di errori, il comando `/feedback`, [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), note di rilascio, i controlli del [badge di stato PR e MR](/docs/it/interactive-mode#pr-review-status), e i controlli di disponibilità come il controllo della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni in background delle fonti di comando del plugin](/docs/it/plugin-marketplaces#when-claude-code-re-runs-the-command), che sono comandi locali piuttosto che traffico di rete, perché possono attivare installazioni di dipendenze. **L'impostazione su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per consentirlo di nuovo. Disabilita anche il recupero dei flag di funzionalità, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. L'auto-installazione del marketplace ufficiale dei plugin non è coperta; disabilitarla con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sulla [scoperta del modello gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha il suo opt-in |

267| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Impostare a `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà flusso. Gli errori di streaming si propagano al livello di ripetizione. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione duplicata dello strumento |269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Impostare su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà flusso. Gli errori di streaming si propagano al livello di ripetizione. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione dello strumento duplicata |

268| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Impostare a `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre state digitando nel terminale o siete focalizzati su di esso. Per impostazione predefinita lo strumento salta sia la notifica desktop che il [push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva attività da tastiera recente o focus del terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere il push mobile quando rileva che siete attivi. Richiede Claude Code v2.1.193 o successivo |270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Impostare su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre state digitando nel terminale o siete focalizzati su di esso. Per impostazione predefinita lo strumento salta sia la notifica desktop che il [push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva un'attività di tastiera recente o la messa a fuoco del terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere il push mobile quando rileva che siete attivi. Richiede Claude Code v2.1.193 o successivo |

269| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Impostare a `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo di una macchina. Se la variabile è impostata a quel punto, Claude Code salta la registrazione in modo permanente. L'annullamento dell'impostazione della variabile in seguito non annulla il salto. Eseguire `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Impostare su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo di una macchina. Se la variabile è impostata a quel punto, Claude Code salta la registrazione in modo permanente. L'annullamento dell'impostazione della variabile in seguito non annulla il salto. Eseguire `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |

270| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Impostare a `1` per impedire a Claude Code di eseguire i vostri [hook `Notification` per richieste di permesso senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Impostare su `1` per impedire a Claude Code di eseguire i vostri [hook `Notification` per le richieste di autorizzazione senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo |

271| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Impostare a `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per sessioni di container o CI che non devono caricare le skill fornite dall'operatore |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Impostare su `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per le sessioni di container o CI che non dovrebbero caricare le skill fornite dall'operatore |

272| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Impostare a `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Nelle sessioni Agent SDK e `claude -p`, questo salta anche la richiesta del modello piccolo/veloce di background che genera il titolo della sessione |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Impostare su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta del modello piccolo/veloce in background che [genera un titolo di sessione](/docs/it/sessions#name-your-sessions) |

273| `CLAUDE_CODE_DISABLE_THINKING` | Impostare a `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il [thinking esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il thinking sui modelli Fable, che non possono avere il thinking disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì |275| `CLAUDE_CODE_DISABLE_THINKING` | Impostare su `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il pensiero sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì |

274| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Impostare a `1` per saltare la [auto-compattazione](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Impostare su `1` per saltare la [auto-compattazione](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo |

275| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Impostare a `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) e eseguire il rendering di ogni messaggio nella trascrizione. Utilizzare se lo scorrimento in modalità a schermo intero mostra regioni vuote dove dovrebbero apparire i messaggi |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Impostare su `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) e eseguire il rendering di ogni messaggio nella trascrizione. Utilizzare se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero apparire i messaggi |

276| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Impostare a `1` per disabilitare i [flussi di lavoro](/docs/it/workflows#turn-workflows-off). Equivalente all'impostazione [`disableWorkflows`](/docs/it/settings-reference#disableworkflows) |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Impostare su `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente invece che attraverso 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 [trasferirsi al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [mettete in background la sessione](/docs/it/agent-view#from-inside-a-session). Se impostate la variabile, un comando PowerShell messo in background si arresta quando il processo della sessione esce. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successivo |

277| `CLAUDE_CODE_EFFORT_LEVEL` | Impostare il livello di effort per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max`, o `auto` per utilizzare l'impostazione predefinita del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort`, e le impostazioni `modelSettings` e `effortLevel`. Un limite [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) si applica comunque. Vedere [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) |279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Impostare su `1` per disabilitare i [flussi di lavoro](/docs/it/workflows#turn-workflows-off). Equivalente all'impostazione [`disableWorkflows`](/docs/it/settings-reference#disableworkflows) |

278| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | Impostare a `1` per abilitare l'aggiunta di testo extra alla fine del prompt di sistema di ogni [subagent](/docs/it/sub-agents) diverso da un [subagent biforcato](/docs/it/sub-agents#fork-the-current-conversation). I flag [`--append-subagent-system-prompt`](/docs/it/cli-reference#cli-flags) e [`--append-subagent-system-prompt-file`](/docs/it/cli-reference#cli-flags) forniscono il testo aggiunto e impostano questa variabile automaticamente, quindi non è necessario impostarla voi stessi. Richiede Claude Code v2.1.205 o successivo |280| `CLAUDE_CODE_EFFORT_LEVEL` | Impostare il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max`, o `auto` per utilizzare il predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e le impostazioni `modelSettings` e `effortLevel`. Un limite [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) si applica comunque. Vedere [Regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level) |

279| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Accettato per compatibilità con versioni precedenti e non ha effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, incluso Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, e sessioni del [gateway app Claude](/docs/it/claude-apps-gateway) con accesso. Nella v2.1.158 attraverso v2.1.206, l'impostazione di questo a `1` era necessaria per rendere la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) disponibile su quei provider |281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Accettato per la 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 sessioni del [gateway app Claude](/docs/it/claude-apps-gateway) con accesso. Nella v2.1.158 attraverso v2.1.206, l'impostazione su `1` era necessaria per rendere la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) disponibile su quei provider |

280| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sostituire la disponibilità del [riepilogo della sessione](/docs/it/interactive-mode#session-recap). Impostare a `0` per forzare i riepiloghi disattivati indipendentemente dall'interruttore `/config`. Impostare a `1` per forzare i riepiloghi attivati quando [`awaySummaryEnabled`](/docs/it/settings-reference#awaysummaryenabled) è `false`. Ha la precedenza sull'impostazione e l'interruttore `/config` |282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sostituire la disponibilità del [riepilogo della sessione](/docs/it/interactive-mode#session-recap). Impostare su `0` per forzare i riepiloghi disattivati indipendentemente dall'interruttore `/config`. Impostare su `1` per forzare i riepiloghi attivati quando [`awaySummaryEnabled`](/docs/it/settings-reference#awaysummaryenabled) è `false`. Ha la precedenza sull'impostazione e sull'interruttore `/config` |

281| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Impostare a `1` per aggiornare lo stato del plugin ai confini dei turni in [modalità non interattiva](/docs/it/headless) dopo il completamento di un'installazione di background. Disattivato per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, il che invalida la [memorizzazione in cache del prompt](/docs/it/prompt-caching) per quel turno |283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Impostare su `1` per aggiornare lo stato del plugin ai confini dei turni in [modalità non interattiva](/docs/it/headless) dopo il completamento di un'installazione in background. Disattivato per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, il che invalida la [memorizzazione in cache del prompt](/docs/it/prompt-caching) per quel turno |

282| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Impostare a `1` per instradare il sondaggio sulla qualità della sessione "Come sta andando Claude?" al vostro [collettore OpenTelemetry](/docs/it/monitoring-usage) quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro collettore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, o `DO_NOT_TRACK` è impostato, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la politica di feedback del prodotto dell'organizzazione hanno la precedenza |284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Impostare su `1` per instradare il sondaggio sulla qualità della sessione "Come sta andando Claude?" al vostro [raccoglitore OpenTelemetry](/docs/it/monitoring-usage) quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro raccoglitore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK` è impostato, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la politica di feedback del prodotto dell'organizzazione hanno la precedenza |

283| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate di strumento vengono trasmessi dall'API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su Amazon Bedrock e Google Cloud's Agent Platform, abilitato per modello dove il contenitore distribuito lo supporta. Impostare a `0` per rinunciare. Impostare a `1` per forzare l'attivazione quando si instrada attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Microsoft Foundry e connessioni [gateway](/docs/it/llm-gateway) |285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate di strumento vengono trasmessi dall'API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su Amazon Bedrock e Google Cloud's Agent Platform, abilitato per modello dove il contenitore distribuito lo supporta. Impostare su `0` per rinunciare. Impostare su `1` per forzare l'attivazione quando si instrada attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Microsoft Foundry e connessioni [gateway](/docs/it/llm-gateway) |

284| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Impostare a `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del vostro 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 supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati da un'allowlist [`availableModels`](/docs/it/settings-reference#availablemodels) che la sessione riceve; consegnare l'elenco tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), poiché la [consegna gestita dal server non è disponibile su configurazioni gateway](/docs/it/server-managed-settings#platform-availability) |286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Impostare su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del vostro 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 supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati da un'allowlist [`availableModels`](/docs/it/settings-reference#availablemodels) che la sessione riceve; consegnare l'elenco tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), poiché la [consegna gestita dal server non è disponibile su configurazioni gateway](/docs/it/server-managed-settings#platform-availability) |

285| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimosso nella v2.1.142, quando l'impostazione predefinita della [modalità veloce](/docs/it/fast-mode) è passata da Opus 4.6 a Opus 4.7 |287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimosso nella v2.1.142, quando il predefinito della [modalità veloce](/docs/it/fast-mode) si è spostato da Opus 4.6 a Opus 4.7 |

286| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Impostare a `false` per disattivare i suggerimenti di prompt, le previsioni grigie che appaiono nell'input del prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quello che l'interruttore **Suggerimenti di prompt** in `/config` scrive. Claude Code inoltre [mette in pausa i suggerimenti mentre il vostro account è vicino o al limite di utilizzo](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Impostare a `true` per mantenerli attivi fino a raggiungere il limite. Richiede Claude Code v2.1.238 o successivo. Vedere [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Impostare su `false` per disattivare i suggerimenti di prompt, le previsioni grigie che appaiono nel vostro input di prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quello che l'interruttore **Suggerimenti di prompt** in `/config` scrive. Claude Code inoltre [mette in pausa i suggerimenti mentre il vostro account è vicino o al limite di utilizzo](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Impostare su `true` per mantenerli attivi fino a raggiungere il limite. Richiede Claude Code v2.1.238 o successivo. Vedere [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |

287| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività Claude Code fornisce nelle [sessioni che le hanno](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet`, e `TaskList`. Impostare a `0` per ottenere lo strumento legacy `TodoWrite`. Vedere [Elenco attività](/docs/it/interactive-mode#task-list) |289| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività Claude Code fornisce nelle [sessioni che li hanno](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Impostare su `0` per ottenere lo strumento legacy `TodoWrite`. Vedere [Elenco attività](/docs/it/interactive-mode#task-list) |

288| `CLAUDE_CODE_ENABLE_TELEMETRY` | Impostare a `1` per abilitare la raccolta di dati OpenTelemetry per metriche e registrazione. Obbligatorio prima di configurare gli esportatori OTel. Vedere [Monitoraggio](/docs/it/monitoring-usage) |290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Impostare su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e registrazione. Obbligatorio prima di configurare gli esportatori OTel. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

289| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Impostare a `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di esso, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successivo |291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Impostare su `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di esso, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successivo |

290| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da aspettare dopo che il ciclo di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da aspettare dopo che il ciclo di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |

291| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Impostare a `1` per abilitare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Impostare su `1` per abilitare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |

292| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella vostra shell si applica anche alle [sessioni di background](/docs/it/agent-view) che inviate con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni di background ignoravano un valore esportato dalla shell e utilizzavano qualsiasi copia che il processo supervisore di background ereditava |294| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella vostra shell si applica anche alle [sessioni in background](/docs/it/agent-view) che inviate con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e utilizzavano qualsiasi copia ereditata dal processo supervisore in background |

293| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sostituire il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero |295| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sostituire il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero |

294| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Impostare a `1` per forzare la persistenza della trascrizione, la cronologia dei prompt, e la registrazione di `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione Claude Code. Utilizzare quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o un launcher di background avviato per la prima volta dallo strumento Bash di Claude Code, causa una sessione di primo livello genuina a essere classificata erroneamente come nidificata. 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. Anche onorato su v2.1.169 e precedenti; non ha effetto su v2.1.170 e v2.1.171, dove il rilevamento della sessione nidificata che sostituisce è stato rimosso |296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Impostare su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione di `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione Claude Code. Utilizzare quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o un launcher in background avviato per la prima volta dallo strumento Bash di Claude Code, causa una sessione di primo livello genuina a essere classificata erroneamente come nidificata. 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. Anche onorato su v2.1.169 e precedenti; non ha effetto su v2.1.170 e v2.1.171, dove il rilevamento della sessione nidificata che sostituisce è stato rimosso |

295| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Impostare a `1` per forzare il rendering del barrato per `~~text~~` nelle risposte di Claude quando il vostro terminale lo supporta ma non viene rilevato automaticamente, come su SSH senza `TERM_PROGRAM` inoltrato. Senza questo, i terminali non rilevati mostrano i marcatori letterali `~~` invece di eseguire il rendering del testo come barrato. Richiede Claude Code v2.1.186 o successivo |297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Impostare su `1` per forzare il rendering del barrato per `~~text~~` nelle risposte di Claude quando il vostro terminale lo supporta ma non viene rilevato automaticamente, ad esempio su SSH senza `TERM_PROGRAM` inoltrato. Senza questo, i terminali non rilevati mostrano i marcatori letterali `~~` invece di eseguire il rendering del testo come barrato. Richiede Claude Code v2.1.186 o successivo |

296| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Impostare a `1` per forzare l'abilitazione della modalità privata DEC 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando il vostro terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come Emacs `eat` che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al [rendering a schermo intero](/docs/it/fullscreen), questo non cambia il renderer |298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Impostare su `1` per forzare l'abilitazione della modalità privata DEC 2026 [output sincronizzato](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando il vostro terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al [rendering a schermo intero](/docs/it/fullscreen), questo non cambia il renderer |

297| `CLAUDE_CODE_FORK_SUBAGENT` | Controlla la [modalità fork](/docs/it/sub-agents#turn-fork-mode-on-or-off), che consente a Claude di generare [subagent biforcati](/docs/it/sub-agents#fork-the-current-conversation) e è attiva per impostazione predefinita solo nelle sessioni interattive. Impostare a `1` per attivarla anche in `claude -p` e Agent SDK, o `0` per disattivarla in ogni tipo di sessione. Potete eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. L'impostazione predefinita interattiva richiede Claude Code v2.1.232 o successivo; su versioni precedenti, impostare la variabile a `1` per attivare la modalità fork |299| `CLAUDE_CODE_FORK_SUBAGENT` | Controlla la [modalità fork](/docs/it/sub-agents#turn-fork-mode-on-or-off), che consente a Claude di generare [subagent forkati](/docs/it/sub-agents#fork-the-current-conversation) da solo ed è attiva per impostazione predefinita solo nelle sessioni interattive. Impostare su `1` per attivarla anche in `claude -p` e Agent SDK, o `0` per disattivarla in ogni tipo di sessione. Potete eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. Il predefinito interattivo richiede Claude Code v2.1.232 o successivo; su versioni precedenti, impostare la variabile su `1` per attivare la modalità fork |

298| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Impostare a `1` per emettere i blocchi di testo e thinking del [subagent](/docs/it/sub-agents) nell'output `claude -p --output-format stream-json`, lo stesso comportamento del flag [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags). Utilizzare la variabile quando un harness invoca `claude` e non può passare il flag stesso. A differenza del flag, che esce con un errore al di fuori della modalità non interattiva con output stream-json, la variabile viene ignorata lì in modo che le invocazioni nidificate continuino a funzionare quando è impostata a livello di processo. Richiede Claude Code v2.1.211 o successivo |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Impostare su `1` per emettere blocchi di testo e pensiero del [subagent](/docs/it/sub-agents) nell'output `claude -p --output-format stream-json`, lo stesso comportamento del flag [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags). Utilizzare la variabile quando un harness invoca `claude` e non può passare il flag stesso. A differenza del flag, che esce con un errore al di fuori della modalità non interattiva con output stream-json, la variabile viene ignorata lì in modo che le invocazioni nidificate continuino a funzionare quando è impostata a livello di processo. Richiede Claude Code v2.1.211 o successivo |

299| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso all'eseguibile Git Bash (`bash.exe`). Utilizzare quando Git Bash è installato ma non nel vostro PATH. Se il percorso non esiste o il file non è denominato `bash.exe`, `sh.exe`, `bash`, o `sh`, Claude Code ignora la variabile e auto-rileva Git Bash come se fosse non impostata, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code usciva all'avvio quando il percorso non esisteva, e utilizzava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Vedere [Configurazione di Windows](/docs/it/setup#set-up-on-windows) |301| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Impostare su `1` per inviare le [intestazioni di suggerimento 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 un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Impostare su `0` per smettere di inviarle su ogni connessione, inclusa una connessione diretta all'API Anthropic, dove Claude Code le invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successivo |

300| `CLAUDE_CODE_GLOB_HIDDEN` | Impostare a `false` per escludere i dotfile dai risultati quando Claude invoca lo strumento [Glob](/docs/it/tools-reference#glob-tool-behavior). Incluso per impostazione predefinita. Non influisce sull'autocompletamento di file `@`, `ls`, Grep, o Read |302| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in millisecondi per la richiesta di [scoperta del modello gateway](/docs/it/llm-gateway-protocol#model-discovery) che `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` attiva (predefinito: `3000`). Aumentare quando il vostro gateway ha bisogno di più di tre secondi per rispondere a `/v1/models` all'avvio. Accetta solo cifre semplici; `0`, valori negativi e altre ortografie mantengono il predefinito. Richiede Claude Code v2.1.269 o successivo |

301| `CLAUDE_CODE_GLOB_NO_IGNORE` | Impostare a `false` per fare in modo che lo strumento [Glob](/docs/it/tools-reference#glob-tool-behavior) rispetti i modelli `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce sull'autocompletamento di file `@`, che ha la sua impostazione [`respectGitignore`](/docs/it/settings-reference#respectgitignore) |303| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso all'eseguibile Git Bash (`bash.exe`). Utilizzare quando Git Bash è installato ma non nel vostro PATH. Se il percorso non esiste o il file non è denominato `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e auto-rileva Git Bash come se fosse non impostato, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code usciva all'avvio quando il percorso non esisteva e utilizzava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Vedere [Configurazione di Windows](/docs/it/setup#set-up-on-windows) |

304| `CLAUDE_CODE_GLOB_HIDDEN` | Impostare su `false` per escludere i dotfile dai risultati quando Claude invoca lo strumento [Glob](/docs/it/tools-reference#glob-tool-behavior). Incluso per impostazione predefinita. Non influisce su `@` autocomplete di file, `ls`, Grep o Read |

305| `CLAUDE_CODE_GLOB_NO_IGNORE` | Impostare su `false` per fare in modo che lo strumento [Glob](/docs/it/tools-reference#glob-tool-behavior) rispetti i modelli `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su `@` autocomplete di file, che ha la sua impostazione [`respectGitignore`](/docs/it/settings-reference#respectgitignore) |

302| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per la scoperta dei file dello strumento Glob. Impostazione predefinita: 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |306| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per la scoperta dei file dello strumento Glob. Impostazione predefinita: 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |

303| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Quanti minuti il lavoro di background può mantenere un obiettivo attivo in attesa prima che Claude Code [chieda a Claude di controllarlo](/docs/it/goal#background-work-defers-evaluation). Predefinito `30`. Impostare `0` per disattivare i check-in. Fornire minuti interi in cifre semplici, al massimo `10080`, che è una settimana. Claude Code tratta qualsiasi altro valore come non impostato e utilizza l'impostazione predefinita. Richiede Claude Code v2.1.234 o successivo |307| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Quanti minuti il lavoro in background può mantenere un obiettivo attivo in attesa prima che Claude Code [chieda a Claude di controllarlo](/docs/it/goal#background-work-defers-evaluation). Predefinito `30`. Impostare `0` per disattivare i check-in. Fornire minuti interi in cifre semplici, al massimo `10080`, che è una settimana. Claude Code tratta qualsiasi altro valore come non impostato e utilizza il predefinito. Richiede Claude Code v2.1.234 o successivo |

304| `CLAUDE_CODE_HIDE_CWD` | Impostare a `1` per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni dove il percorso espone il vostro nome utente del sistema operativo |308| `CLAUDE_CODE_HIDE_CWD` | Impostare su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni dove il percorso espone il vostro nome utente del sistema operativo |

305| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sostituire l'indirizzo host utilizzato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code auto-rileva l'indirizzo corretto, incluso l'instradamento WSL-to-Windows |309| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sostituire l'indirizzo host utilizzato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code auto-rileva l'indirizzo corretto, incluso l'instradamento WSL-to-Windows |

306| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Impostare a `1` per saltare l'auto-installazione delle estensioni IDE. Equivalente all'impostazione [`autoInstallIdeExtension`](/docs/it/settings-reference#autoinstallideextension) a `false` |310| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Impostare su `1` per saltare l'auto-installazione delle estensioni IDE. Equivalente all'impostazione [`autoInstallIdeExtension`](/docs/it/settings-reference#autoinstallideextension) su `false` |

307| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Impostare a `1` per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizzare quando l'auto-connessione non riesce a trovare il vostro IDE nonostante sia in esecuzione |311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Impostare su `1` per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizzare quando l'auto-connessione non riesce a trovare il vostro IDE nonostante sia in esecuzione |

308| `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 rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi cosa diversa viene ignorata, quindi il limite può essere regolato ma non disabilitato. Richiede Claude Code v2.1.217 o successivo |312| `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 rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altra cosa viene ignorata, quindi la variabile può regolare il limite ma non disabilitarlo. Richiede Claude Code v2.1.217 o successivo |

309| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sostituire la dimensione della finestra di contesto che Claude Code presume per il modello attivo. A partire dalla v2.1.193, come si applica dipende da come Claude Code risolve l'ID del modello; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Utilizzare quando si instrada a un modello attraverso `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione incorporata per il suo nome |313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sostituire la dimensione della finestra di contesto che Claude Code presume per il modello attivo. A partire dalla v2.1.193, come si applica dipende da come Claude Code risolve l'ID del modello; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Utilizzare quando si instrada a un modello attraverso `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione incorporata per il suo nome |

310| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Impostare il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e i limiti variano per modello; vedere [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code impostazione predefinita a 32000 per gli ID modello che non riconosce, come i nomi specifici del gateway, e abbassa i valori superiori al limite di un modello al limite. L'aumento di questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la [auto-compattazione](/docs/it/costs#reduce-token-usage) |314| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Impostare il numero massimo di token di output per la maggior parte delle richieste. I predefiniti e i limiti variano per modello; vedere [token di output massimi](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code impostazione predefinita a 32000 per gli ID modello che non riconosce, come i nomi specifici del gateway, e abbassa i valori superiori al limite di un modello al limite. L'aumento di questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la [auto-compattazione](/docs/it/costs#reduce-token-usage) |

311| `CLAUDE_CODE_MAX_RETRIES` | Sostituire il numero di volte per riprovare 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 l'impostazione predefinita e rimuove il limite. Per le sessioni non presenziate che devono aspettare attraverso interruzioni più lunghe, impostare `CLAUDE_CODE_RETRY_WATCHDOG` |315| `CLAUDE_CODE_MAX_RETRIES` | Sostituire il numero di volte per riprovare 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 predefinito e rimuove il limite. Per le sessioni non presidiate che devono aspettare attraverso interruzioni più lunghe, impostare `CLAUDE_CODE_RETRY_WATCHDOG` |

312| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Rimosso nella v2.1.224 e ora un no-op. 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 concorrente](/docs/it/sub-agents#concurrent-subagent-limit) e il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) si applicano comunque |316| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Rimosso nella v2.1.224 e ora un no-op. 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 concorrente](/docs/it/sub-agents#concurrent-subagent-limit) e il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) si applicano comunque |

313| `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). All'impostazione predefinita, i subagent possono generare i loro subagent, e un subagent al terzo livello non può generare ulteriormente; impostare `1` per disattivare l'annidamento. Nella v2.1.217 attraverso v2.1.218, l'impostazione predefinita era 1, quindi un subagent non poteva generare il suo a meno che non aumentaste il limite; v2.1.219 ha aumentato l'impostazione predefinita a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi cosa diversa viene ignorata, quindi il limite può essere regolato ma non rimosso. Richiede Claude Code v2.1.217 o successivo |317| `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). Al predefinito, i subagent possono generare i loro subagent e un subagent al terzo livello non può generare ulteriormente; impostare `1` per disattivare l'annidamento. Nella v2.1.217 attraverso v2.1.218, il predefinito era 1, quindi un subagent non poteva generare il suo a meno che non aumentaste il limite; v2.1.219 ha aumentato il predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altra cosa viene ignorata, quindi il limite può essere regolato ma non rimosso. Richiede Claude Code v2.1.217 o successivo |

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

315| `CLAUDE_CODE_MAX_TURNS` | Limitare il numero di turni agentici quando non viene passato un limite esplicito. Equivalente a passare [`--max-turns`](/docs/it/cli-reference#cli-flags), che ha la precedenza quando entrambi sono impostati. Un valore che non è un numero intero positivo viene rifiutato all'avvio con un errore piuttosto che trattato come nessun limite |319| `CLAUDE_CODE_MAX_TURNS` | Limitare il numero di turni agenti quando non viene passato un limite esplicito. Equivalente a passare [`--max-turns`](/docs/it/cli-reference#cli-flags), che ha la precedenza quando entrambi sono impostati. Un valore che non è un numero intero positivo viene rifiutato all'avvio con un errore piuttosto che trattato come nessun limite |

316| `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, le ulteriori chiamate WebSearch restituiscono un avviso che gli dice di continuare con le informazioni che ha già raccolto. Accetta un numero intero positivo senza limite superiore. Qualsiasi cosa diversa viene ignorata e si applica l'impostazione predefinita, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successivo |320| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite sul numero totale di chiamate [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) che una sessione può effettuare (predefinito: 200). Quando Claude raggiunge il limite, le ulteriori chiamate WebSearch restituiscono un avviso che gli dice di continuare con le informazioni che ha già raccolto. Accetta un numero intero positivo senza limite superiore. Qualsiasi altra cosa viene ignorata e si applica il predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successivo |

317| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Impostare a `1` per generare i server MCP stdio con solo un ambiente di base sicuro più il `env` configurato del server, invece di ereditare l'ambiente della vostra shell |321| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Impostare su `1` per generare i server MCP stdio con solo un ambiente di base sicuro più il `env` configurato del server, invece di ereditare l'ambiente della vostra shell |

318| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo trascorso in millisecondi prima che una chiamata di strumento MCP ancora in esecuzione [si sposti a un'attività di background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) (predefinito: 120000, o 2 minuti). Impostare a `0` per disattivare l'auto-backgrounding. Richiede Claude Code v2.1.212 o successivo |322| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo trascorso in millisecondi prima che una chiamata di strumento MCP ancora in esecuzione [si sposti a un'attività in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) (predefinito: 120000, o 2 minuti). Impostare su `0` per disattivare l'auto-backgrounding. Richiede Claude Code v2.1.212 o successivo |

319| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout di inattività in millisecondi per le chiamate di 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 risposta e nessuna notifica di progresso per questo lungo, la chiamata dello strumento interrompe con un errore invece di aspettare il `MCP_TOOL_TIMEOUT` complessivo. Sostituisce i valori predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Impostare a `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono aumentati 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 `timeout`. Non si applica ai server IDE o ai server in-process SDK. Richiede Claude Code v2.1.187 o successivo. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività |323| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Quanto a lungo in millisecondi il primo turno di una sessione [non interattiva](/docs/it/headless) aspetta i server MCP ancora in connessione, al posto dell'[attesa del primo turno](/docs/it/agent-sdk/mcp#connection-timing) predefinita. Quando impostato, l'attesa copre ogni server in sospeso. Impostare su `0` per saltare l'attesa. Un server [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) mantiene la sua propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successivo |

324| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout di inattività in millisecondi per le chiamate di 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 risposta e nessuna notifica di progresso per questo lungo, la chiamata dello strumento si interrompe con un errore invece di aspettare il `MCP_TOOL_TIMEOUT` complessivo. Sostituisce i predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Impostare su `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono aumentati 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 `timeout`. Non si applica ai server IDE o ai server in-process SDK. Richiede Claude Code v2.1.187 o successivo. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività |

320| `CLAUDE_CODE_MESSAGING_SOCKET` | Impostato da Claude Code, non da voi: nelle sessioni che vincolano un [socket della posta in arrivo](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta il percorso di quel socket ai hook e ai comandi Bash quando vincola il socket. In una sessione che inizia con la messaggistica attiva, Claude Code vincola il socket prima che qualsiasi hook venga eseguito. Altre sessioni sulla macchina consegnano i messaggi a questo percorso. Ogni sessione esporta il suo socket piuttosto che uno ereditato da un genitore, e i messaggi che arrivano su di esso passano attraverso i [controlli in entrata](/docs/it/cross-session-messaging#control-inbound-messages) della sessione. I blocchi `env` delle impostazioni non possono impostarlo. Richiede Claude Code v2.1.224 o successivo |325| `CLAUDE_CODE_MESSAGING_SOCKET` | Impostato da Claude Code, non da voi: nelle sessioni che vincolano un [socket della posta in arrivo](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta il percorso di quel socket ai hook e ai comandi Bash quando vincola il socket. In una sessione che inizia con la messaggistica attiva, Claude Code vincola il socket prima che qualsiasi hook venga eseguito. Altre sessioni sulla macchina consegnano i messaggi a questo percorso. Ogni sessione esporta il suo socket piuttosto che uno ereditato da un genitore, e i messaggi che arrivano su di esso passano attraverso i [controlli in entrata](/docs/it/cross-session-messaging#control-inbound-messages) della sessione. I blocchi `env` delle impostazioni non possono impostarlo. Richiede Claude Code v2.1.224 o successivo |

321| `CLAUDE_CODE_MESSAGING_TOKEN` | Impostato da Claude Code, non da voi: nelle sessioni che vincolano un [socket della posta in arrivo](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta questo token per sessione ai hook e ai comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che invia al socket può inviare `{"type":"auth","token":"<token>"}` come sua prima riga per provare che appartiene alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non si apre con una valida. Le [regole di child proprio](/docs/it/cross-session-messaging#the-sessions-inbox-socket) dicono quando Claude Code consulta il token. Ogni sessione esporta il suo token, mai uno ereditato da una sessione genitore. I blocchi `env` delle impostazioni non possono impostarlo. Richiede Claude Code v2.1.228 o successivo |326| `CLAUDE_CODE_MESSAGING_TOKEN` | Impostato da Claude Code, non da voi: nelle sessioni che vincolano un [socket della posta in arrivo](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta questo token per sessione ai hook e ai comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che invia al socket può inviare `{"type":"auth","token":"<token>"}` come sua prima riga per provare che appartiene alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non si apre con una valida. Le [regole dei propri figli](/docs/it/cross-session-messaging#the-sessions-inbox-socket) dicono quando Claude Code consulta il token. Ogni sessione esporta il suo token, mai uno ereditato da una sessione genitore. I blocchi `env` delle impostazioni non possono impostarlo. Richiede Claude Code v2.1.228 o successivo |

322| `CLAUDE_CODE_NATIVE_CURSOR` | Impostare a `1` per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e focus del terminale |327| `CLAUDE_CODE_NATIVE_CURSOR` | Impostare su `1` per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e messa a fuoco del terminale |

323| `CLAUDE_CODE_NEW_INIT` | Impostare a `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 la base di codice e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere |328| `CLAUDE_CODE_NEW_INIT` | Impostare 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 la base di codice e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere |

324| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Impostare a `1` per scrivere l'output del terminale attraverso un secondo descrittore di file non bloccante, in modo che un terminale che smette di leggere, come un riquadro di modalità di controllo tmux in pausa o una connessione SSH bloccata, non possa congelare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successivo |329| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Impostare su `1` per scrivere l'output del terminale attraverso un secondo descrittore di file non bloccante, in modo che un terminale che smette di leggere, come un riquadro di controllo tmux in pausa o una connessione SSH bloccata, non possa congelare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successivo |

325| `CLAUDE_CODE_NO_FLICKER` | Impostare a `1` per abilitare il [rendering a schermo intero](/docs/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Sostituisce l'impostazione [`tui`](/docs/it/settings-reference#tui); potete anche passare con `/tui fullscreen` |330| `CLAUDE_CODE_NO_FLICKER` | Impostare su `1` per abilitare il [rendering a schermo intero](/docs/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Sostituisce l'impostazione [`tui`](/docs/it/settings-reference#tui); potete anche passare con `/tui fullscreen` |

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

327| `CLAUDE_CODE_OAUTH_SCOPES` | Scopi OAuth separati da spazi che il token di aggiornamento è stato emesso con, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatorio quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostato |332| `CLAUDE_CODE_OAUTH_SCOPES` | Ambiti OAuth separati da spazi con cui il token di aggiornamento è stato emesso, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatorio quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostato |

328| `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 archiviate nel portachiavi. Generarne uno con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token). A meno che non eseguiate [`/login`](/docs/it/authentication#authentication-precedence), Claude Code utilizza il token che impostate per l'intera sessione. Per sostituire un token scaduto, generarne uno nuovo e riavviate |333| `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 archiviate nel portachiavi. Generarne uno con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token). A meno che non eseguiate [`/login`](/docs/it/authentication#authentication-precedence), Claude Code utilizza il token che impostate per l'intera sessione. Per sostituire un token scaduto, generarne uno nuovo e riavviate |

329| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Rimosso nella v2.1.160 e ora un no-op. In precedenza bloccava la [modalità veloce](/docs/it/fast-mode) a Claude Opus 4.6 invece dell'impostazione predefinita corrente. Opus 4.6 non supporta più la modalità veloce |334| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Rimosso nella v2.1.160 e ora un no-op. In precedenza bloccava la [modalità veloce](/docs/it/fast-mode) a Claude Opus 4.6 invece del predefinito corrente. Opus 4.6 non supporta più la modalità veloce |

330| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Lunghezza massima degli attributi OpenTelemetry che trasportano contenuto (risposte del modello, contenuto dello strumento, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, cioè 60 KB). Aumentare solo se il vostro backend di telemetria accetta valori di attributo più grandi di 64 KB, o abbassare per ridurre il volume di telemetria. Richiede Claude Code v2.1.214 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage) |335| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Lunghezza massima degli attributi OpenTelemetry che trasportano contenuto (risposte del modello, contenuto dello strumento, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, cioè 60 KB). Aumentare solo se il vostro backend di telemetria accetta valori di attributo più grandi di 64 KB, o abbassare per ridurre il volume di telemetria. Richiede Claude Code v2.1.214 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

331| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Impostare a `1` per scrivere gli errori diagnostici dell'esportatore OpenTelemetry su stderr. Per impostazione predefinita questi errori appaiono solo con `--debug`, quindi un esportatore non configurato correttamente come una collisione di porta Prometheus altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage) |336| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Impostare su `1` per scrivere gli errori diagnostici dell'esportatore OpenTelemetry su stderr. Per impostazione predefinita questi errori appaiono solo con `--debug`, quindi un esportatore non configurato correttamente come una collisione di porta Prometheus altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

332| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo scaricamento degli span OpenTelemetry in sospeso (predefinito: 5000). Vedere [Monitoraggio](/docs/it/monitoring-usage) |337| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo scaricamento degli span OpenTelemetry in sospeso (predefinito: 5000). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

333| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo per l'aggiornamento degli header OpenTelemetry dinamici in millisecondi (predefinito: 1740000 / 29 minuti). Vedere [Header dinamici](/docs/it/monitoring-usage#dynamic-headers) |338| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo per l'aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedere [Intestazioni dinamiche](/docs/it/monitoring-usage#dynamic-headers) |

334| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi affinché l'esportatore OpenTelemetry finisca all'arresto (predefinito: 2000). Aumentare se le metriche vengono eliminate all'uscita. Vedere [Monitoraggio](/docs/it/monitoring-usage) |339| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi affinché l'esportatore OpenTelemetry finisca all'arresto (predefinito: 2000). Aumentare se le metriche vengono eliminate all'uscita. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

335| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Impostare a `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando è disponibile una nuova versione. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedere [Auto-aggiornamenti](/docs/it/setup#auto-updates) |340| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Impostare su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando è disponibile una nuova versione. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedere [Auto-aggiornamenti](/docs/it/setup#auto-updates) |

336| `CLAUDE_CODE_PERFORCE_MODE` | Impostare a `1` per abilitare la protezione da scrittura consapevole di Perforce. Quando impostato, Edit, Write, e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca il bit di proprietario-scrittura, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |341| `CLAUDE_CODE_PERFORCE_MODE` | Impostare su `1` per abilitare la protezione da scrittura consapevole di Perforce. Quando impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca il bit di proprietario-scrittura, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |

337| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sostituire la directory radice dei plugin. Nonostante il nome, questo imposta la directory genitore, non la cache stessa: i marketplace e la cache dei plugin vivono in sottodirectory sotto questo percorso. Impostazione predefinita: `~/.claude/plugins` |342| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sostituire la directory radice dei plugin. Nonostante il nome, questo imposta la directory genitore, non la cache stessa: i marketplace e la cache dei plugin vivono in sottodirectory sotto questo percorso. Impostazione predefinita: `~/.claude/plugins` |

338| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumentare questo valore per repository grandi o connessioni di rete lente. Vedere [Le operazioni Git scadono](/docs/it/plugin-marketplaces#git-operations-time-out) |343| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumentare questo valore per repository grandi o connessioni di rete lente. Vedere [Le operazioni Git scadono](/docs/it/plugin-marketplaces#git-operations-time-out) |

339| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Impostare a `1` per saltare il tentativo di re-clone e continuare a utilizzare la cache del marketplace esistente quando un `git pull` fallisce. Utile in ambienti offline o airgapped dove il re-clone fallirebbe allo stesso modo. Vedere [Gli aggiornamenti del marketplace falliscono in ambienti offline](/docs/it/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |344| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Impostare su `1` per saltare il tentativo di re-clone e continuare a utilizzare il checkout del marketplace esistente quando un aggiornamento del marketplace non riesce a raggiungere o autenticarsi al remoto. Utile negli ambienti offline o airgapped dove il re-cloning fallirebbe allo stesso modo. Vedere [Gli aggiornamenti del marketplace falliscono negli ambienti offline](/docs/it/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

340| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Impostare a `1` per clonare la scorciatoia GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container, o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |345| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Impostare su `1` per clonare le fonti di scorciatoia GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |

341| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso a una o più directory di seed dei plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizzare per raggruppare una directory di plugin pre-popolata in un'immagine di container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati in cache senza re-clonare. Vedere [Pre-popolare i plugin per i container](/docs/it/plugin-marketplaces#pre-populate-plugins-for-containers) |346| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso a una o più directory di seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizzare per raggruppare una directory di plugin pre-popolata in un'immagine di container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati in cache senza re-clonare. Vedere [Pre-popolare i plugin per i container](/docs/it/plugin-marketplaces#pre-populate-plugins-for-containers) |

342| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Impostare a `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumenti, gli hook e i comandi della status line, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite-Restricted. Il bypass a livello di processo non sostituisce mai il Criterio di gruppo `MachinePolicy` o `UserPolicy` indipendentemente da questa impostazione |347| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Impostare su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumenti, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite-Restricted. Il bypass a livello di processo non sostituisce mai la `MachinePolicy` o la `UserPolicy` di Group Policy indipendentemente da questa impostazione |

343| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite in millisecondi sull'attesa inattiva per i subagent di background e i flussi di lavoro dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude prende un turno per gestire un risultato di background. Predefinito: `600000`, o 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di aspettare i compiti di background rimanenti e esce. Impostare a `0` per aspettare indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica alle shell di background semplici. Richiede Claude Code v2.1.182 o successivo |348| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite in millisecondi sull'attesa inattiva per i subagent in background e i flussi di lavoro dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude prende un turno per gestire un risultato in background. Predefinito: `600000`, o 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di aspettare i compiti in background rimanenti e esce. Impostare su `0` per aspettare indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica alle shell in background semplici. Richiede Claude Code v2.1.182 o successivo |

344| `CLAUDE_CODE_PROCESS_WRAPPER` | Avviare i processi che Claude Code avvia dal suo binario, come il servizio di background che ospita le sessioni [agent view](/docs/it/agent-view), attraverso un launcher aziendale fornito come prefisso argv come `/opt/corp/launcher`. Impostatelo nel blocco `env` delle impostazioni utente o [gestite](/docs/it/managed-settings), non come esportazione di shell, in modo che il servizio di background staccato lo erediti; le impostazioni di progetto e locali non possono impostarlo. Equivalente all'impostazione [`processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successivo; questa variabile ha la precedenza quando entrambi sono impostati. L'estensione VS Code configura il suo launcher separatamente attraverso l'impostazione `claudeProcessWrapper`. Ignorato su Windows. Vedere [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, cosa copre il launcher, e il contratto che il launcher deve soddisfare. Richiede Claude Code v2.1.208 o successivo |349| `CLAUDE_CODE_PROCESS_WRAPPER` | Avviare i processi che Claude Code avvia dal suo binario, come il servizio in background che ospita le sessioni di [visualizzazione agente](/docs/it/agent-view), attraverso un launcher aziendale fornito come prefisso argv come `/opt/corp/launcher`. Impostatelo nel blocco `env` delle impostazioni utente o [gestite](/docs/it/managed-settings), non come esportazione di shell, in modo che il servizio in background staccato lo erediti; le impostazioni di progetto e locali non possono impostarlo. Equivalente all'impostazione [`processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successivo; questa variabile ha la precedenza quando entrambi sono impostati. L'estensione VS Code configura il suo launcher separatamente attraverso la sua impostazione `claudeProcessWrapper`. Ignorato su Windows. Vedere [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, cosa copre il launcher e il contratto che il launcher deve soddisfare. Richiede Claude Code v2.1.208 o successivo |

345| `CLAUDE_CODE_PROJECT_DIR_NAME` | Impostare insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory `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 sotto `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostato, e la legge solo dall'ambiente da cui avviate `claude`, mai da un blocco `env` del [file di impostazioni](#in-settings-files). Vedere [Denominare la directory del progetto voi stessi](/docs/it/sessions#name-the-project-directory-yourself). Richiede Claude Code v2.1.234 o successivo |350| `CLAUDE_CODE_PROJECT_DIR_NAME` | Impostare insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory `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, avviare Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` le memorizza sotto `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostato e la legge solo dall'ambiente da cui avviate `claude`, mai da un blocco `env` del file di impostazioni. Vedere [Denominare la directory del progetto voi stessi](/docs/it/sessions#name-the-project-directory-yourself). Richiede Claude Code v2.1.234 o successivo |

346| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Impostare `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) per la conversazione principale: i vostri 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`, e `FORCE_PROMPT_CACHING_5M` la sostituisce. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Richiede Claude Code v2.1.242 o successivo |351| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Impostare `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) per la conversazione principale: i vostri 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`, e `FORCE_PROMPT_CACHING_5M` la sostituisce. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Richiede Claude Code v2.1.242 o successivo |

347| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Impostare a `1` per propagare il contesto di traccia W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'intestazione `traceparent` sulle richieste del modello e MCP HTTP e la variabile di ambiente `TRACEPARENT` per i sottoprocessi Bash, PowerShell e hook. Per impostazione predefinita, la propagazione è abilitata solo quando connessi direttamente all'API Anthropic. Aggiunto nella v2.1.152. Vedere [Tracce (beta)](/docs/it/monitoring-usage#traces-beta) |352| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Impostare su `1` per propagare il contesto di traccia W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'intestazione `traceparent` sulle richieste del modello e MCP HTTP e la variabile di ambiente `TRACEPARENT` per i sottoprocessi Bash, PowerShell e hook. Per impostazione predefinita, la propagazione è abilitata solo quando connessi direttamente all'API Anthropic. Aggiunto nella v2.1.152. Vedere [Tracce (beta)](/docs/it/monitoring-usage#traces-beta) |

348| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostato da piattaforme host che incorporano Claude Code e gestiscono l'instradamento del provider di modelli per suo conto. Quando impostato, Claude Code ignora le variabili di selezione del provider, endpoint e autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, e `ANTHROPIC_API_KEY` nei file di impostazioni, in modo che le impostazioni utente non possono ignorare 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), qualsiasi fonte gestita le consegni, in modo che la configurazione del modello dell'host ha la precedenza su un pin del modello gestito non aggiornato. Claude Code ignora anche 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 fornisca la sua. Claude Code salta anche l'opt-out di telemetria automatica che altrimenti applica su provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, e Microsoft Foundry, in modo che la telemetria segua l'opt-out standard `DISABLE_TELEMETRY`. Vedere [Comportamenti predefiniti per provider API](/docs/it/data-usage#default-behaviors-by-api-provider) |353| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostato da piattaforme host che incorporano Claude Code e gestiscono l'instradamento del provider di modelli per suo conto. Quando impostato, Claude Code ignora le variabili di selezione del provider, endpoint e autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni, in modo che le impostazioni utente non possono ignorare 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 fonte gestita le consegni, in modo che la configurazione del modello dell'host ha la precedenza su un pin del modello gestito non aggiornato. Claude Code ignora anche 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 fornisca la sua. Claude Code salta anche l'opt-out di telemetria automatica che altrimenti applica su provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, in modo che la telemetria segua l'opt-out standard `DISABLE_TELEMETRY`. Vedere [Comportamenti predefiniti per provider API](/docs/it/data-usage#default-behaviors-by-api-provider) |

349| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Impostare a `1` per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per ambienti in cui il proxy dovrebbe gestire la risoluzione del nome host |354| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Impostare su `1` per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per gli ambienti in cui il proxy dovrebbe gestire la risoluzione del nome host |

350| `CLAUDE_CODE_REMOTE` | Impostato automaticamente a `true` quando Claude Code è in esecuzione come una [sessione cloud](/docs/it/claude-code-on-the-web). Leggere questo da un hook o script di configurazione per rilevare se siete in una sessione cloud |355| `CLAUDE_CODE_REMOTE` | Impostato automaticamente su `true` quando Claude Code è in esecuzione come una [sessione cloud](/docs/it/claude-code-on-the-web). Leggere questo da un hook o script di configurazione per rilevare se siete in una sessione cloud |

351| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostato automaticamente nelle [sessioni cloud](/docs/it/claude-code-on-the-web) all'ID della sessione corrente. Leggere questo per costruire un link di ritorno alla trascrizione della sessione. Vedere [Collegare l'output di ritorno alla sessione](/docs/it/cloud-environments#link-output-back-to-the-session) |356| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostato automaticamente nelle [sessioni cloud](/docs/it/claude-code-on-the-web) all'ID della sessione corrente. Leggere questo per costruire un link di ritorno alla trascrizione della sessione. Vedere [Collegare l'output di nuovo alla sessione](/docs/it/cloud-environments#link-output-back-to-the-session) |

352| `CLAUDE_CODE_RESTRICTED` | Impostare a `1` per avviare la sessione in modalità ristretta, lo stesso che passare [`--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 successivo |357| `CLAUDE_CODE_RESTRICTED` | Impostare su `1` per avviare la sessione in modalità ristretta, lo stesso che passare [`--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 successivo |

353| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Impostare a `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di inviare di nuovo il prompt. Per disattivare questo, annullare l'impostazione della variabile o impostarla a `0`. Prima della v2.1.221, Claude Code ignorava `0` e altri valori falsy, quindi l'impostazione di `0` attivava comunque la ripresa in modalità non interattiva e l'annullamento dell'impostazione della variabile era l'unico modo per disattivarla |358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Impostare su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di inviare di nuovo il prompt. Per disattivare questo, annullare l'impostazione della variabile o impostarla su `0`. Prima della v2.1.221, Claude Code ignorava `0` e altri valori falsy, quindi l'impostazione di `0` attivava comunque la ripresa in modalità non interattiva e l'annullamento dell'impostazione della variabile era l'unico modo per disattivarla |

354| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione che è terminata a metà turno continui automaticamente al ripristino. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta sia la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` che il messaggio di continuazione iniettato `CLAUDE_CODE_RESUME_PROMPT`, e la sessione inizia inattiva in modo che continuiate esplicitamente. Non impostato o `0` significa nessun limite; un valore negativo o non numerico applica un limite di un'ora. Gli script di generazione per agenti a lunga esecuzione possono impostare questo in modo che un riavvio contro una trascrizione vecchia non ri-esegua un prompt stantio. Claude Code imposta un limite di un'ora da solo quando riavvia una sessione [agent view](/docs/it/agent-view) bloccata che ha ereditato la sua conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successivo |359| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione che è terminata a metà turno continui automaticamente al ripristino. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta sia la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` che il messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT` iniettato, e la sessione inizia inattiva in modo che continuiate esplicitamente. Non impostato o `0` significa nessun limite, tranne che un turno la cui ultima richiesta ha fallito con un errore API riprende solo mentre quell'errore è inferiore a sei ore. Un valore positivo limita ogni turno, inclusi quelli; un valore negativo o non numerico applica un limite di un'ora. Gli script di generazione per agenti a lunga esecuzione possono impostare questo in modo che un riavvio rispetto a una trascrizione vecchia non ri-esegua un prompt stantio. Claude Code imposta un limite di un'ora da solo quando riavvia una sessione di [visualizzazione agente](/docs/it/agent-view) bloccata che ha ereditato la sua conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successivo |

355| `CLAUDE_CODE_RESUME_PROMPT` | Sostituire il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Impostazione predefinita: `Continue from where you left off.`. Gli script di generazione per agenti a lunga esecuzione possono impostare questo a un messaggio di avvio più direttivo. Una stringa vuota utilizza l'impostazione predefinita |360| `CLAUDE_CODE_RESUME_PROMPT` | Sostituire il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Impostazione predefinita: `Continue from where you left off.`. Gli script di generazione per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il predefinito |

356| `CLAUDE_CODE_RETRY_WATCHDOG` | Impostare a `1` per le sessioni non presenziate come harness di valutazione, lavori CI, o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche uno da un [limite di spesa gateway](/docs/it/errors#spend-limit-reached) che si ripristina su un programma. Prima della v2.1.239, il watchdog ritentava questi indefinitamente. Per le richieste in modalità veloce, vedere [Gestire i limiti di velocità](/docs/it/fast-mode#handle-rate-limits). Il watchdog fa un backup fino a 5 minuti tra i tentativi, o fino a quando il limite non si ripristina quando la risposta trasporta un tempo di ripristino del limite di velocità, quindi una sessione che colpisce un limite di utilizzo aspetta la finestra rimanente. Su v2.1.199 o successivo aumenta anche il conteggio di ripetizione predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backup, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se impostate esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successivo |361| `CLAUDE_CODE_RETRY_WATCHDOG` | Impostare su `1` per le sessioni non presidiate come harness di valutazione, lavori CI o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429`che segnala un limite di spesa o crediti di utilizzo esauriti, anche uno da un [limite di spesa gateway](/docs/it/errors#spend-limit-reached) che si ripristina su un programma. Prima della v2.1.239, il watchdog ritentava questi indefinitamente. Per le richieste in modalità veloce, vedere [Gestire i limiti di velocità](/docs/it/fast-mode#handle-rate-limits). Il watchdog fa un backup fino a 5 minuti tra i tentativi, o fino al ripristino del limite quando la risposta trasporta un tempo di ripristino del limite di velocità, quindi una sessione che colpisce un limite di utilizzo aspetta la finestra rimanente. Su v2.1.199 o successivo aumenta anche il conteggio di ripetizione predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backup, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se impostate esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successivo |

357| `CLAUDE_CODE_SAFE_MODE` | Impostare a `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della status line e suggerimento di file, server LSP, e memoria automatica non si caricano, per la risoluzione dei problemi di una configurazione rotta. La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la status line e i comandi di suggerimento di file; i plugin gestiti, le skill gestite, il CLAUDE.md gestito, e i server MCP configurati dalla politica non lo fanno. Equivalente a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figlio generati direttamente ereditano la variabile |362| `CLAUDE_CODE_SAFE_MODE` | Impostare su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e suggerimento di file, server LSP e memoria automatica non si caricano, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la linea di stato e i comandi di suggerimento di file; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla politica non si caricano. Equivalente a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figlio generati direttamente ereditano la variabile |

358| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di conteggio intero. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe in modo che i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contino comunque contro il limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità |363| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di conteggio di interi. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe in modo che i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contino comunque contro il limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità |

359| `CLAUDE_CODE_SCROLL_SPEED` | Impostare il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento del trackpad e della rotella accelerato nei terminali che già amplificano gli eventi della rotella. Impostare a `3` per corrispondere a `vim` se il vostro terminale invia un evento della rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza la sua gestione dello scorrimento |364| `CLAUDE_CODE_SCROLL_SPEED` | Impostare il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento del trackpad e della rotella accelerato nei terminali che già amplificano gli eventi della rotella. Impostare su `3` per corrispondere a `vim` se il vostro terminale invia un evento della rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza la sua gestione dello scorrimento |

360| `CLAUDE_CODE_SEND_FEEDBACK` | Impostare a `0` per disattivare il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) per una sessione. Impostare a `1` per attivarlo dove il vostro 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 |365| `CLAUDE_CODE_SEND_FEEDBACK` | Impostare su `0` per disattivare il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) per una sessione. Impostare su `1` per attivarlo dove il vostro 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 |

361| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sostituire 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 il suo `timeout`. Si applica all'uscita della sessione, `/clear`, e al passaggio delle sessioni tramite `/resume` interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget |366| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sostituire 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 il suo `timeout`. Si applica all'uscita della sessione, `/clear` e al passaggio delle sessioni tramite `/resume` interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget |

362| `CLAUDE_CODE_SESSION_ID` | Impostato automaticamente all'ID della sessione corrente nei sottoprocessi dello strumento Bash e PowerShell, nei sottoprocessi del [comando hook](/docs/it/hooks), e nei sottoprocessi del [server MCP](/docs/it/mcp) stdio. Per Bash, PowerShell e hook questo corrisponde al campo `session_id` nell'input JSON dell'hook e viene aggiornato su `/clear`. Un sottoprocesso del server MCP mantiene l'ID con cui è stato generato. Su `--resume <session-id>` riceve l'ID ripreso. Su `--continue` o `--resume` senza un ID esplicito potrebbe ricevere l'ID di avvio iniziale. Utilizzare per correlare script e strumenti esterni con la sessione Claude Code che li ha avviati |367| `CLAUDE_CODE_SESSION_ID` | Impostato automaticamente all'ID della sessione corrente nei sottoprocessi dello strumento Bash e PowerShell, nei sottoprocessi del [comando hook](/docs/it/hooks) e nei sottoprocessi [server MCP](/docs/it/mcp) stdio. Per Bash, PowerShell e hook questo corrisponde al campo `session_id` nell'input JSON dell'hook e viene aggiornato su `/clear`. Un sottoprocesso del server MCP mantiene l'ID con cui è stato generato. Su `--resume <session-id>` riceve l'ID ripreso, corrispondente agli hook e Bash. Su `--continue` o `--resume` senza un ID esplicito potrebbe ricevere l'ID di avvio iniziale. Utilizzare per correlare gli script e gli strumenti esterni con la sessione Claude Code che li ha avviati |

363| `CLAUDE_CODE_SHELL` | Impostare la shell che Claude Code utilizza 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 torna all'auto-rilevamento. L'auto-rilevamento utilizza il vostro `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` funzionante quindi `bash` trovato nel vostro `PATH` e nelle posizioni di installazione standard |368| `CLAUDE_CODE_SHELL` | Impostare la shell che Claude Code utilizza 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 torna all'auto-rilevamento. L'auto-rilevamento utilizza il vostro `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` funzionante quindi `bash` trovato sul vostro `PATH` e nelle posizioni di installazione standard |

364| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso di comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi [hook](/docs/it/hooks), comandi [status line](/docs/it/statusline), e comandi di avvio del [server MCP](/docs/it/mcp) stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per la registrazione o il controllo. L'impostazione di un percorso eseguibile nudo 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 shell-quoted in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un percorso eseguibile nudo interrompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate dello strumento Bash, `$1` contiene l'invocazione della shell completa che Claude Code assembla, inclusa la configurazione dell'ambiente, non solo il comando che Claude ha eseguito |369| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso di comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi [hook](/docs/it/hooks), comandi [linea di stato](/docs/it/statusline) e comandi di avvio [server MCP](/docs/it/mcp) stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per la registrazione o il controllo. L'impostazione di un percorso eseguibile nudo 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 con shell-quoted in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un percorso eseguibile nudo interrompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate dello strumento Bash, `$1` contiene l'invocazione della shell completa che Claude Code assembla, inclusa la configurazione dell'ambiente, non solo il comando che Claude ha eseguito |

365| `CLAUDE_CODE_SIMPLE` | Impostare a `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura di file e modifica di file. Gli strumenti MCP da `--mcp-config` sono ancora disponibili. Disabilita l'auto-scoperta di hook, skill, comandi personalizzati, subagent, plugin, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory che passate con `--add-dir` si caricano comunque. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l'autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o un `apiKeyHelper` in `--settings`. Equivalente a passare [`--bare`](/docs/it/headless#start-faster-with-bare-mode) |370| `CLAUDE_CODE_SIMPLE` | Impostare su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura di file e modifica di file. Gli strumenti MCP da `--mcp-config` sono comunque disponibili. Disabilita l'auto-scoperta di hook, skill, comandi personalizzati, subagent, plugin, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory che passate con `--add-dir` si caricano comunque. 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`. Equivalente a passare [`--bare`](/docs/it/headless#start-faster-with-bare-mode) |

366| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Impostare a `1` per utilizzare un prompt di sistema più breve e descrizioni di strumenti abbreviate su qualsiasi modello. Impostare a `0`, `false`, `no`, o `off` per rinunciare anche sui modelli in cui l'esperimento o la configurazione del server lo abiliterebbero altrimenti. L'insieme completo di strumenti, gli hook, i server MCP e la scoperta di CLAUDE.md rimangono abilitati |371| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Impostare su `1` per utilizzare un prompt di sistema più breve e descrizioni di strumenti abbreviate su qualsiasi modello. Impostare su `0`, `false`, `no` o `off` per rinunciare anche sui modelli in cui l'esperimento o la configurazione del server lo abiliterebbero altrimenti. L'insieme completo di strumenti, gli hook, i server MCP e la scoperta di CLAUDE.md rimangono abilitati |

367| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Saltare l'autenticazione lato client per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), per i gateway che firmano le richieste da soli |372| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Saltare l'autenticazione lato client per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), per i gateway che firmano le richieste da soli |

368| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Impostare a `1` per disattivare la cache in-process delle credenziali risolte dalla catena del provider di credenziali predefinito AWS, in modo che Claude Code risolva la catena su ogni richiesta API. Con la cache disattivata, un profilo supportato da SSO richiede credenziali da IAM Identity Center su ogni richiesta. Vedere [credential caching and resolution timeout](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successivo |373| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Impostare su `1` per disattivare la cache in-process delle credenziali risolte dalla catena del provider di credenziali predefinito AWS, in modo che Claude Code risolva la catena su ogni richiesta API. Con la cache disattivata, un profilo supportato da SSO richiede credenziali da IAM Identity Center su ogni richiesta. Vedere [memorizzazione in cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successivo |

369| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Saltare l'autenticazione AWS per Amazon Bedrock (ad esempio, quando si utilizza un gateway LLM) |374| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Saltare l'autenticazione AWS per Amazon Bedrock (ad esempio, quando si utilizza un gateway LLM) |

370| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Impostare a `1` per trattare un controllo di disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) non riuscito come disponibile, per le reti che bloccano la richiesta diretta del controllo a `api.anthropic.com`. Claude Code onora comunque una risposta "disabilitato dalla vostra organizzazione" |375| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Impostare su `1` per trattare un controllo di disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) non riuscito come disponibile, per le reti che bloccano la richiesta diretta del controllo a `api.anthropic.com`. Claude Code onora comunque una risposta "disabilitato dalla vostra organizzazione" |

371| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Impostare a `1` per saltare il controllo di disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) lato client, per i proxy che intercettano la richiesta del controllo piuttosto che rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la vostra organizzazione ha la modalità veloce disabilitata |376| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Impostare su `1` per saltare il controllo di disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) lato client, per i proxy che intercettano la richiesta del controllo piuttosto che rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la vostra organizzazione ha la modalità veloce disabilitata |

372| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Saltare l'autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inietta il suo `Authorization` header. Claude Code invia richieste senza una credenziale Azure e preserva l'intestazione `Authorization` che fornite, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorato quando `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN` è impostato. Prima della v2.1.203, questa variabile lasciava il client Microsoft Foundry incapace di inviare richieste a meno che una chiave API non fosse anche impostata |377| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Saltare l'autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inietta la sua intestazione `Authorization`. Claude Code invia richieste senza una credenziale Azure e preserva l'intestazione `Authorization` che fornite, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorato quando `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN` è impostato. Prima della v2.1.203, questa variabile lasciava il client Microsoft Foundry incapace di inviare richieste a meno che una chiave API non fosse anche impostata |

373| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Saltare l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM) |378| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Saltare l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM) |

374| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Impostare a `1` per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in `--resume`, `--continue`, o nella cronologia della freccia su. Utile per le sessioni di script effimere |379| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Impostare su `1` per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in `--resume`, `--continue` o nella cronologia della freccia su. Utile per le sessioni di script effimere |

375| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Saltare l'autenticazione Google per Google Cloud's Agent Platform (ad esempio, quando si utilizza un gateway LLM) |380| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Saltare l'autenticazione Google per Google Cloud's Agent Platform (ad esempio, quando si utilizza un gateway LLM) |

376| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive che un hook [Stop](/docs/it/hooks#stop) o [SubagentStop](/docs/it/hooks#subagentstop) può bloccare il turno dal terminare prima che Claude Code lo ignori e termini il turno comunque (predefinito: 8). Impostare a `0` per disabilitare il limite. Aumentare se il vostro hook ha legittimamente bisogno di più iterazioni per risolvere |381| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Impostare su `1` per fare in modo che una sessione avviata con `--output-format stream-json` scriva un [messaggio di risultato che nomina il motivo per cui Claude Code ha rifiutato di avviare](/docs/it/agent-sdk/typescript#startup_failure_reason) per i fallimenti di avvio che altrimenti terminano solo con stderr. Richiede Claude Code v2.1.274 o successivo |

377| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i compagni del [team di agenti](/docs/it/agent-teams#specify-teammates-and-models), e gli agenti del [flusso di lavoro](/docs/it/workflows) che non sono assegnati a un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Due fonti hanno la precedenza su di esso: un modello che Claude passa quando genera l'agente, e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare quello, impostare [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model). Vedere [Scegliere un modello](/docs/it/sub-agents#choose-a-model) per l'ordine completo. L'impostazione a `inherit` è la stessa che lasciarla non impostata. Prima della v2.1.251, questa variabile sostituiva sia il modello per invocazione che il campo `model` della definizione |382| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive che un hook [Stop](/docs/it/hooks#stop) o [SubagentStop](/docs/it/hooks#subagentstop) può bloccare la fine del turno prima che Claude Code lo ignori e termini il turno comunque (predefinito: 8). Impostare su `0` per disabilitare il limite. Aumentare se il vostro hook ha legittimamente bisogno di più iterazioni per risolvere |

378| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Impostare a `1` per forzare un modello sui subagent, i compagni e gli agenti del flusso di lavoro. [Eseguire ogni subagent su un modello](/docs/it/sub-agents#run-every-subagent-on-one-model) dice quale modello è. Richiede Claude Code v2.1.257 o successivo |383| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i compagni di [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) e gli agenti di [flusso di lavoro](/docs/it/workflows) che non sono assegnati a un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Due fonti hanno la precedenza su di esso: un modello che Claude passa quando genera l'agente e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare quello, impostare [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model). Vedere [Scegliere un modello](/docs/it/sub-agents#choose-a-model) per l'ordine completo. L'impostazione su `inherit` è la stessa che lasciarla non impostata. Prima della v2.1.251, questa variabile sostituiva sia il modello per invocazione che il campo `model` della definizione |

379| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Impostare `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) per le richieste al di fuori della conversazione principale, come [subagent](/docs/it/sub-agents), flussi di lavoro e lavoro di background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` la sostituisce. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Richiede Claude Code v2.1.242 o successivo |384| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Impostare su `1` per forzare un modello sui subagent, i compagni e gli agenti del flusso di lavoro. [Eseguire ogni subagent su un modello](/docs/it/sub-agents#run-every-subagent-on-one-model) dice quale modello è. Richiede Claude Code v2.1.257 o successivo |

380| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Impostare a `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio): credenziali Anthropic e provider cloud, qualsiasi altra variabile che Claude Code riconosce come credenziale, e credenziali incorporate negli URL del registro dei pacchetti. Il processo Claude genitore mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l'esposizione agli attacchi di iniezione di prompt che tentano di esfiltrare i segreti tramite l'espansione della shell. Su v2.1.251 o successivo, lo scrub rimuove anche le variabili del puntatore dell'archivio di configurazione di Claude Code (come `CLAUDE_CONFIG_DIR`), in modo che un processo figlio non possa individuare una directory di configurazione rilocata. Lasciare lo scrub non impostato se un sottoprocesso ha bisogno di queste variabili. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi 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 o segnalare i processi host. `claude-code-action` imposta questo automaticamente quando `allowed_non_write_users` è configurato |385| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Impostare `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) per le richieste al di fuori della conversazione principale, come [subagent](/docs/it/sub-agents), flussi di lavoro e lavoro in background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` la sostituisce. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Richiede Claude Code v2.1.242 o successivo |

381| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Impostare a `1` in modalità non interattiva (il flag `-p`) per aspettare il completamento dell'installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combinare con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |386| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Impostare su `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio): credenziali Anthropic e provider cloud, qualsiasi altra variabile che Claude Code riconosce come credenziale e credenziali incorporate negli URL del registro dei pacchetti. Il processo Claude genitore mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l'esposizione agli attacchi di iniezione di prompt che tentano di esfiltare i segreti tramite l'espansione della shell. Su v2.1.251 o successivo, lo scrub rimuove anche le variabili del puntatore dell'archivio di configurazione di Claude Code (come `CLAUDE_CONFIG_DIR`), in modo che un processo figlio non possa individuare una directory di configurazione rilocata. Lasciare lo scrub non impostato se un sottoprocesso ha bisogno di queste variabili. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi 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 o segnalare i processi host. `claude-code-action` imposta questo automaticamente quando `allowed_non_write_users` è configurato |

387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Impostare su `1` in modalità non interattiva (il flag `-p`) per aspettare il completamento dell'installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combinare con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |

382| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona del plugin. Quando superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l'installazione sincrona aspetta fino al completamento |388| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona del plugin. Quando superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l'installazione sincrona aspetta fino al completamento |

383| `CLAUDE_CODE_SYNC_SKILLS` | Impostare a `1` per scaricare le vostre skill abilitate di claude.ai in `~/.claude/skills/synced/` e risincronizzare ogni 10 minuti. Prima di eseguire la prima query, Claude Code aspetta fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` per l'elenco delle vostre skill. I download stessi finiscono in background, e Claude aspetta il download di una skill quando la invoca. Il nome della cartella `synced` è [riservato per questo download](/docs/it/skills#where-skills-live). Prima della v2.1.227, le skill scaricavano direttamente in `~/.claude/skills/`. Si applica solo in modalità non interattiva con il flag `-p`. Richiede l'autenticazione di claude.ai. Le [sessioni cloud](/docs/it/claude-code-on-the-web) ricevono le vostre skill abilitate di claude.ai automaticamente; non è necessario impostare questo lì. Claude Code applica [regole extra alle skill scaricate](/docs/it/skills#how-synced-skills-behave), come non eseguire i loro comandi `!` sulla vostra macchina |389| `CLAUDE_CODE_SYNC_SKILLS` | Impostare su `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi le skill abilitate per il vostro account claude.ai in quella esecuzione e aspetti l'elenco di esse, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. Gli scaricamenti stessi finiscono in background e Claude aspetta il download di una skill quando la invoca. Richiede l'autenticazione claude.ai. Le sessioni di terminale in cui accedete con il vostro account claude.ai [scaricano queste skill](/docs/it/skills#where-synced-skills-load) in `~/.claude/skills/synced/` e risincronizzano circa ogni 10 minuti senza questa variabile, quindi impostatela solo quando un'esecuzione `-p` ha bisogno delle vostre skill attuali al primo turno. Prima della v2.1.273, le sessioni di terminale le scaricavano solo in un'esecuzione `-p` con questa variabile impostata. Il nome della cartella `synced` è [riservato per questo download](/docs/it/skills#where-skills-live). Prima della v2.1.227, le skill scaricate in `~/.claude/skills/` direttamente. Claude Code applica [regole extra alle skill scaricate](/docs/it/skills#how-synced-skills-behave), come non eseguire i loro comandi `!` sulla vostra macchina |

384| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per una risincronizzazione delle skill a metà sessione quando `CLAUDE_CODE_SYNC_SKILLS` è impostato (predefinito: 30000). Limita il download attivato quando l'host richiede un ricaricamento delle skill durante la sessione. Quando superato, la risincronizzazione si ferma e i download rimanenti continuano in background |390| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per la risincronizzazione delle skill che viene eseguita a metà sessione quando un'app costruita su [Agent SDK](/docs/it/agent-sdk/typescript#query-object) ricarica le skill (predefinito: 30000). Quando superato, il ricaricamento continua con qualunque skill sia arrivata e i download rimanenti finiscono in background |

385| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in millisecondi affinché la prima query aspetti l'elenco iniziale delle skill quando `CLAUDE_CODE_SYNC_SKILLS` è impostato (predefinito: 5000). Quando superato, la prima query viene eseguita con qualsiasi skill sia arrivata. I download finiscono in background in entrambi i casi, e Claude aspetta il download di una skill quando la invoca |391| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in millisecondi affinché la prima query aspetti l'elenco di skill iniziale quando `CLAUDE_CODE_SYNC_SKILLS` è impostato (predefinito: 5000). Quando superato, la prima query viene eseguita con qualunque skill sia arrivata. I download finiscono in background in entrambi i casi e Claude aspetta il download di una skill quando la invoca |

386| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Impostare a `false` per disabilitare l'evidenziazione della sintassi nell'output diff. Utile quando i colori interferiscono con la configurazione del vostro terminale. Per disabilitare anche l'evidenziazione nei blocchi di codice e nelle anteprime di file, utilizzare l'impostazione [`syntaxHighlightingDisabled`](/docs/it/settings-reference#syntaxhighlightingdisabled) |392| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Impostare su `false` per disabilitare l'evidenziazione della sintassi nell'output diff. Utile quando i colori interferiscono con la configurazione del vostro terminale. Per disabilitare anche l'evidenziazione nei blocchi di codice e nelle anteprime di file, utilizzare l'impostazione [`syntaxHighlightingDisabled`](/docs/it/settings-reference#syntaxhighlightingdisabled) |

387| `CLAUDE_CODE_TASK_LIST_ID` | Condividere un elenco di attività tra le sessioni. Impostare lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso, nelle [sessioni che hanno gli strumenti Task](/docs/it/tools-reference#task-tool-availability). Vedere [Elenco attività](/docs/it/interactive-mode#task-list) |393| `CLAUDE_CODE_TASK_LIST_ID` | Condividere un elenco di attività tra le sessioni. Impostare lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso, nelle [sessioni che hanno gli strumenti Task](/docs/it/tools-reference#task-tool-availability). Vedere [Elenco attività](/docs/it/interactive-mode#task-list) |

388| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sostituire, in millisecondi, quanto tempo una sessione non interattiva aspetta all'uscita affinché il suo [team di agenti](/docs/it/agent-teams) finisca di smontarsi. Accetta da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica l'impostazione predefinita di 10000. Richiede Claude Code v2.1.206 o successivo |394| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sostituire, in millisecondi, quanto a lungo una sessione non interattiva aspetta all'uscita affinché il suo [team di agenti](/docs/it/agent-teams) finisca di smontarsi. Accetta da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il predefinito di 10000. Richiede Claude Code v2.1.206 o successivo |

389| `CLAUDE_CODE_TMPDIR` | Sostituire la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` su Unix o `/claude/` su Windows a questo percorso. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash [sandboxed](/docs/it/sandboxing) ricevono un fallback `$TMPDIR` breve sotto l'impostazione predefinita del sistema quando il vostro override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non sandboxed ereditano il vostro `$TMPDIR` della shell invariato. I file temporanei di Claude Code utilizzano sempre il vostro override. Impostatelo nella vostra shell, nelle impostazioni utente, o nelle impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |395| `CLAUDE_CODE_TMPDIR` | Sostituire la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` su Unix o `/claude/` su Windows a questo percorso. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash [sandboxed](/docs/it/sandboxing) ricevono un fallback `$TMPDIR` breve sotto il predefinito del sistema quando il vostro override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non sandboxed ereditano il vostro `$TMPDIR` della shell quando è impostato. I file temporanei di Claude Code utilizzano sempre il vostro override. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

390| `CLAUDE_CODE_TMUX_TRUECOLOR` | Impostare a qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. **L'impostazione a `0` o `false` consente comunque il truecolor**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per ripristinare il limite di 256 colori. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato. Impostare questo dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al vostro `~/.tmux.conf`. Vedere [Configurazione del terminale](/docs/it/terminal-config) per altre impostazioni di tmux |396| `CLAUDE_CODE_TMUX_TRUECOLOR` | Impostare su qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. **L'impostazione su `0` o `false` consente comunque il truecolor**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per ripristinare il blocco a 256 colori. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato. Impostare questo dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al vostro `~/.tmux.conf`. Vedere [Configurazione del terminale](/docs/it/terminal-config) per altre impostazioni tmux |

391| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Su Linux e WSL, impostare a un elenco separato da virgole dei tipi di processi che Claude Code [esclude dal limite di memoria dello strumento](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), come `mcp` o `lsp`. Impostare `none` per limitare ogni tipo, o `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene i comandi degli strumenti Bash, PowerShell e Monitor sotto il limite qualsiasi cosa elenchiate. Richiede Claude Code v2.1.246 o successivo |397| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Su Linux e WSL, impostare su un elenco separato da virgole dei tipi di processi che Claude Code [esclude dal limite di memoria dello strumento](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), come `mcp` o `lsp`. Impostare `none` per limitare ogni tipo, o `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene i comandi degli strumenti Bash, PowerShell e Monitor sotto il limite qualunque cosa elenchiate. Richiede Claude Code v2.1.246 o successivo |

392| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Su Linux e WSL, impostare a una dimensione come `4G` per [limitare la memoria che i comandi degli strumenti Bash e PowerShell possono utilizzare](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), e i comandi dello strumento Monitor su v2.1.246 o successivo. Scrivere la dimensione in cifre semplici, sole per un numero di byte o con un suffisso `K`, `M`, `G`, o `T`. Impostare `0` o `off` per disattivare il limite. Una volta che il primo processo che Claude Code avvia ha attivato o disattivato il limite, un valore modificato ha effetto la prossima volta che avviate `claude`. Richiede Claude Code v2.1.233 o successivo |398| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Su Linux e WSL, impostare su una dimensione come `4G` per [limitare la memoria che i comandi degli strumenti Bash e PowerShell possono utilizzare](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), e i comandi dello strumento Monitor su v2.1.246 o successivo. Scrivere la dimensione in cifre semplici, sole per un numero di byte o con un suffisso `K`, `M`, `G` o `T`. Impostare `0` o `off` per disattivare il limite. Una volta che il primo processo che Claude Code avvia ha attivato o disattivato il limite, un valore modificato ha effetto la prossima volta che avviate `claude`. Richiede Claude Code v2.1.233 o successivo |

393| `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 [Remote Control](/docs/it/remote-control) o host SDK, o la finestra di dialogo di approvazione per un [messaggio tra sessioni trattenuto](/docs/it/cross-session-messaging#control-inbound-messages); i prompt di permesso e le domande `AskUserQuestion` utilizzano i loro flussi e non sono governati da esso. Su Claude Code v2.1.236 o successivo, limita anche il prompt di consenso dei crediti di utilizzo di Fable a metà sessione]\(/it/model-config#fable-and-usage-credits) in una sessione che potrebbe essere in esecuzione senza presenziale. [Controllare i messaggi in entrata](/docs/it/cross-session-messaging#control-inbound-messages) e [sessioni non interattive](/docs/it/cross-session-messaging#non-interactive-sessions) coprono le regole di scadenza del messaggio trattenuto completo, inclusi i casi in cui la scadenza non si applica. Sostituisce l'impostazione [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry). `0` o un valore negativo disabilita la scadenza |399| `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 [Remote Control](/docs/it/remote-control) o host SDK, o la finestra di dialogo di approvazione per un [messaggio tra sessioni in sospeso](/docs/it/cross-session-messaging#control-inbound-messages); i prompt di autorizzazione e le domande `AskUserQuestion` utilizzano i loro flussi e non sono governati da esso. Su Claude Code v2.1.236 o successivo, limita anche il prompt di consenso dei 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 entrata](/docs/it/cross-session-messaging#control-inbound-messages) e [sessioni non interattive](/docs/it/cross-session-messaging#non-interactive-sessions) coprono le regole di scadenza del messaggio in sospeso completo, inclusi i casi in cui la scadenza non si applica. Sostituisce l'impostazione [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry). `0` o un valore negativo disabilita la scadenza |

397| `CLAUDE_CODE_USE_MANTLE` | Utilizzare l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock |403| `CLAUDE_CODE_USE_MANTLE` | Utilizzare l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock |

398| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Impostare a `1` per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Impostare questo se il binario ripgrep raggruppato non è disponibile o bloccato nel vostro ambiente. Non influisce sugli strumenti Grep o ricerca di file |404| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Impostare su `1` per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Impostare questo se il binario ripgrep raggruppato non è disponibile o bloccato nel vostro ambiente. Non influisce sugli strumenti Grep o ricerca di file |

399| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; impostare a `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; impostare a `1` per abilitarlo nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, o `0` per disattivarlo. Su Linux, macOS e WSL, impostare a `1` per abilitarlo, che richiede `pwsh` nel vostro `PATH`. Quando abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedere [Strumento PowerShell](/docs/it/tools-reference#powershell-tool) |405| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; impostare su `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; impostare su `1` per abilitarlo nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, o `0` per disattivarlo. Su Linux, macOS e WSL, impostare su `1` per abilitarlo, che richiede `pwsh` sul vostro `PATH`. Quando abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedere [Strumento PowerShell](/docs/it/tools-reference#powershell-tool) |

401| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Impostare al numero di millisecondi che [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) mantiene la risposta di ogni URL recuperato memorizzata in cache. L'impostazione predefinita è `900000`, che è 15 minuti. Accetta solo cifre semplici; `0`, un decimale, o qualsiasi altra ortografia mantiene l'impostazione predefinita. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica quando avviate successivamente `claude`. Richiede Claude Code v2.1.233 o successivo |407| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Impostare al numero di millisecondi che [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) mantiene la risposta di ogni URL recuperato memorizzata in cache. Il predefinito è `900000`, che è 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra ortografia mantiene il predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica quando avviate successivamente `claude`. Richiede Claude Code v2.1.233 o successivo |

402| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superiore in millisecondi su quanto tempo [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) aspetta affinché una pagina si scarichi, inclusi i reindirizzamenti che segue. Un download che non è stato completato entro allora fallisce con un errore di scadenza. L'impostazione predefinita è `300000`, che è cinque minuti. Impostare a `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra ortografia mantiene l'impostazione predefinita. Richiede Claude Code v2.1.268 o successivo |408| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superiore in millisecondi su quanto a lungo [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) aspetta il download di una pagina, inclusi i reindirizzamenti che segue. Un download che non è stato completato entro allora fallisce con un errore di scadenza. Il predefinito è `300000`, che è cinque minuti. Impostare su `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra ortografia mantiene il predefinito. Richiede Claude Code v2.1.268 o successivo |

403| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superiore in millisecondi su quanto tempo un agente del [flusso di lavoro](/docs/it/workflows) aspetta affinché la prima risposta di un fratello con lo stesso prefisso inizi prima di inviare la sua stessa 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 mantiene tutti tranne il primo agente per fino a questo lungo in modo che il resto legga il prefisso memorizzato in cache invece di elaborarlo senza cache. Predefinito `5000`. Impostare a `0` per disabilitare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostato, gli agenti non aspettano mai. Richiede Claude Code v2.1.229 o successivo |409| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quanti agenti un'esecuzione di [flusso di lavoro](/docs/it/workflows) singolo esegue contemporaneamente, 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 aspettano uno slot libero. La trascrizione di ogni agente in esecuzione rimane nella memoria di Claude Code, quindi i valori più alti aumentano l'utilizzo della memoria. Accetta solo cifre semplici; i valori fuori intervallo e altre ortografie mantengono il predefinito. Richiede Claude Code v2.1.269 o successivo |

404| `CLAUDE_CONFIG_DIR` | Sostituire la directory di configurazione (predefinito: `~/.claude`). Tutte le impostazioni, la cronologia della sessione e i plugin vengono memorizzati sotto questo percorso. Per le credenziali, vedere [dove Claude Code memorizza le credenziali](/docs/it/authentication#credential-management). Utile per eseguire più account fianco a fianco: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostatelo nella vostra shell, nelle impostazioni utente, o nelle impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |410| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superiore in millisecondi su quanto a lungo un agente di [flusso di lavoro](/docs/it/workflows) aspetta la prima risposta di un fratello con lo stesso prefisso prima di inviare la sua 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 mantiene tutti tranne il primo agente per fino a questo lungo in modo che il resto legga il prefisso memorizzato in cache invece di elaborarlo senza cache. Predefinito `5000`. Impostare su `0` per disabilitare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostato, gli agenti non aspettano mai. Richiede Claude Code v2.1.229 o successivo |

405| `CLAUDE_DISABLE_ADOPT` | Impostare a `1` per interrompere il lavoro di background in volo invece di trasportarlo quando mettete in background una sessione premendo `←` o con [`/background`](/docs/it/agent-view#from-inside-a-session). Claude Code vi chiede di confermare prima di mettere in background, quindi interrompe i compiti che altrimenti si trasporterebbero. Richiede Claude Code v2.1.195 o successivo |411| `CLAUDE_CONFIG_DIR` | Sostituire la directory di configurazione (predefinito: `~/.claude`). Tutte le impostazioni, la cronologia della sessione e i plugin vengono memorizzati sotto questo percorso. Per le credenziali, vedere [dove Claude Code memorizza le credenziali](/docs/it/authentication#credential-management). Utile per eseguire più account fianco a fianco: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

406| `CLAUDE_EFFORT` | Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al [livello di effort](/docs/it/model-config#adjust-effort-level) in vigore quando il sottoprocesso inizia: `low`, `medium`, `high`, `xhigh`, o `max`. Ultracode non è un livello distinto e segnala come `xhigh`. Corrisponde al campo `effort.level` passato agli [hook](/docs/it/hooks). Impostato solo quando il modello corrente supporta il parametro effort |412| `CLAUDE_DISABLE_ADOPT` | Impostare su `1` per impedire il trasferimento del lavoro in background in volo quando mettete in background una sessione premendo `←` o con [`/background`](/docs/it/agent-view#from-inside-a-session). Claude Code vi chiede di confermare prima di mettere in background, quindi arresta i compiti che altrimenti si trasferirebbero. Richiede Claude Code v2.1.195 o successivo |

407| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Impostare a `1` per forzare l'abilitazione del watchdog di inattività di streaming a livello di byte, o impostare a `0` per forzare la disattivazione. `0` disattiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle connessioni in cui viene eseguita quella scadenza. Quando non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic dirette e [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e per le risposte in streaming su connessioni [gateway](/docs/it/gateways) raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non veniva eseguito su quelle connessioni gateway, quindi il watchdog a livello di evento potrebbe segnalare uno stallo lì anche mentre i ping keep-alive stavano arrivando. Per i timeout e come i timer interagiscono, vedere [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs) |413| `CLAUDE_EFFORT` | Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al [livello di sforzo](/docs/it/model-config#adjust-effort-level) in vigore quando il sottoprocesso inizia: `low`, `medium`, `high`, `xhigh` o `max`. Ultracode non è un livello distinto e segnala come `xhigh`. Corrisponde al campo `effort.level` passato agli [hook](/docs/it/hooks). Impostato solo quando il modello corrente supporta il parametro effort |

408| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Impostare a `1` per abilitare il watchdog di inattività di streaming a livello di byte sulle risposte `vnd.amazon.eventstream` di Amazon Bedrock, che abilita anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle richieste di streaming di Bedrock. Disattivato per impostazione predefinita. Configurare il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |414| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Impostare su `1` per forzare l'abilitazione del watchdog di inattività di flusso a livello di byte, o impostare su `0` per forzare la disabilitazione. `0` disattiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle connessioni in cui viene eseguita quella scadenza. Quando non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic dirette e [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e per le risposte in streaming su connessioni [gateway](/docs/it/gateways) raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non veniva eseguito su quelle connessioni gateway, quindi il watchdog a livello di evento potrebbe segnalare uno stallo lì anche mentre i ping keep-alive stavano arrivando. Per i timeout e come i timer interagiscono, vedere [Watchdog di inattività di flusso](/docs/it/network-config#streaming-idle-watchdogs) |

409| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Impostare a `0` per forzare la disattivazione del watchdog di inattività di streaming a livello di evento, o impostare a `1` per forzare l'abilitazione. Quando non impostato, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, l'impostazione predefinita non impostata era controllata dal server sull'API Anthropic diretta e disattivata su altri provider. Configurare il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che vengono eseguiti insieme a questo, vedere [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs) |415| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Impostare su `1` per abilitare il watchdog di inattività di flusso a livello di byte sulle risposte [Amazon Bedrock](/docs/it/amazon-bedrock) `vnd.amazon.eventstream`, che abilita anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle richieste di streaming Bedrock. Disattivato per impostazione predefinita. Configurare il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

410| `CLAUDE_ENV_FILE` | Percorso a uno script shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo shell, in modo che gli export nel file siano visibili al comando. Utilizzare per persistere l'attivazione di virtualenv o conda tra i comandi. Anche popolato 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) |416| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Impostare su `0` per forzare la disabilitazione del watchdog di inattività di flusso a livello di evento, o impostare su `1` per forzare l'abilitazione. Quando non impostato, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il predefinito non impostato era controllato dal server sull'API Anthropic diretta e disattivato su altri provider. Configurare il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che vengono eseguiti insieme a questo, vedere [Watchdog di inattività di flusso](/docs/it/network-config#streaming-idle-watchdogs) |

411| `CLAUDE_JOB_DIR` | Impostato da Claude Code in ogni [sessione di background](/docs/it/agent-view) a quella directory `~/.claude/jobs/<id>` della sessione. I comandi shell che la sessione esegue lo ereditano. Scrivere i file di scratch a [`$CLAUDE_JOB_DIR/tmp`](/docs/it/agent-view#where-state-is-stored). Le chiamate `Write` e `Edit` di Claude lì non richiedono il permesso, e la directory viene rimossa quando la sessione viene eliminata |417| `CLAUDE_ENV_FILE` | Percorso a uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizzare per persistere l'attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente da hook [SessionStart](/docs/it/hooks#persist-environment-variables), [Setup](/docs/it/hooks#setup), [CwdChanged](/docs/it/hooks#cwdchanged) e [FileChanged](/docs/it/hooks#filechanged) |

412| `CLAUDE_PID` | Claude Code imposta questo al suo ID di processo nei sottoprocessi che genera: comandi degli strumenti Bash e PowerShell e comandi hook. Su Linux, l'integrazione della shell dello strumento Bash lo utilizza per rifiutare un modello `pkill` che corrisponderebbe al processo Claude Code stesso; vedere il [riferimento degli errori](/docs/it/errors#pkill-pattern-matches-the-claude-code-process). Leggerlo dai vostri script per identificare o segnalare deliberatamente il processo Claude Code genitore. Richiede Claude Code v2.1.214 o successivo |418| `CLAUDE_JOB_DIR` | Impostato da Claude Code in ogni [sessione in background](/docs/it/agent-view) alla directory `~/.claude/jobs/<id>` di quella sessione. I comandi shell che la sessione esegue lo ereditano. Scrivere i file di scratch a [`$CLAUDE_JOB_DIR/tmp`](/docs/it/agent-view#where-state-is-stored). Le chiamate `Write` e `Edit` di Claude lì non richiedono l'autorizzazione e la directory viene rimossa quando la sessione viene eliminata |

413| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi della sessione [Remote Control](/docs/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Impostazione predefinita: il nome host della vostra macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |419| `CLAUDE_PID` | Claude Code imposta questo al suo ID di processo nei sottoprocessi che genera: comandi dello strumento Bash e PowerShell e comandi hook. Su Linux, l'integrazione della shell dello strumento Bash lo utilizza per rifiutare un modello `pkill` che corrisponderebbe al processo Claude Code stesso; vedere il [riferimento degli errori](/docs/it/errors#pkill-pattern-matches-the-claude-code-process). Leggerlo dai vostri script per identificare o segnalare deliberatamente il processo Claude Code genitore. Richiede Claude Code v2.1.214 o successivo |

414| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Scadenza in millisecondi per il primo byte di risposta di una richiesta in streaming, sulle connessioni in cui viene eseguita 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 grandi, e come sceglie la scadenza quando la lasciate non impostata, vedere [Nessuna risposta dall'API](/docs/it/errors#no-response-from-api). Richiede Claude Code v2.1.242 o successivo |420| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi di sessione [Remote Control](/docs/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Impostazione predefinita: il nome host della vostra macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |

415| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che i watchdog di inattività di streaming a livello di evento e byte chiudano una connessione bloccata. Quando impostate questa variabile esplicitamente, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente limitati per assorbire le pause di thinking esteso e il buffering del 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 non impostati per watchdog, vedere [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs) |421| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Scadenza in millisecondi per il primo byte di risposta di una richiesta in streaming, sulle connessioni in cui viene eseguita 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 grandi e come sceglie la scadenza quando la lasciate non impostata, vedere [Nessuna risposta dall'API](/docs/it/errors#no-response-from-api). Richiede Claude Code v2.1.242 o successivo |

416| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Rimosso nella v2.1.260 e ora un no-op. In precedenza limitava quanto tempo un [comando shell di background](/docs/it/interactive-mode#background-bash-commands) che un [subagent](/docs/it/sub-agents) ha avviato poteva eseguire, in millisecondi, con un predefinito di 60 minuti. Vedere [le regole di durata del comando di background](/docs/it/tools-reference#background-commands) |422| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che i watchdog di inattività di flusso a livello di evento e byte chiudano una connessione bloccata. Quando impostate questa variabile esplicitamente, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente limitati per assorbire le pause di pensiero esteso e il buffering del 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 predefiniti non impostati per watchdog, vedere [Watchdog di inattività di flusso](/docs/it/network-config#streaming-idle-watchdogs) |

417| `DEBUG` | Impostare a `1` per abilitare la modalità debug, equivalente a lanciare con [`--debug`](/docs/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, o al percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori truthy `1`, `true`, `yes`, e `on` abilitano la modalità debug, quindi i modelli di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano |423| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Rimosso nella v2.1.260 e ora un no-op. In precedenza limitava quanto a lungo un [comando shell in background](/docs/it/interactive-mode#background-bash-commands) che un [subagent](/docs/it/sub-agents) ha avviato poteva eseguire, in millisecondi, con un predefinito di 60 minuti. Vedere le [regole della durata del comando in background](/docs/it/tools-reference#background-commands) |

418| `DISABLE_AUTOUPDATER` | Impostare a `1` per disabilitare gli aggiornamenti automatici di background. Il manuale `claude update` continua a funzionare. Utilizzare `DISABLE_UPDATES` per bloccare entrambi |424| `DEBUG` | Impostare 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`, o nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori truthy `1`, `true`, `yes` e `on` abilitano la modalità debug, quindi i modelli di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano |

419| `DISABLE_AUTO_COMPACT` | Impostare a `1` per disabilitare la compattazione automatica quando ci si avvicina al limite di contesto. Il comando manuale `/compact` rimane disponibile. Utilizzare quando desiderate il controllo esplicito su quando si verifica la compattazione. Sostituisce l'impostazione [`autoCompactEnabled`](/docs/it/settings-reference#autocompactenabled) |425| `DISABLE_AUTOUPDATER` | Impostare su `1` per disabilitare gli aggiornamenti automatici in background. Il manuale `claude update` continua a funzionare. Utilizzare `DISABLE_UPDATES` per bloccare entrambi |

420| `DISABLE_COMPACT` | Impostare a `1` per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale `/compact` |426| `DISABLE_AUTO_COMPACT` | Impostare su `1` per disabilitare la compattazione automatica quando ci si avvicina al limite di contesto. Il comando manuale `/compact` rimane disponibile. Utilizzare quando desiderate il controllo esplicito su quando si verifica la compattazione. Sostituisce l'impostazione [`autoCompactEnabled`](/docs/it/settings-reference#autocompactenabled) |

422| `DISABLE_DOCTOR_COMMAND` | Impostare a `1` per nascondere la skill [`/doctor`](/docs/it/commands#all-commands) di controllo della configurazione e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire i diagnostici di configurazione da una sessione. Non influisce sul comando del terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva la schermata di diagnostica del comando `/doctor` |428| `DISABLE_COST_WARNINGS` | Impostare su `1` per disabilitare i messaggi di avviso sui costi |

423| `DISABLE_ERROR_REPORTING` | Impostare a qualsiasi valore non vuoto, come `1`, per rinunciare alla segnalazione degli errori. **L'impostazione a `0` o `false` rinuncia comunque**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la segnalazione degli errori |429| `DISABLE_DOCTOR_COMMAND` | Impostare su `1` per nascondere la skill [`/doctor`](/docs/it/commands#all-commands) di controllo della configurazione e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire i diagnostici di configurazione da una sessione. Non influisce sul comando del terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva la schermata dei diagnostici `/doctor` |

424| `DISABLE_EXTRA_USAGE_COMMAND` | Impostare a `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità |430| `DISABLE_ERROR_REPORTING` | Impostare su qualsiasi valore non vuoto, come `1`, per rinunciare alla segnalazione degli errori. **L'impostazione su `0` o `false` rinuncia comunque**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la segnalazione degli errori |

425| `DISABLE_FEEDBACK_COMMAND` | Impostare a `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 segnalano attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando era disabilitato sotto ogni nome. Il nome più vecchio `DISABLE_BUG_COMMAND` è anche accettato |431| `DISABLE_EXTRA_USAGE_COMMAND` | Impostare su `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità |

426| `DISABLE_GROWTHBOOK` | Impostare a `1` o `true` per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i valori predefiniti del codice per ogni flag. Questo rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. L'impostazione a `0` o `false` lascia il recupero attivo. La registrazione degli eventi di telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato |432| `DISABLE_FEEDBACK_COMMAND` | Impostare 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 segnalano attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando era disabilitato con ogni nome. Il nome più vecchio `DISABLE_BUG_COMMAND` è anche accettato |

427| `DISABLE_INSTALLATION_CHECKS` | Impostare a `1` per disabilitare gli avvisi di installazione. Utilizzare solo quando si gestisce manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard |433| `DISABLE_GROWTHBOOK` | Impostare su `1` o `true` per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i predefiniti del codice per ogni flag. Questo rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. L'impostazione su `0` o `false` lascia il recupero attivo. La registrazione degli eventi di telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato |

428| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Impostare a `1` per nascondere il comando `/install-github-app`. Già nascosto quando si utilizzano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry) |434| `DISABLE_INSTALLATION_CHECKS` | Impostare su `1` per disabilitare gli avvisi di installazione. Utilizzare solo quando gestite manualmente il percorso di installazione, poiché questo può mascherare i problemi con le installazioni standard |

429| `DISABLE_INTERLEAVED_THINKING` | Impostare a `1` per impedire l'invio dell'intestazione beta del thinking interleaved. Utile quando il vostro gateway LLM o provider non supporta il [thinking interleaved](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |435| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Impostare su `1` per nascondere il comando `/install-github-app`. Già nascosto quando si utilizzano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry) |

430| `DISABLE_LOGIN_COMMAND` | Impostare a `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |436| `DISABLE_INTERLEAVED_THINKING` | Impostare su `1` per impedire l'invio dell'intestazione beta del pensiero intercalato. Utile quando il vostro gateway LLM o provider non supporta il [pensiero intercalato](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

431| `DISABLE_LOGOUT_COMMAND` | Impostare a `1` per nascondere il comando `/logout` |437| `DISABLE_LOGIN_COMMAND` | Impostare su `1` per nascondere il comando `/login`. Utile quando l'autenticazione viene gestita esternamente tramite chiavi API o `apiKeyHelper` |

432| `DISABLE_PROMPT_CACHING` | Impostare a `1` per disabilitare la [memorizzazione in cache del prompt](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |438| `DISABLE_LOGOUT_COMMAND` | Impostare su `1` per nascondere il comando `/logout` |

433| `DISABLE_PROMPT_CACHING_FABLE` | Impostare a `1` per disabilitare la memorizzazione in cache del prompt per i modelli Fable |439| `DISABLE_PROMPT_CACHING` | Impostare su `1` per disabilitare la [memorizzazione in cache del prompt](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |

434| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare a `1` per disabilitare la memorizzazione in cache del prompt per i modelli Haiku |440| `DISABLE_PROMPT_CACHING_FABLE` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Fable |

435| `DISABLE_PROMPT_CACHING_OPUS` | Impostare a `1` per disabilitare la memorizzazione in cache del prompt per i modelli Opus |441| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Haiku |

436| `DISABLE_PROMPT_CACHING_SONNET` | Impostare a `1` per disabilitare la memorizzazione in cache del prompt per i modelli Sonnet |442| `DISABLE_PROMPT_CACHING_OPUS` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Opus |

437| `DISABLE_TELEMETRY` | Impostare a qualsiasi valore non vuoto, come `1`, per rinunciare alla telemetria. **L'impostazione a `0` o `false` rinuncia comunque**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità con lo stesso effetto di `DISABLE_GROWTHBOOK`, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Vedere [Disattivare la telemetria per la vostra organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |443| `DISABLE_PROMPT_CACHING_SONNET` | Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Sonnet |

438| `DISABLE_UPDATES` | Impostare a `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizzare quando si distribuisce Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornare |444| `DISABLE_TELEMETRY` | Impostare su qualsiasi valore non vuoto, come `1`, per rinunciare alla telemetria. **L'impostazione su `0` o `false` rinuncia comunque**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità con lo stesso effetto di `DISABLE_GROWTHBOOK`, che rende [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Vedere [Disattivare la telemetria per la vostra organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |

439| `DISABLE_UPGRADE_COMMAND` | Impostare a `1` per nascondere il comando `/upgrade` |445| `DISABLE_UPDATES` | Impostare su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizzare quando si distribuisce Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornare |

440| `DO_NOT_TRACK` | Impostare a `1` per rinunciare alla telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso il rendere [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Claude Code legge questa variabile come un booleano standard, quindi `0` lascia la telemetria attiva, e l'onora come la convenzione tra strumenti riconosciuta da molti CLI di sviluppatori |446| `DISABLE_UPGRADE_COMMAND` | Impostare su `1` per nascondere il comando `/upgrade` |

441| `ENABLE_BETA_TRACING_DETAILED` | Impostare a `1`, insieme a `BETA_TRACING_ENDPOINT`, per attivare il [tracciamento beta dettagliato](/docs/it/monitoring-usage#traces-beta), che aggiunge attributi di span che trasportano contenuto e lo span `claude_code.hook`. Le sessioni CLI interattive richiedono anche che la vostra organizzazione sia nella lista di autorizzazione per il beta. Entrambe le variabili vengono ignorate nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |447| `DO_NOT_TRACK` | Impostare su `1` per rinunciare alla telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso il rendere [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che necessitano del recupero dei flag di funzionalità](#features-that-need-feature-flag-fetching) non disponibili. Claude Code legge questa variabile come un booleano standard, quindi `0` lascia la telemetria attiva e la onora come la convenzione tra strumenti riconosciuta da molti CLI di sviluppatori |

442| `ENABLE_CLAUDEAI_MCP_SERVERS` | Impostare a `false` per impedire a Claude Code di recuperare i [server MCP di claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). Abilitato per impostazione predefinita per gli utenti connessi. Per disabilitare per progetto o per organizzazione, impostare [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) nelle impostazioni |448| `ENABLE_BETA_TRACING_DETAILED` | Impostare su `1`, insieme a `BETA_TRACING_ENDPOINT`, per attivare il [tracciamento beta dettagliato](/docs/it/monitoring-usage#traces-beta), che aggiunge attributi che trasportano contenuto e l'intervallo `claude_code.hook`. Le sessioni CLI interattive richiedono anche che la vostra organizzazione sia nella lista di autorizzazione per il beta. Entrambe le variabili vengono ignorate nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

443| `ENABLE_PROMPT_CACHING_1H` | Impostare a `1` per richiedere un [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di 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 di abbonamento all'interno dell'utilizzo incluso ricevono il TTL di 1 ora automaticamente sulla [conversazione principale](/docs/it/prompt-caching#which-ttl-each-request-gets). Gli utenti di abbonamento che attingono ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) possono impostarlo per mantenere il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Per scegliere il TTL per bucket di richiesta, utilizzare `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile |449| `ENABLE_CLAUDEAI_MCP_SERVERS` | Impostare su `false` per impedire a Claude Code di recuperare i [server MCP claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). Abilitato per impostazione predefinita per gli utenti connessi. Per disabilitare per progetto o per organizzazione, impostare [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) nelle impostazioni |

450| `ENABLE_PROMPT_CACHING_1H` | Impostare su `1` per richiedere un [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di 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 di abbonamento entro l'utilizzo incluso ricevono il TTL di 1 ora automaticamente sulla [conversazione principale](/docs/it/prompt-caching#which-ttl-each-request-gets). Gli utenti di abbonamento che attingono ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) possono impostarlo per mantenere il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Per scegliere il TTL per bucket di richiesta, utilizzare `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile |

445| `ENABLE_TOOL_SEARCH` | Controlla la [ricerca degli strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search). Non impostato, Claude Code rinvia tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo su modelli Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, su una distribuzione Microsoft Foundry ospitata su Azure, e quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte. `true` rinvia sempre e invia l'intestazione beta, tranne su quei modelli Agent Platform e distribuzioni Microsoft Foundry; le richieste falliscono su gateway proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti si adattano entro il 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore che impostate voi stessi viene ignorato quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` è impostato. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli su Google Cloud's Agent Platform a meno che non impostaste questa variabile a `true` |452| `ENABLE_TOOL_SEARCH` | Controlla la [ricerca degli strumenti MCP](/docs/it/mcp#scale-with-mcp-tool-search). Non impostato, Claude Code rinvia tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, su una distribuzione Microsoft Foundry ospitata su Azure e quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte. `true` rinvia sempre e invia l'intestazione beta, tranne su quei modelli di Agent Platform e distribuzioni Microsoft Foundry; le richieste falliscono su proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti si adattano entro il 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore che impostate voi stessi viene ignorato quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` è impostato. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli su Google Cloud's Agent Platform a meno che non impostaste questa variabile su `true` |

446| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Impostare a qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di ritentare su errori di sovraccarico ripetuti per ogni modello quando nessun modello di fallback è configurato. **L'impostazione a `0` o `false` abilita comunque questo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per ripristinare il comportamento di ripetizione predefinito. Senza di esso, Claude Code smette di ritentare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando vi autenticate con una chiave API o un [provider di terze parti](/docs/it/third-party-integrations) piuttosto che un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa al vostro [fallback model chain](/docs/it/model-config#fallback-model-chains) configurato su errori di sovraccarico ripetuti per qualsiasi modello primario, quindi questa variabile non influisce sul passaggio a un modello di fallback |453| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Impostare su qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di ritentare su errori di sovraccarico ripetuti per ogni modello quando nessun modello di fallback è configurato. **L'impostazione su `0` o `false` abilita comunque questo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per ripristinare il comportamento di ripetizione predefinito. Senza di esso, Claude Code smette di ritentare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando vi autenticate con una chiave API o un [provider di terze parti](/docs/it/third-party-integrations) piuttosto che un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla vostra [catena del modello di fallback](/docs/it/model-config#fallback-model-chains) configurata su errori di sovraccarico ripetuti per qualsiasi modello primario, quindi questa variabile non influisce sul passaggio a un modello di fallback |

447| `FORCE_AUTOUPDATE_PLUGINS` | Impostare a `1` per forzare gli auto-aggiornamenti dei plugin anche quando l'auto-updater principale è disabilitato tramite `DISABLE_AUTOUPDATER` |454| `FORCE_AUTOUPDATE_PLUGINS` | Impostare su `1` per forzare gli auto-aggiornamenti dei plugin anche quando l'auto-updater principale è disabilitato tramite `DISABLE_AUTOUPDATER` |

448| `FORCE_HYPERLINK` | Impostare a `1` per abilitare i link OSC 8 cliccabili quando il vostro terminale li supporta ma non viene rilevato automaticamente, o `0` per disabilitarli. Quando non impostato, Claude Code abilita i link solo quando rileva il supporto del terminale. Claude Code analizza questo valore come un numero, non un booleano, quindi un valore come `false`, `no`, o `off` abilita i link piuttosto che disabilitarli. Il badge [PR o merge request](/docs/it/interactive-mode#pr-review-status) nel footer viene eseguito come link anche quando Claude Code non può rilevare il supporto del terminale, come su SSH. Impostare `0` per eseguire il rendering del badge come testo semplice |455| `FORCE_HYPERLINK` | Impostare su `1` per abilitare i hyperlink OSC 8 cliccabili quando il vostro terminale li supporta ma non viene rilevato automaticamente, o `0` per disabilitarli. Quando non impostato, Claude Code abilita i hyperlink solo quando rileva il supporto del terminale. Claude Code analizza questo valore come un numero, non un booleano, quindi un valore come `false`, `no` o `off` abilita i hyperlink piuttosto che disabilitarli. Il badge del [PR o merge request](/docs/it/interactive-mode#pr-review-status) del footer viene eseguito come hyperlink anche quando Claude Code non riesce a rilevare il supporto del terminale, come su SSH. Impostare `0` per eseguire il rendering del badge come testo semplice |

449| `FORCE_PROMPT_CACHING_5M` | Impostare a `1` per forzare il TTL della cache del prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H`, e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl` |456| `FORCE_PROMPT_CACHING_5M` | Impostare su `1` per forzare il TTL della cache del prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl` |

452| `IS_DEMO` | Impostare a qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. **L'impostazione a `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione |459| `IS_DEMO` | Impostare su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. **L'impostazione su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione |

453| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da quei strumenti è ancora soggetto a questa variabile (predefinito: 25000) |460| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da quei strumenti è comunque soggetto a questa variabile (predefinito: 25000) |

454| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent del [flusso di lavoro](/docs/it/workflows) non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro riprove |461| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di [flusso di lavoro](/docs/it/workflows) non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro tentativi |

455| `MAX_THINKING_TOKENS` | Budget di token fisso per il [thinking esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token sotto i token di output massimi della richiesta e mai sotto 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il thinking è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la loro profondità di thinking, e gli altri modelli utilizzano il limite. Impostare a `0` per disabilitare il thinking sull'API Anthropic, tranne sui modelli Fable, che non possono avere il thinking disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `0` omette il parametro `thinking`. Con il thinking 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. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |462| `MAX_THINKING_TOKENS` | Budget di token fisso per il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token al di sotto dei token di output massimi della richiesta e mai al di sotto di 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il pensiero è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la loro profondità di pensiero e gli altri modelli utilizzano il limite. Impostare su `0` per disabilitare il pensiero sull'API Anthropic, tranne sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `0` omette il parametro `thinking`. Con il pensiero disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |

456| `MCP_CLIENT_SECRET` | Segreto client OAuth per i server MCP che richiedono [credenziali pre-configurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita il prompt interattivo quando si aggiunge un server con `--client-secret` |463| `MCP_CLIENT_SECRET` | Segreto client OAuth per i server MCP che richiedono [credenziali pre-configurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita il prompt interattivo quando si aggiunge un server con `--client-secret` |

457| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio aspetta che i server MCP si connettano prima della prima query. L'avvio di MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare a `0` per fare in modo che Claude Code aspetti che i server si connettano prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla [cache di scoperta](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`), Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile, con una scadenza più lunga quando passate [`--mcp-config`](/docs/it/cli-reference#cli-flags) esplicitamente; vedere quella voce del flag per l'eccezione del server memorizzato in cache |464| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio aspetta i server MCP per connettersi prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare su `0` per fare in modo che Claude Code aspetti i server per connettersi prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla [cache di scoperta](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passate [`--mcp-config`](/docs/it/cli-reference#cli-flags) esplicitamente, l'attesa ha una scadenza più lunga; vedere la voce di quel flag per l'eccezione del server memorizzato in cache |

458| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo l'avvio di MCP bloccante aspetta, in millisecondi, per il batch di connessione prima di fare uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |465| `MCP_CONNECT_TIMEOUT_MS` | Quanto a lungo l'avvio MCP bloccante aspetta, in millisecondi, il batch di connessione prima di fare uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |

459| `MCP_DISCOVERY_CACHE` | Attiva o disattiva la [cache di scoperta MCP](/docs/it/mcp#server-status-detail). Con la cache attiva, un server HTTP o SSE remoto che avete utilizzato prima può mostrare lo [stato `cached`](/docs/it/mcp#server-status-detail), e Claude Code lo connette alla sua prima chiamata di strumento invece che all'avvio. La cache è disattivata per impostazione predefinita a meno che un rollout graduale non l'abbia abilitata per il vostro account. Impostare a `1` per attivarla, o `0` per mantenerla disattivata anche quando il rollout 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 |466| `MCP_DISCOVERY_CACHE` | Attiva o disattiva la [cache di scoperta MCP](/docs/it/mcp#server-status-detail). Con la cache attiva, un server HTTP o SSE remoto che avete utilizzato prima può mostrare lo [stato `cached`](/docs/it/mcp#server-status-detail), e Claude Code lo connette alla sua prima chiamata di strumento invece che all'avvio. La cache è disattivata per impostazione predefinita a meno che un rollout graduale non l'abbia abilitata per il vostro account. Impostare su `1` per attivarla, o `0` per mantenerla disattivata anche quando il rollout 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 |

460| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Età massima, in secondi, di una voce della [cache di scoperta](/docs/it/mcp#server-status-detail) (predefinito: 14400, o 4 ore). All'avvio in cui la voce è più vecchia di quella, 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, l'impostazione predefinita era 86400, o 24 ore, e Claude Code non limitava il valore |467| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Età massima, in secondi, di una voce della [cache di scoperta](/docs/it/mcp#server-status-detail) (predefinito: 14400, o 4 ore). All'avvio in cui la voce è più vecchia di quella, 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 predefinito era 86400, o 24 ore, e Claude Code non limitava il valore |

461| `MCP_DISCOVERY_CACHE_STRIKES` | All'avvio in cui una voce della [cache di scoperta](/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 di fila possono fallire prima che Claude Code scarta la voce e connette il server al prossimo avvio (predefinito: 1). Aumentare se la vostra connessione di rete cade occasionalmente, in modo che un aggiornamento non riuscito non scarta la voce. Richiede Claude Code v2.1.238 o successivo |468| `MCP_DISCOVERY_CACHE_STRIKES` | All'avvio in cui una voce della [cache di scoperta](/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 di fila possono fallire prima che Claude Code scarta la voce e connette il server al prossimo avvio (predefinito: 1). Aumentare se la vostra connessione di rete cade occasionalmente, in modo che un aggiornamento non riuscito non scarta la voce. Richiede Claude Code v2.1.238 o successivo |

462| `MCP_DISCOVERY_CACHE_TTL_S` | Secondi per i quali Claude Code utilizza una voce della [cache di scoperta](/docs/it/mcp#server-status-detail) senza aggiornarla (predefinito: 900). All'avvio in cui la voce è più vecchia di quella, Claude Code la utilizza comunque ma l'aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la scarta. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che è 4 ore per impostazione predefinita. Prima della v2.1.238, Claude Code non limitava il valore |469| `MCP_DISCOVERY_CACHE_TTL_S` | Secondi per i quali Claude Code utilizza una voce della [cache di scoperta](/docs/it/mcp#server-status-detail) senza aggiornarla (predefinito: 900). All'avvio in cui la voce è più vecchia di quella, Claude Code la utilizza comunque ma l'aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la scarta. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che è 4 ore per impostazione predefinita. Prima della v2.1.238, Claude Code non limitava il valore |

463| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando si aggiunge un server MCP con [credenziali pre-configurate](/docs/it/mcp#use-pre-configured-oauth-credentials) |470| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando si aggiunge un server MCP con [credenziali pre-configurate](/docs/it/mcp#use-pre-configured-oauth-credentials) |

464| `MCP_PROTOCOL_NEGOTIATION` | Solo sul [runtime del client MCP v2](/docs/it/mcp#mcp-client-runtimes), se Claude Code esamina i server per la revisione del protocollo MCP 2026-07-28. Impostare `auto` per esaminare i server HTTP, connettore claude.ai e stdio; un server che non risponde al probe si connette sul protocollo precedente, come fanno sempre i server SSE e WebSocket. Impostare `legacy` per saltare il probe per ogni server. Senza la variabile, Claude Code esamina i server HTTP e connettore claude.ai su Claude Code v2.1.232 o successivo, con le eccezioni che la sezione [runtime del client MCP](/docs/it/mcp#mcp-client-runtimes) elenca. Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successivo |471| `MCP_PROTOCOL_NEGOTIATION` | Solo sul [runtime client MCP v2](/docs/it/mcp#mcp-client-runtimes), se Claude Code esamina i server per la revisione del protocollo MCP 2026-07-28. Impostare `auto` per esaminare i server HTTP, connettore claude.ai e stdio; un server che non risponde al probe si connette sul protocollo precedente, come i server SSE e WebSocket fanno sempre. Impostare `legacy` per saltare il probe per ogni server. Senza la variabile, Claude Code esamina i server HTTP e esamina anche i server del connettore claude.ai nelle sessioni in cui [recupera i flag di funzionalità](#features-that-need-feature-flag-fetching). Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successivo |

465| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |472| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |

466| `MCP_SDK_GENERATION` | Bloccare quale [runtime del client MCP](/docs/it/mcp#mcp-client-runtimes) questo processo si connette ai server MCP con: `v1`, costruito su MCP TypeScript SDK 1.x, o `v2`, costruito su [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Senza la variabile, Claude Code utilizza v2 su Claude Code v2.1.232 o successivo, tranne dove quella sezione dice che utilizza v1. Su Claude Code v2.1.221 o successivo, il runtime v2 controlla l'emittente che un server OAuth MCP restituisce nella sua risposta di autorizzazione e fallisce l'accesso con un errore che inizia `Issuer mismatch in authorization response` quando non corrisponde. Il runtime v1 non esegue questo controllo. Se impostate 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 |473| `MCP_SDK_GENERATION` | Bloccare quale [runtime client MCP](/docs/it/mcp#mcp-client-runtimes) questo processo si connette ai server MCP con: `v1`, costruito su MCP TypeScript SDK 1.x, o `v2`, costruito su [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Senza la variabile, Claude Code utilizza v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 controlla l'emittente che un server OAuth MCP restituisce nella sua risposta di autorizzazione e fallisce l'accesso con un errore che inizia `Issuer mismatch in authorization response` quando non corrisponde. Il runtime v1 non esegue questo controllo. Se impostate 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 |

467| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |474| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |

469| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade anche dopo 60 secondi per impostazione predefinita; impostare questa variabile, o il `timeout` per server, sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout di esecuzione dello strumento complessivo ma lascia il timer per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sostituisce questo per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate di strumento di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo limite richiede Claude Code v2.1.203 o successivo. Per la variabile env, i valori inferiori a 1000 vengono aumentati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |476| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade anche dopo 60 secondi per impostazione predefinita; impostare questa variabile o il `timeout` per server sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout di esecuzione dello strumento complessivo ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sostituisce questo per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate di strumento di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo floor richiede Claude Code v2.1.203 o successivo. Per la variabile env, i valori inferiori a 1000 sono limitati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |

471| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard dell'SDK OpenTelemetry sulla lunghezza del valore dell'attributo. Claude Code limita gli attributi di telemetria che trasportano contenuto al minore di questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento rimanga entro il limite dell'SDK. Claude Code legge le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` allo stesso modo, e il valore più piccolo impostato si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |478| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard OpenTelemetry SDK sulla lunghezza del valore dell'attributo. Claude Code limita gli attributi di telemetria che trasportano contenuto al minore di questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento rimanga entro il limite dell'SDK. Claude Code legge le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` allo stesso modo e il valore più piccolo impostato si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |

472| `OTEL_LOG_ASSISTANT_RESPONSES` | Impostare a `1` per includere il testo della risposta del modello sugli eventi di log OpenTelemetry `assistant_response`. Quando non impostato, viene utilizzato il valore di `OTEL_LOG_USER_PROMPTS`. Impostare a `0` per mantenere le risposte redatte anche quando `OTEL_LOG_USER_PROMPTS` è impostato. Richiede Claude Code v2.1.193 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |479| `OTEL_LOG_ASSISTANT_RESPONSES` | Impostare su `1` per includere il testo della risposta del modello sugli eventi di log OpenTelemetry `assistant_response`. Quando non impostato, viene utilizzato il valore di `OTEL_LOG_USER_PROMPTS`. Impostare su `0` per mantenere le risposte redatte anche quando `OTEL_LOG_USER_PROMPTS` è impostato. Richiede Claude Code v2.1.193 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |

473| `OTEL_LOG_RAW_API_BODIES` | Emettere il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Impostare a `1` per i corpi in linea troncati al limite di contenuto, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostatelo nella vostra shell, nelle impostazioni utente, o nelle impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Vedere [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |480| `OTEL_LOG_MANAGED_SETTINGS` | Impostare su `1` per aggiungere le impostazioni gestite redatte e un digest SHA-256 delle impostazioni prima della redazione agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitato per impostazione predefinita. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite; un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo. Vedere [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |

474| `OTEL_LOG_TOOL_CONTENT` | Impostare a `1` per includere il contenuto di input e output dello strumento negli eventi di span OpenTelemetry. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedere [Monitoraggio](/docs/it/monitoring-usage) |481| `OTEL_LOG_RAW_API_BODIES` | Emettere il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Impostare su `1` per i corpi in linea troncati al limite di contenuto, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Vedere [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |

475| `OTEL_LOG_TOOL_DETAILS` | Impostare a `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, i nomi dei flussi di lavoro creati dall'utente, le stringhe di errore grezze sui fallimenti dello strumento, la `category` di rifiuto sugli eventi `api_refusal`, e altri dettagli dello strumento nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le PII. Vedere [Monitoraggio](/docs/it/monitoring-usage) |482| `OTEL_LOG_TOOL_CONTENT` | Impostare su `1` per includere il contenuto dello strumento nell'evento di intervallo OpenTelemetry `tool.output`. Gli attributi di intervallo trasportano il contenuto dello strumento sotto i [loro propri gate](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracciamento](/docs/it/monitoring-usage#traces-beta). Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedere [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |

476| `OTEL_LOG_USER_PROMPTS` | Impostare a `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedere [Monitoraggio](/docs/it/monitoring-usage) |483| `OTEL_LOG_TOOL_DETAILS` | Impostare su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, i nomi dei flussi di lavoro creati dall'utente, le stringhe di errore grezze sui fallimenti degli strumenti, la `category` di rifiuto sugli eventi `api_refusal` e altri dettagli dello strumento nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le PII. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

477| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Impostare a `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |484| `OTEL_LOG_USER_PROMPTS` | Impostare su `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

478| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Impostare a `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto nella v2.1.152. Vedere [Monitoraggio](/docs/it/monitoring-usage) |485| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Impostare su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

479| `OTEL_METRICS_INCLUDE_REPOSITORY` | Impostare a `true` per taggare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Vedere [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |486| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Impostare su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto nella v2.1.152. Vedere [Monitoraggio](/docs/it/monitoring-usage) |

480| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partire dalla v2.1.161, Claude Code allega le chiavi `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei punti dati delle metriche. Impostare a `false` per escluderle (predefinito: incluse). Vedere [Monitoraggio](/docs/it/monitoring-usage#multi-team-organization-support) |487| `OTEL_METRICS_INCLUDE_REPOSITORY` | Impostare su `true` per taggare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Vedere [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |

481| `OTEL_METRICS_INCLUDE_SESSION_ID` | Impostare a `false` per escludere l'ID della sessione dagli attributi delle metriche (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |488| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partire dalla v2.1.161, Claude Code allega le chiavi `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei punti dati delle metriche. Impostare su `false` per escluderle (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage#multi-team-organization-support) |

482| `OTEL_METRICS_INCLUDE_VERSION` | Impostare a `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |489| `OTEL_METRICS_INCLUDE_SESSION_ID` | Impostare su `false` per escludere l'ID della sessione dagli attributi delle metriche (predefinito: incluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

490| `OTEL_METRICS_INCLUDE_VERSION` | Impostare su `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Vedere [Monitoraggio](/docs/it/monitoring-usage) |

483| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sostituire il budget di caratteri per i metadati della skill mostrati allo [strumento Skill](/docs/it/skills#control-who-invokes-a-skill). Il budget si ridimensiona dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per la compatibilità all'indietro |491| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sostituire il budget di caratteri per i metadati della skill mostrati allo [strumento Skill](/docs/it/skills#control-who-invokes-a-skill). Il budget si ridimensiona dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per la compatibilità all'indietro |

484| `TASK_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri dell'output di un [compito di background](/docs/it/tools-reference#background-commands) che lo strumento `TaskOutput` mantiene (predefinito: 32000; massimo: 160000). Se impostate l'impostazione [`taskOutputMaxChars`](/docs/it/settings-reference#taskoutputmaxchars), Claude Code ignora questa variabile |492| `TASK_MAX_OUTPUT_LENGTH` | Rimosso nella v2.1.277 e ora un no-op, insieme allo strumento `TaskOutput` che ha dimensionato. In precedenza impostava il numero massimo di caratteri dell'output di un [compito in background](/docs/it/tools-reference#background-commands) che lo strumento `TaskOutput` manteneva. Claude legge l'output di un compito in background con `Read` |

485| `USE_BUILTIN_RIPGREP` | Impostare a `0` per utilizzare il `rg` installato dal sistema invece del `rg` incluso con Claude Code |493| `USE_BUILTIN_RIPGREP` | Impostare su `0` per utilizzare il `rg` installato dal sistema invece di `rg` incluso con Claude Code |

486| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sostituire la regione per Claude 3.5 Haiku quando si utilizza Google Cloud's Agent Platform |494| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sostituire l'area per Claude 3.5 Haiku quando si utilizza Google Cloud's Agent Platform |

487| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sostituire la regione per Claude 3.5 Sonnet quando si utilizza Google Cloud's Agent Platform |495| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sostituire l'area per Claude 3.5 Sonnet quando si utilizza Google Cloud's Agent Platform |

488| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sostituire la regione per Claude 3.7 Sonnet quando si utilizza Google Cloud's Agent Platform |496| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sostituire l'area per Claude 3.7 Sonnet quando si utilizza Google Cloud's Agent Platform |

489| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sostituire la regione per Claude 4.0 Opus quando si utilizza Google Cloud's Agent Platform |497| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sostituire l'area per Claude 4.0 Opus quando si utilizza Google Cloud's Agent Platform |

490| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sostituire la regione per Claude 4.0 Sonnet quando si utilizza Google Cloud's Agent Platform |498| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sostituire l'area per Claude 4.0 Sonnet quando si utilizza Google Cloud's Agent Platform |

491| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sostituire la regione per Claude 4.1 Opus quando si utilizza Google Cloud's Agent Platform |499| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sostituire l'area per Claude 4.1 Opus quando si utilizza Google Cloud's Agent Platform |

492| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sostituire la regione per Claude Opus 4.5 quando si utilizza Google Cloud's Agent Platform |500| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sostituire l'area per Claude Opus 4.5 quando si utilizza Google Cloud's Agent Platform |

493| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sostituire la regione per Claude Sonnet 4.5 quando si utilizza Google Cloud's Agent Platform |501| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sostituire l'area per Claude Sonnet 4.5 quando si utilizza Google Cloud's Agent Platform |

494| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sostituire la regione per Claude Opus 4.6 quando si utilizza Google Cloud's Agent Platform |502| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sostituire l'area per Claude Opus 4.6 quando si utilizza Google Cloud's Agent Platform |

495| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sostituire la regione per Claude Sonnet 4.6 quando si utilizza Google Cloud's Agent Platform |503| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sostituire l'area per Claude Sonnet 4.6 quando si utilizza Google Cloud's Agent Platform |

496| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sostituire la regione per Claude Opus 4.7 quando si utilizza Google Cloud's Agent Platform |504| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sostituire l'area per Claude Opus 4.7 quando si utilizza Google Cloud's Agent Platform |

497| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sostituire la regione per Claude Opus 4.8 quando si utilizza Google Cloud's Agent Platform |505| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sostituire l'area per Claude Opus 4.8 quando si utilizza Google Cloud's Agent Platform |

498| `VERTEX_REGION_CLAUDE_5_OPUS` | Sostituire la regione per Claude Opus 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.219 |506| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sostituire l'area per Claude Opus 5.5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.280 |

499| `VERTEX_REGION_CLAUDE_5_SONNET` | Sostituire la regione per Claude Sonnet 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.197 |507| `VERTEX_REGION_CLAUDE_5_OPUS` | Sostituire l'area per Claude Opus 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.219 |

500| `VERTEX_REGION_CLAUDE_FABLE_5` | Sostituire la regione per Claude Fable 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.170 |508| `VERTEX_REGION_CLAUDE_5_SONNET` | Sostituire l'area per Claude Sonnet 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.197 |

501| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sostituire la regione per Claude Fable 5.1 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.257 |509| `VERTEX_REGION_CLAUDE_FABLE_5` | Sostituire l'area per Claude Fable 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.170 |

502| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sostituire la regione per Claude Haiku 4.5 quando si utilizza Google Cloud's Agent Platform |510| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sostituire l'area per Claude Fable 5.1 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.257 |

~~503~~ 511| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sostituire l'area per Claude Haiku 4.5 quando si utilizza Google Cloud's Agent Platform |

504Le variabili dell'esportatore OpenTelemetry standard (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES`, e varianti specifiche del segnale) sono anche supportate. Vedere [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.512

513Sono supportate anche le variabili dell'esportatore OpenTelemetry standard (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e varianti specifiche del segnale). Vedere [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.

505 514

506<h2 id="features-that-need-feature-flag-fetching">515<h2 id="features-that-need-feature-flag-fetching">

507 Funzionalità che richiedono il recupero dei feature flag516 Funzionalità che richiedono il recupero dei feature flag

515 524

516Con il recupero disattivato, non potete:525Con il recupero disattivato, non potete:

517 526

527* Avere Claude Code [leggere i file `AGENTS.md`](/docs/it/memory#agents-md) come istruzioni di progetto; carica solo i file `CLAUDE.md`

518* [Avviare sessioni in modalità auto per impostazione predefinita](/docs/it/permission-modes#which-mode-a-session-starts-in) sui piani Pro, Max e Team528* [Avviare sessioni in modalità auto per impostazione predefinita](/docs/it/permission-modes#which-mode-a-session-starts-in) sui piani Pro, Max e Team

519* Far [leggere al'estensione VS Code i file di impostazioni per la modalità di autorizzazione iniziale](/docs/it/permission-modes#switch-permission-modes)529* Far [leggere all'estensione VS Code i file di impostazioni per la modalità di autorizzazione iniziale](/docs/it/permission-modes#switch-permission-modes)

520* Eseguire [`/auto-mode-setup`](/docs/it/auto-mode-config#generate-environment-entries) per elaborare le voci `autoMode.environment`530* Eseguire [`/auto-mode-setup`](/docs/it/auto-mode-config#generate-environment-entries) per elaborare le voci `autoMode.environment`

521* Utilizzare [Remote Control](/docs/it/remote-control#requirements)531* Utilizzare [Remote Control](/docs/it/remote-control#requirements)

522* [Inviare messaggi alle sessioni oltre questa macchina](/docs/it/cross-session-messaging#message-sessions-on-other-machines); la messaggistica tra sessioni su questa macchina funziona con il recupero disattivato532* [Inviare messaggi alle sessioni oltre questa macchina](/docs/it/cross-session-messaging#message-sessions-on-other-machines); la messaggistica tra sessioni su questa macchina funziona con il recupero disattivato

523* Eseguire [`claude import` o il comando `/import`](/docs/it/cli-reference#cli-commands)533* Eseguire [`claude import` o il comando `/import`](/docs/it/cli-reference#cli-commands)

524* Eseguire [`/skill-doctor`](/docs/it/skills#find-unused-skills) o aprire il suo rapporto nella scheda **Stats** di `/plugin`534* Eseguire [`/skill-doctor`](/docs/it/skills#find-unused-skills) o aprire il suo rapporto nella scheda **Stats** di `/plugin`

535* Sincronizzare le [skill](/docs/it/skills#where-synced-skills-load) e i [plugin](/docs/it/plugins-reference#synced-plugins) abilitati per il vostro account claude.ai nelle vostre sessioni di terminale

525* Utilizzare [lo strumento advisor](/docs/it/advisor#requirements)536* Utilizzare [lo strumento advisor](/docs/it/advisor#requirements)

526* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)537* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)

527* Ottenere il [runtime client MCP v2](/docs/it/mcp#mcp-client-runtimes) e il suo probe del protocollo senza impostare `MCP_SDK_GENERATION` e `MCP_PROTOCOL_NEGOTIATION`; Claude Code utilizza il runtime v1 a meno che non impostiate `MCP_SDK_GENERATION=v2`, e salta il probe a meno che non impostiate `MCP_PROTOCOL_NEGOTIATION=auto`538* Avere Claude Code sondare i server del connettore claude.ai per [la revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes) a meno che non impostiate `MCP_PROTOCOL_NEGOTIATION=auto`

528* 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 attivo539* 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 attivo

529* Ottenere il [feedback elaborato da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), che Claude Code attiva tramite un flag recuperato540* Ottenere il [feedback elaborato da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), che Claude Code attiva tramite un flag recuperato

530* Far [escludere a Claude Code 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)541* 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 marcatura

542* 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)

531 543

532<h3 id="first-session-after-an-install-or-upgrade">544<h3 id="first-session-after-an-install-or-upgrade">

533 Prima sessione dopo un'installazione o un aggiornamento545 Prima sessione dopo un'installazione o un aggiornamento

errors.md +160 −14

Details

4 4

5# Riferimento degli errori5# Riferimento degli errori

6 6

~~7> Cercate i messaggi di errore di runtime di Claude Code con il significato di ciascuno e come risolverlo.~~7> Consulta i messaggi di errore runtime di Claude Code con il significato di ciascuno e come risolverli.

8 8

9Questa pagina elenca gli errori di runtime che Claude Code visualizza e come recuperare da ciascuno, più cosa controllare quando le risposte sembrano non corrette senza un errore. Per gli errori di installazione come `command not found` o errori TLS durante la configurazione, vedere [Risoluzione dei problemi di installazione e accesso](/docs/it/troubleshoot-install).9Questa pagina elenca gli errori runtime che Claude Code visualizza e come recuperare da ciascuno, più cosa controllare quando le risposte sembrano non corrette senza un errore. Per gli errori di installazione come `command not found` o errori TLS durante la configurazione, vedi [Risoluzione dei problemi di installazione e accesso](/docs/it/troubleshoot-install).

10 10

11Ad eccezione degli [errori di Wrapper e IDE](#wrapper-and-ide-errors), che il programma di avvio stampa piuttosto che Claude Code stesso, questi errori e i comandi di recupero si applicano su CLI, l'[app Desktop](/docs/it/desktop) e [Claude Code sul web](/docs/it/claude-code-on-the-web), poiché tutti e tre avvolgono lo stesso CLI di Claude Code. Per altri problemi specifici della superficie, vedere la sezione di risoluzione dei problemi nella pagina di quella superficie.11Ad eccezione degli [errori di Wrapper e IDE](#wrapper-and-ide-errors), che il programma di avvio stampa piuttosto che Claude Code stesso, questi errori e comandi di recupero si applicano su CLI, l'[app Desktop](/docs/it/desktop) e le [sessioni cloud](/docs/it/claude-code-on-the-web), poiché tutti e tre avvolgono lo stesso CLI di Claude Code. Per altri problemi specifici della superficie, vedi la sezione di risoluzione dei problemi nella pagina di quella superficie.

12 12

13<Note>13<Note>

14 Claude Code chiama l'API Claude per le risposte del modello, quindi la maggior parte degli errori di runtime si mappano a un codice di errore API sottostante. Questa pagina copre cosa significa ogni errore all'interno di Claude Code e come recuperare. Per le definizioni del codice di stato HTTP grezzo, vedere il [riferimento degli errori della piattaforma Claude](https://platform.claude.com/docs/en/api/errors).14 Claude Code chiama l'API Claude per le risposte del modello, quindi la maggior parte degli errori runtime si mappano a un codice di errore API sottostante. Questa pagina copre cosa significa ogni errore all'interno di Claude Code e come recuperare. Per le definizioni del codice di stato HTTP grezzo, vedi il [riferimento degli errori della piattaforma Claude](https://platform.claude.com/docs/en/api/errors).

15</Note>15</Note>

16 16

17<h2 id="find-your-error">17<h2 id="find-your-error">

74| `Artifacts need a claude.ai login` | [Autenticazione](#artifacts-need-a-claude-ai-login) |

74| `Not signed in to the Cloud gateway — run /login.` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |75| `Not signed in to the Cloud gateway — run /login.` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |

75| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |76| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Autenticazione](#administrator-policy-requires-a-cloud-gateway-sign-in) |

91| `Sign-in timed out while waiting for you to continue. Try again.` | [Autenticazione](#sign-in-timed-out-while-waiting-for-you-to-continue) |

149| `effort '<level>' is not supported when thinking is disabled` | [Errori di richiesta](#effort-isnt-available-with-thinking-turned-off) |151| `effort '<level>' is not supported when thinking is disabled` | [Errori di richiesta](#effort-isnt-available-with-thinking-turned-off) |

150| `max_tokens must be greater than thinking.budget_tokens` | [Errori di richiesta](#thinking-budget-exceeds-output-limit) |152| `max_tokens must be greater than thinking.budget_tokens` | [Errori di richiesta](#thinking-budget-exceeds-output-limit) |

154| `API Error: 400 orphaned tool_result in conversation history` | [Errori di richiesta](#tool-use-or-thinking-block-mismatch) |

155| `API Error: 400 duplicate tool_use ID in conversation history` | [Errori di richiesta](#tool-use-or-thinking-block-mismatch) |

153| `server_tool_use.name: Input should be` on every turn of a resumed session | [Errori di richiesta](#unsupported-tool-content-removed) |157| `server_tool_use.name: Input should be` on every turn of a resumed session | [Errori di richiesta](#unsupported-tool-content-removed) |

155| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Errori di richiesta](#usage-policy-refusal) |159| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Errori di richiesta](#usage-policy-refusal) |

161| `Opus 5.5's safeguards flagged this session` | [Errori di richiesta](#safety-measures-flagged-a-cybersecurity-topic) |

157| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Errori di richiesta](#safety-measures-flagged-a-cybersecurity-topic) |162| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Errori di richiesta](#safety-measures-flagged-a-cybersecurity-topic) |

158| `Installation was killed before it could finish (exit code 137)` | [Errori di installazione](#installation-was-killed-before-it-could-finish) |163| `Installation was killed before it could finish (exit code 137)` | [Errori di installazione](#installation-was-killed-before-it-could-finish) |

159| `The connection dropped while downloading the update` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |164| `The connection dropped while downloading the update` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |

199| `No conversation found with session ID: <session-id>` | [Errori della riga di comando](#no-conversation-found-with-the-session-id) |204| `No conversation found with session ID: <session-id>` | [Errori della riga di comando](#no-conversation-found-with-the-session-id) |

201| `Cannot switch renderers while work is running in the background` | [Errori della riga di comando](#cannot-switch-renderers-in-this-session) |206| `Cannot switch renderers while work is running in the background` | [Errori della riga di comando](#cannot-switch-renderers-in-this-session) |

207| `Couldn't open Claude Desktop` | [Errori della riga di comando](#couldnt-open-claude-desktop) |

208| `Failed to open Claude Desktop. Please try opening it manually.` | [Errori della riga di comando](#couldnt-open-claude-desktop) |

202| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Errori della riga di comando](#terminal-setup-left-your-zed-keymap-unchanged) |209| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Errori della riga di comando](#terminal-setup-left-your-zed-keymap-unchanged) |

203| `Your Zed keymap isn't a readable list of keybindings` | [Errori della riga di comando](#terminal-setup-left-your-zed-keymap-unchanged) |210| `Your Zed keymap isn't a readable list of keybindings` | [Errori della riga di comando](#terminal-setup-left-your-zed-keymap-unchanged) |

204| `Skill usage reports are not available on this connection.` | [Errori della riga di comando](#skill-usage-reports-are-not-available-on-this-connection) |211| `Skill usage reports are not available on this connection.` | [Errori della riga di comando](#skill-usage-reports-are-not-available-on-this-connection) |

206| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Errori della riga di comando](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |213| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Errori della riga di comando](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

207| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Errori dei plugin](#plugin-eval-is-currently-in-early-access) |214| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Errori dei plugin](#plugin-eval-is-currently-in-early-access) |

208| `Marketplace "<name>" is registered from an untrusted source` | [Errori dei plugin](#marketplace-is-registered-from-an-untrusted-source) |215| `Marketplace "<name>" is registered from an untrusted source` | [Errori dei plugin](#marketplace-is-registered-from-an-untrusted-source) |

216| `Marketplace "<name>" is already added from a different source` | [Errori dei plugin](#marketplace-is-already-added-from-a-different-source) |

209| `references ${user_config.*} in a shell-form command` | [Errori dei plugin](#plugin-command-references-user-config) |217| `references ${user_config.*} in a shell-form command` | [Errori dei plugin](#plugin-command-references-user-config) |

210| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Errori dei plugin](#plugin-command-references-user-config) |218| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Errori dei plugin](#plugin-command-references-user-config) |

211| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Errori dei plugin](#plugin-command-references-user-config) |219| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Errori dei plugin](#plugin-command-references-user-config) |

216| `Plugin source path refused` | [Errori dei plugin](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |224| `Plugin source path refused` | [Errori dei plugin](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

227| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Errori dei plugin](#plugin-is-required-by-your-organization) |

220| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |229| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |

221| `subagent_type is required: the general-purpose agent is not available in this session` | [Errori degli strumenti](#subagent-type-is-required) |230| `subagent_type is required: the general-purpose agent is not available in this session` | [Errori degli strumenti](#subagent-type-is-required) |

246| `Can't open MCP settings in a background session` | [Errori della sessione in background](#commands-refused-in-a-background-session) |255| `Can't open MCP settings in a background session` | [Errori della sessione in background](#commands-refused-in-a-background-session) |

247| `blocked because the path is spelled in a form that cannot be safely resolved` | [Errori della sessione in background](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |256| `blocked because the path is spelled in a form that cannot be safely resolved` | [Errori della sessione in background](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |

248| `blocked because the path is network-shaped` | [Errori della sessione in background](#write-or-command-blocked-because-the-path-names-a-network-location) |257| `blocked because the path is network-shaped` | [Errori della sessione in background](#write-or-command-blocked-because-the-path-names-a-network-location) |

258| `is isolated in the worktree <path>, but this command <reason>. Refusing to run it` | [Errori della sessione in background](#command-blocked-by-the-worktree-isolation-checks) |

259| `too complex to verify that it stays inside the worktree` | [Errori della sessione in background](#command-blocked-by-the-worktree-isolation-checks) |

250| `Can't open — this session is running in another terminal` | [Errori della sessione in background](#this-session-is-running-in-another-terminal) |261| `Can't open — this session is running in another terminal` | [Errori della sessione in background](#this-session-is-running-in-another-terminal) |

251| `This conversation is already open in another running Claude session` | [Errori della sessione in background](#this-session-is-running-in-another-terminal) |262| `This conversation is already open in another running Claude session` | [Errori della sessione in background](#this-session-is-running-in-another-terminal) |

281| `MCP server <name> is blocked by enterprise managed policy` | [Avvisi di configurazione](#mcp-server-is-blocked-by-enterprise-managed-policy) |292| `MCP server <name> is blocked by enterprise managed policy` | [Avvisi di configurazione](#mcp-server-is-blocked-by-enterprise-managed-policy) |

282| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |293| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |

283| `Managed settings drop-in directory could not be read` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |294| `Managed settings drop-in directory could not be read` | [Avvisi di configurazione](#managed-settings-document-could-not-be-parsed) |

295| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Avvisi di configurazione](#otelheadershelper-failed) |

284| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Avvisi di configurazione](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |296| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Avvisi di configurazione](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

286| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Avvisi di configurazione](#malformed-tool-content-rule) |298| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Avvisi di configurazione](#malformed-tool-content-rule) |

624**Cosa fare:**636**Cosa fare:**

625 637

626* Esegui `/model` e seleziona la variante senza il suffisso `[1m]` per tornare alla finestra di contesto standard638* Esegui `/model` e seleziona la variante senza il suffisso `[1m]` per tornare alla finestra di contesto standard

627* Dove il messaggio nomina `/usage-credits`, eseguilo per attivare la fatturazione a consumo per la variante 1M su Pro e Max, o per richiedere crediti di utilizzo al tuo amministratore su Team ed Enterprise. Riavvia Claude Code una volta che i crediti di utilizzo sono attivati. Fino al riavvio, la sessione rimane al limite di contesto standard.639* Dove il messaggio nomina `/usage-credits`, eseguilo per attivare la fatturazione a consumo per la variante 1M su Pro e Max, o per richiedere crediti di utilizzo al tuo amministratore su Team ed Enterprise. Una volta che i crediti di utilizzo sono attivati, riavvia Claude Code o avvia una nuova sessione, a seconda di quello che dice il messaggio. Fino al riavvio, la sessione rimane al limite di contesto standard.

628* Se l'errore persiste dopo `/model`, un ID modello 1M potrebbe essere impostato altrove. Vedi [Setting your model](/docs/it/model-config#setting-your-model) per i percorsi di configurazione da controllare in ordine di priorità.640* Se l'errore persiste dopo `/model`, un ID modello 1M potrebbe essere impostato altrove. Vedi [Setting your model](/docs/it/model-config#setting-your-model) per i percorsi di configurazione da controllare in ordine di priorità.

629* Per rimuovere completamente le varianti 1M dal selettore di modelli, imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars)641* Per rimuovere completamente le varianti 1M dal selettore di modelli, imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars)

630 642

861* Eseguite il comando configurato in `apiKeyHelper` direttamente nella Vostra shell per riprodurre l'errore873* Eseguite il comando configurato in `apiKeyHelper` direttamente nella Vostra shell per riprodurre l'errore

862* Se il comando segnala una sessione scaduta, riauthenticate con il Vostro provider di credenziali, ad esempio accedendo di nuovo al Vostro SSO o vault di segreti874* Se il comando segnala una sessione scaduta, riauthenticate con il Vostro provider di credenziali, ad esempio accedendo di nuovo al Vostro SSO o vault di segreti

863* Correggete il comando in modo che stampi solo la chiave su stdout, come un singolo token di ASCII stampabile fino a 16.384 caratteri, e uscite con codice 0. Vedete [ruotare le credenziali con apiKeyHelper](/docs/it/llm-gateway-connect#rotate-credentials-with-apikeyhelper) per una configurazione funzionante.875* Correggete il comando in modo che stampi solo la chiave su stdout, come un singolo token di ASCII stampabile fino a 16.384 caratteri, e uscite con codice 0. Vedete [ruotare le credenziali con apiKeyHelper](/docs/it/llm-gateway-connect#rotate-credentials-with-apikeyhelper) per una configurazione funzionante.

864* Eseguite `/status` per confermare che `apiKeyHelper` sia la fonte di credenziale attiva. Ogni volta che il comando fallisce, il suo codice di uscita e l'output di errore appaiono in un pannello `Authentication` nel terminale. Prima della v2.1.212, il pannello era intitolato `Cloud authentication`.876* Eseguite `/status` per vedere l'errore e confermare che `apiKeyHelper` sia la fonte di credenziale attiva. La riga `apiKeyHelper` mostra `Failing` con il dettaglio dell'ultimo errore, come il codice di uscita e l'output di errore del comando, e scompare dopo il prossimo esecuzione riuscita. Prima della v2.1.274, `/status` mostrava solo la fonte di credenziale, non l'errore.

877* Ogni volta che il comando fallisce, il suo codice di uscita e l'output di errore appaiono anche in un pannello `Authentication` nel terminale. Prima della v2.1.212, il pannello era intitolato `Cloud authentication`.

865 878

866<h3 id="invalid-request-header-value">879<h3 id="invalid-request-header-value">

867 Valore di intestazione di richiesta non valido880 Valore di intestazione di richiesta non valido

1167 1180

1168* Eseguite `/login`, completate l'accesso, quindi avviate di nuovo la sessione1181* Eseguite `/login`, completate l'accesso, quindi avviate di nuovo la sessione

1169 1182

1183<h3 id="artifacts-need-a-claude-ai-login">

1184 Artifacts hanno bisogno di un login claude.ai

1185</h3>

1186

1187Claude Code ha rifiutato una pubblicazione o lettura di [artifact](/docs/it/artifacts) perché la sessione non ha alcun login claude.ai che possa utilizzare per gli artifact.

1188

1189Ogni forma del messaggio inizia con le stesse parole, seguita da un rimedio che dipende da come la Vostra sessione si autentica. Senza alcuna credenziale in competizione legge:

1190

1191```text theme={null}

1192Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

1193```

1194

1195**Cosa fare:**

1196

1197* Eseguite `/login` e selezionate **Claude account with subscription**. L'opzione **Anthropic Console account** non fornisce credenziali claude.ai.

1198* Quando il messaggio nomina una credenziale che ha la precedenza, come `ANTHROPIC_API_KEY`, un'impostazione `apiKeyHelper` o una chiave Console salvata da un `/login` precedente, rimuovetela nel modo che il messaggio dice, quindi eseguite `/login`

1199* Quando il messaggio dice che questa sessione remota si autentica attraverso la macchina che l'ha lanciata, accedete a claude.ai su quella macchina, quindi riconnettete la sessione

1200* Quando il messaggio dice che la credenziale è iniettata dall'ambiente host della sessione, non potete cambiarla in quella sessione; avviate una sessione che è connessa a claude.ai

1201* Vedete [Disponibilità](/docs/it/artifacts#availability) per gli altri requisiti che gli artifact hanno, come piano, provider di modello e politica dell'organizzazione

1202

1170<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1203<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">

1171 La politica dell'amministratore richiede un accesso al gateway Cloud1204 La politica dell'amministratore richiede un accesso al gateway Cloud

1172</h3>1205</h3>

1535* Eseguite `/login` nella sessione e completate l'accesso del browser1568* Eseguite `/login` nella sessione e completate l'accesso del browser

1536* Per un lancio non interattivo, avviate `claude` nello stesso ambiente, eseguite `/login`, quindi rieseguite il Vostro comando1569* Per un lancio non interattivo, avviate `claude` nello stesso ambiente, eseguite `/login`, quindi rieseguite il Vostro comando

1537 1570

1571<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">

1572 Sign-in scaduto mentre vi aspettava di continuare

1573</h3>

1574

1575Durante un [accesso al gateway delle app Claude](/docs/it/claude-apps-gateway), il gateway ha nominato l'account che ha effettuato l'accesso, e Claude Code vi ha chiesto di confermarlo prima di salvare la credenziale. Avete lasciato la conferma aperta oltre la scadenza dell'accesso stesso, e il gateway non ha emesso alcun token di aggiornamento che potesse rinnovarlo, quindi Claude Code non ha memorizzato nulla quando avete continuato:

1576

1577```text theme={null}

1578Sign-in timed out while waiting for you to continue. Try again.

1579```

1580

1581**Cosa fare:**

1582

1583* Eseguite `/login` di nuovo e confermate l'account prima che l'accesso scada

1584

1538<h3 id="gateway-refused-the-request">1585<h3 id="gateway-refused-the-request">

1539 Il gateway ha rifiutato la richiesta1586 Il gateway ha rifiutato la richiesta

1540</h3>1587</h3>

2268 2315

2269**Cosa fare:**2316**Cosa fare:**

2270 2317

2271* Eseguite `claude update` e riavviate Claude Code. Opus 4.7 ha bisogno della v2.1.111 o successiva. Opus 4.8 ha bisogno della v2.1.154 o successiva. Sonnet 5 ha bisogno della v2.1.197 o successiva. Opus 5 ha bisogno della v2.1.219 o successiva2318* Eseguite `claude update` e riavviate Claude Code. Opus 4.7 ha bisogno della v2.1.111 o successiva. Opus 4.8 ha bisogno della v2.1.154 o successiva. Sonnet 5 ha bisogno della v2.1.197 o successiva. Opus 5 ha bisogno della v2.1.219 o successiva. Opus 5.5 ha bisogno della v2.1.280 o successiva

2272* Se non potete aggiornare, eseguite `/model` e selezionate Opus 4.6 o Sonnet 4.6 invece2319* Se non potete aggiornare, eseguite `/model` e selezionate Opus 4.6 o Sonnet 4.6 invece

2273* Se lo incontrate nell'[Agent SDK](/docs/it/agent-sdk/overview), aggiornate il pacchetto SDK. Opus 4.8 ha bisogno di TypeScript SDK v0.3.154 o successiva e Python SDK v0.2.88 o successiva. Sonnet 5 ha bisogno di TypeScript SDK v0.3.197 o successiva. Opus 5 ha bisogno di TypeScript SDK v0.3.219 o successiva2320* Se lo incontrate nell'[Agent SDK](/docs/it/agent-sdk/overview), aggiornate il pacchetto SDK. Opus 4.8 ha bisogno di TypeScript SDK v0.3.154 o successiva e Python SDK v0.2.88 o successiva. Sonnet 5 ha bisogno di TypeScript SDK v0.3.197 o successiva. Opus 5 ha bisogno di TypeScript SDK v0.3.219 o successiva. Opus 5.5 ha bisogno di TypeScript SDK v0.3.280 o successiva

2274 2321

2275<h3 id="effort-isnt-available-with-thinking-turned-off">2322<h3 id="effort-isnt-available-with-thinking-turned-off">

2276 Effort non è disponibile con thinking disattivato2323 Effort non è disponibile con thinking disattivato

2314 2361

2315```text theme={null}2362```text theme={null}

2316API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2363API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.

2364API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.

2365API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.

2317API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks2366API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks

2318API Error: 400 ... thinking blocks ... cannot be modified2367API Error: 400 ... thinking blocks ... cannot be modified

2319```2368```

2320 2369

2321Tutte e tre le varianti significano la stessa cosa: la sequenza di blocchi `tool_use`, `tool_result` e `thinking` nella cronologia non corrisponde più a ciò che l'API si aspetta.2370Tutte le varianti significano la stessa cosa: la sequenza di blocchi `tool_use`, `tool_result` e `thinking` nella cronologia non corrisponde più a ciò che l'API si aspetta.

2322 2371

2323**Cosa fare:**2372**Cosa fare:**

2324 2373

2376API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2425API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2377```2426```

2378 2427

2379Il messaggio si collega al [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), che concede accesso per il lavoro di cibersicurezza legittimo.2428Il messaggio si collega al [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), che concede accesso per il lavoro di cibersicurezza legittimo. Su Opus 5.5, che richiede v2.1.280 o successiva, il messaggio si apre con `Opus 5.5's safeguards flagged this session` invece. Quando la categoria contrassegnata ha un modello di fallback disponibile, Claude Code [cambia modelli](/docs/it/model-config#automatic-model-fallback) piuttosto che mostrare questo errore.

2380 2429

2381Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), un contrassegno di cibersicurezza produce il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal) invece.2430Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), un contrassegno di cibersicurezza produce il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal) invece.

2382 2431

2441 Errori da riga di comando2490 Errori da riga di comando

2442</h2>2491</h2>

2443 2492

2444Questi errori provengono dal comando `claude` da riga di comando e dai suoi sottocomandi, da un nome di comando che invii al prompt, e da comandi come `/security-review` che raccolgono il contesto eseguendo comandi shell prima che il loro prompt venga eseguito. Lo stesso vale per gli errori da `/tui`, che riavvia la CLI.2493Questi errori provengono dal comando `claude` da riga di comando e dai suoi sottocomandi, da un nome di comando che invii al prompt, e da comandi come `/security-review` che raccolgono il contesto eseguendo comandi shell prima che il loro prompt venga eseguito. Provengono anche da `/tui`, che riavvia la CLI.

2445 2494

2446<h3 id="conflict-between-bg-and-print">2495<h3 id="conflict-between-bg-and-print">

2447 Conflitto tra --bg e --print2496 Conflitto tra --bg e --print

3087**Cosa fare:**3136**Cosa fare:**

3088 3137

3089* Esegui `claude --resume <session-id>` con l'ID della sessione dal messaggio per riprovare3138* Esegui `claude --resume <session-id>` con l'ID della sessione dal messaggio per riprovare

3139* Se ogni nuovo tentativo fallisce allo stesso modo, esegui `claude update` e riprendi di nuovo. Le versioni prima della v2.1.275 falliscono la ripresa quando la trascrizione salvata contiene una voce che non possono leggere.

3090* Se il nuovo tentativo fallisce di nuovo, esegui `claude` per avviare una nuova sessione3140* Se il nuovo tentativo fallisce di nuovo, esegui `claude` per avviare una nuova sessione

3091 3141

3092<h3 id="no-conversation-found-with-the-session-id">3142<h3 id="no-conversation-found-with-the-session-id">

3139 3189

3140* In una sessione avviata senza quelle restrizioni, esegui `/tui fullscreen`, o `/tui default` per cambiare di nuovo. Claude Code salva l'impostazione [`tui`](/docs/it/settings-reference#tui) lì3190* In una sessione avviata senza quelle restrizioni, esegui `/tui fullscreen`, o `/tui default` per cambiare di nuovo. Claude Code salva l'impostazione [`tui`](/docs/it/settings-reference#tui) lì

3141 3191

3192<h3 id="couldnt-open-claude-desktop">

3193 Couldn't open Claude Desktop

3194</h3>

3195

3196Hai eseguito [`/desktop`](/docs/it/desktop#coming-from-the-cli), o il suo alias `/app`, e il comando di sistema che Claude Code usa per aprire Claude Desktop ha fallito. La sessione rimane nel terminale.

3197

3198```text theme={null}

3199Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.

3200```

3201

3202**Cosa fare:**

3203

3204* Apri Claude Desktop tu stesso, quindi esegui di nuovo `/desktop`

3205* Per leggere l'output di errore completo di quel comando, attiva il debug logging con `/debug`, esegui di nuovo `/desktop`, e controlla il log di debug

3206

3207Prima della v2.1.275, il messaggio era `Failed to open Claude Desktop. Please try opening it manually.` e non diceva cosa era fallito.

3208

3142<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3209<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3143 /terminal-setup ha lasciato la tua keymap Zed invariata3210 /terminal-setup ha lasciato la tua keymap Zed invariata

3144</h3>3211</h3>

3256* Se pubblicate un marketplace di terze parti che ha utilizzato il nome prima che diventasse riservato, rinominatelo e chiedete agli utenti di aggiungerlo di nuovo dalla vostra fonte3323* Se pubblicate un marketplace di terze parti che ha utilizzato il nome prima che diventasse riservato, rinominatelo e chiedete agli utenti di aggiungerlo di nuovo dalla vostra fonte

3257* Vedere l'elenco dei nomi riservati in [Marketplace schema](/docs/it/plugin-marketplaces#marketplace-schema)3324* Vedere l'elenco dei nomi riservati in [Marketplace schema](/docs/it/plugin-marketplaces#marketplace-schema)

3258 3325

3326<h3 id="marketplace-is-already-added-from-a-different-source">

3327 Marketplace is already added from a different source

3328</h3>

3329

3330Avete confermato l'aggiunta di un marketplace tramite [`/plugin install <plugin> --marketplace <source>`](/docs/it/discover-plugins#add-a-marketplace-and-install-in-one-command), e il catalogo che Claude Code ha recuperato da quella fonte nomina se stesso con lo stesso nome di un marketplace che avete già aggiunto da una fonte diversa. Claude Code mantiene il marketplace esistente invece di sostituirlo, e il plugin non viene installato.

3331

3332```text theme={null}

3333Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

3334```

3335

3336**Cosa fare:**

3337

3338* Se il marketplace che avete già aggiunto è quello che desiderate, installate da esso per nome: `/plugin install <plugin>@<name>`

3339* Per passare alla nuova fonte, eseguite `/plugin marketplace remove <name>`, quindi riprovate l'installazione

3340

3259<h3 id="plugin-command-references-user-config">3341<h3 id="plugin-command-references-user-config">

3260 Plugin command references user\_config in a shell command3342 Plugin command references user\_config in a shell command

3261</h3>3343</h3>

3380La [voce del marketplace](/docs/it/plugin-marketplaces#plugin-entries) del plugin dichiara un percorso di origine che Claude Code non può risolvere a una posizione all'interno della directory del marketplace stesso, quindi il plugin non si installa o non si carica. Il rifiuto copre:3462La [voce del marketplace](/docs/it/plugin-marketplaces#plugin-entries) del plugin dichiara un percorso di origine che Claude Code non può risolvere a una posizione all'interno della directory del marketplace stesso, quindi il plugin non si installa o non si carica. Il rifiuto copre:

3381 3463

3382* Un percorso di voce che è assoluto, esce dal marketplace con `..`, o è scritto come un percorso di rete3464* Un percorso di voce che è assoluto, esce dal marketplace con `..`, o è scritto come un percorso di rete

3465* Su macOS e Linux, un percorso di voce che contiene una barra rovesciata in qualsiasi punto dopo il `./` iniziale

3383* Una voce in un marketplace recuperato da una fonte remota, come git o un URL, che raggiunge il suo target attraverso un symlink che si risolve al di fuori della directory del marketplace3466* Una voce in un marketplace recuperato da una fonte remota, come git o un URL, che raggiunge il suo target attraverso un symlink che si risolve al di fuori della directory del marketplace

3384* Una voce relativa in un marketplace aggiunto da un URL diretto al suo `marketplace.json`: Claude Code scarica solo quel file, quindi nessun file di plugin locale esiste per il percorso da nominare. Vedere [Plugins with relative paths fail in URL-based marketplaces](/docs/it/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)3467* Una voce relativa in un marketplace aggiunto da un URL diretto al suo `marketplace.json`: Claude Code scarica solo quel file, quindi nessun file di plugin locale esiste per il percorso da nominare. Vedere [Plugins with relative paths fail in URL-based marketplaces](/docs/it/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)

3385 3468

3397 3480

3398**Cosa fare:**3481**Cosa fare:**

3399 3482

3400* Se mantenete il marketplace, scrivete il `source` della voce come un percorso relativo semplice come `./plugins/my-plugin`, e mantenete qualsiasi symlink che attraversa puntato all'interno della directory del marketplace3483* Se mantenete il marketplace, scrivete il `source` della voce come un percorso relativo semplice con barre in avanti, come `./plugins/my-plugin`, e mantenete qualsiasi symlink che attraversa puntato all'interno della directory del marketplace

3401* Se avete aggiunto il marketplace da un URL diretto, le voci relative non possono risolversi. Chiedete all'autore del marketplace di utilizzare [un'altra fonte di plugin](/docs/it/plugin-marketplaces#plugin-sources), o aggiungete il marketplace dal suo repository git invece3484* Se avete aggiunto il marketplace da un URL diretto, le voci relative non possono risolversi. Chiedete all'autore del marketplace di utilizzare [un'altra fonte di plugin](/docs/it/plugin-marketplaces#plugin-sources), o aggiungete il marketplace dal suo repository git invece

3402 3485

3403<h3 id="failed-to-load-marketplace-configuration">3486<h3 id="failed-to-load-marketplace-configuration">

3424* Aprite `~/.claude/plugins/known_marketplaces.json` e riparate il JSON, o correggete le voci che il messaggio nomina come non corrispondenti allo schema del registro3507* Aprite `~/.claude/plugins/known_marketplaces.json` e riparate il JSON, o correggete le voci che il messaggio nomina come non corrispondenti allo schema del registro

3425* Se non potete ripararla, eliminate il file o sostituite i suoi contenuti con `{}`, quindi aggiungete di nuovo ogni marketplace con `claude plugin marketplace add <source>`. Claude Code ri-registra i marketplace che le vostre impostazioni utente o gestite dichiarano in [`extraKnownMarketplaces`](/docs/it/settings-reference#extraknownmarketplaces) la prossima volta che lo avviate in una cartella che avete considerato attendibile.3508* Se non potete ripararla, eliminate il file o sostituite i suoi contenuti con `{}`, quindi aggiungete di nuovo ogni marketplace con `claude plugin marketplace add <source>`. Claude Code ri-registra i marketplace che le vostre impostazioni utente o gestite dichiarano in [`extraKnownMarketplaces`](/docs/it/settings-reference#extraknownmarketplaces) la prossima volta che lo avviate in una cartella che avete considerato attendibile.

3426 3509

3510<h3 id="plugin-is-required-by-your-organization">

3511 Plugin is required by your organization

3512</h3>

3513

3514Avete eseguito `claude plugin disable`, o utilizzato la scheda **Installed** di `/plugin`, per disattivare un [plugin sincronizzato da claude.ai](/docs/it/plugins-reference#synced-plugins) che la vostra organizzazione contrassegna come obbligatorio:

3515

3516```text theme={null}

3517Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

3518```

3519

3520Claude Code non salva nulla e il plugin rimane abilitato.

3521

3522Quando tentate di disattivare un plugin da cui dipende un plugin obbligatorio, Claude Code rifiuta allo stesso modo, con un messaggio che nomina il plugin obbligatorio che ne ha bisogno.

3523

3524**Cosa fare:**

3525

3526* Chiedete a un amministratore della vostra organizzazione claude.ai di cambiare lo stato obbligatorio del plugin su claude.ai

3527

3427<h2 id="tool-errors">3528<h2 id="tool-errors">

3428 Errori degli strumenti3529 Errori degli strumenti

3429</h2>3530</h2>

3452 3553

3453* Correggete ogni voce che l'errore nomina rispetto agli [strumenti disponibili per i subagent](/docs/it/sub-agents#available-tools)3554* Correggete ogni voce che l'errore nomina rispetto agli [strumenti disponibili per i subagent](/docs/it/sub-agents#available-tools)

3454* Rimuovete le voci per gli strumenti che la sessione non ha, come gli strumenti MCP da un server che non è connesso3555* Rimuovete le voci per gli strumenti che la sessione non ha, come gli strumenti MCP da un server che non è connesso

3455* Per uno strumento che [i subagent in background eliminano](/docs/it/sub-agents#available-tools), come `LSP`, rimuovete la voce. Per mantenere lo strumento, [disattivate la fork mode](/docs/it/sub-agents#turn-fork-mode-on-or-off) e chiedete a Claude di eseguire il subagent in foreground3556* Per uno strumento che [i subagent in background eliminano](/docs/it/sub-agents#available-tools), come `CronCreate`, rimuovete la voce. Per mantenere lo strumento, [disattivate la fork mode](/docs/it/sub-agents#turn-fork-mode-on-or-off) e chiedete a Claude di eseguire il subagent in foreground

3456* Eliminate il campo `tools` invece di elencare gli strumenti per dare al subagent ogni [strumento disponibile per i subagent](/docs/it/sub-agents#available-tools)3557* Eliminate il campo `tools` invece di elencare gli strumenti per dare al subagent ogni [strumento disponibile per i subagent](/docs/it/sub-agents#available-tools)

3457* Per un elenco `tools` che contiene solo `Agent`, aumentate il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) o date all'agent almeno uno strumento aggiuntivo: Claude Code trattiene `Agent` a quel limite, quindi un elenco con nient'altro in esso si risolve in nessuno strumento3558* Per un elenco `tools` che contiene solo `Agent`, aumentate il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) o date all'agent almeno uno strumento aggiuntivo: Claude Code trattiene `Agent` a quel limite, quindi un elenco con nient'altro in esso si risolve in nessuno strumento

3458 3559

3812* Di solito nulla: Claude riprova con l'ortografia locale che il messaggio chiede3913* Di solito nulla: Claude riprova con l'ortografia locale che il messaggio chiede

3813* Se il file è su una condivisione di rete piuttosto che un file locale scritto con un percorso di rete, è al di fuori dell'area di lavoro locale della sessione; modificalo da una sessione interattiva regolare invece3914* Se il file è su una condivisione di rete piuttosto che un file locale scritto con un percorso di rete, è al di fuori dell'area di lavoro locale della sessione; modificalo da una sessione interattiva regolare invece

3814 3915

3916<h3 id="command-blocked-by-the-worktree-isolation-checks">

3917 Comando bloccato dai controlli di isolamento worktree

3918</h3>

3919

3920Claude ha eseguito un comando Bash o Monitor in una [sessione isolata in un worktree](/docs/it/worktrees#how-claude-code-enforces-isolation), e Claude Code l'ha rifiutato per uno di due motivi:

3921

3922* Il comando punta git al checkout principale.

3923* Claude Code non può verificare dal testo del comando che qualsiasi git che il comando esegue rimanga all'interno del worktree. Un comando che non nomina mai git può comunque essere rifiutato per questo motivo, perché espandere un'indirezione di variabile come `${!name}` o eseguire una sostituzione di funzione Bash come `${ command; }` produce un valore in fase di esecuzione che può essere esso stesso un comando.

3924

3925Il mezzo del messaggio nomina cosa non poteva essere verificato:

3926

3927```text wrap theme={null}

3928This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.

3929```

3930

3931**Cosa fare:**

3932

3933* Di solito nulla: Claude legge il messaggio e riscrive il comando nel modo che la sua frase finale chiede

3934* Se un comando che hai chiesto continua ad essere rifiutato, scrivi il valore contrassegnato letteralmente: sostituisci l'indirezione o la sostituzione con il suo valore, ed esegui git come suo proprio comando semplice dall'interno del worktree

3935* Per agire sul checkout principale di proposito, esegui il comando tu stesso in un terminale al di fuori della sessione

3936

3815<h3 id="this-session-has-no-saved-transcript">3937<h3 id="this-session-has-no-saved-transcript">

3816 Questa sessione non ha una trascrizione salvata3938 Questa sessione non ha una trascrizione salvata

3817</h3>3939</h3>

4201 4323

4202Claude Code elimina i backup di una sessione nella [retention sweep](/docs/it/claude-directory#cleaned-up-automatically), per impostazione predefinita circa 30 giorni dopo l'ultimo salvataggio della sessione. Se riprendi una sessione dopo questo periodo, `/rewind` elenca ancora i suoi checkpoint, ma il ripristino a uno di essi può fallire con questo errore. Se il messaggio dice anche `N paths were skipped for link safety`, vedi [Restored the code, but skipped files](#restored-the-code-but-skipped-files) per quei percorsi.4324Claude Code elimina i backup di una sessione nella [retention sweep](/docs/it/claude-directory#cleaned-up-automatically), per impostazione predefinita circa 30 giorni dopo l'ultimo salvataggio della sessione. Se riprendi una sessione dopo questo periodo, `/rewind` elenca ancora i suoi checkpoint, ma il ripristino a uno di essi può fallire con questo errore. Se il messaggio dice anche `N paths were skipped for link safety`, vedi [Restored the code, but skipped files](#restored-the-code-but-skipped-files) per quei percorsi.

4203 4325

4326Quando esegui il fork di una sessione, ad esempio con [`--fork-session`](/docs/it/cli-reference#cli-flags) o [`/branch`](/docs/it/sessions#branch-a-session), Claude Code copia i backup della sessione originale nel fork. Quando Claude Code non riesce a copiare un backup, ad esempio perché il disco è pieno, quel backup è mancante nel fork. Il ripristino a un checkpoint che ne ha bisogno può fallire con questo errore.

4327

4204**Cosa fare:**4328**Cosa fare:**

4205 4329

4206* Annulla le modifiche in un altro modo: chiedi a Claude di invertire le sue modifiche, o ripristina i file dal controllo versione. Quando i backup sono spariti, l'esecuzione di `/rewind` di nuovo fallisce allo stesso modo.4330* Annulla le modifiche in un altro modo: chiedi a Claude di invertire le sue modifiche, o ripristina i file dal controllo versione. Quando i backup sono spariti, l'esecuzione di `/rewind` di nuovo fallisce allo stesso modo.

4458* Se amministrate la macchina, correggere il documento nominato in modo che si analizzi come un oggetto JSON, o rimuovere il file, il profilo o il valore del registro. Un `managed-settings.json` vuoto conta come `{}` e non blocca l'avvio.4582* Se amministrate la macchina, correggere il documento nominato in modo che si analizzi come un oggetto JSON, o rimuovere il file, il profilo o il valore del registro. Un `managed-settings.json` vuoto conta come `{}` e non blocca l'avvio.

4459* Se non lo fate, chiedete al vostro amministratore di correggere il documento distribuito. Nulla nei vostri file di impostazioni causa o cancella questo errore.4583* Se non lo fate, chiedete al vostro amministratore di correggere il documento distribuito. Nulla nei vostri file di impostazioni causa o cancella questo errore.

4460 4584

4585<h3 id="otelheadershelper-failed">

4586 otelHeadersHelper non riuscito

4587</h3>

4588

4589Claude Code mostra questo avviso come una notifica nell'interfaccia terminale, una volta per sessione interattiva, quando lo script [`otelHeadersHelper`](/docs/it/settings-reference#otelheadershelper) fallisce o stampa output che non soddisfa i [requisiti dello script](/docs/it/monitoring-usage#script-requirements).

4590

4591Mentre lo script continua a fallire, le esportazioni falliscono e il vostro backend di telemetria non riceve nulla dalla sessione.

4592

4593Il testo dopo `See /status:` dice cosa è fallito, come il codice di uscita dello script seguito dal suo output di errore:

4594

4595```text theme={null}

4596otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable

4597```

4598

4599**Cosa fare:**

4600

4601* Eseguire `/status` per leggere il dettaglio del fallimento.

4602* Correggere lo script in modo che esca 0 entro 30 secondi e stampi un oggetto JSON di valori di intestazione stringa su stdout. Vedere [requisiti dello script](/docs/it/monitoring-usage#script-requirements).

4603* Se la vostra organizzazione distribuisce lo script attraverso [impostazioni gestite](/docs/it/managed-settings), chiedete a chi le mantiene di correggerlo.

4604

4605In [modalità non interattiva](/docs/it/headless) con `-p`, lo stesso fallimento appare su stderr come `otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error>` invece.

4606

4461<h3 id="headershelper-not-run">4607<h3 id="headershelper-not-run">

4462 headersHelper non eseguito4608 headersHelper non eseguito

4463</h3>4609</h3>

4652 4798

4653* Un [`--fallback-model`](/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione4799* Un [`--fallback-model`](/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione

4654* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile4800* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile

4655* Il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) su Fable 5.1, Fable 5 e Opus 5 sposta la sessione al modello di fallback della categoria contrassegnata, quando quella categoria ne ha uno, e mostra un avviso nella trascrizione4801* Il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) su Fable 5.1, Fable 5, Opus 5.5 e Opus 5 sposta la sessione al modello di fallback della categoria contrassegnata, quando quella categoria ne ha uno, e mostra un avviso nella trascrizione

4656 4802

4657Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio `/model`. La [configurazione del modello](/docs/it/model-config) spiega quando si applica ogni fallback.4803Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio `/model`. La [configurazione del modello](/docs/it/model-config) spiega quando si applica ogni fallback.

4658 4804

fast-mode.md +12 −7

Details

12 12

13La modalità veloce è una configurazione ad alta velocità per Claude Opus, che rende il modello fino a 2,5 volte più veloce a un costo per token più elevato. Attivala con `/fast` quando hai bisogno di velocità per il lavoro interattivo come l'iterazione rapida o il debug in tempo reale, e disattivala quando il costo è più importante della latenza.13La modalità veloce è una configurazione ad alta velocità per Claude Opus, che rende il modello fino a 2,5 volte più veloce a un costo per token più elevato. Attivala con `/fast` quando hai bisogno di velocità per il lavoro interattivo come l'iterazione rapida o il debug in tempo reale, e disattivala quando il costo è più importante della latenza.

14 14

15La modalità veloce non è un modello diverso. Utilizza Claude Opus con una configurazione API diversa che dà priorità alla velocità rispetto all'efficienza dei costi. Ottieni la stessa qualità e capacità con risposte più veloci. La modalità veloce è supportata su Opus 5 e Opus 4.8. Non è disponibile su Sonnet, Haiku o altri modelli.15La modalità veloce non è un modello diverso. Utilizza Claude Opus con una configurazione API diversa che dà priorità alla velocità rispetto all'efficienza dei costi. Ottieni la stessa qualità e capacità con risposte più veloci. La modalità veloce è supportata su Opus 5.5, Opus 5 e Opus 4.8. Non è disponibile su Sonnet, Haiku o altri modelli.

16 16

17Claude Code tratta Opus 4.7 come qualsiasi altro modello senza supporto della modalità veloce: il passaggio ad esso disattiva la modalità veloce. La modalità veloce per Opus 4.7 è stata deprecata il 25 giugno 2026 e rimossa il 24 luglio 2026.17Opus 4.7 non supporta la modalità veloce, quindi il passaggio ad esso disattiva la modalità veloce. La modalità veloce per Opus 4.7 è stata deprecata il 25 giugno 2026 e rimossa il 24 luglio 2026.

18 18

19Cosa sapere:19Cosa sapere:

20 20

21* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. L'estensione VS Code segue la tua impostazione [`fastMode`](#toggle-fast-mode) e offre un comando **Toggle fast mode** quando il modello selezionato supporta la modalità veloce.21* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. L'[estensione VS Code](/docs/it/vs-code) offre un comando **Toggle fast mode** quando il modello selezionato supporta la modalità veloce. Claude Code salva tale attivazione/disattivazione nella tua impostazione [`fastMode`](#toggle-fast-mode).

~~22* I prezzi della modalità veloce per MTok input/output sono \$10/\$50 su Opus 5 e Opus 4.8.~~22* I prezzi della modalità veloce per MTok input/output sono \$8/\$40 su Opus 5.5 e \$10/\$50 su Opus 5 e Opus 4.8.

23* Disponibile per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise) e su Claude Console. Le organizzazioni Team ed Enterprise hanno bisogno che un Owner lo abiliti per primo, e le organizzazioni Console hanno bisogno che l'accesso sia fornito per primo, entrambi descritti in [Requisiti](#requirements).23* Disponibile per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise) e su Claude Console. Le organizzazioni Team ed Enterprise hanno bisogno che un Owner lo abiliti per primo, e le organizzazioni Console hanno bisogno che l'accesso sia fornito per primo, entrambi descritti in [Requisiti](#requirements).

24* Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise), la modalità veloce è disponibile solo tramite crediti di utilizzo e non è inclusa nei limiti di velocità dell'abbonamento.24* Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise), la modalità veloce è disponibile solo tramite crediti di utilizzo e non è inclusa nei limiti di velocità dell'abbonamento.

25 25

29 29

30Attiva/disattiva la modalità veloce in uno di questi modi:30Attiva/disattiva la modalità veloce in uno di questi modi:

31 31

~~32* Digita `/fast` e premi Tab per attivare o disattivare~~32* Esegui `/fast`, premi Spazio per attivare o disattivare, quindi premi Invio per confermare

33* Imposta `"fastMode": true` nel tuo [file di impostazioni utente](/docs/it/settings)33* Imposta `"fastMode": true` nel tuo [file di impostazioni utente](/docs/it/settings)

34 34

35Per impostazione predefinita, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni. Puoi configurare la modalità veloce per ripristinarsi ogni sessione. Vedi [richiedi opt-in per sessione](#require-per-session-opt-in) per i dettagli.35Per impostazione predefinita, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni. Puoi configurare la modalità veloce per ripristinarsi ogni sessione. Vedi [richiedi opt-in per sessione](#require-per-session-opt-in) per i dettagli.

47* Un piccolo icona `↯` appare accanto al prompt mentre la modalità veloce è attiva47* Un piccolo icona `↯` appare accanto al prompt mentre la modalità veloce è attiva

48* Esegui `/fast` di nuovo in qualsiasi momento per verificare se la modalità veloce è attiva o disattiva48* Esegui `/fast` di nuovo in qualsiasi momento per verificare se la modalità veloce è attiva o disattiva

49 49

50Opus 5 è il valore predefinito della modalità veloce in Claude Code v2.1.219 e successivo. Prima di v2.1.219, la modalità veloce predefinita era Opus 4.8 su v2.1.154 fino a v2.1.218, e Opus 4.7 su v2.1.142 fino a v2.1.153.50Opus 5.5 è il valore predefinito della modalità veloce in Claude Code v2.1.280 e successivo. Prima di v2.1.280, la modalità veloce predefinita era Opus 5 da v2.1.219, a Opus 4.8 su v2.1.154 fino a v2.1.218, e a Opus 4.7 su v2.1.142 fino a v2.1.153.

51 51

52Quando disabiliti la modalità veloce con `/fast` di nuovo, rimani su Opus. Per passare a un modello diverso, usa `/model`.52Quando disabiliti la modalità veloce con `/fast` di nuovo, rimani su Opus. Per passare a un modello diverso, usa `/model`.

53 53

80 80

82| -------- | ------------ | ------------- |82| -------- | ------------ | ------------- |

83| Opus 5.5 | \$8 | \$40 |

83| Opus 5 | \$10 | \$50 |84| Opus 5 | \$10 | \$50 |

84| Opus 4.8 | \$10 | \$50 |85| Opus 4.8 | \$10 | \$50 |

85 86

145* **Abilitazione del proprietario per Team e Enterprise**: la modalità veloce è disabilitata per impostazione predefinita per le organizzazioni Team e Enterprise. Un proprietario deve esplicitamente [abilitare la modalità veloce](#enable-fast-mode-for-your-organization) prima che gli utenti possano accedervi.146* **Abilitazione del proprietario per Team e Enterprise**: la modalità veloce è disabilitata per impostazione predefinita per le organizzazioni Team e Enterprise. Un proprietario deve esplicitamente [abilitare la modalità veloce](#enable-fast-mode-for-your-organization) prima che gli utenti possano accedervi.

146 147

147<Note>148<Note>

148 Due impostazioni organizzative possono bloccare l'attivazione della modalità veloce con `/fast`:149 Quattro impostazioni organizzative possono bloccare l'attivazione della modalità veloce con `/fast`:

149 150

150 * **Modalità veloce non abilitata**: se la modalità veloce non è stata abilitata per la tua organizzazione, l'attivazione della modalità veloce con `/fast` mostra "Fast mode has been disabled by your organization."151 * **Modalità veloce non abilitata**: se la modalità veloce non è stata abilitata per la tua organizzazione, l'attivazione della modalità veloce con `/fast` mostra "Fast mode has been disabled by your organization."

152 * **Modalità veloce disattivata dalle impostazioni gestite**: se la tua organizzazione distribuisce [impostazioni gestite](/docs/it/managed-settings) che impostano [`fastMode: false`](/docs/it/settings-reference#fastmode), l'attivazione della modalità veloce con `/fast` mostra lo stesso messaggio "Fast mode has been disabled by your organization".

153 * **Opt-in per sessione richiesto**: le impostazioni gestite che impostano [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) rifiutano `/fast on` con lo stesso messaggio ovunque tranne in una sessione di terminale interattiva.

151 * **Modello modalità veloce non consentito**: se l'elenco di consentiti [`availableModels`](/docs/it/model-config#restrict-model-selection) della tua organizzazione esclude il modello Opus della modalità veloce, l'attivazione viene rifiutata con "is not in your organization's allowed models". In una sessione già in esecuzione su un modello Opus consentito che supporta la modalità veloce, `/fast` abilita invece la modalità veloce sul tuo modello attuale senza cambiare modelli.154 * **Modello modalità veloce non consentito**: se l'elenco di consentiti [`availableModels`](/docs/it/model-config#restrict-model-selection) della tua organizzazione esclude il modello Opus della modalità veloce, l'attivazione viene rifiutata con "is not in your organization's allowed models". In una sessione già in esecuzione su un modello Opus consentito che supporta la modalità veloce, `/fast` abilita invece la modalità veloce sul tuo modello attuale senza cambiare modelli.

152</Note>155</Note>

153 156

204 207

205Questo è utile per controllare i costi nelle organizzazioni in cui gli utenti eseguono più sessioni simultanee. La preferenza della modalità veloce dell'utente è ancora salvata, quindi rimuovere questa impostazione ripristina il comportamento persistente predefinito.208Questo è utile per controllare i costi nelle organizzazioni in cui gli utenti eseguono più sessioni simultanee. La preferenza della modalità veloce dell'utente è ancora salvata, quindi rimuovere questa impostazione ripristina il comportamento persistente predefinito.

206 209

210Quando le impostazioni gestite impostano la chiave, `/fast on` funziona solo in una sessione di terminale interattiva. Ovunque altro, inclusa la [modalità non interattiva](/docs/it/headless), l'[estensione VS Code](/docs/it/vs-code) e le [sessioni cloud](#use-fast-mode-in-cloud-sessions), viene rifiutato con un messaggio che la tua organizzazione ha disabilitato la modalità veloce.

211

207<h2 id="handle-rate-limits">212<h2 id="handle-rate-limits">

208 Gestisci i limiti di velocità213 Gestisci i limiti di velocità

209</h2>214</h2>

features-overview.md +25 −5

Details

21Le estensioni si collegano a diverse parti del ciclo agentico:21Le estensioni si collegano a diverse parti del ciclo agentico:

22 22

23* **[CLAUDE.md](/docs/it/memory)** aggiunge contesto persistente che Claude vede in ogni sessione23* **[CLAUDE.md](/docs/it/memory)** aggiunge contesto persistente che Claude vede in ogni sessione

24* **[Output styles](/docs/it/output-styles)** impostano il ruolo, il tono e il formato di risposta di Claude per ogni risposta in una sessione

24* **[Skills](/docs/it/skills)** aggiungono conoscenze riutilizzabili e flussi di lavoro invocabili25* **[Skills](/docs/it/skills)** aggiungono conoscenze riutilizzabili e flussi di lavoro invocabili

25* **[Code intelligence](/docs/it/tools-reference#lsp-tool-behavior)** collega Claude a un language server per la navigazione a livello di simbolo e gli errori di tipo in tempo reale26* **[Code intelligence](/docs/it/tools-reference#lsp-tool-behavior)** collega Claude a un language server per la navigazione a livello di simbolo e gli errori di tipo in tempo reale

26* **[MCP](/docs/it/mcp)** collega Claude a servizi e strumenti esterni27* **[MCP](/docs/it/mcp)** collega Claude a servizi e strumenti esterni

39Le funzionalità vanno dal contesto sempre attivo che Claude vede in ogni sessione, alle capacità su richiesta che voi o Claude potete invocare, all'automazione in background che viene eseguita su eventi specifici. La tabella seguente mostra ciò che è disponibile e quando ogni funzionalità ha senso.40Le funzionalità vanno dal contesto sempre attivo che Claude vede in ogni sessione, alle capacità su richiesta che voi o Claude potete invocare, all'automazione in background che viene eseguita su eventi specifici. La tabella seguente mostra ciò che è disponibile e quando ogni funzionalità ha senso.

40 41

42| -------------------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |43| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |

45| **[Output style](/docs/it/output-styles)** | Istruzioni che impostano il ruolo, il tono e il formato di risposta di Claude per un'intera sessione | Una voce, una lunghezza o un formato che desiderate in ogni risposta, o Claude che lavora come qualcosa di diverso da un ingegnere del software | Lo stile Concise integrato per risposte più brevi; uno stile personalizzato che risponde a ogni domanda con un diagramma per primo |

44| **Skill** | Istruzioni, conoscenze e flussi di lavoro che Claude può utilizzare | Contenuto riutilizzabile, documenti di riferimento, compiti ripetibili | `/deploy` esegue la vostra checklist di distribuzione; skill di documentazione API con pattern di endpoint |46| **Skill** | Istruzioni, conoscenze e flussi di lavoro che Claude può utilizzare | Contenuto riutilizzabile, documenti di riferimento, compiti ripetibili | `/deploy` esegue la vostra checklist di distribuzione; skill di documentazione API con pattern di endpoint |

46| **[Dynamic workflow](/docs/it/workflows)** | Script che Claude scrive che esegue molti subagents in background | Lavoro che cresce oltre una manciata di subagents, o risultati che desiderate siano verificati incrociati | Controllare un'intera codebase, con una seconda serie di agenti che verificano ogni risultato |48| **[Dynamic workflow](/docs/it/workflows)** | Script che Claude scrive che esegue molti subagents in background | Lavoro che cresce oltre una manciata di subagents, o risultati che desiderate siano verificati incrociati | Controllare un'intera codebase, con una seconda serie di agenti che verificano ogni risultato |

59Non è necessario configurare tutto in anticipo. Ogni funzionalità ha un trigger riconoscibile, e la maggior parte dei team le aggiunge approssimativamente in questo ordine:61Non è necessario configurare tutto in anticipo. Ogni funzionalità ha un trigger riconoscibile, e la maggior parte dei team le aggiunge approssimativamente in questo ordine:

60 62

61| Trigger | Aggiungete |63| Trigger | Aggiungete |

62| :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |64| :---------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |

63| Claude sbaglia una convenzione o un comando due volte | Aggiungetelo a [CLAUDE.md](/docs/it/memory) |65| Claude sbaglia una convenzione o un comando due volte | Aggiungetelo a [CLAUDE.md](/docs/it/memory) |

66| Continuate a chiedere a Claude di essere più breve, spiegare di più o rispondere nello stesso formato | Impostate uno [stile di output](/docs/it/output-styles) |

64| Continuate a digitare lo stesso prompt per avviare un compito | Salvatelo come [skill](/docs/it/skills) invocabile dall'utente |67| Continuate a digitare lo stesso prompt per avviare un compito | Salvatelo come [skill](/docs/it/skills) invocabile dall'utente |

65| Incollate lo stesso playbook o procedura multi-step in chat per la terza volta | Catturatelo come [skill](/docs/it/skills) |68| Incollate lo stesso playbook o procedura multi-step in chat per la terza volta | Catturatelo come [skill](/docs/it/skills) |

66| Continuate a copiare dati da una scheda del browser che Claude non può vedere | Collegate quel sistema come [server MCP](/docs/it/mcp) |69| Continuate a copiare dati da una scheda del browser che Claude non può vedere | Collegate quel sistema come [server MCP](/docs/it/mcp) |

112 115

113 **Mettetelo in una skill** se è materiale di riferimento di cui Claude ha bisogno a volte (documentazione API, guide di stile) o un flusso di lavoro che attivate con `/<name>` (deploy, review, release).116 **Mettetelo in una skill** se è materiale di riferimento di cui Claude ha bisogno a volte (documentazione API, guide di stile) o un flusso di lavoro che attivate con `/<name>` (deploy, review, release).

114 117

115 **Regola pratica:** Mantenete CLAUDE.md sotto 200 righe. Se sta crescendo, spostate il contenuto di riferimento in skills o dividetelo in file [`.claude/rules/`](/docs/it/memory#organize-rules-with-claude%2Frules%2F).118 **Regola pratica:** Mantenete CLAUDE.md sotto 200 righe. Se sta crescendo, spostate il contenuto di riferimento in skills o dividetelo in file [`.claude/rules/`](/docs/it/memory#organize-rules-with-claude/rules/).

119 </Tab>

120

121 <Tab title="CLAUDE.md vs Output style">

122 Entrambi danno a Claude istruzioni permanenti. CLAUDE.md contiene ciò che Claude dovrebbe sapere, e uno stile di output imposta come Claude risponde.

123

124 | Aspetto | CLAUDE.md | Output style |

125 | ---------------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |

126 | **Contiene** | Fatti e regole sul vostro progetto | Un ruolo, un tono e un formato di risposta |

127 | **Cambio** | Sempre caricato | Uno attivo alla volta; [cambiate stili](/docs/it/output-styles#change-your-output-style) quando desiderate |

128 | **Migliore per** | Comandi di build, convenzioni, regole "non fare mai X" | Risposte più brevi, spiegazioni insieme al codice, un ruolo non ingegneristico |

129

130 **Mettetelo in CLAUDE.md** se è vero del progetto qualunque stile siate in: convenzioni di codifica, comandi di build, struttura del progetto.

131

132 **Utilizzate uno stile di output** se riguarda la risposta stessa e potreste volerlo disattivare di nuovo: lunghezza, formato, quanto Claude spiega, o un ruolo diverso come un assistente di scrittura. Claude Code include [stili integrati](/docs/it/output-styles#built-in-output-styles), e potete scrivere i vostri.

133

134 **Si combinano.** CLAUDE.md rimane caricato qualunque stile scegliate. Claude segue entrambi come istruzioni, quindi nessuno è forzato. Per qualsiasi cosa che deve accadere ogni volta, utilizzate un [hook](/docs/it/hooks-guide).

116 </Tab>135 </Tab>

117 136

118 <Tab title="CLAUDE.md vs Rules vs Skills">137 <Tab title="CLAUDE.md vs Rules vs Skills">

187 206

188Le funzionalità possono essere definite a più livelli: a livello di utente, per progetto, tramite plugins o tramite politiche gestite. Potete anche annidare file CLAUDE.md in sottodirectory o posizionare skills in pacchetti specifici di un monorepo. Quando la stessa funzionalità esiste a più livelli, ecco come si stratificano:207Le funzionalità possono essere definite a più livelli: a livello di utente, per progetto, tramite plugins o tramite politiche gestite. Potete anche annidare file CLAUDE.md in sottodirectory o posizionare skills in pacchetti specifici di un monorepo. Quando la stessa funzionalità esiste a più livelli, ecco come si stratificano:

189 208

190* **I file CLAUDE.md** sono additivi: tutti i livelli contribuiscono contenuti al contesto di Claude simultaneamente. I file dalla vostra directory di lavoro e sopra si caricano all'avvio; le sottodirectory si caricano mentre lavorate in esse. Quando le istruzioni entrano in conflitto, Claude usa il giudizio per riconciliarle, con istruzioni più specifiche che tipicamente hanno la precedenza. Consultate [come i file CLAUDE.md si caricano](/docs/it/memory#how-claude-md-files-load).209* **I file CLAUDE.md** sono additivi: tutti i livelli contribuiscono contenuti al contesto di Claude simultaneamente. I file dalla vostra directory di lavoro e sopra si caricano all'avvio; le sottodirectory si caricano mentre lavorate in esse. Quando le istruzioni entrano in conflitto, Claude usa il giudizio per riconciliarle. Consultate [come i file CLAUDE.md si caricano](/docs/it/memory#how-claude-md-files-load).

191* **Skills e subagents** si sovrascrivono per nome: quando lo stesso nome esiste a più livelli, una definizione vince in base alla priorità (gestito > utente > progetto per skills; gestito > flag CLI > progetto > utente > plugin per subagents). Le skills dei plugin sono [con spazio dei nomi](/docs/it/plugins#add-skills-to-your-plugin) per evitare conflitti. Consultate [scoperta delle skills](/docs/it/skills#resolve-skills-that-share-a-name) e [ambito del subagent](/docs/it/sub-agents#choose-the-subagent-scope).210* **Skills e subagents** si sovrascrivono per nome: quando lo stesso nome esiste a più livelli, una definizione vince in base alla priorità (gestito > utente > progetto per skills; gestito > flag CLI > progetto > utente > plugin per subagents). Le skills dei plugin sono [con spazio dei nomi](/docs/it/plugins#add-skills-to-your-plugin) per evitare conflitti. Consultate [scoperta delle skills](/docs/it/skills#resolve-skills-that-share-a-name) e [ambito del subagent](/docs/it/sub-agents#choose-the-subagent-scope).

192* **I server MCP** si sovrascrivono per nome: locale > progetto > utente. Consultate [ambito MCP](/docs/it/mcp#scope-hierarchy-and-precedence).211* **I server MCP** si sovrascrivono per nome: locale > progetto > utente. Consultate [ambito MCP](/docs/it/mcp#scope-hierarchy-and-precedence).

193* **Hooks** si uniscono: tutti gli hooks registrati si attivano per i loro eventi corrispondenti indipendentemente dalla fonte. Consultate [hooks](/docs/it/hooks-guide).212* **Hooks** si uniscono: tutti gli hooks registrati si attivano per i loro eventi corrispondenti indipendentemente dalla fonte. Consultate [hooks](/docs/it/hooks-guide).

220Ogni funzionalità ha una strategia di caricamento e un costo di contesto diversi:239Ogni funzionalità ha una strategia di caricamento e un costo di contesto diversi:

221 240

223| --------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |242| --------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |

fullscreen.md +2 −2

Details

234 234

235Eseguire `/clear` per avviare una nuova conversazione.235Eseguire `/clear` per avviare una nuova conversazione.

236 236

237Per cancellare lo schermo e mantenere la conversazione, premere `Ctrl+L`. I messaggi precedenti scorrono fuori dalla vista e potete scorrere indietro con `PgUp` o la rotella del mouse per leggerli di nuovo. Prima della v2.1.260, `Ctrl+L` ridisegnava lo schermo senza cancellarlo. Prima della v2.1.238, premendolo due volte entro due secondi eseguiva `/clear`.237Se la visualizzazione appare distorta o parzialmente vuota, premere `Ctrl+L` per ridisegnare lo schermo. Il ridisegno mantiene la conversazione e il vostro input al loro posto.

238 238

239`Cmd+K` fa lo stesso di `Ctrl+L` quando il vostro terminale lo passa a Claude Code. iTerm2 e Terminal.app gestiscono `Cmd+K` da soli e Claude Code ridisegna la conversazione invece di cancellarla, quindi premete `Ctrl+L` su quei terminali.239`Cmd+K` fa lo stesso di `Ctrl+L` quando il vostro terminale lo passa a Claude Code. iTerm2 e Terminal.app gestiscono `Cmd+K` da soli e cancellano il loro schermo, e Claude Code rileva lo schermo cancellato e ridipinge la conversazione. Prima della v2.1.280, a partire dalla v2.1.260, premendo `Ctrl+L` o `Cmd+K` dove raggiunge Claude Code, cancellava lo schermo nel rendering a schermo intero. Prima della v2.1.238, premendo `Ctrl+L` due volte entro due secondi eseguiva `/clear`.

240 240

241<h2 id="use-with-tmux">241<h2 id="use-with-tmux">

242 Utilizzo con tmux242 Utilizzo con tmux

github-actions.md +1 −1

Details

300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

301 prompt: "Generate a summary of yesterday's commits and open issues"301 prompt: "Generate a summary of yesterday's commits and open issues"

302 claude_args: |302 claude_args: |

303 --model claude-opus-4-8303 --model claude-opus-5-5

304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

305```305```

306 306

glossary.md +12 −0

Details

208 208

209Scopri di più: [Use extended thinking](/docs/it/model-config#extended-thinking)209Scopri di più: [Use extended thinking](/docs/it/model-config#extended-thinking)

210 210

211<h2 id="f">

212 F

213</h2>

214

215<h3 id="frontmatter">

216 Frontmatter

217</h3>

218

219Un blocco di impostazioni YAML all'inizio di un file Markdown, tra una riga di apertura `---` e una riga di chiusura `---`. Skills, subagent, stili di output e regole leggono ciascuno la loro configurazione dal frontmatter, come la `description` di uno skill o i `tools` di un subagent, e trattano tutto ciò che viene dopo il `---` di chiusura come le istruzioni. Il `---` di apertura deve essere la prima riga del file. Ogni tipo di file accetta il proprio set di campi.

220

221Scopri di più: [Skill frontmatter](/docs/it/skills#frontmatter-reference), [Subagent frontmatter](/docs/it/sub-agents#supported-frontmatter-fields), [Output style frontmatter](/docs/it/output-styles#frontmatter), [Rule frontmatter](/docs/it/memory#rules-frontmatter-reference)

222

211<h2 id="h">223<h2 id="h">

212 H224 H

213</h2>225</h2>

google-vertex-ai.md +3 −3

Details

238 238

239Imposta queste variabili di ambiente su ID modello Google Cloud's Agent Platform specifici.239Imposta queste variabili di ambiente su ID modello Google Cloud's Agent Platform specifici.

240 240

241Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Google Cloud's Agent Platform si risolve in Opus 5, e senza `ANTHROPIC_DEFAULT_SONNET_MODEL`, l'alias `sonnet` si risolve in Sonnet 4.5. Questo esempio fissa ogni alias a una versione specifica:241Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Google Cloud's Agent Platform si risolve in Opus 5.5, e senza `ANTHROPIC_DEFAULT_SONNET_MODEL`, l'alias `sonnet` si risolve in Sonnet 4.5. Questo esempio fissa ogni alias a una versione specifica:

242 242

243```bash theme={null}243```bash theme={null}

244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'

252 252

253| Tipo di modello | Valore predefinito |253| Tipo di modello | Valore predefinito |

254| :--------------------- | :--------------------------- |254| :--------------------- | :--------------------------- |

257 257

258Le attività in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Google Cloud's Agent Platform, Claude Code utilizza il modello Sonnet predefinito per le attività in background perché Haiku potrebbe non essere abilitato in ogni progetto o regione. Due selezioni cambiano quale modello le esegue:258Le attività in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Google Cloud's Agent Platform, Claude Code utilizza il modello Sonnet predefinito per le attività in background perché Haiku potrebbe non essere abilitato in ogni progetto o regione. Due selezioni cambiano quale modello le esegue:

264 I modelli Opus hanno un prezzo per token più elevato rispetto ai modelli Sonnet, quindi una distribuzione che non fissa un modello primario viene fatturata alla tariffa Opus una volta che si aggiorna a v2.1.207 o successiva. Per mantenere Sonnet 4.5 come modello primario, imposta `ANTHROPIC_MODEL` al suo ID modello completo. Una distribuzione che indirizza il valore predefinito con `ANTHROPIC_DEFAULT_SONNET_MODEL` e non imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` mantiene il suo modello Sonnet indirizzato come predefinito.264 I modelli Opus hanno un prezzo per token più elevato rispetto ai modelli Sonnet, quindi una distribuzione che non fissa un modello primario viene fatturata alla tariffa Opus una volta che si aggiorna a v2.1.207 o successiva. Per mantenere Sonnet 4.5 come modello primario, imposta `ANTHROPIC_MODEL` al suo ID modello completo. Una distribuzione che indirizza il valore predefinito con `ANTHROPIC_DEFAULT_SONNET_MODEL` e non imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` mantiene il suo modello Sonnet indirizzato come predefinito.

265</Warning>265</Warning>

266 266

267Su v2.1.207 attraverso v2.1.218, il modello primario su Google Cloud's Agent Platform era predefinito a Opus 4.8 e l'alias `opus` si risolveva in Opus 4.8. Prima della v2.1.207, il modello primario era predefinito a Sonnet 4.5, l'alias `opus` si risolveva in Opus 4.6, e le attività in background utilizzavano sempre il modello primario.267Prima della v2.1.280, il modello primario su Google Cloud's Agent Platform era predefinito a Opus 5 e l'alias `opus` si risolveva in Opus 5 da v2.1.219. Su v2.1.207 attraverso v2.1.218, il modello primario su Google Cloud's Agent Platform era predefinito a Opus 4.8 e l'alias `opus` si risolveva in Opus 4.8. Prima della v2.1.207, il modello primario era predefinito a Sonnet 4.5, l'alias `opus` si risolveva in Opus 4.6, e le attività in background utilizzavano sempre il modello primario.

268 268

269Per personalizzare ulteriormente i modelli:269Per personalizzare ulteriormente i modelli:

270 270

headless.md +2 −2

Details

109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

110```110```

111 111

112Con `--output-format json`, il payload della risposta include `total_cost_usd` e una suddivisione dei costi per modello, quindi i chiamanti con script possono tracciare la spesa per invocazione senza consultare il [dashboard di utilizzo](/docs/it/costs). Entrambe le cifre sono [stime lato client](/docs/it/agent-sdk/cost-tracking) e possono differire dalla tua fattura effettiva.112Con `--output-format json`, il payload della risposta include `total_cost_usd` e una suddivisione dei costi per modello, quindi i chiamanti con script possono tracciare la spesa senza consultare il [dashboard di utilizzo](/docs/it/costs). Quando continui una conversazione precedente con `--continue` o `--resume`, l'esecuzione segnala il totale complessivo della conversazione, [la spesa delle esecuzioni precedenti inclusa](/docs/it/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Entrambe le cifre sono [stime lato client](/docs/it/agent-sdk/cost-tracking) e possono differire dalla tua fattura effettiva.

113 113

114<Note>114<Note>

115 Stdin inviato tramite pipe è limitato a 10MB. Se superi il limite, Claude Code esce con un errore chiaro e uno stato diverso da zero. Per lavorare con input più grandi, scrivi il contenuto in un file e fai riferimento al percorso del file nel tuo prompt invece di inviarlo tramite pipe.115 Stdin inviato tramite pipe è limitato a 10MB. Se superi il limite, Claude Code esce con un errore chiaro e uno stato diverso da zero. Per lavorare con input più grandi, scrivi il contenuto in un file e fai riferimento al percorso del file nel tuo prompt invece di inviarlo tramite pipe.

212* **Per impostazione predefinita**: i blocchi `tool_use` e `tool_result` del subagent.212* **Per impostazione predefinita**: i blocchi `tool_use` e `tool_result` del subagent.

213* **Con [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags) o [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/it/env-vars)**: anche i blocchi di testo e thinking del subagent, in modo da poter ricostruire la trascrizione di ogni subagent. Questo richiede Claude Code v2.1.211 o successivo.213* **Con [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags) o [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/it/env-vars)**: anche i blocchi di testo e thinking del subagent, in modo da poter ricostruire la trascrizione di ogni subagent. Questo richiede Claude Code v2.1.211 o successivo.

214 214

215Quando abiliti una delle due opzioni, Claude Code inoltra i messaggi dai [subagent a ogni profondità di annidamento](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents): quando un subagent genera il suo subagent, i messaggi del subagent annidato portano l'ID della chiamata dello strumento Agent che lo ha generato in `parent_tool_use_id`, in modo da poter ricostruire l'albero di annidamento completo seguendo quegli ID. Prima della v2.1.219, i messaggi dai subagent annidati non apparivano nel flusso.215Quando abiliti una delle due opzioni, Claude Code inoltra i messaggi dai [subagent a ogni profondità di annidamento](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents), indipendentemente dal fatto che ogni subagent sia stato generato con lo strumento Agent o avviato come una [skill biforcata](/docs/it/skills#run-skills-in-a-subagent). I messaggi dei subagent che una skill biforcata genera, e delle skill biforcate avviate all'interno di un subagent o di un'altra skill biforcata, richiedono Claude Code v2.1.275 o successivo. In `parent_tool_use_id`, i messaggi del subagent annidato portano l'ID della chiamata dello strumento Agent o Skill che lo ha avviato, in modo da poter ricostruire l'albero di annidamento completo seguendo quegli ID. Prima della v2.1.219, i messaggi dai subagent annidati non apparivano nel flusso.

216 216

217Le skills che [vengono eseguite in un subagent](/docs/it/skills#run-skills-in-a-subagent) appaiono nel flusso allo stesso modo: il primo messaggio della skill biforcata è un messaggio `user` che contiene il contenuto della skill che guida l'esecuzione. Se abiliti una delle due opzioni, il flusso contiene anche i blocchi di testo e thinking della skill biforcata. Prima della v2.1.265, solo i blocchi `tool_use` e `tool_result` della skill biforcata apparivano nel flusso.217Le skills che [vengono eseguite in un subagent](/docs/it/skills#run-skills-in-a-subagent) appaiono nel flusso allo stesso modo: il primo messaggio della skill biforcata è un messaggio `user` che contiene il contenuto della skill che guida l'esecuzione. Se abiliti una delle due opzioni, il flusso contiene anche i blocchi di testo e thinking della skill biforcata. Prima della v2.1.265, solo i blocchi `tool_use` e `tool_result` della skill biforcata apparivano nel flusso.

218 218

hooks.md +161 −156

Details

242 242

243Gli hook sono definiti in file di impostazioni JSON. La configurazione ha tre livelli di annidamento:243Gli hook sono definiti in file di impostazioni JSON. La configurazione ha tre livelli di annidamento:

244 244

2451. Scegliere un [hook event](#hook-events) a cui rispondere, come `PreToolUse` o `Stop`2451. Scegli un [evento hook](#hook-events) a cui rispondere, come `PreToolUse` o `Stop`

2462. Aggiungere un [matcher group](#matcher-patterns) per filtrare quando si attiva, come "solo per lo strumento Bash"2462. Aggiungi un [gruppo matcher](#matcher-patterns) per filtrare quando si attiva, come "solo per lo strumento Bash"

2473. Definire uno o più [hook handlers](#hook-handler-fields) da eseguire quando corrisponde2473. Definisci uno o più [handler hook](#hook-handler-fields) da eseguire quando corrisponde

248 248

249Consultare [Come si risolve un hook](#how-a-hook-resolves) sopra per una procedura dettagliata completa con un esempio annotato.249Vedi [Come si risolve un hook](#how-a-hook-resolves) sopra per una procedura dettagliata completa con un esempio annotato.

250 250

251<Note>251<Note>

252 Questa pagina utilizza termini specifici per ogni livello: **hook event** per il punto del ciclo di vita, **matcher group** per il filtro e **hook handler** per il comando shell, endpoint HTTP, strumento MCP, prompt o agente che viene eseguito. "Hook" da solo si riferisce alla funzionalità generale.252 Questa pagina utilizza termini specifici per ogni livello: **hook event** per il punto del ciclo di vita, **matcher group** per il filtro, e **hook handler** per il comando shell, endpoint HTTP, strumento MCP, prompt, o agente che viene eseguito. "Hook" da solo si riferisce alla funzione generale.

253</Note>253</Note>

254 254

255<h3 id="hook-locations">255<h3 id="hook-locations">

256 Posizioni dei hook256 Posizioni degli hook

257</h3>257</h3>

258 258

259Il luogo in cui si definisce un hook determina il suo ambito:259Il luogo in cui definisci un hook determina il suo ambito:

260 260

262| :--------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------- |262| :--------------------------------------- | :-------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------- |

268| [Skill](/docs/it/skills) frontmatter | Il resto della sessione una volta che la skill viene invocata. Consultare [Hooks in skills and agents](#hooks-in-skills-and-agents) | Sì, definito nel file della skill |268| [Skill](/docs/it/skills) frontmatter | Il resto della sessione una volta che lo skill è invocato. Vedi [Hook in skill e agenti](#hooks-in-skills-and-agents) | Sì, definito nel file dello skill |

270 270

271Le sessioni cloud su [Claude Code on the web](/docs/it/claude-code-on-the-web) non leggono il file locale `~/.claude/settings.json`; gli hook lì provengono dal repository, il che significa il suo `.claude/settings.json` in una sessione con un repository e i plugin che dichiara in qualsiasi sessione, e dalle impostazioni gestite dal server della vostra organizzazione. In un [ambiente self-hosted](/docs/it/self-hosted-environments-configuration#permissions-and-tool-approval), Claude Code esegue anche gli hook che l'operatore ha seminato da `~/.claude/` dell'host runner, ed esegue gli hook nel file di impostazioni gestite dell'immagine runner quando quel file è tra le [fonti gestite che Claude Code applica](/docs/it/managed-settings#how-claude-code-combines-managed-sources), il che per impostazione predefinita significa solo quando né le impostazioni gestite dal server né una politica Claude Code consegnata da MDM forniscono il livello gestito. Consultare [cosa viene trasferito dalla vostra configurazione](/docs/it/cloud-environments#what-carries-over-from-your-setup) per sapere quali file raggiungono una sessione cloud.271[Le sessioni cloud](/docs/it/claude-code-on-the-web) non leggono il tuo `~/.claude/settings.json` locale; gli hook lì provengono dal `.claude/settings.json` del repo in una sessione con un repository, dai plugin [sincronizzati dal tuo account claude.ai](/docs/it/plugins-reference#synced-plugins), e dalle impostazioni gestite dal server della tua organizzazione. In un [ambiente self-hosted](/docs/it/self-hosted-environments-configuration#permissions-and-tool-approval), Claude Code esegue anche gli hook che l'operatore ha seminato da `~/.claude/` dell'host runner, e esegue gli hook nel file di impostazioni gestite dell'immagine runner quando quel file è tra le [fonti gestite che Claude Code applica](/docs/it/managed-settings#how-claude-code-combines-managed-sources), il che per impostazione predefinita significa solo quando né le impostazioni gestite dal server né una policy Claude Code consegnata da MDM forniscono il livello gestito. Vedi [cosa viene trasferito dalla tua configurazione](/docs/it/cloud-environments#what-carries-over-from-your-setup) per quali file raggiungono una sessione cloud.

272 272

273Per i dettagli sulla risoluzione del file di impostazioni, consultare [settings](/docs/it/settings).273Per i dettagli sulla risoluzione dei file di impostazioni, vedi [settings](/docs/it/settings).

274 274

275Gli hook dai file di impostazioni, dalle impostazioni della politica gestita e dai plugin vengono eseguiti anche all'interno dei [subagents](/docs/it/sub-agents). Quando un subagent chiama uno strumento, gli eventi degli strumenti come `PreToolUse` e `PostToolUse` attivano gli stessi hook configurati della conversazione principale, e l'input contiene i campi di input comuni `agent_id` e `agent_type` [](#common-input-fields) che identificano il subagent.275Gli hook dai file di impostazioni, dalle impostazioni di policy gestite e dai plugin vengono eseguiti anche all'interno di [subagenti](/docs/it/sub-agents). Quando un subagent chiama uno strumento, gli eventi dello strumento come `PreToolUse` e `PostToolUse` attivano gli stessi hook configurati della conversazione principale, e l'input contiene i campi di input comuni `agent_id` e `agent_type` [](#common-input-fields) che identificano il subagent.

276 276

277Gli amministratori aziendali possono utilizzare `allowManagedHooksOnly` per limitare quali hook vengono eseguiti:277Gli amministratori aziendali possono utilizzare `allowManagedHooksOnly` per limitare quali hook vengono eseguiti:

278 278

279* Gli hook dell'utente, del progetto, locali e del plugin vengono bloccati. Gli hook dai plugin forzatamente abilitati nelle impostazioni gestite `enabledPlugins` sono esenti279* I tuoi hook utente, progetto, locale e plugin sono bloccati. Gli hook dai plugin forzatamente abilitati nelle impostazioni gestite `enabledPlugins` sono esenti

280* Claude Code inoltre limita le impostazioni [`statusLine`](/docs/it/statusline), [`fileSuggestion`](/docs/it/settings-reference#filesuggestion) e [`subagentStatusLine`](/docs/it/statusline#subagent-status-lines) alle impostazioni gestite280* Claude Code restringe anche le tue impostazioni [`statusLine`](/docs/it/statusline), [`fileSuggestion`](/docs/it/settings-reference#filesuggestion), e [`subagentStatusLine`](/docs/it/statusline#subagent-status-lines) alle impostazioni gestite

281* Claude Code inoltre disabilita i plugin con una [fonte `command`](/docs/it/plugin-marketplaces#command-sources), inclusi i plugin forzatamente abilitati nelle impostazioni gestite `enabledPlugins`, a meno che [`disableCommandPluginSources`](/docs/it/settings-reference#disablecommandpluginsources) non sia esplicitamente impostato su `false`. Le fonti `command` richiedono Claude Code v2.1.229 o successivo281* Claude Code disabilita anche i plugin con una [`command` source](/docs/it/plugin-marketplaces#command-sources), inclusi i plugin forzatamente abilitati nelle impostazioni gestite `enabledPlugins`, a meno che [`disableCommandPluginSources`](/docs/it/settings-reference#disablecommandpluginsources) non sia esplicitamente impostato su `false`. Le `command` sources richiedono Claude Code v2.1.229 o successivo

282* Claude Code inoltre blocca i comandi [`headersHelper`](/docs/it/plugin-marketplaces#authenticate-archive-downloads) del marketplace a meno che [`disableCommandPluginSources`](/docs/it/settings-reference#disablecommandpluginsources) non sia esplicitamente impostato su `false`, tranne per un marketplace che le impostazioni gestite stesse dichiarano282* Claude Code blocca anche i comandi [`headersHelper`](/docs/it/plugin-marketplaces#authenticate-archive-downloads) del marketplace a meno che [`disableCommandPluginSources`](/docs/it/settings-reference#disablecommandpluginsources) non sia esplicitamente impostato su `false`, tranne per un marketplace che le impostazioni gestite stesse dichiarano

283 283

284Consultare [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly).284Vedi [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly).

285 285

286Gli hook si uniscono tra i livelli di impostazioni piuttosto che sostituirsi a vicenda: le impostazioni dell'utente, del progetto e locali aggiungono i loro hook senza rimuovere quelli gestiti, e l'impostazione [`disableAllHooks`](#disable-or-remove-hooks) non può disabilitare gli hook gestiti da fuori le impostazioni gestite.286Le voci degli hook si uniscono tra i livelli di impostazioni piuttosto che sostituirsi a vicenda: le impostazioni utente, progetto e locale aggiungono i loro hook senza rimuovere quelli gestiti, e l'impostazione [`disableAllHooks`](#disable-or-remove-hooks) non può disabilitare gli hook gestiti da fuori le impostazioni gestite.

287 287

288Le [allowlist dei hook HTTP](/docs/it/settings-reference#hook-and-skill-settings) si applicano agli hook da ogni fonte, incluse le impostazioni della politica gestita:288Le [allowlist degli hook HTTP](/docs/it/settings-reference#hook-and-skill-settings) si applicano agli hook da ogni fonte, incluse le impostazioni di policy gestite:

289 289

290* `allowedHttpHookUrls`: quando definito a qualsiasi livello di impostazioni, Claude Code esegue un gestore di hook HTTP solo se il suo URL corrisponde all'allowlist unita290* `allowedHttpHookUrls`: quando definito a qualsiasi livello di impostazioni, Claude Code esegue un handler hook HTTP solo se il suo URL corrisponde all'allowlist unito

291* `httpHookAllowedEnvVars`: quando definito, Claude Code interpola solo le variabili di ambiente in quell'elenco nelle intestazioni del hook291* `httpHookAllowedEnvVars`: quando definito, Claude Code interpola solo le variabili di ambiente in quella lista negli header degli hook

292 292

293<h3 id="matcher-patterns">293<h3 id="matcher-patterns">

294 Modelli di matcher294 Modelli matcher

295</h3>295</h3>

296 296

297Il campo `matcher` filtra quando gli hook si attivano. Come viene valutato un matcher dipende dai caratteri che contiene:297Il campo `matcher` filtra quando gli hook si attivano. Come viene valutato un matcher dipende dai caratteri che contiene:

298 298

300| :----------------------------------------------- | :--------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |300| :------------------------------------------------ | :-------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

302| Solo lettere, cifre, `_`, `-`, spazi, `,` e `\|` | Stringa esatta, o elenco di stringhe esatte separate da `\|` o `,` con spazi bianchi opzionali circostanti | `Bash` corrisponde solo allo strumento Bash; `Edit\|Write` e `Edit, Write` corrispondono ciascuno a entrambi gli strumenti esattamente; `code-reviewer` corrisponde solo a quel tipo di agente |302| Solo lettere, cifre, `_`, `-`, spazi, `,`, e `\|` | Stringa esatta, o lista di stringhe esatte separate da `\|` o `,` con spazi bianchi opzionali circostanti | `Bash` corrisponde solo allo strumento Bash; `Edit\|Write` e `Edit, Write` corrispondono ciascuno a uno dei due strumenti esattamente; `code-reviewer` corrisponde solo a quel tipo di agente |

303| Contiene qualsiasi altro carattere | Espressione regolare JavaScript, non ancorata | `^Notebook` corrisponde a qualsiasi strumento il cui nome inizia con Notebook; `mcp__memory__.*` corrisponde a ogni strumento dal server `memory` |303| Contiene qualsiasi altro carattere | Espressione regolare JavaScript, non ancorata | `^Notebook` corrisponde a qualsiasi strumento il cui nome inizia con `Notebook`; `mcp__memory__.*` corrisponde a ogni strumento dal server `memory` |

304 304

305Un matcher sul percorso dell'espressione regolare viene testato con `RegExp.prototype.test` di JavaScript, che ha successo su una corrispondenza in qualsiasi punto del valore. `Edit.*` corrisponde sia a `Edit` che a `NotebookEdit`; racchiudere il modello in `^` e `$`, come in `^Edit$`, quando è necessaria una corrispondenza di intera stringa.305Un matcher sul percorso dell'espressione regolare viene testato con `RegExp.prototype.test` di JavaScript, che ha successo su una corrispondenza in qualsiasi punto del valore. `Edit.*` corrisponde sia a `Edit` che a `NotebookEdit`; racchiudi il pattern in `^` e `$`, come in `^Edit$`, quando hai bisogno di una corrispondenza di intera stringa.

306 306

307I separatori di virgola e la tolleranza dello spazio bianco circostante richiedono Claude Code v2.1.191 o successivo.307I separatori di virgola e la tolleranza dello spazio bianco circostante richiedono Claude Code v2.1.191 o successivo.

308 308

309I trattini nel set di corrispondenza esatta richiedono Claude Code v2.1.195 o successivo. Nelle versioni precedenti un nome con trattino come `code-reviewer` viene valutato come un'espressione regolare non ancorata, quindi si attiva anche per `senior-code-reviewer`; ancorarlo come `^code-reviewer$` su quelle versioni per corrispondere solo a quel nome.309I trattini nel set di corrispondenza esatta richiedono Claude Code v2.1.195 o successivo. Nelle versioni precedenti un nome con trattino come `code-reviewer` viene valutato come un'espressione regolare non ancorata, quindi si attiva anche per `senior-code-reviewer`; ancoratelo come `^code-reviewer$` in quelle versioni per corrispondere solo a quel nome.

310 310

311`FileChanged` e `StopFailure` utilizzano un set di corrispondenza esatta più ristretto di sole lettere, cifre, `_` e `|`. Un trattino, uno spazio o una virgola in un matcher per questi due eventi lo mantiene sul percorso dell'espressione regolare, e solo `|` separa le alternative. Ogni altro evento con supporto matcher nella tabella che segue accetta `|` o `,`.311`FileChanged` e `StopFailure` utilizzano un set di corrispondenza esatta più ristretto di sole lettere, cifre, `_`, e `|`. Un trattino, spazio, o virgola in un matcher per questi due eventi lo mantiene sul percorso dell'espressione regolare, e solo `|` separa le alternative. Ogni altro evento con supporto matcher nella tabella che segue accetta `|` o `,`.

312 312

313L'evento `FileChanged` non segue queste regole quando costruisce il suo elenco di osservazione. Consultare [FileChanged](#filechanged).313L'evento `FileChanged` non segue queste regole quando costruisce la sua lista di osservazione. Vedi [FileChanged](#filechanged).

314 314

315Ogni tipo di evento corrisponde a un campo diverso:315Ogni tipo di evento corrisponde su un campo diverso:

316 316

318| :------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |318| :------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

323| `Notification` | tipo di notifica | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled` |323| `Notification` | tipo di notifica | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled` |

326| `PreModelSwitch`, `PostModelSwitch` | nome canonico del modello a cui la sessione passa, come descritto sotto [PreModelSwitch](#premodelswitch) | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |326| `PreModelSwitch`, `PostModelSwitch` | nome canonico del modello a cui la sessione passa, come descritto sotto [PreModelSwitch](#premodelswitch) | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |

332| `StopFailure` | tipo di errore | `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error`, `unknown` |332| `StopFailure` | tipo di errore | `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error`, `unknown` |

337| `UserPromptSubmit`, `PostToolBatch`, `Stop`, `TeammateIdle`, `TaskCreated`, `TaskCompleted`, `WorktreeCreate`, `WorktreeRemove`, `MessageDisplay` | nessun supporto matcher | si attiva sempre ad ogni occorrenza |337| `UserPromptSubmit`, `PostToolBatch`, `Stop`, `TeammateIdle`, `TaskCreated`, `TaskCompleted`, `WorktreeCreate`, `WorktreeRemove`, `MessageDisplay` | nessun supporto matcher | si attiva sempre ad ogni occorrenza |

338 338

339La corrispondenza di `StopFailure` su `cloud_credential_error` richiede Claude Code v2.1.267 o successivo, la prima versione che segnala i guasti di caricamento delle credenziali sotto quel valore piuttosto che `server_error` o `unknown`.339La corrispondenza di `StopFailure` su `cloud_credential_error` richiede Claude Code v2.1.267 o successivo, la prima versione che segnala i fallimenti di caricamento delle credenziali sotto quel valore piuttosto che `server_error` o `unknown`.

340 340

341Per la maggior parte degli eventi, Claude Code valuta il matcher rispetto a un campo dall'[input JSON](#hook-input-and-output) che invia al vostro hook su stdin. Per gli eventi degli strumenti, quel campo è `tool_name`. Per `PreModelSwitch` e `PostModelSwitch`, Claude Code valuta il matcher rispetto al nome canonico che deriva da `to_model`, come descritto sotto [PreModelSwitch](#premodelswitch). Ogni sezione [hook event](#hook-events) elenca l'insieme completo di valori matcher e lo schema di input per quell'evento.341Per la maggior parte degli eventi, Claude Code valuta il matcher rispetto a un campo dall'[input JSON](#hook-input-and-output) che invia al tuo hook su stdin. Per gli eventi dello strumento, quel campo è `tool_name`. Per `PreModelSwitch` e `PostModelSwitch`, Claude Code valuta il matcher rispetto al nome canonico che deriva da `to_model`, come descritto sotto [PreModelSwitch](#premodelswitch). Ogni sezione [hook event](#hook-events) elenca l'insieme completo dei valori matcher e lo schema di input per quell'evento.

342 342

343Questo esempio esegue uno script di linting solo quando Claude scrive o modifica un file:343Questo esempio esegue uno script di linting solo quando Claude scrive o modifica un file:

344 344

360}360}

361```361```

362 362

363Se aggiungete un campo `matcher` a un evento senza supporto matcher, viene silenziosamente ignorato.363Se aggiungi un campo `matcher` a un evento senza supporto matcher, viene silenziosamente ignorato.

364 364

365Per gli eventi degli strumenti, potete filtrare più strettamente impostando il campo [`if`](#common-fields) sui singoli gestori del hook. `if` utilizza la [sintassi delle regole di autorizzazione](/docs/it/permissions) per corrispondere al nome dello strumento e agli argomenti insieme, quindi `"Bash(git *)"` viene eseguito quando qualsiasi sottocomando dell'input Bash corrisponde a `git *` e `"Edit(*.ts)"` viene eseguito solo per i file TypeScript.365Per gli eventi dello strumento, puoi filtrare più strettamente impostando il campo [`if`](#common-fields) sui singoli handler hook. `if` utilizza la [sintassi delle regole di permesso](/docs/it/permissions) per corrispondere al nome dello strumento e agli argomenti insieme, quindi `"Bash(git *)"` viene eseguito quando qualsiasi sottocomando dell'input Bash corrisponde a `git *` e `"Edit(*.ts)"` viene eseguito solo per i file TypeScript.

366 366

367<h4 id="match-mcp-tools">367<h4 id="match-mcp-tools">

368 Corrispondere ai strumenti MCP368 Corrispondere ai tool MCP

369</h4>369</h4>

370 370

371Gli strumenti del server [MCP](/docs/it/mcp) appaiono come strumenti regolari negli eventi degli strumenti (`PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied`), quindi potete farvi corrispondere lo stesso modo in cui fate corrispondere qualsiasi altro nome di strumento.371I tool del server [MCP](/docs/it/mcp) appaiono come tool regolari negli eventi dello strumento (`PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied`), quindi puoi farli corrispondere allo stesso modo di qualsiasi altro nome di strumento.

372 372

373Gli strumenti MCP seguono il modello di denominazione `mcp__<server>__<tool>`, ad esempio:373I tool MCP seguono il modello di denominazione `mcp__<server>__<tool>`, ad esempio:

374 374

375* `mcp__memory__create_entities`: strumento create entities del server Memory375* `mcp__memory__create_entities`: tool create entities del server Memory

376* `mcp__filesystem__read_file`: strumento read file del server Filesystem376* `mcp__filesystem__read_file`: tool read file del server Filesystem

377* `mcp__github__search_repositories`: strumento search del server GitHub377* `mcp__github__search_repositories`: tool search del server GitHub

378 378

379Per corrispondere a ogni strumento da un server, aggiungete `.*` al prefisso del server. `.*` è obbligatorio: un matcher come `mcp__memory` o `mcp__brave-search` contiene solo caratteri di corrispondenza esatta, quindi viene confrontato come stringa esatta e non corrisponde a nessuno strumento.379Per corrispondere a ogni tool da un server, aggiungi `.*` al prefisso del server. `.*` è obbligatorio: un matcher come `mcp__memory` o `mcp__brave-search` contiene solo caratteri di corrispondenza esatta, quindi viene confrontato come una stringa esatta e non corrisponde a nessun tool.

380 380

381* `mcp__memory__.*` corrisponde a tutti gli strumenti dal server `memory`381* `mcp__memory__.*` corrisponde a tutti i tool dal server `memory`

382* `mcp__brave-search__.*` corrisponde a tutti gli strumenti da un server il cui nome contiene un trattino382* `mcp__brave-search__.*` corrisponde a tutti i tool da un server il cui nome contiene un trattino

383* `mcp__.*__write.*` corrisponde a qualsiasi strumento il cui nome inizia con `write` da qualsiasi server383* `mcp__.*__write.*` corrisponde a qualsiasi tool il cui nome inizia con `write` da qualsiasi server

384 384

385I trattini nel set di corrispondenza esatta richiedono Claude Code v2.1.195 o successivo. Nelle versioni precedenti un prefisso semplice con trattino come `mcp__brave-search` viene valutato come un'espressione regolare non ancorata e corrisponde a ogni strumento da quel server. La forma `mcp__brave-search__.*` funziona su ogni versione.385I trattini nel set di corrispondenza esatta richiedono Claude Code v2.1.195 o successivo. Nelle versioni precedenti un prefisso nudo con trattino come `mcp__brave-search` viene valutato come un'espressione regolare non ancorata e corrisponde a ogni tool da quel server. La forma `mcp__brave-search__.*` funziona su ogni versione.

386 386

387Gli strumenti da un [server MCP fornito da plugin](/docs/it/mcp#plugin-provided-mcp-servers) utilizzano un segmento server con ambito che include il nome del plugin: `mcp__plugin_<plugin-name>_<server-name>__<tool>`. Un matcher scritto rispetto alla chiave del server semplice non si attiva mai per questi strumenti. Per un plugin denominato `my-plugin` che fornisce un server con la chiave `db`, uno strumento `query` appare come `mcp__plugin_my-plugin_db__query`, quindi il matcher per ogni strumento da quel server è `mcp__plugin_my-plugin_db__.*`. Utilizzate lo stesso nome dello strumento con ambito nel campo [`if`](#common-fields) di un gestore. Consultare [Plugin-provided MCP servers](/docs/it/mcp#plugin-provided-mcp-servers) per come viene costruito il nome con ambito.387I tool da un [server MCP fornito da plugin](/docs/it/mcp#plugin-provided-mcp-servers) utilizzano un segmento di server con scope che include il nome del plugin: `mcp__plugin_<plugin-name>_<server-name>__<tool>`. Un matcher scritto rispetto alla chiave del server nudo non si attiva mai per questi tool. Per un plugin denominato `my-plugin` che raggruppa un server sotto la chiave `db`, un tool `query` appare come `mcp__plugin_my-plugin_db__query`, quindi il matcher per ogni tool da quel server è `mcp__plugin_my-plugin_db__.*`. Utilizza lo stesso nome di tool con scope nel campo [`if`](#common-fields) di un handler. Vedi [Plugin-provided MCP servers](/docs/it/mcp#plugin-provided-mcp-servers) per come viene costruito il nome con scope.

388 388

389Questo esempio registra tutte le operazioni del server memory e convalida le operazioni di scrittura da qualsiasi server MCP:389Questo esempio registra tutte le operazioni del server memory e convalida le operazioni di scrittura da qualsiasi server MCP:

390 390

416```416```

417 417

418<h3 id="hook-handler-fields">418<h3 id="hook-handler-fields">

419 Campi del gestore del hook419 Campi handler hook

420</h3>420</h3>

421 421

422Ogni oggetto nell'array `hooks` interno è un gestore del hook: il comando shell, endpoint HTTP, strumento MCP, prompt LLM o agente che viene eseguito quando il matcher corrisponde. Ci sono cinque tipi:422Ogni oggetto nell'array `hooks` interno è un handler hook: il comando shell, endpoint HTTP, tool MCP, prompt LLM, o agente che viene eseguito quando il matcher corrisponde. Ci sono cinque tipi:

423 423

424* **[Command hooks](#command-hook-fields)** (`type: "command"`): eseguono un comando shell. Lo script riceve l'[input JSON](#hook-input-and-output) dell'evento su stdin e comunica i risultati attraverso codici di uscita e stdout.424* **[Command hooks](#command-hook-fields)** (`type: "command"`): esegui un comando shell. Il tuo script riceve l'[input JSON](#hook-input-and-output) dell'evento su stdin e comunica i risultati indietro attraverso codici di uscita e stdout.

425* **[HTTP hooks](#http-hook-fields)** (`type: "http"`): inviano l'input JSON dell'evento come richiesta HTTP POST a un URL. L'endpoint comunica i risultati attraverso il corpo della risposta utilizzando lo stesso [formato JSON di output](#json-output) dei command hook.425* **[HTTP hooks](#http-hook-fields)** (`type: "http"`): invia l'input JSON dell'evento come richiesta HTTP POST a un URL. L'endpoint comunica i risultati indietro attraverso il corpo della risposta utilizzando lo stesso [formato di output JSON](#json-output) degli hook di comando.

426* **[MCP tool hooks](#mcp-tool-hook-fields)** (`type: "mcp_tool"`): chiamano uno strumento su un [server MCP](/docs/it/mcp) già connesso. L'output di testo dello strumento viene trattato come stdout del command hook.426* **[MCP tool hooks](#mcp-tool-hook-fields)** (`type: "mcp_tool"`): chiama un tool su un server [MCP](/docs/it/mcp) già connesso. L'output di testo del tool viene trattato come stdout di hook di comando.

427* **[Prompt hooks](#prompt-and-agent-hook-fields)** (`type: "prompt"`): inviano un prompt a un modello Claude per la valutazione a turno singolo. Il modello restituisce la sua decisione come JSON. Consultare [Prompt-based hooks](#prompt-based-hooks).427* **[Prompt hooks](#prompt-and-agent-hook-fields)** (`type: "prompt"`): invia un prompt a un modello Claude per la valutazione a turno singolo. Il modello restituisce la sua decisione come JSON. Vedi [Prompt-based hooks](#prompt-based-hooks).

428* **[Agent hooks](#prompt-and-agent-hook-fields)** (`type: "agent"`): generano un subagent che può utilizzare strumenti come Read, Grep e Glob per verificare le condizioni prima di restituire una decisione. Gli agent hook sono sperimentali e potrebbero cambiare. Consultare [Agent-based hooks](#agent-based-hooks).428* **[Agent hooks](#prompt-and-agent-hook-fields)** (`type: "agent"`): genera un subagent che può utilizzare tool come Read, Grep, e Glob per verificare le condizioni prima di restituire una decisione. Gli agent hook sono sperimentali e potrebbero cambiare. Vedi [Agent-based hooks](#agent-based-hooks).

429 429

430Tutti gli hook corrispondenti vengono eseguiti in parallelo. Se definite lo stesso gestore in più di un file di impostazioni, viene eseguito una volta. Una copia dello stesso gestore di un plugin o di una skill rimane separata.430Tutti gli hook corrispondenti vengono eseguiti in parallelo. Se definisci lo stesso handler in più di un file di impostazioni, viene eseguito una volta. Una copia dello stesso handler di un plugin o skill rimane separata.

431 431

432I gestori vengono eseguiti nella directory corrente con l'ambiente di Claude Code. Se la directory corrente non esiste più, ad esempio un worktree o una directory temporanea che un'altra shell ha eliminato a metà sessione, Claude Code esegue i command hook dal primo di questi che esiste ancora: la directory in cui la sessione è iniziata, la radice del progetto, la vostra home directory o la directory temporanea del sistema. Claude Code registra un avviso che nomina la directory di fallback nel [debug log](#debug-hooks).432Gli handler vengono eseguiti nella directory corrente con l'ambiente di Claude Code. Se la directory corrente non esiste più, ad esempio un worktree o una directory temporanea che un'altra shell ha eliminato a metà sessione, Claude Code esegue gli hook di comando dal primo di questi che esiste ancora: la directory in cui è iniziata la sessione, la radice del progetto, la tua home directory, o la directory temporanea del sistema. Claude Code registra un avviso che nomina la directory di fallback nel [debug log](#debug-hooks).

433 433

434La variabile di ambiente `$CLAUDE_CODE_REMOTE` è `"true"` negli ambienti web remoti e non è impostata nella CLI locale. Claude Code v2.1.199 e successivo imposta [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/it/env-vars) all'ID della sessione [Remote Control](/docs/it/remote-control) mentre la sessione locale ha una connessione Remote Control attiva.434La variabile di ambiente `$CLAUDE_CODE_REMOTE` è `"true"` negli ambienti web remoti e non è impostata nella CLI locale. Claude Code v2.1.199 e successivo imposta [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/it/env-vars) all'ID della sessione [Remote Control](/docs/it/remote-control) mentre la sessione locale ha una connessione Remote Control attiva.

435 435

440Questi campi si applicano a tutti i tipi di hook:440Questi campi si applicano a tutti i tipi di hook:

441 441

443| :-------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |443| :-------------- | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

444| `type` | sì | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` o `"agent"` |444| `type` | sì | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"`, o `"agent"` |

445| `if` | no | Sintassi della regola di autorizzazione per filtrare quando questo hook viene eseguito, come `"Bash(git *)"` o `"Edit(*.ts)"`. L'hook viene eseguito solo se la chiamata dello strumento corrisponde al modello. Consultare la [tabella di corrispondenza Bash](#bash-if-matching) di seguito per come i modelli Bash si valutano rispetto ai sottocomandi, `$()` e backtick. Valutato solo su eventi degli strumenti: `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 autorizzazione](/docs/it/permissions) |445| `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) |

446| `timeout` | no | Secondi prima dell'annullamento. Claude Code non lo applica su un command hook che eseguite 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 vostre impostazioni impostano un `timeout` per hook più lungo, Claude Code aumenta il budget per corrispondere, fino a 60 secondi |446| `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 |

447| `statusMessage` | no | Messaggio spinner personalizzato visualizzato mentre l'hook viene eseguito |447| `statusMessage` | no | Messaggio spinner personalizzato visualizzato mentre l'hook viene eseguito |

448| `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 della skill](#hooks-in-skills-and-agents); ignorato nei file di impostazioni e nel frontmatter dell'agente |448| `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 |

449 449

450Il campo `if` contiene esattamente una regola di autorizzazione. Non esiste sintassi `&&`, `||` o di elenco per combinare le regole; per applicare più condizioni, definite un gestore del hook separato per ciascuna.450Il campo `if` contiene esattamente una regola di permesso. Non c'è sintassi `&&`, `||`, o lista per combinare le regole; per applicare più condizioni, definisci un handler hook separato per ciascuna.

451 451

452In una condizione `if` per uno strumento di file, un modello 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à, scrivete `"Edit(**/src/**)"`. Prima di v2.1.214, `"Edit(src/**)"` corrispondeva a una directory denominata `src` a qualsiasi profondità sotto la directory di lavoro.452In 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.

453 453

454<span id="bash-if-matching" />Per i modelli Bash, se il comando hook viene eseguito dipende dalla forma del modello e dal comando Bash che Claude sta invocando. Gli assegnamenti `VAR=value` iniziali vengono rimossi prima della corrispondenza.454<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.

455 455

457| :----------------- | :-------------------------- | :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------- |457| :----------------- | :-------------------------- | :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------- |

462| `Bash(cat *)` | `echo before $(date) after` | no | una sostituzione può stare in qualsiasi posizione di argomento, quindi il comando completo e `date` vengono entrambi controllati; nessuno corrisponde a `cat *` |462| `Bash(cat *)` | `echo before $(date) after` | no | una sostituzione può stare in qualsiasi posizione di argomento, quindi il comando completo e `date` vengono entrambi controllati; nessuno corrisponde a `cat *` |

465 465

466Quando Claude Code non può determinare quali comandi l'input Bash esegue, esegue il vostro hook indipendentemente dal modello. Poiché il filtro `if` è best-effort, utilizzate il [sistema di autorizzazione](/docs/it/permissions) piuttosto che un hook per applicare un'autorizzazione o un diniego rigido.466Quando Claude Code non può determinare quali comandi esegue l'input Bash, esegue il tuo hook indipendentemente dal pattern. Poiché il filtro `if` è best-effort, utilizza il [sistema di permessi](/docs/it/permissions) piuttosto che un hook per applicare un allow o deny rigido.

467 467

468<h4 id="command-hook-fields">468<h4 id="command-hook-fields">

469 Campi del command hook469 Campi command hook

470</h4>470</h4>

471 471

472Oltre ai [campi comuni](#common-fields), i command hook accettano questi campi:472Oltre ai [campi comuni](#common-fields), gli hook di comando accettano questi campi:

473 473

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

476| `command` | sì | Comando shell da eseguire. Con `args`, l'eseguibile da generare direttamente. Consultare [Exec form e shell form](#exec-form-and-shell-form) |476| `command` | sì | Comando shell da eseguire. Con `args`, l'eseguibile da generare direttamente. Vedi [Exec form e shell form](#exec-form-and-shell-form) |

477| `args` | no | Elenco di argomenti. Quando presente, `command` viene risolto come eseguibile e generato direttamente con `args` come vettore di argomenti, senza shell. Consultare [Exec form e shell form](#exec-form-and-shell-form) |477| `args` | no | Lista di argomenti. Quando presente, `command` viene risolto come un eseguibile e generato direttamente con `args` come vettore di argomenti, senza shell coinvolto. Vedi [Exec form e shell form](#exec-form-and-shell-form) |

478| `async` | no | Se `true`, viene eseguito in background senza bloccare. Consultare [Run hooks in the background](#run-hooks-in-the-background) |478| `async` | no | Se `true`, viene eseguito in background senza bloccare. Vedi [Run hooks in the background](#run-hooks-in-the-background) |

479| `asyncRewake` | no | Se `true`, viene eseguito in background e riattiva Claude su codice di uscita 2. L'hook stderr, o stdout se stderr è vuoto, viene mostrato a Claude come promemoria di sistema in modo che possa reagire a un guasto in background a lunga esecuzione |479| `asyncRewake` | no | Se `true`, viene eseguito in background e riattiva Claude al codice di uscita 2. Lo stderr dell'hook, o stdout se stderr è vuoto, viene mostrato a Claude come un promemoria di sistema in modo che possa reagire a un fallimento di background di lunga durata |

480| `shell` | no | Shell da utilizzare per questo hook. Accetta `"bash"` o `"powershell"`. Impostazione predefinita: `"bash"`, o `"powershell"` su Windows quando Git Bash non è installato. L'impostazione `"powershell"` esegue il comando tramite PowerShell su Windows. Non richiede `CLAUDE_CODE_USE_POWERSHELL_TOOL` poiché gli hook generano PowerShell direttamente. Ignorato quando `args` è impostato |480| `shell` | no | Shell da utilizzare per questo hook. Accetta `"bash"` o `"powershell"`. Impostazione predefinita `"bash"`, o `"powershell"` su Windows quando Git Bash non è installato. L'impostazione di `"powershell"` esegue il comando tramite PowerShell su Windows. Non richiede `CLAUDE_CODE_USE_POWERSHELL_TOOL` poiché gli hook generano PowerShell direttamente. Ignorato quando `args` è impostato |

481 481

482<a id="exec-form-and-shell-form" />482<a id="exec-form-and-shell-form" />

483 483

485 Exec form e shell form485 Exec form e shell form

486</h5>486</h5>

487 487

488Un command hook viene eseguito come exec form quando `args` è impostato, e come shell form quando `args` è omesso. Impostate `args` ogni volta che l'hook fa riferimento a un [segnaposto di percorso](#reference-scripts-by-path), poiché ogni elemento viene passato come un argomento senza virgolette. Omettete `args` quando è necessario utilizzare funzionalità shell come pipe o `&&`, o quando nessuno dei due problemi si applica.488Un hook di comando viene eseguito come exec form quando `args` è impostato, e shell form quando `args` è omesso. Imposta `args` ogni volta che l'hook fa riferimento a un [placeholder di percorso](#reference-scripts-by-path), poiché ogni elemento viene passato come un argomento senza virgolette. Ometti `args` quando hai bisogno di funzioni shell come pipe o `&&`, o quando nessuno dei due problemi si applica.

489 489

490**Exec form** viene eseguito quando `args` è presente. Claude Code risolve `command` come eseguibile su `PATH` e lo genera direttamente con `args` come vettore di argomenti. Non c'è shell, quindi ogni elemento `args` è un argomento esattamente come scritto, e i segnaposti di percorso come `${CLAUDE_PLUGIN_ROOT}` vengono sostituiti in `command` e in ogni elemento `args` come stringhe semplici. I caratteri speciali come apostrofi, `$` e backtick passano attraverso verbatim perché non c'è shell per interpretarli. Non avviene alcuna tokenizzazione shell su nessuna piattaforma.490**Exec form** viene eseguito quando `args` è presente. Claude Code risolve `command` come un eseguibile su `PATH` e lo genera direttamente con `args` come vettore di argomenti. Non c'è shell, quindi ogni elemento `args` è un argomento esattamente come scritto, e i placeholder di percorso come `${CLAUDE_PLUGIN_ROOT}` vengono sostituiti in `command` e in ogni elemento `args` come stringhe semplici. I caratteri speciali come apostrofi, `$`, e backtick passano attraverso verbatim perché non c'è shell per interpretarli. Non avviene tokenizzazione shell su nessuna piattaforma.

491 491

492**Shell form** viene eseguito quando `args` è assente. La stringa `command` viene passata a una shell: `sh -c` su macOS e Linux, Git Bash su Windows, o PowerShell quando Git Bash non è installato. Impostate il campo `shell` per scegliere esplicitamente. La shell tokenizza la stringa, espande le variabili e interpreta pipe, `&&`, reindirizzamenti e glob.492**Shell form** viene eseguito quando `args` è assente. La stringa `command` viene passata a una shell: `sh -c` su macOS e Linux, Git Bash su Windows, o PowerShell quando Git Bash non è installato. Imposta il campo `shell` per scegliere esplicitamente. La shell tokenizza la stringa, espande le variabili, e interpreta pipe, `&&`, reindirizzamenti, e glob.

493 493

494<Note>494<Note>

495 Su Windows, exec form richiede che `command` si risolva in un vero eseguibile come `.exe`. Gli shim `.cmd` e `.bat` che npm, npx, eslint e altri strumenti installano in `node_modules/.bin` non sono eseguibili e non possono essere generati senza una shell. Per eseguirli in exec form, invocate lo script sottostante con `node` direttamente, ad esempio `"command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/node_modules/eslint/bin/eslint.js"]`. Il modello `node` più percorso-script funziona su ogni piattaforma perché `node.exe` è un vero binario. Per eseguire uno shim `.cmd` o `.bat` per nome, utilizzate shell form.495 Su Windows, exec form richiede che `command` si risolva in un vero eseguibile come `.exe`. Gli shim `.cmd` e `.bat` che npm, npx, eslint, e altri tool installano in `node_modules/.bin` non sono eseguibili e non possono essere generati senza una shell. Per eseguirli in exec form, invoca lo script sottostante con `node` direttamente, ad esempio `"command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/node_modules/eslint/bin/eslint.js"]`. Il pattern `node` più script-path funziona su ogni piattaforma perché `node.exe` è un vero binario. Per eseguire uno shim `.cmd` o `.bat` per nome, utilizza shell form.

496</Note>496</Note>

497 497

498Questo esempio esegue uno script Node fornito con un plugin. Exec form passa il percorso dello script risolto come un argomento senza virgolette:498Questo esempio esegue uno script Node raggruppato con un plugin. Exec form passa il percorso dello script risolto come un argomento senza virgolette:

499 499

500```json theme={null}500```json theme={null}

501{501{

514}514}

515```515```

516 516

517Entrambe le forme supportano gli stessi [segnaposti di percorso](#reference-scripts-by-path), ed entrambi li esportano come variabili di ambiente `CLAUDE_PROJECT_DIR`, `CLAUDE_PLUGIN_ROOT` e `CLAUDE_PLUGIN_DATA` sul processo generato, quindi uno script può leggere `process.env.CLAUDE_PLUGIN_ROOT` indipendentemente da come è stato lanciato.517Entrambe le forme supportano gli stessi [placeholder di percorso](#reference-scripts-by-path), ed entrambe li esportano come variabili di ambiente `CLAUDE_PROJECT_DIR`, `CLAUDE_PLUGIN_ROOT`, e `CLAUDE_PLUGIN_DATA` sul processo generato, quindi uno script può leggere `process.env.CLAUDE_PLUGIN_ROOT` indipendentemente da come è stato lanciato.

518 518

519Gli hook del plugin inoltre sostituiscono i valori [`${user_config.*}`](/docs/it/plugins-reference#user-configuration), in exec form solo: il valore viene sostituito in `command` e in ogni elemento `args` come stringa semplice, quindi nessuna shell lo rianalizza.519Gli hook plugin inoltre sostituiscono i valori [`${user_config.*}`](/docs/it/plugins-reference#user-configuration), solo in exec form: il valore viene sostituito in `command` e in ogni elemento `args` come una stringa semplice, quindi nessuna shell lo ri-analizza.

520 520

521Un hook del plugin in shell form il cui `command` fa riferimento a `${user_config.*}` fallisce con un [errore](/docs/it/errors#plugin-command-references-user-config) invece di eseguirsi. Per utilizzare un valore di opzione da un hook in shell form, leggete la variabile di ambiente `$CLAUDE_PLUGIN_OPTION_<KEY>`, come `$CLAUDE_PLUGIN_OPTION_WEBHOOK_URL` per un'opzione `webhook_url`, oppure impostate `args` per passare l'hook a exec form. Prima di v2.1.207, i comandi degli hook del plugin in shell form sostituivano anche `${user_config.*}`.521Un hook plugin in shell form il cui `command` fa riferimento a `${user_config.*}` fallisce con un [errore](/docs/it/errors#plugin-command-references-user-config) invece di essere eseguito. Per utilizzare un valore di opzione da un hook in shell form, leggi la variabile di ambiente `$CLAUDE_PLUGIN_OPTION_<KEY>`, come `$CLAUDE_PLUGIN_OPTION_WEBHOOK_URL` per un'opzione `webhook_url`, o imposta `args` per passare l'hook a exec form. Prima di v2.1.207, i comandi degli hook plugin in shell form sostituivano anche `${user_config.*}`.

522 522

523<Note>523<Note>

524 In exec form, `command` è solo il nome o il percorso dell'eseguibile. Se `command` è un nome semplice senza separatore di percorso e contiene spazi bianchi insieme a `args`, Claude Code registra un avviso perché la generazione avrà esito negativo: non esiste un eseguibile denominato `node script.js`. Spostate i token extra in `args`. I percorsi assoluti con spazi, come `C:\Program Files\nodejs\node.exe`, sono un singolo eseguibile valido e non attivano l'avviso.524 In exec form, `command` è solo il nome o il percorso dell'eseguibile. Se `command` è un nome nudo senza separatore di percorso e contiene spazi insieme a `args`, Claude Code registra un avviso perché la generazione fallirà: non c'è un eseguibile denominato `node script.js`. Sposta i token extra in `args`. I percorsi assoluti con spazi, come `C:\Program Files\nodejs\node.exe`, sono un singolo eseguibile valido e non attivano l'avviso.

525</Note>525</Note>

526 526

527<h4 id="http-hook-fields">527<h4 id="http-hook-fields">

528 Campi del HTTP hook528 Campi HTTP hook

529</h4>529</h4>

530 530

531Oltre ai [campi comuni](#common-fields), gli HTTP hook accettano questi campi:531Oltre ai [campi comuni](#common-fields), gli hook HTTP accettano questi campi:

532 532

534| :--------------- | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |534| :--------------- | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

535| `url` | sì | URL a cui inviare la richiesta POST |535| `url` | sì | URL a cui inviare la richiesta POST |

536| `headers` | no | Intestazioni HTTP aggiuntive come coppie chiave-valore. I valori supportano l'interpolazione delle variabili di ambiente utilizzando la sintassi `$VAR_NAME` o `${VAR_NAME}`. Solo le variabili elencate in `allowedEnvVars` vengono risolte |536| `headers` | no | Header HTTP aggiuntivi come coppie chiave-valore. I valori supportano l'interpolazione delle variabili di ambiente utilizzando la sintassi `$VAR_NAME` o `${VAR_NAME}`. Solo le variabili elencate in `allowedEnvVars` vengono risolte |

537| `allowedEnvVars` | no | Elenco dei nomi delle variabili di ambiente che possono essere interpolate nei valori dell'intestazione. I riferimenti alle variabili non elencate vengono sostituiti con stringhe vuote. Obbligatorio per qualsiasi interpolazione di variabili di ambiente |537| `allowedEnvVars` | no | Lista di nomi di variabili di ambiente che possono essere interpolate nei valori degli header. I riferimenti alle variabili non elencate vengono sostituiti con stringhe vuote. Obbligatorio affinché avvenga qualsiasi interpolazione di variabili di ambiente |

538 538

539Claude Code invia l'[input JSON](#hook-input-and-output) del hook come corpo della richiesta POST con `Content-Type: application/json`. Il corpo della risposta utilizza lo stesso [formato JSON di output](#json-output) dei command hook.539Claude Code invia l'[input JSON](#hook-input-and-output) dell'hook come corpo della richiesta POST con `Content-Type: application/json`. Il corpo della risposta utilizza lo stesso [formato di output JSON](#json-output) degli hook di comando.

540 540

541La gestione degli errori differisce dai command hook; consultare [HTTP response handling](#http-response-handling).541La gestione degli errori differisce dagli hook di comando; vedi [HTTP response handling](#http-response-handling).

542 542

543Questo esempio invia gli eventi `PreToolUse` a un servizio di convalida locale, autenticandosi con un token dalla variabile di ambiente `MY_TOKEN`:543Questo esempio invia gli eventi `PreToolUse` a un servizio di convalida locale, autenticandosi con un token dalla variabile di ambiente `MY_TOKEN`:

544 544

566```566```

567 567

568<h4 id="mcp-tool-hook-fields">568<h4 id="mcp-tool-hook-fields">

569 Campi del MCP tool hook569 Campi MCP tool hook

570</h4>570</h4>

571 571

572Oltre ai [campi comuni](#common-fields), gli MCP tool hook accettano questi campi:572Oltre ai [campi comuni](#common-fields), gli hook MCP tool accettano questi campi:

573 573

575| :------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |575| :------- | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

576| `server` | sì | Nome di un server MCP configurato. Per un [server fornito da plugin](/docs/it/mcp#plugin-provided-mcp-servers), questo è il nome con ambito `plugin:<plugin-name>:<server-name>`, come `plugin:my-plugin:db`, non la chiave del server semplice. Il server deve essere già connesso; l'hook non attiva mai un flusso OAuth o di connessione |576| `server` | sì | Nome di un server MCP configurato. Per un [server fornito da plugin](/docs/it/mcp#plugin-provided-mcp-servers), questo è il nome con scope `plugin:<plugin-name>:<server-name>`, come `plugin:my-plugin:db`, non la chiave del server nudo. Il server deve essere già connesso; l'hook non attiva mai un flusso OAuth o di connessione |

577| `tool` | sì | Nome dello strumento da chiamare su quel server |577| `tool` | sì | Nome del tool da chiamare su quel server |

578| `input` | no | Argomenti passati allo strumento. I valori stringa supportano la sostituzione `${path}` dall'[input JSON](#hook-input-and-output) del hook, come `"${tool_input.file_path}"` |578| `input` | no | Argomenti passati al tool. I valori stringa supportano la sostituzione `${path}` dall'[input JSON](#hook-input-and-output) dell'hook, come `"${tool_input.file_path}"` |

579 579

580Claude Code legge il contenuto di testo dello strumento nello stesso modo in cui legge il stdout del command hook, seguendo la [regola di analisi sotto il codice di uscita 0](#exit-code-0). Se il server denominato non è connesso, o lo strumento restituisce `isError: true`, l'hook produce un errore non bloccante e l'esecuzione continua.580Claude Code legge il contenuto di testo del tool allo stesso modo in cui legge stdout di hook di comando, seguendo la [regola di analisi sotto il codice di uscita 0](#exit-code-0). Se il server denominato non è connesso, o il tool restituisce `isError: true`, l'hook produce un errore non bloccante e l'esecuzione continua.

581 581

582Questo esempio chiama lo strumento `security_scan` sul server MCP `my_server` dopo ogni `Write` o `Edit`, passando il percorso del file modificato:582Questo esempio chiama il tool `security_scan` sul server MCP `my_server` dopo ogni `Write` o `Edit`, passando il percorso del file modificato:

583 583

584```json theme={null}584```json theme={null}

585{585{

601}601}

602```602```

603 603

604Un hook `mcp_tool` può essere eseguito solo una volta che Claude Code ha reso disponibili i server MCP della sessione agli hook. `SessionStart` e `Setup` possono attivarsi prima di quel punto:604Un hook `mcp_tool` può essere eseguito solo dopo che Claude Code ha reso i server MCP della sessione disponibili agli hook. `SessionStart` e `Setup` possono attivarsi prima di quel punto:

605 605

606* **Al lancio**: `SessionStart` si attiva prima che i server siano disponibili, incluso quando lanciate con `--continue` o `--resume`. Claude Code salta gli hook `mcp_tool` dell'evento senza chiamare i loro strumenti, e il [debug log](#debug-hooks) registra `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)`.606* **Al lancio**: `SessionStart` si attiva prima che i server siano disponibili, incluso quando avvii con `--continue` o `--resume`. Claude Code salta gli hook `mcp_tool` dell'evento senza chiamare i loro tool, e il [debug log](#debug-hooks) registra `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)`.

607* **Più tardi in una sessione in esecuzione**: dopo `/clear` o una compattazione, `SessionStart` si attiva di nuovo con i server già disponibili, e i suoi hook `mcp_tool` vengono eseguiti.607* **Più tardi in una sessione in esecuzione**: dopo `/clear` o una compattazione, `SessionStart` si attiva di nuovo con i server già disponibili, e i suoi hook `mcp_tool` vengono eseguiti.

608* **Su `Setup`**: `Setup` si attiva sempre prima che i server siano disponibili, quindi Claude Code salta i suoi hook `mcp_tool` ogni volta e registra lo stesso messaggio che nomina `Setup`.608* **Su `Setup`**: `Setup` si attiva sempre prima che i server siano disponibili, quindi Claude Code salta i suoi hook `mcp_tool` ogni volta e registra lo stesso messaggio che nomina `Setup`.

609 609

610Ad esempio, questa configurazione chiama lo strumento `load_context` sul server MCP `my_server` da un hook `SessionStart` senza matcher, quindi si applica a ogni fonte `SessionStart`:610Ad esempio, questa configurazione chiama il tool `load_context` sul server MCP `my_server` da un hook `SessionStart` senza matcher, quindi si applica a ogni fonte `SessionStart`:

611 611

612```json theme={null}612```json theme={null}

613{613{

627}627}

628```628```

629 629

630Quando eseguite `claude`, Claude Code salta questo hook, non chiama mai `load_context` e scrive il messaggio `no MCP client context` nel debug log. Eseguite `/clear` in quella stessa sessione e l'hook viene eseguito e chiama `load_context`. Un hook `type: "command"` su `SessionStart` viene eseguito al lancio, quindi utilizzatene uno per qualsiasi cosa la sessione abbia bisogno dal suo primo turno.630Quando esegui `claude`, Claude Code salta questo hook, non chiama mai `load_context`, e scrive il messaggio `no MCP client context` nel debug log. Esegui `/clear` in quella stessa sessione e l'hook viene eseguito e chiama `load_context`. Un hook `type: "command"` su `SessionStart` viene eseguito al lancio, quindi usane uno per qualsiasi cosa la sessione abbia bisogno dal suo primo turno.

631 631

632<h4 id="prompt-and-agent-hook-fields">632<h4 id="prompt-and-agent-hook-fields">

633 Campi del prompt hook e agent hook633 Campi prompt e agent hook

634</h4>634</h4>

635 635

636Oltre ai [campi comuni](#common-fields), i prompt hook e agent hook accettano questi campi:636Oltre ai [campi comuni](#common-fields), gli hook prompt e agent accettano questi campi:

637 637

639| :------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |639| :------- | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

640| `prompt` | sì | Testo del prompt da inviare al modello. Utilizzate `$ARGUMENTS` come segnaposto per l'input JSON del hook. Sfuggite con una barra rovesciata per includere testo letterale: `\$1.00` viene visualizzato come `$1.00` |640| `prompt` | sì | Testo del prompt da inviare al modello. Utilizza `$ARGUMENTS` come placeholder per l'input JSON dell'hook. Sfuggi con una barra rovesciata per includere testo letterale: `\$1.00` viene renderizzato come `$1.00` |

641| `model` | no | Modello da utilizzare per la valutazione. Impostazione predefinita: un modello veloce |641| `model` | no | Modello da utilizzare per la valutazione. Impostazione predefinita a un modello veloce |

642 642

643<h3 id="reference-scripts-by-path">643<h3 id="reference-scripts-by-path">

644 Fare riferimento agli script per percorso644 Riferisci gli script per percorso

645</h3>645</h3>

646 646

647Utilizzate questi segnaposti per fare riferimento agli script del hook relativi alla radice del progetto o del plugin, indipendentemente dalla directory di lavoro quando l'hook viene eseguito:647Utilizza questi placeholder per fare riferimento agli script degli hook relativi alla radice del progetto o del plugin, indipendentemente dalla directory di lavoro quando l'hook viene eseguito:

648 648

649* `${CLAUDE_PROJECT_DIR}`: la radice del progetto dove la sessione è iniziata. Claude Code inoltre imposta questa variabile nell'ambiente dei [server MCP stdio](/docs/it/mcp#option-3-add-a-local-stdio-server) e dei server LSP del plugin.649* `${CLAUDE_PROJECT_DIR}`: la radice del progetto dove è iniziata la sessione. Claude Code imposta anche questa variabile nell'ambiente dei [server MCP stdio](/docs/it/mcp#option-3-add-a-local-stdio-server) e dei server LSP dei plugin.

650* `${CLAUDE_PLUGIN_ROOT}`: la directory di installazione del plugin, per gli script forniti con un [plugin](/docs/it/plugins). Consultare [plugin environment variables](/docs/it/plugins-reference#environment-variables) per come il percorso si comporta tra gli aggiornamenti.650* `${CLAUDE_PLUGIN_ROOT}`: la directory di installazione del plugin, per gli script raggruppati con un [plugin](/docs/it/plugins). Vedi [variabili di ambiente del plugin](/docs/it/plugins-reference#environment-variables) per come il percorso si comporta tra gli aggiornamenti.

651* `${CLAUDE_PLUGIN_DATA}`: la [directory di dati persistenti](/docs/it/plugins-reference#persistent-data-directory) del plugin, per le dipendenze e lo stato che dovrebbero sopravvivere agli aggiornamenti del plugin.651* `${CLAUDE_PLUGIN_DATA}`: la [directory di dati persistenti](/docs/it/plugins-reference#persistent-data-directory) del plugin, per le dipendenze e lo stato che dovrebbero sopravvivere agli aggiornamenti del plugin.

652 652

653<Note>653<Note>

654 **I worktree sono diversi.** Se Claude entra in un [worktree](/docs/it/worktrees) durante la sessione, Claude Code mantiene `${CLAUDE_PROJECT_DIR}` dove era e passa il percorso del worktree ai vostri hook in un modo diverso:654 **I worktree sono diversi.** Se Claude entra in un [worktree](/docs/it/worktrees) durante la sessione, Claude Code mantiene `${CLAUDE_PROJECT_DIR}` dove era e passa il percorso del worktree ai tuoi hook in un modo diverso:

655 655

656 * **`${CLAUDE_PROJECT_DIR}` rimane fermo**: punta ancora alla radice del progetto dove la sessione è iniziata, quindi un comando come `${CLAUDE_PROJECT_DIR}/.claude/hooks/check-style.sh` esegue ancora lo script nel checkout principale.656 * **`${CLAUDE_PROJECT_DIR}` rimane fermo**: punta ancora alla radice del progetto dove è iniziata la sessione, quindi un comando come `${CLAUDE_PROJECT_DIR}/.claude/hooks/check-style.sh` esegue ancora lo script nel checkout principale.

657 * **`cwd` segue Claude**: il campo `cwd` nell'[input JSON](#common-input-fields) del hook è la radice del worktree dopo che Claude entra in un worktree, e la nuova directory dopo che Claude esegue `cd`. Leggete quando un hook ha bisogno di sapere quale directory Claude sta utilizzando.657 * **`cwd` segue Claude**: il campo `cwd` nell'[input JSON](#common-input-fields) dell'hook è la radice del worktree dopo che Claude entra in un worktree, e la nuova directory dopo che Claude esegue `cd`. Leggilo quando un hook ha bisogno di sapere quale directory Claude sta utilizzando.

658</Note>658</Note>

659 659

660Preferite [exec form](#exec-form-and-shell-form) per qualsiasi hook che faccia riferimento a un segnaposto di percorso. In shell form, racchiudete ogni segnaposto tra virgolette doppie.660Preferisci [exec form](#exec-form-and-shell-form) per qualsiasi hook che faccia riferimento a un placeholder di percorso. In shell form, racchiudi ogni placeholder tra virgolette doppie.

661 661

662<Tabs>662<Tabs>

663 <Tab title="Script del progetto">663 <Tab title="Project scripts">

664 Questo esempio utilizza `${CLAUDE_PROJECT_DIR}` per eseguire un controllo dello stile dalla directory `.claude/hooks/` del progetto dopo qualsiasi chiamata dello strumento `Write` o `Edit`:664 Questo esempio utilizza `${CLAUDE_PROJECT_DIR}` per eseguire un verificatore di stile dalla directory `.claude/hooks/` del progetto dopo qualsiasi chiamata dello strumento `Write` o `Edit`:

665 665

666 ```json theme={null}666 ```json theme={null}

667 {667 {

683 ```683 ```

684 </Tab>684 </Tab>

685 685

686 <Tab title="Script del plugin">686 <Tab title="Plugin scripts">

687 Definite i hook del plugin in `hooks/hooks.json` con un campo `description` facoltativo di livello superiore. Quando un plugin è abilitato, i suoi hook si uniscono ai hook dell'utente e del progetto.687 Definisci gli hook del plugin in `hooks/hooks.json` con un campo `description` opzionale di livello superiore. Quando un plugin è abilitato, i suoi hook si uniscono ai tuoi hook utente e progetto.

688 688

689 Questo esempio esegue uno script di formattazione fornito con il plugin:689 Questo esempio esegue uno script di formattazione raggruppato con il plugin:

690 690

691 ```json theme={null}691 ```json theme={null}

692 {692 {

709 }709 }

710 ```710 ```

711 711

712 Consultate il [plugin components reference](/docs/it/plugins-reference#hooks) per i dettagli sulla creazione dei hook del plugin.712 Vedi il [riferimento dei componenti del plugin](/docs/it/plugins-reference#hooks) per i dettagli sulla creazione degli hook del plugin.

713 </Tab>713 </Tab>

714</Tabs>714</Tabs>

715 715

716<h3 id="hooks-in-skills-and-agents">716<h3 id="hooks-in-skills-and-agents">

717 Hook in skills e agents717 Hook in skill e agenti

718</h3>718</h3>

719 719

720Oltre ai file di impostazioni e ai plugin, gli hook possono essere definiti direttamente in [skills](/docs/it/skills) e [subagents](/docs/it/sub-agents) utilizzando il frontmatter, nello stesso formato di configurazione dei hook basati su impostazioni. Per quanto tempo Claude Code li mantiene registrati dipende dal componente:720Oltre ai file di impostazioni e ai plugin, gli hook possono essere definiti direttamente negli [skill](/docs/it/skills) e nei [subagenti](/docs/it/sub-agents) utilizzando il frontmatter, nello stesso formato di configurazione degli hook basati su impostazioni. Per quanto tempo Claude Code li mantiene registrati dipende dal componente:

721 721

722* **Hook dei subagent**: Claude Code li esegue solo mentre quel subagent è in esecuzione e li rimuove quando termina. Claude Code converte un hook `Stop` qui in `SubagentStop`, l'evento che si attiva quando un subagent completa.722* **Hook del subagent**: Claude Code li esegue solo mentre quel subagent è in esecuzione e li rimuove quando finisce. Claude Code converte un hook `Stop` qui in `SubagentStop`, l'evento che si attiva quando un subagent si completa.

723* **Hook delle skill**: Claude Code li registra quando voi o Claude invocate la skill e continua a eseguirli per il resto della sessione, su turni dopo il turno della skill stessa. Per fare in modo che Claude Code rimuova un hook dopo la sua prima esecuzione riuscita, impostate [`once: true`](#common-fields) su di esso.723* **Hook dello skill**: Claude Code li registra quando tu o Claude invocate lo skill e continua a eseguirli per il resto della sessione, su turni dopo il turno dello skill stesso. Per fare in modo che Claude Code rimuova un hook dopo la sua prima esecuzione riuscita, imposta [`once: true`](#common-fields) su di esso.

724 724

725Questa skill definisce un hook `PreToolUse` che esegue uno script di convalida della sicurezza prima di ogni comando `Bash`:725Questo skill definisce un hook `PreToolUse` che esegue uno script di convalida della sicurezza prima di ogni comando `Bash`:

726 726

727```yaml theme={null}727```yaml theme={null}

728---728---

737---737---

738```738```

739 739

740I subagent utilizzano lo stesso formato nel loro frontmatter YAML.740I subagenti utilizzano lo stesso formato nel loro frontmatter YAML.

741 741

742Gli hook del frontmatter in una skill del progetto seguono la stessa [regola di fiducia dell'area di lavoro degli hook nei file di impostazioni](#workspace-trust). Claude Code li registra quando voi o Claude invocate la skill, incluso in un'esecuzione `-p` in una cartella che non avete ancora fidata.742Gli hook del frontmatter in uno skill del progetto seguono la stessa [regola di fiducia dell'area di lavoro degli hook nei file di impostazioni](#workspace-trust). Claude Code li registra quando tu o Claude invocate lo skill, incluso in un'esecuzione `-p` in una cartella che non hai ancora fidata.

743 743

744Gli hook del frontmatter in un subagent del progetto vengono eseguiti solo dopo che accettate la [finestra di dialogo di fiducia dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust) per la cartella da cui proviene il file dell'agente. Una sessione `-p` non conta come accettazione. [Cosa viene eseguito prima di fidarvi di una cartella](/docs/it/permissions#what-runs-before-you-trust-a-folder) confronta questo con la regola del file di impostazioni, e la pagina dei subagent elenca [quali ambiti sono esenti](/docs/it/sub-agents#hooks-in-subagent-frontmatter). Prima di v2.1.218, questi hook potevano essere eseguiti da cartelle che non avevate fidata.744Gli hook del frontmatter in un subagent del progetto vengono eseguiti solo dopo che accetti la [finestra di dialogo di fiducia dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust) per la cartella da cui proviene il file dell'agente. Una sessione `-p` non conta come accettazione. [Cosa viene eseguito prima di fidarti di una cartella](/docs/it/permissions#what-runs-before-you-trust-a-folder) confronta questo con la regola del file di impostazioni, e la pagina dei subagenti elenca [quali ambiti sono esenti](/docs/it/sub-agents#hooks-in-subagent-frontmatter). Prima di v2.1.218, questi hook potevano essere eseguiti da cartelle che non avevi fidata.

745 745

746<h3 id="the-/hooks-menu">746<h3 id="the-/hooks-menu">

747 Il menu `/hooks`747 Il menu `/hooks`

748</h3>748</h3>

749 749

750Digitate `/hooks` in Claude Code per aprire un browser di sola lettura per i vostri hook configurati. Il menu mostra ogni hook event con un conteggio dei hook configurati, vi consente di approfondire i matcher e mostra i dettagli completi di ogni gestore del hook. Utilizzatelo per verificare la configurazione, controllare da quale file di impostazioni proviene un hook o ispezionare il comando, il prompt o l'URL di un hook.750Digita `/hooks` in Claude Code per aprire un browser di sola lettura per i tuoi hook configurati. Il menu mostra ogni evento hook con un conteggio degli hook configurati, ti permette di approfondire i matcher, e mostra i dettagli completi di ogni handler hook. Usalo per verificare la configurazione, controllare da quale file di impostazioni proviene un hook, o ispezionare il comando, il prompt, o l'URL di un hook.

751 751

752Il menu visualizza tutti e cinque i tipi di hook: `command`, `prompt`, `agent`, `http` e `mcp_tool`. Ogni hook è etichettato con un prefisso `[type]` e una fonte che indica dove è stato definito:752Il menu visualizza tutti e cinque i tipi di hook: `command`, `prompt`, `agent`, `http`, e `mcp_tool`. Ogni hook è etichettato con un prefisso `[type]` e una fonte che indica dove è stato definito:

753 753

754* `User Settings`: da `~/.claude/settings.json`754* `User Settings`: da `~/.claude/settings.json`

755* `Project Settings`: da `.claude/settings.json`755* `Project Settings`: da `.claude/settings.json`

757* `Plugin Hooks`: da `hooks/hooks.json` di un plugin757* `Plugin Hooks`: da `hooks/hooks.json` di un plugin

758* `Session Hooks`: registrato in memoria per la sessione corrente758* `Session Hooks`: registrato in memoria per la sessione corrente

759 759

760Selezionando un hook si apre una vista dettagliata che mostra il suo evento, matcher, tipo, file di origine e il comando, il prompt o l'URL completo. Il menu è di sola lettura: per aggiungere, modificare o rimuovere gli hook, modificate il JSON delle impostazioni direttamente o chiedete a Claude di fare la modifica.760Selezionando un hook si apre una vista dettagliata che mostra il suo evento, matcher, tipo, file di origine, e il comando, prompt, o URL completo. Il menu è di sola lettura: per aggiungere, modificare, o rimuovere gli hook, modifica il JSON di impostazioni direttamente o chiedi a Claude di fare il cambiamento.

761 761

762<h3 id="disable-or-remove-hooks">762<h3 id="disable-or-remove-hooks">

763 Disabilitare o rimuovere i hook763 Disabilita o rimuovi gli hook

764</h3>764</h3>

765 765

766Per rimuovere un hook, eliminate la sua voce dal file di impostazioni JSON.766Per rimuovere un hook, elimina la sua voce dal file JSON di impostazioni.

767 767

768Per disabilitare temporaneamente tutti gli hook senza rimuoverli, impostate `"disableAllHooks": true` nel vostro file di impostazioni. Claude Code legge il valore rimasto dopo che la [precedenza delle impostazioni](/docs/it/settings#settings-precedence) si applica, quindi un `"disableAllHooks": false` nel `.claude/settings.json` di un progetto sostituisce un `true` nelle vostre impostazioni utente. Per disattivare gli hook per un'esecuzione qualunque cosa dicano le impostazioni del progetto, passate `--settings '{"disableAllHooks": true}'`, che ha la precedenza sulle impostazioni del progetto e locali. Non c'è modo di disabilitare un singolo hook mantenendolo nella configurazione.768Per disabilitare temporaneamente tutti gli hook senza rimuoverli, imposta `"disableAllHooks": true` nel tuo file di impostazioni. Claude Code legge il valore rimasto dopo che la [precedenza delle impostazioni](/docs/it/settings#settings-precedence) si applica, quindi un `"disableAllHooks": false` nel `.claude/settings.json` di un progetto sostituisce un `true` nelle tue impostazioni utente. Per disattivare gli hook per un'esecuzione qualunque siano le impostazioni del progetto, passa `--settings '{"disableAllHooks": true}'`, che ha la precedenza sulle impostazioni di progetto e locale. Non c'è modo di disabilitare un singolo hook mantenendolo nella configurazione.

769 769

770L'impostazione `disableAllHooks` rispetta la gerarchia delle impostazioni gestite. Se un amministratore ha configurato gli hook attraverso le impostazioni della politica gestita, `disableAllHooks` impostato nelle impostazioni dell'utente, del progetto o locali non può disabilitare quei hook gestiti. Solo `disableAllHooks` impostato a livello di impostazioni gestite può disabilitare gli hook gestiti. Per la portata completa di ogni livello, consultate [`disableAllHooks`](/docs/it/settings-reference#disableallhooks).770L'impostazione `disableAllHooks` rispetta la gerarchia delle impostazioni gestite. Se un amministratore ha configurato gli hook attraverso le impostazioni di policy gestite, `disableAllHooks` impostato nelle impostazioni utente, progetto, o locale non può disabilitare quegli hook gestiti. Solo `disableAllHooks` impostato a livello di impostazioni gestite può disabilitare gli hook gestiti. Per la portata completa di ogni livello, vedi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks).

771 771

772Le modifiche dirette ai hook nei file di impostazioni vengono normalmente acquisite automaticamente dal file watcher.772Le modifiche dirette agli hook nei file di impostazioni vengono normalmente rilevate automaticamente dal file watcher.

773 773

774<h2 id="hook-input-and-output">774<h2 id="hook-input-and-output">

775 Input e output del hook775 Input e output del hook

1436 UserPromptSubmit input1436 UserPromptSubmit input

1437</h4>1437</h4>

1438 1438

1439Oltre ai [common input fields](#common-input-fields), gli hook UserPromptSubmit ricevono il campo `prompt` contenente il testo che l'utente ha inviato.1439Oltre ai [common input fields](#common-input-fields), gli hook UserPromptSubmit ricevono il campo `prompt` contenente il testo che l'utente ha inviato. Il contenuto incollato che è crollato in un segnaposto `[Pasted text #N]` arriva espanso al suo posto. Nelle sessioni in cui Claude Code [contrassegna il testo incollato per Claude](/docs/it/terminal-config#how-claude-treats-pasted-text), quel contenuto espanso si trova tra una riga `<pasted_content id="…">` e una riga `</pasted_content id="…">`, quindi tieni conto di quelle righe se il tuo hook analizza il prompt.

1440 1440

1441```json theme={null}1441```json theme={null}

1442{1442{

2578 2578

2579Oltre ai [common input fields](#common-input-fields), gli hook SubagentStop ricevono `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path`, e `last_assistant_message`. Il campo `agent_type` è il valore usato per il filtraggio del matcher. Il `transcript_path` è la trascrizione della sessione principale, mentre `agent_transcript_path` è la trascrizione propria del subagent archiviata in una cartella `subagents/` annidato. Il campo `last_assistant_message` contiene il contenuto di testo della risposta finale del subagent, quindi gli hook possono accedervi senza analizzare il file della trascrizione.2579Oltre ai [common input fields](#common-input-fields), gli hook SubagentStop ricevono `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path`, e `last_assistant_message`. Il campo `agent_type` è il valore usato per il filtraggio del matcher. Il `transcript_path` è la trascrizione della sessione principale, mentre `agent_transcript_path` è la trascrizione propria del subagent archiviata in una cartella `subagents/` annidato. Il campo `last_assistant_message` contiene il contenuto di testo della risposta finale del subagent, quindi gli hook possono accedervi senza analizzare il file della trascrizione.

2580 2580

2581Non ogni evento SubagentStop proviene da un subagent che Claude ha generato. Claude Code esegue anche agenti interni per alcune delle sue stesse funzioni, come i [suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) e le [domande laterali `/btw`](/docs/it/interactive-mode#side-questions-with-%2Fbtw), e SubagentStop si attiva quando uno di quelli finisce anche. Per questi eventi, `agent_type` è il nome dell'agente che la sessione stessa esegue, come uno impostato con [`--agent`](/docs/it/cli-reference#cli-flags) o l'impostazione [`agent`](/docs/it/settings-reference#agent), e una stringa vuota quando la sessione si esegue senza uno.

2582

2583Un `matcher` che nomina i tipi di agente non corrisponde a un `agent_type` vuoto. Un hook il cui matcher è omesso, `""`, o `"*"`, o è un'espressione regolare che corrisponde a una stringa vuota, si esegue anche per gli eventi con un `agent_type` vuoto.

2584

2581Su Claude Code v2.1.271 o successivo, un subagent che si esegue con lo strumento [`SubagentHandback`](/docs/it/tools-reference) consegna il suo rapporto attraverso quello strumento prima che si fermi. Il campo `last_assistant_message` porta quindi il testo di chiusura del subagent, se presente, che non è il rapporto consegnato. Il rapporto è l'input `message` di quella chiamata, che un hook `PreToolUse` o `PostToolUse` abbinato su `SubagentHandback` riceve come `tool_input.message`.2585Su Claude Code v2.1.271 o successivo, un subagent che si esegue con lo strumento [`SubagentHandback`](/docs/it/tools-reference) consegna il suo rapporto attraverso quello strumento prima che si fermi. Il campo `last_assistant_message` porta quindi il testo di chiusura del subagent, se presente, che non è il rapporto consegnato. Il rapporto è l'input `message` di quella chiamata, che un hook `PreToolUse` o `PostToolUse` abbinato su `SubagentHandback` riceve come `tool_input.message`.

2582 2586

2583Gli hook SubagentStop ricevono anche gli array `background_tasks` e `session_crons` descritti sotto [Stop input](#stop-input). Entrambi gli array hanno ambito alla sessione genitore, non al subagent.2587Gli hook SubagentStop ricevono anche gli array `background_tasks` e `session_crons` descritti sotto [Stop input](#stop-input). Entrambi gli array hanno ambito alla sessione genitore, non al subagent.

2760Ogni voce in `session_crons` descrive un risveglio programmato con ambito di sessione, proveniente da `CronCreate`, `ScheduleWakeup`, e `/loop`:2764Ogni voce in `session_crons` descrive un risveglio programmato con ambito di sessione, proveniente da `CronCreate`, `ScheduleWakeup`, e `/loop`:

2761 2765

2762| Field | Description |2766| Field | Description |

2763| :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |2767| :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |

2764| `id` | Identificatore del compito cron |2768| `id` | Identificatore del compito cron |

2766| `recurring` | `false` per i risvegli una tantum il cui programma codifica un singolo tempo di attivazione, `true` per i compiti che si riattivano su ogni corrispondenza |2770| `recurring` | `false` per i risvegli una tantum il cui programma codifica un singolo tempo di att ivazione, `true` per i compiti che si riattivano su ogni corrispondenza |

2768 2772

2769Questo esempio mostra un input Stop con un compito shell in volo e un cron ricorrente:2773Questo esempio mostra un input Stop con un compito shell in volo e un cron ricorrente:

2801 Stop decision control2805 Stop decision control

2802</h4>2806</h4>

2803 2807

2804Gli hook `Stop` e `SubagentStop` possono controllare se Claude continua. Oltre ai [JSON output fields](#json-output) disponibili per tutti gli hook, il tuo script hook può rest ituire questi campi specifici dell'evento:2808Gli hook `Stop` e `SubagentStop` possono controllare se Claude continua. Oltre ai [JSON output fields](#json-output) disponibili per tutti gli hook, il tuo script hook può restituire questi campi specifici dell'evento:

2805 2809

2806| Field | Description |2810| Field | Description |

2807| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2811| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3756Gli eventi che supportano tutti e cinque i tipi di hook (`command`, `http`, `mcp_tool`, `prompt` e `agent`):3760Gli eventi che supportano tutti e cinque i tipi di hook (`command`, `http`, `mcp_tool`, `prompt` e `agent`):

3757 3761

3758* `PermissionDenied`3762* `PermissionDenied`

3759* `PermissionRequest`

3760* `PostToolBatch`3763* `PostToolBatch`

3761* `PostToolUse`3764* `PostToolUse`

3762* `PostToolUseFailure`3765* `PostToolUseFailure`

3769* `UserPromptExpansion`3772* `UserPromptExpansion`

3770* `UserPromptSubmit`3773* `UserPromptSubmit`

3771 3774

3775`PermissionRequest` supporta gli hook `command`, `http`, `mcp_tool` e `prompt` ma non gli hook `agent`. Se configuri un hook agent su questo evento, Claude Code lo salta e il flusso di autorizzazione procede invariato. Per consentire o negare da un hook, restituisci l'[oggetto decisione](#permissionrequest-decision-control) da un hook di comando o HTTP.

3776

3772Gli eventi che supportano gli hook `command`, `http` e `mcp_tool` ma non `prompt` o `agent`:3777Gli eventi che supportano gli hook `command`, `http` e `mcp_tool` ma non `prompt` o `agent`:

3773 3778

3774* `ConfigChange`3779* `ConfigChange`

3901 Gli hook agente sono sperimentali. Il comportamento e la configurazione potrebbero cambiare nelle versioni future. Per i flussi di lavoro in produzione, preferire gli [hook di comando](#command-hook-fields).3906 Gli hook agente sono sperimentali. Il comportamento e la configurazione potrebbero cambiare nelle versioni future. Per i flussi di lavoro in produzione, preferire gli [hook di comando](#command-hook-fields).

3902</Warning>3907</Warning>

3903 3908

3904Gli hook basati su agenti (`type: "agent"`) sono come gli hook basati su prompt ma con accesso agli strumenti multi-turno. Invece di una singola chiamata LLM, un hook agente genera un subagent che può leggere file, cercare codice e ispezionare il codebase per verificare le condizioni. Gli hook agente supportano gli stessi eventi degli hook basati su prompt.3909Gli hook basati su agenti (`type: "agent"`) sono come gli hook basati su prompt ma con accesso agli strumenti multi-turno. Invece di una singola chiamata LLM, un hook agente genera un subagent che può leggere file, cercare codice e ispezionare il codebase per verificare le condizioni. Gli hook agente supportano gli stessi eventi degli [hook basati su prompt](#prompt-based-hooks), ad eccezione di `PermissionRequest`.

3905 3910

3906<h3 id="how-agent-hooks-work">3911<h3 id="how-agent-hooks-work">

3907 Come funzionano gli hook basati su agenti3912 Come funzionano gli hook basati su agenti

how-claude-code-works.md +3 −3

Details

24 24

25Anche tu fai parte di questo ciclo. Puoi interrompere in qualsiasi momento per indirizzare Claude in una direzione diversa, fornire contesto aggiuntivo o chiedergli di provare un approccio diverso. Claude lavora autonomamente ma rimane reattivo al tuo input.25Anche tu fai parte di questo ciclo. Puoi interrompere in qualsiasi momento per indirizzare Claude in una direzione diversa, fornire contesto aggiuntivo o chiedergli di provare un approccio diverso. Claude lavora autonomamente ma rimane reattivo al tuo input.

26 26

27Il ciclo agentico è alimentato da due componenti: [modelli](#models) che ragionano e [strumenti](#tools) che agiscono. Claude Code funge da **harness agentico** intorno a Claude: fornisce gli strumenti, la gestione del contesto e l'ambiente di esecuzione che trasformano un modello di linguaggio in un agente di codifica capace.27Il ciclo agentico è alimentato da due componenti: [modelli](#models) che ragionano e [strumenti](#tools) che agiscono. Claude Code è il livello intorno al modello che fornisce gli strumenti e gestisce il contesto che il modello vede. Questo livello circostante è a cosa si riferisce il termine agentic harness.

28 28

29<h3 id="models">29<h3 id="models">

30 Modelli30 Modelli

238 Interrompi e indirizza238 Interrompi e indirizza

239</h4>239</h4>

240 240

241Puoi reindirizzare Claude in qualsiasi momento senza aspettare che il turno finisca o ricominciare da capo:241Puoi reindirizzare Claude in qualsiasi momento senza ricominciare da capo. Fai una di queste cose:

242 242

243* **Premi `Esc`** per fermare Claude immediatamente. La chiamata dello strumento in esecuzione viene annullata e Claude attende la tua prossima istruzione. Se hai messaggi in coda, Claude Code [li invia successivamente](/docs/it/interactive-mode#queue-messages-while-claude-works).243* **Premi `Esc`** per fermare Claude immediatamente. La chiamata dello strumento in esecuzione viene annullata e Claude attende la tua prossima istruzione. Se hai messaggi in coda, Claude Code [li invia successivamente](/docs/it/interactive-mode#queue-messages-while-claude-works).

244* **Digita una correzione e premi `Invio`** per inviarla senza fermare lo strumento in esecuzione. Claude la legge non appena l'azione corrente si completa e si adatta prima di decidere il suo prossimo passo.244* **Digita una correzione e premi `Invio`** senza fermare Claude. Il messaggio viene visualizzato come in coda sopra la casella di input. Se Claude sta eseguendo chiamate di strumenti, legge il messaggio non appena quelle chiamate si completano, nello stesso turno, e si adatta prima del suo prossimo passo. [Accoda messaggi mentre Claude lavora](/docs/it/interactive-mode#queue-messages-while-claude-works) copre quando altre voci in coda vengono inviate.

245 245

246<h3 id="delegate-don’t-dictate">246<h3 id="delegate-don’t-dictate">

247 Delega, non dettare247 Delega, non dettare

interactive-mode.md +13 −3

Details

24| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |24| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

25| `Ctrl+C` | Interrompi, o cancella l'input | Interrompe un'operazione in esecuzione. Se nulla è in esecuzione, il primo pressione cancella l'input del prompt e una seconda pressione esce da Claude Code |25| `Ctrl+C` | Interrompi, o cancella l'input | Interrompe un'operazione in esecuzione. Se nulla è in esecuzione, il primo pressione cancella l'input del prompt e una seconda pressione esce da Claude Code |

26| `Ctrl+X Ctrl+K` | Arresta tutti i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione. Premi due volte entro 3 secondi per confermare | Controllo subagent |26| `Ctrl+X Ctrl+K` | Arresta tutti i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione. Premi due volte entro 3 secondi per confermare | Controllo subagent |

27| `Ctrl+D` | Esci dalla sessione Claude Code | Il primo pressione mostra un suggerimento di conferma e un secondo pressione entro 800ms esce. Quando il prompt contiene testo, `Ctrl+D` elimina il carattere dopo il cursore |27| `Ctrl+D` | Esci dalla sessione Claude Code | Il primo pressione mostra un suggerimento di conferma e un secondo pressione entro 800ms esce. Quando il prompt contiene testo, `Ctrl+D` elimina il carattere dopo il cursore invece |

28| `Ctrl+G` o `Ctrl+X Ctrl+E` | Apri nell'editor di testo predefinito | Modifica il tuo prompt o la risposta personalizzata nell'editor di testo predefinito. `Ctrl+X Ctrl+E` è il binding nativo di readline. Attiva **Mostra l'ultima risposta nell'editor esterno** in `/config` per anteporre la risposta precedente di Claude come contesto commentato con `#` sopra il tuo prompt; Claude Code rimuove il blocco di commento quando salvi |28| `Ctrl+G` o `Ctrl+X Ctrl+E` | Apri nell'editor di testo predefinito | Modifica il tuo prompt o la risposta personalizzata nell'editor di testo predefinito. `Ctrl+X Ctrl+E` è il binding nativo di readline. Attiva **Mostra l'ultima risposta nell'editor esterno** in `/config` per anteporre la risposta precedente di Claude come contesto commentato con `#` sopra il tuo prompt; Claude Code rimuove il blocco di commento quando salvi |

29| `Ctrl+L` | Ridisegna o cancella lo schermo | Forza un ridisegno completo del terminale, mantenendo l'input e la cronologia della conversazione. Usa questo per recuperare se il display diventa distorto o parzialmente vuoto. Nel [rendering a schermo intero](/docs/it/fullscreen#clear-the-conversation), cancella anche lo schermo e puoi scorrere verso l'alto per vedere i messaggi precedenti |29| `Ctrl+L` | Ridisegna lo schermo | Forza un ridisegno completo del terminale, mantenendo l'input e la cronologia della conversazione. Usa questo per recuperare se il display diventa distorto o parzialmente vuoto. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per il rendering a schermo intero |

30| `Ctrl+O` | Attiva/disattiva il visualizzatore della trascrizione | Mostra l'utilizzo dettagliato degli strumenti e l'esecuzione, con un timestamp e il modello utilizzato su ogni messaggio dell'assistente. Espande anche le righe che si comprimono per impostazione predefinita, come le chiamate MCP, mostrate come una singola riga `Called slack 3 times`, e i [messaggi dalle tue altre sessioni](/docs/it/cross-session-messaging#what-a-message-looks-like), mostrati come un'anteprima `Message from @<sender>` su una riga |30| `Ctrl+O` | Attiva/disattiva il visualizzatore della trascrizione | Mostra l'utilizzo dettagliato degli strumenti e l'esecuzione, con un timestamp e il modello utilizzato su ogni messaggio dell'assistente. Espande anche le righe che si comprimono per impostazione predefinita, come le chiamate MCP, mostrate come una singola riga `Called slack 3 times`, e i [messaggi dalle tue altre sessioni](/docs/it/cross-session-messaging#what-a-message-looks-like), mostrati come un'anteprima `Message from @<sender>` su una riga |

32| `Ctrl+V` o `Cmd+V` (iTerm2) o `Alt+V` (Windows e WSL) | Incolla l'immagine dagli appunti | Inserisce un chip `[Image #N]` al cursore in modo da potervi fare riferimento posizionalmente nel tuo prompt. Su WSL, sia `Ctrl+V` che `Alt+V` sono associati; usa `Alt+V` se il tuo terminale intercetta `Ctrl+V` |32| `Ctrl+V` o `Cmd+V` (iTerm2) o `Alt+V` (Windows e WSL) | Incolla l'immagine dagli appunti | Inserisce un chip `[Image #N]` al cursore in modo da potervi fare riferimento posizionalmente nel tuo prompt. Su WSL, sia `Ctrl+V` che `Alt+V` sono associati; usa `Alt+V` se il tuo terminale intercetta `Ctrl+V` |

42| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Interrompe il turno corrente in modo che i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, escano subito invece di quando il turno termina. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando senza interrompere. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |42| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Interrompe il turno corrente in modo che i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, escano subito invece di quando il turno termina. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando senza interrompere. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |

43| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](/docs/it/permission-modes). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |43| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](/docs/it/permission-modes). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |

45| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il pensiero esteso | Abilita o disabilita la modalità di pensiero esteso. Non ha effetto su Fable 5.1 o Fable 5, che utilizzano sempre il pensiero esteso. Funziona su macOS senza configurare Option come Meta |45| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il pensiero esteso | Abilita o disabilita la modalità di pensiero esteso. Non ha effetto su Opus 5.5 o i modelli Fable, che utilizzano sempre il pensiero esteso. Funziona su macOS senza configurare Option come Meta |

47 47

48<h3 id="text-editing">48<h3 id="text-editing">

593 593

594Per scoprire quale di questi è accaduto, avvia `claude --debug` con il controllo ortografico attivo e digita una parola. Quindi cerca le righe `[spellcheck]` nel log di debug in `~/.claude/debug/<session-id>.txt`. Una riga nomina il programma che Claude Code ha avviato, o elenca quelli che ha cercato e non ha trovato. Le righe successive dicono perché ha smesso. Un errore di dizionario mancante lì significa che il checker non ha un dizionario per il tuo valore `language`, o nessuno predefinito quando `language` non è impostato. Installane uno, o imposta `language` a un dizionario che hai.594Per scoprire quale di questi è accaduto, avvia `claude --debug` con il controllo ortografico attivo e digita una parola. Quindi cerca le righe `[spellcheck]` nel log di debug in `~/.claude/debug/<session-id>.txt`. Una riga nomina il programma che Claude Code ha avviato, o elenca quelli che ha cercato e non ha trovato. Le righe successive dicono perché ha smesso. Un errore di dizionario mancante lì significa che il checker non ha un dizionario per il tuo valore `language`, o nessuno predefinito quando `language` non è impostato. Installane uno, o imposta `language` a un dizionario che hai.

595 595

596<h2 id="invisible-characters-in-prompts">

597 Caratteri invisibili nei prompt

598</h2>

599

600Il testo incollato può contenere caratteri Unicode che un terminale disegna come nulla, come caratteri di tag, controlli bidirezionali e spazi a larghezza zero, quindi un prompt può contenere testo che non vedete mai. Per evitare che il testo copiato contenga istruzioni che il terminale non disegna, Claude Code rimuove questi caratteri quando premete Invio, prima di inviare qualsiasi cosa. Pulisce sia il prompt che il contenuto di qualsiasi [riferimento di testo incollato](/docs/it/terminal-config#paste-large-content) che il prompt include. Claude Code mantiene i caratteri di unione che gli script persiani e indici scrivono e i selettori all'interno delle sequenze emoji.

601

602Se Claude Code ha rimosso qualcosa, quel tasto Invio non invia nulla. Il prompt pulito ritorna nella casella di input con un avviso come `Removed 3 invisible characters · review and press Enter to send`, e premendo Invio di nuovo si invia il testo come mostrato.

603

604Quando passate un prompt sulla riga di comando, come in `claude "fix the login bug"`, o ne incanalate uno in una sessione interattiva, Claude Code non aspetta un secondo Invio. Rimuove i caratteri, mostra un avviso e invia il prompt pulito. Se il prompt pulito inizierebbe con `/`, Claude Code lo mette nella casella di input affinché lo rivediate e lo inviate.

605

596<h2 id="review-changes-with-/diff">606<h2 id="review-changes-with-/diff">

597 Esamina le modifiche con /diff607 Esamina le modifiche con /diff

598</h2>608</h2>

keybindings.md +30 −4

Details

115| :-------------------- | :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |115| :-------------------- | :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |

119| `chat:killAgents` | Ctrl+X Ctrl+K | Termina tutti gli [agenti in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in esecuzione in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione |119| `chat:killAgents` | Ctrl+X Ctrl+K | Termina tutti gli [agenti in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in esecuzione in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione |

153 153

155| :---------------------- | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |155| :---------------------- | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

158| `confirm:previous` | Su | Opzione precedente |158| `confirm:previous` | Su | Opzione precedente |

159| `confirm:next` | Giù | Opzione successiva |159| `confirm:next` | Giù | Opzione successiva |

160| `confirm:nextField` | Tab | Campo successivo |160| `confirm:nextField` | Tab | Campo successivo |

166 166

167Prima della v2.1.257, un'azione `confirm:toggleExplanation`, associata a `Ctrl+E` per impostazione predefinita, mostrava una spiegazione generata dal modello del comando sui prompt di permesso Bash e PowerShell.167Prima della v2.1.257, un'azione `confirm:toggleExplanation`, associata a `Ctrl+E` per impostazione predefinita, mostrava una spiegazione generata dal modello del comando sui prompt di permesso Bash e PowerShell.

168 168

169I dialoghi utilizzano `confirm:yes` e `confirm:no` per accettare e annullare anche quando non pongono una domanda sì o no. Se associ una lettera semplice come `y` o `n` in questo contesto, la lettera agisce anche su dialoghi che non la mostrano mai come tasto. Un dialogo che mostra `y` e `n` come suoi tasti legge quelle lettere stesso e non ha bisogno di alcun binding.

170

171Questo esempio associa `y` a `confirm:yes` e `n` a `confirm:no`:

172

173```json theme={null}

174{

175 "bindings": [

176 {

177 "context": "Confirmation",

178 "bindings": {

179 "y": "confirm:yes",

180 "n": "confirm:no"

181 }

182 }

183 ]

184}

185```

186

187Prima della v2.1.280, `y` era anche associato a `confirm:yes` e `n` a `confirm:no` per impostazione predefinita. Se hai creato il tuo `keybindings.json` con `/keybindings` prima della v2.1.280, il file elenca entrambi i binding e rimangono in vigore finché non elimini quelle due righe.

188

169<h3 id="permission-actions">189<h3 id="permission-actions">

170 Azioni di permesso190 Azioni di permesso

171</h3>191</h3>

276| `footer:dismiss` | Backspace, Canc | Chiudi il collegamento [artefatto](/docs/it/artifacts) selezionato dal piè di pagina; l'artefatto pubblicato stesso non è interessato. Su altre righe del piè di pagina, questi tasti non hanno effetto. Richiede v2.1.217 o successiva |296| `footer:dismiss` | Backspace, Canc | Chiudi il collegamento [artefatto](/docs/it/artifacts) selezionato dal piè di pagina; l'artefatto pubblicato stesso non è interessato. Su altre righe del piè di pagina, questi tasti non hanno effetto. Richiede v2.1.217 o successiva |

277 297

298Mentre un elemento del piè di pagina è selezionato, come una riga nel pannello dell'agente sotto il prompt, `Invio` lo apre anche quando riassoci `Invio` nel contesto `Chat` a `chat:queueSubmit` o `chat:newline`.

299

300I binding `Chat` su tasti che il contesto `Footer` non associa, come `Shift+Tab` per `chat:cycleMode`, continuano a funzionare mentre un elemento è selezionato.

301

278<h3 id="message-selector-actions">302<h3 id="message-selector-actions">

279 Azioni del selezionatore di messaggi303 Azioni del selezionatore di messaggi

280</h3>304</h3>

372 396

373Claude Code applica i tuoi binding `select:pageUp`, `select:pageDown`, `select:first` e `select:last` nel menu `/skills`. Nella maggior parte degli altri elenchi, come il selezionatore `/model`, Claude Code pagina con PagSu e PagGiù indipendentemente dai tuoi binding e ignora Home e Fine.397Claude Code applica i tuoi binding `select:pageUp`, `select:pageDown`, `select:first` e `select:last` nel menu `/skills`. Nella maggior parte degli altri elenchi, come il selezionatore `/model`, i tuoi binding `select:first` e `select:last` si applicano. PagSu e PagGiù scorrono le opzioni in quegli elenchi indipendentemente dai tuoi binding.

398

399Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e i tuoi binding `select:first` e `select:last`.

374 400

375<h3 id="plugin-actions">401<h3 id="plugin-actions">

376 Azioni dei plugin402 Azioni dei plugin

large-codebases.md +1 −1

Details

255 255

256Questo è particolarmente utile per [l'isolamento del worktree del subagent](/docs/it/worktrees#isolate-subagents-with-worktrees). I subagent sono istanze Claude parallele generate per sottocompiti, e ognuno che viene eseguito in un worktree ottiene un checkout leggero invece dell'albero completo. Tutti i worktrees in una sessione condividono lo stesso `sparsePaths`, quindi se un subagent ha bisogno di `packages/api/` e un altro ha bisogno di `packages/web/`, elencali entrambi.256Questo è particolarmente utile per [l'isolamento del worktree del subagent](/docs/it/worktrees#isolate-subagents-with-worktrees). I subagent sono istanze Claude parallele generate per sottocompiti, e ognuno che viene eseguito in un worktree ottiene un checkout leggero invece dell'albero completo. Tutti i worktrees in una sessione condividono lo stesso `sparsePaths`, quindi se un subagent ha bisogno di `packages/api/` e un altro ha bisogno di `packages/web/`, elencali entrambi.

257 257

258Elenca le directory in `sparsePaths`, non i singoli file. I file a livello di radice come `package.json`, `tsconfig.base.json` e i file di lock vengono sempre controllati insieme alle directory che elenchi. Le directory a livello di radice non lo sono, quindi includi `.claude` nell'elenco se vuoi che il `.claude/settings.json`, `.claude/rules/` o `.claude/skills/` della radice del repository siano disponibili dentro il worktree.258Elenca le directory in `sparsePaths`, non i singoli file. I file a livello di radice come `package.json`, `tsconfig.base.json` e i file di lock vengono sempre controllati insieme alle directory che elenchi. Le directory a livello di radice non lo sono, quindi includi `.claude` nell'elenco se vuoi che il `.claude/settings.json` della radice del repository, `.claude/rules/` e le skills siano disponibili dentro il worktree. Per skills di progetto, agenti e comandi, vedi [Cosa i worktrees condividono con il checkout principale](/docs/it/worktrees#what-worktrees-share-with-the-main-checkout).

259 259

260Sparse checkout richiede a git di abilitare `extensions.worktreeConfig` nel `.git/config` condiviso del repository mentre esiste un worktree sparse. Claude Code rimuove quella voce dopo che l'ultimo worktree viene rimosso, ma solo se Claude Code l'ha aggiunta. Non rimuove mai un valore che hai impostato tu stesso. Prima della v2.1.207, la voce rimaneva dopo che l'ultimo worktree veniva rimosso, e gli strumenti basati su go-git come `tea` non riuscivano ad aprire il repository finché non eseguivi `git config --unset extensions.worktreeConfig`.260Sparse checkout richiede a git di abilitare `extensions.worktreeConfig` nel `.git/config` condiviso del repository mentre esiste un worktree sparse. Claude Code rimuove quella voce dopo che l'ultimo worktree viene rimosso, ma solo se Claude Code l'ha aggiunta. Non rimuove mai un valore che hai impostato tu stesso. Prima della v2.1.207, la voce rimaneva dopo che l'ultimo worktree veniva rimosso, e gli strumenti basati su go-git come `tea` non riuscivano ad aprire il repository finché non eseguivi `git config --unset extensions.worktreeConfig`.

261 261

llm-gateway-connect.md +2 −1

Details

578Questi sono gli errori più comuni quando si esegue Claude Code attraverso un gateway, con la causa dal lato del gateway e la correzione:578Questi sono gli errori più comuni quando si esegue Claude Code attraverso un gateway, con la causa dal lato del gateway e la correzione:

579 579

581| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |581| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

582| Un avviso di avvio che nomina due fonti di credenziale e termina con `auth may not work as expected`. Le versioni più vecchie mostrano `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` invece. | Una credenziale del gateway e un accesso salvato sono entrambi attivi; la variabile viene utilizzata per le richieste, ma l'accesso stantio può causare un comportamento di autenticazione inaspettato | Annulla l'impostazione della variabile per usare l'accesso salvato, o esegui `/logout` per usare la credenziale del gateway |582| Un avviso di avvio che nomina due fonti di credenziale e termina con `auth may not work as expected`. Le versioni più vecchie mostrano `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` invece. | Una credenziale del gateway e un accesso salvato sono entrambi attivi; la variabile viene utilizzata per le richieste, ma l'accesso stantio può causare un comportamento di autenticazione inaspettato | Annulla l'impostazione della variabile per usare l'accesso salvato, o esegui `/logout` per usare la credenziale del gateway |

583| Errori `401` che nominano un token non valido o non riconosciuto | La credenziale non è una che il gateway ha emesso, o è in un'intestazione che il gateway non legge | Conferma che la variabile corrisponde al tuo tipo di credenziale nella [tabella di credenziale](#set-the-credential-variable), e rigenera la chiave al gateway se è stata revocata |583| Errori `401` che nominano un token non valido o non riconosciuto | La credenziale non è una che il gateway ha emesso, o è in un'intestazione che il gateway non legge | Conferma che la variabile corrisponde al tuo tipo di credenziale nella [tabella di credenziale](#set-the-credential-variable), e rigenera la chiave al gateway se è stata revocata |

584| `Your apiKeyHelper script is failing`, o `apiKeyHelper failed:` su stderr in modalità non interattiva | Il comando nell'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) non ha prodotto una chiave utilizzabile, quindi le richieste portano una chiave segnaposto | Esegui il comando direttamente per vedere perché fallisce, e ri-autentica con il tuo provider di credenziali se segnala una sessione scaduta; vedi [il riferimento dell'errore](/docs/it/errors#your-apikeyhelper-script-is-failing) |584| `Your apiKeyHelper script is failing`, o `apiKeyHelper failed:` su stderr in modalità non interattiva | Il comando nell'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) non ha prodotto una chiave utilizzabile, quindi le richieste portano una chiave segnaposto | Esegui il comando direttamente per vedere perché fallisce, e ri-autentica con il tuo provider di credenziali se segnala una sessione scaduta; vedi [il riferimento dell'errore](/docs/it/errors#your-apikeyhelper-script-is-failing) |

588| Errori `400` che nominano `thinking` o `adaptive`, come `Input tag 'adaptive' found` | La build del modello upstream non accetta il ragionamento adattivo, che Claude Code richiede per i modelli Claude 4.6 e successivi | Aggiorna l'upstream del gateway. Su Opus 4.6 e Sonnet 4.6, `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` funziona invece. Le variabili di capacità della [configurazione del modello](/docs/it/model-config) si applicano solo alle configurazioni del provider, come `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, non dietro un gateway `ANTHROPIC_BASE_URL` |588| Errori `400` che nominano `thinking` o `adaptive`, come `Input tag 'adaptive' found` | La build del modello upstream non accetta il ragionamento adattivo, che Claude Code richiede per i modelli Claude 4.6 e successivi | Aggiorna l'upstream del gateway. Su Opus 4.6 e Sonnet 4.6, `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` funziona invece. Le variabili di capacità della [configurazione del modello](/docs/it/model-config) si applicano solo alle configurazioni del provider, come `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, non dietro un gateway `ANTHROPIC_BASE_URL` |

589| Errori `400` che indicano un contesto o limite di token nelle parole del gateway stesso, come `ContextWindowExceededError` o `prompt token count of N exceeds the limit of M` | Il gateway applica un contesto più piccolo della finestra nativa del modello e riscrive l'errore upstream, quindi Claude Code non lo riconosce come un [errore troppo lungo](/docs/it/errors#prompt-is-too-long) e non compatta e riprova automaticamente | Esegui `/compact` per recuperare la sessione. Per prevenirlo, imposta `CLAUDE_CODE_AUTO_COMPACT_WINDOW` al limite del gateway; Claude Code blocca il valore ad almeno 100.000 token e al massimo la finestra di contesto del modello, quindi non puoi abbinare un limite del gateway inferiore a 100.000, e `/compact` rimane il recupero lì. Imposta anche `CLAUDE_CODE_MAX_OUTPUT_TOKENS` sotto il limite di output del modello del gateway |589| Errori `400` che indicano un contesto o limite di token nelle parole del gateway stesso, come `ContextWindowExceededError` o `prompt token count of N exceeds the limit of M` | Il gateway applica un contesto più piccolo della finestra nativa del modello e riscrive l'errore upstream, quindi Claude Code non lo riconosce come un [errore troppo lungo](/docs/it/errors#prompt-is-too-long) e non compatta e riprova automaticamente | Esegui `/compact` per recuperare la sessione. Per prevenirlo, imposta `CLAUDE_CODE_AUTO_COMPACT_WINDOW` al limite del gateway; Claude Code blocca il valore ad almeno 100.000 token e al massimo la finestra di contesto del modello, quindi non puoi abbinare un limite del gateway inferiore a 100.000, e `/compact` rimane il recupero lì. Imposta anche `CLAUDE_CODE_MAX_OUTPUT_TOKENS` sotto il limite di output del modello del gateway |

590| Errori `400` su ogni richiesta, nelle parole del gateway stesso che rifiutano lo schema di input di uno strumento o il suo `pattern`, su Claude Code v2.1.265 attraverso v2.1.267 | In un rollout graduale su quelle versioni, lo schema dello [strumento Artifact](/docs/it/artifacts#availability) contiene un'espressione regolare con classi di caratteri Unicode `\p{...}`. L'API Anthropic l'accetta, ma un gateway o upstream che controlla il `pattern` dello schema di ogni strumento con il proprio motore regex rifiuta l'intera richiesta | Aggiorna a v2.1.268 o successivo, che non invia l'espressione regolare. Su una versione interessata, [disattiva gli artifact](/docs/it/artifacts#disable-artifacts), che rimuove lo strumento e il suo schema dalle richieste |590| Errori `400` su ogni richiesta, nelle parole del gateway stesso che rifiutano lo schema di input di uno strumento o il suo `pattern`, su Claude Code v2.1.265 attraverso v2.1.267 | In un rollout graduale su quelle versioni, lo schema dello [strumento Artifact](/docs/it/artifacts#availability) contiene un'espressione regolare con classi di caratteri Unicode `\p{...}`. L'API Anthropic l'accetta, ma un gateway o upstream che controlla il `pattern` dello schema di ogni strumento con il proprio motore regex rifiuta l'intera richiesta | Aggiorna a v2.1.268 o successivo, che non invia l'espressione regolare. Su una versione interessata, [disattiva gli artifact](/docs/it/artifacts#disable-artifacts), che rimuove lo strumento e il suo schema dalle richieste |

591| Errori `400` su ogni richiesta, nelle parole del gateway stesso che rifiutano un tipo di strumento non riconosciuto, come `Input tag 'advisor_20260301'`, su Claude Code v2.1.275 | In un rollout graduale su quella versione, le richieste portano una voce dello [strumento advisor](/docs/it/advisor) anche con l'advisor disattivato. L'API Anthropic l'accetta, ma un gateway o upstream che convalida i tipi di strumento rifiuta l'intera richiesta; uno che [invia i campi del corpo della richiesta invariati](/docs/it/llm-gateway-protocol#forward-as-open-lists) lo passa attraverso senza effetti. La voce è una dichiarazione che non porta alcun contenuto di conversazione | Aggiorna a v2.1.276 o successivo, che non invia la voce dietro un gateway `ANTHROPIC_BASE_URL` a meno che tu non attivi l'advisor. Su v2.1.275, imposta [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](/docs/it/env-vars), che rimuove la voce dalle richieste |

591| Modelli mancanti dal selettore `/model` | I nomi dei modelli del gateway non sono nell'elenco integrato di Claude Code, o Claude Code sta mostrando un [`modelPicker`](/docs/it/settings-reference#modelpicker) che sostituisce le opzioni integrate | Abilita la [scoperta di modelli del gateway](#add-gateway-models-to-the-model-picker) o aggiungi nomi con le variabili della [configurazione del modello](/docs/it/model-config). Se Claude Code mostra un `modelPicker` che sostituisce, aggiungi i modelli del gateway ad esso, o chiedi al tuo amministratore di aggiungerli quando le impostazioni gestite lo forniscono |592| Modelli mancanti dal selettore `/model` | I nomi dei modelli del gateway non sono nell'elenco integrato di Claude Code, o Claude Code sta mostrando un [`modelPicker`](/docs/it/settings-reference#modelpicker) che sostituisce le opzioni integrate | Abilita la [scoperta di modelli del gateway](#add-gateway-models-to-the-model-picker) o aggiungi nomi con le variabili della [configurazione del modello](/docs/it/model-config). Se Claude Code mostra un `modelPicker` che sostituisce, aggiungi i modelli del gateway ad esso, o chiedi al tuo amministratore di aggiungerli quando le impostazioni gestite lo forniscono |

592| `/fast` segnala `Fast mode unavailable due to network connectivity issues` mentre le richieste di inferenza funzionano | Il controllo di disponibilità della [modalità veloce](/docs/it/fast-mode) va direttamente a `api.anthropic.com` e non segue `ANTHROPIC_BASE_URL`, quindi l'uscita diretta bloccata fallisce il controllo. Lo stesso messaggio appare su una rete aperta quando il controllo presenta una chiave emessa dal gateway da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` e Anthropic la rifiuta | Consenti `api.anthropic.com` se l'uscita è bloccata, o imposta una variabile di salto; per una chiave del gateway rifiutata solo le variabili di salto aiutano. Vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |593| `/fast` segnala `Fast mode unavailable due to network connectivity issues` mentre le richieste di inferenza funzionano | Il controllo di disponibilità della [modalità veloce](/docs/it/fast-mode) va direttamente a `api.anthropic.com` e non segue `ANTHROPIC_BASE_URL`, quindi l'uscita diretta bloccata fallisce il controllo. Lo stesso messaggio appare su una rete aperta quando il controllo presenta una chiave emessa dal gateway da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` e Anthropic la rifiuta | Consenti `api.anthropic.com` se l'uscita è bloccata, o imposta una variabile di salto; per una chiave del gateway rifiutata solo le variabili di salto aiutano. Vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

593| `/fast` segnala `Fast mode has been disabled by your organization` in una sessione autenticata con `ANTHROPIC_AUTH_TOKEN`, anche se l'organizzazione ha la modalità veloce abilitata | Il controllo di disponibilità richiede un accesso claude.ai o una chiave API Anthropic; con solo un token bearer, Claude Code tratta la modalità veloce come disabilitata senza inviare il controllo | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |594| `/fast` segnala `Fast mode has been disabled by your organization` in una sessione autenticata con `ANTHROPIC_AUTH_TOKEN`, anche se l'organizzazione ha la modalità veloce abilitata | Il controllo di disponibilità richiede un accesso claude.ai o una chiave API Anthropic; con solo un token bearer, Claude Code tratta la modalità veloce come disabilitata senza inviare il controllo | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

llm-gateway-protocol.md +34 −0

Details

144 144

145Se i vostri sviluppatori impostano `ANTHROPIC_CUSTOM_HEADERS`, quelle intestazioni appaiono anche sulle richieste.145Se i vostri sviluppatori impostano `ANTHROPIC_CUSTOM_HEADERS`, quelle intestazioni appaiono anche sulle richieste.

146 146

147<h3 id="gateway-hint-headers">

148 Intestazioni di suggerimento del gateway

149</h3>

150

151Claude Code può anche inviare suggerimenti di routing: fatti per richiesta che un gateway o router può utilizzare per pianificare, memorizzare nella cache o attribuire una richiesta. Richiede Claude Code v2.1.273 o successivo.

152

153Se una richiesta li porta dipende da dove Claude Code li invia:

154

155* Connessione diretta all'API Anthropic: inviati per impostazione predefinita

156* URL di base personalizzato: disattivato per impostazione predefinita, perché un proxy che rifiuta intestazioni sconosciute farebbe fallire la richiesta. Per riceverli, impostare [`CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`](/docs/it/env-vars) per i vostri sviluppatori, ad esempio nel blocco `env` delle [impostazioni gestite](/docs/it/managed-settings)

157* Qualsiasi altro backend, inclusi Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e Claude Platform on AWS: inviati solo quando `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1` è impostato

158

159Impostare `CLAUDE_CODE_GATEWAY_HINT_HEADERS` su `0` interrompe le intestazioni su ogni connessione.

160

161Le intestazioni portano solo ciò che le righe sottostanti elencano: vocabolari fissi, nomi di strumenti e durate, mai testo del prompt o contenuti di file. Ogni valore è ASCII stampabile.

162

163| Intestazione | Descrizione |

164| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

165| `x-claude-code-request-class` | Che tipo di richiesta è questa: `main` per un turno della conversazione principale, `subagent` per un turno di un [subagent](/docs/it/sub-agents), `workflow` per un agente in esecuzione all'interno di un flusso di lavoro, `compaction` per la richiesta di riepilogo che compatta una conversazione, o `auxiliary` per richieste laterali come titoli di sessione, classificatori e riepiloghi. Inviato su ogni richiesta |

166| `x-claude-code-agent-type` | Il tipo di subagent che ha emesso la richiesta: un nome di tipo di agente integrato come `Explore`, `Plan` o `general-purpose`, o `custom` per un agente definito dall'utente, `teammate` per un membro del [team di agenti](/docs/it/agent-teams) in esecuzione nel processo del leader, o `fork` per un [fork](/docs/it/sub-agents#fork-the-current-conversation). Presente solo sui turni propri di un subagent; la compattazione o le richieste laterali di un subagent mantengono l'ID dell'agente ma non portano alcun tipo. Un nome di agente scelto dall'utente non viene mai inviato |

167| `x-claude-code-compaction` | Presente sulla richiesta che riepiloga la conversazione durante una [compattazione](/docs/it/prompt-caching#compacting-the-conversation). Il valore dice cosa l'ha attivata: `auto` quando la finestra di contesto si avvicinava alla capacità, `manual` per `/compact`, o `reactive` quando l'API ha rifiutato una richiesta come troppo lunga. Assente su ogni altra richiesta |

168| `x-claude-code-context-compacted` | Presente una volta, sulla prima richiesta di conversazione principale dopo una compattazione, con gli stessi valori di `x-claude-code-compaction`. Il prefisso della conversazione prima di questa richiesta non viene più utilizzato, quindi una cache basata su di esso può essere eliminata |

169| `x-claude-code-prev-tool-durations` | Tempo di esecuzione misurato delle chiamate di strumento i cui risultati questa richiesta porta, come `<name>=<ms>;<name>=<ms>`, ad esempio `Bash=742;Read=9`. Inviato sulla richiesta successiva della stessa conversazione dopo un batch di chiamate di strumento, dalla sessione principale o da un subagent |

170

171Prima di analizzare `x-claude-code-prev-tool-durations`, controllare come Claude Code costruisce il valore e cosa lascia fuori:

172

173* Voci: una per ogni chiamata di strumento che è stata eseguita, nell'ordine in cui il suo risultato è stato raccolto, in millisecondi interi

174* Limite: Claude Code invia al massimo 32 voci e 4 KB, mantenendo le prime voci

175* Codifica: i nomi degli strumenti sono codificati in percentuale, coprendo `%`, `;`, `=`, virgola, spazio e qualsiasi carattere al di fuori di ASCII stampabile

176* Analisi: dividere su `;`, quindi su `=`, e decodificare ogni nome

177* Assenza: le chiamate di compattazione, le richieste laterali e la prima richiesta di un nuovo prompt non la portano mai. Non leggere un'intestazione mancante come un turno che non ha eseguito alcuno strumento

178* Tempi: ognuno esclude i prompt di autorizzazione e gli hook, e le chiamate di strumento parallele ciascuna segnalano il proprio tempo, quindi le voci non si sommano al divario tra le richieste

179

147<h3 id="forward-as-open-lists">180<h3 id="forward-as-open-lists">

148 Inoltrare come elenchi aperti181 Inoltrare come elenchi aperti

149</h3>182</h3>

221 254

222* Quando l'upstream rifiuta il campo `thinking`, un messaggio di sistema a metà conversazione, o il marcatore `cache_control` su tale messaggio, Claude Code ritenta la richiesta e disabilita la capacità rifiutata per il resto della conversazione255* Quando l'upstream rifiuta il campo `thinking`, un messaggio di sistema a metà conversazione, o il marcatore `cache_control` su tale messaggio, Claude Code ritenta la richiesta e disabilita la capacità rifiutata per il resto della conversazione

223* Quando l'upstream rifiuta una [thinking signature](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), incluso con un `400` il cui messaggio dice che il blocco è `bound to a different conversation`, Claude Code rimuove i blocchi di pensiero precedenti dalla richiesta, ritenta, e li mantiene fuori da ogni richiesta successiva. Le nuove risposte includono ancora il pensiero256* Quando l'upstream rifiuta una [thinking signature](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), incluso con un `400` il cui messaggio dice che il blocco è `bound to a different conversation`, Claude Code rimuove i blocchi di pensiero precedenti dalla richiesta, ritenta, e li mantiene fuori da ogni richiesta successiva. Le nuove risposte includono ancora il pensiero

257* Quando il gateway o il suo upstream rifiuta la voce dello [strumento advisor](/docs/it/advisor) in `tools` come tipo di strumento non riconosciuto, Claude Code ritenta la richiesta una volta senza quella voce e il suo valore `anthropic-beta`. Le richieste successive a quell'URL di base lasciano l'advisor fuori fino a quando Claude Code esce, e `/advisor` non è disponibile allo sviluppatore per quel tempo. Claude Code riconosce questo rifiuto da una risposta `400` o `422` il cui messaggio nomina il tipo di strumento dopo `Input tag`, come `Input tag 'advisor_20260301'`. Prima della v2.1.280, Claude Code non ritentava questo rifiuto

224* Claude Code non ritenta i rifiuti di gestione del contesto o di campi dello schema dello strumento, quindi quegli errori `400` raggiungono lo sviluppatore258* Claude Code non ritenta i rifiuti di gestione del contesto o di campi dello schema dello strumento, quindi quegli errori `400` raggiungono lo sviluppatore

225 259

226Il rifiuto `bound to a different conversation` proviene dal controllo [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) dell'API, che fallisce quando il contenuto di `system`, `tools`, o precedenti `messages` differisce dalla richiesta che ha prodotto il pensiero. Un gateway che riscrive uno qualsiasi di quel contenuto può causare il rifiuto stesso; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) copre ciò che passare attraverso invariato.260Il rifiuto `bound to a different conversation` proviene dal controllo [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) dell'API, che fallisce quando il contenuto di `system`, `tools`, o precedenti `messages` differisce dalla richiesta che ha prodotto il pensiero. Un gateway che riscrive uno qualsiasi di quel contenuto può causare il rifiuto stesso; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) copre ciò che passare attraverso invariato.

llm-gateway-rollout.md +1 −0

Details

185| `apiKeyHelper`, o una credenziale in `ANTHROPIC_AUTH_TOKEN` o `ANTHROPIC_API_KEY` | Autentica ogni richiesta al gateway. L'helper esegue un comando per recuperare la chiave; le variabili contengono una chiave statica, inviata come `Authorization: Bearer` e `x-api-key` rispettivamente | Sempre; uno dei tre |185| `apiKeyHelper`, o una credenziale in `ANTHROPIC_AUTH_TOKEN` o `ANTHROPIC_API_KEY` | Autentica ogni richiesta al gateway. L'helper esegue un comando per recuperare la chiave; le variabili contengono una chiave statica, inviata come `Authorization: Bearer` e `x-api-key` rispettivamente | Sempre; uno dei tre |

186| `ANTHROPIC_CUSTOM_HEADERS` | Aggiunge intestazioni HTTP extra a ogni richiesta API | Il vostro gateway richiede un'intestazione tenant o di instradamento su ogni richiesta |186| `ANTHROPIC_CUSTOM_HEADERS` | Aggiunge intestazioni HTTP extra a ogni richiesta API | Il vostro gateway richiede un'intestazione tenant o di instradamento su ogni richiesta |

187| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Invia le [intestazioni hint del gateway](/docs/it/llm-gateway-protocol#gateway-hint-headers), che classificano ogni richiesta per decisioni di instradamento e pianificazione al gateway. Richiede Claude Code v2.1.273 o successivo | Il vostro gateway legge le intestazioni hint |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Interroga il `/v1/models` del gateway all'avvio e aggiunge i nomi restituiti al selettore `/model` | Il vostro gateway serve `/v1/models` e volete che i selettori degli sviluppatori siano popolati da esso |188| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Interroga il `/v1/models` del gateway all'avvio e aggiunge i nomi restituiti al selettore `/model` | Il vostro gateway serve `/v1/models` e volete che i selettori degli sviluppatori siano popolati da esso |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Impedisce a Claude Code di inviare intestazioni di capacità pre-release e campi del corpo. [Disabilitare le capacità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) copre l'ambito esatto | Il vostro gateway inoltra a un upstream Amazon Bedrock o Google Cloud's Agent Platform che rifiuta i campi beta. Vedere [Requisiti del gateway](#gateway-requirements) |189| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Impedisce a Claude Code di inviare intestazioni di capacità pre-release e campi del corpo. [Disabilitare le capacità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) copre l'ambito esatto | Il vostro gateway inoltra a un upstream Amazon Bedrock o Google Cloud's Agent Platform che rifiuta i campi beta. Vedere [Requisiti del gateway](#gateway-requirements) |

189| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` o `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Ripristina [fast mode](/docs/it/fast-mode) quando il suo controllo di disponibilità, che chiama `api.anthropic.com` direttamente piuttosto che seguire `ANTHROPIC_BASE_URL`, fallisce, è intercettato, o è saltato per mancanza di una credenziale Anthropic | La vostra organizzazione usa fast mode, e gli sviluppatori si autenticano con `ANTHROPIC_AUTH_TOKEN` solo, con una chiave emessa dal gateway in `ANTHROPIC_API_KEY` o da un `apiKeyHelper`, o la vostra rete blocca o intercetta le richieste dirette a `api.anthropic.com`; [usare fast mode dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) copre quale delle due variabili corrisponde alla vostra configurazione |190| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` o `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Ripristina [fast mode](/docs/it/fast-mode) quando il suo controllo di disponibilità, che chiama `api.anthropic.com` direttamente piuttosto che seguire `ANTHROPIC_BASE_URL`, fallisce, è intercettato, o è saltato per mancanza di una credenziale Anthropic | La vostra organizzazione usa fast mode, e gli sviluppatori si autenticano con `ANTHROPIC_AUTH_TOKEN` solo, con una chiave emessa dal gateway in `ANTHROPIC_API_KEY` o da un `apiKeyHelper`, o la vostra rete blocca o intercetta le richieste dirette a `api.anthropic.com`; [usare fast mode dietro proxy e gateway LLM](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) copre quale delle due variabili corrisponde alla vostra configurazione |

managed-settings.md +8 −2

Details

361Poche chiavi di applicazione non vengono eliminate quando non valide. Claude Code applica un fallback più restrittivo fino a quando il valore non viene corretto; la tabella mostra cosa applica per ogni chiave:361Poche chiavi di applicazione non vengono eliminate quando non valide. Claude Code applica un fallback più restrittivo fino a quando il valore non viene corretto; la tabella mostra cosa applica per ogni chiave:

362 362

364| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |364| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

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

369| `strictKnownMarketplaces` | Applicato come un allowlist vuoto fino a quando il valore non viene corretto, quindi nessuna [fonte marketplace](/docs/it/plugin-marketplaces#managed-marketplace-restrictions) 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. |

369| `allowManagedHooksOnly` | Trattato come `true` fino a quando non viene corretto: le [restrizioni hook](/docs/it/settings-reference#allowmanagedhooksonly) si applicano e, a meno che `disableCommandPluginSources` non sia esplicitamente `false`, i plugin sourced da comando sono disabilitati. |370| `allowManagedHooksOnly` | Trattato come `true` fino a quando non viene corretto: le [restrizioni hook](/docs/it/settings-reference#allowmanagedhooksonly) si applicano e, a meno che `disableCommandPluginSources` non sia esplicitamente `false`, i plugin sourced da comando sono disabilitati. |

371| `disableCommandPluginSources` | Trattato come `true`, quindi i plugin sourced da comando rimangono disabilitati fino a quando il valore non viene corretto. |372| `disableCommandPluginSources` | Trattato come `true`, quindi i plugin sourced da comando rimangono disabilitati fino a quando il valore non viene corretto. |

373| `disableSideloadFlags` | Trattato come `true` fino a quando il valore non viene corretto, con gli effetti elencati per [`disableSideloadFlags`](/docs/it/settings-reference#disablesideloadflags). |

372| `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. |374| `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. |

376| `syncClaudeAiPlugins` | Trattato come `false`, quindi la sincronizzazione dei [plugin claude.ai](/docs/it/settings-reference#syncclaudeaiplugins) è disattivata fino a quando il valore non viene corretto. |

375| `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. |378| `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. |

376| `crossSessionInbound` | Trattato come `refuse`, il valore più restrittivo, quindi i [messaggi cross-session](/docs/it/cross-session-messaging#control-inbound-messages) in entrata vengono rifiutati fino a quando il valore non viene corretto. Lo sviluppatore vede [un avviso](/docs/it/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |379| `crossSessionInbound` | Trattato come `refuse`, il valore più restrittivo, quindi i [messaggi cross-session](/docs/it/cross-session-messaging#control-inbound-messages) in entrata vengono rifiutati fino a quando il valore non viene corretto. Lo sviluppatore vede [un avviso](/docs/it/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

377| `deniedMcpServers` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Un valore completamente non valido viene eliminato con un avviso, poiché negare ogni server bloccherebbe i server che la policy non ha mai nominato. |380| `deniedMcpServers` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Un valore completamente non valido viene eliminato con un avviso, poiché negare ogni server bloccherebbe i server che la policy non ha mai nominato. |

381| `blockedMarketplaces` | Una voce non valida individuale viene rimossa e il sottoinsieme valido viene applicato. Una voce che si analizza ma non può mai corrispondere, come una regex `hostPattern` che non si compila, viene mantenuta con un avviso. Non blocca nulla fino a quando non viene corretto, ma le [restrizioni marketplace](/docs/it/plugin-marketplaces#managed-marketplace-restrictions) rimangono attive. Un valore completamente non valido viene eliminato con un avviso, poiché bloccare ogni marketplace bloccherebbe le fonti che la policy non ha mai nominato. |

378| `sandbox.credentials` | Una voce non valida recuperabile viene degradata a `mode: "deny"` con un avviso; una non recuperabile viene rimossa; le voci valide rimangono applicate. Vedi [invalid credential entries](/docs/it/settings-reference#invalid-credential-entries-in-managed-settings) |382| `sandbox.credentials` | Una voce non valida recuperabile viene degradata a `mode: "deny"` con un avviso; una non recuperabile viene rimossa; le voci valide rimangono applicate. Vedi [invalid credential entries](/docs/it/settings-reference#invalid-credential-entries-in-managed-settings) |

379 383

380`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. I 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.384`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.

385

386I fallback per queste due chiavi e per `allowedChannelPlugins` richiedono Claude Code v2.1.267 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida. I fallback per `strictKnownMarketplaces`, `blockedMarketplaces`, e `disableSideloadFlags` richiedono Claude Code v2.1.277 o successivo; le versioni precedenti eliminano l'intera chiave quando il suo valore o qualsiasi voce non è valida.

381 387

382`requiredMinimumVersion` e `requiredMaximumVersion` falliscono aperti per design: un valore non valido viene eliminato piuttosto che applicato.388`requiredMinimumVersion` e `requiredMaximumVersion` falliscono aperti per design: un valore non valido viene eliminato piuttosto che applicato.

383 389

memory.md +24 −7

Details

82<Tip>82<Tip>

83 Eseguite `/init` per generare automaticamente un CLAUDE.md iniziale. Claude analizza il vostro codebase e crea un file con comandi di build, istruzioni di test e convenzioni di progetto che scopre. Se un CLAUDE.md esiste già, `/init` suggerisce miglioramenti piuttosto che sovrascriverlo. Perfezionate da lì con istruzioni che Claude non scoprirebbe da solo.83 Eseguite `/init` per generare automaticamente un CLAUDE.md iniziale. Claude analizza il vostro codebase e crea un file con comandi di build, istruzioni di test e convenzioni di progetto che scopre. Se un CLAUDE.md esiste già, `/init` suggerisce miglioramenti piuttosto che sovrascriverlo. Perfezionate da lì con istruzioni che Claude non scoprirebbe da solo.

84 84

85 Impostate `CLAUDE_CODE_NEW_INIT=1` per abilitare un flusso interattivo multi-fase. `/init` chiede quali artefatti configurare: file CLAUDE.md, skills e hooks. Quindi esplora il vostro codebase con un subagent, colma le lacune tramite domande di follow-up e presenta una proposta revisionabile prima di scrivere qualsiasi file.85 Per un flusso interattivo multi-fase invece, impostate la variabile di ambiente `CLAUDE_CODE_NEW_INIT` a `1` prima di eseguire `/init`. Impostatela nella vostra shell o nel blocco `env` di un file di impostazioni, come mostrato in [Impostare le variabili di ambiente](/docs/it/env-vars#set-environment-variables). Con essa impostata, `/init` chiede quali artefatti configurare: file CLAUDE.md, skills e hooks. Quindi esplora il vostro codebase con un subagent, colma le lacune tramite domande di follow-up e presenta una proposta revisionabile prima di scrivere qualsiasi file. La variabile cambia solo il modo in cui `/init` viene eseguito, quindi potete lasciarla impostata.

86</Tip>86</Tip>

87 87

88<h3 id="write-effective-instructions">88<h3 id="write-effective-instructions">

165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

166```166```

167 167

168La forma inline imposta la variabile per quel singolo lancio in Bash o Zsh. Per mantenerla attiva per ogni sessione, aggiungetela al blocco `env` in `~/.claude/settings.json` come mostrato in [Impostare le variabili di ambiente](/docs/it/env-vars#set-environment-variables).

169

168Questo carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md` dalla directory aggiuntiva. `CLAUDE.local.md` viene saltato se escludete `local` da [`--setting-sources`](/docs/it/cli-reference).170Questo carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md` dalla directory aggiuntiva. `CLAUDE.local.md` viene saltato se escludete `local` da [`--setting-sources`](/docs/it/cli-reference).

169 171

170<h3 id="organize-rules-with-claude/rules/">172<h3 id="organize-rules-with-claude/rules/">

244 246

245La sintassi Glob tratta `[` come l'inizio di un'espressione tra parentesi quadre come `[abc]`. Un modello con un `[` che non può essere letto come un'espressione tra parentesi quadre, come `photos [2024/**`, non è valido: non corrisponde a nulla, e gli altri modelli della regola continuano a funzionare. Per far corrispondere un `[` letterale in un nome di file, sfuggitelo come `photos \[2024/**`. Prima della v2.1.207, un modello non valido causava il fallimento dello strumento Read per ogni file su cui la regola veniva valutata, invece di non corrispondere a nulla.247La sintassi Glob tratta `[` come l'inizio di un'espressione tra parentesi quadre come `[abc]`. Un modello con un `[` che non può essere letto come un'espressione tra parentesi quadre, come `photos [2024/**`, non è valido: non corrisponde a nulla, e gli altri modelli della regola continuano a funzionare. Per far corrispondere un `[` letterale in un nome di file, sfuggitelo come `photos \[2024/**`. Prima della v2.1.207, un modello non valido causava il fallimento dello strumento Read per ogni file su cui la regola veniva valutata, invece di non corrispondere a nulla.

246 248

249<h4 id="rules-frontmatter-reference">

250 Riferimento frontmatter delle regole

251</h4>

252

253Configurate una regola con il [frontmatter](/docs/it/glossary#frontmatter) YAML tra i marcatori `---` all'inizio del file. `paths` è l'unico campo che Claude Code legge da una regola; qualsiasi altro campo viene ignorato senza errore. Claude Code rimuove il frontmatter prima di caricare la regola in contesto.

254

255| Campo | Obbligatorio | Descrizione |

256| :------ | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------- |

257| `paths` | No | Modelli glob che [limitano la regola ai file corrispondenti](#path-specific-rules). Accetta un elenco YAML o una stringa separata da virgole |

258

259Se lo YAML tra i marcatori non viene analizzato, Claude Code ignora il frontmatter e carica la regola come se non avesse `paths`. Eseguite `claude --debug` per vedere l'errore di analisi.

260

247<h4 id="share-rules-across-projects-with-symlinks">261<h4 id="share-rules-across-projects-with-symlinks">

248 Condividete le regole tra i progetti con symlink262 Condividete le regole tra i progetti con symlink

249</h4>263</h4>

271└── workflows.md # I vostri flussi di lavoro preferiti285└── workflows.md # I vostri flussi di lavoro preferiti

272```286```

273 287

274Le regole a livello di utente vengono caricate prima delle regole di progetto, dando alle regole di progetto una priorità più alta.288Claude Code carica le regole a livello di utente prima delle regole di progetto, quindi una regola di progetto appare più tardi nel contesto di Claude rispetto a una regola utente. Nessuno dei due set sostituisce l'altro: se una regola utente e una regola di progetto si contraddicono, Claude potrebbe seguire l'una o l'altra, quindi mantenete i due coerenti.

275 289

276<h3 id="manage-claude-md-for-large-teams">290<h3 id="manage-claude-md-for-large-teams">

277 Gestite CLAUDE.md per i team di grandi dimensioni291 Gestite CLAUDE.md per i team di grandi dimensioni

424* Siete su una versione di Claude Code precedente a v2.1.277438* Siete su una versione di Claude Code precedente a v2.1.277

425* La vostra sessione non [recupera i flag delle funzionalità da Anthropic](/docs/it/env-vars#features-that-need-feature-flag-fetching), ad esempio perché usate Amazon Bedrock o un altro provider di terze parti, o avete disabilitato la telemetria. La sezione collegata ha l'elenco completo439* La vostra sessione non [recupera i flag delle funzionalità da Anthropic](/docs/it/env-vars#features-that-need-feature-flag-fetching), ad esempio perché usate Amazon Bedrock o un altro provider di terze parti, o avete disabilitato la telemetria. La sezione collegata ha l'elenco completo

426* È la vostra [prima sessione dopo aver installato o aggiornato](/docs/it/env-vars#first-session-after-an-install-or-upgrade) a una versione con supporto `AGENTS.md`. Claude legge `AGENTS.md` dalla vostra prossima sessione440* È la vostra [prima sessione dopo aver installato o aggiornato](/docs/it/env-vars#first-session-after-an-install-or-upgrade) a una versione con supporto `AGENTS.md`. Claude legge `AGENTS.md` dalla vostra prossima sessione

427* Voi o la vostra organizzazione avete impostato [`disableAllHooks`](/docs/it/settings-reference#disableallhooks) o [`allowManagedHooksOnly`](/docs/it/settings-reference#allowmanagedhooksonly), o avete disabilitato il plugin integrato `agents-md` in `/plugin`441* Voi o la vostra organizzazione avete disabilitato il plugin integrato `agents-md` in `/plugin`

428 442

429Per dare a Claude il vostro `AGENTS.md` in queste sessioni, [importatelo da un `CLAUDE.md`](#share-one-file-with-other-coding-tools).443Per dare a Claude il vostro `AGENTS.md` in queste sessioni, [importatelo da un `CLAUDE.md`](#share-one-file-with-other-coding-tools).

430 444

435Un `AGENTS.md` che Claude legge attraverso l'impostazione **Project instructions** differisce da un `CLAUDE.md` in questi posti:449Un `AGENTS.md` che Claude legge attraverso l'impostazione **Project instructions** differisce da un `CLAUDE.md` in questi posti:

436 450

438| :---------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |452| :---------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |

439| `/memory` e l'elenco **Memory files** in `/context` | Elencato | Non elencato. Per confermare che Claude lo ha letto, cercate la [riga `AGENTS.md loaded`](#when-claude-code-reads-agents-md) sotto il valore predefinito, o chiedete a Claude cosa dicono le sue istruzioni del progetto |

440| [Hook `InstructionsLoaded`](/docs/it/hooks#instructionsloaded) | Si attivano | Non si attivano. Si attivano come al solito per un `AGENTS.md` che un `CLAUDE.md` importa o crea un symlink |453| [Hook `InstructionsLoaded`](/docs/it/hooks#instructionsloaded) | Si attivano | Non si attivano. Si attivano come al solito per un `AGENTS.md` che un `CLAUDE.md` importa o crea un symlink |

441| Directory che aggiungete con `--add-dir` mentre [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) è impostato | Il loro `CLAUDE.md` carica | Il loro `AGENTS.md` non carica |454| Directory che aggiungete con `--add-dir` mentre [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) è impostato | Il loro `CLAUDE.md` carica | Il loro `AGENTS.md` non carica |

442| Un import `@path` di un file al di fuori della vostra directory di lavoro | Claude Code vi chiede di approvare gli [import esterni](#import-additional-files) | Carica solo se avete già approvato gli import esterni per questo progetto, senza prompt |455| Un import `@path` di un file al di fuori della vostra directory di lavoro | Claude Code vi chiede di approvare gli [import esterni](#import-additional-files) | Carica solo se avete già approvato gli import esterni per questo progetto, senza prompt |

604 617

605Per eseguire il debug:618Per eseguire il debug:

606 619

607* Esegui `/context` e controlla l'elenco sotto **Memory files** per verificare che i tuoi file CLAUDE.md e CLAUDE.local.md siano stati caricati. Se un file `CLAUDE.md` non è presente lì, Claude non può vederlo. Un `AGENTS.md` appare lì solo quando un `CLAUDE.md` lo importa, non quando Claude [lo legge direttamente](#where-agents-md-differs-from-claude-md). Usa `/memory` per aprire e modificare i file.620* Esegui `/context` e controlla l'elenco sotto **Memory files** per verificare che i tuoi file CLAUDE.md e CLAUDE.local.md siano stati caricati. Se un file `CLAUDE.md` non è presente lì, Claude non può vederlo. Usa `/memory` per aprire e modificare i file.

608* Verifica che il CLAUDE.md rilevante si trovi in una posizione che viene caricata per la tua sessione (vedi [Scegli dove mettere i file CLAUDE.md](#choose-where-to-put-claude-md-files)).621* Verifica che il CLAUDE.md rilevante si trovi in una posizione che viene caricata per la tua sessione (vedi [Scegli dove mettere i file CLAUDE.md](#choose-where-to-put-claude-md-files)).

609* Rendi le istruzioni più specifiche. "Usa indentazione a 2 spazi" funziona meglio di "formatta il codice bene".622* Rendi le istruzioni più specifiche. "Usa indentazione a 2 spazi" funziona meglio di "formatta il codice bene".

610* Cerca istruzioni conflittuali tra i file CLAUDE.md. Se due file danno una guida diversa per lo stesso comportamento, Claude potrebbe sceglierne una arbitrariamente.623* Cerca istruzioni conflittuali tra i file CLAUDE.md. Se due file danno una guida diversa per lo stesso comportamento, Claude potrebbe sceglierne una arbitrariamente.

6283. Controlla se la tua sessione è una che [non può caricare `AGENTS.md`](#when-agents-md-support-is-unavailable), come una sessione su un provider di terze parti o con telemetria disabilitata.6413. Controlla se la tua sessione è una che [non può caricare `AGENTS.md`](#when-agents-md-support-is-unavailable), come una sessione su un provider di terze parti o con telemetria disabilitata.

6294. Digita `/config` nella tua sessione per aprire il pannello delle impostazioni e conferma che **Project instructions** non è impostato su `claude-md` o `managed-only`. Se non vedi affatto l'impostazione lì, la tua sessione è una che [non può caricare `AGENTS.md`](#when-agents-md-support-is-unavailable).6424. Digita `/config` nella tua sessione per aprire il pannello delle impostazioni e conferma che **Project instructions** non è impostato su `claude-md` o `managed-only`. Se non vedi affatto l'impostazione lì, la tua sessione è una che [non può caricare `AGENTS.md`](#when-agents-md-support-is-unavailable).

630 643

631`AGENTS.md` non appare in `/memory` o `/context` quando Claude lo legge direttamente, quindi controlla la riga `AGENTS.md loaded` o chiedi a Claude quali sono le sue istruzioni di progetto. Se vuoi mantenere il `CLAUDE.md` che hai trovato, o la tua sessione non può caricare `AGENTS.md`, [aggiungi un `CLAUDE.md` accanto al tuo `AGENTS.md` che lo importa](#share-one-file-with-other-coding-tools).644Per verificare se Claude ha letto il tuo `AGENTS.md`, esegui `/memory` e cerca il suo percorso nell'elenco.

645

646Prima della v2.1.280, `/memory` e `/context` non elencavano un `AGENTS.md` che Claude leggeva direttamente. Su quelle versioni, chiedi a Claude quali sono le sue istruzioni di progetto.

647

648Se vuoi mantenere il `CLAUDE.md` che hai trovato, o la tua sessione non può caricare `AGENTS.md`, [aggiungi un `CLAUDE.md` accanto al tuo `AGENTS.md` che lo importa](#share-one-file-with-other-coding-tools).

632 649

633<h3 id="i-don’t-know-what-auto-memory-saved">650<h3 id="i-don’t-know-what-auto-memory-saved">

634 Non so cosa ha salvato la memoria automatica651 Non so cosa ha salvato la memoria automatica

model-config.md +114 −116

Details

10 Modelli disponibili10 Modelli disponibili

11</h2>11</h2>

12 12

~~13Per l'impostazione `model` in Claude Code, è possibile configurare:~~13Per l'impostazione `model` in Claude Code, puoi configurare:

14 14

15* Un **alias del modello**15* Un **alias del modello**

16* Un **nome del modello**16* Un **nome del modello**

~~17 * API Anthropic: un **[nome del modello](https://platform.claude.com/docs/en/about-claude/models/overview)** completo~~17 * Anthropic API: un **[nome del modello](https://platform.claude.com/docs/en/about-claude/models/overview)** completo

18 * Amazon Bedrock: un ARN del profilo di inferenza18 * Amazon Bedrock: un ARN del profilo di inferenza

19 * Microsoft Foundry: un nome di distribuzione19 * Microsoft Foundry: un nome di distribuzione

~~20 * Agent Platform di Google Cloud: un nome di versione~~20 * Google Cloud's Agent Platform: un nome di versione

21 21

22Per indicazioni su quale modello e livello di impegno si adattano a diversi tipi di lavoro, consultare [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) sul blog.22Per indicazioni su quale modello e livello di impegno si adattano a diversi tipi di lavoro, consulta [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) sul blog.

23 23

24<Note>24<Note>

~~25 `ANTHROPIC_BASE_URL` cambia dove vengono inviate le richieste, non quale modello le risponde. Per instradare Claude attraverso un gateway LLM, consultare [LLM gateways](/docs/it/llm-gateway).~~25 `ANTHROPIC_BASE_URL` cambia dove vengono inviate le richieste, non quale modello le risponde. Per instradare Claude attraverso un gateway LLM, consulta [LLM gateways](/docs/it/llm-gateway).

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

~~29 Alias dei modelli~~29 Alias del modello

30</h3>30</h3>

31 31

~~32Utilizzare un alias del modello per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:~~32Usa un alias del modello per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:

33 33

34| Alias del modello | Comportamento |34| Alias del modello | Comportamento |

35| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |35| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

36| **`default`** | Valore speciale che cancella qualsiasi override del modello e ripristina il [valore predefinito di runtime per il vostro account](#default-model-setting). Non è di per sé un alias del modello |36| **`default`** | Valore speciale che cancella qualsiasi override del modello e ripristina il [valore predefinito di runtime per il tuo account](#default-model-setting). Non è di per sé un alias del modello |

37| **`best`** | Utilizza il modello a cui si risolve l'alias [`fable`](#fable-alias-resolution) dove Fable è disponibile per voi, altrimenti lo stesso modello di `opus` |37| **`best`** | Utilizza il modello a cui si risolve l'alias [`fable`](#fable-alias-resolution) dove Fable è disponibile per te, altrimenti lo stesso modello di `opus` |

38| **`fable`** | Utilizza il [modello Fable per il vostro provider](#fable-alias-resolution) per i vostri compiti più difficili e lunghi |38| **`fable`** | Utilizza il [modello Fable per il tuo provider](#fable-alias-resolution) per i tuoi compiti più difficili e lunghi |

42| **`sonnet[1m]`** | Utilizza Sonnet con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `sonnet` si risolve già in Sonnet 5 con la sua finestra nativa di 1M; dietro un [gateway LLM](/docs/it/llm-gateway), seleziona la finestra 1M per Sonnet 5 |42| **`sonnet[1m]`** | Utilizza Sonnet con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `sonnet` si risolve già in Sonnet 5 con la sua finestra nativa di 1M; dietro un [gateway LLM](/docs/it/llm-gateway), seleziona la finestra di 1M per Sonnet 5 |

43| **`opus[1m]`** | Utilizza Opus con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe |43| **`opus[1m]`** | Utilizza Opus con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe |

45 45

47 47

49| :--------------------------------------------------- | :------- | :--------- |49| :--------------------------------------------------- | :------- | :--------- |

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56

57A meno che non impostiate `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5.1, tranne nelle sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) dove `fable` e `best` si risolvono in Fable 5. Prima della v2.1.257, `fable` si risolveva in Fable 5 su ogni provider.57A meno che non imposti `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5.1, tranne nelle sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) dove `fable` e `best` si risolvono in Fable 5. Prima della v2.1.257, `fable` si risolveva in Fable 5 su ogni provider.

58 58

59Un gateway non configurato per servire `claude-fable-5-1` rifiuta le richieste per quel modello. Per utilizzare Fable 5.1 attraverso un gateway che lo serve, selezionarlo con `/model claude-fable-5-1`.59Un gateway non configurato per servire `claude-fable-5-1` rifiuta le richieste per quel modello. Per utilizzare Fable 5.1 attraverso un gateway che lo serve, selezionalo con `/model claude-fable-5-1`.

60 60

61Dove un alias si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando il nome completo del modello esplicitamente o impostando `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Dove un alias si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando il nome del modello completo esplicitamente o impostando `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62

63Prima della v2.1.219, `opus` si risolveva in Opus 4.8 sull'API Anthropic dalla v2.1.154, e su Claude Platform on AWS, Amazon Bedrock e Agent Platform di Google Cloud dalla v2.1.207. Prima della v2.1.207, `opus` si risolveva in Opus 4.7 su Claude Platform on AWS e in Opus 4.6 su Amazon Bedrock e Agent Platform di Google Cloud.63Prima della v2.1.280, `opus` si risolveva in Opus 5 su Anthropic API, Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform dalla v2.1.219. Prima della v2.1.219, `opus` si risolveva in Opus 4.8 su Anthropic API dalla v2.1.154, e su Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform dalla v2.1.207. Prima della v2.1.207, `opus` si risolveva in Opus 4.7 su Claude Platform on AWS e in Opus 4.6 su Amazon Bedrock e Google Cloud's Agent Platform.

64 64

65Gli alias puntano alla versione consigliata per il vostro provider e si aggiornano nel tempo. Per fissare una versione specifica, utilizzare il nome completo del modello, ad esempio `claude-opus-5`, o impostare la variabile di ambiente corrispondente come `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Gli alias puntano alla versione consigliata per il tuo provider e si aggiornano nel tempo. Per fissare una versione specifica, utilizza il nome del modello completo, ad esempio `claude-opus-5-5`, o imposta la variabile di ambiente corrispondente come `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66

67<Note>67<Note>

~~68 Opus 5 richiede Claude Code v2.1.219 o successiva. Sonnet 5 richiede v2.1.197 o successiva. Opus 4.8 richiede v2.1.154 o successiva. Eseguire `claude update` per aggiornare.~~68 Opus 5.5 richiede Claude Code v2.1.280 o successiva. Opus 5 richiede v2.1.219 o successiva. Sonnet 5 richiede v2.1.197 o successiva. Esegui `claude update` per aggiornare.

69</Note>69</Note>

70 70

71<h3 id="work-with-fable">71<h3 id="work-with-fable">

~~72 Lavorare con Fable~~72 Lavora con Fable

73</h3>73</h3>

74 74

75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione. Sostengono lunghe sessioni autonome, investigano prima di agire e verificano il loro lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione. Sostengono lunghe sessioni autonome, investigano prima di agire e verificano il loro lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.

76 76

~~77Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionarne uno esplicitamente:~~77Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionane uno esplicitamente:

78 78

79* **Fable 5.1**: eseguire `/model fable`, o avviare con `claude --model fable`. Nelle sessioni [Claude apps gateway](/docs/it/claude-apps-gateway), dove l'alias si risolve in Fable 5, eseguire `/model claude-fable-5-1` invece.79* **Fable 5.1**: esegui `/model fable`, o avvia con `claude --model fable`. Nelle sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) dove l'alias si risolve in Fable 5, esegui `/model claude-fable-5-1` invece.

80* **Fable 5**: selezionarlo per ID del modello. Sull'API Anthropic, eseguire `/model claude-fable-5` o avviare con `claude --model claude-fable-5`. Su altri provider, utilizzare l'ID del modello Fable 5 del vostro provider o [fissarlo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.80* **Fable 5**: selezionalo per ID del modello. Su Anthropic API, esegui `/model claude-fable-5` o avvia con `claude --model claude-fable-5`. Su altri provider, utilizza l'ID del modello Fable 5 del tuo provider o [fissalo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.

81 81

82Se vi connettete direttamente all'API Anthropic e le vostre impostazioni utente contengono `claude-fable-5` o `claude-fable-5[1m]` come modello, ad esempio perché avete selezionato Fable nel selettore `/model` prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias `fable` o `fable[1m]` la prima volta che eseguite v2.1.257 o successiva. La riga del modello di avvio mostra `(auto-updated)` una volta. Un valore `claude-fable-5` nelle impostazioni di progetto, locali o gestite rimane come è.82Se ti connetti direttamente a Anthropic API e le tue impostazioni utente contengono `claude-fable-5` o `claude-fable-5[1m]` come modello, ad esempio perché hai selezionato Fable nel selettore `/model` prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias `fable` o `fable[1m]` la prima volta che esegui v2.1.257 o successiva. La riga del modello di avvio mostra `(auto-updated)` una volta. Un valore `claude-fable-5` nelle impostazioni di progetto, locali o gestite rimane come è.

83 83

84Le richieste che i classificatori di sicurezza di un modello Fable contrassegnano, più spesso nei domini della sicurezza informatica e della biologia, attivano il [fallback automatico del modello](#automatic-model-fallback).84Le richieste che i classificatori di sicurezza di un modello Fable contrassegnano, il più delle volte nei domini della sicurezza informatica e della biologia, attivano il [fallback automatico del modello](#automatic-model-fallback).

85 85

86Per ottenere il massimo da Fable:86Per ottenere il massimo da Fable:

87 87

88* **Descrivete il risultato, non i passaggi**: dategli il risultato che desiderate e lasciate che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, [impostate un obiettivo](/docs/it/goal).88* **Descrivi il risultato, non i passaggi**: dagli il risultato che desideri e lascia che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, [imposta un obiettivo](/docs/it/goal).

~~89* **Dategli problemi ambigui**: le investigazioni delle cause radice, il debug dei disservizi e le decisioni architettoniche sono dove l'investigazione e la verifica extra ripagano.~~89* **Dagli problemi ambigui**: le indagini sulla causa principale, il debug delle interruzioni e le decisioni architettoniche sono dove l'indagine e la verifica extra ripagano.

~~90* **Saltate i promemoria di verifica**: verifica il suo lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare sono solitamente non necessari.~~90* **Salta i promemoria di verifica**: verifica il suo lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare sono solitamente non necessari.

~~91* **Dimensionate i compiti più grandi**: dategli lavoro che normalmente dividereste in pezzi. Sostiene lunghe sessioni senza perdere il filo.~~91* **Dimensiona compiti più grandi**: dagli lavoro che normalmente divideresti in pezzi. Sostiene lunghe sessioni senza perdere il filo.

92 92

93<Note>93<Note>

94 Fable 5.1 richiede Claude Code v2.1.257 o successiva. Se una richiesta per esso da una versione più vecchia fallisce, consultare [Claude Code does not support this model](/docs/it/errors#claude-code-does-not-support-this-model). Eseguire `claude update` per aggiornare. Per la disponibilità con zero data retention, consultare [Model availability under ZDR](/docs/it/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 richiede Claude Code v2.1.257 o successiva. Se una richiesta per essa da una versione precedente fallisce, consulta [Claude Code does not support this model](/docs/it/errors#claude-code-does-not-support-this-model). Esegui `claude update` per aggiornare. Per la disponibilità con zero data retention, consulta [Model availability under ZDR](/docs/it/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96

97Sull'API Anthropic, il selettore `/model` elenca un modello Fable solo dopo che il server lo segnala come disponibile per la vostra organizzazione. Quando digitate `/model fable` o un ID del modello Fable, Claude Code controlla la disponibilità direttamente con il server, quindi una selezione digitata può avere successo anche quando il selettore non elenca la voce.97Su Anthropic API, un modello Fable appare nel selettore `/model` a meno che [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) lo escludano. Quando la tua organizzazione non può utilizzare Fable affatto, ad esempio con [zero data retention](/docs/it/zero-data-retention#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.

98 98

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable e crediti di utilizzo100 Fable e crediti di utilizzo

101</h4>101</h4>

102 102

103A seconda del vostro piano e del livello di posto, l'utilizzo di Fable può fatturare ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) invece di attingere ai limiti inclusi nel vostro piano. Quando lo fa, il selettore `/model` mostra "Requires usage credits" sulla riga Fable. Per gestire i crediti di utilizzo, consultare [Add usage credits to your subscription](/docs/it/costs#add-usage-credits-to-your-subscription).103A seconda del tuo piano e del livello di posto, l'utilizzo di Fable può fatturare ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) invece di attingere ai limiti inclusi nel tuo piano. Quando lo fa, il selettore `/model` mostra "Requires usage credits" sulla riga Fable. Per gestire i crediti di utilizzo, consulta [Add usage credits to your subscription](/docs/it/costs#add-usage-credits-to-your-subscription).

104 104

105Nelle sessioni interattive, Claude Code mostra un prompt di consenso prima che una richiesta Fable fatturi i crediti di utilizzo. I membri dei piani Enterprise con fatturazione organizzativa non vedono il prompt. Potete continuare su Fable utilizzando i crediti di utilizzo o passare al vostro modello predefinito. Potete anche chiudere il prompt:105Nelle sessioni interattive, Claude Code mostra un prompt di consenso prima che una richiesta Fable fatturi crediti di utilizzo. I membri dei piani Enterprise con fatturazione organizzativa non vedono il prompt. Puoi continuare su Fable utilizzando crediti di utilizzo o passare al tuo modello predefinito. Puoi anche chiudere il prompt:

106 106

107* Nel selettore `/model`, mantenete il vostro modello attuale.107* Nel selettore `/model`, mantieni il tuo modello attuale.

108* A metà sessione, Claude Code continua il turno sul vostro modello predefinito.108* A metà sessione, Claude Code continua il turno sul tuo modello predefinito.

109 109

110Dopo aver scelto di continuare su Fable utilizzando i crediti di utilizzo, Claude Code non mostra più il prompt.110Dopo aver scelto di continuare su Fable utilizzando crediti di utilizzo, Claude Code non mostra più il prompt.

111 111

112In una sessione con [Remote Control](/docs/it/remote-control) connesso, una [sessione in background](/docs/it/agent-view), o una sessione di un compagno di squadra [agent team](/docs/it/agent-teams), nessuno potrebbe essere al terminale, quindi Claude Code tiene il prompt di consenso a metà sessione per la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che il client Remote Control mostra anche. La vostra selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al vostro prossimo messaggio.112In una sessione con [Remote Control](/docs/it/remote-control) connesso, una [sessione in background](/docs/it/agent-view), o una sessione del compagno di un [team di agenti](/docs/it/agent-teams), nessuno potrebbe essere al terminale, quindi Claude Code tiene il prompt di consenso a metà sessione per la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che il client Remote Control mostra anche. La tua selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al tuo prossimo messaggio.

113 113

114Quello che potete fare mentre il prompt è in attesa dipende dalla sessione:114Quello che puoi fare mentre il prompt è in attesa dipende dalla sessione:

115 115

116* Con Remote Control connesso o nella sessione di un compagno di squadra, premete un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la vostra risposta.116* Con Remote Control connesso o nella sessione di un compagno, premi un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la tua risposta.

117* In una sessione in background, rispondete prima della scadenza.117* In una sessione in background, rispondi prima della scadenza.

118* Se inviate un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il vostro nuovo messaggio inizia il turno successivo. Dopo che qualcuno digita al terminale, Claude Code continua ad aspettare la risposta e mette in coda il vostro nuovo messaggio dietro di essa.118* Se invii un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il tuo nuovo messaggio inizia il turno successivo. Dopo che qualcuno digita al terminale, Claude Code continua ad aspettare la risposta e mette in coda il tuo nuovo messaggio dietro di essa.

119 119

120In [modalità non interattiva](/docs/it/headless) con il flag `-p` e attraverso l'Agent SDK, Claude Code non mostra mai il prompt di consenso. Quando una richiesta Fable lì fatturasse ai crediti di utilizzo, Claude Code la fattura senza chiedere.120In [modalità non interattiva](/docs/it/headless) con il flag `-p` e attraverso Agent SDK, Claude Code non mostra mai il prompt di consenso. Quando una richiesta Fable lì fatturasse crediti di utilizzo, Claude Code la fattura senza chiedere.

121 121

122<h3 id="setting-your-model">122<h3 id="setting-your-model">

123 Impostazione del vostro modello123 Impostazione del tuo modello

124</h3>124</h3>

125 125

126Potete configurare il vostro modello in diversi modi, elencati in ordine di priorità:126Puoi configurare il tuo modello in diversi modi, elencati in ordine di priorità:

127 127

1281. **Durante la sessione**: utilizzare `/model <alias|name>` per passare immediatamente, o eseguire `/model` senza argomenti per aprire il selettore. Consultare [quando Claude Code vi chiede di confermare il passaggio](/docs/it/prompt-caching#switching-models)1281. **Durante la sessione**: usa `/model <alias|name>` per passare immediatamente, o esegui `/model` senza argomenti per aprire il selettore. Consulta [quando Claude Code ti chiede di confermare il passaggio](/docs/it/prompt-caching#switching-models)

1292. **All'avvio**: avviare con `claude --model <alias|name>`1292. **All'avvio**: avvia con `claude --model <alias|name>`

1303. **Variabile di ambiente**: impostare `ANTHROPIC_MODEL=<alias|name>`1303. **Variabile di ambiente**: imposta `ANTHROPIC_MODEL=<alias|name>`

1314. **Impostazioni**: configurare permanentemente nel vostro file di impostazioni utilizzando il campo `model`1314. **Impostazioni**: configura permanentemente nel tuo file di impostazioni usando il campo `model`

1325. **[Valore predefinito per le nuove sessioni](#set-a-default-model-for-new-sessions)**: impostare `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1325. **[Predefinito per le nuove sessioni](#set-a-default-model-for-new-sessions)**: imposta `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

133 133

134`/model` salva la vostra scelta come valore predefinito per le nuove sessioni scrivendo il campo `model` nelle vostre impostazioni utente. Nel selettore:134`/model` salva la tua scelta come predefinita per le nuove sessioni scrivendo il campo `model` nelle tue impostazioni utente. Nel selettore:

135 135

136* `Enter`: passa il modello e salva come vostro valore predefinito136* `Enter`: cambia modello e salva come predefinito

137* `s`: passa il modello solo per questa sessione e lascia il vostro valore predefinito invariato. Per utilizzare un tasto diverso, riassegnare [`modelPicker:thisSessionOnly`](/docs/it/keybindings#model-picker-actions)137* `s`: cambia modello solo per questa sessione e lascia il tuo predefinito invariato. Per utilizzare un tasto diverso, riassegna [`modelPicker:thisSessionOnly`](/docs/it/keybindings#model-picker-actions)

138 138

139Digitare `/model <name>` direttamente si comporta come `Enter`. Per passare solo per questa sessione, aprire il selettore con `/model` e premere `s` sulla riga del modello.139Digitare `/model <name>` direttamente si comporta come `Enter`. Per cambiare solo per questa sessione, apri il selettore con `/model` e premi `s` sulla riga del modello.

140 140

141Se impostate un modello con `/model` in [modalità non interattiva](/docs/it/headless), con il flag `-p`, la vostra scelta si applica solo alla sessione attuale e non viene salvata come vostro valore predefinito; `/model` in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite mantengono comunque la precedenza e si riapplicano al prossimo avvio. Un [modello predefinito dell'organizzazione](#organization-default-model) che il vostro amministratore ha configurato per ignorare la selezione dell'utente si riapplica anche al prossimo avvio.141Se cambi modelli con `/model`, il cambio raggiunge anche i [subagenti che ereditano il modello della conversazione principale](/docs/it/sub-agents#choose-a-model), perché Claude Code risolve il loro modello da quello che la tua sessione sta utilizzando quando Claude li avvia. Passa a Opus prima che Claude deleghi ricerche o esecuzioni di test a uno di loro, e quel lavoro viene eseguito su Opus anche. Per mantenere un subagente personalizzato su un modello più piccolo, imposta `model` nella sua definizione.

142 142

143Nella v2.1.144 attraverso v2.1.152, `/model` si applicava solo alla sessione attuale e `d` nel selettore salvava un valore predefinito.143Se imposti un modello con `/model` in [modalità non interattiva](/docs/it/headless), con il flag `-p`, la tua scelta si applica solo alla sessione corrente e non viene salvata come predefinita; `/model` in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite hanno ancora la precedenza e si riapplicano al prossimo avvio. Un [modello predefinito dell'organizzazione](#organization-default-model) che il tuo amministratore ha configurato per ignorare la selezione dell'utente si riapplica anche al prossimo avvio.

144 144

145Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avviate con essi. Per eseguire modelli diversi in terminali diversi contemporaneamente, avviate ciascuno con il suo flag `--model` piuttosto che passare con `/model`.145Nella v2.1.144 attraverso v2.1.152, `/model` si applicava solo alla sessione corrente e `d` nel selettore salvava un predefinito.

146 146

147I prezzi nel selettore `/model` appaiono quando Claude Code parla con l'API Anthropic, direttamente o attraverso un [gateway LLM](/docs/it/llm-gateway) che lo fa da proxy, e il prezzo su una riga è il prezzo del modello che quella riga seleziona. Su [provider di terze parti](/docs/it/third-party-integrations) come Amazon Bedrock e sul [gateway Claude apps](/docs/it/claude-apps-gateway), il vostro provider o gateway determina quello che pagate, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello una riga seleziona o cosa il vostro provider fattura. Prima della v2.1.206, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e le sessioni gateway mostravano i prezzi di listino di Anthropic e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.147Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avvii con loro. Per eseguire modelli diversi in terminali diversi contemporaneamente, avvia ognuno con il suo flag `--model` piuttosto che cambiare con `/model`.

148 148

149Le sessioni riprese avviate con `claude --resume`, `--continue`, o il selettore `/resume` mantengono il modello che stavano utilizzando quando la trascrizione è stata salvata, indipendentemente dall'impostazione `model` attuale. Se il modello ripristinato è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta `/model` di un'altra sessione cambi il modello al ripristino. Su provider che utilizzano ID di distribuzione specifici del provider piuttosto che ID del modello Anthropic, come Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, il modello della trascrizione non viene ripristinato affatto e la sessione risolve il suo modello attraverso l'ordine di precedenza normale.149I prezzi nel selettore `/model` appaiono quando Claude Code parla con Anthropic API, direttamente o attraverso un [gateway LLM](/docs/it/llm-gateway) che lo proxies, e il prezzo su una riga è il prezzo del modello che quella riga seleziona. Su [provider di terze parti](/docs/it/third-party-integrations) come Amazon Bedrock e sul [gateway delle app Claude](/docs/it/claude-apps-gateway), il tuo provider o gateway determina quello che paghi, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello una riga seleziona o su cosa il tuo provider fattura. Prima della v2.1.206, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e le sessioni del gateway mostravano i prezzi di listino di Anthropic, e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.

150 150

151Un modello che scegliete per il nuovo avvio con `--model` o `ANTHROPIC_MODEL` mantiene comunque la precedenza sul modello ripristinato. A partire dalla v2.1.195, lo fa anche una variabile della famiglia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) può farlo anche, secondo le condizioni elencate nella sua sezione.151Le sessioni riprese avviate con `claude --resume`, `--continue`, o il selettore `/resume` mantengono il modello che stavano utilizzando quando la trascrizione è stata salvata, indipendentemente dall'impostazione `model` corrente. Se il modello ripristinato è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta `/model` di un'altra sessione cambi il modello al ripristino. Su provider che utilizzano ID di distribuzione specifici del provider piuttosto che ID di modello Anthropic, come Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, il modello della trascrizione non viene affatto ripristinato e la sessione risolve il suo modello attraverso l'ordine di precedenza normale.

152 152

153Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite piuttosto che dalla vostra selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per ignorare; l'impostazione di progetto o gestita si riapplica al prossimo avvio. Su piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un allowlist `availableModels` gestito rimane in vigore a meno che l'host non fornisca il suo; [Exceptions to managed settings precedence](/docs/it/settings#exceptions-to-managed-settings-precedence) dice quali chiavi e variabili l'host ignora.153Un modello che scegli per il nuovo avvio con `--model` o `ANTHROPIC_MODEL` ha ancora la precedenza sul modello ripristinato. A partire dalla v2.1.195, così fa una variabile della famiglia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) può farlo anche, secondo le condizioni elencate nella sua sezione.

154 154

155Se voi o la vostra organizzazione configurate [PreModelSwitch hooks](/docs/it/hooks#premodelswitch), vengono eseguiti prima che un passaggio richiesto si applichi e possono bloccarlo o chiedervi di confermare.155Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite piuttosto che dalla tua selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Esegui `/model` per ignorare; l'impostazione di progetto o gestita si riapplica al prossimo avvio. Su piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un elenco di autorizzazione `availableModels` gestito rimane in vigore a meno che l'host non fornisca il suo; [Exceptions to managed settings precedence](/docs/it/settings#exceptions-to-managed-settings-precedence) dice quali chiavi e variabili l'host ignora.

156 156

157Quando Claude Code non riesce a dire quali hook PreModelSwitch i [plugin gestiti](/docs/it/settings-reference#enabledplugins) della vostra organizzazione forniscono, ad esempio perché un plugin gestito non è riuscito a caricarsi, rifiuta il passaggio piuttosto che applicarlo senza controllo, e controlla di nuovo ad ogni nuovo tentativo. Consultare [Model switch was blocked by a PreModelSwitch hook](/docs/it/errors#model-switch-was-blocked-by-a-premodelswitch-hook) per il messaggio e il recupero.157Se tu o la tua organizzazione configurate [hook PreModelSwitch](/docs/it/hooks#premodelswitch), vengono eseguiti prima che un cambio richiesto si applichi e possono bloccarlo o chiederti di confermare.

158 158

159Quando passate i modelli attraverso il metodo [`setModel()`](/docs/it/agent-sdk/overview) dell'Agent SDK o da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control), o un'app come l'[Desktop app](/docs/it/desktop) che esegue il CLI di Claude Code passa per voi, Claude Code controlla che la stringa sia una che riconosce prima di salvarla. Questo controllo richiede Claude Code v2.1.200 o successiva. Controllare una scelta Remote Control richiede Claude Code v2.1.260 o successiva sulla vostra macchina. Sull'API Anthropic, Claude Code riconosce:159Quando Claude Code non riesce a dire quali hook PreModelSwitch i [plugin gestiti](/docs/it/settings-reference#enabledplugins) della tua organizzazione forniscono, ad esempio perché un plugin gestito non è riuscito a caricarsi, rifiuta il cambio piuttosto che applicarlo senza controllo, e controlla di nuovo ad ogni nuovo tentativo. Consulta [Model switch was blocked by a PreModelSwitch hook](/docs/it/errors#model-switch-was-blocked-by-a-premodelswitch-hook) per il messaggio e il recupero.

160

161Quando cambi modelli attraverso il metodo `setModel()` dell'[Agent SDK](/docs/it/agent-sdk/overview) o da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control), o un'app come l'[app Desktop](/docs/it/desktop) che esegue il CLI di Claude Code cambia per te, Claude Code controlla che la stringa sia una che riconosce prima di salvarla. Questo controllo richiede Claude Code v2.1.200 o successiva. Controllare una scelta Remote Control richiede Claude Code v2.1.260 o successiva sulla tua macchina. Su Anthropic API, Claude Code riconosce:

160 162

161* un alias del modello163* un alias del modello

162* una voce dal selettore `/model`164* una voce dal selettore `/model`

163* qualsiasi nome che inizia con `claude-`165* qualsiasi nome che inizia con `claude-`

164* un valore che avete configurato voi stessi come [opzione del modello personalizzato](#add-a-custom-model-option) o in [`modelOverrides`](#override-model-ids-per-version)166* un valore che hai configurato tu stesso come [opzione di modello personalizzato](#add-a-custom-model-option) o in [`modelOverrides`](#override-model-ids-per-version)

165 167

166Claude Code rifiuta una stringa non riconosciuta con `Model "<name>" is not a recognized model id.` e la sessione mantiene il suo modello attuale, invece di salvare la stringa e fallire alla prossima richiesta. Consultare [il riferimento dell'errore](/docs/it/errors#model-is-not-a-recognized-model-id) per i passaggi di recupero.168Claude Code rifiuta una stringa non riconosciuta con `Model "<name>" is not a recognized model id.` e la sessione mantiene il suo modello attuale, invece di salvare la stringa e fallire alla prossima richiesta. Consulta [il riferimento dell'errore](/docs/it/errors#model-is-not-a-recognized-model-id) per i passaggi di recupero.

167 169

168Il controllo viene eseguito solo sull'API Anthropic. Su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e dietro un [gateway LLM](/docs/it/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizzato, il vostro provider o gateway definisce i nomi dei modelli, quindi Claude Code passa qualsiasi stringa senza controllarla. Il controllo non copre nemmeno il flag `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, o l'impostazione `model`; un valore digitato male lì produce [There's an issue with the selected model](/docs/it/errors#theres-an-issue-with-the-selected-model) alla prima richiesta invece. Claude Code può comunque scrivere la [riga diagnostica del modello non riconosciuto](/docs/it/errors#unrecognized-model-id-on-a-request) al momento della richiesta, su ogni provider.170Il controllo viene eseguito solo su Anthropic API. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e dietro un [gateway LLM](/docs/it/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizzato, il tuo provider o gateway definisce i nomi dei modelli, quindi Claude Code passa qualsiasi stringa senza controllarla. Il controllo non copre nemmeno il flag `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, o l'impostazione `model`; un valore digitato male lì produce [There's an issue with the selected model](/docs/it/errors#theres-an-issue-with-the-selected-model) alla prima richiesta invece. Claude Code può comunque scrivere la [riga diagnostica del modello non riconosciuto](/docs/it/errors#unrecognized-model-id-on-a-request) al momento della richiesta, su ogni provider.

169 171

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

171 173

172Ad esempio, avviare una sessione su Opus:174Ad esempio, avvia una sessione su Opus:

173 175

174```bash theme={null}176```bash theme={null}

175claude --model opus177claude --model opus

176```178```

177 179

178Quindi passare i modelli dalla sessione:180Quindi cambia modelli dalla sessione:

179 181

180```text theme={null}182```text theme={null}

181/model sonnet183/model sonnet

193```195```

194 196

195<h4 id="set-a-default-model-for-new-sessions">197<h4 id="set-a-default-model-for-new-sessions">

196 Impostare un modello predefinito per le nuove sessioni198 Imposta un modello predefinito per le nuove sessioni

197</h4>199</h4>

198 200

199Impostare `ANTHROPIC_DEFAULT_MODEL=<alias|name>` per scegliere il modello su cui le vostre sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.201Imposta `ANTHROPIC_DEFAULT_MODEL=<alias|name>` per scegliere il modello su cui le tue sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.

200 202

201Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi seleziona un modello:203Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi seleziona un modello:

202 204

203* Il flag `--model`205* Il flag `--model`

204* `ANTHROPIC_MODEL`206* `ANTHROPIC_MODEL`

205* Un valore `model` in qualsiasi file di impostazioni, inclusa la scelta che salvate con `/model`207* Un valore `model` in qualsiasi file di impostazioni, inclusa la scelta che salvi con `/model`

206* Un [modello predefinito dell'organizzazione](#organization-default-model)208* Un [modello predefinito dell'organizzazione](#organization-default-model)

207 209

208Una scelta che salvate con `/model` ha la precedenza sulla variabile anche nei lanci successivi. Con `ANTHROPIC_MODEL` impostato invece, Claude Code ritorna al modello della variabile al prossimo lancio, qualunque cosa abbiate salvato con `/model`.210Una scelta che salvi con `/model` ha la precedenza sulla variabile anche nei lanci successivi. Con `ANTHROPIC_MODEL` impostato invece, Claude Code ritorna al modello della variabile al prossimo lancio, qualunque cosa tu abbia salvato con `/model`.

209 211

210Claude Code risolve anche l'opzione Default al modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Default si risolve al modello della variabile, la riga Default nel selettore `/model` mostra l'etichetta Set by ANTHROPIC\_DEFAULT\_MODEL.212Claude Code risolve anche l'opzione Predefinito al modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Predefinito si risolve nel modello della variabile, la riga Predefinito nel selettore `/model` mostra l'etichetta Set by ANTHROPIC\_DEFAULT\_MODEL.

211 213

212Claude Code ignora la variabile in questi casi e l'opzione Default si risolve come se non l'aveste impostata:214Claude Code ignora la variabile in questi casi e l'opzione Predefinito si risolve come se non l'avessi impostata:

213 215

214* L'avete impostata su `default`, `inherit`, `opusplan`, o `haiku`216* L'hai impostata su `default`, `inherit`, `opusplan`, o `haiku`

215* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è attivo217* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è attivo

216* [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) escludono il modello218* [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) escludono il modello

217* Il modello non è disponibile per il vostro account219* Il modello non è disponibile per il tuo account

218 220

219Quando una nuova sessione si avvierebbe sul modello della variabile, una sessione che riprendete con `claude --resume`, `--continue`, o il selettore `/resume` si avvia su di esso anche. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Altrimenti Claude Code non utilizza la variabile quando [riprendete una sessione](#setting-your-model).221Quando una nuova sessione si avvierebbe sul modello della variabile, una sessione che riprendi con `claude --resume`, `--continue`, o il selettore `/resume` si avvia su di esso anche. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Altrimenti Claude Code non utilizza la variabile quando [riprendi una sessione](#setting-your-model).

220 222

221<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">223<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

222 Una nuova sessione si avvia su un modello diverso da quello che avete scelto224 Una nuova sessione si avvia su un modello diverso da quello che hai scelto

223</h4>225</h4>

224 226

225Quando scegliete un modello con `/model` e la vostra prossima sessione si avvia su qualcos'altro, queste sono le cause solite:227Quando scegli un modello con `/model` e la tua prossima sessione si avvia su qualcos'altro, queste sono le cause solite:

226 228

227* **L'avete scelto per una sessione.** Premere `s` nel selettore, avviare con `--model`, e eseguire `/model` in modalità non interattiva si applicano tutti alla sessione attuale e lasciano il vostro valore predefinito salvato da solo.229* **L'hai scelto per una sessione.** Premere `s` nel selettore, avviare con `--model`, e eseguire `/model` in modalità non interattiva si applicano tutti alla sessione corrente e lasciano il tuo predefinito salvato da solo.

228* **Qualcosa con priorità più alta imposta il modello.** Un valore `model` nelle impostazioni di progetto o gestite, `ANTHROPIC_MODEL` nella vostra shell, o un [valore predefinito dell'organizzazione](#organization-default-model) che il vostro amministratore ha impostato per ignorare le scelte dell'utente si applica di nuovo ad ogni lancio. La vostra scelta `/model` è ancora salvata; è superata. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio nomina il file.230* **Qualcosa con priorità più alta imposta il modello.** Un valore `model` nelle impostazioni di progetto o gestite, `ANTHROPIC_MODEL` nella tua shell, o un [modello predefinito dell'organizzazione](#organization-default-model) che il tuo amministratore ha impostato per ignorare le scelte dell'utente si applica di nuovo ad ogni lancio. La tua scelta `/model` è ancora salvata; è superata. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio nomina il file.

229* **Claude Code non ha potuto salvare la vostra scelta.** `/model` scrive `model` in `~/.claude/settings.json`. Se non potete scrivere in quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, il modello che avete scelto dura per la sessione e il prossimo lancio legge il valore vecchio. Impostare `model` nello strumento che genera il file, o rendere il file scrivibile. Consultare [A change you made in Claude Code is lost in new sessions](/docs/it/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).231* **Claude Code non ha potuto salvare la tua scelta.** `/model` scrive `model` in `~/.claude/settings.json`. Se non puoi scrivere in quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, il modello che hai scelto dura per la sessione e il prossimo lancio legge il valore vecchio. Imposta `model` nello strumento che genera il file, o rendi il file scrivibile. Consulta [A change you made in Claude Code is lost in new sessions](/docs/it/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

230* **Avete ripreso una sessione.** Una sessione che riprendete con `claude --resume` o `--continue` solitamente [mantiene il modello che stava utilizzando](#setting-your-model) piuttosto che il vostro valore predefinito attuale.232* **Hai ripreso una sessione.** Una sessione che riprendi con `claude --resume` o `--continue` di solito [mantiene il modello che stava utilizzando](#setting-your-model) piuttosto che il tuo predefinito attuale.

231 233

232<h2 id="restrict-model-selection">234<h2 id="restrict-model-selection">

233 Limitare la selezione del modello235 Limitare la selezione del modello

443 445

444Il comportamento di `default` dipende dal tipo di account:446Il comportamento di `default` dipende dal tipo di account:

445 447

446* **Max, Team Premium, Enterprise e Anthropic API**: predefinito su Opus 5448* **Pro, Max, Team, Enterprise e Anthropic API**: predefinito su Opus 5.5

447* **Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform**: predefinito su Opus 5449* **Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform**: predefinito su Opus 5.5

448* **Pro e Team Standard**: predefinito su Sonnet 5

449* **Microsoft Foundry**: predefinito su Sonnet 4.5450* **Microsoft Foundry**: predefinito su Sonnet 4.5

450 451

451Prima della v2.1.219, `default` si risolveva in Opus 4.8 su Anthropic API, Max, Team Premium e Enterprise con pagamento a consumo da v2.1.154, e su Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.207. Prima della v2.1.207, `default` si risolveva in Opus 4.7 su Claude Platform su AWS e in Sonnet 4.5 su Amazon Bedrock e Google Cloud's Agent Platform.452Prima della v2.1.280, `default` si risolveva in Sonnet 5 su Pro e Team Standard, e in Opus 5 su Max, Team Premium, Enterprise, Anthropic API, Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.219. Prima della v2.1.219, `default` si risolveva in Opus 4.8 su Anthropic API, Max, Team Premium e Enterprise con pagamento a consumo da v2.1.154, e su Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.207. Prima della v2.1.207, `default` si risolveva in Opus 4.7 su Claude Platform su AWS e in Sonnet 4.5 su Amazon Bedrock e Google Cloud's Agent Platform.

452 453

453Quando un amministratore ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), `default` si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. `default` può anche risolversi nel modello impostato con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), secondo le condizioni elencate nella relativa sezione.454Quando un amministratore ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), `default` si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. `default` può anche risolversi nel modello impostato con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), secondo le condizioni elencate nella relativa sezione.

454 455

512 Fallback automatico del modello513 Fallback automatico del modello

513</h3>514</h3>

514 515

515Questa sezione copre il fallback basato sul contenuto dai modelli Fable e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, vedere [Catene di modelli di fallback](#fallback-model-chains).516Questa sezione copre il fallback basato sul contenuto dai modelli Fable, Opus 5.5 e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, vedere [Catene di modelli di fallback](#fallback-model-chains).

516 517

517I modelli Fable e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte contrassegnano il contenuto di sicurezza informatica e biologia. Quando un classificatore contrassegna una richiesta e la categoria contrassegnata ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e mostra un avviso nella trascrizione. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:518I modelli Fable, Opus 5.5 e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte contrassegnano il contenuto di sicurezza informatica e biologia. Quando un classificatore contrassegna una richiesta e la categoria contrassegnata ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e mostra un avviso nella trascrizione. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:

518 519

519* **Fable 5.1 e Fable 5**: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.520* **Fable 5.1, Fable 5 e Opus 5.5**: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.

520* **Opus 5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.521* **Opus 5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.

521 522

522Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve questi target attraverso il tuo deployment, e se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le categorie che hanno un fallback vengono rieseguite sul modello bloccato; vedere [Abilitare il fallback su Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).523Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve questi target attraverso il tuo deployment, e se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le categorie che hanno un fallback vengono rieseguite sul modello bloccato; vedere [Abilitare il fallback su Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

555 556

556Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare entrambi i modelli coinvolti:557Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare entrambi i modelli coinvolti:

557 558

558* Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene `claude-fable-5`, corrisponde al valore di `ANTHROPIC_DEFAULT_FABLE_MODEL` o è mappato con [`modelOverrides`](#override-model-ids-per-version). Opus 5 viene riconosciuto dal suo ID modello del provider o da un mapping [`modelOverrides`](#override-model-ids-per-version).559* Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene `claude-fable-5`, corrisponde al valore di `ANTHROPIC_DEFAULT_FABLE_MODEL` o è mappato con [`modelOverrides`](#override-model-ids-per-version). Opus 5.5 e Opus 5 vengono riconosciuti dal loro ID modello del provider o da un mapping [`modelOverrides`](#override-model-ids-per-version).

559* Il modello di fallback deve risolversi nel tuo deployment. Se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le richieste contrassegnate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste contrassegnate per sicurezza informatica vengono rieseguite su una voce Opus 4.8 nell'elenco dei modelli del provider, e le richieste contrassegnate per biologia da un modello Fable su una voce Opus 5.560* Il modello di fallback deve risolversi nel tuo deployment. Se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le richieste contrassegnate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste contrassegnate per sicurezza informatica vengono rieseguite su una voce Opus 4.8 nell'elenco dei modelli del provider, e le richieste contrassegnate per biologia da un modello Fable o Opus 5.5 su una voce Opus 5.

560 561

561Se uno dei modelli non può essere identificato, Claude Code non passa automaticamente. La richiesta contrassegnata termina con un messaggio di rifiuto e puoi cambiare modelli con [`/model`](#setting-your-model) e riprovare. Impostare `ANTHROPIC_DEFAULT_FABLE_MODEL` sul tuo ID modello Fable abilita il riconoscimento di Fable. Impostare `ANTHROPIC_DEFAULT_OPUS_MODEL` su un ID modello Opus fornisce alle categorie contrassegnate un target di fallback, a meno che il pin non nomini un modello al di fuori della famiglia Opus o il modello che ha rifiutato; quindi Claude Code non passa e il rifiuto rimane.562Se uno dei modelli non può essere identificato, Claude Code non passa automaticamente. La richiesta contrassegnata termina con un messaggio di rifiuto e puoi cambiare modelli con [`/model`](#setting-your-model) e riprovare. Impostare `ANTHROPIC_DEFAULT_FABLE_MODEL` sul tuo ID modello Fable abilita il riconoscimento di Fable. Impostare `ANTHROPIC_DEFAULT_OPUS_MODEL` su un ID modello Opus fornisce alle categorie contrassegnate un target di fallback, a meno che il pin non nomini un modello al di fuori della famiglia Opus o il modello che ha rifiutato; quindi Claude Code non passa e il rifiuto rimane.

562 563

564 Ricerca sulla sicurezza e carichi di lavoro biologici565 Ricerca sulla sicurezza e carichi di lavoro biologici

565</h4>566</h4>

566 567

567I carichi di lavoro in sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e basi di codice adiacenti alla biologia, attivano il fallback frequentemente, spesso alla prima richiesta. Per un lavoro biologico sostanziale su Fable 5.1 o Fable 5, Claude Code sposta la sessione a Opus 5 alla prima richiesta contrassegnata, e le successive richieste contrassegnate per biologia terminano in rifiuti lì, perché Opus 5 non ha fallback biologico. Su Opus 5, ricevi quei rifiuti dalla prima richiesta contrassegnata.568I carichi di lavoro in sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e basi di codice adiacenti alla biologia, attivano il fallback frequentemente, spesso alla prima richiesta. Per un lavoro biologico sostanziale su Fable 5.1, Fable 5 o Opus 5.5, Claude Code sposta la sessione a Opus 5 alla prima richiesta contrassegnata, e le successive richieste contrassegnate per biologia terminano in rifiuti lì, perché Opus 5 non ha fallback biologico. Su Opus 5, ricevi quei rifiuti dalla prima richiesta contrassegnata.

568 569

569Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.570Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.

570 571

577I livelli di sforzo disponibili dipendono dal modello. I modelli non elencati qui non supportano lo sforzo:578I livelli di sforzo disponibili dipendono dal modello. I modelli non elencati qui non supportano lo sforzo:

578 579

579| Modello | Livelli |580| Modello | Livelli |

580| :------------------------------------ | :-------------------------------------- |581| :---------------------------------------------- | :-------------------------------------- |

584 585

585Se imposti un livello che il modello attivo non supporta, Claude Code fallback al livello supportato più alto pari o inferiore a quello impostato. Ad esempio, `xhigh` viene eseguito come `high` su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; vedere [Limiti di sforzo dell'organizzazione](#organization-effort-limits).586Se imposti un livello che il modello attivo non supporta, Claude Code fallback al livello supportato più alto pari o inferiore a quello impostato. Ad esempio, `xhigh` viene eseguito come `high` su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; vedere [Limiti di sforzo dell'organizzazione](#organization-effort-limits).

587Con l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode) disattivata, Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:588Con l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode) disattivata, Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:

588 589

5891. Una scelta esplicita: la variabile di ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars#variables), l'avvio con `--effort`, o `/effort` nella sessione ([un `/effort` non interattivo ha effetto più ristretto](#non-interactive-effort))5901. Una scelta esplicita: la variabile di ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars#variables), l'avvio con `--effort`, o `/effort` nella sessione ([un `/effort` non interattivo ha effetto più ristretto](#non-interactive-effort))

5902. Lo sforzo predefinito del modello, su Fable 5, Opus 4.8 o Opus 4.7: dalla prima volta che esegui uno di questi modelli, Claude Code mantiene lo sforzo predefinito di quel modello tra le sessioni, anche quando le tue impostazioni risolvono un livello diverso. Opus 5 e Fable 5.1 non hanno tale mantenimento. Se un livello che imposti termina il mantenimento dipende da come lo imposti, ad esempio:5912. Le tue impostazioni: il livello che hai salvato per il modello o una chiave [`effortLevel`](/docs/it/settings-reference#effortlevel), con la precedenza tra loro e tra i file di impostazioni indicata in [`modelSettings`](/docs/it/settings-reference#modelsettings)

591 * **Termina il mantenimento**: confermare un livello in modo interattivo, con `Enter` nel cursore `/effort` o nel selettore `/model` o con un livello digitato dopo `/effort`, o selezionare un livello dal controllo dello sforzo di un dispositivo connesso [Remote Control](/docs/it/remote-control#what-connected-devices-see)5923. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne che Opus 5.5 predefinito a `medium`, Opus 4.7 predefinito a `xhigh` e, quando la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello

592 * **Lascia il mantenimento in vigore per le sessioni successive**: `--effort` all'avvio, o `s` nel cursore `/effort` o nel selettore `/model`593

5933. Le tue impostazioni: il livello che hai salvato per il modello o una chiave [`effortLevel`](/docs/it/settings-reference#effortlevel), con la precedenza tra loro e tra i file di impostazioni indicata in [`modelSettings`](/docs/it/settings-reference#modelsettings)594Opus 5.5 inizia a `medium` a meno che una delle fonti sopra non imposti un livello per esso, e un `effortLevel` di livello superiore nel tuo file di impostazioni utente non conta per Opus 5.5. Quella chiave è la forma più vecchia che `/effort` ha scritto prima che Claude Code salvasse i livelli per modello: continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti, mentre Opus 5.5 e i modelli rilasciati dopo di esso iniziano al loro predefinito fino a quando non scegli un livello per loro con `/effort` o il selettore `/model`. Un `effortLevel` di livello superiore nelle impostazioni di progetto, locale o gestite, o uno passato con `--settings`, si applica a ogni modello.

5944. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne che Opus 4.7 predefinito a `xhigh` e, quando la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello

595 595

596Quando imposti `low`, `medium`, `high` o `xhigh` in una sessione interattiva sulla tua macchina, scegli quanto dura selezionando come lo confermi:596Quando imposti `low`, `medium`, `high` o `xhigh` in una sessione interattiva sulla tua macchina, scegli quanto dura selezionando come lo confermi:

597 597

608 608

609<span id="non-interactive-effort" />609<span id="non-interactive-effort" />

610 610

611Quando imposti un livello con `/effort` in un'esecuzione [`-p`](/docs/it/headless), Claude Code lo applica solo a quella sessione e non lo salva come predefinito. Su Fable 5, Opus 4.8 e Opus 4.7, quel livello inoltre non termina il mantenimento dello sforzo predefinito del modello né lo sostituisce per la sessione. Mentre quel mantenimento è in vigore, un `/effort` non interattivo segnala `Not applied`, quindi passa `--effort` all'avvio.611Quando imposti un livello con `/effort` in un'esecuzione [`-p`](/docs/it/headless), Claude Code lo applica solo a quella sessione e non lo salva come predefinito.

612 612

613Il menu `/effort` offre anche `ultracode`. Ultracode è un'impostazione di Claude Code piuttosto che un livello di sforzo del modello: invia `xhigh` al modello e inoltre ha Claude orchestrare [flussi di lavoro dinamici](/docs/it/workflows) per attività sostanziali. Per dove può essere impostato in modo persistente, vedere l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode).613Il menu `/effort` offre anche `ultracode`. Ultracode è un'impostazione di Claude Code piuttosto che un livello di sforzo del modello: invia `xhigh` al modello e inoltre ha Claude orchestrare [flussi di lavoro dinamici](/docs/it/workflows) per attività sostanziali. Per dove può essere impostato in modo persistente, vedere l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode).

614 614

642| Livello | Quando usarlo |642| Livello | Quando usarlo |

643| :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |643| :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

644| `low` | Riservato per attività brevi, circoscritte e sensibili alla latenza che non sono sensibili all'intelligenza |644| `low` | Riservato per attività brevi, circoscritte e sensibili alla latenza che non sono sensibili all'intelligenza |

645| `medium` | Riduce l'utilizzo di token per il lavoro sensibile ai costi che può scambiare un po' di intelligenza |645| `medium` | Riduce l'utilizzo di token per il lavoro sensibile ai costi che può scambiare un po' di intelligenza. Il predefinito su Opus 5.5 |

648| `max` | Può migliorare le prestazioni su attività impegnative ma può mostrare rendimenti decrescenti ed è soggetto a eccesso di riflessione. Prova prima di adottare ampiamente |648| `max` | Può migliorare le prestazioni su attività impegnative ma può mostrare rendimenti decrescenti ed è soggetto a eccesso di riflessione. Prova prima di adottare ampiamente |

649| `ultracode` | Un'impostazione di Claude Code che pianifica un [flusso di lavoro dinamico](/docs/it/workflows) per ogni attività sostanziale con ragionamento `xhigh` per messaggio |649| `ultracode` | Un'impostazione di Claude Code che pianifica un [flusso di lavoro dinamico](/docs/it/workflows) per ogni attività sostanziale con ragionamento `xhigh` per messaggio |

667* **Flag `--effort`**: passa un nome di livello per impostarlo per una singola sessione quando avvii Claude Code667* **Flag `--effort`**: passa un nome di livello per impostarlo per una singola sessione quando avvii Claude Code

668* **Variabile di ambiente**: imposta `CLAUDE_CODE_EFFORT_LEVEL` su un nome di livello o `auto`668* **Variabile di ambiente**: imposta `CLAUDE_CODE_EFFORT_LEVEL` su un nome di livello o `auto`

669* **Impostazioni**: imposta un livello per modello in [`modelSettings`](/docs/it/settings-reference#modelsettings), o imposta [`effortLevel`](/docs/it/settings-reference#effortlevel) su `low`, `medium`, `high` o `xhigh` come predefinito per i modelli senza uno. `max` non è accettato in nessuna delle due chiavi, e `ultracode` ha la sua propria chiave [`ultracode`](/docs/it/settings-reference#ultracode)669* **Impostazioni**: imposta un livello per modello in [`modelSettings`](/docs/it/settings-reference#modelsettings), o imposta [`effortLevel`](/docs/it/settings-reference#effortlevel) su `low`, `medium`, `high` o `xhigh` come predefinito per i modelli senza uno. `max` non è accettato in nessuna delle due chiavi, e `ultracode` ha la sua propria chiave [`ultracode`](/docs/it/settings-reference#ultracode)

670* **Da un dispositivo connesso**: in una sessione [Remote Control](/docs/it/remote-control#what-connected-devices-see), scegli un livello dal controllo dello sforzo sul tuo telefono o nel tuo browser. Il livello si applica solo alla sessione corrente, anche se termina anche il [mantenimento dello sforzo predefinito del modello](#adjust-effort-level). Richiede Claude Code v2.1.234 o successiva670* **Da un dispositivo connesso**: in una sessione [Remote Control](/docs/it/remote-control#what-connected-devices-see), scegli un livello dal controllo dello sforzo sul tuo telefono o nel tuo browser. Il livello si applica solo alla sessione corrente. Richiede Claude Code v2.1.234 o successiva

671* **Frontmatter di skill e subagente**: imposta `effort` in un file markdown [skill](/docs/it/skills#frontmatter-reference) o [subagente](/docs/it/sub-agents#supported-frontmatter-fields) per sostituire il livello di sforzo quando quella skill o subagente viene eseguito671* **Frontmatter di skill e subagente**: imposta `effort` in un file markdown [skill](/docs/it/skills#frontmatter-reference) o [subagente](/docs/it/sub-agents#supported-frontmatter-fields) per sostituire il livello di sforzo quando quella skill o subagente viene eseguito

672 672

673Lo sforzo del frontmatter si applica quando quella skill o subagente è attivo, sostituendo il livello della sessione ma non la variabile di ambiente. Un [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) o [limite di sforzo dell'organizzazione](#organization-effort-limits) limita comunque il livello a cui la skill o il subagente viene eseguito.673Lo sforzo del frontmatter si applica quando quella skill o subagente è attivo, sostituendo il livello della sessione ma non la variabile di ambiente. Un [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) o [limite di sforzo dell'organizzazione](#organization-effort-limits) limita comunque il livello a cui la skill o il subagente viene eseguito.

674 674

675Su Fable 5, Opus 4.8 e Opus 4.7, lo sforzo del frontmatter si applica anche mentre il [mantenimento dello sforzo predefinito del modello](#adjust-effort-level) è in vigore. Prima della v2.1.267, il mantenimento aveva la precedenza e Claude Code ignorava il livello del frontmatter mentre il mantenimento era attivo.

~~676~~

677Se imposti `effortLevel` nelle [impostazioni gestite](/docs/it/managed-settings), Claude Code lo applica al passo delle impostazioni dell'[ordine di risoluzione dello sforzo](#adjust-effort-level), e gli utenti possono comunque modificare il livello con `/effort` o `--effort`. Per mantenere gli utenti a o sotto un livello, imposta [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel).675Se imposti `effortLevel` nelle [impostazioni gestite](/docs/it/managed-settings), Claude Code lo applica al passo delle impostazioni dell'[ordine di risoluzione dello sforzo](#adjust-effort-level), e gli utenti possono comunque modificare il livello con `/effort` o `--effort`. Per mantenere gli utenti a o sotto un livello, imposta [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel).

678 676

679Il cursore dello sforzo appare in `/model` quando è selezionato un modello supportato. Il livello di sforzo corrente è anche mostrato nell'intestazione della sessione accanto al nome del modello, ad esempio "con sforzo basso", in modo che tu possa confermare quale impostazione è attiva senza aprire `/model`. Il piè di pagina mostra anche brevemente il livello di sforzo all'avvio e quando cambia.677Il cursore dello sforzo appare in `/model` quando è selezionato un modello supportato. Il livello di sforzo corrente è anche mostrato nell'intestazione della sessione accanto al nome del modello, ad esempio "con sforzo basso", in modo che tu possa confermare quale impostazione è attiva senza aprire `/model`. Il piè di pagina mostra anche brevemente il livello di sforzo all'avvio e quando cambia.

695Il pensiero esteso è il ragionamento che Claude emette prima di rispondere. Sui modelli che supportano il [ragionamento adattivo](#adjust-effort-level), il livello di sforzo è il controllo primario per quanto pensiero accade; le impostazioni di seguito attivano o disattivano il pensiero e controllano come viene visualizzato. Con il pensiero disattivato su Anthropic API, Claude Code invia sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.693Il pensiero esteso è il ragionamento che Claude emette prima di rispondere. Sui modelli che supportano il [ragionamento adattivo](#adjust-effort-level), il livello di sforzo è il controllo primario per quanto pensiero accade; le impostazioni di seguito attivano o disattivano il pensiero e controllano come viene visualizzato. Con il pensiero disattivato su Anthropic API, Claude Code invia sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

696 694

697| Controllo | Come impostarlo |695| Controllo | Come impostarlo |

698| :------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |696| :------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

701| 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 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) |699| Disabilita tramite una variabile di ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il pensiero su Anthropic API tranne sui modelli Opus 5.5 e Fable. Su [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette il parametro `thinking`, e i modelli di ragionamento adattivo potrebbero comunque pensare. Altri valori si applicano solo con un [budget di pensiero fisso](#adaptive-reasoning-and-fixed-thinking-budgets) |

702 700

703Non puoi disattivare il pensiero sui modelli Fable. L'attivazione/disattivazione della sessione, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` non hanno effetto lì, e un modello Fable decide per passo quanto pensare in base al livello di sforzo.701Non puoi disattivare il pensiero sui modelli Opus 5.5 o Fable. L'attivazione/disattivazione della sessione, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` non hanno effetto lì, e il modello decide per passo quanto pensare in base al livello di sforzo.

704 702

705Claude Code comprime l'output di pensiero per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedi il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di pensiero redatti per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](/docs/it/settings) se desideri i riassunti completi disponibili quando espandi. Ti viene addebitato per tutti i token di pensiero generati, anche quando compressi o redatti.703Claude Code comprime l'output di pensiero per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedi il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di pensiero redatti per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](/docs/it/settings) se desideri i riassunti completi disponibili quando espandi. Ti viene addebitato per tutti i token di pensiero generati, anche quando compressi o redatti.

706 704

786Se non si imposta una finestra auto-compact, Claude Code compatta quando la conversazione raggiunge il limite di contesto del modello, tranne in queste sessioni:784Se non si imposta una finestra auto-compact, Claude Code compatta quando la conversazione raggiunge il limite di contesto del modello, tranne in queste sessioni:

787 785

788* Le [sessioni cloud](/docs/it/claude-code-on-the-web) si compattano mentre la conversazione si avvicina al limite del modello786* Le [sessioni cloud](/docs/it/claude-code-on-the-web) si compattano mentre la conversazione si avvicina al limite del modello

789* Sonnet 4.6 e Opus 4.6 senza [contesto esteso](#extended-context) si compattano al limite di 200K, così come Opus 4.8 e Opus 5 quando vengono eseguiti con una finestra di contesto di 200K, come su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry787* Sonnet 4.6 e Opus 4.6 senza [contesto esteso](#extended-context) si compattano al limite di 200K, così come Opus 4.8 e versioni successive quando vengono eseguiti con una finestra di contesto di 200K, come su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry

790* Quando si imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars), i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K788* Quando si imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars), i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K

791* I modelli in esecuzione con una finestra nativa di 1M, come Sonnet 5, i modelli Fable e Opus 4.7 e versioni successive su Anthropic API, si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, [Pin models for third-party deployments](#pin-models-for-third-party-deployments) indica quali modelli vengono eseguiti con quella finestra; per le configurazioni che assegnano a Sonnet 5 200K, vedere [Sonnet 5 context window](#sonnet-5-context-window)789* I modelli in esecuzione con una finestra nativa di 1M, come Sonnet 5, i modelli Fable e Opus 4.7 e versioni successive su Anthropic API, si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, [Pin models for third-party deployments](#pin-models-for-third-party-deployments) indica quali modelli vengono eseguiti con quella finestra; per le configurazioni che assegnano a Sonnet 5 200K, vedere [Sonnet 5 context window](#sonnet-5-context-window)

792* Le sessioni su un ID modello che Claude Code non riconosce, come un alias [LLM gateway](/docs/it/llm-gateway), si compattano alla finestra di contesto che Claude Code assume per l'ID; vedere [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)790* Le sessioni su un ID modello che Claude Code non riconosce, come un alias [LLM gateway](/docs/it/llm-gateway), si compattano alla finestra di contesto che Claude Code assume per l'ID; vedere [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

831Questo esempio imposta tutte e tre le variabili per rendere selezionabile una distribuzione Opus instradata tramite gateway. Claude Code legge le variabili di ambiente all'avvio, quindi eseguire gli export prima di lanciare `claude`, o riavviare una sessione esistente per applicarle:829Questo esempio imposta tutte e tre le variabili per rendere selezionabile una distribuzione Opus instradata tramite gateway. Claude Code legge le variabili di ambiente all'avvio, quindi eseguire gli export prima di lanciare `claude`, o riavviare una sessione esistente per applicarle:

832 830

833```bash theme={null}831```bash theme={null}

834export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"832export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5-5"

835export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"833export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"

836export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"834export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

837```835```

847 845

848Quando [`availableModels`](#restrict-model-selection) è impostato, includere l'ID del modello personalizzato anche nell'elenco di autorizzazione. Altrimenti Claude Code filtra la voce personalizzata dal selettore e rifiuta una selezione `--model` di essa come qualsiasi altro modello escluso.846Quando [`availableModels`](#restrict-model-selection) è impostato, includere l'ID del modello personalizzato anche nell'elenco di autorizzazione. Altrimenti Claude Code filtra la voce personalizzata dal selettore e rifiuta una selezione `--model` di essa come qualsiasi altro modello escluso.

849 847

850Un ID personalizzato che incorpora un nome di famiglia, come `my-gateway/claude-opus-5`, conta come una voce specifica per quella famiglia e disabilita il suo wildcard, quindi elencare anche le versioni che intendete mantenere selezionabili. Vedere [Comportamento di unione](#merge-behavior).848Un ID personalizzato che incorpora un nome di famiglia, come `my-gateway/claude-opus-5-5`, conta come una voce specifica per quella famiglia e disabilita il suo wildcard, quindi elencare anche le versioni che intendete mantenere selezionabili. Vedere [Comportamento di unione](#merge-behavior).

851 849

852<h2 id="environment-variables">850<h2 id="environment-variables">

853 Variabili di ambiente851 Variabili di ambiente

monitoring-usage.md +257 −196

Details

123| `OTEL_LOG_ASSISTANT_RESPONSES` | Abilita la registrazione del testo della risposta dell'assistente negli eventi `assistant_response` (predefinito: disabilitato). Se non impostato, ricade al valore di `OTEL_LOG_USER_PROMPTS`. Richiede Claude Code v2.1.193 o successivo | `1` per abilitare, `0` per mantenerlo oscurato |123| `OTEL_LOG_ASSISTANT_RESPONSES` | Abilita la registrazione del testo della risposta dell'assistente negli eventi `assistant_response` (predefinito: disabilitato). Se non impostato, ricade al valore di `OTEL_LOG_USER_PROMPTS`. Richiede Claude Code v2.1.193 o successivo | `1` per abilitare, `0` per mantenerlo oscurato |

124| `OTEL_LOG_TOOL_DETAILS` | Abilita la registrazione dei parametri dello strumento e degli argomenti di input negli eventi dello strumento e negli attributi di span di traccia: comandi Bash, nomi dei server e degli strumenti MCP, nomi delle skill, nomi dei workflow creati dall'utente e input degli strumenti. Abilita anche i nomi dei comandi personalizzati, plugin e MCP negli eventi `user_prompt` (predefinito: disabilitato). Per i server integrati di Claude Desktop, nelle sessioni di proprietà di Claude Desktop, `mcp_server_name`/`mcp_tool_name` vengono emessi su `tool_decision`/`tool_result` anche con il flag disattivato. L'eccezione richiede Claude Code v2.1.214 o successivo | `1` per abilitare |124| `OTEL_LOG_TOOL_DETAILS` | Abilita la registrazione dei parametri dello strumento e degli argomenti di input negli eventi dello strumento e negli attributi di span di traccia: comandi Bash, nomi dei server e degli strumenti MCP, nomi delle skill, nomi dei workflow creati dall'utente e input degli strumenti. Abilita anche i nomi dei comandi personalizzati, plugin e MCP negli eventi `user_prompt` (predefinito: disabilitato). Per i server integrati di Claude Desktop, nelle sessioni di proprietà di Claude Desktop, `mcp_server_name`/`mcp_tool_name` vengono emessi su `tool_decision`/`tool_result` anche con il flag disattivato. L'eccezione richiede Claude Code v2.1.214 o successivo | `1` per abilitare |

125| `OTEL_LOG_TOOL_CONTENT` | Abilita la registrazione del contenuto dello strumento nell'evento di span [`tool.output`](#tool-output-span-event) (predefinito: disabilitato). Gli attributi di span portano il contenuto dello strumento secondo i loro [gate specifici](#new-context-gates). Richiede [tracce](#traces-beta). Il contenuto viene troncato al limite di contenuto (60 KB per impostazione predefinita) | `1` per abilitare |125| `OTEL_LOG_TOOL_CONTENT` | Abilita la registrazione del contenuto dello strumento nell'evento di span [`tool.output`](#tool-output-span-event) (predefinito: disabilitato). Gli attributi di span portano il contenuto dello strumento secondo i loro [gate specifici](#new-context-gates). Richiede [tracce](#traces-beta). Il contenuto viene troncato al limite di contenuto (60 KB per impostazione predefinita) | `1` per abilitare |

126| `OTEL_LOG_MANAGED_SETTINGS` | Aggiungi le impostazioni gestite oscurate e un digest SHA-256 delle impostazioni prima dell'oscuramento agli eventi [managed settings resolved](#managed-settings-resolved-event) (predefinito: disabilitato). Un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo | `1` per abilitare |

126| `OTEL_LOG_RAW_API_BODIES` | Emetti il corpo completo della richiesta e della risposta JSON dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body` (predefinito: disabilitato). I corpi includono l'intera cronologia della conversazione. L'abilitazione di questa opzione implica il consenso a tutto ciò che `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, e `OTEL_LOG_TOOL_CONTENT` rivelerebbero | `1` per corpi inline troncati al limite di contenuto (60 KB per impostazione predefinita), o `file:<dir>` per corpi non troncati su disco con un puntatore `body_ref` nell'evento |127| `OTEL_LOG_RAW_API_BODIES` | Emetti il corpo completo della richiesta e della risposta JSON dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body` (predefinito: disabilitato). I corpi includono l'intera cronologia della conversazione. L'abilitazione di questa opzione implica il consenso a tutto ciò che `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, e `OTEL_LOG_TOOL_CONTENT` rivelerebbero | `1` per corpi inline troncati al limite di contenuto (60 KB per impostazione predefinita), o `file:<dir>` per corpi non troncati su disco con un puntatore `body_ref` nell'evento |

127| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite di contenuto: la lunghezza massima degli attributi che portano contenuto come risposte del modello, contenuto dello strumento, prompt di sistema e corpi API grezzi, marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, cioè 60 KB). Il predefinito è dimensionato per backend che limitano i valori degli attributi a 64 KB; aumentalo solo se il tuo backend accetta valori più grandi, o riducilo per tagliare il volume della telemetria. Quando un limite di attributo dell'SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` o uno dei suoi varianti logrecord e span, è impostato più basso, Claude Code tronca a quel valore più piccolo in modo che il marcatore `[TRUNCATED ...]` rimanga entro il limite dell'SDK. Richiede Claude Code v2.1.214 o successivo | `262144` |128| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite di contenuto: la lunghezza massima degli attributi che portano contenuto come risposte del modello, contenuto dello strumento, prompt di sistema e corpi API grezzi, marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, cioè 60 KB). Il predefinito è dimensionato per backend che limitano i valori degli attributi a 64 KB; aumentalo solo se il tuo backend accetta valori più grandi, o riducilo per tagliare il volume della telemetria. Quando un limite di attributo dell'SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` o uno dei suoi varianti logrecord e span, è impostato più basso, Claude Code tronca a quel valore più piccolo in modo che il marcatore `[TRUNCATED ...]` rimanga entro il limite dell'SDK. Richiede Claude Code v2.1.214 o successivo | `262144` |

128| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferenza di temporalità delle metriche (predefinito: `delta`). Imposta su `cumulative` se il tuo backend prevede temporalità cumulativa | `delta`, `cumulative` |129| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferenza di temporalità delle metriche (predefinito: `delta`). Imposta su `cumulative` se il tuo backend prevede temporalità cumulativa | `delta`, `cumulative` |

241| `workflow.run_id` | Identificatore di esecuzione della [Workflow](/docs/it/workflows) tool run che ha generato questo agente, con prefisso `wf_`. Assente per gli agenti non generati da un workflow | |242| `workflow.run_id` | Identificatore di esecuzione della [Workflow](/docs/it/workflows) tool run che ha generato questo agente, con prefisso `wf_`. Assente per gli agenti non generati da un workflow | |

242| `workflow.name` | Nome del workflow che ha generato questo agente. I nomi creati dall'utente vengono sostituiti con `custom` a meno che il gate non sia impostato | `OTEL_LOG_TOOL_DETAILS` |243| `workflow.name` | Nome del workflow che ha generato questo agente. I nomi creati dall'utente vengono sostituiti con `custom` a meno che il gate non sia impostato | `OTEL_LOG_TOOL_DETAILS` |

245| `effort` | [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `low`, `medium`, `high`, `xhigh`, o `max`. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo. Richiede Claude Code v2.1.274 o successivo | |

385echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"387echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

386```388```

387 389

388Se l'helper non riesce o stampa output che non soddisfa questi requisiti, Claude Code segnala l'errore in:390Se l'helper non riesce o stampa output che non soddisfa questi requisiti, le esportazioni non riescono e il tuo backend di telemetria non riceve nulla dalla sessione fino a quando l'helper non funziona di nuovo. Claude Code segnala l'errore in:

389 391

392* Una notifica di avviso nelle sessioni interattive, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/it/errors#otelheadershelper-failed), mostrata una volta per sessione quando l'helper non riesce per la prima volta

390* Output di `/status`393* Output di `/status`

391* Il log di debug, quando si esegue con [`--debug`](/docs/it/cli-reference#cli-flags) o dopo aver eseguito `/debug` nella sessione394* Il log di debug, quando si esegue con [`--debug`](/docs/it/cli-reference#cli-flags) o dopo aver eseguito `/debug` nella sessione

392* stderr, in sessioni non interattive avviate con `-p`395* stderr, in sessioni non interattive avviate con `-p`

514```517```

515 518

516<h2 id="available-metrics-and-events">519<h2 id="available-metrics-and-events">

517 Metriche e eventi disponibili520 Metriche ed eventi disponibili

518</h2>521</h2>

519 522

520<h3 id="standard-attributes">523<h3 id="standard-attributes">

525 528

527| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |530| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |

530| `app.entrypoint` | Come la sessione è stata avviata, come `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, o `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (predefinito: false) |533| `app.entrypoint` | Come è stata avviata la sessione, ad esempio `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, o `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (predefinito: false) |

533| `user.account_id` | ID dell'account in formato taggato corrispondente alle API di amministrazione Anthropic (quando autenticato), come `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (predefinito: true) |536| `user.account_id` | ID dell'account in formato etichettato corrispondente alle API di amministrazione Anthropic (quando autenticato), ad esempio `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (predefinito: true) |

534| `user.id` | Identificatore anonimo casuale generato al primo avvio e persistente in `~/.claude.json`. Non contiene informazioni personali e non è derivato dal tuo account Claude. L'eliminazione del file produce un nuovo valore non correlato al prossimo avvio. | Sempre incluso |537| `user.id` | Identificatore anonimo casuale generato al primo avvio e persistente in `~/.claude.json`. Non contiene informazioni personali e non è derivato dal tuo account Claude. L'eliminazione del file produce un nuovo valore non correlato al prossimo avvio. | Sempre incluso |

535| `user.email` | Indirizzo email dell'utente, dal tuo accesso o, in una [sessione cloud](/docs/it/claude-code-on-the-web), dalle credenziali della sessione stessa | Sempre incluso quando disponibile |538| `user.email` | Indirizzo email dell'utente, dal tuo accesso o, in una [sessione cloud](/docs/it/claude-code-on-the-web), dalle credenziali della sessione stessa | Sempre incluso quando disponibile |

537| Chiavi da `OTEL_RESOURCE_ATTRIBUTES` | Attributi personalizzati che imposti, come `department` o `team.id`. Vedi [Supporto per organizzazioni multi-team](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (predefinito: true) |540| Chiavi da `OTEL_RESOURCE_ATTRIBUTES` | Attributi personalizzati che imposti, ad esempio `department` o `team.id`. Vedi [Supporto per organizzazioni multi-team](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (predefinito: true) |

538| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | L'identità del repository della sessione, derivata dal suo remote `origin`. Vedi [Attributi del repository](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (predefinito: false). Richiede Claude Code v2.1.269 o successivo |541| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | L'identità del repository della sessione, derivata dal suo remote `origin`. Vedi [Attributi del repository](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (predefinito: false). Richiede Claude Code v2.1.269 o successivo |

539 542

540Quando Claude Code è connesso a un [gateway di app Claude](/docs/it/claude-apps-gateway), la CLI contrassegna le esportazioni con l'identità autenticata dalla sessione del gateway: `user.id` è il soggetto IdP piuttosto che un identificatore di installazione anonimo, `user.email` è l'email connessa, e `user.groups` contiene l'appartenenza al gruppo IdP come stringa separata da virgole. Ogni esportazione contiene anche `identity.source: gateway-oidc`. L'identità del gateway viene applicata per ultima, quindi le chiavi `user.*` e `identity.*` impostate tramite `OTEL_RESOURCE_ATTRIBUTES` vengono ignorate nelle sessioni del gateway.543Quando Claude Code è autenticato in un [gateway di app Claude](/docs/it/claude-apps-gateway), la CLI contrassegna le esportazioni con l'identità autenticata dalla sessione del gateway: `user.id` è il soggetto IdP piuttosto che un identificatore di installazione anonimo, `user.email` è l'email con cui hai effettuato l'accesso, e `user.groups` contiene l'appartenenza al gruppo IdP come stringa separata da virgole. Ogni esportazione contiene anche `identity.source: gateway-oidc`. L'identità del gateway viene applicata per ultima, quindi le chiavi `user.*` e `identity.*` impostate tramite `OTEL_RESOURCE_ATTRIBUTES` vengono ignorate nelle sessioni del gateway.

541 544

542Gli eventi includono inoltre i seguenti attributi. Questi non vengono mai allegati alle metriche perché causerebbero cardinalità illimitata:545Gli eventi includono inoltre i seguenti attributi. Questi non vengono mai allegati alle metriche perché causerebbero cardinalità illimitata:

543 546

544* `prompt.id`: UUID che correla un prompt dell'utente con tutti gli eventi successivi fino al prompt successivo. Vedi [Attributi di correlazione degli eventi](#event-correlation-attributes).547* `prompt.id`: UUID che correla un prompt dell'utente con tutti gli eventi successivi fino al prompt successivo. Vedi [Attributi di correlazione degli eventi](#event-correlation-attributes).

545* `workspace.host_paths`: directory dell'area di lavoro host selezionate nell'app desktop, come array di stringhe548* `workspace.host_paths`: directory dell'area di lavoro host selezionate nell'app desktop, come array di stringhe

546* `workflow.run_id`: identificatore di esecuzione, con prefisso `wf_`, sugli eventi API e degli strumenti emessi da agenti che appartengono a un'esecuzione dello strumento [Workflow](/docs/it/workflows). Filtrando gli eventi per un `workflow.run_id` si ricostruisce l'esecuzione delle richieste API e dei risultati degli strumenti. L'identificatore copre gli agenti che lo script del workflow genera e tutti gli agenti che questi generano a loro volta, come le invocazioni di skill. Corrisponde all'identificatore di esecuzione segnalato nel risultato dello strumento Workflow. Assente su tutti gli altri eventi. Richiede Claude Code v2.1.202 o successivo549* `workflow.run_id`: identificatore di esecuzione, con prefisso `wf_`, sugli eventi API e degli strumenti emessi da agenti che appartengono a un'esecuzione dello strumento [Workflow](/docs/it/workflows). Il filtraggio degli eventi per un `workflow.run_id` ricostruisce le richieste API e i risultati degli strumenti di quella esecuzione. L'identificatore copre gli agenti che lo script del workflow genera e tutti gli agenti che questi generano a loro volta, ad esempio le invocazioni di skill. Corrisponde all'identificatore di esecuzione riportato nel risultato dello strumento Workflow. Assente su tutti gli altri eventi. Richiede Claude Code v2.1.202 o successivo

547* `workflow.name`: nome del workflow, il `meta.name` del suo script, emesso insieme a `workflow.run_id`. I nomi dei workflow incorporati vengono visualizzati così come sono quando l'esecuzione esegue lo script incorporato non modificato. I nomi creati dall'utente, incluse le copie modificate degli script incorporati, vengono sostituiti con `custom` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato. Richiede Claude Code v2.1.202 o successivo550* `workflow.name`: nome del workflow, il `meta.name` dello script, emesso insieme a `workflow.run_id`. I nomi dei workflow incorporati vengono visualizzati letteralmente quando l'esecuzione esegue lo script incorporato non modificato. I nomi creati dall'utente, incluse le copie modificate degli script incorporati, vengono sostituiti con `custom` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato. Richiede Claude Code v2.1.202 o successivo

548 551

549<h4 id="repository-attributes">552<h4 id="repository-attributes">

550 Attributi del repository553 Attributi del repository

551</h4>554</h4>

552 555

553Imposta `OTEL_METRICS_INCLUDE_REPOSITORY=true` per taggare le metriche e gli eventi con l'identità del repository della sessione, in modo che un collector condiviso possa attribuire l'utilizzo per repository. Richiede Claude Code v2.1.269 o successivo.556Imposta `OTEL_METRICS_INCLUDE_REPOSITORY=true` per etichettare metriche ed eventi con l'identità del repository della sessione, in modo che un collector condiviso possa attribuire l'utilizzo per repository. Richiede Claude Code v2.1.269 o successivo.

554 557

555Claude Code deriva questi attributi una volta per sessione dal remote `origin` del repository. I remote HTTPS e SSH di un repository producono valori identici:558Claude Code deriva questi attributi una volta per sessione dal remote `origin` del repository. I remote HTTPS e SSH di un repository producono valori identici:

556 559

557| Attributo | Valore |560| Attributo | Valore |

558| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |561| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

559| `vcs.repository.url.full` | L'URL del browser del repository senza `.git`, come `https://github.com/example-org/example-repo` |562| `vcs.repository.url.full` | L'URL del browser del repository senza `.git`, ad esempio `https://github.com/example-org/example-repo` |

560| `vcs.owner.name` | Il percorso del proprietario o del gruppo, come `example-org`; omesso quando il percorso remoto ha un singolo segmento |563| `vcs.owner.name` | Il percorso del proprietario o del gruppo, ad esempio `example-org`; omesso quando il percorso remoto ha un singolo segmento |

562| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, o `gitea` quando Claude Code riconosce l'host remoto o la forma dell'URL come uno di questi provider; omesso altrimenti |565| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, o `gitea` quando Claude Code riconosce l'host remoto o la forma dell'URL come uno di questi provider; omesso altrimenti |

563 566

564I valori sono minuscoli, e le credenziali, le stringhe di query e i frammenti dall'URL remoto non compaiono mai in essi. Gli attributi vengono omessi quando la sessione non ha un remote `origin`, quando il remote non è a forma di URL, o quando l'unico repository che lo racchiude è la tua directory home.567I valori sono in minuscolo e le credenziali, le stringhe di query e i frammenti dall'URL remoto non compaiono mai in essi. Gli attributi vengono omessi quando la sessione non ha un remote `origin`, quando il remote non ha forma di URL, o quando l'unico repository che lo racchiude è la tua directory home.

565 568

566Una chiave `vcs.*` che dichiari in [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) sostituisce il valore derivato per quella chiave. Se dichiari `vcs.repository.url.full`, Claude Code non legge mai il remote e segnala solo le chiavi che dichiari.569Una chiave `vcs.*` che dichiari in [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) sostituisce il valore derivato per quella chiave. Se dichiari `vcs.repository.url.full`, Claude Code non legge mai il remote e riporta solo le chiavi che dichiari.

567 570

568Gli attributi fluiscono solo ai tuoi esportatori; la telemetria di Anthropic elimina ogni chiave `vcs.*`.571Gli attributi fluiscono solo ai tuoi esportatori; la telemetria di Anthropic elimina ogni chiave `vcs.*`.

569 572

571 Metriche574 Metriche

572</h3>575</h3>

573 576

574Claude Code esporta le seguenti metriche. La colonna Unit mostra la stringa di unità OpenTelemetry allegata a ogni metrica; le metriche di conteggio non ne hanno alcuna.577Claude Code esporta le seguenti metriche. La colonna Unit mostra la stringa di unità OpenTelemetry allegata a ogni metrica; le metriche di conteggio non ne hanno.

575 578

577| ------------------------------------- | ---------------------------------------------------------------------------------- | ------ |580| ------------------------------------- | ---------------------------------------------------------------------------------- | ------- |

582| `claude_code.cost.usage` | Costo della sessione Claude Code | USD |585| `claude_code.cost.usage` | Costo della sessione Claude Code | USD |

585| `claude_code.active_time.total` | Tempo attivo totale | s |588| `claude_code.active_time.total` | Tempo attivo totale | s |

586 589

587Quando `prometheus` è l'unico esportatore elencato in `OTEL_METRICS_EXPORTER`, Claude Code omette le unità `USD`, `tokens`, e `s` dalle metriche esportate in modo che lo scrape rimanga in formato testo Prometheus valido. I nomi delle metriche non cambiano, e le configurazioni che combinano esportatori, come `otlp,prometheus`, mantengono le unità. Prima della v2.1.216, lo scrape Prometheus includeva righe `# UNIT` solo OpenMetrics che alcuni scraper rifiutavano.590Quando `prometheus` è l'unico esportatore elencato in `OTEL_METRICS_EXPORTER`, Claude Code omette le unità `USD`, `token`, e `s` dalle metriche esportate in modo che lo scrape rimanga in formato testo Prometheus valido. I nomi delle metriche non cambiano e le configurazioni che combinano esportatori, come `otlp,prometheus`, mantengono le unità. Prima della v2.1.216, lo scrape Prometheus includeva righe `# UNIT` solo OpenMetrics che alcuni scraper rifiutavano.

588 591

589<h3 id="metric-details">592<h3 id="metric-details">

590 Dettagli delle metriche593 Dettagli delle metriche

591</h3>594</h3>

592 595

593Ogni metrica include gli attributi standard elencati sopra. Le metriche con attributi aggiuntivi specifici del contesto sono indicate di seguito.596Ogni metrica include gli attributi standard elencati sopra. Le metriche con attributi aggiuntivi specifici del contesto sono annotate di seguito.

594 597

595<h4 id="session-counter">598<h4 id="session-counter">

596 Contatore di sessione599 Contatore di sessione

601**Attributi**:604**Attributi**:

602 605

603* Tutti gli [attributi standard](#standard-attributes)606* Tutti gli [attributi standard](#standard-attributes)

604* `start_type`: Come la sessione è stata avviata. Uno di `"fresh"`, `"resume"`, `"continue"`, o `"agents_view"`. Il valore `"agents_view"` identifica il processo della dashboard `claude agents`, un'interfaccia utente locale avviata dall'utente piuttosto che una sessione conversazionale. Filtra su questo valore per separare i lanci del processo UI dalle sessioni conversazionali nei tuoi dashboard.607* `start_type`: Come è stata avviata la sessione. Uno di `"fresh"`, `"resume"`, `"continue"`, o `"agents_view"`. Il valore `"agents_view"` identifica il processo dashboard `claude agents`, un'interfaccia utente locale avviata dall'utente piuttosto che una sessione conversazionale. Filtra su questo valore per separare i lanci del processo UI dalle sessioni conversazionali nei tuoi dashboard.

605 608

606<h4 id="lines-of-code-counter">609<h4 id="lines-of-code-counter">

607 Contatore di righe di codice610 Contatore di righe di codice

613 616

614* Tutti gli [attributi standard](#standard-attributes)617* Tutti gli [attributi standard](#standard-attributes)

615* `type`: (`"added"`, `"removed"`)618* `type`: (`"added"`, `"removed"`)

616* `model`: Identificatore del modello per il modello che ha effettuato la modifica (ad esempio, "claude-sonnet-5")619* `model`: Identificatore del modello per il modello che ha apportato la modifica (ad esempio, "claude-sonnet-5")

617 620

618<h4 id="pull-request-counter">621<h4 id="pull-request-counter">

619 Contatore di pull request622 Contatore di pull request

620</h4>623</h4>

621 624

622Incrementato quando Claude Code crea una pull request o merge request tramite un comando shell o uno strumento MCP.625Incrementato quando Claude Code crea una pull request o una merge request tramite un comando shell o uno strumento MCP.

623 626

624**Attributi**:627**Attributi**:

625 628

647* `model`: Identificatore del modello (ad esempio, "claude-sonnet-5")650* `model`: Identificatore del modello (ad esempio, "claude-sonnet-5")

648* `query_source`: Categoria del sottosistema che ha emesso la richiesta. Uno di `"main"`, `"subagent"`, o `"auxiliary"`651* `query_source`: Categoria del sottosistema che ha emesso la richiesta. Uno di `"main"`, `"subagent"`, o `"auxiliary"`

649* `speed`: `"fast"` quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti652* `speed`: `"fast"` quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti

650* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Assente quando il modello non supporta lo sforzo.653* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo.

651* `agent.name`: Tipo di subagent che ha emesso la richiesta. I nomi degli agenti incorporati e i nomi degli agenti dai plugin del marketplace ufficiale vengono visualizzati così come sono. Gli altri nomi degli agenti definiti dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non è stata emessa da un tipo di subagent denominato.654* `agent.name`: Tipo di subagent che ha emesso la richiesta. I nomi degli agenti incorporati e gli agenti dai plugin del marketplace ufficiale vengono visualizzati letteralmente. Gli altri nomi di agenti definiti dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non è stata emessa da un tipo di subagent denominato.

652* `skill.name`: Skill attiva per la richiesta, impostata dallo strumento Skill, da un comando `/`, o ereditata da un subagent generato. I nomi delle skill incorporate, in bundle, definite dall'utente e dei plugin del marketplace ufficiale vengono visualizzati così come sono. I nomi delle skill dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando nessuna skill è attiva.655* `skill.name`: Skill attiva per la richiesta, impostata dallo strumento Skill, da un comando `/`, o ereditata da un subagent generato. I nomi delle skill incorporati, in bundle, definiti dall'utente e dai plugin del marketplace ufficiale vengono visualizzati letteralmente. I nomi delle skill dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando nessuna skill è attiva.

653* `plugin.name`: Plugin proprietario quando la skill attiva o il subagent è fornito da un plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati così come sono. I nomi dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando né la skill né il subagent hanno un plugin proprietario.656* `plugin.name`: Plugin proprietario quando la skill attiva o il subagent è fornito da un plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati letteralmente. I nomi dei plugin di terze parti vengono sostituiti con `"third-party"`. Assente quando né la skill né il subagent hanno un plugin proprietario.

654* `marketplace.name`: Marketplace da cui è stato installato il plugin proprietario. Emesso solo per i plugin del marketplace ufficiale. Assente altrimenti.657* `marketplace.name`: Marketplace da cui è stato installato il plugin proprietario. Emesso solo per i plugin del marketplace ufficiale. Assente altrimenti.

655* `mcp_server.name`: Server MCP il cui risultato dello strumento questa richiesta ha consumato. I nomi dei server incorporati, proxy di claude.ai, e del registro ufficiale vengono visualizzati così come sono. I nomi dei server configurati dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP. Prima della v2.1.222, Claude Code impostava questo attributo su ogni richiesta dopo una chiamata dello strumento MCP, non solo su richieste che hanno consumato un risultato dello strumento, quindi i dashboard che lo aggregano mostrano un calo dopo l'aggiornamento.658* `mcp_server.name`: Server MCP il cui risultato dello strumento questa richiesta ha consumato. I nomi dei server incorporati, proxy di claude.ai e del registro ufficiale vengono visualizzati letteralmente. I nomi dei server configurati dall'utente vengono sostituiti con `"custom"`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP. Prima della v2.1.222, Claude Code impostava questo attributo su ogni richiesta dopo una chiamata dello strumento MCP, non solo su richieste che consumavano un risultato dello strumento, quindi i dashboard che lo aggregano mostrano un calo dopo l'aggiornamento.

656* `mcp_tool.name`: Strumento MCP il cui risultato questa richiesta ha consumato, con lo stesso comportamento di oscuramento e di versione di `mcp_server.name`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP.659* `mcp_tool.name`: Strumento MCP il cui risultato questa richiesta ha consumato, con lo stesso comportamento di redazione e versione di `mcp_server.name`. Assente quando la richiesta non ha consumato alcun risultato dello strumento MCP.

657 660

658<h4 id="token-counter">661<h4 id="token-counter">

659 Contatore di token662 Contatore di token

669* `query_source`: Categoria del sottosistema che ha emesso la richiesta. Uno di `"main"`, `"subagent"`, o `"auxiliary"`672* `query_source`: Categoria del sottosistema che ha emesso la richiesta. Uno di `"main"`, `"subagent"`, o `"auxiliary"`

670* `speed`: `"fast"` quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti673* `speed`: `"fast"` quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti

671* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta. Vedi [Contatore di costo](#cost-counter) per i dettagli.674* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta. Vedi [Contatore di costo](#cost-counter) per i dettagli.

672* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di oscuramento.675* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di redazione.

673 676

674<h4 id="code-edit-tool-decision-counter">677<h4 id="code-edit-tool-decision-counter">

675 Contatore di decisione dello strumento di modifica del codice678 Contatore di decisioni dello strumento di modifica del codice

676</h4>679</h4>

677 680

678Incrementato quando l'utente accetta o rifiuta l'utilizzo dello strumento Edit, Write o NotebookEdit.681Incrementato quando l'utente accetta o rifiuta l'utilizzo dello strumento Edit, Write, o NotebookEdit.

679 682

680**Attributi**:683**Attributi**:

681 684

682* Tutti gli [attributi standard](#standard-attributes)685* Tutti gli [attributi standard](#standard-attributes)

683* `tool_name`: Nome dello strumento (`"Edit"`, `"Write"`, `"NotebookEdit"`)686* `tool_name`: Nome dello strumento (`"Edit"`, `"Write"`, `"NotebookEdit"`)

684* `decision`: Decisione dell'utente (`"accept"`, `"reject"`)687* `decision`: Decisione dell'utente (`"accept"`, `"reject"`)

685* `source`: Fonte della decisione. Uno di `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"`, o `"user_reject"`. Vedi l'[Evento di decisione dello strumento](#tool-decision-event) per il significato di ogni valore.688* `source`: Da dove proviene la decisione. Uno di `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"`, o `"user_reject"`. Vedi l'[evento di decisione dello strumento](#tool-decision-event) per il significato di ogni valore.

686* `language`: Linguaggio di programmazione del file modificato, come `"TypeScript"`, `"Python"`, `"JavaScript"`, o `"Markdown"`. Restituisce `"unknown"` per estensioni di file non riconosciute.689* `language`: Linguaggio di programmazione del file modificato, ad esempio `"TypeScript"`, `"Python"`, `"JavaScript"`, o `"Markdown"`. Restituisce `"unknown"` per estensioni di file non riconosciute.

687 690

688<h4 id="active-time-counter">691<h4 id="active-time-counter">

689 Contatore di tempo attivo692 Contatore di tempo attivo

690</h4>693</h4>

691 694

692Traccia il tempo effettivo trascorso utilizzando attivamente Claude Code, escludendo il tempo di inattività. Questa metrica viene incrementata durante le interazioni dell'utente, come la digitazione e la lettura delle risposte, e durante l'elaborazione CLI, come l'esecuzione degli strumenti e la generazione della risposta AI.695Traccia il tempo effettivo trascorso utilizzando attivamente Claude Code, escludendo il tempo di inattività. Questa metrica viene incrementata durante le interazioni dell'utente, come la digitazione e la lettura delle risposte, e durante l'elaborazione della CLI, come l'esecuzione degli strumenti e la generazione della risposta AI.

693 696

694**Attributi**:697**Attributi**:

695 698

706 Attributi di correlazione degli eventi709 Attributi di correlazione degli eventi

707</h4>710</h4>

708 711

709Quando un utente invia un prompt, Claude Code potrebbe effettuare più chiamate API ed eseguire diversi strumenti. L'attributo `prompt.id` ti consente di collegare tutti questi eventi al singolo prompt che li ha attivati.712Quando un utente invia un prompt, Claude Code può effettuare più chiamate API ed eseguire diversi strumenti. L'attributo `prompt.id` ti consente di collegare tutti questi eventi al singolo prompt che li ha attivati.

710 713

712| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |715| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

713| `prompt.id` | Identificatore UUID v4 che collega tutti gli eventi prodotti durante l'elaborazione di un singolo prompt dell'utente |716| `prompt.id` | Identificatore UUID v4 che collega tutti gli eventi prodotti durante l'elaborazione di un singolo prompt dell'utente |

714| `event.sequence` | Contatore a base 0 per ordinare gli eventi, contato per processo Claude Code piuttosto che per sessione |717| `event.sequence` | Contatore a base 0 per ordinare gli eventi, conteggiato per processo Claude Code piuttosto che per sessione |

715| `message.uuid` | UUID del messaggio come persistente nella trascrizione della sessione, i file `~/.claude/projects/*/*.jsonl`. Presente su `assistant_response`, e su `user_prompt` eccetto per i dispatching dei comandi, che possono produrre zero o molti messaggi. Su `assistant_response`, questa è la voce della trascrizione finale della risposta, da cui la `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo |718| `message.uuid` | UUID del messaggio come persistente nella trascrizione della sessione, i file `~/.claude/projects/*/*.jsonl`. Presente su `assistant_response`, su `api_response_body`, e su `user_prompt` eccetto per i dispatching dei comandi, che possono produrre zero o molti messaggi. Su `assistant_response` e `api_response_body`, questo è il messaggio finale della trascrizione della risposta, da cui il `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo, o v2.1.274 o successivo su `api_response_body` |

716| `client_request_id` | UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Presente su `api_request` e `api_error` su connessioni API di prima parte; assente su backend di provider di terze parti e quando la richiesta è stata ritentata tramite il fallback non-streaming. Accoppia una richiesta con la sua risposta e rimane disponibile per i guasti come i timeout che non hanno mai prodotto un `request_id` del server. Corrisponde allo stesso attributo sul span di traccia `llm_request`. Richiede Claude Code v2.1.214 o successivo |719| `client_request_id` | UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Presente su `api_request` e `api_error` su connessioni API di prima parte; assente su backend di provider di terze parti e quando la richiesta è stata ritentata tramite il fallback non in streaming. Accoppia una richiesta con la sua risposta e rimane disponibile per i guasti come i timeout che non hanno mai prodotto un `request_id` del server. Corrisponde allo stesso attributo sul span di traccia `llm_request`. Richiede Claude Code v2.1.214 o successivo |

717 720

718Per tracciare tutta l'attività attivata da un singolo prompt, filtra i tuoi eventi per un valore specifico di `prompt.id`. Questo restituisce l'evento user\_prompt, eventuali eventi api\_request, e eventuali eventi tool\_result che si sono verificati durante l'elaborazione di quel prompt.721Per tracciare tutta l'attività attivata da un singolo prompt, filtra i tuoi eventi per un valore specifico di `prompt.id`. Questo restituisce l'evento user\_prompt, tutti gli eventi api\_request, e tutti gli eventi tool\_result che si sono verificati durante l'elaborazione di quel prompt.

719 722

720`event.sequence` inizia a 0 ogni volta che un processo Claude Code si avvia e conta fino alla fine della vita di quel processo. Continua a contare attraverso `/clear`, che assegna un nuovo `session.id`. Se [riprendi una sessione senza fare un fork](/docs/it/how-claude-code-works#resume-or-fork-sessions), la sessione mantiene il suo `session.id` ma prende i suoi valori `event.sequence` dal processo che l'ha ripresa, quindi all'interno di una sessione un evento successivo può portare un valore inferiore a uno precedente, o ripetere uno. Per ordinare gli eventi di una sessione, ordina per `event.timestamp` e usa `event.sequence` per ordinare gli eventi che condividono un timestamp.723`event.sequence` inizia a 0 ogni volta che un processo Claude Code si avvia e conta fino alla fine della vita di quel processo. Continua a contare attraverso `/clear`, che assegna un nuovo `session.id`. Se [riprendi una sessione senza fare un fork](/docs/it/how-claude-code-works#resume-or-fork-sessions), la sessione mantiene il suo `session.id` ma prende i suoi valori `event.sequence` dal processo che l'ha ripresa, quindi all'interno di una sessione un evento successivo può portare un valore inferiore a uno precedente, o ripetere uno. Per ordinare gli eventi di una sessione, ordina per `event.timestamp` e usa `event.sequence` per ordinare gli eventi che condividono un timestamp.

721 724

722Per la ricostruzione a livello di messaggio, ogni classe di evento porta una chiave che corrisponde a un campo nella trascrizione della sessione. Il formato della voce della trascrizione è [interno a Claude Code](/docs/it/sessions#where-transcripts-are-stored) e cambia tra le versioni, quindi una pipeline che si unisce su questi campi può rompersi in qualsiasi rilascio; tratta gli join come specifici della versione piuttosto che come un contratto stabile:725Per la ricostruzione a livello di messaggio, ogni classe di evento porta una chiave che corrisponde a un campo nella trascrizione della sessione. Il formato della voce di trascrizione è [interno a Claude Code](/docs/it/sessions#where-transcripts-are-stored) e cambia tra le versioni, quindi una pipeline che si unisce su questi campi può rompersi in qualsiasi rilascio; tratta gli join come specifici della versione piuttosto che come un contratto stabile:

723 726

724* `message.uuid` su `user_prompt` e `assistant_response`727* `message.uuid` su `user_prompt`, `assistant_response`, e `api_response_body`

725* `request_id` sugli eventi API, persistito come `requestId` sulle voci dell'assistente della trascrizione728* `request_id` sugli eventi API, persistito come `requestId` sulle voci dell'assistente della trascrizione

726* `tool_use_id` su `tool_result` e `tool_decision` eventi729* `tool_use_id` su `tool_result` e `tool_decision` eventi

727 730

738* Tutti gli [attributi standard](#standard-attributes)741* Tutti gli [attributi standard](#standard-attributes)

739* `event.name`: `"user_prompt"`742* `event.name`: `"user_prompt"`

740* `event.timestamp`: Timestamp ISO 8601743* `event.timestamp`: Timestamp ISO 8601

741* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)744* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

742* `prompt_length`: Lunghezza del prompt745* `prompt_length`: Lunghezza del prompt

743* `prompt`: Contenuto del prompt. Oscurato per impostazione predefinita. Imposta `OTEL_LOG_USER_PROMPTS=1` per includerlo746* `prompt`: Contenuto del prompt. Redatto per impostazione predefinita. Imposta `OTEL_LOG_USER_PROMPTS=1` per includerlo

744* `message.uuid`: UUID del messaggio utente risultante, corrispondente alla voce della trascrizione persistente. Assente nei dispatching dei comandi, che possono produrre zero o molti messaggi. Richiede Claude Code v2.1.214 o successivo747* `message.uuid`: UUID del messaggio utente risultante, corrispondente alla voce di trascrizione persistente. Assente nei dispatching dei comandi, che possono produrre zero o molti messaggi. Richiede Claude Code v2.1.214 o successivo

745* `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, plugin e MCP si riducono a `custom` o `mcp` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato748* `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 come 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

746* `command_source`: Origine del comando quando presente: `builtin`, `custom`, o `mcp`. I comandi forniti dai plugin vengono segnalati come `custom`749* `command_source`: Origine del comando quando presente: `builtin`, `custom`, o `mcp`. I comandi forniti dai plugin vengono segnalati come `custom`

747 750

748<h4 id="assistant-response-event">751<h4 id="assistant-response-event">

758* Tutti gli [attributi standard](#standard-attributes)761* Tutti gli [attributi standard](#standard-attributes)

759* `event.name`: `"assistant_response"`762* `event.name`: `"assistant_response"`

760* `event.timestamp`: Timestamp ISO 8601763* `event.timestamp`: Timestamp ISO 8601

761* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)764* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

762* `response_length`: Lunghezza del testo della risposta in caratteri765* `response_length`: Lunghezza del testo della risposta in caratteri

763* `response`: Testo della risposta, troncato al limite di contenuto (60 KB per impostazione predefinita). Sostituito con `<REDACTED>` per impostazione predefinita. Imposta `OTEL_LOG_ASSISTANT_RESPONSES=1` per includerlo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` non è impostato, `OTEL_LOG_USER_PROMPTS` lo controlla invece, quindi imposta `OTEL_LOG_ASSISTANT_RESPONSES=0` per mantenere le risposte oscurate mentre la registrazione dei prompt è attiva766* `response`: Testo della risposta, troncato al limite di contenuto (60 KB per impostazione predefinita). Redatto a `<REDACTED>` per impostazione predefinita. Imposta `OTEL_LOG_ASSISTANT_RESPONSES=1` per includerlo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` non è impostato, `OTEL_LOG_USER_PROMPTS` lo controlla invece, quindi imposta `OTEL_LOG_ASSISTANT_RESPONSES=0` per mantenere le risposte redatte mentre la registrazione dei prompt è attiva

764* `model`: Identificatore del modello (ad esempio, "claude-sonnet-5")767* `model`: Identificatore del modello (ad esempio, "claude-sonnet-5")

765* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta. Presente solo quando l'API ne restituisce uno768* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta. Presente solo quando l'API ne restituisce uno

766* `message.uuid`: UUID della voce della trascrizione finale della risposta. Una risposta API viene persistita come una voce della trascrizione per blocco di contenuto; questa è l'ultima, da cui la `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo769* `message.uuid`: UUID della voce di trascrizione finale della risposta. Una risposta API viene persistita come una voce di trascrizione per blocco di contenuto; questa è l'ultima, da cui il `parentUuid` del turno successivo si collega. Richiede Claude Code v2.1.214 o successivo

767* `query_source`: Sottosistema che ha emesso la richiesta, come `"repl_main_thread"`, `"compact"`, o un nome di subagent770* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent

768 771

769<h4 id="tool-result-event">772<h4 id="tool-result-event">

770 Evento di risultato dello strumento773 Evento di risultato dello strumento

771</h4>774</h4>

772 775

773Registrato quando uno strumento completa l'esecuzione. Non emesso se la chiamata dello strumento è stata rifiutata; vedi l'[Evento di decisione dello strumento](#tool-decision-event) per i rifiuti.776Registrato quando uno strumento completa l'esecuzione. Non emesso se la chiamata dello strumento è stata rifiutata; vedi l'[evento di decisione dello strumento](#tool-decision-event) per i rifiuti.

774 777

775**Nome evento**: `claude_code.tool_result`778**Nome evento**: `claude_code.tool_result`

776 779

779* Tutti gli [attributi standard](#standard-attributes)782* Tutti gli [attributi standard](#standard-attributes)

780* `event.name`: `"tool_result"`783* `event.name`: `"tool_result"`

781* `event.timestamp`: Timestamp ISO 8601784* `event.timestamp`: Timestamp ISO 8601

782* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)785* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

783* `tool_name`: Nome dello strumento786* `tool_name`: Nome dello strumento

784* `tool_use_id`: Identificatore univoco per questa invocazione dello strumento. Corrisponde al `tool_use_id` passato agli hooks, consentendo la correlazione tra gli eventi OTel e i dati acquisiti dagli hooks.787* `tool_use_id`: Identificatore univoco per questa invocazione dello strumento. Corrisponde al `tool_use_id` passato agli hook, consentendo la correlazione tra gli eventi OTel e i dati acquisiti dagli hook.

785* `success`: `"true"` o `"false"`788* `success`: `"true"` o `"false"`

786* `duration_ms`: Tempo di esecuzione in millisecondi789* `duration_ms`: Tempo di esecuzione in millisecondi

787* `error_type`: Stringa di categoria di errore quando lo strumento non è riuscito, come `"Error:ENOENT"` o `"ShellError"`790* `error_type`: Stringa di categoria di errore quando lo strumento ha fallito, ad esempio `"Error:ENOENT"` o `"ShellError"`

788* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Messaggio di errore completo quando lo strumento non è riuscito791* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Messaggio di errore completo quando lo strumento ha fallito

789* `decision_type`: Sempre `"accept"`, poiché questo evento viene emesso solo dopo l'esecuzione dello strumento. Le chiamate rifiutate non producono un risultato dello strumento792* `decision_type`: Sempre `"accept"`, poiché questo evento viene emesso solo dopo l'esecuzione dello strumento. Le chiamate rifiutate non producono un risultato dello strumento

790* `decision_source`: Fonte della decisione di autorizzazione. Uno di `"config"`, `"hook"`, `"user_permanent"`, o `"user_temporary"`. Vedi l'[Evento di decisione dello strumento](#tool-decision-event) per il significato di ogni valore. Le fonti solo per il rifiuto `"user_abort"` e `"user_reject"` non compaiono mai su questo evento.793* `decision_source`: Da dove proviene la decisione di autorizzazione. Uno di `"config"`, `"hook"`, `"user_permanent"`, o `"user_temporary"`. Vedi l'[evento di decisione dello strumento](#tool-decision-event) per il significato di ogni valore. Le fonti solo per il rifiuto `"user_abort"` e `"user_reject"` non compaiono mai su questo evento.

791* `tool_input_size_bytes`: Dimensione dell'input dello strumento serializzato in JSON in byte794* `tool_input_size_bytes`: Dimensione dell'input dello strumento serializzato in JSON in byte

792* `tool_result_size_bytes`: Dimensione del risultato dello strumento in byte795* `tool_result_size_bytes`: Dimensione del risultato dello strumento in byte

793* `mcp_server_scope`: Identificatore dell'ambito del server MCP (per gli strumenti MCP)796* `mcp_server_scope`: Identificatore dell'ambito del server MCP (per gli strumenti MCP)

794* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): l'identità del commit di un'esecuzione riuscita di `git commit` eseguita dallo strumento Bash o PowerShell. `vcs.ref.head.revision` è lo SHA del commit, `vcs.ref.head.name` è il ramo su cui è stato eseguito il commit, e `vcs.ref.head.type` è `branch`. Il nome e il tipo vengono omessi quando il commit è stato effettuato su un HEAD staccato. Richiede Claude Code v2.1.269 o successivo797* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): l'identità del commit di un'esecuzione riuscita di `git commit` eseguita dallo strumento Bash o PowerShell. `vcs.ref.head.revision` è lo SHA del commit, `vcs.ref.head.name` è il ramo su cui è stato eseguito il commit, e `vcs.ref.head.type` è `branch`. Il nome e il tipo vengono omessi quando il commit è stato effettuato su un HEAD staccato. Richiede Claude Code v2.1.269 o successivo

795* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): Stringa JSON contenente parametri specifici dello strumento. Per i server incorporati di Claude Desktop, nelle sessioni che Claude Desktop possiede, la coppia `mcp_server_name`/`mcp_tool_name` è inclusa anche con il flag disattivato, la stessa eccezione creata dall'host dell'[Evento di decisione dello strumento](#tool-decision-event), richiedendo Claude Code v2.1.214 o successivo. I parametri variano per strumento:798* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): Stringa JSON contenente parametri specifici dello strumento. Per i server incorporati di Claude Desktop, nelle sessioni che Claude Desktop possiede, la coppia `mcp_server_name`/`mcp_tool_name` è inclusa anche con il flag disattivato, la stessa eccezione creata dall'host dell'[evento di decisione dello strumento](#tool-decision-event), richiedendo Claude Code v2.1.214 o successivo. I parametri variano in base allo strumento:

796 * Per lo strumento Bash: include `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`, e `git_commit_id` e `git_branch` quando un comando `git commit` ha successo. `git_commit_id` è lo SHA completo del commit quando il commit è l'HEAD della directory di lavoro della sessione, e lo SHA abbreviato di git altrimenti. `git_branch` è il ramo su cui è stato eseguito il commit, omesso su un HEAD staccato799 * Per lo strumento Bash: include `bash_command`, `full_command`, `timeout`, `description`, e `dangerouslyDisableSandbox`, più `git_commit_id` e `git_branch` quando un comando `git commit` ha successo. `git_commit_id` è lo SHA del commit completo quando il commit è l'HEAD della directory di lavoro della sessione, e lo SHA abbreviato di git altrimenti. `git_branch` è il ramo su cui è stato eseguito il commit, omesso su un HEAD staccato

797 * Per lo strumento Bash dell'area di lavoro dell'app desktop, che segnala anche `tool_name` come `Bash`: include solo `bash_command`, `full_command`, e `timeout`800 * Per lo strumento Bash dell'area di lavoro dell'app desktop, che riporta anche `tool_name` come `Bash`: include solo `bash_command`, `full_command`, e `timeout`

798 * Per gli strumenti MCP: include `mcp_server_name`, `mcp_tool_name`801 * Per gli strumenti MCP: include `mcp_server_name`, `mcp_tool_name`

799 * Per lo strumento Skill: include `skill_name`802 * Per lo strumento Skill: include `skill_name`

800 * Per lo strumento Agent o lo strumento Task legacy: include `subagent_type`803 * Per lo strumento Agent o lo strumento Task legacy: include `subagent_type`

801* `tool_input` (quando `OTEL_LOG_TOOL_DETAILS=1`): Argomenti dello strumento serializzati in JSON. I singoli valori superiori a 512 caratteri vengono troncati, e il payload completo è limitato a circa 4 K caratteri. Si applica a tutti gli strumenti inclusi gli strumenti MCP.804* `tool_input` (quando `OTEL_LOG_TOOL_DETAILS=1`): Argomenti dello strumento serializzati in JSON. I singoli valori superiori a 512 caratteri vengono troncati e il payload completo è limitato a circa 4 K caratteri. Si applica a tutti gli strumenti inclusi gli strumenti MCP.

802 805

803<h4 id="api-request-event">806<h4 id="api-request-event">

804 Evento di richiesta API807 Evento di richiesta API

813* Tutti gli [attributi standard](#standard-attributes)816* Tutti gli [attributi standard](#standard-attributes)

814* `event.name`: `"api_request"`817* `event.name`: `"api_request"`

815* `event.timestamp`: Timestamp ISO 8601818* `event.timestamp`: Timestamp ISO 8601

816* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)819* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

817* `model`: Modello utilizzato (ad esempio, "claude-sonnet-5")820* `model`: Modello utilizzato (ad esempio, "claude-sonnet-5")

818* `cost_usd`: Costo stimato in USD821* `cost_usd`: Costo stimato in USD

819* `cost_usd_micros`: Costo stimato in milionesimi di dollaro USA, emesso come numero intero822* `cost_usd_micros`: Costo stimato in milionesimi di dollaro USA, emesso come numero intero

822* `output_tokens`: Numero di token di output825* `output_tokens`: Numero di token di output

823* `cache_read_tokens`: Numero di token letti dalla cache826* `cache_read_tokens`: Numero di token letti dalla cache

824* `cache_creation_tokens`: Numero di token utilizzati per la creazione della cache827* `cache_creation_tokens`: Numero di token utilizzati per la creazione della cache

825* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, come `"req_011..."`. Presente solo quando l'API ne restituisce uno.828* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.

826* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo829* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo

827* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva830* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva

828* `query_source`: Sottosistema che ha emesso la richiesta, come `"repl_main_thread"`, `"compact"`, o un nome di subagent831* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent

829* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Assente quando il modello non supporta lo sforzo.832* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta: `"low"`, `"medium"`, `"high"`, `"xhigh"`, o `"max"`. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo.

830* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di oscuramento.833* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di redazione.

831 834

832<h4 id="api-error-event">835<h4 id="api-error-event">

833 Evento di errore API836 Evento di errore API

842* Tutti gli [attributi standard](#standard-attributes)845* Tutti gli [attributi standard](#standard-attributes)

843* `event.name`: `"api_error"`846* `event.name`: `"api_error"`

844* `event.timestamp`: Timestamp ISO 8601847* `event.timestamp`: Timestamp ISO 8601

845* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)848* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

846* `model`: Modello utilizzato (ad esempio, "claude-sonnet-5")849* `model`: Modello utilizzato (ad esempio, "claude-sonnet-5")

847* `error`: Messaggio di errore850* `error`: Messaggio di errore

848* `status_code`: Codice di stato HTTP come numero. Assente per errori non-HTTP come i guasti di connessione.851* `status_code`: Codice di stato HTTP come numero. Assente per errori non HTTP come i guasti di connessione.

849* `duration_ms`: Durata della richiesta in millisecondi852* `duration_ms`: Durata della richiesta in millisecondi

850* `attempt`: Numero totale di tentativi effettuati, inclusa la richiesta iniziale (`1` significa che non si sono verificati tentativi)853* `attempt`: Numero totale di tentativi effettuati, inclusa la richiesta iniziale (`1` significa che non si sono verificati tentativi)

851* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, come `"req_011..."`. Presente solo quando l'API ne restituisce uno.854* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.

852* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Disponibile anche quando un guasto come un timeout o un errore di connessione non ha mai prodotto un `request_id` del server; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo855* `client_request_id`: UUID generato dal client inviato come intestazione della richiesta `x-client-request-id`. Disponibile anche quando un guasto come un timeout o un errore di connessione non ha mai prodotto un `request_id` del server; vedi la tabella [attributi di correlazione degli eventi](#event-correlation-attributes) per quando è presente. Richiede Claude Code v2.1.214 o successivo

853* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva856* `speed`: `"fast"` o `"normal"`, indicando se la modalità veloce era attiva

854* `query_source`: Sottosistema che ha emesso la richiesta, come `"repl_main_thread"`, `"compact"`, o un nome di subagent857* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent

855* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta. Assente quando il modello non supporta lo sforzo.858* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo.

856* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di oscuramento.859* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di redazione.

857 860

858<h4 id="api-refusal-event">861<h4 id="api-refusal-event">

859 Evento di rifiuto API862 Evento di rifiuto API

868* Tutti gli [attributi standard](#standard-attributes)871* Tutti gli [attributi standard](#standard-attributes)

869* `event.name`: `"api_refusal"`872* `event.name`: `"api_refusal"`

870* `event.timestamp`: Timestamp ISO 8601873* `event.timestamp`: Timestamp ISO 8601

871* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)874* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

872* `model`: Identificatore del modello dalla richiesta875* `model`: Identificatore del modello dalla richiesta

873* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, come `"req_011..."`. Presente solo quando l'API ne restituisce uno.876* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.

874* `query_source`: Sottosistema che ha emesso la richiesta, come `"repl_main_thread"`, `"compact"`, o un nome di subagent. Vedi [`api_request`](#api-request-event) per le definizioni.877* `query_source`: Sottosistema che ha emesso la richiesta, ad esempio `"repl_main_thread"`, `"compact"`, o un nome di subagent. Vedi [`api_request`](#api-request-event) per le definizioni.

875* `speed`: `"fast"` quando [Fast mode](/docs/it/fast-mode) è attivo, o `"normal"`878* `speed`: `"fast"` quando la [modalità veloce](/docs/it/fast-mode) è attiva, o `"normal"`

876* `attempt`: Numero del tentativo di ripetizione. Il primo tentativo è `1`.879* `attempt`: Numero del tentativo di ripetizione. Il primo tentativo è `1`.

877* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta. Assente quando il modello non supporta lo sforzo.880* `effort`: [Livello di sforzo](/docs/it/model-config#adjust-effort-level) applicato alla richiesta. Assente quando Claude Code non invia alcun livello di sforzo, ad esempio su un modello che non supporta lo sforzo.

878* `server_fallback_hop`: `true` quando il fallback del modello lato server dell'API ha già ritentato questo rifiuto su un modello diverso, quindi l'utente non ha visto questo particolare rifiuto. `false` quando la richiesta è terminata in un rifiuto. Un singolo turno può emettere sia un evento hop `true` che un successivo evento finale `false` quando il modello di fallback rifiuta anche.881* `server_fallback_hop`: `true` quando il fallback del modello lato server dell'API ha già ritentato questo rifiuto su un modello diverso, quindi l'utente non ha visto questo particolare rifiuto. `false` quando la richiesta è terminata in un rifiuto. Un singolo turno può emettere sia un evento hop `true` che un evento finale `false` successivo quando il modello di fallback rifiuta anche.

879* `has_category`: `true` quando la risposta API ha portato una `stop_details.category` di `"cyber"`, `"bio"`, `"frontier_llm"`, o `"reasoning_extraction"`. `false` quando la risposta non ha portato alcuna categoria o un valore al di fuori di quel set. Assente quando `server_fallback_hop` è `true`, perché i blocchi hop non portano `stop_details`.882* `has_category`: `true` quando la risposta API conteneva un `stop_details.category` di `"cyber"`, `"bio"`, `"frontier_llm"`, o `"reasoning_extraction"`. `false` quando la risposta non conteneva alcuna categoria o un valore al di fuori di quel set. Assente quando `server_fallback_hop` è `true`, perché i blocchi hop non portano `stop_details`.

880* `has_explanation`: `true` quando la risposta API ha portato una `stop_details.explanation`, altrimenti `false`. Assente quando `server_fallback_hop` è `true`.883* `has_explanation`: `true` quando la risposta API conteneva un `stop_details.explanation`, altrimenti `false`. Assente quando `server_fallback_hop` è `true`.

881* `category`: Il valore `stop_details.category` dalla risposta API. Uno di `"cyber"`, `"bio"`, `"frontier_llm"`, o `"reasoning_extraction"`. Presente solo quando `OTEL_LOG_TOOL_DETAILS=1` è impostato e `has_category` è `true`.884* `category`: Il valore `stop_details.category` dalla risposta API. Uno di `"cyber"`, `"bio"`, `"frontier_llm"`, o `"reasoning_extraction"`. Presente solo quando `OTEL_LOG_TOOL_DETAILS=1` è impostato e `has_category` è `true`.

882* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di oscuramento.885* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di redazione.

883 886

884<h4 id="api-request-body-event">887<h4 id="api-request-body-event">

885 Evento di corpo della richiesta API888 Evento del corpo della richiesta API

886</h4>889</h4>

887 890

888Registrato per ogni tentativo di richiesta API quando `OTEL_LOG_RAW_API_BODIES` è impostato. Un evento viene emesso per tentativo, quindi i tentativi con parametri regolati producono ciascuno il proprio evento.891Registrato per ogni tentativo di richiesta API quando `OTEL_LOG_RAW_API_BODIES` è impostato. Un evento viene emesso per tentativo, quindi i tentativi con parametri regolati producono ciascuno il proprio evento.

894* Tutti gli [attributi standard](#standard-attributes)897* Tutti gli [attributi standard](#standard-attributes)

895* `event.name`: `"api_request_body"`898* `event.name`: `"api_request_body"`

896* `event.timestamp`: Timestamp ISO 8601899* `event.timestamp`: Timestamp ISO 8601

897* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)900* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

898* `body`: Parametri della richiesta dell'API Messages serializzati in JSON, come il prompt di sistema, i messaggi e gli strumenti, troncati al limite di contenuto (60 KB per impostazione predefinita). Il contenuto del pensiero esteso nei turni precedenti dell'assistente viene oscurato. Emesso solo in modalità inline (`OTEL_LOG_RAW_API_BODIES=1`).901* `body`: Parametri della richiesta API Messages serializzati in JSON, come il prompt di sistema, i messaggi e gli strumenti, troncati al limite di contenuto (60 KB per impostazione predefinita). Il contenuto del pensiero esteso nei turni dell'assistente precedenti viene redatto. Emesso solo in modalità inline (`OTEL_LOG_RAW_API_BODIES=1`).

899* `body_ref`: Percorso assoluto a un file `<dir>/<uuid>.request.json` contenente il corpo non troncato. Emesso solo in modalità file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).902* `body_ref`: Percorso assoluto a un file `<dir>/<uuid>.request.json` contenente il corpo non troncato. Emesso solo in modalità file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

900* `body_length`: Lunghezza del corpo non troncato. Byte UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, o unità di codice UTF-16 quando `=1`903* `body_length`: Lunghezza del corpo non troncato. Byte UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, o unità di codice UTF-16 quando `=1`

901* `body_truncated`: `"true"` quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.904* `body_truncated`: `"true"` quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.

902* `model`: Identificatore del modello dai parametri della richiesta905* `model`: Identificatore del modello dai parametri della richiesta

903* `query_source`: Sottosistema che ha emesso la richiesta (ad esempio, `"compact"`)906* `query_source`: Sottosistema che ha emesso la richiesta (ad esempio, `"compact"`)

904* `request_body_id`: UUID che identifica il corpo della richiesta di questo tentativo. L'evento [`api_response_body`](#api-response-body-event) per il tentativo che ha successo porta lo stesso valore, quindi puoi accoppiare una risposta con la richiesta esatta che l'ha prodotta. Richiede Claude Code v2.1.274 o successivo907* `request_body_id`: UUID che identifica il corpo della richiesta di questo tentativo. L'[evento `api_response_body`](#api-response-body-event) per il tentativo che ha successo porta lo stesso valore, quindi puoi accoppiare una risposta con la richiesta esatta che l'ha prodotta. Richiede Claude Code v2.1.274 o successivo

905 908

906<h4 id="api-response-body-event">909<h4 id="api-response-body-event">

907 Evento di corpo della risposta API910 Evento del corpo della risposta API

908</h4>911</h4>

909 912

910Registrato per ogni risposta API riuscita quando `OTEL_LOG_RAW_API_BODIES` è impostato.913Registrato per ogni risposta API riuscita quando `OTEL_LOG_RAW_API_BODIES` è impostato.

911 914

912In modalità file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code aggiunge anche una riga JSON a `<dir>/index.jsonl` per ogni risposta riuscita, con i campi `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, e `response_file`. Leggilo per trovare i file di richiesta e risposta dietro un determinato messaggio della trascrizione senza interrogare il tuo backend di telemetria. Il file di indice richiede Claude Code v2.1.274 o successivo.915In modalità file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code aggiunge anche una riga JSON a `<dir>/index.jsonl` per ogni risposta riuscita, con i campi `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, e `response_file`. Leggilo per trovare i file di richiesta e risposta dietro un determinato messaggio di trascrizione senza interrogare il tuo backend di telemetria. Il file di indice richiede Claude Code v2.1.274 o successivo.

913 916

914**Nome evento**: `claude_code.api_response_body`917**Nome evento**: `claude_code.api_response_body`

915 918

918* Tutti gli [attributi standard](#standard-attributes)921* Tutti gli [attributi standard](#standard-attributes)

919* `event.name`: `"api_response_body"`922* `event.name`: `"api_response_body"`

920* `event.timestamp`: Timestamp ISO 8601923* `event.timestamp`: Timestamp ISO 8601

921* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)924* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

922* `body`: Risposta dell'API Messages serializzata in JSON, inclusi l'id, i blocchi di contenuto, l'utilizzo e il motivo di arresto, troncata al limite di contenuto (60 KB per impostazione predefinita). Il contenuto del pensiero esteso viene oscurato. Emesso solo in modalità inline (`OTEL_LOG_RAW_API_BODIES=1`).925* `body`: Risposta API Messages serializzata in JSON, inclusi l'id, i blocchi di contenuto, l'utilizzo e il motivo dell'arresto, troncata al limite di contenuto (60 KB per impostazione predefinita). Il contenuto del pensiero esteso viene redatto. Emesso solo in modalità inline (`OTEL_LOG_RAW_API_BODIES=1`).

923* `body_ref`: Percorso assoluto a un file `<dir>/<request_id>.response.json` contenente il corpo non troncato. Emesso solo in modalità file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).926* `body_ref`: Percorso assoluto a un file `<dir>/<request_id>.response.json` contenente il corpo non troncato. Emesso solo in modalità file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

924* `body_length`: Lunghezza del corpo non troncato. Byte UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, o unità di codice UTF-16 quando `=1`927* `body_length`: Lunghezza del corpo non troncato. Byte UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, o unità di codice UTF-16 quando `=1`

925* `body_truncated`: `"true"` quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.928* `body_truncated`: `"true"` quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.

926* `model`: Identificatore del modello929* `model`: Identificatore del modello

927* `query_source`: Sottosistema che ha emesso la richiesta930* `query_source`: Sottosistema che ha emesso la richiesta

928* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, come `"req_011..."`. Presente solo quando l'API ne restituisce uno.931* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, ad esempio `"req_011..."`. Presente solo quando l'API ne restituisce uno.

929* `request_body_id`: Il `request_body_id` dell'evento [`api_request_body`](#api-request-body-event) a cui questa risposta risponde. Richiede Claude Code v2.1.274 o successivo932* `request_body_id`: Il `request_body_id` dell'[evento `api_request_body`](#api-request-body-event) a cui questa risposta risponde. Richiede Claude Code v2.1.274 o successivo

930* `message.id`: ID del messaggio che l'API ha assegnato alla risposta, il campo `id` del corpo della risposta. Richiede Claude Code v2.1.274 o successivo933* `message.id`: ID del messaggio che l'API ha assegnato alla risposta, il campo `id` del corpo della risposta. Richiede Claude Code v2.1.274 o successivo

931* `message.uuid`: UUID della voce della trascrizione finale della risposta. Insieme a `request_body_id`, collega un messaggio della trascrizione ai corpi di richiesta e risposta dietro di esso. Richiede Claude Code v2.1.274 o successivo934* `message.uuid`: UUID della voce di trascrizione finale della risposta. Insieme a `request_body_id`, collega un messaggio di trascrizione ai corpi di richiesta e risposta dietro di esso. Richiede Claude Code v2.1.274 o successivo

932 935

933<h4 id="tool-decision-event">936<h4 id="tool-decision-event">

934 Evento di decisione dello strumento937 Evento di decisione dello strumento

943* Tutti gli [attributi standard](#standard-attributes)946* Tutti gli [attributi standard](#standard-attributes)

944* `event.name`: `"tool_decision"`947* `event.name`: `"tool_decision"`

945* `event.timestamp`: Timestamp ISO 8601948* `event.timestamp`: Timestamp ISO 8601

946* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)949* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

947* `tool_name`: Nome dello strumento (ad esempio, "Read", "Edit", "Write", "NotebookEdit")950* `tool_name`: Nome dello strumento (ad esempio, "Read", "Edit", "Write", "NotebookEdit")

948* `tool_use_id`: Identificatore univoco per questa invocazione dello strumento. Corrisponde al `tool_use_id` passato agli hooks, consentendo la correlazione tra gli eventi OTel e i dati acquisiti dagli hooks.951* `tool_use_id`: Identificatore univoco per questa invocazione dello strumento. Corrisponde al `tool_use_id` passato agli hook, consentendo la correlazione tra gli eventi OTel e i dati acquisiti dagli hook.

949* `decision`: `"accept"` o `"reject"`952* `decision`: `"accept"` o `"reject"`

950* `tool_source`: Sempre presente. La provenienza dello strumento, come un insieme chiuso di valori creati dalla CLI. Richiede Claude Code v2.1.214 o successivo953* `tool_source`: Sempre presente. La provenienza dello strumento, come un insieme chiuso di valori creati dalla CLI. Richiede Claude Code v2.1.214 o successivo

951 * `"builtin"`: gli strumenti della CLI stessa954 * `"builtin"`: gli strumenti della CLI stessa

952 * `"mcp"`: server MCP in generale955 * `"mcp"`: server MCP in generale

953 * `"sdk_host_builtin_mcp"`: un server in-process incorporato in Claude Desktop stesso, in una sessione che Claude Desktop possiede. Claude Desktop possiede una sessione che ha avviato da uno dei suoi propri punti di ingresso, `claude-desktop`, `claude-desktop-3p`, o `local-agent`, quando quella sessione non è un figlio annidato; le sessioni annidate, incluse le sessioni che Claude Code stesso genera, segnalano questi server come `"mcp"`956 * `"sdk_host_builtin_mcp"`: un server in-process incorporato in Claude Desktop stesso, in una sessione che Claude Desktop possiede. Claude Desktop possiede una sessione che ha avviato da uno dei suoi stessi punti di ingresso, `claude-desktop`, `claude-desktop-3p`, o `local-agent`, quando quella sessione non è un figlio annidato; le sessioni annidate, incluse le sessioni che Claude Code stesso genera, segnalano questi server come `"mcp"`

954* `source`: Fonte della decisione:957* `source`: Da dove proviene la decisione:

955 * `"config"`: Deciso automaticamente senza richiedere, in base alle impostazioni del progetto, alle regole di autorizzazione nelle impostazioni personali dell'utente, alla politica gestita dall'azienda, ai flag `--allowedTools` o `--disallowedTools`, alla modalità di autorizzazione attiva, a una concessione con ambito di sessione da un prompt precedente nella stessa sessione CLI interattiva, o perché lo strumento è intrinsecamente sicuro. L'evento non indica quale di queste fonti corrisponde. Claude Code segnala anche `"config"` quando la richiesta del prompt di autorizzazione stessa non riesce, ad esempio quando il callback [`canUseTool`](/docs/it/agent-sdk/typescript#canusetool) dell'Agent SDK o lo strumento [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) restituisce un risultato non valido, o quando il flusso di input si chiude mentre la richiesta è in sospeso. Prima della v2.1.216, Claude Code segnalava questi guasti come `"user_reject"`.958 * `"config"`: Deciso automaticamente senza chiedere, in base alle impostazioni del progetto, alle regole di consentimento o negazione nelle impostazioni personali dell'utente, alla politica gestita dall'azienda, ai flag `--allowedTools` o `--disallowedTools`, alla modalità di autorizzazione attiva, a una concessione con ambito di sessione da un prompt precedente nella stessa sessione CLI interattiva, o perché lo strumento è intrinsecamente sicuro. L'evento non indica quale di queste fonti corrisponde. Claude Code riporta anche `"config"` quando la richiesta del prompt di autorizzazione stessa non riesce, ad esempio quando il callback [`canUseTool`](/docs/it/agent-sdk/typescript#canusetool) dell'Agent SDK o lo strumento [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) restituisce un risultato non valido, o quando il flusso di input si chiude mentre la richiesta è in sospeso. Prima della v2.1.216, Claude Code segnalava questi guasti come `"user_reject"`.

956 * `"hook"`: Un hook `PreToolUse` o `PermissionRequest` ha restituito la decisione.959 * `"hook"`: Un hook `PreToolUse` o `PermissionRequest` ha restituito la decisione.

957 * `"user_permanent"`: Emesso quando l'utente ha scelto "Sì, e non chiedere di nuovo per ..." in un prompt di autorizzazione, il che salva una regola di autorizzazione alle sue impostazioni personali. Nella CLI interattiva questo viene emesso solo per quella scelta stessa; le chiamate successive che corrispondono alla regola salvata emettono `"config"` invece. Nelle sessioni Agent SDK o non interattive `-p`, sia la scelta iniziale che le corrispondenze di regole successive emettono `"user_permanent"`. Trattato come un'accettazione.960 * `"user_permanent"`: Emesso quando l'utente ha scelto "Sì, e non chiedere di nuovo per ..." a un prompt di autorizzazione, che salva una regola di consentimento nelle impostazioni personali. Nella CLI interattiva questo viene emesso solo per quella scelta stessa; le chiamate successive che corrispondono alla regola salvata emettono `"config"` invece. Nelle sessioni Agent SDK o non interattive `-p`, sia la scelta iniziale che le corrispondenze successive della regola emettono `"user_permanent"`. Trattato come un'accettazione.

958 * `"user_temporary"`: Emesso quando l'utente ha scelto "Sì" in un prompt di autorizzazione per un'approvazione una tantum, o ha scelto un'opzione che concede l'accesso per il resto della sessione in un prompt di modifica o lettura di file. Nella CLI interattiva questo viene emesso solo per la scelta stessa; le chiamate successive consentite da quella concessione con ambito di sessione emettono `"config"` invece. Nelle sessioni Agent SDK o non interattive `-p`, sia la scelta che le corrispondenze successive emettono `"user_temporary"`. Trattato come un'accettazione.961 * `"user_temporary"`: Emesso quando l'utente ha scelto "Sì" a un prompt di autorizzazione per un'approvazione una tantum, o ha scelto un'opzione che concede l'accesso per il resto della sessione su un prompt di modifica o lettura di file. Nella CLI interattiva questo viene emesso solo per la scelta stessa; le chiamate successive consentite da quella concessione con ambito di sessione emettono `"config"` invece. Nelle sessioni Agent SDK o non interattive `-p`, sia la scelta che le corrispondenze successive emettono `"user_temporary"`. Trattato come un'accettazione.

959 * `"user_abort"`: Emesso quando l'utente ha chiuso il prompt di autorizzazione senza rispondere. Nelle sessioni Agent SDK e non interattive `-p`, questo include l'interruzione del turno mentre una richiesta di autorizzazione `canUseTool` o `--permission-prompt-tool` è in sospeso; prima della v2.1.216, Claude Code segnalava quell'interruzione come `"user_reject"`. Trattato come un rifiuto.962 * `"user_abort"`: Emesso quando l'utente ha chiuso il prompt di autorizzazione senza rispondere. Nelle sessioni Agent SDK e non interattive `-p`, questo include l'interruzione del turno mentre una richiesta di autorizzazione `canUseTool` o `--permission-prompt-tool` è in sospeso; prima della v2.1.216, Claude Code segnalava quell'interruzione come `"user_reject"`. Trattato come un rifiuto.

960 * `"user_reject"`: Emesso quando l'utente ha scelto "No" quando richiesto. Nella CLI interattiva questo viene emesso solo per quella scelta stessa; le chiamate che corrispondono a una regola di negazione nelle impostazioni personali dell'utente emettono `"config"` invece. Nelle sessioni Agent SDK o non interattive `-p`, le chiamate che corrispondono a una regola di negazione nelle impostazioni personali emettono `"user_reject"`. Trattato come un rifiuto.963 * `"user_reject"`: Emesso quando l'utente ha scelto "No" quando gli è stato chiesto. Nella CLI interattiva questo viene emesso solo per quella scelta stessa; le chiamate che corrispondono a una regola di negazione nelle impostazioni personali dell'utente emettono `"config"` invece. Nelle sessioni Agent SDK o non interattive `-p`, le chiamate che corrispondono a una regola di negazione nelle impostazioni personali emettono `"user_reject"`. Trattato come un rifiuto.

961* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): Stringa JSON contenente parametri specifici dello strumento. Stessa forma dell'[Evento di risultato dello strumento](#tool-result-event), meno i campi post-esecuzione come `git_commit_id`. I valori possono differire da `tool_result` per una chiamata accettata se la decisione di autorizzazione riscrive l'input dello strumento tramite `updatedInput`. Usa questo attributo per vedere quale comando è stato rifiutato quando `decision` è `"reject"`.964* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): Stringa JSON contenente parametri specifici dello strumento. Stessa forma dell'[evento di risultato dello strumento](#tool-result-event), meno i campi post-esecuzione come `git_commit_id`. I valori possono differire da `tool_result` per una chiamata accettata se la decisione di autorizzazione riscrive l'input dello strumento tramite `updatedInput`. Usa questo attributo per vedere quale comando è stato rifiutato quando `decision` è `"reject"`.

962 * Per gli strumenti `"sdk_host_builtin_mcp"`: `mcp_server_name` e `mcp_tool_name` sono inclusi anche quando `OTEL_LOG_TOOL_DETAILS` è disattivato, perché l'applicazione host definisce questi nomi; senza di loro, una chiamata rifiutata a uno di questi server incorporati sarebbe non attribuibile nel flusso predefinito. Per i server MCP configurati dall'utente, il `tool_name` dell'evento è sempre il letterale `"mcp_tool"`, e i nomi del server e dello strumento appaiono solo in `tool_parameters` con il flag attivato; il contenuto dell'argomento richiede il flag ovunque. Richiede Claude Code v2.1.214 o successivo965 * Per gli strumenti `"sdk_host_builtin_mcp"`: `mcp_server_name` e `mcp_tool_name` sono inclusi anche quando `OTEL_LOG_TOOL_DETAILS` è disattivato, perché l'applicazione host definisce questi nomi; senza di loro, una chiamata rifiutata a uno di questi server incorporati sarebbe non attribuibile nel flusso predefinito. Per i server MCP configurati dall'utente, il `tool_name` dell'evento è sempre il letterale `"mcp_tool"`, e i nomi del server e dello strumento compaiono solo in `tool_parameters` con il flag attivato; il contenuto dell'argomento richiede il flag ovunque. Richiede Claude Code v2.1.214 o successivo

963 * Per lo strumento Bash: include `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Lo strumento bash dell'area di lavoro dell'app desktop segnala anche `tool_name` come `Bash`, ma include solo `bash_command`, `full_command`, e `timeout`966 * Per lo strumento Bash: include `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Lo strumento bash dell'area di lavoro dell'app desktop riporta anche `tool_name` come `Bash`, ma include solo `bash_command`, `full_command`, e `timeout`

964 * Per gli strumenti MCP: include `mcp_server_name`, `mcp_tool_name`967 * Per gli strumenti MCP: include `mcp_server_name`, `mcp_tool_name`

965 * Per lo strumento Skill: include `skill_name`968 * Per lo strumento Skill: include `skill_name`

966 * Per lo strumento Agent o lo strumento Task legacy: include `subagent_type`969 * Per lo strumento Agent o lo strumento Task legacy: include `subagent_type`

969 Evento di cambio della modalità di autorizzazione972 Evento di cambio della modalità di autorizzazione

970</h4>973</h4>

971 974

972Registrato quando la modalità di autorizzazione cambia, ad esempio da ciclo Shift+Tab, uscita dalla Plan Mode, o un controllo del gate della modalità automatica.975Registrato quando la modalità di autorizzazione cambia, ad esempio dal ciclo Shift+Tab, dall'uscita dalla modalità piano, o da un controllo del gate della modalità automatica.

973 976

974**Nome evento**: `claude_code.permission_mode_changed`977**Nome evento**: `claude_code.permission_mode_changed`

975 978

978* Tutti gli [attributi standard](#standard-attributes)981* Tutti gli [attributi standard](#standard-attributes)

979* `event.name`: `"permission_mode_changed"`982* `event.name`: `"permission_mode_changed"`

980* `event.timestamp`: Timestamp ISO 8601983* `event.timestamp`: Timestamp ISO 8601

981* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)984* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

982* `from_mode`: La modalità di autorizzazione precedente, ad esempio `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, o `"bypassPermissions"`985* `from_mode`: La modalità di autorizzazione precedente, ad esempio `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, o `"bypassPermissions"`

983* `to_mode`: La nuova modalità di autorizzazione986* `to_mode`: La nuova modalità di autorizzazione

984* `trigger`: Cosa ha causato il cambio. Uno di `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, o `"auto_opt_in"`. Assente quando la transizione proviene dall'SDK o dal bridge987* `trigger`: Cosa ha causato il cambio. Uno di `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, o `"auto_opt_in"`. Assente quando la transizione proviene dall'SDK o dal bridge

996* Tutti gli [attributi standard](#standard-attributes)999* Tutti gli [attributi standard](#standard-attributes)

997* `event.name`: `"auth"`1000* `event.name`: `"auth"`

998* `event.timestamp`: Timestamp ISO 86011001* `event.timestamp`: Timestamp ISO 8601

999* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1002* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1000* `action`: `"login"` o `"logout"`1003* `action`: `"login"` o `"logout"`

1001* `success`: `"true"` o `"false"`1004* `success`: `"true"` o `"false"`

1002* `auth_method`: Metodo di autenticazione, come `"oauth"`1005* `auth_method`: Metodo di autenticazione, ad esempio `"oauth"`

1003* `error_category`: Tipo di errore categorico quando l'azione non è riuscita. Il messaggio di errore grezzo non viene mai incluso1006* `error_category`: Tipo di errore categorico quando l'azione non è riuscita. Il messaggio di errore grezzo non viene mai incluso

1004* `status_code`: Codice di stato HTTP come stringa quando l'azione non è riuscita con un errore HTTP1007* `status_code`: Codice di stato HTTP come stringa quando l'azione non è riuscita con un errore HTTP

1005 1008

1007 Evento di connessione del server MCP1010 Evento di connessione del server MCP

1008</h4>1011</h4>

1009 1012

1010Registrato quando un server MCP si connette, si disconnette o non riesce a connettersi.1013Registrato quando un server MCP si connette, si disconnette, o non riesce a connettersi.

1011 1014

1012**Nome evento**: `claude_code.mcp_server_connection`1015**Nome evento**: `claude_code.mcp_server_connection`

1013 1016

1016* Tutti gli [attributi standard](#standard-attributes)1019* Tutti gli [attributi standard](#standard-attributes)

1017* `event.name`: `"mcp_server_connection"`1020* `event.name`: `"mcp_server_connection"`

1018* `event.timestamp`: Timestamp ISO 86011021* `event.timestamp`: Timestamp ISO 8601

1019* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1022* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1020* `status`: `"connected"`, `"failed"`, o `"disconnected"`1023* `status`: `"connected"`, `"failed"`, o `"disconnected"`

1021* `transport_type`: Trasporto del server, come `"stdio"`, `"sse"`, o `"http"`1024* `transport_type`: Trasporto del server, ad esempio `"stdio"`, `"sse"`, o `"http"`

1022* `server_scope`: Ambito in cui il server è configurato, come `"user"`, `"project"`, o `"local"`1025* `server_scope`: Ambito in cui il server è configurato, ad esempio `"user"`, `"project"`, o `"local"`

1023* `duration_ms`: Durata del tentativo di connessione in millisecondi1026* `duration_ms`: Durata del tentativo di connessione in millisecondi

1024* `error_code`: Codice di errore quando la connessione non è riuscita1027* `error_code`: Codice di errore quando la connessione non è riuscita

1025* `is_plugin`: `true` quando il server è fornito da un plugin, `false` altrimenti1028* `is_plugin`: `true` quando il server è fornito da un plugin, `false` altrimenti

1026* `plugin_id_hash` (quando `is_plugin` è `true`): Hash stabile del nome del plugin e del marketplace, per raggruppare gli eventi per plugin senza esporre il nome. Claude Code lo calcola come descritto nell'[evento di plugin caricato](#plugin-loaded-event)1029* `plugin_id_hash` (quando `is_plugin` è `true`): Hash stabile del nome del plugin e del marketplace, per raggruppare gli eventi per plugin senza esporre il nome. Claude Code lo calcola come descritto sotto l'[evento di plugin caricato](#plugin-loaded-event)

1027* `plugin.name` (quando `is_plugin` è `true`): Nome del plugin che fornisce il server. Per i plugin di terze parti questo è la stringa letterale `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1`; questo protegge i nomi dei plugin di terze parti dall'apparire nei log per impostazione predefinita. I plugin da fonti ufficiali Anthropic sono sempre identificati per nome. Gli attributi `plugin_id_hash` e `plugin.name` fluiscono al tuo backend di monitoraggio e non vengono inviati ad Anthropic1030* `plugin.name` (quando `is_plugin` è `true`): Nome del plugin che fornisce il server. Per i plugin di terze parti questo è il letterale `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1`; questo protegge i nomi dei plugin di terze parti dall'apparire nei log per impostazione predefinita. I plugin da fonti Anthropic ufficiali sono sempre identificati per nome. Gli attributi `plugin_id_hash` e `plugin.name` fluiscono al tuo backend di monitoraggio e non vengono inviati ad Anthropic

1028* `server_name` (quando `OTEL_LOG_TOOL_DETAILS=1`): Nome del server configurato1031* `server_name` (quando `OTEL_LOG_TOOL_DETAILS=1`): Nome del server configurato

1029* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Messaggio di errore completo quando la connessione non è riuscita1032* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Messaggio di errore completo quando la connessione non è riuscita

1030 1033

1032 Evento di errore interno1035 Evento di errore interno

1033</h4>1036</h4>

1034 1037

1035Registrato quando Claude Code cattura un errore interno inaspettato. Viene registrato solo il nome della classe di errore e un codice di stile errno. Il messaggio di errore e la traccia dello stack non vengono mai inclusi. Questo evento non viene emesso quando si esegue su Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry, o quando `DISABLE_ERROR_REPORTING` è impostato.1038Registrato quando Claude Code cattura un errore interno inaspettato. Solo il nome della classe di errore e un codice di stile errno vengono registrati. Il messaggio di errore e la traccia dello stack non vengono mai inclusi. Questo evento non viene emesso quando si esegue su Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry, o quando `DISABLE_ERROR_REPORTING` è impostato.

1036 1039

1037**Nome evento**: `claude_code.internal_error`1040**Nome evento**: `claude_code.internal_error`

1038 1041

1041* Tutti gli [attributi standard](#standard-attributes)1044* Tutti gli [attributi standard](#standard-attributes)

1042* `event.name`: `"internal_error"`1045* `event.name`: `"internal_error"`

1043* `event.timestamp`: Timestamp ISO 86011046* `event.timestamp`: Timestamp ISO 8601

1044* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1047* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1045* `error_name`: Nome della classe di errore, come `"TypeError"` o `"SyntaxError"`1048* `error_name`: Nome della classe di errore, ad esempio `"TypeError"` o `"SyntaxError"`

1046* `error_code`: Codice errno di Node.js come `"ENOENT"` quando presente nell'errore1049* `error_code`: Codice errno di Node.js come `"ENOENT"` quando presente sull'errore

1047 1050

1048<h4 id="plugin-installed-event">1051<h4 id="plugin-installed-event">

1049 Evento di plugin installato1052 Evento di plugin installato

1050</h4>1053</h4>

1051 1054

1052Registrato quando un plugin finisce di installarsi, sia dal comando CLI `claude plugin install` che dall'interfaccia utente interattiva `/plugin`.1055Registrato quando un plugin finisce di installare, sia dal comando CLI `claude plugin install` che dall'interfaccia utente interattiva `/plugin`.

1053 1056

1054**Nome evento**: `claude_code.plugin_installed`1057**Nome evento**: `claude_code.plugin_installed`

1055 1058

1058* Tutti gli [attributi standard](#standard-attributes)1061* Tutti gli [attributi standard](#standard-attributes)

1059* `event.name`: `"plugin_installed"`1062* `event.name`: `"plugin_installed"`

1060* `event.timestamp`: Timestamp ISO 86011063* `event.timestamp`: Timestamp ISO 8601

1061* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1064* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1062* `marketplace.is_official`: `"true"` se il marketplace è un marketplace ufficiale Anthropic, `"false"` altrimenti1065* `marketplace.is_official`: `"true"` se il marketplace è un marketplace Anthropic ufficiale, `"false"` altrimenti

1063* `install.trigger`: `"cli"` o `"ui"`1066* `install.trigger`: `"cli"` o `"ui"`

1064* `plugin.name`: Nome del plugin installato. Per i marketplace di terze parti questo è incluso solo quando `OTEL_LOG_TOOL_DETAILS=1`1067* `plugin.name`: Nome del plugin installato. Per i marketplace di terze parti questo è incluso solo quando `OTEL_LOG_TOOL_DETAILS=1`

1065* `plugin.version`: Versione del plugin quando dichiarata nella voce del marketplace. Per i marketplace di terze parti questo è incluso solo quando `OTEL_LOG_TOOL_DETAILS=1`1068* `plugin.version`: Versione del plugin quando dichiarata nella voce del marketplace. Per i marketplace di terze parti questo è incluso solo quando `OTEL_LOG_TOOL_DETAILS=1`

1078* Tutti gli [attributi standard](#standard-attributes)1081* Tutti gli [attributi standard](#standard-attributes)

1079* `event.name`: `"plugin_loaded"`1082* `event.name`: `"plugin_loaded"`

1080* `event.timestamp`: Timestamp ISO 86011083* `event.timestamp`: Timestamp ISO 8601

1081* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1084* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1082* `plugin.name`: Nome del plugin. Per i plugin al di fuori del marketplace ufficiale e del bundle incorporato il valore è `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1`1085* `plugin.name`: nome del plugin. Per i plugin al di fuori del marketplace ufficiale e del bundle incorporato il valore è `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1`

1083* `marketplace.name`: Marketplace da cui è stato installato il plugin, quando noto. Sostituito con `"third-party"` nella stessa condizione di `plugin.name`1086* `marketplace.name`: marketplace da cui è stato installato il plugin, quando noto. Redatto a `"third-party"` sotto la stessa condizione di `plugin.name`

1084* `plugin.version`: Versione dal manifesto del plugin. Incluso solo quando il nome non è oscurato e il manifesto dichiara una versione1087* `plugin.version`: versione dal manifesto del plugin. Incluso solo quando il nome non è redatto e il manifesto dichiara una versione

1085* `plugin.scope`: Categoria di provenienza per il plugin: `"official"`, `"community"`, `"org"`, `"user-local"`, o `"default-bundle"`1088* `plugin.scope`: categoria di provenienza per il plugin: `"official"`, `"community"`, `"org"`, `"user-local"`, o `"default-bundle"`

1086* `enabled_via`: Come il plugin è stato abilitato: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"`, o `"user-install"`. Il valore `"admin-install"` significa che il plugin è impostato come obbligatorio o auto-installazione per la tua organizzazione in [**Impostazioni organizzazione > Plugin**](https://claude.ai/admin-settings/plugins). Prima della v2.1.246, Claude Code segnalava questi plugin come `"user-install"` o `"seed-mount"`1089* `enabled_via`: come il plugin è venuto ad essere abilitato: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"`, o `"user-install"`. Il valore `"admin-install"` significa che il plugin è impostato come obbligatorio o auto-installazione per la tua organizzazione in [**Impostazioni organizzazione > Plugin**](https://claude.ai/admin-settings/plugins). Prima della v2.1.246, Claude Code segnalava questi plugin come `"user-install"` o `"seed-mount"`

1087* `plugin_id_hash`: Hash deterministico del nome del plugin e del marketplace, inviato solo al tuo esportatore configurato. Ti consente di contare i plugin di terze parti distinti caricati nella tua flotta senza registrare i loro nomi. Per i [plugin sincronizzati da claude.ai](/docs/it/plugins-reference#synced-plugins), Claude Code esegue l'hash del nome del plugin con il nome del marketplace che claude.ai segnala per il plugin, o con `synced` altrimenti. Prima della v2.1.246, Claude Code non utilizzava il nome del marketplace che claude.ai segnala nell'hash1090* `plugin_id_hash`: hash deterministico del nome del plugin e del marketplace, inviato solo al tuo esportatore configurato. Ti consente di contare i plugin di terze parti distinti caricati nella tua flotta senza registrare i loro nomi. Per i [plugin sincronizzati da claude.ai](/docs/it/plugins-reference#synced-plugins), Claude Code esegue l'hash del nome del plugin con il nome del marketplace che claude.ai riporta per il plugin, o con `synced` altrimenti. Prima della v2.1.246, Claude Code non utilizzava il nome del marketplace che claude.ai riporta nell'hash

1088* `has_hooks`: Se il plugin contribuisce hooks1091* `has_hooks`: se il plugin contribuisce hook

1089* `has_mcp`: Se il plugin contribuisce server MCP1092* `has_mcp`: se il plugin contribuisce server MCP

1090* `host_owned_mcp`: `true` quando l'host SDK gestisce le connessioni MCP di questo plugin e Claude Code ha saltato la lettura della configurazione del server MCP del plugin, `false` altrimenti. Richiede Claude Code v2.1.172 o successivo1093* `host_owned_mcp`: `true` quando l'host SDK gestisce le connessioni MCP di questo plugin e Claude Code ha saltato la lettura della configurazione del server MCP del plugin, `false` altrimenti. Richiede Claude Code v2.1.172 o successivo

1091* `skill_path_count`: Numero di directory di skill che il plugin dichiara1094* `skill_path_count`: numero di directory di skill che il plugin dichiara

1092* `command_path_count`: Numero di directory di comandi che il plugin dichiara1095* `command_path_count`: numero di directory di comandi che il plugin dichiara

1093* `agent_path_count`: Numero di directory di agenti che il plugin dichiara1096* `agent_path_count`: numero di directory di agenti che il plugin dichiara

1094* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. In modalità sicura questo evento segnala solo l'inventario configurato; i comandi, le skill, gli hooks e i server MCP del plugin non si caricano. Richiede Claude Code v2.1.169 o successivo1097* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. In modalità sicura questo evento riporta solo l'inventario configurato; i comandi, le skill, gli hook e i server MCP del plugin non si caricano. Richiede Claude Code v2.1.169 o successivo

1095 1098

1096<h4 id="skill-activated-event">1099<h4 id="skill-activated-event">

1097 Evento di skill attivata1100 Evento di skill attivata

1098</h4>1101</h4>

1099 1102

1100Registrato quando una skill viene invocata, sia che Claude la chiami tramite lo strumento Skill sia che tu la esegua come comando `/`.1103Registrato quando una skill viene invocata, sia che Claude la chiami tramite lo strumento Skill che tu la esegua come comando `/`.

1101 1104

1102**Nome evento**: `claude_code.skill_activated`1105**Nome evento**: `claude_code.skill_activated`

1103 1106

1106* Tutti gli [attributi standard](#standard-attributes)1109* Tutti gli [attributi standard](#standard-attributes)

1107* `event.name`: `"skill_activated"`1110* `event.name`: `"skill_activated"`

1108* `event.timestamp`: Timestamp ISO 86011111* `event.timestamp`: Timestamp ISO 8601

1109* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1112* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1110* `skill.name`: Nome della skill. Per le skill definite dall'utente e di terze parti il valore è il placeholder `"custom_skill"` a meno che `OTEL_LOG_TOOL_DETAILS=1`1113* `skill.name`: Nome della skill. Per le skill definite dall'utente e dai plugin di terze parti il valore è il placeholder `"custom_skill"` a meno che `OTEL_LOG_TOOL_DETAILS=1`

1111* `invocation_trigger`: Come la skill è stata attivata (`"user-slash"`, `"claude-proactive"`, o `"nested-skill"`)1114* `invocation_trigger`: Come la skill è stata attivata (`"user-slash"`, `"claude-proactive"`, o `"nested-skill"`)

1112* `skill.source`: Da dove è stata caricata la skill (ad esempio, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1115* `skill.source`: Da dove è stata caricata la skill (ad esempio, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1113* `skill.kind`: `"workflow"` quando la skill è una skill di workflow. Assente altrimenti1116* `skill.kind`: `"workflow"` quando la skill è una skill di workflow. Assente altrimenti

1114* `plugin.name` (quando `OTEL_LOG_TOOL_DETAILS=1` o il plugin è da un marketplace ufficiale): Nome del plugin proprietario quando la skill è fornita da un plugin1117* `plugin.name` (quando `OTEL_LOG_TOOL_DETAILS=1` o il plugin è da un marketplace ufficiale): Nome del plugin proprietario quando la skill è fornita da un plugin

1115* `marketplace.name` (quando `OTEL_LOG_TOOL_DETAILS=1` o il plugin è da un marketplace ufficiale): Marketplace del plugin proprietario da cui è stato installato, quando la skill è fornita da un plugin1118* `marketplace.name` (quando `OTEL_LOG_TOOL_DETAILS=1` o il plugin è da un marketplace ufficiale): Marketplace da cui è stato installato il plugin proprietario, quando la skill è fornita da un plugin

1116 1119

1117<h4 id="at-mention-event">1120<h4 id="at-mention-event">

1118 Evento di menzione @1121 Evento di menzione @

1119</h4>1122</h4>

1120 1123

1121Registrato quando Claude Code risolve una menzione `@` in un prompt. Non ogni menzione emette un evento: i percorsi di uscita anticipata come i rifiuti di autorizzazione, i file di grandi dimensioni, gli allegati di riferimento PDF e i guasti dell'elenco delle directory vengono restituiti senza registrazione.1124Registrato quando Claude Code risolve una menzione `@` in un prompt. Non ogni menzione emette un evento: i percorsi di uscita anticipata come i rifiuti di autorizzazione, i file di grandi dimensioni, gli allegati di riferimento PDF e i guasti dell'elenco delle directory ritornano senza registrare.

1122 1125

1123**Nome evento**: `claude_code.at_mention`1126**Nome evento**: `claude_code.at_mention`

1124 1127

1127* Tutti gli [attributi standard](#standard-attributes)1130* Tutti gli [attributi standard](#standard-attributes)

1128* `event.name`: `"at_mention"`1131* `event.name`: `"at_mention"`

1129* `event.timestamp`: Timestamp ISO 86011132* `event.timestamp`: Timestamp ISO 8601

1130* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1133* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1131* `mention_type`: Tipo di menzione (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). Il valore `"peer"` significa che hai menzionato [una delle tue altre sessioni Claude Code](/docs/it/cross-session-messaging). Richiede Claude Code v2.1.232 o successivo1134* `mention_type`: Tipo di menzione (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). Il valore `"peer"` significa che hai menzionato [una delle tue altre sessioni Claude Code](/docs/it/cross-session-messaging). Richiede Claude Code v2.1.232 o successivo

1132* `success`: Se la menzione è stata risolta con successo (`"true"` o `"false"`)1135* `success`: Se la menzione è stata risolta con successo (`"true"` o `"false"`)

1133 1136

1144* Tutti gli [attributi standard](#standard-attributes)1147* Tutti gli [attributi standard](#standard-attributes)

1145* `event.name`: `"api_retries_exhausted"`1148* `event.name`: `"api_retries_exhausted"`

1146* `event.timestamp`: Timestamp ISO 86011149* `event.timestamp`: Timestamp ISO 8601

1147* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1150* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1148* `model`: Modello utilizzato1151* `model`: Modello utilizzato

1149* `error`: Messaggio di errore finale1152* `error`: Messaggio di errore finale

1150* `status_code`: Codice di stato HTTP come numero. Assente per errori non-HTTP.1153* `status_code`: Codice di stato HTTP come numero. Assente per errori non HTTP.

1151* `total_attempts`: Numero totale di tentativi effettuati1154* `total_attempts`: Numero totale di tentativi effettuati

1152* `total_retry_duration_ms`: Tempo wall-clock totale tra tutti i tentativi1155* `total_retry_duration_ms`: Tempo totale di wall-clock su tutti i tentativi

1153* `speed`: `"fast"` o `"normal"`1156* `speed`: `"fast"` o `"normal"`

1154 1157

1155<h4 id="hook-registered-event">1158<h4 id="hook-registered-event">

1165* Tutti gli [attributi standard](#standard-attributes)1168* Tutti gli [attributi standard](#standard-attributes)

1166* `event.name`: `"hook_registered"`1169* `event.name`: `"hook_registered"`

1167* `event.timestamp`: Timestamp ISO 86011170* `event.timestamp`: Timestamp ISO 8601

1168* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1171* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1169* `hook_event`: Tipo di evento hook, come `"PreToolUse"` o `"PostToolUse"`1172* `hook_event`: tipo di evento hook, ad esempio `"PreToolUse"` o `"PostToolUse"`

1170* `hook_type`: Tipo di implementazione dell'hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, o `"agent"`1173* `hook_type`: tipo di implementazione dell'hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, o `"agent"`

1171* `hook_source`: Dove è definito l'hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, o `"pluginHook"`1174* `hook_source`: dove è definito l'hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, o `"pluginHook"`

1172* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. Richiede Claude Code v2.1.169 o successivo1175* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. Richiede Claude Code v2.1.169 o successivo

1173* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): La stringa matcher dalla configurazione dell'hook, quando è impostata1176* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): la stringa matcher dalla configurazione dell'hook, quando ne è impostata una

1174* `plugin.name` (quando `hook_source` è `"pluginHook"`): Nome del plugin che contribuisce. Per i plugin al di fuori del marketplace ufficiale e del bundle incorporato il valore è `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1`1177* `plugin.name` (quando `hook_source` è `"pluginHook"`): nome del plugin che contribuisce. Per i plugin al di fuori del marketplace ufficiale e del bundle incorporato il valore è `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1`

1175* `plugin_id_hash` (quando `hook_source` è `"pluginHook"`): Hash deterministico del nome del plugin e del marketplace, inviato solo al tuo esportatore configurato. Ti consente di contare i plugin che contribuiscono distinti senza registrare i loro nomi. Claude Code lo calcola come descritto nell'[evento di plugin caricato](#plugin-loaded-event)1178* `plugin_id_hash` (quando `hook_source` è `"pluginHook"`): hash deterministico del nome del plugin e del marketplace, inviato solo al tuo esportatore configurato. Ti consente di contare i plugin che contribuiscono distinti senza registrare i loro nomi. Claude Code lo calcola come descritto sotto l'[evento di plugin caricato](#plugin-loaded-event)

1176 1179

1177<h4 id="hook-execution-start-event">1180<h4 id="hook-execution-start-event">

1178 Evento di inizio esecuzione dell'hook1181 Evento di inizio esecuzione dell'hook

1179</h4>1182</h4>

1180 1183

1181Registrato quando uno o più hook iniziano a eseguirsi per un evento hook.1184Registrato quando uno o più hook iniziano a eseguire per un evento hook.

1182 1185

1183**Nome evento**: `claude_code.hook_execution_start`1186**Nome evento**: `claude_code.hook_execution_start`

1184 1187

1187* Tutti gli [attributi standard](#standard-attributes)1190* Tutti gli [attributi standard](#standard-attributes)

1188* `event.name`: `"hook_execution_start"`1191* `event.name`: `"hook_execution_start"`

1189* `event.timestamp`: Timestamp ISO 86011192* `event.timestamp`: Timestamp ISO 8601

1190* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1193* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1191* `hook_event`: Tipo di evento hook, come `"PreToolUse"` o `"PostToolUse"`1194* `hook_event`: Tipo di evento hook, ad esempio `"PreToolUse"` o `"PostToolUse"`

1192* `hook_name`: Nome completo dell'hook incluso il matcher, come `"PreToolUse:Write"`1195* `hook_name`: Nome completo dell'hook incluso matcher, ad esempio `"PreToolUse:Write"`

1193* `num_hooks`: Numero di comandi hook corrispondenti1196* `num_hooks`: Numero di comandi hook corrispondenti

1194* `managed_only`: `"true"` quando sono consentiti solo gli hook della politica gestita1197* `managed_only`: `"true"` quando sono consentiti solo hook di politica gestita

1195* `hook_source`: `"policySettings"` o `"merged"`1198* `hook_source`: `"policySettings"` o `"merged"`

1196* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. Richiede Claude Code v2.1.169 o successivo1199* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. Richiede Claude Code v2.1.169 o successivo

1197* `hook_definitions`: Configurazione dell'hook serializzata in JSON. Incluso solo quando sia la traccia beta dettagliata che `OTEL_LOG_TOOL_DETAILS=1` sono abilitati1200* `hook_definitions`: Configurazione dell'hook serializzata in JSON. Incluso solo quando sia la traccia beta dettagliata che `OTEL_LOG_TOOL_DETAILS=1` sono abilitate

1198 1201

1199<h4 id="hook-execution-complete-event">1202<h4 id="hook-execution-complete-event">

1200 Evento di completamento esecuzione dell'hook1203 Evento di completamento esecuzione dell'hook

1209* Tutti gli [attributi standard](#standard-attributes)1212* Tutti gli [attributi standard](#standard-attributes)

1210* `event.name`: `"hook_execution_complete"`1213* `event.name`: `"hook_execution_complete"`

1211* `event.timestamp`: Timestamp ISO 86011214* `event.timestamp`: Timestamp ISO 8601

1212* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1215* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1213* `hook_event`: Tipo di evento hook1216* `hook_event`: Tipo di evento hook

1214* `hook_name`: Nome completo dell'hook incluso il matcher1217* `hook_name`: Nome completo dell'hook incluso matcher

1215* `num_hooks`: Numero di comandi hook corrispondenti1218* `num_hooks`: Numero di comandi hook corrispondenti

1216* `num_success`: Conteggio che ha completato con successo1219* `num_success`: Conteggio che ha completato con successo

1217* `num_blocking`: Conteggio che ha restituito una decisione di blocco1220* `num_blocking`: Conteggio che ha restituito una decisione di blocco

1218* `num_non_blocking_error`: Conteggio che non ha avuto esito positivo senza bloccare1221* `num_non_blocking_error`: Conteggio che ha fallito senza bloccare

1219* `num_cancelled`: Conteggio annullato prima del completamento1222* `num_cancelled`: Conteggio annullato prima del completamento

1220* `total_duration_ms`: Durata wall-clock di tutti gli hook corrispondenti1223* `total_duration_ms`: Durata di wall-clock di tutti gli hook corrispondenti

1221* `managed_only`: `"true"` quando sono consentiti solo gli hook della politica gestita1224* `managed_only`: `"true"` quando sono consentiti solo hook di politica gestita

1222* `hook_source`: `"policySettings"` o `"merged"`1225* `hook_source`: `"policySettings"` o `"merged"`

1223* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. Richiede Claude Code v2.1.169 o successivo1226* `safe_mode`: `"true"` quando la sessione è stata avviata con [`--safe-mode`](/docs/it/cli-reference), `"false"` altrimenti. Richiede Claude Code v2.1.169 o successivo

1224* `hook_definitions`: Configurazione dell'hook serializzata in JSON. Incluso solo quando sia la traccia beta dettagliata che `OTEL_LOG_TOOL_DETAILS=1` sono abilitati1227* `hook_definitions`: Configurazione dell'hook serializzata in JSON. Incluso solo quando sia la traccia beta dettagliata che `OTEL_LOG_TOOL_DETAILS=1` sono abilitate

1225 1228

1226<h4 id="hook-plugin-metrics-event">1229<h4 id="hook-plugin-metrics-event">

1227 Evento di metriche plugin hook1230 Evento di metriche del plugin hook

1228</h4>1231</h4>

1229 1232

1230Registrato quando un hook plugin del marketplace ufficiale emette metriche per invocazione. Solo i plugin installati da un marketplace ufficiale Anthropic possono emettere questi. I plugin di marketplace di terze parti e gli hook configurati dall'utente non emettono a questo evento. Usa questo evento per monitorare il comportamento del plugin come i tassi di ricerca, i costi e le durate dal tuo stack di osservabilità.1233Registrato quando un hook del plugin del marketplace ufficiale emette metriche per invocazione. Solo i plugin installati da un marketplace Anthropic ufficiale possono emettere questi. I plugin del marketplace di terze parti e gli hook configurati dall'utente non emettono a questo evento. Usa questo evento per monitorare il comportamento del plugin come i tassi di ricerca, i costi e le durate dal tuo stack di osservabilità.

1231 1234

1232**Nome evento**: `claude_code.hook_plugin_metrics`1235**Nome evento**: `claude_code.hook_plugin_metrics`

1233 1236

1236* Tutti gli [attributi standard](#standard-attributes)1239* Tutti gli [attributi standard](#standard-attributes)

1237* `event.name`: `"hook_plugin_metrics"`1240* `event.name`: `"hook_plugin_metrics"`

1238* `event.timestamp`: Timestamp ISO 86011241* `event.timestamp`: Timestamp ISO 8601

1239* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1242* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1240* `plugin_id`: Identificatore del plugin in forma `<name>@<marketplace>`1243* `plugin_id`: identificatore del plugin in forma `<name>@<marketplace>`

1241* `hook_event`: Tipo di evento hook che ha emesso le metriche1244* `hook_event`: tipo di evento hook che ha emesso le metriche

1242* Fino a 20 chiavi di metriche emesse dal plugin. I nomi corrispondono a `^[a-z][a-z0-9_]{0,39}$`. I valori sono booleani o numeri.1245* Fino a 20 chiavi di metriche emesse dal plugin. I nomi corrispondono a `^[a-z][a-z0-9_]{0,39}$`. I valori sono booleani o numeri.

1243 1246

1244<h4 id="compaction-event">1247<h4 id="compaction-event">

1254* Tutti gli [attributi standard](#standard-attributes)1257* Tutti gli [attributi standard](#standard-attributes)

1255* `event.name`: `"compaction"`1258* `event.name`: `"compaction"`

1256* `event.timestamp`: Timestamp ISO 86011259* `event.timestamp`: Timestamp ISO 8601

1257* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1260* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1258* `trigger`: `"auto"` o `"manual"`1261* `trigger`: `"auto"` o `"manual"`

1259* `success`: `"true"` o `"false"`1262* `success`: `"true"` o `"false"`

1260* `duration_ms`: Durata della compattazione1263* `duration_ms`: Durata della compattazione

1261* `pre_tokens`: Conteggio approssimativo dei token prima della compattazione1264* `pre_tokens`: Conteggio approssimativo dei token prima della compattazione

1262* `post_tokens`: Conteggio approssimativo dei token dopo la compattazione1265* `post_tokens`: Conteggio approssimativo dei token dopo la compattazione

1263* `error`: Messaggio di errore quando la compattazione non è riuscita1266* `error`: Messaggio di errore quando la compattazione non è riuscita

1264* `precompute_reuse`: Impostato solo quando `trigger` è `"manual"`. La compattazione automatica può preparare un riepilogo in background prima che la finestra di contesto si riempia, e questo attributo registra se `/compact` ha riutilizzato quel riepilogo preparato. `"hit"` significa che è stato riutilizzato; `"miss_custom_instructions"`, `"miss_hook"`, e `"miss_not_ready"` forniscono il motivo per cui è stato calcolato un riepilogo fresco. Richiede Claude Code v2.1.153 o successivo1267* `precompute_reuse`: Impostato solo quando `trigger` è `"manual"`. La compattazione automatica può preparare un riepilogo in background prima che la finestra di contesto si riempia, e questo attributo registra se `/compact` ha riutilizzato quel riepilogo preparato. `"hit"` significa che è stato riutilizzato; `"miss_custom_instructions"`, `"miss_hook"`, e `"miss_not_ready"` danno il motivo per cui è stato calcolato un riepilogo fresco. Richiede Claude Code v2.1.153 o successivo

1265 1268

1266<h4 id="subagent-completed-event">1269<h4 id="subagent-completed-event">

1267 Evento di subagent completato1270 Evento di completamento del subagent

1268</h4>1271</h4>

1269 1272

1270Registrato quando un [subagent](/docs/it/sub-agents) finisce e restituisce il suo risultato alla conversazione che lo ha avviato. Usalo per aggregare l'utilizzo dello strumento e il tempo di esecuzione per tipo di subagent; per aggregazioni di token o costo, usa il [contatore di token](#token-counter) e il [contatore di costo](#cost-counter) filtrati a `query_source` `"subagent"`, poiché il `total_tokens` di questo evento copre solo la richiesta finale. La categoria `"subagent"` conta anche le richieste dagli hook basati su agenti, che non emettono alcun evento di subagent.1273Registrato quando un [subagent](/docs/it/sub-agents) finisce e restituisce il suo risultato alla conversazione che l'ha avviato. Usalo per aggregare l'utilizzo dello strumento e il tempo di esecuzione per tipo di subagent; per aggregazioni di token o costo, usa il [contatore di token](#token-counter) e il [contatore di costo](#cost-counter) filtrati a `query_source` `"subagent"`, poiché il `total_tokens` di questo evento copre solo la richiesta finale. La categoria `"subagent"` conta anche le richieste dagli hook basati su agenti, che non emettono alcun evento di subagent.

1271 1274

1272**Nome evento**: `claude_code.subagent_completed`1275**Nome evento**: `claude_code.subagent_completed`

1273 1276

1276* Tutti gli [attributi standard](#standard-attributes)1279* Tutti gli [attributi standard](#standard-attributes)

1277* `event.name`: `"subagent_completed"`1280* `event.name`: `"subagent_completed"`

1278* `event.timestamp`: Timestamp ISO 86011281* `event.timestamp`: Timestamp ISO 8601

1279* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1282* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1280* `agent_type`: Il tipo di subagent. I nomi degli agenti incorporati e i nomi degli agenti dai plugin del marketplace ufficiale vengono visualizzati così come sono; gli altri nomi degli agenti vengono sostituiti con `"custom"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato1283* `agent_type`: Il tipo di subagent. I nomi degli agenti incorporati e gli agenti dai plugin del marketplace ufficiale vengono visualizzati letteralmente; gli altri nomi di agenti vengono sostituiti con `"custom"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato

1281* `agent.source`: Da dove proviene la definizione dell'agente: `built-in`, `plugin`, o la fonte di impostazioni che ha definito un agente personalizzato, come `userSettings` o `projectSettings`1284* `agent.source`: Da dove proviene la definizione dell'agente: `built-in`, `plugin`, o la fonte di impostazioni che ha definito un agente personalizzato, ad esempio `userSettings` o `projectSettings`

1282* `is_built_in`: Se il subagent è un tipo di agente incorporato1285* `is_built_in`: Se il subagent è un tipo di agente incorporato

1283* `is_async`: Se il subagent è stato eseguito in [background](/docs/it/sub-agents#run-subagents-in-foreground-or-background)1286* `is_async`: Se il subagent è stato eseguito in [background](/docs/it/sub-agents#run-subagents-in-foreground-or-background)

1284* `total_tokens`: L'impronta di token della richiesta API finale del subagent: i token di input, creazione della cache, lettura della cache e output di quella richiesta, approssimativamente la dimensione del contesto del subagent al completamento. Non una somma nell'intera esecuzione1287* `total_tokens`: L'impronta di token della richiesta API finale del subagent: quella singola richiesta di token di input, creazione della cache, lettura della cache e output, approssimativamente la dimensione del contesto del subagent al completamento. Non una somma nell'intera esecuzione

1285* `total_tool_uses`: Numero di chiamate dello strumento che il subagent ha effettuato nell'intera esecuzione1288* `total_tool_uses`: Numero di chiamate dello strumento che il subagent ha effettuato nell'intera esecuzione

1286* `duration_ms`: Tempo di esecuzione in millisecondi1289* `duration_ms`: Tempo di esecuzione in millisecondi

1287* `model`: Il modello in cui il subagent è stato risolto per l'esecuzione1290* `model`: Il modello in cui il subagent è stato risolto per eseguire

1288* `final_model`: Il modello che ha prodotto la risposta finale del subagent, che differisce da `model` dopo un cambio a metà esecuzione come un fallback. Richiede Claude Code v2.1.212 o successivo1291* `final_model`: Il modello che ha prodotto la risposta finale del subagent, che differisce da `model` dopo un cambio durante l'esecuzione come un fallback. Richiede Claude Code v2.1.212 o successivo

1289* `model_swapped`: Se più di un modello ha servito le richieste del subagent. Richiede Claude Code v2.1.212 o successivo1292* `model_swapped`: Se più di un modello ha servito le richieste del subagent. Richiede Claude Code v2.1.212 o successivo

1290* `plugin_id_hash`, `plugin.name`: Presente per gli agenti forniti da plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati così come sono; gli altri nomi dei plugin vengono sostituiti con `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato1293* `plugin_id_hash`, `plugin.name`: Presente per gli agenti forniti da plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati letteralmente; gli altri nomi di plugin vengono sostituiti con `"third-party"` a meno che `OTEL_LOG_TOOL_DETAILS=1` non sia impostato

1291 1294

1292<h4 id="feedback-survey-event">1295<h4 id="feedback-survey-event">

1293 Evento di sondaggio di feedback1296 Evento di sondaggio di feedback

1294</h4>1297</h4>

1295 1298

1296Registrato quando viene mostrato o risposto a un sondaggio sulla qualità della sessione. Vedi [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) per sapere cosa raccolgono i sondaggi e come controllarli.1299Registrato quando viene mostrato o risposto un sondaggio sulla qualità della sessione. Vedi [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) per quello che i sondaggi raccolgono e come controllarli.

1297 1300

1298**Nome evento**: `claude_code.feedback_survey`1301**Nome evento**: `claude_code.feedback_survey`

1299 1302

1302* Tutti gli [attributi standard](#standard-attributes)1305* Tutti gli [attributi standard](#standard-attributes)

1303* `event.name`: `"feedback_survey"`1306* `event.name`: `"feedback_survey"`

1304* `event.timestamp`: Timestamp ISO 86011307* `event.timestamp`: Timestamp ISO 8601

1305* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1308* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1306* `event_type`: Evento del ciclo di vita del sondaggio, ad esempio `"appeared"`, `"responded"`, o `"transcript_prompt_appeared"`1309* `event_type`: Evento del ciclo di vita del sondaggio, ad esempio `"appeared"`, `"responded"`, o `"transcript_prompt_appeared"`

1307* `appearance_id`: ID univoco che collega gli eventi emessi per un'istanza di sondaggio1310* `appearance_id`: ID univoco che collega gli eventi emessi per un'istanza di sondaggio

1308* `survey_type`: Quale sondaggio ha prodotto l'evento. `"session"` è il prompt di valutazione "Come sta andando Claude?"1311* `survey_type`: Quale sondaggio ha prodotto l'evento. `"session"` è il prompt di valutazione "Come sta andando Claude?"

1309* `response`: La selezione dell'utente su eventi `responded`1312* `response`: La selezione dell'utente su eventi `responded`

1310* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/it/env-vars) è impostato. Emesso come booleano, non come stringa. Presente su eventi di sondaggio `session`. Filtra su questo attributo per confermare che l'override è applicato in tutta la flotta1313* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/it/env-vars) è impostato. Emesso come booleano, non come stringa. Presente su eventi di sondaggio `session`. Filtra su questo attributo per confermare che l'override è applicato in una flotta

1311 1314

1312<h4 id="retention-sweep-event">1315<h4 id="retention-sweep-event">

1313 Evento di sweep di conservazione1316 Evento di sweep di conservazione

1314</h4>1317</h4>

1315 1318

1316Registrato una volta per esecuzione dello sweep di pulizia della conservazione, che elimina [trascrizioni di sessione e altri dati dell'applicazione](/docs/it/claude-directory#cleaned-up-automatically) più vecchi dell'impostazione [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays). Claude Code esegue lo sweep in background al massimo una volta per sessione, e un'esecuzione che non elimina nulla emette comunque l'evento. Se Claude Code ha eseguito lo sweep in qualsiasi sessione sulla stessa macchina negli ultimi 24 ore, ritarda lo sweep di questa sessione di almeno 10 minuti, quindi una sessione che esce prima non emette nulla. Quando esegui `claude -p` con `--bare`, Claude Code non esegue lo sweep e non emette nulla.1319Registrato una volta per esecuzione dello sweep di pulizia della conservazione, che elimina [trascrizioni di sessione e altri dati dell'applicazione](/docs/it/claude-directory#cleaned-up-automatically) più vecchi dell'impostazione [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays). Claude Code esegue lo sweep in background al massimo una volta per sessione, e un'esecuzione che non elimina nulla emette comunque l'evento. Se Claude Code ha eseguito lo sweep in qualsiasi sessione sulla stessa macchina nelle ultime 24 ore, ritarda lo sweep di questa sessione di almeno 10 minuti, quindi una sessione che esce prima non emette nulla. Quando esegui `claude -p` con `--bare`, Claude Code non esegue lo sweep e non emette nulla.

1317 1320

1318Come ogni evento OTel su questa pagina, va solo al backend di telemetria che configuri. Richiede Claude Code v2.1.227 o successivo.1321Come ogni evento OTel su questa pagina, va solo al backend di telemetria che configuri. Richiede Claude Code v2.1.227 o successivo.

1319 1322

1320Quando Claude Code non può determinare in modo sicuro il periodo di conservazione, mette in pausa lo sweep e emette l'evento con `result` impostato a `"skipped"` e una `skip_reason`. Quando le [impostazioni gestite](/docs/it/server-managed-settings) impostano `cleanupPeriodDays`, il valore gestito fissa il periodo di conservazione e lo sweep viene eseguito anche quando un file di impostazioni in un ambito di priorità inferiore è rotto o non valido. Quando `managed-settings.json` stesso non può essere letto, Claude Code mette comunque in pausa lo sweep a meno che il [livello gestito](/docs/it/managed-settings#how-claude-code-combines-managed-sources) fornisca `cleanupPeriodDays` da altrove, come impostazioni gestite dal server o un drop-in `managed-settings.d/` accanto al file rotto. Gli attributi del contatore di eliminazione sono presenti solo quando `result` è `"complete"`.1323Quando Claude Code non può determinare in modo sicuro il periodo di conservazione, mette in pausa lo sweep e emette l'evento con `result` impostato a `"skipped"` e un `skip_reason`. Quando le [impostazioni gestite](/docs/it/server-managed-settings) impostano `cleanupPeriodDays`, il valore gestito fissa il periodo di conservazione e lo sweep viene eseguito anche quando un file di impostazioni in un ambito di priorità inferiore è rotto o non valido. Quando `managed-settings.json` stesso non può essere letto, Claude Code mette comunque in pausa lo sweep a meno che il [livello gestito](/docs/it/managed-settings#how-claude-code-combines-managed-sources) fornisca `cleanupPeriodDays` da altrove, ad esempio dalle impostazioni gestite dal server o da un drop-in `managed-settings.d/` accanto al file rotto. Gli attributi del contatore di eliminazione sono presenti solo quando `result` è `"complete"`.

1321 1324

1322**Nome evento**: `claude_code.retention_sweep`1325**Nome evento**: `claude_code.retention_sweep`

1323 1326

1326* Tutti gli [attributi standard](#standard-attributes)1329* Tutti gli [attributi standard](#standard-attributes)

1327* `event.name`: `"retention_sweep"`1330* `event.name`: `"retention_sweep"`

1328* `event.timestamp`: Timestamp ISO 86011331* `event.timestamp`: Timestamp ISO 8601

1329* `event.sequence`: Contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1332* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1330* `result`: `"complete"` quando lo sweep è stato eseguito, `"skipped"` quando Claude Code lo ha messo in pausa1333* `result`: `"complete"` quando lo sweep è stato eseguito, `"skipped"` quando Claude Code l'ha messo in pausa

1331* `period_days`: Il valore `cleanupPeriodDays` dalle impostazioni unite, in giorni, o `30` quando nessuna fonte lo imposta. Su eventi saltati, il valore che lo sweep avrebbe utilizzato, calcolato dalle fonti di impostazioni che Claude Code potrebbe leggere1334* `period_days`: Il valore `cleanupPeriodDays` dalle impostazioni unite, in giorni, o `30` quando nessuna fonte lo imposta. Su eventi saltati, il valore che lo sweep avrebbe utilizzato, calcolato dalle fonti di impostazioni che Claude Code potrebbe leggere

1332* `used_default`: `"true"` quando nessuna fonte di impostazioni leggibile imposta `cleanupPeriodDays`, `"false"` altrimenti. Su eventi completi, `"true"` significa che il default di 30 giorni è stato applicato1335* `used_default`: `"true"` quando nessuna fonte di impostazioni leggibile imposta `cleanupPeriodDays`, `"false"` altrimenti. Su eventi completi, `"true"` significa che il default di 30 giorni è stato applicato

1333* `skip_reason`: Perché Claude Code ha messo in pausa lo sweep. Presente solo quando `result` è `"skipped"`:1336* `skip_reason`: Perché Claude Code ha messo in pausa lo sweep. Presente solo quando `result` è `"skipped"`:

1334 * `"user_source_disabled"`: Le impostazioni utente sono escluse, ad esempio dal flag [`--setting-sources`](/docs/it/cli-reference#cli-flags) o dall'opzione [`settingSources`](/docs/it/agent-sdk/typescript#options) dell'SDK, e nessuna fonte abilitata fornisce `cleanupPeriodDays`1337 * `"user_source_disabled"`: Le impostazioni utente sono escluse, ad esempio dal flag [`--setting-sources`](/docs/it/cli-reference#cli-flags) o dall'opzione [`settingSources`](/docs/it/agent-sdk/typescript#options) dell'SDK, e nessuna fonte abilitata fornisce `cleanupPeriodDays`

1335 * `"settings_unknowable"`: Un file di impostazioni non poteva essere letto o analizzato, quindi `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` potrebbe essere impostato a un valore che Claude Code non può vedere1338 * `"settings_unknowable"`: Un file di impostazioni non poteva essere letto o analizzato, quindi `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` potrebbe essere impostato a un valore che Claude Code non può vedere

1336 * `"settings_invalid_key_set"`: Le impostazioni hanno errori di convalida e `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` è esplicitamente impostato, quindi il fallback al default potrebbe eliminare o mantenere file contro quell'impostazione1339 * `"settings_invalid_key_set"`: Le impostazioni hanno errori di convalida e `cleanupPeriodDays` o `desktopSessionCleanupPeriodDays` è esplicitamente impostato, quindi il fallback al default potrebbe eliminare o mantenere file contro quell'impostazione

1337* `transcripts_deleted`: Numero di trascrizioni di sessione, i file di primo livello `~/.claude/projects/*/*.jsonl`, che lo sweep ha eliminato1340* `transcripts_deleted`: Numero di trascrizioni di sessione, i file `~/.claude/projects/*/*.jsonl` di livello superiore, che lo sweep ha eliminato

1338* `transcripts_exempted_desktop`: Numero di trascrizioni passate il periodo di conservazione che lo sweep ha mantenuto secondo la [regola di Claude Desktop e Cowork](/docs/it/claude-directory#cleaned-up-automatically). Questi non contano verso `files_past_cutoff`. Richiede Claude Code v2.1.248 o successivo1341* `transcripts_exempted_desktop`: Numero di trascrizioni passate il periodo di conservazione che lo sweep ha mantenuto secondo la [regola di Claude Desktop e Cowork](/docs/it/claude-directory#cleaned-up-automatically). Questi non contano verso `files_past_cutoff`. Richiede Claude Code v2.1.248 o successivo

1339* `session_files_deleted`: Numero di artefatti che lo sweep dei file di sessione ha eliminato: trascrizioni più file complementari per sessione come sidecars, registrazioni e risultati degli strumenti1342* `session_files_deleted`: Numero di artefatti che lo sweep della sessione ha eliminato: trascrizioni più file complementari per sessione come sidecar, registrazioni e risultati degli strumenti

1340* `artifacts_deleted`: Numero totale di elementi che lo sweep ha eliminato nelle directory di dati che copre, inclusi i file di sessione. Alcuni sweep contano un intero albero di directory rimosso come un elemento e alcuni passaggi di pulizia non contribuiscono al contatore, quindi tratta il valore come un limite inferiore piuttosto che un conteggio di file esatto1343* `artifacts_deleted`: Elementi totali che lo sweep ha eliminato nelle directory di dati che copre, inclusi i file della sessione. Alcuni sweep contano un intero albero di directory rimosso come un elemento e alcuni passaggi di pulizia non contribuiscono al contatore, quindi tratta il valore come un limite inferiore piuttosto che un conteggio esatto di file

1341* `files_retained_fresh`: File ispezionati e lasciati in posizione perché sono ancora entro il periodo di conservazione. Solo gli sweep per file contano questi, quindi il valore è un limite inferiore; un valore diverso da zero è lo stato stazionario normale1344* `files_retained_fresh`: File ispezionati e lasciati in posizione perché sono ancora entro il periodo di conservazione. Solo i sweep per file contano questi, quindi il valore è un limite inferiore; un valore diverso da zero è lo stato stazionario normale

1342* `files_past_cutoff`: File più vecchi del periodo di conservazione che lo sweep non ha potuto eliminare, ad esempio a causa di un errore di autorizzazione o di un file tenuto aperto. Un valore superiore a zero significa che i file hanno superato il periodo di conservazione configurato; zero non è una prova che nessuno lo ha fatto, perché un'eliminazione non riuscita di un'intera directory conta verso `error_count` invece1345* `files_past_cutoff`: File più vecchi del periodo di conservazione che lo sweep non ha potuto eliminare, ad esempio a causa di un errore di autorizzazione o di un file tenuto aperto. Un valore superiore a zero significa che i file hanno superato il periodo di conservazione configurato; zero non è la prova che nessuno l'ha fatto, perché una rimozione non riuscita di un'intera directory conta verso `error_count` invece

1343* `error_count`: Numero di errori che lo sweep ha incontrato durante l'elenco o l'eliminazione di file1346* `error_count`: Numero di errori che lo sweep ha incontrato durante l'elenco o l'eliminazione di file

1344 1347

1348<h4 id="managed-settings-resolved-event">

1349 Evento di impostazioni gestite risolte

1350</h4>

1351

1352Registrato con le [impostazioni gestite](/docs/it/managed-settings) che una sessione ha risolto: una volta all'avvio della sessione, di nuovo quando le impostazioni gestite o lo stato dell'[helper di politica](/docs/it/managed-settings#compute-the-policy-with-a-helper-program) cambiano durante la sessione, e quando Claude Code rifiuta di avviare o termina la sessione per uno dei motivi che l'attributo `error.type` elenca.

1353Usa questo evento per trovare macchine in esecuzione su una fonte gestita inaspettata, macchine il cui helper di politica sta fallendo, e il motivo per cui una macchina ha rifiutato di avviare.

1354Richiede Claude Code v2.1.274 o successivo.

1355

1356Per impostazione predefinita, l'evento contiene le fonti gestite e lo stato dell'helper di politica ma non le impostazioni stesse. Per aggiungere l'attributo `managed_settings.settings` redatto e il digest `managed_settings.resolved_sha256`, imposta `OTEL_LOG_MANAGED_SETTINGS=1`:

1357

1358* Impostalo nel blocco `env` delle impostazioni gestite, impostazioni utente, o `--settings`, o nell'ambiente in cui avvii Claude Code. Un valore nelle impostazioni di progetto o locali non lo attiva, perché un repository clonato può scriverle.

1359* Le impostazioni gestite dal server possono impostarla senza mostrare la [finestra di dialogo di approvazione della sicurezza](/docs/it/server-managed-settings#security-approval-dialogs), perché la variabile aggiunge solo la tua politica redatta dell'organizzazione a un evento che la tua organizzazione riceve già.

1360

1361In una sessione interattiva in una cartella che non hai [fidata](/docs/it/permissions#what-runs-before-you-trust-a-folder), Claude Code non esporta l'evento di rifiuto, perché le impostazioni di progetto e locali potrebbero puntare l'esportazione a un collector diverso prima della fiducia.

1362

1363**Nome evento**: `claude_code.managed_settings_resolved`

1364

1365**Attributi**:

1366

1367* Tutti gli [attributi standard](#standard-attributes)

1368* `event.name`: `"managed_settings_resolved"`

1369* `event.timestamp`: Timestamp ISO 8601

1370* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1371* `managed_settings.trigger`: `"startup"` per l'evento di avvio della sessione, `"change"` quando le impostazioni gestite o lo stato dell'helper di politica sono cambiati più tardi nella sessione, o `"refused"` quando una politica di impostazioni gestite ha fermato la sessione. Claude Code invia un evento `change` solo quando un attributo differisce dall'ultimo evento che ha inviato, e un valore di impostazione modificato conta anche quando `OTEL_LOG_MANAGED_SETTINGS` è disattivato

1372* `error.type`: perché Claude Code ha fermato la sessione. Presente solo su eventi `refused`:

1373 * `"helper_failed"`: un'[esecuzione dell'helper di politica non è riuscita](/docs/it/settings-reference#helper-failures)

1374 * `"policy_invalid"`: le impostazioni gestite contengono un errore che ferma Claude Code dall'avvio, o un'origine amministrativa non è riuscita a caricarsi, quindi Claude Code non può controllare l'applicazione dell'accesso all'organizzazione

1375 * `"consent_rejected"`: l'utente ha rifiutato la [finestra di dialogo di approvazione della sicurezza](/docs/it/server-managed-settings#security-approval-dialogs) per le impostazioni gestite dal server

1376 * `"force_refresh_failed"`: il fetch delle impostazioni che [`forceRemoteSettingsRefresh`](/docs/it/settings-reference#forceremotesettingsrefresh) richiede non è riuscito

1377 * `"gateway_rejected"`: un [gateway di app Claude](/docs/it/claude-apps-gateway) ha risposto al caricamento delle impostazioni gestite con HTTP 403

1378 * `"version_below_minimum"`: questa versione di Claude Code è al di sotto di [`requiredMinimumVersion`](/docs/it/settings-reference#requiredminimumversion) o al di sopra di [`requiredMaximumVersion`](/docs/it/settings-reference#requiredmaximumversion)

1379 * `"_OTHER"`: il caricamento delle impostazioni gestite del gateway di app Claude non è riuscito per un altro motivo

1380* `managed_settings.sources`: ogni fonte gestita che fornisce almeno una [chiave di politica](/docs/it/managed-settings#how-claude-code-combines-managed-sources), priorità più alta per prima, incluse le fonti le cui chiavi non hanno effetto sotto `first-wins`. I valori sono `"remote"`, `"plist"` o `"hklm"` per la politica MDM o a livello di OS, `"file"` per i file di impostazioni gestite e drop-in, `"parent"` quando un [host di incorporamento](/docs/it/managed-settings#let-an-embedding-host-add-policy) fornisce impostazioni, e `"hkcu"` per il [valore del registro Windows HKCU](/docs/it/managed-settings#where-each-mechanism-stores-the-policy) quando Claude Code lo [legge](/docs/it/managed-settings#how-claude-code-combines-managed-sources). Una fonte che porta solo chiavi di controllo, o che Claude Code non poteva leggere, non è elencata. Emesso come array di stringhe, vuoto quando nessuna fonte gestita fornisce una chiave di politica

1381* `managed_settings.source_behavior`: il valore [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) che Claude Code ha letto, `"first-wins"` o `"merge"`. `"first-wins"` quando nessuna fonte imposta la chiave

1382* `managed_settings.helper.state`: stato dell'helper di politica che la fonte MDM o file selezionata configura:

1383 * `"ok"`: l'output dell'helper serve come impostazioni gestite

1384 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"`, o `"schema_rejected"`: l'ultima esecuzione dell'helper non è riuscita. [Helper failures](/docs/it/settings-reference#helper-failures) descrive i casi

1385 * `"none"`: nessun helper è configurato, o la fonte che lo configura non è una politica MDM o un file di impostazioni gestite

1386* `managed_settings.helper.applied`: `"output"` mentre l'output dell'helper stesso serve come impostazioni gestite, `"none"` quando non lo fa

1387* `managed_settings.helper.entry`: `"policyHelper"` quando Claude Code ha selezionato un [`policyHelper`](/docs/it/settings-reference#policyhelper). Assente quando non ha selezionato alcun helper

1388* `managed_settings.helper.path`: il [`path`](/docs/it/settings-reference#policyhelper-path) configurato dell'helper. Presente ogni volta che Claude Code ha selezionato un helper, indipendentemente dal fatto che `OTEL_LOG_MANAGED_SETTINGS` sia impostato

1389* `managed_settings.resolved_sha256` (quando `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 delle impostazioni gestite risolte prima della redazione, serializzate come JSON con chiavi ordinate ricorsivamente e senza spazi. Le macchine con lo stesso digest eseguono la stessa politica. Claude Code invia il digest solo con l'opt-in perché una politica breve può essere recuperata eseguendo l'hash di ipotesi. Assente quando nessuna impostazione gestita è stata risolta, e su eventi `refused`

1390* `managed_settings.settings` (quando `OTEL_LOG_MANAGED_SETTINGS=1`): i nomi e la forma delle impostazioni gestite risolte come stringa JSON, con i valori redatti. Assente su eventi `refused`. Claude Code lo costruisce dal suo schema di impostazioni:

1391

1392 * Un nome di impostazione che lo schema dichiara viene esportato, e una chiave che non dichiara viene lasciata fuori

1393 * Booleani, numeri e valori di stringa che lo schema limita a un insieme fisso di opzioni, come `permissions.defaultMode`, vengono esportati così come sono. `sandbox.network.httpProxyPort` e `sandbox.network.socksProxyPort` vengono esportati come `"[REDACTED]"`

1394 * Ogni altra stringa, come `model`, `apiKeyHelper`, ogni valore `env`, ogni URL, e ogni comando, viene esportato come `"[REDACTED]"`

1395 * I nomi delle voci di mappe, come i nomi delle variabili `env` e gli ID dei plugin, vengono esportati così come sono. Un'impostazione le cui voci lo schema non digita, come `vimInsertModeRemaps`, viene esportata come un singolo `"[REDACTED]"`, e `sandbox.ignoreViolations` viene esportato come un elenco dei suoi elenchi di percorsi senza i modelli di comando

1396 * Un elenco mantiene la sua lunghezza, con ogni voce redatta dalle stesse regole

1397 * Una regola `permissions.allow`, `permissions.deny`, o `permissions.ask` viene esportata come il suo nome dello strumento con il contenuto redatto, come `Read([REDACTED])`, quando lo strumento è incorporato in questa versione di Claude Code o è un riferimento `mcp__` come `mcp__jira__create_issue`. Qualsiasi altra regola viene esportata come `"[REDACTED]"`

1398 * Gli hook seguono le stesse regole, quindi i campi a opzione fissa e numerici come `type` e `timeout` vengono mostrati, mentre ogni comando, URL, `matcher`, e condizione `if` viene esportato come `"[REDACTED]"`

1399

1400 Ad esempio, le impostazioni gestite con `apiKeyHelper`, due variabili `env`, e una regola di negazione vengono esportate come `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1401

1402 Claude Code taglia il valore a 8 KB di UTF-8, e il valore tagliato non è JSON valido

1403* `managed_settings.settings_truncated` (quando `managed_settings.settings` è presente): `true` quando Claude Code ha tagliato `managed_settings.settings` a 8 KB, `false` altrimenti. Emesso come booleano, non come stringa

1404

1345<h2 id="interpret-metrics-and-events-data">1405<h2 id="interpret-metrics-and-events-data">

1346 Interpretazione dei dati di metriche e eventi1406 Interpretazione dei dati di metriche e eventi

1347</h2>1407</h2>

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

1462 1522

1464| ------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------ |1524| ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1471| Comandi eseguiti e file toccati | `tool_result` (eseguito) o `tool_decision` (rifiutato) con `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (`tool_result` solo) |1531| Comandi eseguiti e file toccati | `tool_result` (eseguito) o `tool_decision` (rifiutato) con `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (`tool_result` solo) |

1532| Quali fonti di impostazioni gestite una macchina esegue, se il suo helper di politica è integro e perché una macchina ha rifiutato di avviarsi | `managed_settings_resolved` | `managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type`; `managed_settings.settings` e `managed_settings.resolved_sha256` con `OTEL_LOG_MANAGED_SETTINGS=1` |

1472 1533

1473Claude Code emette solo il flusso di eventi grezzo. Il rilevamento delle anomalie, il baselining, la correlazione tra sessioni e gli avvisi sono responsabilità del vostro SIEM o backend di osservabilità.1534Claude Code emette solo il flusso di eventi grezzo. Il rilevamento delle anomalie, il baselining, la correlazione tra sessioni e gli avvisi sono responsabilità del vostro SIEM o backend di osservabilità.

1474 1535

network-config.md +1 −0

Details

245| `registry.npmjs.org` | Installazioni di plugin (recupero di pacchetti plugin da fonte npm e installazione delle dipendenze dei pacchetti Node.js dei plugin), server MCP lanciati con `npx` e il registro dei pacchetti per le installazioni npm e bun di Claude Code stesso |245| `registry.npmjs.org` | Installazioni di plugin (recupero di pacchetti plugin da fonte npm e installazione delle dipendenze dei pacchetti Node.js dei plugin), server MCP lanciati con `npx` e il registro dei pacchetti per le installazioni npm e bun di Claude Code stesso |

247| `*.frame.claudeusercontent.com` | Letture di contenuto [Artifact](/docs/it/artifacts). La CLI recupera i file di un artifact da questo host quando Claude ne apre uno, e solo quando lo strumento Artifact è [disponibile](/docs/it/artifacts#availability) per il vostro account. Per disattivare lo strumento e eliminare questo requisito, impostate [`"enableArtifact": false`](/docs/it/settings-reference#enableartifact) o [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/it/env-vars); Claude Code rispetta anche l'impostazione deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact). Consultate [Disabilitare gli artifact](/docs/it/artifacts#disable-artifacts) per come queste impostazioni interagiscono |247| `*.frame.claudeusercontent.com` | Letture di contenuto [Artifact](/docs/it/artifacts). La CLI recupera i file di un artifact da questo host quando Claude ne apre uno, e solo quando lo strumento Artifact è [disponibile](/docs/it/artifacts#availability) per il vostro account. Per disattivare lo strumento e eliminare questo requisito, impostate [`"enableArtifact": false`](/docs/it/settings-reference#enableartifact) o [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/it/env-vars); Claude Code rispetta anche l'impostazione deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact). Consultate [Disabilitare gli artifact](/docs/it/artifacts#disable-artifacts) per come queste impostazioni interagiscono |

248| `github.com` | Clonazione di [marketplace di plugin](/docs/it/plugin-marketplaces) e plugin ospitati su GitHub, incluso il marketplace ufficiale Anthropic, su HTTPS o SSH. Per clonare sorgenti GitHub `owner/repo` solo su HTTPS, impostate [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/it/env-vars) |

248| `raw.githubusercontent.com` | Feed del changelog per [`/release-notes`](/docs/it/commands). Nelle sessioni interattive, Claude Code lo recupera anche in background all'avvio quando il changelog memorizzato nella cache non copre ancora la versione in esecuzione, ad esempio al primo avvio dopo un aggiornamento; le sessioni non interattive e cloud non lo recuperano mai |249| `raw.githubusercontent.com` | Feed del changelog per [`/release-notes`](/docs/it/commands). Nelle sessioni interattive, Claude Code lo recupera anche in background all'avvio quando il changelog memorizzato nella cache non copre ancora la versione in esecuzione, ad esempio al primo avvio dopo un aggiornamento; le sessioni non interattive e cloud non lo recuperano mai |

249| `*-review.googlesource.com` | Ricerca di modifiche Gerrit su checkout `googlesource.com`. Quando una sessione di una scheda Claude Desktop Code si avvia o riprende su un checkout [attendibile](/docs/it/permissions#project-allow-rules-and-workspace-trust) il cui `origin` è un host `googlesource.com`, Claude Code chiede anonimamente al server `-review` di quell'host la modifica aperta corrispondente al `Change-Id` di HEAD, una volta per avvio o ripresa. Altri tipi di sessione saltano la ricerca e nessun altro host Gerrit viene contattato. Facoltativo: disabilitare con [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars) |250| `*-review.googlesource.com` | Ricerca di modifiche Gerrit su checkout `googlesource.com`. Quando una sessione di una scheda Claude Desktop Code si avvia o riprende su un checkout [attendibile](/docs/it/permissions#project-allow-rules-and-workspace-trust) il cui `origin` è un host `googlesource.com`, Claude Code chiede anonimamente al server `-review` di quell'host la modifica aperta corrispondente al `Change-Id` di HEAD, una volta per avvio o ripresa. Altri tipi di sessione saltano la ricerca e nessun altro host Gerrit viene contattato. Facoltativo: disabilitare con [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars) |

250| `http-intake.logs.us5.datadoghq.com` | Eventi di telemetria operazionale, inviati solo quando la CLI utilizza direttamente l'API Anthropic, mai per Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Facoltativo: disabilitare con [`DISABLE_TELEMETRY`](/docs/it/data-usage#telemetry-services) o `DO_NOT_TRACK` |251| `http-intake.logs.us5.datadoghq.com` | Eventi di telemetria operazionale, inviati solo quando la CLI utilizza direttamente l'API Anthropic, mai per Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Facoltativo: disabilitare con [`DISABLE_TELEMETRY`](/docs/it/data-usage#telemetry-services) o `DO_NOT_TRACK` |

output-styles.md +125 −43

Details

4 4

5# Output styles5# Output styles

6 6

~~7> Adattare Claude Code per usi oltre l'ingegneria del software~~7> Cambia il ruolo, il tono e il formato di risposta di Claude Code con uno stile di output integrato come Concise o Explanatory, oppure scrivi uno stile personalizzato.

8 8

9Output styles cambiano il modo in cui Claude risponde, non quello che Claude sa. Impostano il ruolo, il tono e il formato di output di Claude per ogni risposta. Utilizzatene uno quando continuate a ripetere la stessa voce o formato ad ogni turno, oppure quando desiderate che Claude agisca come qualcosa di diverso da un ingegnere del software.9Uno stile di output è un insieme di istruzioni che imposta il ruolo, il tono e il formato di risposta di Claude per ogni risposta in una sessione. Claude Code include quattro stili integrati oltre al suo predefinito, e puoi scrivere il tuo.

10 10

11Uno stile di output personalizzato fornisce a Claude le vostre istruzioni e vi permette di scegliere se mantenere le istruzioni integrate di ingegneria del software di Claude Code. Mantenetele quando state cambiando il modo in cui Claude comunica ma state ancora codificando, come rispondere sempre con un diagramma. Omettele quando Claude non sta facendo ingegneria del software affatto, come un assistente di scrittura o un analista di dati.11Utilizza uno stile di output per cambiare il modo in cui Claude risponde e lavora con te per un'intera sessione, così non devi ripetere la richiesta in ogni prompt. Ad esempio, uno stile integrato può rendere le risposte più brevi, aggiungere una spiegazione di ogni modifica, oppure fare in modo che Claude inizi il lavoro senza fare domande di routine. Uno stile personalizzato può anche trasformare Claude in qualcosa di diverso da un ingegnere del software, come un assistente di scrittura o un analista di dati.

12 12

~~13Per le istruzioni relative al vostro progetto, alle convenzioni o al codebase, utilizzate [CLAUDE.md](/docs/it/memory) invece.~~13* Per utilizzare uno stile integrato, scegline uno dagli [stili di output integrati](#built-in-output-styles) e [passa ad esso](#change-your-output-style).

14* Per scrivere le tue istruzioni, [crea uno stile di output personalizzato](#create-a-custom-output-style).

16<Note>

17 Uno stile di output fornisce a Claude istruzioni da seguire. Non garantisce che qualcosa accada sempre o non accada mai. Alcuni bisogni si adattano a una funzione diversa:

19 * Per quello che Claude dovrebbe sapere del tuo progetto, utilizza [CLAUDE.md](/docs/it/memory).

20 * Per qualcosa che deve accadere ogni volta, come la formattazione dopo ogni modifica o il blocco di un comando, utilizza un [hook](/docs/it/hooks-guide).

21 * Per skills, subagents e le altre opzioni, vedi [Scegli tra uno stile di output e altre funzioni](#choose-between-an-output-style-and-other-features).

22</Note>

14 23

15<h2 id="built-in-output-styles">24<h2 id="built-in-output-styles">

16 Output styles integrati25 Output styles integrati

17</h2>26</h2>

18 27

~~19Lo **Default** output style di Claude Code è il suo set standard di istruzioni, progettato per aiutarvi a completare i compiti di ingegneria del software in modo efficiente.~~28Claude Code inizia nello stile [**Default**](#default), le sue istruzioni standard per completare i compiti di ingegneria del software. Ognuno degli altri quattro output styles integrati mantiene quelle istruzioni e aggiunge le proprie.

30Questa tabella mostra cosa cambia ogni stile in una sessione e quando è appropriato:

32| Style | Cosa cambia | Usalo quando |

33| :-------------------------- | :-------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------- |

34| [Proactive](#proactive) | Claude inizia il lavoro subito e fa ipotesi ragionevoli invece di chiedere informazioni su decisioni di routine | Vuoi che Claude continui a lavorare attraverso decisioni di routine, e correggerai il corso se un'ipotesi è sbagliata |

35| [Concise](#concise) | Le risposte iniziano con il risultato e omettono il preambolo, la narrazione e i riepiloghi | Le risposte predefinite sono più lunghe di quanto desideri |

36| [Explanatory](#explanatory) | Claude aggiunge brevi blocchi `Insight` che spiegano le scelte dietro il codice che scrive | Stai imparando a conoscere una codebase o vuoi il ragionamento insieme alla modifica |

37| [Learning](#learning) | Claude spiega le sue scelte e lascia piccoli pezzi di codice da scrivere tu stesso | Vuoi pratica di codifica pratica mentre il compito viene comunque completato |

39<h3 id="default">

40 Default

41</h3>

43Default significa che nessuno output style è selezionato. Claude Code non aggiunge istruzioni di stile e Claude lavora dal prompt di sistema standard di Claude Code, che è scritto per i compiti di ingegneria del software.

45`default` appare nell'elenco `/output-style` insieme agli altri stili, quindi lo [selezioni allo stesso modo](#change-your-output-style).

47<h3 id="proactive">

48 Proactive

49</h3>

51Nello stile Proactive, Claude inizia l'implementazione non appena invii un compito. Fa ipotesi ragionevoli su decisioni di routine piuttosto che fermarsi per chiedere, e non passa alla plan mode a meno che non chiedi un piano. Puoi reindirizzarlo in qualsiasi momento.

53Le istruzioni dello stile dicono anche a Claude di verificare con te nella conversazione prima di un'azione che elimina dati o modifica un sistema condiviso o di produzione. Questo controllo è un'istruzione che Claude segue ed è separato dai prompt di permesso.

55Il passaggio allo stile Proactive non cambia la tua [modalità di permesso](/docs/it/permission-modes). La tua modalità di permesso decide comunque quali chiamate di strumento vengono eseguite senza chiederti, quindi i prompt di permesso appaiono allo stesso modo di prima del passaggio.

57<h3 id="concise">

58 Concise

59</h3>

61Nello stile Concise, la prima frase di una risposta afferma cosa è successo o qual è la risposta. Claude omette l'introduzione, la narrazione passo dopo passo e il riepilogo di chiusura, e risponde a una domanda semplice in una o tre frasi. Svolge il lavoro di ingegneria in modo altrettanto approfondito dello stile Default. Richiede Claude Code v2.1.237 o successivo.

63Claude scrive comunque a piena lunghezza in questi casi:

65* **Qualsiasi cosa tu chieda**: quando chiedi una spiegazione o più dettagli, Claude risponde completamente.

66* **Qualsiasi cosa tu abbia bisogno per agire in sicurezza**: rapporti di errore, output di test falliti, avvisi di sicurezza e conferme per azioni distruttive mantengono il loro contenuto completo.

68<h3 id="explanatory">

69 Explanatory

70</h3>

72Nello stile Explanatory, Claude svolge il compito come fa nello stile Default e aggiunge brevi spiegazioni del perché ha fatto le scelte che ha fatto. Ogni spiegazione appare nella conversazione, prima o dopo il codice di cui parla, in un blocco etichettato `Insight`. Le spiegazioni non sono scritte nei tuoi file come commenti.

74Un blocco `Insight` contiene due o tre punti sulla tua codebase o sul codice che Claude ha scritto, come questo dopo l'aggiunta di un endpoint API:

76```text theme={null}

77★ Insight ─────────────────────────────────────

78- Ogni route in questo repo passa attraverso il wrapper withAuth, quindi il nuovo endpoint ottiene i controlli di sessione senza il suo middleware.

79- I limiti di velocità sono impostati per route in limits.ts, ecco perché questo cambiamento aggiunge una voce lì piuttosto che un default globale.

80─────────────────────────────────────────────────

81```

83<h3 id="learning">

84 Learning

85</h3>

87Nello stile Learning, Claude aggiunge gli stessi blocchi `Insight` dello [stile Explanatory](#explanatory) e ti chiede anche di scrivere parte del codice. Claude gestisce l'implementazione di routine da solo. Quando raggiunge un pezzo con una vera decisione di design, come la gestione degli errori, una struttura dati o la logica di business con più di un approccio valido, lascia alcune righe per te.

20 88

~~21Ci sono quattro output styles integrati aggiuntivi:~~89Claude contrassegna il punto con un commento `TODO(human)` nel file, quindi invia una richiesta che dice cosa è già costruito, cosa scrivere e cosa considerare:

22 90

23* **Proactive**: Claude esegue immediatamente, fa ipotesi ragionevoli invece di fermarsi per decisioni di routine, e preferisce l'azione alla pianificazione. Questa è una guida di esecuzione autonoma più forte di quella che [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) applica, e funziona senza cambiare la vostra modalità di permesso, quindi la vostra modalità di permesso decide comunque cosa viene eseguito senza chiedere.91```text theme={null}

92● Learn by Doing

24 93

25* **Concise**: Claude inizia con il risultato, salta il preambolo e la narrazione, e mantiene le risposte brevi per impostazione predefinita, mentre svolge il lavoro di ingegneria in modo altrettanto approfondito dello stile Default. Quando chiedete una spiegazione o più dettagli, Claude risponde completamente. Claude mantiene sempre il contenuto completo dei rapporti di errore, degli avvisi di sicurezza e delle conferme per le azioni distruttive. Richiede Claude Code v2.1.237 o successivo.94Context: Il modulo di caricamento è in posizione e chiama validateFile() prima di accettare un file. I controlli di dimensione e tipo funzionano per le immagini, ma l'istruzione switch non ha ancora la gestione per i documenti.

26 95

~~27* **Explanatory**: Fornisce "Insights" educativi tra l'aiuto nel completamento dei compiti di ingegneria del software. Aiuta a comprendere le scelte di implementazione e i pattern del codebase.~~96Your Task: In upload.js, implementa il ramo del caso "document" all'interno di validateFile(). Cerca TODO(human).

28 97

29* **Learning**: Modalità collaborativa di apprendimento pratico in cui Claude non solo condividerà "Insights" durante la codifica, ma vi chiederà anche di contribuire con piccoli, strategici pezzi di codice voi stessi. Claude Code aggiungerà marcatori `TODO(human)` nel vostro codice per voi da implementare.98Guidance: Decidi un limite di dimensione per i documenti e se l'estensione del file deve corrispondere al tipo MIME. Restituisci {valid: boolean, error?: string}.

99```

100

101Claude quindi si ferma e aspetta. Scrivi il tuo codice al commento `TODO(human)` e dì a Claude quando hai finito. Claude risponde con un `Insight` sul tuo codice e continua il compito.

30 102

31<h2 id="change-your-output-style">103<h2 id="change-your-output-style">

32 Cambiare il vostro output style104 Cambiare il vostro output style

33</h2>105</h2>

34 106

~~35Scegliete uno stile in uno di questi modi:~~107Scegliete uno stile con il comando, un menu o un file di impostazioni. Il comando e entrambi i menu salvano la vostra scelta in `.claude/settings.local.json` al [livello del progetto locale](/docs/it/settings).

36 108

37* **Comando `/output-style`**: eseguite `/output-style <style>` per passare a uno stile, ad esempio `/output-style concise`. Senza argomenti, il comando elenca gli stili che potete scegliere e contrassegna quello attuale. Claude Code salva la vostra selezione in `.claude/settings.local.json` al [livello del progetto locale](/docs/it/settings).109* **Comando `/output-style`**: eseguite `/output-style <style>` per passare a uno stile, ad esempio `/output-style concise`. Senza argomenti, il comando elenca gli stili che potete scegliere e contrassegna quello attuale.

38 110

39 Il comando funziona anche in [modalità non interattiva](/docs/it/headless) e nelle sessioni Agent SDK, e dall'app mobile o dal web tramite [Remote Control](/docs/it/remote-control#limitations), dove potete elencare e selezionare solo gli [stili incorporati](#built-in-output-styles). Richiede Claude Code v2.1.269 o successivo.111 Il comando funziona anche in [modalità non interattiva](/docs/it/headless) e nelle sessioni Agent SDK, e dall'app mobile o dal web tramite [Remote Control](/docs/it/remote-control#limitations), dove potete elencare e selezionare solo gli [stili incorporati](#built-in-output-styles). Richiede Claude Code v2.1.269 o successivo.

40* **Terminal**: eseguite `/config` e selezionate **Output style** per scegliere uno stile da un menu. Claude Code salva la vostra selezione in `.claude/settings.local.json` al [livello del progetto locale](/docs/it/settings).112* **Menu Terminal**: eseguite `/config` e selezionate **Output style** per scegliere uno stile da un menu.

41* **VS Code extension**: aprite il [menu dei comandi](/docs/it/vs-code#use-the-prompt-box) con `/` e selezionate **Output styles** per scegliere uno stile, inclusi i vostri stili personalizzati. Claude Code salva la vostra selezione in `.claude/settings.local.json`, lo stesso file che scrive il menu del terminal. Richiede Claude Code v2.1.257 o successivo.113* **Estensione VS Code**: aprite il [menu dei comandi](/docs/it/vs-code#use-the-prompt-box) con `/` e selezionate **Output styles** per scegliere uno stile, inclusi i vostri stili personalizzati. Richiede Claude Code v2.1.257 o successivo.

42* **Desktop app**: impostate il campo `outputStyle` in un file di impostazioni, ad esempio `.claude/settings.local.json`, il file che scrive il menu del terminal. Quando eseguite `/config` lì, Claude Code [apre **Settings > Claude Code**](/docs/it/desktop#what%E2%80%99s-not-available-in-desktop) piuttosto che un menu.114* **App Desktop**: impostate il campo `outputStyle` in un file di impostazioni, ad esempio `.claude/settings.local.json`, il file che scrive il menu del terminal. Quando eseguite `/config` lì, Claude Code [apre **Settings > Claude Code**](/docs/it/desktop#what%E2%80%99s-not-available-in-desktop) piuttosto che un menu.

43 115

44Per impostare uno stile senza il menu, modificate direttamente il campo `outputStyle` in un file di impostazioni:116Per impostare uno stile senza il menu, modificate direttamente il campo `outputStyle` in un file di impostazioni:

45 117

49}121}

50```122```

51 123

124Il valore è sensibile alle maiuscole, quindi scrivete i nomi incorporati come `Proactive`, `Concise`, `Explanatory` e `Learning`. Un valore che non corrisponde esattamente a un nome di stile, come `explanatory`, vi fornisce lo stile Default. Il comando `/output-style` ignora le maiuscole.

125

126Per impostare uno stile come predefinito in tutti i progetti, impostate `outputStyle` in `~/.claude/settings.json`. I file di impostazioni di un progetto [hanno la precedenza](/docs/it/settings#settings-precedence) su quel valore.

127

52Quando cambiate stile a metà sessione, Claude utilizza il nuovo stile a partire dal vostro messaggio successivo. Per il costo di quel primo messaggio in prompt caching, consultate [Changing output style](/docs/it/prompt-caching#changing-output-style). Prima della v2.1.251, il nuovo stile si applicava solo dopo aver eseguito `/clear` o avviato una nuova sessione.128Quando cambiate stile a metà sessione, Claude utilizza il nuovo stile a partire dal vostro messaggio successivo. Per il costo di quel primo messaggio in prompt caching, consultate [Changing output style](/docs/it/prompt-caching#changing-output-style). Prima della v2.1.251, il nuovo stile si applicava solo dopo aver eseguito `/clear` o avviato una nuova sessione.

53 129

54<h2 id="create-a-custom-output-style">130<h2 id="create-a-custom-output-style">

98I [Plugins](/docs/it/plugins-reference) possono anche fornire output styles in una directory `output-styles/`.174I [Plugins](/docs/it/plugins-reference) possono anche fornire output styles in una directory `output-styles/`.

99 175

100<h3 id="frontmatter">176<h3 id="frontmatter">

101 Frontmatter177 Riferimento frontmatter

102</h3>178</h3>

103 179

104I file di output style supportano questi campi frontmatter:180Configurate uno stile di output con [frontmatter](/docs/it/glossary#frontmatter) YAML tra i marcatori `---` all'inizio del file. Tutti i campi sono facoltativi e i nomi dei campi utilizzano parole minuscole separate da trattini. Un campo scritto male viene ignorato senza errore. Se lo YAML non viene analizzato, lo stile si carica comunque con il suo nome file senza campi impostati; eseguite `claude --debug` per visualizzare l'errore di analisi.

105 181

107| :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------ |183| :------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

111| `force-for-plugin` | Solo output styles dei plugin: applica questo stile automaticamente ogni volta che il plugin è abilitato, senza richiedere agli utenti di selezionarlo. Sostituisce l'impostazione `outputStyle` dell'utente. Se più plugin abilitati impostano questo, Claude Code utilizza il primo caricato. | `false` |187| `force-for-plugin` | No | Solo output styles dei plugin. Impostate su `true` per applicare questo stile automaticamente ogni volta che il plugin è abilitato, senza richiedere agli utenti di selezionarlo. Sostituisce l'impostazione `outputStyle` dell'utente. Se più plugin abilitati impostano questo, Claude Code utilizza il primo caricato. Predefinito: `false` |

112 188

113<h2 id="how-output-styles-work">189<span id="comparisons-to-related-features" />

114 Come funzionano gli output styles

115</h2>

116 190

117Uno output style modifica le istruzioni che Claude Code fornisce a Claude.191<h2 id="choose-between-an-output-style-and-other-features">

192 Scegliere tra uno stile di output e altre funzionalità

193</h2>

118 194

119* Claude Code invia le istruzioni dello stile attivo con ogni richiesta.195Uno stile di output si applica a ogni risposta in una sessione. È un'istruzione che Claude segue, quindi nulla la impone. Quando quello che desiderate è più ristretto di ogni risposta, o deve accadere senza fallo, un'altra funzionalità si adatta meglio.

120* Quando [selezionate uno stile diverso da Default](#change-your-output-style), Claude Code ricorda anche a Claude lo stile durante la conversazione.

121* Gli output styles personalizzati omettono le istruzioni integrate di ingegneria del software di Claude Code, come come definire l'ambito dei cambiamenti, scrivere commenti e verificare il lavoro, a meno che `keep-coding-instructions` non sia impostato a `true`.

122 196

123Gli output styles si applicano alla conversazione principale e a un [fork](/docs/it/sub-agents#fork-the-current-conversation), che eredita la conversazione completa e il prompt di sistema del genitore. Altri [subagent eseguono il proprio prompt di sistema](/docs/it/sub-agents#what-loads-at-startup), quindi gli stili non cambiano il modo in cui rispondono.197Questa tabella abbina quello che desiderate alla funzionalità che lo fa:

124 198

125L'utilizzo dei token dipende dallo stile. Le istruzioni di uno stile aggiungono token di input, anche se il prompt caching riduce questo costo dopo la prima richiesta in una sessione.199| Desiderate | Utilizzate | Perché si adatta |

200| :----------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |

201| Ogni risposta in una certa voce, lunghezza o formato, o Claude in un ruolo diverso | Uno stile di output | Si applica all'intera sessione, e cambiate gli stili con un comando |

202| Claude conosce le convenzioni, i comandi e la struttura del vostro progetto | [CLAUDE.md](/docs/it/memory) | Contiene quello che Claude dovrebbe sapere sulla codebase, e rimane caricato qualunque stile scegliate |

203| Istruzioni per un tipo di attività, come una checklist di rilascio o una procedura di revisione | Una [skill](/docs/it/skills) | Claude la carica solo quando la richiamate o l'attività corrisponde, quindi non modifica le risposte non correlate |

204| Qualcosa che accada ogni volta senza eccezione, come la formattazione dopo ogni modifica o il blocco di un comando | Un [hook](/docs/it/hooks-guide) | Claude Code esegue un hook stesso a un evento del ciclo di vita, quindi non dipende da Claude che segua un'istruzione |

205| Un assistente con le proprie istruzioni, modello e strumenti per un'attività focalizzata | Un [subagent](/docs/it/sub-agents) | Viene eseguito in un contesto separato con il proprio prompt di sistema e restituisce un riepilogo alla vostra conversazione |

206| Un'aggiunta alle istruzioni di Claude che passate quando avviate Claude Code | [`--append-system-prompt`](/docs/it/cli-reference#system-prompt-flags) | Si aggiunge al prompt di sistema senza rimuovere nulla |

126 207

127Gli output styles integrati Explanatory e Learning producono risposte più lunghe rispetto a Default per progettazione, il che aumenta i token di output. Lo stile Concise fa il contrario istruendo Claude a mantenere le risposte brevi per impostazione predefinita. Per gli stili personalizzati, l'utilizzo dei token di output dipende da ciò che le vostre istruzioni dicono a Claude di produrre.208Queste funzionalità si combinano. Ad esempio, potete utilizzare CLAUDE.md per quello che Claude dovrebbe sapere, uno stile di output per come risponde, e un hook per qualsiasi cosa che debba essere garantita. [Estendere Claude Code](/docs/it/features-overview) confronta il resto delle funzionalità dell'estensione.

128 209

129<h2 id="comparisons-to-related-features">210<h2 id="how-output-styles-work">

130 Confronti con funzionalità correlate211 Come funzionano gli output styles

131</h2>212</h2>

132 213

133Diverse funzionalità personalizzano il comportamento di Claude Code. Gli output styles modificano le istruzioni predefinite di Claude Code e si applicano a ogni risposta. Le altre aggiungono istruzioni senza cambiare quelle predefinite, o le limitano a un compito specifico.214Un output style modifica le istruzioni che Claude Code fornisce a Claude.

215

216* Claude Code invia le istruzioni dello style attivo con ogni richiesta.

217* Gli output styles personalizzati omettono le istruzioni di ingegneria del software integrate di Claude Code, come il modo di limitare le modifiche, scrivere commenti e verificare il lavoro, a meno che `keep-coding-instructions` non sia impostato su `true`.

218

219Gli output styles si applicano alla conversazione principale e a un [fork](/docs/it/sub-agents#fork-the-current-conversation), che eredita la conversazione completa e il prompt di sistema del genitore. Altri [subagents eseguono il loro prompt di sistema](/docs/it/sub-agents#what-loads-at-startup), quindi gli styles non cambiano il modo in cui rispondono.

220

221L'utilizzo dei token dipende dallo style. Le istruzioni di uno style aggiungono token di input, anche se il prompt caching riduce questo costo dopo la prima richiesta in una sessione.

134 222

135| Funzionalità | Come funziona | Utilizzatela quando |223Gli output styles Explanatory e Learning integrati producono risposte più lunghe rispetto a Default per design, il che aumenta i token di output. Lo style Concise fa il contrario istruendo Claude a mantenere le risposte brevi per impostazione predefinita. Per gli styles personalizzati, l'utilizzo dei token di output dipende da ciò che le vostre istruzioni dicono a Claude di produrre.

136| :----------------------- | :------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- |

137| Output styles | Modifica le istruzioni predefinite di Claude Code | Desiderate un ruolo, tono o formato di risposta predefinito diverso ad ogni turno |

138| [CLAUDE.md](/docs/it/memory) | Aggiunge un messaggio utente dopo il prompt di sistema | Claude dovrebbe sempre conoscere le convenzioni del vostro progetto e il contesto del codebase |

139| `--append-system-prompt` | Aggiunge al prompt di sistema senza rimuovere nulla | Desiderate un'aggiunta una tantum passata come [flag CLI](/docs/it/cli-reference#system-prompt-flags) al lancio |

140| [Agents](/docs/it/sub-agents) | Esegue un subagent con il suo prompt di sistema, modello e strumenti | Desiderate un helper con ambito separato per un compito focalizzato |

141| [Skills](/docs/it/skills) | Carica istruzioni specifiche per compiti quando invocate o rilevanti | Avete un flusso di lavoro riutilizzabile |

142 224

143<h2 id="related-resources">225<h2 id="related-resources">

144 Risorse correlate226 Risorse correlate

overview.md +1 −0

Details

247* [Guida rapida](/docs/it/quickstart): esamina il tuo primo compito reale, dall'esplorazione di una base di codice al commit di una correzione247* [Guida rapida](/docs/it/quickstart): esamina il tuo primo compito reale, dall'esplorazione di una base di codice al commit di una correzione

248* [Archivia istruzioni e memorie](/docs/it/memory): dai a Claude istruzioni persistenti con file CLAUDE.md e memoria automatica248* [Archivia istruzioni e memorie](/docs/it/memory): dai a Claude istruzioni persistenti con file CLAUDE.md e memoria automatica

249* [Flussi di lavoro comuni](/docs/it/common-workflows) e [best practice](/docs/it/best-practices): modelli per ottenere il massimo da Claude Code249* [Flussi di lavoro comuni](/docs/it/common-workflows) e [best practice](/docs/it/best-practices): modelli per ottenere il massimo da Claude Code

250* [Claude Academy](https://academy.claude.com/): corsi gratuiti a ritmo autonomo, inclusi [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action)

250* [Un harness per ogni compito](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): come il team di Claude Code utilizza [flussi di lavoro dinamici](/docs/it/workflows) per orchestrare subagenti su larga scala251* [Un harness per ogni compito](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): come il team di Claude Code utilizza [flussi di lavoro dinamici](/docs/it/workflows) per orchestrare subagenti su larga scala

251* [Impostazioni](/docs/it/settings): personalizza Claude Code per il tuo flusso di lavoro252* [Impostazioni](/docs/it/settings): personalizza Claude Code per il tuo flusso di lavoro

252* [Risoluzione dei problemi](/docs/it/troubleshooting): soluzioni per i problemi comuni253* [Risoluzione dei problemi](/docs/it/troubleshooting): soluzioni per i problemi comuni

permission-modes.md +20 −5

Details

267 267

268Quando il piano è pronto, Claude lo presenta e chiede come procedere. Da quel prompt puoi scegliere:268Quando il piano è pronto, Claude lo presenta e chiede come procedere. Da quel prompt puoi scegliere:

269 269

270* **Sì, e utilizza la modalità auto**: approva e inizia in [modalità auto](#eliminate-prompts-with-auto-mode). Quando la modalità auto non è disponibile, questa opzione legge **Sì, auto-accetta le modifiche**. Se hai avviato la sessione con le autorizzazioni di bypass abilitate, l'opzione legge **Sì, e passa a BYPASS PERMISSIONS (nessun ulteriore prompt) per questa sessione** invece.270* **Sì, e utilizza la modalità auto**: approva e inizia in [modalità auto](#eliminate-prompts-with-auto-mode). Se la modalità auto non è [disponibile per la tua sessione](#eliminate-prompts-with-auto-mode), ad esempio perché la tua organizzazione l'ha disattivata, questa opzione legge **Sì, auto-accetta le modifiche**. Se hai avviato la sessione con le autorizzazioni di bypass abilitate, l'opzione legge **Sì, e passa a BYPASS PERMISSIONS (nessun ulteriore prompt) per questa sessione** invece.

271* **Sì, approva manualmente le modifiche**: approva e rivedi ogni modifica individualmente.271* **Sì, approva manualmente le modifiche**: approva e rivedi ogni modifica individualmente.

272* **No, continua a pianificare**: rimani in modalità plan e dì a Claude cosa cambiare.272* **No, continua a pianificare**: rimani in modalità plan e dì a Claude cosa cambiare.

273 273

457 457

458I confini non vengono archiviati come regole. Il classificatore li rilegge dalla trascrizione su ogni controllo, quindi un confine può andare perso se la [compattazione del contesto](/docs/it/costs#reduce-token-usage) rimuove il messaggio che lo ha dichiarato. Per una garanzia dura, aggiungi una [regola deny](/docs/it/permissions#permission-rule-syntax) invece.458I confini non vengono archiviati come regole. Il classificatore li rilegge dalla trascrizione su ogni controllo, quindi un confine può andare perso se la [compattazione del contesto](/docs/it/costs#reduce-token-usage) rimuove il messaggio che lo ha dichiarato. Per una garanzia dura, aggiungi una [regola deny](/docs/it/permissions#permission-rule-syntax) invece.

459 459

460<h3 id="approvals-you-state-in-conversation">

461 Approvazioni che dichiari nella conversazione

462</h3>

463

464Se dici a Claude che un'azione bloccata è consentita, il classificatore legge questo come la tua approvazione e può cancellare il blocco. Come l'hai formulato decide se l'azione viene eseguita, e quanto lontano arriva l'approvazione:

465

466* **Nomina l'azione e i suoi dettagli**: il tuo messaggio deve nominare l'azione e la cosa specifica che la rende pericolosa, come il ramo di un force push. Nominare solo il verbo non cancella nulla, quindi "puoi fare force-push" lascia il blocco in vigore.

467* **Aspettati che copra un'azione**: un'approvazione copre l'azione distruttiva che hai nominato, quindi un'azione successiva viene bloccata di nuovo a meno che tu non abbia concesso l'approvazione come permanente. Per smettere di approvare un modello di routine un'azione alla volta, aggiungilo a [`autoMode.allow`](/docs/it/auto-mode-config#override-the-block-and-allow-rules).

468* **Alcuni blocchi rimangono in vigore**: [l'ordine di precedenza del classificatore](/docs/it/auto-mode-config#override-the-block-and-allow-rules) stabilisce quali blocchi la tua approvazione può raggiungere. Per eseguire un passaggio che non cancellerà, [esci dalla modalità auto](#switch-permission-modes) e rispondi al prompt di autorizzazione.

469

460<h3 id="when-auto-mode-falls-back">470<h3 id="when-auto-mode-falls-back">

461 Quando la modalità auto passa ai prompt manuali471 Quando la modalità auto passa ai prompt manuali

462</h3>472</h3>

465 475

466* **Un'azione bloccata**: Claude Code mostra una notifica e elenca l'azione in `/permissions` sotto la scheda **Recently denied**, dove puoi premere `r` per ritentarla con un'approvazione manuale. Quando il classificatore produce [nessun verdetto sull'azione](/docs/it/errors#auto-mode-cannot-determine-the-safety-of-an-action), perché un controllo di sicurezza separato dalla modalità auto ha rifiutato la richiesta del classificatore o la sua risposta non è stata analizzata, Claude Code nega l'azione senza la notifica o la voce **Recently denied**.476* **Un'azione bloccata**: Claude Code mostra una notifica e elenca l'azione in `/permissions` sotto la scheda **Recently denied**, dove puoi premere `r` per ritentarla con un'approvazione manuale. Quando il classificatore produce [nessun verdetto sull'azione](/docs/it/errors#auto-mode-cannot-determine-the-safety-of-an-action), perché un controllo di sicurezza separato dalla modalità auto ha rifiutato la richiesta del classificatore o la sua risposta non è stata analizzata, Claude Code nega l'azione senza la notifica o la voce **Recently denied**.

467* **Blocchi ripetuti**: se il classificatore blocca un'azione 3 volte di seguito o 20 volte in totale, la modalità auto si mette in pausa e Claude Code riprende a richiedere. L'approvazione dell'azione richiesta riprende la modalità auto. Questi soglie non sono configurabili. Qualsiasi azione consentita ripristina il contatore consecutivo, mentre il contatore totale persiste per la sessione e si ripristina solo quando il suo limite attiva un fallback. Claude Code non conta un diniego verso nessuno dei due soglie quando [un controllo di sicurezza separato dalla modalità auto rifiuta la richiesta del classificatore](/docs/it/errors#auto-mode-cannot-determine-the-safety-of-an-action); la voce collegata copre come Claude Code gestisce quei dinieghi.477* **Blocchi ripetuti**: se il classificatore blocca un'azione 3 volte di seguito o 20 volte in totale, la modalità auto si mette in pausa e Claude Code riprende a richiedere. L'approvazione dell'azione richiesta riprende la modalità auto. Questi soglie non sono configurabili. Qualsiasi azione consentita ripristina il contatore consecutivo, mentre il contatore totale persiste per la sessione e si ripristina solo quando il suo limite attiva un fallback. Claude Code non conta un diniego verso nessuno dei due soglie quando [un controllo di sicurezza separato dalla modalità auto rifiuta la richiesta del classificatore](/docs/it/errors#auto-mode-cannot-determine-the-safety-of-an-action); la voce collegata copre come Claude Code gestisce quei dinieghi.

468* **Sessioni che non possono richiedere**: un'esecuzione non interattiva `-p` senza un [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) non ha un prompt a cui ricorrere. Quando i blocchi ripetuti raggiungono una soglia, l'azione non viene eseguita e Claude continua a lavorare. Lo stesso si applica quando [un controllo di sicurezza separato dalla modalità auto rifiuta la richiesta del classificatore](/docs/it/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code non ferma l'esecuzione in nessuno dei due casi.478* **Sessioni che non possono richiedere**: un'esecuzione [non interattiva](/docs/it/headless) `-p` senza un [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) non ha un prompt a cui ricorrere. Quando i blocchi ripetuti raggiungono una soglia, l'azione non viene eseguita e Claude continua a lavorare. Lo stesso si applica quando [un controllo di sicurezza separato dalla modalità auto rifiuta la richiesta del classificatore](/docs/it/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code non ferma l'esecuzione in nessuno dei due casi.

469* **Un cambio di modalità durante un controllo**: se cambi le modalità di autorizzazione mentre un controllo del classificatore è in sospeso, Claude Code scarta un verdetto che la nuova modalità non avrebbe richiesto piuttosto che applicarlo: sei richiesto per l'approvazione invece, o l'azione viene auto-negata in modalità [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).479* **Un cambio di modalità durante un controllo**: se cambi le modalità di autorizzazione mentre un controllo del classificatore è in sospeso, Claude Code scarta un verdetto che la nuova modalità non avrebbe richiesto piuttosto che applicarlo: sei richiesto per l'approvazione invece, o l'azione viene auto-negata in modalità [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).

470 480

471I blocchi ripetuti di solito significano che il classificatore manca di contesto sulla tua infrastruttura. Usa `/feedback` per segnalare falsi positivi, o fai in modo che un amministratore [configuri l'infrastruttura attendibile](/docs/it/auto-mode-config).481I blocchi ripetuti di solito significano che il classificatore manca di contesto sulla tua infrastruttura. Usa `/feedback` per segnalare falsi positivi, o fai in modo che un amministratore [configuri l'infrastruttura attendibile](/docs/it/auto-mode-config).

480 * Scritture su [percorsi protetti](#protected-paths) vengono instradate al classificatore anche quando una regola allow corrisponde, e così fanno le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths) in Claude Code v2.1.218 e successivi490 * Scritture su [percorsi protetti](#protected-paths) vengono instradate al classificatore anche quando una regola allow corrisponde, e così fanno le rimozioni `rm` e `rmdir` che prendono di mira un [percorso critico](#critical-paths) in Claude Code v2.1.218 e successivi

481 * Gli strumenti MCP contrassegnati [`requiresUserInteraction`](/docs/it/mcp#require-approval-for-a-specific-tool) ti chiedono direttamente anche quando una regola allow corrisponde, e così fanno gli strumenti connector [che la tua organizzazione ha impostato su `ask`](/docs/it/mcp#organization-controls-on-connector-tools) in sessioni dove quella impostazione raggiunge Claude Code491 * Gli strumenti MCP contrassegnati [`requiresUserInteraction`](/docs/it/mcp#require-approval-for-a-specific-tool) ti chiedono direttamente anche quando una regola allow corrisponde, e così fanno gli strumenti connector [che la tua organizzazione ha impostato su `ask`](/docs/it/mcp#organization-controls-on-connector-tools) in sessioni dove quella impostazione raggiunge Claude Code

482 * Un comando shell che porta [domini consentiti per comando](/docs/it/sandboxing#per-command-allowed-domains-in-auto-mode) viene anche instradato al classificatore anche quando una regola allow corrisponde, perché una regola approva il comando, non i suoi host492 * Un comando shell che porta [domini consentiti per comando](/docs/it/sandboxing#per-command-allowed-domains-in-auto-mode) viene anche instradato al classificatore anche quando una regola allow corrisponde, perché una regola approva il comando, non i suoi host

483 * Le regole ask che corrispondono sul contenuto di un comando, come `Bash(git push *)`, ricadono in un [prompt di autorizzazione](/docs/it/permissions#bash-rule-limits)493 * Le regole ask che corrispondono sul contenuto di un comando, come `Bash(git push *)`, ricadono in un prompt di autorizzazione

484 2. Le azioni di sola lettura e le modifiche di file nella tua directory di lavoro vengono auto-approvate, tranne le scritture su [percorsi protetti](#protected-paths) e [la prima lettura al di fuori delle directory di lavoro](#first-read-outside-the-working-directories), che ti richiede494 2. Le azioni di sola lettura e le modifiche di file nella tua directory di lavoro vengono auto-approvate, tranne le scritture su [percorsi protetti](#protected-paths) e [la prima lettura al di fuori delle directory di lavoro](#first-read-outside-the-working-directories), che ti richiede

485 3. Tutto il resto va al classificatore. Gli strumenti connector e gli strumenti MCP contrassegnati [`requiresUserInteraction`](/docs/it/mcp#require-approval-for-a-specific-tool) che ti chiedono direttamente nel passaggio 1 non raggiungono mai il classificatore, quindi un'approvazione richiesta dall'organizzazione o un passaggio di consenso non viene mai auto-approvato495 3. Tutto il resto va al classificatore. Gli strumenti connector e gli strumenti MCP contrassegnati [`requiresUserInteraction`](/docs/it/mcp#require-approval-for-a-specific-tool) che ti chiedono direttamente nel passaggio 1 non raggiungono mai il classificatore, quindi un'approvazione richiesta dall'organizzazione o un passaggio di consenso non viene mai auto-approvato

486 4. Se il classificatore blocca, Claude riceve il motivo e prova un'alternativa. Nella maggior parte delle sessioni il motivo indica la regola a cui il classificatore ha trovato corrispondenza, ad esempio `[Data Exfiltration]`, invece di fornire una spiegazione scritta; vedi [Rivedi i dinieghi](/docs/it/auto-mode-config#review-denials)496 4. Se il classificatore blocca, Claude riceve il motivo e prova un'alternativa. Nella maggior parte delle sessioni il motivo indica la regola a cui il classificatore ha trovato corrispondenza, ad esempio `[Data Exfiltration]`, invece di fornire una spiegazione scritta; vedi [Rivedi i dinieghi](/docs/it/auto-mode-config#review-denials)

508 1. Prima che un subagent inizi, la descrizione del compito delegato viene valutata, quindi un compito che sembra pericoloso viene bloccato al momento dello spawn.518 1. Prima che un subagent inizi, la descrizione del compito delegato viene valutata, quindi un compito che sembra pericoloso viene bloccato al momento dello spawn.

509 2. Mentre il subagent viene eseguito, ognuna delle sue azioni passa attraverso il classificatore con le stesse regole della sessione padre, e qualsiasi `permissionMode` nel frontmatter del subagent viene ignorato.519 2. Mentre il subagent viene eseguito, ognuna delle sue azioni passa attraverso il classificatore con le stesse regole della sessione padre, e qualsiasi `permissionMode` nel frontmatter del subagent viene ignorato.

510 3. Quando il subagent finisce, il classificatore esamina il suo lavoro e il suo rapporto finale prima che il padre legga il rapporto. Quando il classificatore contrassegna il lavoro o il rapporto del subagent, o un controllo di sicurezza API separato rifiuta la revisione, il rapporto viene comunque consegnato, anteposto con un avviso di sicurezza. Quando il classificatore non è disponibile per la revisione, il rapporto arriva con una nota per verificare il lavoro del subagent prima di agire su di esso.520 3. Quando il subagent finisce, il classificatore esamina il suo lavoro e il suo rapporto finale prima che il padre legga il rapporto. Quando il classificatore contrassegna il lavoro o il rapporto del subagent, o un controllo di sicurezza API separato rifiuta la revisione, il rapporto viene comunque consegnato, anteposto con un avviso di sicurezza. Quando il classificatore non è disponibile per la revisione, il rapporto arriva con una nota per verificare il lavoro del subagent prima di agire su di esso.

~~511~~

512 Il passaggio 1 richiede Claude Code v2.1.178 o successivo. Le versioni precedenti applicavano il classificatore ai passaggi 2 e 3, ma non valutavano la descrizione del compito prima che il subagent iniziasse.

513 </Accordion>521 </Accordion>

514 522

515 <Accordion title="Costo e latenza">523 <Accordion title="Costo e latenza">

660 668

661Claude Code tratta anche un glob o una barra finale direttamente sotto una variabile shell, come `rm -rf "$DIR"/*`, come una rimozione di percorso critico, perché il comando diventa una rimozione dalla radice del filesystem quando la variabile è vuota.669Claude Code tratta anche un glob o una barra finale direttamente sotto una variabile shell, come `rm -rf "$DIR"/*`, come una rimozione di percorso critico, perché il comando diventa una rimozione dalla radice del filesystem quando la variabile è vuota.

662 670

671Il prompt per questo caso di variabile nomina il comando `rm` contrassegnato e dice come riscriverlo in modo che il controllo passi:

672

673* Per una variabile come `$DIR`, proteggi ogni espansione in modo che la shell si fermi con un errore quando la variabile non è impostata o è vuota, come in `rm -rf "${DIR:?}"/*`, oppure usa un percorso letterale

674* Per una variabile che è normalmente impostata, come `$HOME`, usa un percorso letterale

675

676Una rimozione le cui espansioni sono tutte protette in questo modo non è una rimozione di percorso critico, quindi in modalità `bypassPermissions` viene eseguita senza un prompt.

677

663Nascondere la rimozione dentro una subshell con `(...)`, un gruppo di parentesi graffe con `{ ...; }`, la sostituzione di comando con `$(...)` o backtick, o la sostituzione di processo con `<(...)`, non salta il controllo. Claude Code trova una rimozione di percorso critico indipendentemente dal fatto che si trovi dentro la forma annidata, come in `(rm -rf ~)` o `echo "$(rm -rf ~)"`, o altrove nello stesso comando.678Nascondere la rimozione dentro una subshell con `(...)`, un gruppo di parentesi graffe con `{ ...; }`, la sostituzione di comando con `$(...)` o backtick, o la sostituzione di processo con `<(...)`, non salta il controllo. Claude Code trova una rimozione di percorso critico indipendentemente dal fatto che si trovi dentro la forma annidata, come in `(rm -rf ~)` o `echo "$(rm -rf ~)"`, o altrove nello stesso comando.

664 679

665<h3 id="remove-item-in-powershell">680<h3 id="remove-item-in-powershell">

permissions.md +2 −10

Details

26 26

27Prima della v2.1.211, Claude Code salvava sempre la regola nella directory di avvio, quindi un'approvazione concessa in un worktree o sottodirectory non si applicava al resto del repository. Le regole che le versioni precedenti hanno salvato in una sottodirectory o worktree si applicano ancora alle sessioni avviate lì.27Prima della v2.1.211, Claude Code salvava sempre la regola nella directory di avvio, quindi un'approvazione concessa in un worktree o sottodirectory non si applicava al resto del repository. Le regole che le versioni precedenti hanno salvato in una sottodirectory o worktree si applicano ancora alle sessioni avviate lì.

28 28

29A volte un prompt di autorizzazione offre solo un'approvazione una tantum, senza opzione "non chiedere più" e senza opzione per consentire l'azione per il resto della sessione. Claude Code offre quelle opzioni solo quando il prompt può mostrarti tutto ciò che consentirebbero, quindi una regola che salvi da un prompt copre solo ciò che la sua opzione denominata.29A volte un prompt di autorizzazione offre solo un'approvazione una tantum, senza opzione "non chiedere più" e senza opzione per consentire l'azione per il resto della sessione. Claude Code offre quelle opzioni solo quando il prompt può mostrarti tutto ciò che consentirebbero, quindi una regola che salvi da un prompt copre solo ciò che la sua opzione denominata. Quando un prompt offre solo l'approvazione una tantum, approva l'azione una volta, o aggiungi la regola tu stesso in [`/permissions`](#manage-permissions).

31Quando la directory in cui hai avviato Claude Code è quella che rende l'etichetta dell'opzione troppo lunga, Claude Code la accorcia nell'etichetta, sostituendo la tua home directory con `~` e poi la fine del percorso con `…`, e mantiene l'opzione. Salvi comunque la stessa regola. Claude Code lascia fuori le opzioni in tre casi:

~~33* **Comando o modifica:** troppo grande per mostrare completamente.~~

~~34* **Comandi o percorsi che la regola coprirebbe:** l'etichetta non può contenerli tutti.~~

~~35* **Directory di avvio troppo lunga, non accorciata:** contiene caratteri che Claude Code non può visualizzare in sicurezza, o anche il suo inizio non si adatta.~~

~~37Approva l'azione una volta, o aggiungi la regola tu stesso in [`/permissions`](#manage-permissions).~~

38 30

39<h3 id="add-a-comment-when-you-answer-a-permission-prompt">31<h3 id="add-a-comment-when-you-answer-a-permission-prompt">

40 Aggiungi un commento quando rispondi a un prompt di autorizzazione32 Aggiungi un commento quando rispondi a un prompt di autorizzazione

224 216

225Le regole di autorizzazione accettano globs nei nomi degli strumenti solo dopo un prefisso letterale `mcp__<server>__`. Il segmento del server deve essere privo di glob in modo che la regola nomini un server specifico che avete configurato. `mcp__puppeteer__*` corrisponde a ogni strumento dal server `puppeteer`, e `mcp__github__get_*` corrisponde ai suoi strumenti `get_`. Un glob di autorizzazione non ancorato come `"*"`, `"B*"`, o `"mcp__*"` viene saltato con un avviso e non approva automaticamente nulla.217Le regole di autorizzazione accettano globs nei nomi degli strumenti solo dopo un prefisso letterale `mcp__<server>__`. Il segmento del server deve essere privo di glob in modo che la regola nomini un server specifico che avete configurato. `mcp__puppeteer__*` corrisponde a ogni strumento dal server `puppeteer`, e `mcp__github__get_*` corrisponde ai suoi strumenti `get_`. Un glob di autorizzazione non ancorato come `"*"`, `"B*"`, o `"mcp__*"` viene saltato con un avviso e non approva automaticamente nulla.

226 218

227Una regola di negazione o richiesta il cui nome dello strumento non corrisponde a nessuno strumento noto produce un avviso all'avvio per catturare gli errori di digitazione. I nomi degli strumenti contenenti `_` o `*` sono esenti dal controllo.219Una regola di negazione o richiesta il cui nome dello strumento non corrisponde a nessuno strumento noto produce un avviso all'avvio per catturare gli errori di digitazione. I nomi degli strumenti contenenti `_` o `*` sono esenti dal controllo, e così pure i nomi degli strumenti che Claude Code ha rimosso, come `TaskOutput`.

228 220

229L'etichetta mostrata per uno strumento nella trascrizione e nella finestra di dialogo di autorizzazione può differire dal suo nome canonico. Ad esempio, lo strumento etichettato `Stop Task` nella trascrizione ha il nome canonico `TaskStop`. Le regole di autorizzazione e i [matcher di hook](/docs/it/hooks) non corrispondono all'etichetta, quindi una regola scritta come `Stop Task` non corrisponde. Per le regole di negazione e richiesta, l'avviso all'avvio di cui sopra cattura la mancata corrispondenza. Utilizzate i nomi canonici elencati nel [riferimento degli strumenti](/docs/it/tools-reference).221L'etichetta mostrata per uno strumento nella trascrizione e nella finestra di dialogo di autorizzazione può differire dal suo nome canonico. Ad esempio, lo strumento etichettato `Stop Task` nella trascrizione ha il nome canonico `TaskStop`. Le regole di autorizzazione e i [matcher di hook](/docs/it/hooks) non corrispondono all'etichetta, quindi una regola scritta come `Stop Task` non corrisponde. Per le regole di negazione e richiesta, l'avviso all'avvio di cui sopra cattura la mancata corrispondenza. Utilizzate i nomi canonici elencati nel [riferimento degli strumenti](/docs/it/tools-reference).

230 222

plugin-evals.md +3 −1

Details

339 Concedi strumenti339 Concedi strumenti

340</h3>340</h3>

341 341

342Le esecuzioni non si fermano mai per chiedere il permesso. Gli strumenti incorporati che hanno bisogno di una concessione che non hai dato, come `Bash`, `Write`, `Edit`, `WebFetch`, e `WebSearch`, vengono rimossi dalla sessione, quindi Claude non può chiamarli affatto. L'allowlist è gli strumenti di sola lettura che il caso elenca in `allowed_tools`, da `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `Agent`, `TodoWrite`, e gli strumenti di task `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, `TaskStop`, e `TaskOutput`, più quello che concedi con `--allow-tools`, che si applica a ogni caso nell'esecuzione. Per lasciare che i casi usino `Bash`, `Write`, `Edit`, `WebFetch`, o `WebSearch`, concedili tu stesso:342Le esecuzioni non si fermano mai per chiedere il permesso. Gli strumenti incorporati che hanno bisogno di una concessione che non hai dato, come `Bash`, `Write`, `Edit`, `WebFetch`, e `WebSearch`, vengono rimossi dalla sessione, quindi Claude non può chiamarli affatto.

343

344L'allowlist è gli strumenti di sola lettura che il caso elenca in `allowed_tools`, da `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `Agent`, `TodoWrite`, e gli strumenti di task `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, e `TaskStop`, più quello che concedi con `--allow-tools`. Quella concessione si applica a ogni caso nell'esecuzione. Per lasciare che i casi usino `Bash`, `Write`, `Edit`, `WebFetch`, o `WebSearch`, concedili tu stesso:

343 345

344```bash theme={null}346```bash theme={null}

345claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"347claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"

plugins-reference.md +117 −67

Details

71Prompt di sistema dettagliato per l'agent che descrive il suo ruolo, competenza e comportamento.71Prompt di sistema dettagliato per l'agent che descrive il suo ruolo, competenza e comportamento.

72```72```

73 73

74Gli agent del plugin supportano i campi frontmatter `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background`, [`omitClaudeMd`](/docs/it/sub-agents#supported-frontmatter-fields) e `isolation`. L'unico valore `isolation` valido è `"worktree"`.74<h4 id="plugin-agent-frontmatter">

75 Frontmatter dell'agent del plugin

76</h4>

78Un file agent del plugin utilizza gli stessi [campi frontmatter di un file subagent](/docs/it/sub-agents#supported-frontmatter-fields), tranne che Claude Code onora solo alcuni di essi quando l'agent proviene da un plugin:

80* **Supportati**: `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background`, `omitClaudeMd`, `isolation`, `color` e `experimental`. L'unico valore `isolation` valido è `"worktree"`.

81* **Non supportati, per motivi di sicurezza**: `hooks`, `mcpServers` e `permissionMode`. Claude Code ignora questi quando carica un agent da un plugin. Per utilizzarli, copia il file agent in `.claude/agents/` o `~/.claude/agents/`.

82* **Non supportati**: `initialPrompt`.

75 83

~~76Per motivi di sicurezza, gli agent forniti dal plugin non supportano `hooks`, `mcpServers` o `permissionMode`.~~84Puoi mettere i file degli agent del plugin in sottocartelle di `agents/`. Claude Code [li carica ricorsivamente](/docs/it/sub-agents#choose-the-subagent-scope) e unisce il nome del plugin, ogni nome di sottocartella e il nome del file con i due punti per formare il nome con scope dell'agent. Ad esempio, `agents/review/security.md` in un plugin denominato `my-plugin` viene caricato come `my-plugin:review:security`. Due impostazioni cambiano quel nome:

86* Frontmatter `name`: sostituisce solo il nome del file, quindi `name: audit` in `agents/review/security.md` viene caricato come `my-plugin:review:audit`

87* Campo manifest [`agents`](#component-path-fields): un file che elenchi lì viene caricato senza nomi di sottocartella, quindi `"agents": "./custom/review/security.md"` viene caricato come `my-plugin:security`

77 88

78Claude Code carica un agent del plugin anche quando il suo frontmatter non ha `name` o non viene analizzato:89Claude Code carica un agent del plugin anche quando il suo frontmatter non ha `name` o non viene analizzato:

79 90

476 487

477Il file `.claude-plugin/plugin.json` definisce i metadati e la configurazione del plugin.488Il file `.claude-plugin/plugin.json` definisce i metadati e la configurazione del plugin.

478 489

479Il manifest è facoltativo. Se omesso, Claude Code scopre automaticamente i componenti nelle [posizioni predefinite](#file-locations-reference) e deriva il nome del plugin dal nome della directory. Utilizzare un manifest quando è necessario fornire metadati o percorsi di componenti personalizzati.490Il manifest è facoltativo. Se omesso, Claude Code scopre automaticamente i componenti nelle [posizioni predefinite](#file-locations-reference) e deriva il nome del plugin dal nome della directory. Utilizza un manifest quando hai bisogno di fornire metadati o percorsi di componenti personalizzati.

480 491

481<h3 id="complete-schema">492<h3 id="complete-schema">

482 Schema completo493 Schema completo

521 Campi obbligatori532 Campi obbligatori

522</h3>533</h3>

523 534

524Se si include un manifest, `name` è l'unico campo obbligatorio.535Se includi un manifest, `name` è l'unico campo obbligatorio.

525 536

527| :----- | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |538| :----- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

528| `name` | string | Identificatore univoco in kebab-case, senza spazi, caratteri di controllo o caratteri di formattazione bidirezionali. Quando una [voce del marketplace](/docs/it/plugin-marketplaces#plugin-entries) elenca il plugin con un nome diverso, il nome della voce del marketplace è quello utilizzato da `enabledPlugins` e `/plugin` | `"deployment-tools"` |539| `name` | string | Identificatore univoco in kebab-case, senza spazi, caratteri di controllo o caratteri di formattazione bidirezionali. Quando una [voce del marketplace](/docs/it/plugin-marketplaces#plugin-entries) elenca il plugin con un nome diverso, il nome della voce del marketplace è quello che `enabledPlugins` e `/plugin` utilizzano | `"deployment-tools"` |

529 540

530Questo nome viene utilizzato per lo spazio dei nomi dei componenti. Ad esempio, nell'interfaccia utente, l'agente `agent-creator` per il plugin con nome `plugin-dev` apparirà come `plugin-dev:agent-creator`.541Questo nome viene utilizzato per lo spazio dei nomi dei componenti. Ad esempio, nell'interfaccia utente, l'agente `agent-creator` per il plugin con nome `plugin-dev` apparirà come `plugin-dev:agent-creator`.

531 542

533 Campi non riconosciuti544 Campi non riconosciuti

534</h3>545</h3>

535 546

536Claude Code ignora i campi di primo livello che non riconosce. È possibile mantenere i metadati da un altro ecosistema in `plugin.json` e il plugin si carica comunque. Questo rende pratico mantenere un unico manifest che funziona sia come manifest di VS Code o Cursor, come `package.json` npm, o come manifest di bundle MCPB/DXT.547Claude Code ignora i campi di primo livello che non riconosce. Puoi mantenere i metadati da un altro ecosistema in `plugin.json` e il plugin si carica comunque. Questo rende pratico mantenere un manifest che funge anche da manifest di estensione VS Code o Cursor, da `package.json` npm, o da manifest bundle MCPB/DXT.

537 548

538`claude plugin validate` segnala i campi non riconosciuti come avvisi, non come errori. Se un campo è uno o due caratteri diverso da uno riconosciuto, l'avviso suggerisce il nome probabilmente inteso. Un plugin con solo avvisi di campi non riconosciuti passa comunque la convalida e si carica al runtime.549`claude plugin validate` segnala i campi non riconosciuti come avvisi, non come errori. Se un campo è uno o due caratteri diverso da uno riconosciuto, l'avviso suggerisce il nome probabilmente inteso. Un plugin con solo avvisi di campi non riconosciuti passa comunque la convalida e si carica al runtime.

539 550

542* **La maggior parte dei campi**: il plugin non si carica. Ad esempio, un valore `keywords` che è una stringa invece di un array è un errore di caricamento, e `claude plugin validate` lo segnala come tale.553* **La maggior parte dei campi**: il plugin non si carica. Ad esempio, un valore `keywords` che è una stringa invece di un array è un errore di caricamento, e `claude plugin validate` lo segnala come tale.

543* **`experimental` e `metadata`**: Claude Code ignora un valore non-oggetto, e `claude plugin validate` segnala un avviso.554* **`experimental` e `metadata`**: Claude Code ignora un valore non-oggetto, e `claude plugin validate` segnala un avviso.

544 555

545Passare `--strict` per trattare gli avvisi come errori. Utilizzarlo in CI per rilevare un nome di campo scritto male o un campo rimasto da un manifest di un altro strumento prima della pubblicazione, anche se il plugin si caricherà al runtime.556Passa `--strict` per trattare gli avvisi come errori. Usalo in CI per rilevare un nome di campo scritto male o un campo rimasto da un manifest di un altro strumento prima della pubblicazione, anche se il plugin si caricherà al runtime.

546 557

547```bash theme={null}558```bash theme={null}

548claude plugin validate ./my-plugin --strict559claude plugin validate ./my-plugin --strict

553</h3>564</h3>

554 565

556| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------- |567| :--------------- | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

557| `$schema` | string | URL dello schema JSON per l'autocompletamento e la convalida dell'editor. Claude Code ignora questo campo al momento del caricamento. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |568| `$schema` | string | URL dello schema JSON per l'autocompletamento e la convalida dell'editor. Claude Code ignora questo campo al momento del caricamento. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

558| `displayName` | string | Nome leggibile mostrato nel selettore `/plugin` e in altre superfici dell'interfaccia utente. Per un plugin installato dal marketplace, un `displayName` sulla [voce del marketplace](/docs/it/plugin-marketplaces#optional-plugin-fields) ha la precedenza su questo valore. Quando nessun nome di visualizzazione è impostato in nessuno dei due posti, gli utenti vedono `name`. A differenza di `name`, può contenere spazi e qualsiasi maiuscola/minuscola. Non utilizzato per lo spazio dei nomi o la ricerca. | `"Deployment Tools"` |569| `displayName` | string | Nome leggibile mostrato nel selettore `/plugin` e in altre superfici dell'interfaccia utente. Per un plugin installato dal marketplace, un `displayName` sulla [voce del marketplace](/docs/it/plugin-marketplaces#optional-plugin-fields) ha la precedenza su questo valore. Quando nessun nome visualizzato è impostato in nessuno dei due posti, gli utenti vedono `name`. A differenza di `name`, può contenere spazi e qualsiasi maiuscola/minuscola. Non utilizzato per lo spazio dei nomi o la ricerca. | `"Deployment Tools"` |

559| `version` | string | Facoltativo. Versione semantica. L'impostazione di questa opzione fissa il plugin a quella stringa di versione, quindi gli utenti ricevono aggiornamenti solo quando la si incrementa, ad eccezione di una [`command` source](/docs/it/plugin-marketplaces#command-sources) o un plugin [caricato in place](#plugin-caching-and-file-resolution); vedere [Gestione delle versioni](#version-management). Se impostato anche nella voce del marketplace, `plugin.json` vince. Se omesso, la versione proviene dalla prossima fonte in [Gestione delle versioni](#version-management). | `"2.1.0"` |570| `version` | string | Facoltativo. Versione semantica. L'impostazione di questa opzione fissa il plugin a quella stringa di versione, quindi gli utenti ricevono aggiornamenti solo quando la aumenti, tranne per una [`command` source](/docs/it/plugin-marketplaces#command-sources) o un plugin [caricato in place](#plugin-caching-and-file-resolution); vedi [Gestione delle versioni](#version-management). Se impostato anche nella voce del marketplace, `plugin.json` vince. Se omesso, la versione proviene dalla prossima fonte in [Gestione delle versioni](#version-management). | `"2.1.0"` |

561| `author` | object | Informazioni sull'autore | `{"name": "Dev Team", "email": "dev@company.com"}` |572| `author` | object | Informazioni sull'autore | `{"name": "Dev Team", "email": "dev@company.com"}` |

566| `metadata` | object | Oggetto in formato libero per i propri dati, come campi di diritto o catalogo. Claude Code non lo legge, quindi i valori non influiscono mai sul comportamento del plugin. Claude Code ignora un valore non-oggetto, e `claude plugin validate` lo segnala come avviso. Prima della v2.1.222, Claude Code trattava la chiave come un [campo non riconosciuto](#unrecognized-fields). | `{"catalogId": "cat-123"}` |577| `metadata` | object | Oggetto in forma libera per i tuoi dati, come campi di diritto o catalogo. Claude Code non lo legge, quindi i valori non influenzano mai il comportamento del plugin. Claude Code ignora un valore non-oggetto, e `claude plugin validate` lo segnala come avviso. Prima della v2.1.222, Claude Code trattava la chiave come un [campo non riconosciuto](#unrecognized-fields). | `{"catalogId": "cat-123"}` |

568 579

569<h3 id="default-enablement">580<h3 id="default-enablement">

570 Abilitazione predefinita581 Abilitazione predefinita

571</h3>582</h3>

572 583

573Impostare `defaultEnabled: false` in `plugin.json` per distribuire un plugin che si installa disabilitato. L'utente lo attiva con `claude plugin enable <plugin>` o l'interfaccia `/plugin`. Utilizzare questa opzione per i plugin che aggiungono costi o ambito a cui un utente dovrebbe acconsentire esplicitamente, come uno che si connette a un servizio esterno.584Imposta `defaultEnabled: false` in `plugin.json` per distribuire un plugin che si installa disabilitato. L'utente lo attiva con `claude plugin enable <plugin>` o l'interfaccia `/plugin`. Usalo per i plugin che aggiungono costi o ambito a cui un utente dovrebbe acconsentire, come uno che si connette a un servizio esterno.

574 585

575`defaultEnabled` è il fallback quando nient'altro ha deciso lo stato del plugin. L'impostazione dell'utente e un requisito di dipendenza hanno la precedenza su di esso:586`defaultEnabled` è il fallback quando nient'altro ha deciso lo stato del plugin. L'impostazione dell'utente e un requisito di dipendenza hanno la precedenza su di esso:

576 587

577* **L'impostazione dell'utente**: una voce per il plugin in `enabledPlugins` in qualsiasi ambito di impostazioni. Una volta scritta, persiste tra gli aggiornamenti e le reinstallazioni del plugin, quindi modificare `defaultEnabled` in una versione successiva non capovolge un utente esistente.588* **L'impostazione dell'utente**: una voce per il plugin in `enabledPlugins` a qualsiasi ambito di impostazioni. Una volta scritta, persiste negli aggiornamenti e reinstallazioni del plugin, quindi modificare `defaultEnabled` in una versione successiva non capovolge un utente esistente.

578* **Un requisito di dipendenza**: quando un plugin è richiesto da un altro che è attivo, Claude Code scrive `true` per esso al momento dell'installazione o dell'abilitazione. Questo gli dà un'impostazione esplicita, quindi il suo valore predefinito non si applica più. Vedere [Abilitare o disabilitare un plugin con dipendenze](/docs/it/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies).589* **Un requisito di dipendenza**: quando un plugin è richiesto da un altro che è attivo, Claude Code scrive `true` per esso al momento dell'installazione o dell'abilitazione. Questo gli dà un'impostazione esplicita, quindi il suo default non si applica più. Vedi [Abilitare o disabilitare un plugin con dipendenze](/docs/it/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies).

579 590

580Lo stesso campo può apparire nella voce del marketplace di un plugin, dove ha la precedenza sul valore in `plugin.json`. Vedere [Campi plugin facoltativi](/docs/it/plugin-marketplaces#optional-plugin-fields).591Lo stesso campo può apparire nella voce del marketplace di un plugin, dove ha la precedenza sul valore in `plugin.json`. Vedi [Campi plugin facoltativi](/docs/it/plugin-marketplaces#optional-plugin-fields).

581 592

582<h3 id="component-path-fields">593<h3 id="component-path-fields">

583 Campi del percorso del componente594 Campi del percorso del componente

584</h3>595</h3>

585 596

587| :---------------------- | :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |598| :---------------------- | :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

588| `skills` | string\|array | Directory di skill personalizzate contenenti `<name>/SKILL.md`. Si aggiunge alla scansione predefinita `skills/`. Vedere [Regole di comportamento del percorso](#path-behavior-rules) per l'eccezione della radice del marketplace | `"./custom/skills/"` |599| `skills` | string\|array | Directory di skill personalizzate contenenti `<name>/SKILL.md`. Si aggiunge alla scansione predefinita `skills/`. Vedi [Regole del comportamento del percorso](#path-behavior-rules) per l'eccezione della radice del marketplace | `"./custom/skills/"` |

598| `experimental.evals` | string\|array | Directory sotto la radice del plugin che contiene i [casi di eval](/docs/it/plugin-evals#use-a-different-eval-directory) del plugin, quando non è la directory predefinita `evals/`. `claude plugin eval --eval-dir` la sostituisce | `"quality/evals"` |609| `experimental.evals` | string\|array | Directory sotto la radice del plugin che contiene i [casi eval](/docs/it/plugin-evals#use-a-different-eval-directory) del plugin, quando non è il valore predefinito `evals/`. `claude plugin eval --eval-dir` lo sostituisce | `"quality/evals"` |

601| `dependencies` | array | Altri plugin richiesti da questo plugin, facoltativamente con vincoli di versione semver. Vedere [Vincolare le versioni delle dipendenze del plugin](/docs/it/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |612| `dependencies` | array | Altri plugin richiesti da questo plugin, facoltativamente con vincoli di versione semver. Vedi [Vincolare le versioni di dipendenza del plugin](/docs/it/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |

602 613

603<h3 id="experimental-components">614<h3 id="experimental-components">

604 Componenti sperimentali615 Componenti sperimentali

605</h3>616</h3>

606 617

607I componenti sotto la chiave `experimental`, `themes` e `monitors`, hanno uno schema di manifest che potrebbe cambiare tra le versioni mentre si stabilizzano. Dove li si dichiara è una migrazione separata: il livello superiore funziona ancora, `claude plugin validate` avverte, e una versione futura richiederà `experimental.*`.618I componenti sotto la chiave `experimental`, `themes` e `monitors`, hanno uno schema di manifest che potrebbe cambiare tra le versioni mentre si stabilizzano. Dove li dichiari è una migrazione separata: il livello superiore funziona ancora, `claude plugin validate` avverte, e una versione futura richiederà `experimental.*`.

608 619

609<h3 id="user-configuration">620<h3 id="user-configuration">

610 Configurazione utente621 Configurazione utente

611</h3>622</h3>

612 623

613Il campo `userConfig` dichiara i valori per i quali Claude Code richiede all'utente quando il plugin è abilitato. Utilizzare questa opzione invece di richiedere agli utenti di modificare manualmente `settings.json`.624Il campo `userConfig` dichiara valori per i quali Claude Code richiede all'utente quando il plugin è abilitato. Usalo invece di richiedere agli utenti di modificare manualmente `settings.json`.

614 625

615```json theme={null}626```json theme={null}

616{627{

633Le chiavi devono essere identificatori validi. Ogni opzione supporta questi campi:644Le chiavi devono essere identificatori validi. Ogni opzione supporta questi campi:

634 645

636| :------------ | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |647| :------------ | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

637| `type` | Sì | Uno di `string`, `number`, `boolean`, `directory`, o `file` |648| `type` | Sì | Uno di `string`, `number`, `boolean`, `directory`, o `file` |

638| `title` | Sì | Etichetta mostrata nella finestra di dialogo di configurazione |649| `title` | Sì | Etichetta mostrata nella finestra di dialogo di configurazione |

639| `description` | Sì | Testo di aiuto mostrato sotto il campo |650| `description` | Sì | Testo di aiuto mostrato sotto il campo |

640| `sensitive` | No | Se `true`, maschera l'input e memorizza il valore nell'archiviazione sicura invece di `settings.json` |651| `sensitive` | No | Se `true`, maschera l'input e memorizza il valore nell'archiviazione sicura invece di `settings.json` |

641| `required` | No | Se `true`, la convalida fallisce quando il campo è vuoto |652| `required` | No | Se `true`, la convalida fallisce quando il campo è vuoto |

642| `default` | No | Valore utilizzato quando l'utente non fornisce nulla |653| `default` | No | Valore utilizzato quando l'utente non fornisce nulla |

643| `options` | No | Per il tipo `string`, i valori che il campo accetta, mostrati in `/config` come un selettore su di essi. Richiede Claude Code v2.1.271 o successivo |654| `options` | No | Per il tipo `string`, i valori che il campo accetta, mostrati in `/config` come un selettore su di essi. Vedi [Limitare un campo a opzioni fisse](#limit-a-field-to-fixed-options). Richiede Claude Code v2.1.271 o successivo |

644| `multiple` | No | Per il tipo `string`, consenti un array di stringhe |655| `multiple` | No | Per il tipo `string`, consenti un array di stringhe |

645| `min` / `max` | No | Limiti per il tipo `number` |656| `min` / `max` | No | Limiti per il tipo `number` |

646 657

647Ad eccezione dei campi `sensitive` e degli elenchi `multiple`, ogni campo di ogni plugin abilitato appare anche come una riga nel pannello `/config`. Le righe richiedono Claude Code v2.1.269 o successivo.658Tranne i campi `sensitive` e gli elenchi `multiple`, ogni campo di ogni plugin abilitato appare anche come una riga nel pannello `/config`. Le righe richiedono Claude Code v2.1.269 o successivo.

648 659

649Ogni valore è disponibile per la sostituzione come `${user_config.KEY}` nelle configurazioni del server MCP e LSP e nei comandi hook. I valori non sensibili possono anche essere sostituiti nel contenuto di skill e agenti. Tutti i valori vengono esportati ai processi hook come variabili di ambiente `CLAUDE_PLUGIN_OPTION_<KEY>`, dove `<KEY>` è la chiave dell'opzione in maiuscolo.660Ogni valore è disponibile per la sostituzione come `${user_config.KEY}` nelle configurazioni del server MCP e LSP e nei comandi hook. I valori non sensibili possono anche essere sostituiti nel contenuto di skill e agente. Tutti i valori vengono esportati ai processi hook come variabili di ambiente `CLAUDE_PLUGIN_OPTION_<KEY>`, dove `<KEY>` è la chiave dell'opzione in maiuscolo.

650 661

651I campi che vengono eseguiti in una shell rifiutano `${user_config.*}`: sostituire un valore configurato in un comando shell consentirebbe alla shell di eseguire qualsiasi cosa contenga quel valore, quindi il componente fallisce con un [errore](/docs/it/errors#plugin-command-references-user-config) invece. Ogni campo rifiutato ha un modo alternativo per passare il valore:662I campi che vengono eseguiti in una shell rifiutano `${user_config.*}`: sostituire un valore configurato in un comando shell consentirebbe alla shell di eseguire qualsiasi cosa contenga quel valore, quindi il componente fallisce con un [errore](/docs/it/errors#plugin-command-references-user-config) invece. Ogni campo rifiutato ha un modo alternativo per passare il valore:

652 663

653| Campo rifiutato | Come passare il valore |664| Campo rifiutato | Come passare il valore |

654| :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ |665| :--------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |

655| Comandi hook in forma shell | Utilizzare [forma exec](/docs/it/hooks#exec-form-and-shell-form) con `args`, o leggere `CLAUDE_PLUGIN_OPTION_<KEY>` dall'ambiente del hook |666| Comandi hook in forma shell | Usa [forma exec](/docs/it/hooks#exec-form-and-shell-form) con `args`, o leggi `CLAUDE_PLUGIN_OPTION_<KEY>` dall'ambiente del hook |

656| Comandi [Monitor](#monitors) | Leggere il valore da un file di configurazione nello script |667| Comandi [Monitor](#monitors) | Leggi il valore da un file di configurazione nello script |

657| MCP [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication) | Leggere il valore da un file di configurazione nello script |668| MCP [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication) | Leggi il valore da un file di configurazione nello script |

658 669

659Prima della v2.1.207, questi campi sostituivano i valori `${user_config.KEY}`; aggiornare i plugin che si basavano su questo.670Prima della v2.1.207, questi campi sostituivano i valori `${user_config.KEY}`; aggiorna i plugin che si basavano su questo.

660 671

661I valori non sensibili vengono memorizzati sotto la chiave [`pluginConfigs`](/docs/it/settings-reference#pluginconfigs) nel file `settings.json` dell'utente come `pluginConfigs[<plugin-id>].options`.672I valori non sensibili vengono memorizzati sotto la chiave [`pluginConfigs`](/docs/it/settings-reference#pluginconfigs) nel tuo `settings.json` utente come `pluginConfigs[<plugin-id>].options`.

662 673

663Su macOS, Claude Code memorizza i valori sensibili nel Portachiavi di macOS, ricadendo su `~/.claude/.credentials.json` quando il Portachiavi rifiuta la scrittura. Su piattaforme senza un portachiavi supportato, li memorizza in `~/.claude/.credentials.json`. L'archiviazione del Portachiavi è condivisa con i token OAuth e ha un limite totale approssimativo di 2 KB, quindi mantenere i valori sensibili piccoli.674Su macOS, Claude Code memorizza i valori sensibili nel Portachiavi macOS, ricadendo su `~/.claude/.credentials.json` quando il Portachiavi rifiuta la scrittura. Su piattaforme senza un portachiavi supportato, li memorizza in `~/.claude/.credentials.json`. L'archiviazione del Portachiavi è condivisa con i token OAuth e ha un limite totale approssimativo di 2 KB, quindi mantieni i valori sensibili piccoli.

664 675

665Claude Code legge tutti i valori `pluginConfigs` da solo tre fonti di impostazioni:676Claude Code legge tutti i valori `pluginConfigs` da solo tre fonti di impostazioni:

666 677

667* **Impostazioni utente**: `~/.claude/settings.json`, il file in cui la richiesta al momento dell'abilitazione scrive678* **Impostazioni utente**: `~/.claude/settings.json`, il file che il prompt al momento dell'abilitazione scrive

668* **`--settings`**: il flag CLI o le impostazioni inline SDK679* **`--settings`**: il flag CLI o le impostazioni inline SDK

669* **Impostazioni gestite**: [politica controllata dall'organizzazione](/docs/it/permissions#managed-settings)680* **Impostazioni gestite**: [politica controllata dall'organizzazione](/docs/it/permissions#managed-settings)

670 681

671Quando più di una fonte imposta la stessa chiave, le impostazioni gestite hanno la precedenza, quindi `--settings`, quindi le impostazioni utente. L'unica fonte che è possibile rimuovere da questo elenco è le impostazioni utente: passare [`--setting-sources`](/docs/it/cli-reference#cli-flags) senza `user` e Claude Code le salta. Le impostazioni gestite e `--settings` rimangono qualsiasi cosa si passi. L'opzione [`settingSources`](/docs/it/agent-sdk/claude-code-features#what-settingsources-does-not-control) dell'SDK imposta lo stesso elenco.682Quando più di una fonte imposta la stessa chiave, le impostazioni gestite hanno la precedenza, quindi `--settings`, quindi le impostazioni utente. L'unica fonte che puoi rimuovere da questo elenco è le impostazioni utente: passa [`--setting-sources`](/docs/it/cli-reference#cli-flags) senza `user` e Claude Code le salta. Le impostazioni gestite e `--settings` rimangono qualsiasi cosa tu passi. L'opzione [`settingSources`](/docs/it/agent-sdk/claude-code-features#what-settingsources-does-not-control) dell'SDK imposta lo stesso elenco.

683

684Le voci nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto vengono ignorate. Entrambi i file vivono nell'area di lavoro, quindi un repository clonato potrebbe fornire valori lì, e quei valori fluirebbero nei comandi hook del plugin, nelle configurazioni del server MCP, nei comandi LSP e nei comandi monitor. Prima della v2.1.207, queste voci venivano lette. La restrizione è specifica per `pluginConfigs`: [`enabledPlugins`](/docs/it/settings-reference#enabledplugins) onora ancora le impostazioni del progetto e locali.

685

686<h4 id="limit-a-field-to-fixed-options">

687 Limitare un campo a opzioni fisse

688</h4>

689

690Imposta `options` su un campo `userConfig` per fare in modo che gli utenti scelgano il suo valore da un elenco fisso.

691

692Per limitare un campo `tone` a tre opzioni, elencale in `options` e imposta `default` su una di esse:

693

694```json theme={null}

695{

696 "userConfig": {

697 "tone": {

698 "type": "string",

699 "title": "Tone",

700 "description": "Voice for generated replies",

701 "options": ["neutral", "warm", "formal"],

702 "default": "neutral"

703 }

704 }

705}

706```

707

708Se dichiari `options` su qualsiasi campo, gli utenti su versioni di Claude Code precedenti alla v2.1.271 non possono caricare il plugin.

709

710Quando imposti `options` su un campo, segui queste regole:

711

712* Imposta `type` su `string`

713* Non impostare `multiple` o `sensitive` su `true`

714* Imposta `default` su una delle opzioni

715* Se lasci `default` non impostato, imposta `required` su `true`

716* Elenca almeno un'opzione, ognuna da 1 a 64 caratteri

717* Non iniziare o terminare un'opzione con uno spazio

718* Non usare caratteri di controllo, caratteri invisibili, caratteri che cambiano la direzione del testo, o spazi diversi da uno spazio regolare in un'opzione

719* Non elencare la stessa opzione due volte, nemmeno in una diversa maiuscola/minuscola

672 720

673Le voci nel file `.claude/settings.json` o `.claude/settings.local.json` di un progetto vengono ignorate. Entrambi i file si trovano nell'area di lavoro, quindi un repository clonato potrebbe fornire valori lì, e quei valori fluirebbero nei comandi hook del plugin, nelle configurazioni del server MCP, nei comandi LSP e nei comandi monitor. Prima della v2.1.207, queste voci venivano lette. La restrizione è specifica per `pluginConfigs`: [`enabledPlugins`](/docs/it/settings-reference#enabledplugins) onora ancora le impostazioni del progetto e locali.721Se infrangi una di queste regole, il plugin non si carica. Esegui `claude plugin validate` per vedere quale campo infrange quale regola.

674 722

675<h3 id="channels">723<h3 id="channels">

676 Canali724 Canali

701}749}

702```750```

703 751

704Il campo `server` è obbligatorio e deve corrispondere a una chiave in `mcpServers` del plugin. L'opzionale `userConfig` per canale utilizza lo stesso schema del campo di primo livello, consentendo al plugin di richiedere token bot o ID proprietario quando il plugin è abilitato.752Il campo `server` è obbligatorio e deve corrispondere a una chiave in `mcpServers` del plugin. Il `userConfig` facoltativo per canale utilizza lo stesso schema del campo di primo livello, consentendo al plugin di richiedere token bot o ID proprietario quando il plugin è abilitato.

705 753

706<h3 id="path-behavior-rules">754<h3 id="path-behavior-rules">

707 Regole di comportamento del percorso755 Regole del comportamento del percorso

708</h3>756</h3>

709 757

710Se un percorso personalizzato sostituisce o estende la directory predefinita del plugin dipende dal campo:758Se un percorso personalizzato sostituisce o estende la directory predefinita del plugin dipende dal campo:

711 759

712* **Sostituisce il valore predefinito**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Ad esempio, quando il manifest specifica `commands`, la directory predefinita `commands/` non viene scansionata. Per mantenere il valore predefinito e aggiungerne altri, elencarli esplicitamente: `"commands": ["./commands/", "./extras/"]`760* **Sostituisce il valore predefinito**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Ad esempio, quando il manifest specifica `commands`, la directory predefinita `commands/` non viene scansionata. Per mantenere il valore predefinito e aggiungerne altri, elencalo esplicitamente: `"commands": ["./commands/", "./extras/"]`

713* **Si aggiunge al valore predefinito**: `skills`. La directory predefinita `skills/` viene sempre scansionata, e le directory elencate in `skills` vengono caricate insieme ad essa. Eccezione: per una [voce del marketplace la cui `source` si risolve nella radice del marketplace](/docs/it/plugin-marketplaces#advanced-plugin-entries), dichiarare sottodirectory specifiche sostituisce la scansione predefinita `skills/`761* **Si aggiunge al valore predefinito**: `skills`. La directory predefinita `skills/` viene sempre scansionata, e le directory elencate in `skills` vengono caricate insieme ad essa. Eccezione: per una [voce del marketplace la cui `source` si risolve nella radice del marketplace](/docs/it/plugin-marketplaces#advanced-plugin-entries), dichiarare sottodirectory specifiche sostituisce la scansione predefinita `skills/`

714* **Regole di merge proprie**: [hooks](#hooks), [server MCP](#mcp-servers), e [server LSP](#lsp-servers). Vedere ogni sezione per come più fonti si combinano762* **Regole di merge proprie**: [hooks](#hooks), [server MCP](#mcp-servers), e [server LSP](#lsp-servers). Vedi ogni sezione per come più fonti si combinano

715 763

716Quando un plugin ha sia una cartella predefinita che la chiave manifest corrispondente, Claude Code avverte sulla cartella ignorata in `claude plugin list` e nella vista dei dettagli `/plugin`. Il plugin si carica comunque utilizzando i percorsi del manifest. Claude Code non avverte quando la chiave manifest punta nella cartella predefinita, ad esempio `"commands": ["./commands/deploy.md"]`, perché quel percorso nomina la cartella esplicitamente.764Quando un plugin ha sia una cartella predefinita che la chiave manifest corrispondente, Claude Code avverte sulla cartella ignorata in `claude plugin list` e nella vista dei dettagli `/plugin`. Il plugin si carica comunque utilizzando i percorsi del manifest. Claude Code non avverte quando la chiave manifest punta nella cartella predefinita, ad esempio `"commands": ["./commands/deploy.md"]`, perché quel percorso nomina la cartella esplicitamente.

717 765

719 767

720* Tutti i percorsi devono essere relativi alla radice del plugin e iniziare con `./`, tranne che il campo `skills` accetta anche `"."`768* Tutti i percorsi devono essere relativi alla radice del plugin e iniziare con `./`, tranne che il campo `skills` accetta anche `"."`

721 * Sia `"."` che `"./"` denotano la radice del plugin stesso769 * Sia `"."` che `"./"` denotano la radice del plugin stesso

722 * Prima della v2.1.221, `"."` falliva la convalida del manifest e il plugin non si caricava, quindi utilizzare `"./"` per supportare versioni precedenti770 * Prima della v2.1.221, `"."` falliva la convalida del manifest e il plugin non si caricava, quindi usa `"./"` per supportare versioni precedenti

723* I componenti da percorsi personalizzati utilizzano le stesse regole di denominazione e spazio dei nomi771* I componenti da percorsi personalizzati utilizzano le stesse regole di denominazione e spazio dei nomi, tranne i file agente. Vedi [Agenti](#agents) per come funzionano i nomi degli agenti

724* Più percorsi possono essere specificati come array772* Più percorsi possono essere specificati come array

725* Un percorso di skill può puntare a una directory che contiene direttamente un `SKILL.md`, ad esempio `"skills": ["."]` per la radice del plugin773* Un percorso di skill può puntare a una directory che contiene direttamente un `SKILL.md`, ad esempio `"skills": ["."]` per la radice del plugin

726 * Claude Code prende il nome di invocazione della skill dal campo frontmatter `name` in `SKILL.md`, quindi il nome rimane stabile indipendentemente da come viene denominata la directory di installazione774 * Claude Code prende il nome di invocazione della skill dal campo frontmatter `name` in `SKILL.md`, quindi il nome rimane stabile qualunque sia il nome della directory di installazione

727 * Se `name` non è impostato nel frontmatter, Claude Code ritorna al nome della directory di base775 * Se `name` non è impostato nel frontmatter, Claude Code ricade sul basename della directory

728 776

729Un plugin che ha un `SKILL.md` alla sua radice, nessuna sottodirectory `skills/`, e nessun campo manifest `skills` viene caricato automaticamente come plugin a skill singola. Non è necessario impostare `"skills": ["./"]` in `plugin.json` per questo layout.777Un plugin che ha un `SKILL.md` alla sua radice, nessuna sottodirectory `skills/`, e nessun campo manifest `skills` viene caricato automaticamente come plugin a skill singola. Non hai bisogno di impostare `"skills": ["./"]` in `plugin.json` per questo layout.

730 778

731**Esempi di percorso**:779**Esempi di percorso**:

732 780

749 797

750Claude Code fornisce tre variabili per fare riferimento ai percorsi:798Claude Code fornisce tre variabili per fare riferimento ai percorsi:

751 799

753| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------- |801| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------- |

754| `${CLAUDE_PLUGIN_ROOT}` | Percorso assoluto della directory di installazione del plugin | Script, binari e file di configurazione forniti con il plugin |802| `${CLAUDE_PLUGIN_ROOT}` | Percorso assoluto della directory di installazione del plugin | Script, binari e file di configurazione forniti con il plugin |

755| `${CLAUDE_PLUGIN_DATA}` | [Directory persistente](#persistent-data-directory) che sopravvive agli aggiornamenti del plugin, creata al primo riferimento | Dipendenze installate come `node_modules` o ambienti virtuali Python, codice generato e cache |803| `${CLAUDE_PLUGIN_DATA}` | [Directory persistente](#persistent-data-directory) che sopravvive agli aggiornamenti del plugin, creata al primo riferimento | Dipendenze installate come `node_modules` o ambienti virtuali Python, codice generato e cache |

756| `${CLAUDE_PROJECT_DIR}` | La radice del progetto | Script e file di configurazione locali del progetto |804| `${CLAUDE_PROJECT_DIR}` | La radice del progetto | Script e file di configurazione locali del progetto |

757 805

758Tutti e tre vengono esportati come variabili di ambiente ai processi hook e ai sottoprocessi del server MCP e LSP. Non sono presenti nell'ambiente dei comandi che Claude esegue attraverso lo strumento Bash, nella sessione principale o in un subagent. Nel contenuto del plugin, scrivere il placeholder invece, e Claude Code sostituisce il percorso inline quando carica il contenuto. Quali campi sostituiscono inline dipende dal componente del plugin:806Tutti e tre vengono esportati come variabili di ambiente ai processi hook e ai sottoprocessi del server MCP e LSP. Non sono presenti nell'ambiente dei comandi che Claude esegue attraverso lo strumento Bash, nella sessione principale o in un subagente. Nel contenuto del plugin, scrivi il placeholder invece, e Claude Code sostituisce il percorso inline quando carica il contenuto. Quali campi sostituiscono inline dipende dal componente del plugin:

759 807

760| Componente del plugin | Campi dove i placeholder si risolvono |808| Componente del plugin | Campi dove i placeholder si risolvono |

761| :----------------------------- | :------------------------------------------ |809| :----------------------------- | :------------------------------------------ |

762| Contenuto di skill e agenti | Ovunque appaia il placeholder |810| Contenuto di skill e agente | Ovunque appaia il placeholder |

763| Comandi hook e monitor | Ovunque appaia il placeholder |811| Comandi hook e monitor | Ovunque appaia il placeholder |

767 815

768Nei comandi hook, utilizzare [forma exec](/docs/it/hooks#exec-form-and-shell-form) con `args` in modo che ogni percorso venga passato come un argomento senza virgolette. Negli hook in forma shell e nei comandi monitor, racchiudere le variabili tra virgolette doppie, come in `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Questo hook in forma shell esegue uno script fornito con un plugin:816Nei comandi hook, usa [forma exec](/docs/it/hooks#exec-form-and-shell-form) con `args` in modo che ogni percorso venga passato come un argomento senza virgolette. Negli hook in forma shell e nei comandi monitor, avvolgi le variabili tra virgolette doppie, come in `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Questo hook in forma shell esegue uno script fornito con un plugin:

769 817

770```json theme={null}818```json theme={null}

771{819{

784}832}

785```833```

786 834

787Per un plugin copiato, `${CLAUDE_PLUGIN_ROOT}` cambia quando il plugin si aggiorna. La directory della versione precedente rimane su disco per un periodo di grazia dopo un aggiornamento, ma trattarla come effimera e non scrivere stato lì. Per un plugin caricato in place da un marketplace di directory locale, la variabile punta alla directory sorgente stabile. Vedere [plugin caching](#plugin-caching-and-file-resolution) per quali plugin vengono copiati e per la semantica di pulizia.835Per un plugin copiato, `${CLAUDE_PLUGIN_ROOT}` cambia quando il plugin si aggiorna. La directory della versione precedente rimane su disco per un periodo di grazia dopo un aggiornamento, ma trattala come effimera e non scrivere stato lì. Per un plugin caricato in place da un marketplace di directory locale, la variabile punta alla directory sorgente stabile. Vedi [plugin caching](#plugin-caching-and-file-resolution) per quali plugin vengono copiati e per la semantica di pulizia.

788 836

789Quando un plugin copiato si aggiorna a metà sessione, i comandi hook, i monitor, i server MCP e i server LSP continuano a utilizzare il percorso della versione precedente. Eseguire `/reload-plugins` per passare i hook, i server MCP e i server LSP al nuovo percorso; i monitor richiedono un riavvio della sessione. In una sessione senza un terminale interattivo, il ricaricamento lascia i server MCP del plugin sul percorso precedente fino alla sessione successiva.837Quando un plugin copiato si aggiorna a metà sessione, i comandi hook, i monitor, i server MCP e i server LSP continuano a utilizzare il percorso della versione precedente. Esegui `/reload-plugins` per passare hook, server MCP e server LSP al nuovo percorso; i monitor richiedono un riavvio della sessione. In una sessione senza un terminale interattivo, il ricaricamento lascia i server MCP del plugin sul vecchio percorso fino alla sessione successiva.

790 838

791Per un plugin con una `command` source, Claude Code [può ricaricare il plugin stesso](/docs/it/plugin-marketplaces#when-claude-code-re-runs-the-command).839Per un plugin con una `command` source, Claude Code [può ricaricare il plugin stesso](/docs/it/plugin-marketplaces#when-claude-code-re-runs-the-command).

792 840

793I server MCP possono anche chiamare la richiesta `roots/list` per leggere le directory di lavoro della sessione al runtime. Vedere [cosa restituisce `roots/list` e quando Claude Code notifica al server i cambiamenti](/docs/it/mcp#option-3-add-a-local-stdio-server).841I server MCP possono anche chiamare la richiesta `roots/list` per leggere le directory di lavoro della sessione al runtime. Vedi [cosa restituisce `roots/list` e quando Claude Code notifica al server i cambiamenti](/docs/it/mcp#option-3-add-a-local-stdio-server).

794 842

795<h4 id="persistent-data-directory">843<h4 id="persistent-data-directory">

796 Directory di dati persistenti844 Directory di dati persistenti

798 846

799La directory `${CLAUDE_PLUGIN_DATA}` si risolve in `~/.claude/plugins/data/{id}/`, dove `{id}` è l'identificatore del plugin con caratteri al di fuori di `a-z`, `A-Z`, `0-9`, `_`, e `-` sostituiti da `-`. Per un plugin installato come `formatter@my-marketplace`, la directory è `~/.claude/plugins/data/formatter-my-marketplace/`.847La directory `${CLAUDE_PLUGIN_DATA}` si risolve in `~/.claude/plugins/data/{id}/`, dove `{id}` è l'identificatore del plugin con caratteri al di fuori di `a-z`, `A-Z`, `0-9`, `_`, e `-` sostituiti da `-`. Per un plugin installato come `formatter@my-marketplace`, la directory è `~/.claude/plugins/data/formatter-my-marketplace/`.

800 848

801Un uso comune è installare le dipendenze del linguaggio una volta e riutilizzarle tra sessioni e aggiornamenti del plugin. Utilizzarla per le dipendenze Python, le dipendenze bloccate con Yarn o pnpm, e i pacchetti i cui script del ciclo di vita devono essere eseguiti. Per un plugin installato dal marketplace, potrebbe non essere necessario affatto: Claude Code installa automaticamente le [dipendenze del pacchetto Node.js](#node-js-package-dependencies) idonee quando memorizza il plugin nella cache.849Un uso comune è installare dipendenze di linguaggio una volta e riutilizzarle tra sessioni e aggiornamenti di plugin. Usala per dipendenze Python, dipendenze bloccate con Yarn o pnpm, e pacchetti i cui script del ciclo di vita devono essere eseguiti. Per un plugin installato dal marketplace, potresti non averne bisogno affatto: Claude Code installa automaticamente le [dipendenze del pacchetto Node.js](/docs/it/plugin-dependencies#node-js-package-dependencies) idonee quando memorizza il plugin nella cache.

802 850

803Poiché la directory di dati sopravvive a qualsiasi singola versione del plugin, un controllo per l'esistenza della directory da solo non può rilevare quando un aggiornamento cambia il manifest delle dipendenze del plugin. Il modello consigliato confronta il manifest fornito con una copia nella directory di dati e reinstalla quando differiscono.851Poiché la directory di dati sopravvive a qualsiasi singola versione del plugin, un controllo per l'esistenza della directory da solo non può rilevare quando un aggiornamento cambia il manifest di dipendenza del plugin. Il modello consigliato confronta il manifest fornito rispetto a una copia nella directory di dati e reinstalla quando differiscono.

804 852

805Questo hook `SessionStart` installa `node_modules` alla prima esecuzione e di nuovo ogni volta che un aggiornamento del plugin include un `package.json` modificato:853Questo hook `SessionStart` installa `node_modules` alla prima esecuzione e di nuovo ogni volta che un aggiornamento del plugin include un `package.json` modificato:

806 854

823 871

824Il `diff` esce con codice diverso da zero quando la copia memorizzata è mancante o differisce da quella fornita, coprendo sia la prima esecuzione che gli aggiornamenti che cambiano le dipendenze. Se `npm install` fallisce, il trailing `rm` rimuove il manifest copiato in modo che la sessione successiva riprovi.872Il `diff` esce con codice diverso da zero quando la copia memorizzata è mancante o differisce da quella fornita, coprendo sia la prima esecuzione che gli aggiornamenti che cambiano le dipendenze. Se `npm install` fallisce, il trailing `rm` rimuove il manifest copiato in modo che la sessione successiva riprovi.

825 873

826Gli script forniti in `${CLAUDE_PLUGIN_ROOT}` possono quindi essere eseguiti contro il `node_modules` persistente:874Gli script forniti in `${CLAUDE_PLUGIN_ROOT}` possono quindi essere eseguiti rispetto ai `node_modules` persistiti:

827 875

828```json theme={null}876```json theme={null}

829{877{

839}887}

840```888```

841 889

842La directory di dati viene eliminata automaticamente quando si disinstalla il plugin dall'ultimo ambito in cui è installato. L'interfaccia `/plugin` mostra la dimensione della directory e richiede conferma prima di eliminare. La CLI elimina per impostazione predefinita; passare [`--keep-data`](#plugin-uninstall) per preservarla.890La directory di dati viene eliminata automaticamente quando disinstalli il plugin dall'ultimo ambito in cui è installato. L'interfaccia `/plugin` mostra la dimensione della directory e richiede conferma prima di eliminare. La CLI elimina per impostazione predefinita; passa [`--keep-data`](#plugin-uninstall) per preservarla.

843 891

844***892***

845 893

959├── agents/ # Definizioni dei subagent1007├── agents/ # Definizioni dei subagent

960│ ├── security-reviewer.md1008│ ├── security-reviewer.md

961│ ├── performance-tester.md1009│ ├── performance-tester.md

962│ └── compliance-checker.md1010│ ├── compliance-checker.md

1011│ └── review/ # Gli agent qui si caricano come enterprise-plugin:review:<name>

1012│ └── accessibility.md

963├── workflows/ # Script dei workflow1013├── workflows/ # Script dei workflow

964│ └── release-audit.js1014│ └── release-audit.js

965├── output-styles/ # Definizioni dello stile di output1015├── output-styles/ # Definizioni dello stile di output

prompt-caching.md +1 −1

Details

96 96

97L'[impostazione del modello `opusplan`](/docs/it/model-config#opusplan-model-setting) si risolve in Opus durante la modalità piano e Sonnet durante l'esecuzione, quindi ogni attivazione/disattivazione della modalità piano è un cambio di modello e avvia una cache nuova.97L'[impostazione del modello `opusplan`](/docs/it/model-config#opusplan-model-setting) si risolve in Opus durante la modalità piano e Sonnet durante l'esecuzione, quindi ogni attivazione/disattivazione della modalità piano è un cambio di modello e avvia una cache nuova.

98 98

99[Il fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui modelli Fable e Opus 5 è anche un cambio di modello. Quando un classificatore di sicurezza contrassegna una richiesta in una categoria che ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e la sessione continua lì.99[Il fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui modelli Fable, Opus 5.5 e Opus 5 è anche un cambio di modello. Quando un classificatore di sicurezza contrassegna una richiesta in una categoria che ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e la sessione continua lì.

100 100

101Quando il frontmatter di una skill o di un comando nomina un [`model`](/docs/it/skills#frontmatter-reference) diverso dal modello corrente della sessione, quel turno è anche un cambio di modello: la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Il modello della sessione riprende al tuo prossimo prompt. Una skill `context: fork` imposta il [modello del subagent con fork](/docs/it/skills#run-skills-in-a-subagent) invece.101Quando il frontmatter di una skill o di un comando nomina un [`model`](/docs/it/skills#frontmatter-reference) diverso dal modello corrente della sessione, quel turno è anche un cambio di modello: la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Il modello della sessione riprende al tuo prossimo prompt. Una skill `context: fork` imposta il [modello del subagent con fork](/docs/it/skills#run-skills-in-a-subagent) invece.

102 102

prompt-library.md +1 −1

Details

1384* [Come i team di Anthropic utilizzano Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code): flussi di lavoro reali da team di ingegneria, prodotto, design e dati, con approfondimenti su [legal](https://claude.com/blog/how-anthropic-uses-claude-legal), [marketing](https://claude.com/blog/how-anthropic-uses-claude-marketing) e [cybersecurity](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)1384* [Come i team di Anthropic utilizzano Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code): flussi di lavoro reali da team di ingegneria, prodotto, design e dati, con approfondimenti su [legal](https://claude.com/blog/how-anthropic-uses-claude-legal), [marketing](https://claude.com/blog/how-anthropic-uses-claude-marketing) e [cybersecurity](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)

1385* [Guida al scaling del coding agentico](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): la guida all'adozione aziendale1385* [Guida al scaling del coding agentico](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): la guida all'adozione aziendale

1386 1386

1387Per video tutorial di questi modelli, vedete il corso gratuito [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action) su Anthropic Academy.1387Per video tutorial di questi modelli, vedete il corso gratuito [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action) su [Claude Academy](https://academy.claude.com/).

1388 1388

1389<h2 id="related-resources">1389<h2 id="related-resources">

1390 Risorse correlate1390 Risorse correlate

quickstart.md +1 −0

Details

379 379

380* **In Claude Code**: Digita `/help` o chiedi "come faccio a..."380* **In Claude Code**: Digita `/help` o chiedi "come faccio a..."

381* **Documentazione**: Sei qui! Sfoglia altre guide381* **Documentazione**: Sei qui! Sfoglia altre guide

382* **Corsi**: Segui [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e altri corsi gratuiti a tuo ritmo su [Claude Academy](https://academy.claude.com/)

382* **Community**: Unisciti al nostro [Discord](https://www.anthropic.com/discord) per suggerimenti e supporto383* **Community**: Unisciti al nostro [Discord](https://www.anthropic.com/discord) per suggerimenti e supporto

remote-control.md +1 −1

Details

187* **Estrazione di una sessione con `/teleport`**: quando estrai una [sessione cloud](/docs/it/claude-code-on-the-web#from-cloud-to-terminal) nel tuo terminale con `/teleport`, il dispositivo connesso non riceve la cronologia precedente della conversazione estratta. I nuovi messaggi in entrambe le direzioni vanno verso e da quella conversazione estratta, che è ora quella aperta nel tuo terminale.187* **Estrazione di una sessione con `/teleport`**: quando estrai una [sessione cloud](/docs/it/claude-code-on-the-web#from-cloud-to-terminal) nel tuo terminale con `/teleport`, il dispositivo connesso non riceve la cronologia precedente della conversazione estratta. I nuovi messaggi in entrambe le direzioni vanno verso e da quella conversazione estratta, che è ora quella aperta nel tuo terminale.

188* **Messaggi dalle tue altre sessioni**: con [messaggistica tra sessioni](/docs/it/cross-session-messaging), la stessa connessione trasporta messaggi tra le tue stesse sessioni su macchine diverse e dalle tue [sessioni cloud](/docs/it/claude-code-on-the-web), attraverso i server Anthropic come il resto del traffico Remote Control. [Messaggi alle sessioni su altre macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines) copre le regole di consegna e [Controlla i messaggi in entrata](/docs/it/cross-session-messaging#control-inbound-messages) copre i controlli in entrata. Richiede Claude Code v2.1.224 o successivo.188* **Messaggi dalle tue altre sessioni**: con [messaggistica tra sessioni](/docs/it/cross-session-messaging), la stessa connessione trasporta messaggi tra le tue stesse sessioni su macchine diverse e dalle tue [sessioni cloud](/docs/it/claude-code-on-the-web), attraverso i server Anthropic come il resto del traffico Remote Control. [Messaggi alle sessioni su altre macchine](/docs/it/cross-session-messaging#message-sessions-on-other-machines) copre le regole di consegna e [Controlla i messaggi in entrata](/docs/it/cross-session-messaging#control-inbound-messages) copre i controlli in entrata. Richiede Claude Code v2.1.224 o successivo.

189* **Prompt che invii a metà turno**: quando invii un prompt da un dispositivo connesso prima che il turno corrente termini, Claude Code lo mette in coda e lo mantiene nella trascrizione del dispositivo dopo che quel turno finisce.189* **Prompt che invii a metà turno**: quando invii un prompt da un dispositivo connesso prima che il turno corrente termini, Claude Code lo mette in coda e lo mantiene nella trascrizione del dispositivo dopo che quel turno finisce.

190* **Diff dei tuoi cambiamenti**: quando la directory della sessione è in un repository git, il pannello diff di un dispositivo connesso mostra il diff dei tuoi cambiamenti non committati. Il dispositivo richiede il diff sulla connessione, e Claude Code lo calcola sulla tua macchina. Quando il tuo working tree è pulito, Claude Code serve invece i cambiamenti del tuo ramo da quando ha divergito dal ramo predefinito. Prima della v2.1.247, Claude Code segnalava il diff ai dispositivi connessi solo nelle sessioni servite da `claude remote-control`.190* **Diff dei tuoi cambiamenti**: quando la directory della sessione è in un repository git, il pannello diff di un dispositivo connesso mostra il diff dei tuoi cambiamenti. Il dispositivo richiede il diff sulla connessione, e Claude Code lo calcola sulla tua macchina. Su un ramo che ha commit davanti al ramo predefinito del repository, il pannello mostra i cambiamenti da quando il ramo si è separato da esso, inclusi i tuoi edit non committati. Sul ramo predefinito stesso, o su un ramo che non è davanti a esso, il pannello mostra solo i tuoi cambiamenti non committati. Prima della v2.1.247, Claude Code segnalava il diff ai dispositivi connessi solo nelle sessioni servite da `claude remote-control`.

191* **Modello**: quando scegli un [modello](/docs/it/model-config) da un dispositivo connesso, Claude Code esegue la sessione su quel modello. Il picker `/model` del terminale, `/status`, e `/config` mostrano quel modello. Richiede Claude Code v2.1.238 o successivo.191* **Modello**: quando scegli un [modello](/docs/it/model-config) da un dispositivo connesso, Claude Code esegue la sessione su quel modello. Il picker `/model` del terminale, `/status`, e `/config` mostrano quel modello. Richiede Claude Code v2.1.238 o successivo.

192 * Un modello che scegli dal controllo del modello del dispositivo si applica solo alla sessione corrente. Quando invii `/model <name>` dal dispositivo a una sessione interattiva, Claude Code imposta anche il tuo predefinito per le nuove sessioni.192 * Un modello che scegli dal controllo del modello del dispositivo si applica solo alla sessione corrente. Quando invii `/model <name>` dal dispositivo a una sessione interattiva, Claude Code imposta anche il tuo predefinito per le nuove sessioni.

193 * Se invii un nome che Claude Code non riconosce, come un nome visualizzato dove è previsto un ID modello, Claude Code [rifiuta la scelta](/docs/it/errors#model-is-not-a-recognized-model-id) e la sessione mantiene il suo modello corrente. Prima della v2.1.260, Claude Code salvava una scelta non riconosciuta dal controllo del modello del dispositivo, e il tuo prossimo messaggio falliva.193 * Se invii un nome che Claude Code non riconosce, come un nome visualizzato dove è previsto un ID modello, Claude Code [rifiuta la scelta](/docs/it/errors#model-is-not-a-recognized-model-id) e la sessione mantiene il suo modello corrente. Prima della v2.1.260, Claude Code salvava una scelta non riconosciuta dal controllo del modello del dispositivo, e il tuo prossimo messaggio falliva.

sandboxing.md +12 −6

Details

179 Temporary directories179 Temporary directories

180</h4>180</h4>

181 181

182La directory temporanea della sessione è scrivibile all'interno della sandbox per impostazione predefinita, insieme alla directory di lavoro. A meno che tu non [disabiliti l'isolamento del filesystem](#disable-filesystem-isolation), Claude Code imposta `$TMPDIR` su questa directory per i comandi sandboxati, così gli strumenti che scrivono file temporanei funzionano senza configurazione aggiuntiva. I comandi non sandboxati ereditano il tuo `$TMPDIR` della shell invariato, quindi mentre l'isolamento del filesystem è attivo, i comandi sandboxati e non sandboxati risolvono `$TMPDIR` in directory diverse. Per passare file temporanei tra i due, scrivili nella directory di lavoro invece.182La directory temporanea della sessione è scrivibile all'interno della sandbox per impostazione predefinita, insieme alla directory di lavoro. A meno che tu non [disabiliti l'isolamento del filesystem](#disable-filesystem-isolation), Claude Code imposta `$TMPDIR` su questa directory per i comandi sandboxati, così gli strumenti che scrivono file temporanei funzionano senza configurazione aggiuntiva.

183

184I comandi non sandboxati ereditano il tuo `$TMPDIR` della shell quando è impostato, quindi mentre l'isolamento del filesystem è attivo, i comandi sandboxati e non sandboxati risolvono `$TMPDIR` in directory diverse. Se la tua shell lascia `$TMPDIR` non impostato o vuoto, un comando non sandboxato che fa riferimento a `$TMPDIR` riceve il tuo override [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars), o la directory temporanea del sistema operativo quando non ne hai impostato uno o l'override è un percorso lungo, così la variabile non si espande a una stringa vuota. Per passare file temporanei tra i due, scrivili nella directory di lavoro invece.

183 185

184<h2 id="configure-sandboxing">186<h2 id="configure-sandboxing">

185 Configura il sandboxing187 Configura il sandboxing

309 311

310* I comandi in sandbox ereditano il `$TMPDIR` della tua shell invece della directory temporanea della sessione, perché ogni directory temporanea è scrivibile e Claude Code non reindirizza più i comandi a quella della sessione.312* I comandi in sandbox ereditano il `$TMPDIR` della tua shell invece della directory temporanea della sessione, perché ogni directory temporanea è scrivibile e Claude Code non reindirizza più i comandi a quella della sessione.

311 313

312 Su Linux la variabile è spesso non impostata nella shell padre, quindi può espandersi vuota all'interno dei comandi in sandbox; Claude Code dice a Claude attraverso la sua guida dello strumento Bash di creare directory di lavoro con `mktemp -d` invece di fare affidamento su `$TMPDIR`.314 Su Linux la variabile è spesso non impostata nella shell padre. La guida dello strumento Bash dice a Claude di creare directory di lavoro con `mktemp -d` invece di fare affidamento su `$TMPDIR`.

313* [`autoAllowBashIfSandboxed`](/docs/it/settings-reference#sandbox-autoallowbashifsandboxed) continua a impostare il valore predefinito su `true`, quindi i comandi in sandbox continuano a essere eseguiti senza prompt. Impostalo su `false` per richiedere prompt per i comandi in sandbox.315* [`autoAllowBashIfSandboxed`](/docs/it/settings-reference#sandbox-autoallowbashifsandboxed) continua a impostare il valore predefinito su `true`, quindi i comandi in sandbox continuano a essere eseguiti senza prompt. Impostalo su `false` per richiedere prompt per i comandi in sandbox.

314 316

315<h3 id="protect-credentials">317<h3 id="protect-credentials">

743 745

744* **I comandi falliscono con un errore host-not-allowed**: molti strumenti CLI devono raggiungere host specifici. Concedere l'autorizzazione quando richiesto aggiunge l'host al vostro elenco consentito in modo che lo strumento venga eseguito all'interno della sandbox in futuro.746* **I comandi falliscono con un errore host-not-allowed**: molti strumenti CLI devono raggiungere host specifici. Concedere l'autorizzazione quando richiesto aggiunge l'host al vostro elenco consentito in modo che lo strumento venga eseguito all'interno della sandbox in futuro.

745* **`jest` si blocca o fallisce**: `watchman` è incompatibile con la sandbox. Eseguite `jest --no-watchman` invece.747* **`jest` si blocca o fallisce**: `watchman` è incompatibile con la sandbox. Eseguite `jest --no-watchman` invece.

746* **I CLI basati su Go falliscono la verifica TLS su macOS**: strumenti come `gh`, `gcloud` e `terraform` potrebbero fallire la verifica TLS sotto Seatbelt. Elencate questi strumenti in `excludedCommands` per eseguirli al di fuori della sandbox. Se state utilizzando `httpProxyPort` con un proxy MITM e CA personalizzato, impostate [`enableWeakerNetworkIsolation`](/docs/it/settings-reference#sandbox-enableweakernetworkisolation) su `true` invece.748* **I CLI basati su Go falliscono la verifica TLS su macOS**: strumenti come `gh`, `gcloud` e `terraform` potrebbero fallire la verifica TLS sotto Seatbelt. Elencate questi strumenti in [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands). Se state utilizzando `httpProxyPort` con un proxy MITM e CA personalizzato, impostate [`enableWeakerNetworkIsolation`](/docs/it/settings-reference#sandbox-enableweakernetworkisolation) su `true` invece.

747* **`open`, `osascript`, o i flussi di autenticazione basati su browser falliscono con errore `-600` su macOS**: la sandbox blocca gli Apple Events per impostazione predefinita. Impostate [`allowAppleEvents`](/docs/it/settings-reference#sandbox-allowappleevents) su `true` nelle impostazioni utente, gestite o CLI per consentirli. Le impostazioni del progetto vengono ignorate per questa chiave. L'abilitazione rimuove l'isolamento dell'esecuzione del codice, poiché i comandi sandboxati possono quindi avviare altre applicazioni non sandboxate senza prompt dell'utente e inviare comandi AppleScript alle applicazioni in esecuzione, soggetti al prompt di consenso dell'automazione macOS (TCC). In alternativa, aggiungete il comando a `excludedCommands` per eseguirlo al di fuori della sandbox.749* **`open`, `osascript`, o i flussi di autenticazione basati su browser falliscono con errore `-600` su macOS**: la sandbox blocca gli Apple Events per impostazione predefinita. Impostate [`allowAppleEvents`](/docs/it/settings-reference#sandbox-allowappleevents) su `true` nelle impostazioni utente, gestite o CLI per consentirli. Le impostazioni del progetto vengono ignorate per questa chiave. L'abilitazione rimuove l'isolamento dell'esecuzione del codice, poiché i comandi sandboxati possono quindi avviare altre applicazioni non sandboxate senza prompt dell'utente e inviare comandi AppleScript alle applicazioni in esecuzione, soggetti al prompt di consenso dell'automazione macOS (TCC). In alternativa, aggiungete il comando a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands).

748* **I comandi `docker` falliscono**: `docker` è incompatibile con la sandbox. Aggiungete `docker *` a `excludedCommands` per eseguirlo al di fuori della sandbox.750* **I comandi `docker` falliscono**: `docker` è incompatibile con la sandbox. Aggiungete `docker *` a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands).

749* **`pbcopy`, `xclip`, o `wl-copy` non aggiorna gli appunti**: queste utilità degli appunti possono non riuscire a raggiungere gli appunti di sistema dall'interno della sandbox, nel qual caso il testo inviato tramite pipe a loro non arriva. Per mettere l'output di Claude negli appunti, chiedete a Claude di stamparlo nella sua risposta, quindi eseguite [`/copy`](/docs/it/commands), che scrive negli appunti dal processo Claude Code piuttosto che da un comando sandboxato. In alternativa, aggiungete `pbcopy *`, `wl-copy *`, o `xclip *` a `excludedCommands` per eseguire il comando al di fuori della sandbox.751* **`pbcopy`, `xclip`, o `wl-copy` non aggiorna gli appunti**: queste utilità degli appunti possono non riuscire a raggiungere gli appunti di sistema dall'interno della sandbox, nel qual caso il testo inviato tramite pipe a loro non arriva.

752

753 Per mettere l'output di Claude negli appunti, chiedete a Claude di stamparlo nella sua risposta, quindi eseguite [`/copy`](/docs/it/commands). `/copy` scrive negli appunti dal processo Claude Code piuttosto che da un comando sandboxato.

754

755 Quando Claude invia testo tramite pipe a uno di questi strumenti, aggiungere lo strumento a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) non toglie quella chiamata dalla sandbox di per sé.

750* **Un comando git fallisce con `unable to unlink old`**: `git merge`, `git checkout` e comandi simili falliscono in questo modo quando devono sostituire un file a cui la sandbox nega le scritture, sia che il file sia sotto un [percorso protetto](#protected-paths) come `.claude/skills`, sotto una delle vostre voci `denyWrite`, o al di fuori delle directory in cui la sandbox consente ai comandi di scrivere. Su Linux e WSL2 l'errore termina con `Read-only file system`.756* **Un comando git fallisce con `unable to unlink old`**: `git merge`, `git checkout` e comandi simili falliscono in questo modo quando devono sostituire un file a cui la sandbox nega le scritture, sia che il file sia sotto un [percorso protetto](#protected-paths) come `.claude/skills`, sotto una delle vostre voci `denyWrite`, o al di fuori delle directory in cui la sandbox consente ai comandi di scrivere. Su Linux e WSL2 l'errore termina con `Read-only file system`.

751 757

752 Dopo il fallimento, Claude potrebbe [offrire di rieseguire il comando al di fuori della sandbox](#the-unsandboxed-retry-escape-hatch); approvate quel nuovo tentativo, o eseguite il comando git voi stessi in un altro terminale. Se avete impostato `allowUnsandboxedCommands` su `false`, Claude non può offrire il nuovo tentativo, quindi eseguite il comando voi stessi. Se lo stesso comando git fallisce spesso, aggiungetelo a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands).758 Dopo il fallimento, Claude potrebbe [offrire di rieseguire il comando al di fuori della sandbox](#the-unsandboxed-retry-escape-hatch); approvate quel nuovo tentativo, o eseguite il comando git voi stessi in un altro terminale. Se avete impostato `allowUnsandboxedCommands` su `false`, Claude non può offrire il nuovo tentativo, quindi eseguite il comando voi stessi. Se lo stesso comando git fallisce spesso, aggiungetelo a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands).

security-guidance.md +6 −5

Details

31/plugin install security-guidance@claude-plugins-official31/plugin install security-guidance@claude-plugins-official

32```32```

33 33

~~34`/plugin` apre un pannello interattivo ed è disponibile solo nel CLI del terminale. Se Claude risponde che `/plugin` non è disponibile in questo ambiente, installa in un altro modo:~~34`/plugin` apre un pannello interattivo nel CLI del terminale. Se Claude risponde che `/plugin` non è disponibile in questo ambiente, installa in un altro modo:

35 35

36* **App desktop Claude, sessione locale o SSH**: apri il [browser dei plugin](/docs/it/desktop#install-plugins) facendo clic sul pulsante **+** accanto al prompt, quindi **Plugins**, quindi **Add plugin**36* **App desktop Claude, sessione locale o SSH**: apri il [browser dei plugin](/docs/it/desktop#install-plugins) facendo clic sul pulsante **+** accanto al prompt, quindi **Plugins**, quindi **Add plugin**

~~37* **Sessioni cloud**: dichiara il plugin in `.claude/settings.json` come mostrato in [Enable in cloud sessions](#enable-in-cloud-sessions-and-shared-repositories)~~37* **Estensione VS Code**: installa dalla [finestra di dialogo **Manage plugins**](/docs/it/vs-code#manage-plugins)

38* **Sessioni cloud**: abilita il plugin per il tuo account claude.ai in modo che Claude Code lo carichi come [plugin sincronizzato](/docs/it/plugins-reference#synced-plugins). Una sessione cloud non carica i plugin dalle tue impostazioni utente o dal file `.claude/settings.json` del repository, come spiega [What carries over from your setup](/docs/it/cloud-environments#what-carries-over-from-your-setup)

38 39

39L'installazione del terminale richiede un ambito. Scegli l'ambito utente per scrivere il plugin nelle tue impostazioni utente, in modo che si carichi in ogni nuova sessione locale che avvii su questa macchina.40L'installazione del terminale richiede un ambito. Scegli l'ambito utente per scrivere il plugin nelle tue impostazioni utente, in modo che si carichi in ogni nuova sessione locale che avvii su questa macchina.

40 41

45 46

46Controlla il riepilogo dell'installazione. Se segnala `Run /reload-plugins to activate.`, consulta [Applica le modifiche ai plugin senza riavviare](/docs/it/discover-plugins#apply-plugin-changes-without-restarting) per attivare il plugin nella tua sessione corrente.47Controlla il riepilogo dell'installazione. Se segnala `Run /reload-plugins to activate.`, consulta [Applica le modifiche ai plugin senza riavviare](/docs/it/discover-plugins#apply-plugin-changes-without-restarting) per attivare il plugin nella tua sessione corrente.

47 48

~~48<h3 id="enable-in-cloud-sessions-and-shared-repositories">~~49<h3 id="enable-for-your-team-in-local-sessions">

~~49 Abilita nelle sessioni cloud e nei repository condivisi~~50 Abilita per il tuo team nelle sessioni locali

50</h3>51</h3>

51 52

52I plugin con ambito utente non vengono trasferiti a [sessioni cloud](/docs/it/claude-code-on-the-web), perché quelle sessioni non vengono eseguite sulla tua macchina. Per abilitare il plugin lì, o per attivarlo per tutti coloro che clonano un repository, dichiaralo nelle impostazioni del progetto archiviate:53Per attivare il plugin nelle sessioni locali che i tuoi colleghi avviano nel repository, dichiaralo nelle impostazioni del progetto archiviate:

53 54

54```json .claude/settings.json theme={null}55```json .claude/settings.json theme={null}

55{56{

self-hosted-environments-deploy.md +2 −2

Details

184 184

185Il proxy richiede `--capacity 1` perché l'URL del proxy è per sessione, e git 2.32 o più recente perché git più vecchio ignora il meccanismo di configurazione che il proxy usa per isolare le sessioni l'una dall'altra. Il runner rifiuta di avviarsi se uno dei due requisiti non è soddisfatto. Poiché il proxy recupera dal lato di Anthropic, il tuo host git deve essere raggiungibile dall'infrastruttura di Anthropic, lo stesso requisito che hanno le sessioni ospitate da Anthropic; per un host git che è solo instradabile all'interno della tua rete, usa un [`checkout` lifecycle hook](/docs/it/self-hosted-environments-configuration#checkout) invece. Ogni processo runner gestisce una sessione alla volta, quindi esegui più repliche per il parallelismo. Quando il proxy è abilitato, `--git-host-rewrite` e `--git-ssh-rewrite` non hanno effetto: l'URL del proxy punta a `api.anthropic.com`, non al tuo host git.185Il proxy richiede `--capacity 1` perché l'URL del proxy è per sessione, e git 2.32 o più recente perché git più vecchio ignora il meccanismo di configurazione che il proxy usa per isolare le sessioni l'una dall'altra. Il runner rifiuta di avviarsi se uno dei due requisiti non è soddisfatto. Poiché il proxy recupera dal lato di Anthropic, il tuo host git deve essere raggiungibile dall'infrastruttura di Anthropic, lo stesso requisito che hanno le sessioni ospitate da Anthropic; per un host git che è solo instradabile all'interno della tua rete, usa un [`checkout` lifecycle hook](/docs/it/self-hosted-environments-configuration#checkout) invece. Ogni processo runner gestisce una sessione alla volta, quindi esegui più repliche per il parallelismo. Quando il proxy è abilitato, `--git-host-rewrite` e `--git-ssh-rewrite` non hanno effetto: l'URL del proxy punta a `api.anthropic.com`, non al tuo host git.

186 186

187Il 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. 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ì.187Il 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ì.

188 188

189<h3 id="rewrite-git-urls-for-private-networks">189<h3 id="rewrite-git-urls-for-private-networks">

190 Riscrivi gli URL git per le reti private190 Riscrivi gli URL git per le reti private

223Scambia `linux-x64` con `linux-arm64` se i tuoi nodi sono ARM, o con `linux-x64-musl` o `linux-arm64-musl` su un'immagine basata su musl come Alpine; vedi [Configurazione Alpine Linux](/docs/it/setup#alpine-linux-and-musl-based-distributions) per i pacchetti extra di cui le immagini musl hanno bisogno. L'URL è la posizione di rilascio standard di Claude Code, quindi puoi verificare il binario scaricato rispetto al manifesto firmato del rilascio come descritto in [Integrità binaria e firma del codice](/docs/it/setup#binary-integrity-and-code-signing). Costruisci l'immagine con Claude Code versione 2.1.224 o successiva, quindi spingila al tuo registro e fai riferimento ad essa nelle ricette di seguito:223Scambia `linux-x64` con `linux-arm64` se i tuoi nodi sono ARM, o con `linux-x64-musl` o `linux-arm64-musl` su un'immagine basata su musl come Alpine; vedi [Configurazione Alpine Linux](/docs/it/setup#alpine-linux-and-musl-based-distributions) per i pacchetti extra di cui le immagini musl hanno bisogno. L'URL è la posizione di rilascio standard di Claude Code, quindi puoi verificare il binario scaricato rispetto al manifesto firmato del rilascio come descritto in [Integrità binaria e firma del codice](/docs/it/setup#binary-integrity-and-code-signing). Costruisci l'immagine con Claude Code versione 2.1.224 o successiva, quindi spingila al tuo registro e fai riferimento ad essa nelle ricette di seguito:

224 224

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.224 -t <your-registry>/claude-runner:latest .226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .

227```227```

228 228

229<h2 id="size-cpu-and-memory-for-sessions">229<h2 id="size-cpu-and-memory-for-sessions">

sessions.md +7 −1

Details

147Le sessioni che non nomini ricevono comunque due etichette che Claude Code assegna. Solo il titolo generato funziona come handle di ripresa:147Le sessioni che non nomini ricevono comunque due etichette che Claude Code assegna. Solo il titolo generato funziona come handle di ripresa:

148 148

149* Nome di visualizzazione predefinito: le sessioni interattive che non nomini mai ricevono comunque un nome di visualizzazione predefinito quando si avviano. Richiede Claude Code v2.1.196 o versione successiva. Il valore predefinito combina il nome della directory di lavoro con un suffisso di due caratteri, ad esempio `my-app-3f`, e identifica la sessione negli elenchi delle sessioni in esecuzione, come la [agent view](/docs/it/agent-view) e l'output di `claude agents --json`. Il valore predefinito non è un handle di ripresa. Se lo passi a `claude --resume` o `/resume`, Claude Code non trova la sessione. Denominare la sessione sostituisce il valore predefinito in quegli elenchi, così come accettare un piano.149* Nome di visualizzazione predefinito: le sessioni interattive che non nomini mai ricevono comunque un nome di visualizzazione predefinito quando si avviano. Richiede Claude Code v2.1.196 o versione successiva. Il valore predefinito combina il nome della directory di lavoro con un suffisso di due caratteri, ad esempio `my-app-3f`, e identifica la sessione negli elenchi delle sessioni in esecuzione, come la [agent view](/docs/it/agent-view) e l'output di `claude agents --json`. Il valore predefinito non è un handle di ripresa. Se lo passi a `claude --resume` o `/resume`, Claude Code non trova la sessione. Denominare la sessione sostituisce il valore predefinito in quegli elenchi, così come accettare un piano.

150* Titolo generato: se non nomini una sessione, Claude Code genera un titolo di sessione per essa. Il titolo è un breve riassunto del tuo primo prompt, scritto da una richiesta in background al modello piccolo/veloce, normalmente un modello della classe Haiku. Accettare un piano lo sostituisce con un titolo basato sul piano. Denominare la sessione sostituisce il titolo generato. Vedi il titolo del primo prompt nel [selezionatore di sessioni](#use-the-session-picker) e nel campo [`session_name`](/docs/it/statusline) della statusline quando nessun nome è impostato. Il titolo del piano appare negli stessi due posti e anche negli elenchi delle sessioni in esecuzione, dove prende il posto del nome di visualizzazione predefinito. Puoi passare uno dei due titoli a `claude --resume` o `/resume`, e Claude Code lo risolve nello stesso modo di un nome che hai impostato.150* Titolo generato: se non nomini una sessione, Claude Code genera un titolo di sessione per essa. Il titolo è un breve riassunto del tuo primo prompt, scritto da una richiesta in background al modello piccolo/veloce, normalmente un modello della classe Haiku. Un'esecuzione `claude -p` che avvii direttamente da una shell o script non ne riceve uno.

151

152 Accettare un piano sostituisce il titolo del primo prompt con un titolo basato sul piano. Denominare la sessione lo sostituisce anche.

153

154 Vedi il titolo del primo prompt nel [selezionatore di sessioni](#use-the-session-picker) e nel campo [`session_name`](/docs/it/statusline) della statusline quando nessun nome è impostato. Il titolo del piano appare negli stessi due posti e anche negli elenchi delle sessioni in esecuzione, dove prende il posto del nome di visualizzazione predefinito.

155

156 Puoi passare uno dei due titoli a `claude --resume` o `/resume`, e Claude Code lo risolve nello stesso modo di un nome che hai impostato.

151 157

152<h2 id="use-the-session-picker">158<h2 id="use-the-session-picker">

153 Usare il selezionatore di sessioni159 Usare il selezionatore di sessioni

settings.md +3 −3

Details

468 Mantenere le impostazioni personali fuori da un repository468 Mantenere le impostazioni personali fuori da un repository

469</h3>469</h3>

470 470

471Per cambiare un'impostazione per voi stessi in un progetto senza cambiarla per i vostri colleghi, salvatela in `.claude/settings.local.json` all'interno del progetto. Claude Code applica quel file sopra il `.claude/settings.json` sottoposto a commit, quindi se il file del vostro team imposta `"model": "claude-sonnet-5"` e volete Opus, mettete `"model": "claude-opus-4-8"` nel vostro file locale e solo le vostre sessioni cambiano.471Per cambiare un'impostazione per voi stessi in un progetto senza cambiarla per i vostri colleghi, salvatela in `.claude/settings.local.json` all'interno del progetto. Claude Code applica quel file sopra il `.claude/settings.json` sottoposto a commit, quindi se il file del vostro team imposta `"model": "claude-sonnet-5"` e volete Opus, mettete `"model": "claude-opus-5-5"` nel vostro file locale e solo le vostre sessioni cambiano.

472 472

473Claude Code scrive anche in questo file, lo mantiene fuori dai vostri commit, e applica le sue regole di autorizzazione senza il passaggio di fiducia:473Claude Code scrive anche in questo file, lo mantiene fuori dai vostri commit, e applica le sue regole di autorizzazione senza il passaggio di fiducia:

474 474

598Ad esempio, per avviare una sessione su Opus senza modificare il vostro predefinito:598Ad esempio, per avviare una sessione su Opus senza modificare il vostro predefinito:

599 599

600```bash theme={null}600```bash theme={null}

601claude --settings '{"model": "claude-opus-4-8"}'601claude --settings '{"model": "claude-opus-5-5"}'

602```602```

603 603

604<h3 id="when-edits-take-effect">604<h3 id="when-edits-take-effect">

803 803

804Una [sessione cloud](/docs/it/claude-code-on-the-web) viene eseguita in un [ambiente cloud](/docs/it/cloud-environments) su un clone fresco del vostro repository, non sulla vostra macchina. Questo cambia quali impostazioni la raggiungono:804Una [sessione cloud](/docs/it/claude-code-on-the-web) viene eseguita in un [ambiente cloud](/docs/it/cloud-environments) su un clone fresco del vostro repository, non sulla vostra macchina. Questo cambia quali impostazioni la raggiungono:

805 805

806* **Impostazioni di progetto condivise** (`.claude/settings.json`): lette in una sessione con un repository, perché il file fa parte del clone e la sessione inizia al suo interno. Committate un'impostazione lì per applicarla in quelle sessioni. Una sessione con più repository inizia sopra i clone, quindi da ogni `.claude/settings.json` del repository carica solo i plugin e i marketplace che il file dichiara, non le regole di permesso, gli hook, `env` o altre chiavi; vedere [Cosa si trasporta dalla vostra configurazione](/docs/it/cloud-environments#what-carries-over-from-your-setup).806* **Impostazioni di progetto condivise** (`.claude/settings.json`): lette in una sessione con un repository, perché il file fa parte del clone e la sessione inizia al suo interno. Committate un'impostazione lì per applicarla in quelle sessioni. Una sessione con più repository inizia sopra i clone e legge solo i tasti `enabledPlugins` e `extraKnownMarketplaces` da ogni `.claude/settings.json` del repository, non le regole di permesso, gli hook, `env` o altre chiavi. I marketplace e i plugin che questi due tasti dichiarano ancora [non si caricano in una sessione cloud](/docs/it/cloud-environments#what-carries-over-from-your-setup).

807* **Impostazioni utente e di progetto locale** (`~/.claude/settings.json` e `.claude/settings.local.json`): non lette. Entrambe rimangono sulla vostra macchina, e il file locale non è nel clone.807* **Impostazioni utente e di progetto locale** (`~/.claude/settings.json` e `.claude/settings.local.json`): non lette. Entrambe rimangono sulla vostra macchina, e il file locale non è nel clone.

808* **Impostazioni gestite**: solo le [impostazioni gestite dal server](/docs/it/server-managed-settings) raggiungono una sessione cloud; un file `managed-settings.json` o un profilo MDM sul vostro dispositivo no. Un [ambiente auto-ospitato](/docs/it/self-hosted-environments) legge anche il file di impostazioni gestite nella sua immagine di runner. [Come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quando quel file si applica.808* **Impostazioni gestite**: solo le [impostazioni gestite dal server](/docs/it/server-managed-settings) raggiungono una sessione cloud; un file `managed-settings.json` o un profilo MDM sul vostro dispositivo no. Un [ambiente auto-ospitato](/docs/it/self-hosted-environments) legge anche il file di impostazioni gestite nella sua immagine di runner. [Come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quando quel file si applica.

809* **`/config`**: nel vostro browser su claude.ai/code, apre la sezione Claude Code delle vostre impostazioni claude.ai invece di modificare un valore. Per modificare un'impostazione per una sessione cloud, impostate una [variabile di ambiente](/docs/it/cloud-environments#set-environment-variables) sull'ambiente, o in una sessione con un repository, committate la chiave al `.claude/settings.json` di quel repository.809* **`/config`**: nel vostro browser su claude.ai/code, apre la sezione Claude Code delle vostre impostazioni claude.ai invece di modificare un valore. Per modificare un'impostazione per una sessione cloud, impostate una [variabile di ambiente](/docs/it/cloud-environments#set-environment-variables) sull'ambiente, o in una sessione con un repository, committate la chiave al `.claude/settings.json` di quel repository.

settings-example.md +7 −3

Details

29 ```json ~/.claude/settings.json theme={null}29 ```json ~/.claude/settings.json theme={null}

30 {30 {

31 "model": "claude-sonnet-5",31 "model": "claude-sonnet-5",

~~32 "effortLevel": "xhigh",~~32 "modelSettings": {

33 "claude-sonnet-5": { "effortLevel": "xhigh" }

34 },

33 "editorMode": "vim",35 "editorMode": "vim",

34 "theme": "light-daltonized",36 "theme": "light-daltonized",

35 "statusLine": {37 "statusLine": {

58 {60 {

59 // Inizia ogni sessione su Sonnet 561 // Inizia ogni sessione su Sonnet 5

60 "model": "claude-sonnet-5",62 "model": "claude-sonnet-5",

~~61 // Ragiona più profondamente del livello alto predefinito su modelli senza un livello salvato; /effort salva un livello per modello, e --effort ne imposta uno per una singola sessione~~63 // Esegui Sonnet 5 al di sopra del suo livello alto predefinito; /effort salva un livello per modello, e --effort ne imposta uno per una singola sessione

~~62 "effortLevel": "xhigh",~~64 "modelSettings": {

65 "claude-sonnet-5": { "effortLevel": "xhigh" }

66 },

63 // Scorciatoie da tastiera Vim nel prompt67 // Scorciatoie da tastiera Vim nel prompt

64 "editorMode": "vim",68 "editorMode": "vim",

65 // Il tema chiaro adatto ai daltonici69 // Il tema chiaro adatto ai daltonici

settings-reference.md +43 −32

Details

689| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Ricevete una [notifica push](/docs/it/remote-control#mobile-push-notifications) quando Claude vi sta aspettando | Remote, desktop, and notifications | Any file |689| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Ricevete una [notifica push](/docs/it/remote-control#mobile-push-notifications) quando Claude vi sta aspettando | Remote, desktop, and notifications | Any file |

690| [`isolatePeerMachines`](#isolatepeermachines) | Chiedete prima che Claude [messaggi una delle vostre sessioni su un'altra macchina](/docs/it/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |690| [`isolatePeerMachines`](#isolatepeermachines) | Chiedete prima che Claude [messaggi una delle vostre sessioni su un'altra macchina](/docs/it/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |

691| [`keybindingFlavor`](#keybindingflavor) | Deprecato e non ha effetto; le scorciatoie di modifica delle parole seguono sempre le [convenzioni readline](/docs/it/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |691| [`keybindingFlavor`](#keybindingflavor) | Deprecato e non ha effetto; le scorciatoie di modifica delle parole seguono sempre le [convenzioni readline](/docs/it/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |

797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Smettete di caricare i [plugin abilitati sul vostro account claude.ai](/docs/it/plugins-reference#synced-plugins) e smettete di scaricare quelli nuovi | Plugins and skills | User, local, or managed |797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Smettete di caricare i [plugin abilitati sul vostro account claude.ai](/docs/it/plugins-reference#synced-plugins) e smettete di scaricare quelli nuovi | Plugins and skills | User, local, or managed |

798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Smettete di scaricare le [skill abilitate sul vostro account claude.ai](/docs/it/skills#how-synced-skills-behave) e nascondetequelle già sincronizzate | Plugins and skills | User, local, or managed |798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Smettete di scaricare le [skill abilitate sul vostro account claude.ai](/docs/it/skills#how-synced-skills-behave) e nascondetequelle già sincronizzate | Plugins and skills | User, local, or managed |

801| [`teammateDefaultModel`](#teammatedefaultmodel) | Rimosso nella v2.1.234; vedere [Specificare i compagni di squadra e i modelli](/docs/it/agent-teams#specify-teammates-and-models) per come Claude Code sceglie il modello di un compagno di squadra | Global config settings | Global config |801| [`teammateDefaultModel`](#teammatedefaultmodel) | Rimosso nella v2.1.234; vedere [Specificare i compagni di squadra e i modelli](/docs/it/agent-teams#specify-teammates-and-models) per come Claude Code sceglie il modello di un compagno di squadra | Global config settings | Global config |

840Se l'account richiede il [consenso usage-credits](/docs/it/advisor#fable-advisor-and-usage-credits), accettarlo prima eseguendo `/model fable`. Fino a quando non lo si fa, scegliere Fable in `/advisor` non salva nulla e Claude Code comunica di eseguire prima `/model fable`.840Se l'account richiede il [consenso usage-credits](/docs/it/advisor#fable-advisor-and-usage-credits), accettarlo prima eseguendo `/model fable`. Fino a quando non lo si fa, scegliere Fable in `/advisor` non salva nulla e Claude Code comunica di eseguire prima `/model fable`.

841 841

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

843* **Type**: string, uno degli alias `"fable"`, `"opus"` o `"sonnet"`, che si risolvono nella versione predefinita corrente di Claude Code di quella famiglia di modelli, oppure un ID modello completo come `"claude-opus-5"`843* **Type**: string, uno degli alias `"fable"`, `"opus"` o `"sonnet"`, che si risolvono nella versione predefinita corrente di Claude Code di quella famiglia di modelli, oppure un ID modello completo come `"claude-opus-5-5"`

844* **Default**: non impostato, quindi l'advisor è disattivato844* **Default**: non impostato, quindi l'advisor è disattivato

845* **Per-session overrides**: `--advisor` ha la precedenza su questa chiave per una sessione. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/it/env-vars) disattiva l'advisor e questa chiave non può riattivarlo845* **Per-session overrides**: `--advisor` ha la precedenza su questa chiave per una sessione. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/it/env-vars) disattiva l'advisor e questa chiave non può riattivarlo

846 846

858 858

859Disattivare il [pensiero esteso](/docs/it/model-config#extended-thinking) per ogni sessione impostando questo su `false`. Il pensiero è attivato per impostazione predefinita, quindi `true` non cambia nulla. La maggior parte delle persone imposta questo tramite `/config` piuttosto che modificando il file.859Disattivare il [pensiero esteso](/docs/it/model-config#extended-thinking) per ogni sessione impostando questo su `false`. Il pensiero è attivato per impostazione predefinita, quindi `true` non cambia nulla. La maggior parte delle persone imposta questo tramite `/config` piuttosto che modificando il file.

860 860

861Su modelli che pensano sempre, come i modelli Fable, `false` non ha effetto. Su [provider di terze parti](/docs/it/third-party-integrations) Claude Code omette il parametro `thinking` invece di disattivare il pensiero, quindi i modelli di ragionamento adattivo potrebbero comunque pensare. Con il pensiero disattivato sull'API Anthropic, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.861Su modelli che pensano sempre, come Opus 5.5 e i modelli Fable, `false` non ha effetto. Su [provider di terze parti](/docs/it/third-party-integrations) Claude Code omette il parametro `thinking` invece di disattivare il pensiero, quindi i modelli di ragionamento adattivo potrebbero comunque pensare. Con il pensiero disattivato sull'API Anthropic, Claude Code invia effort `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

862 862

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

864* **Type**: Boolean864* **Type**: Boolean

903 903

904All'interno dello stesso file di impostazioni, Claude Code utilizza il livello salvato di un modello piuttosto che questa chiave. [`modelSettings`](#modelsettings) indica la precedenza tra file.904All'interno dello stesso file di impostazioni, Claude Code utilizza il livello salvato di un modello piuttosto che questa chiave. [`modelSettings`](#modelsettings) indica la precedenza tra file.

905 905

906In una sessione collegata a un worker remoto, `/effort` si applica solo a quella sessione. In un'esecuzione `-p` o nell'Agent SDK si applica anche solo a quella sessione, [a meno che non sia in vigore un blocco sul livello di effort predefinito del modello](/docs/it/model-config#non-interactive-effort). [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) elenca le scelte interattive che si applicano anche solo a quella sessione. Il messaggio che `/effort` stampa dice quale è accaduto.906In una sessione collegata a un worker remoto, in un'esecuzione `-p` e nell'Agent SDK, `/effort` si applica solo a quella sessione. [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) elenca le scelte interattive che si applicano anche solo a quella sessione. Il messaggio che `/effort` stampa dice quale è accaduto.

907 907

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

909* **Type**: string, uno di:909* **Type**: string, uno di:

920}920}

921```921```

922 922

923Su Opus 4.7, Opus 4.8 e Fable 5, Claude Code mantiene il livello di effort predefinito di quel modello, impostato dall'organizzazione o integrato; [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) indica quali modi di impostare un livello terminano il blocco e quali lo mantengono in vigore. Una volta che il blocco termina, Claude Code risolve l'effort secondo la precedenza indicata in [`modelSettings`](#modelsettings).923Nel file di impostazioni utente, `~/.claude/settings.json`, questa chiave è la forma più vecchia che `/effort` scriveva prima di salvare i livelli per modello, e continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti. Opus 5.5 e i modelli rilasciati dopo di esso la ignorano e iniziano al loro predefinito fino a quando non si salva un livello per essi, che `/effort` scrive sotto [`modelSettings`](#modelsettings). Nelle impostazioni progetto, locali e gestite, e con `--settings`, questa chiave si applica a ogni modello.

924 924

925<h3 id="enforceavailablemodels">925<h3 id="enforceavailablemodels">

926 `enforceAvailableModels`926 `enforceAvailableModels`

974 `fastMode`974 `fastMode`

975</h3>975</h3>

976 976

977Attivare la [modalità veloce](/docs/it/fast-mode) per sessioni dove è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo dove si desidera velocità a un costo più elevato per token. Di solito non si modifica questa chiave manualmente: eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, e eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave. La modalità veloce funziona solo su Opus 5 e Opus 4.8: attivarla da un altro modello passa a Opus, e passare a un modello non supportato la disattiva. Vedere [Cambiare modelli mentre la modalità veloce è attiva](/docs/it/fast-mode#switch-models-while-fast-mode-is-on).977Attivare la [modalità veloce](/docs/it/fast-mode) per sessioni dove è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo dove si desidera velocità a un costo più elevato per token. Di solito non si modifica questa chiave manualmente: eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, e eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave. La modalità veloce funziona solo su Opus 5.5, Opus 5 e Opus 4.8: attivarla da un altro modello passa a Opus, e passare a un modello non supportato la disattiva. Vedere [Cambiare modelli mentre la modalità veloce è attiva](/docs/it/fast-mode#switch-models-while-fast-mode-is-on).

978 978

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

980* **Type**: Boolean980* **Type**: Boolean

993 `fastModePerSessionOptIn`993 `fastModePerSessionOptIn`

994</h3>994</h3>

995 995

996Normalmente, eseguire `/fast` salva [`fastMode`](#fastmode) nelle impostazioni utente di una persona, quindi la modalità veloce è attiva all'inizio di ogni sessione successiva. Impostare questa chiave su `true` per fermare questo: un `fastMode: true` salvato non attiva più la modalità veloce all'inizio della sessione, e ogni persona deve eseguire `/fast` in ogni sessione in cui la desidera. Claude Code lascia la chiave `fastMode` nel file, quindi disattivare questa chiave ripristina il comportamento precedente. I proprietari su piani Team o Enterprise possono distribuirlo a livello di organizzazione tramite [impostazioni gestite dal server](/docs/it/server-managed-settings).996Normalmente, eseguire `/fast` salva [`fastMode`](#fastmode) nelle impostazioni utente di una persona, quindi la modalità veloce è attiva all'inizio di ogni sessione successiva. Impostare questa chiave su `true` per fermare questo: un `fastMode: true` salvato non attiva più la modalità veloce all'inizio della sessione, e ogni persona deve eseguire `/fast` in ogni sessione in cui la desidera. Claude Code lascia la chiave `fastMode` nel file, quindi disattivare questa chiave ripristina il comportamento precedente.

997

998I proprietari su piani Team o Enterprise possono distribuirlo a livello di organizzazione tramite [impostazioni gestite dal server](/docs/it/server-managed-settings). Quando le impostazioni gestite impostano la chiave, `/fast on` viene rifiutato al di fuori delle sessioni di terminale interattive e segnala che l'organizzazione ha disabilitato la modalità veloce. Questo copre la [modalità non interattiva](/docs/it/headless), l'[estensione VS Code](/docs/it/vs-code) e le [sessioni cloud](/docs/it/claude-code-on-the-web).

997 999

998* **Scope**: [`Any file`](#scopes)1000* **Scope**: [`Any file`](#scopes)

999* **Type**: Boolean1001* **Type**: Boolean

1208 `modelSettings`1210 `modelSettings`

1209</h3>1211</h3>

1210 1212

1211Salvare un [livello di effort](/docs/it/model-config#adjust-effort-level) per ogni modello che si utilizza. In una sessione interattiva sulla propria macchina, quando si salva `low`, `medium`, `high` o `xhigh` come predefinito con `/effort` o il cursore di effort del selettore `/model`, Claude Code scrive quel livello qui sotto il modello che si sta utilizzando, quindi raramente si modifica questa chiave manualmente. La voce [`effortLevel`](#effortlevel) elenca le sessioni dove `/effort` si applica solo a quella sessione. Richiede Claude Code v2.1.251 o successivo.1213Salvare un [livello di effort](/docs/it/model-config#adjust-effort-level) per ogni modello che si utilizza. Richiede Claude Code v2.1.251 o successivo.

1214

1215In una sessione interattiva sulla propria macchina, quando si salva `low`, `medium`, `high` o `xhigh` come predefinito con `/effort` o il cursore di effort del selettore `/model`, Claude Code scrive quel livello qui sotto il modello che si sta utilizzando, quindi raramente si modifica questa chiave manualmente. Quando si sceglie uno di questi livelli nel [selettore di modelli dell'estensione VS Code](/docs/it/vs-code#use-the-prompt-box), Claude Code lo salva qui allo stesso modo. La voce [`effortLevel`](#effortlevel) elenca le sessioni dove `/effort` si applica solo a quella sessione.

1212 1216

1213Modificare la chiave manualmente per cambiare o rimuovere un livello salvato.1217Modificare la chiave manualmente per cambiare o rimuovere un livello salvato.

1214 1218

1215Un `effortLevel` di un modello qui ha la precedenza sul [`effortLevel`](#effortlevel) di livello superiore nello stesso file di impostazioni. Tra file, Claude Code risolve ogni modello separatamente: il [file di impostazioni](/docs/it/settings#settings-precedence) con la precedenza più alta che imposta un `effortLevel` per quel modello o il `effortLevel` di livello superiore decide, quindi un `effortLevel` nelle impostazioni gestite supera un livello salvato nelle impostazioni utente. [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) elenca cos'altro può ignorare un livello salvato, come `--effort` al lancio.1219Un `effortLevel` di un modello qui ha la precedenza sul [`effortLevel`](#effortlevel) di livello superiore nello stesso file di impostazioni. Tra file, Claude Code risolve ogni modello separatamente: il [file di impostazioni](/docs/it/settings#settings-precedence) con la precedenza più alta che imposta un `effortLevel` per quel modello o il `effortLevel` di livello superiore che [si applica a quel modello](#effortlevel) decide, quindi un `effortLevel` nelle impostazioni gestite supera un livello salvato nelle impostazioni utente. [Regolare il livello di effort](/docs/it/model-config#adjust-effort-level) elenca cos'altro può ignorare un livello salvato, come `--effort` al lancio.

1216 1220

1217Per limitare l'effort di un modello piuttosto che impostare il suo livello, aggiungere un campo [`maxEffortLevel`](#maxeffortlevel) alla voce di quel modello. Il campo richiede Claude Code v2.1.267 o successivo.1221Per limitare l'effort di un modello piuttosto che impostare il suo livello, aggiungere un campo [`maxEffortLevel`](#maxeffortlevel) alla voce di quel modello. Il campo richiede Claude Code v2.1.267 o successivo.

1218 1222

1220* **Type**: object che mappa un nome di modello a un object con un campo `effortLevel`, uno di `"low"`, `"medium"`, `"high"` o `"xhigh"`, un campo [`maxEffortLevel`](#maxeffortlevel) o entrambi1224* **Type**: object che mappa un nome di modello a un object con un campo `effortLevel`, uno di `"low"`, `"medium"`, `"high"` o `"xhigh"`, un campo [`maxEffortLevel`](#maxeffortlevel) o entrambi

1221* **Default**: non impostato1225* **Default**: non impostato

1222 1226

1223Claude Code scrive ogni voce sotto il nome canonico del modello, come `claude-opus-5`, e corrisponde all'alias di quel modello, con suffisso di data, `[1m]` e ID specifici del provider riconosciuti alla stessa voce.1227Claude Code scrive ogni voce sotto il nome canonico del modello, come `claude-opus-5-5`, e corrisponde all'alias di quel modello, con suffisso di data, `[1m]` e ID specifici del provider riconosciuti alla stessa voce.

1224 1228

1225Questo esempio mantiene Opus 5 a `medium` mentre altri modelli utilizzano i loro livelli salvati o predefiniti:1229Questo esempio mantiene Opus 5.5 a `high` mentre altri modelli utilizzano i loro livelli salvati o predefiniti:

1226 1230

1227```json settings.json theme={null}1231```json settings.json theme={null}

1228{1232{

1229 "modelSettings": {1233 "modelSettings": {

1230 "claude-opus-5": {1234 "claude-opus-5-5": {

1231 "effortLevel": "medium"1235 "effortLevel": "high"

1232 }1236 }

1233 }1237 }

1234}1238}

1839 `sandbox.excludedCommands`1843 `sandbox.excludedCommands`

1840</h3>1844</h3>

1841 1845

1842Nomina i comandi che Claude Code esegue sempre al di fuori della sandbox, come gli strumenti che non funzionano sotto di essa. Ogni voce utilizza la stessa sintassi del contenuto di una [regola di autorizzazione](/docs/it/permissions#permission-rule-syntax) `Bash(...)`: un comando esatto, un prefisso come `docker *` o un pattern con wildcard. Quando qualsiasi parte di un comando composto corrisponde a una voce, Claude Code esegue l'intero comando senza sandbox.1846Nomina i comandi che Claude Code esegue al di fuori della sandbox, come gli strumenti che non funzionano sotto di essa. Ogni voce utilizza la stessa sintassi del contenuto di una [regola di autorizzazione](/docs/it/permissions#permission-rule-syntax) `Bash(...)`: un comando esatto, un prefisso come `docker *` o un pattern con wildcard.

1847

1848Le tue voci tolgono una chiamata Bash dalla sandbox solo quando coprono ogni comando in essa, e alcune forme di chiamata rimangono in sandbox anche allora. Una voce `docker *` da sola non toglie `npm ci && docker build .` dalla sandbox.

1843 1849

1844* **Scope**: [`Any file`](#scopes)1850* **Scope**: [`Any file`](#scopes)

1845* **Type**: array di pattern di comando1851* **Type**: array di pattern di comando

1853}1859}

1854```1860```

1855 1861

1862Claude Code mantiene una chiamata Bash in sandbox quando ha una di queste forme, tra le altre:

1863

1864* Un comando che inizia con `sudo`, `eval` o `xargs`

1865* Un `cd`, `pushd` o `popd`, ovunque appaia nella chiamata

1866* Una sostituzione di comando, una subshell o un blocco di controllo di flusso come `if` o `for`

1867* Un reindirizzamento, come `docker build . > build.log`, diverso da uno che duplica solo un descrittore di file, come `2>&1`

1868* Un nome di comando che proviene da una variabile

1869

1870Ad esempio, `cd build && docker compose up` rimane in sandbox sotto una voce `docker *`, e aggiungere una voce `cd` non cambia questo.

1871

1856I comandi esclusi seguono comunque il flusso di autorizzazione regolare. L'esclusione è una comodità, non un confine di sicurezza: preferisci [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite) quando uno strumento ha solo bisogno di scrivere da qualche parte di specifico. Claude Code unisce le voci in ogni ambito di impostazioni che la sessione carica, e non c'è un blocco solo gestito per questo elenco, quindi mantieni un elenco gestito ristretto.1872I comandi esclusi seguono comunque il flusso di autorizzazione regolare. L'esclusione è una comodità, non un confine di sicurezza: preferisci [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite) quando uno strumento ha solo bisogno di scrivere da qualche parte di specifico. Claude Code unisce le voci in ogni ambito di impostazioni che la sessione carica, e non c'è un blocco solo gestito per questo elenco, quindi mantieni un elenco gestito ristretto.

1857 1873

1858<h3 id="sandbox-allowunsandboxedcommands">1874<h3 id="sandbox-allowunsandboxedcommands">

1905}1921}

1906```1922```

1907 1923

1908Claude Code applica questi elenchi al confine della sandbox del sistema operativo, quindi si applicano a ogni sottoprocesso che un comando in sandbox avvia, come `kubectl`, `terraform` o `npm`, non solo agli strumenti di file di Claude. Claude Code aggiunge le tue [regole di autorizzazione](/docs/it/sandboxing#permission-rules) agli stessi elenchi: le regole `Edit` allow e deny a `allowWrite` e `denyWrite`, le regole `Read` deny a `denyRead` e le regole `WebFetch(domain:...)` allow e deny agli elenchi di domini [`network`](#sandbox-network).1924Claude Code applica questi elenchi al confine della sandbox del sistema operativo, quindi si applicano a ogni sottoprocesso che un comando in sandbox avvia, come `kubectl`, `terraform` o `npm`. Claude Code aggiunge le tue [regole di autorizzazione](/docs/it/sandboxing#permission-rules) agli stessi elenchi: le regole `Edit` allow e deny a `allowWrite` e `denyWrite`, le regole `Read` deny a `denyRead` e le regole `WebFetch(domain:...)` allow e deny agli elenchi di domini [`network`](#sandbox-network).

1909 1925

1910A meno che non sia impostato un blocco solo gestito, Claude Code unisce ogni elenco nei file di impostazioni che la sessione carica. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) limita `allowRead` alle voci dalle impostazioni gestite, e [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) fa lo stesso per i domini consentiti.1926A meno che non sia impostato un blocco solo gestito, Claude Code unisce ogni elenco nei file di impostazioni che la sessione carica. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) limita `allowRead` alle voci dalle impostazioni gestite, e [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) fa lo stesso per i domini consentiti.

1911 1927

3066 `taskOutputMaxChars`3082 `taskOutputMaxChars`

3067</h3>3083</h3>

3068 3084

3069Imposta quanti caratteri dell'output di un [compito in background](/docs/it/tools-reference#background-commands) Claude riceve inline quando Claude legge il compito con lo strumento `TaskOutput`. Quando l'output di un compito terminato è più lungo, Claude riceve i caratteri più recenti. Aumenta il limite quando i tuoi compiti in background producono regolarmente più output del valore predefinito. Richiede Claude Code v2.1.261 o successivo.3085<Warning>

~~3070~~ 3086 Rimosso in v2.1.277, insieme allo strumento `TaskOutput` che lo dimensionava. Impostarlo non ha effetto sulle versioni attuali. Claude legge un [file di output](/docs/it/tools-reference#background-commands) di un compito in background con `Read` invece.

3071* **Scope**: [`Any file`](#scopes)3087</Warning>

3072* **Type**: numero di caratteri, un intero positivo. Claude Code limita il valore nell'intervallo `4000` a `128000`

3073* **Default**: non impostato, quindi Claude riceve fino a 32.000 caratteri inline

~~3074~~

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

3076{

3077 "taskOutputMaxChars": 100000

3078}

3079```

3080 3088

3081Quando imposti questa chiave, Claude Code ignora la variabile di ambiente [`TASK_MAX_OUTPUT_LENGTH`](/docs/it/env-vars).3089Fino a v2.1.276, impostavi questa chiave al numero di caratteri dell'output di un [compito in background](/docs/it/tools-reference#background-commands) che Claude riceveva inline quando leggeva il compito con lo strumento `TaskOutput`.

3082 3090

3083<h2 id="interface-and-terminal">3091<h2 id="interface-and-terminal">

3084 Interfaccia e terminale3092 Interfaccia e terminale

3994 4002

3995Per nascondere tutta l'attribuzione, impostate [`commit`](#attribution-commit) e [`pr`](#attribution-pr) su stringhe vuote e [`sessionUrl`](#attribution-sessionurl) su `false`. Una volta impostato `commit` o `pr`, Claude Code ignora l'impostazione deprecata `includeCoAuthoredBy` e utilizza il testo predefinito per quello dei due che avete lasciato non impostato.4003Per nascondere tutta l'attribuzione, impostate [`commit`](#attribution-commit) e [`pr`](#attribution-pr) su stringhe vuote e [`sessionUrl`](#attribution-sessionurl) su `false`. Una volta impostato `commit` o `pr`, Claude Code ignora l'impostazione deprecata `includeCoAuthoredBy` e utilizza il testo predefinito per quello dei due che avete lasciato non impostato.

3996 4004

4005Claude Code comunica a Claude che le vostre istruzioni personali sull'attribuzione, come una regola CLAUDE.md o [memory](/docs/it/memory), hanno la precedenza su queste righe di commit e PR, a meno che la riga non sia impostata in [managed settings](/docs/it/managed-settings).

4006

3997<h3 id="includecoauthoredby">4007<h3 id="includecoauthoredby">

3998 `includeCoAuthoredBy`4008 `includeCoAuthoredBy`

3999</h3>4009</h3>

4022 `includeGitInstructions`4032 `includeGitInstructions`

4023</h3>4033</h3>

4024 4034

4025All'inizio della sessione, Claude Code aggiunge due elementi correlati a git al prompt di Claude: le sue istruzioni integrate su come scrivere commit e pull request, nella descrizione dello strumento Bash, e uno snapshot dello stato git del vostro repository nel prompt di sistema, il che significa il ramo corrente, il ramo principale, l'output di `git status` e i commit recenti. Impostate questa chiave su `false` per escludere entrambi, ad esempio quando utilizzate le vostre skill di flusso di lavoro git personalizzate.4035Claude Code fornisce a Claude due elementi correlati a git: le sue istruzioni integrate su come scrivere commit e pull request, nella descrizione dello strumento Bash, e uno snapshot dello stato git del vostro repository. Lo snapshot contiene il ramo corrente, il ramo principale, l'output di `git status` e i commit recenti. Claude Code lo legge quando inizia una conversazione.

4036

4037Impostate questa chiave su `false` per escludere entrambi, ad esempio quando utilizzate le vostre skill di flusso di lavoro git personalizzate.

4026 4038

4027* **Ambito**: [`Any file`](#scopes)4039* **Ambito**: [`Any file`](#scopes)

4028* **Tipo**: Boolean4040* **Tipo**: Boolean

4627| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` obbligatorio; `ref` è un ramo o un tag; `path` è una sottodirectory |4639| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` obbligatorio; `ref` è un ramo o un tag; `path` è una sottodirectory |

4628| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` obbligatorio; `ref` e `path` come per `github` |4640| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` obbligatorio; `ref` e `path` come per `github` |

4629| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` obbligatorio; `headers` aggiunge intestazioni HTTP per l'accesso autenticato |4641| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` obbligatorio; `headers` aggiunge intestazioni HTTP per l'accesso autenticato |

4630| `npm` | `{ "source": "npm", "package": "@acme-corp/claude-plugins" }` | `package` obbligatorio, il pacchetto npm che contiene `marketplace.json` |

4631| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` obbligatorio, il percorso assoluto a un file `marketplace.json` |4642| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` obbligatorio, il percorso assoluto a un file `marketplace.json` |

4632| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` obbligatorio, il percorso assoluto a una directory contenente `.claude-plugin/marketplace.json` |4643| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` obbligatorio, il percorso assoluto a una directory contenente `.claude-plugin/marketplace.json` |

4633| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` obbligatorio, una regex confrontata con l'host del marketplace |4644| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` obbligatorio, una regex confrontata con l'host del marketplace |

5905}5916}

5906```5917```

5907 5918

5908Imposta l'intervallo di aggiornamento con [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/it/env-vars). Vedi [Dynamic headers](/docs/it/monitoring-usage#dynamic-headers) per i requisiti dello script e dove Claude Code segnala un helper che fallisce.5919Imposta l'intervallo di aggiornamento con [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/it/env-vars). Vedi [Dynamic headers](/docs/it/monitoring-usage#dynamic-headers) per i requisiti dello script e cosa succede quando l'helper fallisce.

5909 5920

5910<h2 id="updates-and-versioning">5921<h2 id="updates-and-versioning">

5911 Aggiornamenti e versioning5922 Aggiornamenti e versioning

5940Impedisci agli aggiornamenti automatici in background e a `claude update` di installare qualsiasi versione al di sotto di questa, quindi il passaggio al canale `"stable"` non ti fa eseguire il downgrade da una build `"latest"` più recente. Claude Code scrive questa chiave per te quando scegli di rimanere sulla versione corrente mentre cambi canale in `/config`, e la cancella quando torni a `"latest"`.5951Impedisci agli aggiornamenti automatici in background e a `claude update` di installare qualsiasi versione al di sotto di questa, quindi il passaggio al canale `"stable"` non ti fa eseguire il downgrade da una build `"latest"` più recente. Claude Code scrive questa chiave per te quando scegli di rimanere sulla versione corrente mentre cambi canale in `/config`, e la cancella quando torni a `"latest"`.

5941 5952

5942* **Scope**: [`Any file`](#scopes). Impostalo nelle impostazioni gestite per fissare un minimo a livello di organizzazione che le impostazioni utente e di progetto non possono abbassare.5953* **Scope**: [`Any file`](#scopes). Impostalo nelle impostazioni gestite per fissare un minimo a livello di organizzazione che le impostazioni utente e di progetto non possono abbassare.

5943* **Type**: string, un numero di versione come `"2.1.100"`5954* **Type**: string, un numero di versione come `"2.1.100"`; un valore che non è una versione valida viene ignorato

5944* **Default**: non impostato, quindi gli aggiornamenti possono installare qualsiasi versione che il canale offre5955* **Default**: non impostato, quindi gli aggiornamenti possono installare qualsiasi versione che il canale offre

5945 5956

5946Questo esempio segue il canale stable e rifiuta di installare qualsiasi versione al di sotto di 2.1.100:5957Questo esempio segue il canale stable e rifiuta di installare qualsiasi versione al di sotto di 2.1.100:

skills.md +10 −6

Details

145 145

146Claude Code carica le skill di progetto da `.claude/skills/` nella directory in cui lo avvii e in ogni directory padre fino alla radice del repository, quindi avviare in `packages/frontend/` raccoglie comunque le skill definite alla radice. Quando [sposti la sessione con `/cd`](/docs/it/permissions#move-the-session-to-another-directory) su v2.1.246 o successiva, Claude Code aggiunge le skill di progetto della nuova directory.146Claude Code carica le skill di progetto da `.claude/skills/` nella directory in cui lo avvii e in ogni directory padre fino alla radice del repository, quindi avviare in `packages/frontend/` raccoglie comunque le skill definite alla radice. Quando [sposti la sessione con `/cd`](/docs/it/permissions#move-the-session-to-another-directory) su v2.1.246 o successiva, Claude Code aggiunge le skill di progetto della nuova directory.

147 147

148In una sessione in esecuzione in un [git worktree](/docs/it/worktrees) collegato, Claude Code cerca le directory padre solo fino alla radice del worktree. Su Claude Code v2.1.277 o successiva, quando il checkout del worktree non ha una directory `.claude/skills` alla sua radice, Claude Code carica invece le skill di progetto del checkout principale. Vedi [Cosa i worktree condividono con il checkout principale](/docs/it/worktrees#what-worktrees-share-with-the-main-checkout).

149

148Le skill in una directory `.claude/skills/` sotto il punto in cui hai iniziato non si caricano all'avvio. Si caricano la prima volta che Claude legge o modifica un file in quella sottodirectory e rimangono disponibili per il resto della sessione. Fino ad allora non appaiono nel menu `/` e non puoi invocarle per nome. Per caricarle prima, esegui `/add-dir` con il percorso della sottodirectory, che richiede Claude Code v2.1.257 o successiva.150Le skill in una directory `.claude/skills/` sotto il punto in cui hai iniziato non si caricano all'avvio. Si caricano la prima volta che Claude legge o modifica un file in quella sottodirectory e rimangono disponibili per il resto della sessione. Fino ad allora non appaiono nel menu `/` e non puoi invocarle per nome. Per caricarle prima, esegui `/add-dir` con il percorso della sottodirectory, che richiede Claude Code v2.1.257 o successiva.

149 151

150Quando una skill annidato condivide un nome con un'altra skill, entrambe rimangono disponibili. Con una skill `deploy` alla radice del repository e un'altra in `apps/web/.claude/skills/`:152Quando una skill annidato condivide un nome con un'altra skill, entrambe rimangono disponibili. Con una skill `deploy` alla radice del repository e un'altra in `apps/web/.claude/skills/`:

186Se una skill esiste solo in `~/.claude/skills/` sulla tua macchina, Claude Code segnala che la skill non è stata trovata quando una [routine](/docs/it/routines) la invoca, perché ogni esecuzione di routine inizia come una sessione cloud nuova. Per rendere disponibile una skill personale in queste sessioni:188Se una skill esiste solo in `~/.claude/skills/` sulla tua macchina, Claude Code segnala che la skill non è stata trovata quando una [routine](/docs/it/routines) la invoca, perché ogni esecuzione di routine inizia come una sessione cloud nuova. Per rendere disponibile una skill personale in queste sessioni:

187 189

188* Per le sessioni Cowork e cloud, abilita la skill per il tuo account claude.ai.190* Per le sessioni Cowork e cloud, abilita la skill per il tuo account claude.ai.

189* Per le sessioni cloud, puoi invece committare la skill in `.claude/skills/` del repository, o spedirla in un plugin dichiarato in `.claude/settings.json` del repository. I plugin dichiarati nel repository [si installano all'avvio della sessione](/docs/it/cloud-environments#what-carries-over-from-your-setup); i plugin abilitati solo nelle tue impostazioni utente non si trasferiscono.191* Per le sessioni cloud, puoi invece committare la skill in `.claude/skills/` del repository. I plugin dichiarati in `.claude/settings.json` del repository e i plugin abilitati solo nelle tue impostazioni utente [non si caricano nelle sessioni cloud](/docs/it/cloud-environments#what-carries-over-from-your-setup).

190 192

191[I compiti programmati del Desktop](/docs/it/desktop-scheduled-tasks) vengono eseguiti localmente sulla tua macchina, quindi caricano `~/.claude/skills/`.193[I compiti programmati del Desktop](/docs/it/desktop-scheduled-tasks) vengono eseguiti localmente sulla tua macchina, quindi caricano `~/.claude/skills/`.

192 194

219 221

220Le skill che una sessione precedente ha sincronizzato rimangono su disco. Claude Code le carica in sessioni successive accedute allo stesso account, anche quando non riesce a raggiungere claude.ai.222Le skill che una sessione precedente ha sincronizzato rimangono su disco. Claude Code le carica in sessioni successive accedute allo stesso account, anche quando non riesce a raggiungere claude.ai.

221 223

224Claude Code scarica le skill sincronizzate e non le carica mai. Se tu o Claude modificate un file sotto `~/.claude/skills/synced/`, la modifica non viene salvata nel tuo account claude.ai, e una sincronizzazione successiva può sovrascriverla o rimuoverla. Per modificare una skill sincronizzato, aggiornala su claude.ai; la prossima sincronizzazione scarica la nuova versione.

225

222Per vedere quali skill hanno sincronizzato, esegui `/skills`. Il menu le elenca sotto `claude.ai sync`.226Per vedere quali skill hanno sincronizzato, esegui `/skills`. Il menu le elenca sotto `claude.ai sync`.

223 227

224Alcune skill di Anthropic, come `pdf` e `xlsx`, sincronizzano sempre. Per il resto, attiva o disattiva una skill nelle tue impostazioni delle skill su claude.ai per cambiare se sincronizza.228Alcune skill di Anthropic, come `pdf` e `xlsx`, sincronizzano sempre. Per il resto, attiva o disattiva una skill nelle tue impostazioni delle skill su claude.ai per cambiare se sincronizza.

335 Riferimento frontmatter339 Riferimento frontmatter

336</h3>340</h3>

337 341

338Oltre al contenuto markdown, puoi configurare il comportamento della skill utilizzando campi frontmatter YAML tra i marcatori `---` nella parte superiore del tuo file `SKILL.md`:342Configura una skill con YAML [frontmatter](/docs/it/glossary#frontmatter) tra i marcatori `---` nella parte superiore di `SKILL.md`, e scrivi le istruzioni della skill come Markdown dopo il `---` di chiusura. I nomi dei campi usano parole minuscole separate da trattini, eccetto `when_to_use`. Un [file di comando](#where-skills-live) in `.claude/commands/` accetta gli stessi campi eccetto `name` e `paths`. Questo esempio imposta quattro campi:

339 343

340```yaml theme={null}344```yaml theme={null}

341---345---

348Your skill instructions here...352Your skill instructions here...

349```353```

350 354

351Tutti i campi sono facoltativi. Solo `description` è consigliato in modo che Claude sappia quando usare la skill.355Tutti i campi sono facoltativi. Solo `description` è consigliato in modo che Claude sappia quando usare la skill. Un nome di campo deve corrispondere esattamente alla tabella, trattini inclusi: Claude Code ignora un campo che non riconosce senza segnalare un errore.

352 356

353Claude Code legge il frontmatter solo quando l'apertura `---` è la prima riga del file. Altrimenti tratta l'intero file, marcatori `---` inclusi, come contenuto skill.357Claude Code legge il frontmatter solo quando l'apertura `---` è la prima riga del file. Altrimenti tratta l'intero file, marcatori `---` inclusi, come contenuto skill. Se lo YAML tra i marcatori non viene analizzato, la skill si carica comunque senza campi impostati; vedi [Skill non si attiva](#skill-not-triggering) per trovare e correggere l'errore.

354 358

355I campi booleani accettano `yes`, `no`, `on`, `off`, `1` e `0` in qualsiasi maiuscola, oltre a `true` e `false`. Prima della v2.1.218, Claude Code riconosceva solo `true` e `false`.359I campi booleani accettano `yes`, `no`, `on`, `off`, `1` e `0` in qualsiasi maiuscola, oltre a `true` e `false`. Prima della v2.1.218, Claude Code riconosceva solo `true` e `false`.

356 360

358| :------------------------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |362| :------------------------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

359| `name` | No | Nome visualizzato mostrato negli elenchi di skills. Predefinito al nome della directory. Vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name) per come il campo interagisce con il nome che digiti per invocare la skill. |363| `name` | No | Nome visualizzato mostrato negli elenchi di skills. Predefinito al nome della directory. Vedi [Come una skill ottiene il suo nome di comando](#how-a-skill-gets-its-command-name) per come il campo interagisce con il nome che digiti per invocare la skill. |

360| `description` | Consigliato | Cosa fa la skill e quando usarla. Claude usa questo per decidere quando applicare la skill. Se omesso, usa il primo paragrafo non vuoto del contenuto markdown. Metti il caso d'uso chiave per primo: il testo combinato `description` e `when_to_use` viene troncato a 1.536 caratteri nell'elenco delle skills per ridurre l'utilizzo del contesto. |364| `description` | Consigliato | Cosa fa la skill e quando usarla. Claude usa questo per decidere quando applicare la skill. Se omesso, usa la prima riga non vuota del contenuto markdown. Metti il caso d'uso chiave per primo: il testo combinato `description` e `when_to_use` viene troncato a 1.536 caratteri nell'elenco delle skills per ridurre l'utilizzo del contesto. |

361| `when_to_use` | No | Contesto aggiuntivo per quando Claude dovrebbe invocare la skill, come frasi trigger o richieste di esempio. Aggiunto a `description` nell'elenco delle skills e conta verso il limite di 1.536 caratteri. |365| `when_to_use` | No | Contesto aggiuntivo per quando Claude dovrebbe invocare la skill, come frasi trigger o richieste di esempio. Aggiunto a `description` nell'elenco delle skills e conta verso il limite di 1.536 caratteri. |

362| `argument-hint` | No | Suggerimento mostrato durante l'autocompletamento per indicare gli argomenti previsti. Esempio: `[issue-number]` o `[filename] [format]`. |366| `argument-hint` | No | Suggerimento mostrato durante l'autocompletamento per indicare gli argomenti previsti. Esempio: `[issue-number]` o `[filename] [format]`. |

363| `arguments` | No | Argomenti posizionali denominati per la [sostituzione `$name`](#available-string-substitutions) nel contenuto della skill. Accetta una stringa separata da spazi o un elenco YAML. I nomi si mappano alle posizioni degli argomenti in ordine. |367| `arguments` | No | Argomenti posizionali denominati per la [sostituzione `$name`](#available-string-substitutions) nel contenuto della skill. Accetta una stringa separata da spazi o un elenco YAML. I nomi si mappano alle posizioni degli argomenti in ordine. |

790Quando questa skill viene eseguita:794Quando questa skill viene eseguita:

791 795

7921. Viene creato un nuovo contesto isolato7961. Viene creato un nuovo contesto isolato

7932. Il subagent riceve il contenuto della skill come suo prompt ("Research \$ARGUMENTS thoroughly...")7972. Il subagent riceve il contenuto della skill come suo prompt (le istruzioni "Research \$ARGUMENTS thoroughly")

7943. Il campo `agent` determina l'ambiente di esecuzione (modello, strumenti e permessi)7983. Il campo `agent` determina l'ambiente di esecuzione (modello, strumenti e permessi)

7954. Il subagent riassume i suoi risultati e li restituisce alla tua conversazione principale quando finisce7994. Il subagent riassume i suoi risultati e li restituisce alla tua conversazione principale quando finisce

796 800

statusline.md +2 −2

Details

192| `workspace.git_worktree` | Nome del Git worktree quando la directory corrente si trova all'interno di un worktree collegato creato con `git worktree add`. Assente nel worktree principale. Popolato per qualsiasi git worktree, a differenza di `worktree.*`, che è presente solo durante una [sessione worktree](/docs/it/worktrees) |192| `workspace.git_worktree` | Nome del Git worktree quando la directory corrente si trova all'interno di un worktree collegato creato con `git worktree add`. Assente nel worktree principale. Popolato per qualsiasi git worktree, a differenza di `worktree.*`, che è presente solo durante una [sessione worktree](/docs/it/worktrees) |

193| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Identità del repository analizzata dal remote `origin`, ad esempio `"github.com"`, `"anthropics"`, `"claude-code"`. Assente al di fuori di un repository git o quando nessun remote `origin` è configurato. Per un progetto gitlab.com annidato in sottogruppi, `owner` è il percorso dello spazio dei nomi completo con barre, come `"group/subgroup"`. Prima della v2.1.260, `workspace.repo` era assente per questi progetti |193| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Identità del repository analizzata dal remote `origin`, ad esempio `"github.com"`, `"anthropics"`, `"claude-code"`. Assente al di fuori di un repository git o quando nessun remote `origin` è configurato. Per un progetto gitlab.com annidato in sottogruppi, `owner` è il percorso dello spazio dei nomi completo con barre, come `"group/subgroup"`. Prima della v2.1.260, `workspace.repo` era assente per questi progetti |

194| `cost.total_cost_usd` | Costo totale stimato della sessione in USD, calcolato lato client al prezzo di listino a meno che una tabella [`modelPricing`](/docs/it/settings-reference#modelpricing) non sia in vigore. Potrebbe differire dalla tua fattura effettiva. Si ripristina a \$0 quando `/clear` avvia una nuova sessione. Prima della v2.1.211, il totale veniva mantenuto dopo `/clear` |194| `cost.total_cost_usd` | Costo totale stimato della sessione in USD, calcolato lato client al prezzo di listino a meno che una tabella [`modelPricing`](/docs/it/settings-reference#modelpricing) non sia in vigore. Potrebbe differire dalla tua fattura effettiva. Si ripristina a \$0 quando `/clear` avvia una nuova sessione. Prima della v2.1.211, il totale veniva mantenuto dopo `/clear` |

195| `cost.total_duration_ms` | Tempo totale trascorso dal momento dell'avvio della sessione, in millisecondi |195| `cost.total_duration_ms` | Tempo totale trascorso dal momento dell'avvio della sessione, in millisecondi. Si accumula tra i ripresi e non include il tempo mentre la sessione non è in esecuzione |

198| `context_window.total_input_tokens`, `context_window.total_output_tokens` | Conteggi dei token attualmente nella finestra di contesto, dalla risposta API più recente. L'input include letture e scritture della cache. |198| `context_window.total_input_tokens`, `context_window.total_output_tokens` | Conteggi dei token attualmente nella finestra di contesto, dalla risposta API più recente. L'input include letture e scritture della cache. |

236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",

237 "transcript_path": "/path/to/transcript.jsonl",237 "transcript_path": "/path/to/transcript.jsonl",

238 "model": {238 "model": {

239 "id": "claude-opus-5",239 "id": "claude-opus-5-5",

240 "display_name": "Opus"240 "display_name": "Opus"

241 },241 },

242 "workspace": {242 "workspace": {

sub-agents.md +29 −15

Details

32 32

33Claude Code include subagent integrati che Claude utilizza automaticamente quando appropriato. Ognuno eredita le autorizzazioni della conversazione principale; la maggior parte viene eseguita con un set di strumenti limitato.33Claude Code include subagent integrati che Claude utilizza automaticamente quando appropriato. Ognuno eredita le autorizzazioni della conversazione principale; la maggior parte viene eseguita con un set di strumenti limitato.

34 34

35Explore e Plan saltano i vostri file CLAUDE.md e lo stato git della sessione principale per mantenere la ricerca veloce ed economica. Ogni altro subagent integrato e [subagent personalizzato](#configure-subagents) carica entrambi, a meno che la sua definizione non imposti il campo [`omitClaudeMd`](#supported-frontmatter-fields) per saltare i file CLAUDE.md dell'utente, del progetto e locali. Per la suddivisione completa di ciò che raggiunge un subagent, consultate [cosa si carica all'avvio](#what-loads-at-startup).35Explore e Plan saltano i vostri file CLAUDE.md e lo snapshot dello stato git per mantenere la ricerca veloce ed economica. Ogni altro subagent integrato e [subagent personalizzato](#configure-subagents) carica entrambi, a meno che la sua definizione non imposti il campo [`omitClaudeMd`](#supported-frontmatter-fields) per saltare i file CLAUDE.md dell'utente, del progetto e locali. Per la suddivisione completa di ciò che raggiunge un subagent, consultate [cosa si carica all'avvio](#what-loads-at-startup).

36 36

37<Tabs>37<Tabs>

38 <Tab title="Explore">38 <Tab title="Explore">

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232

233Il flag `--agents` accetta JSON con un campo `prompt` più questi campi [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd`, e `isolation`. Usi `prompt` per il prompt di sistema, equivalente al corpo markdown nei subagent basati su file.233Il flag `--agents` accetta JSON con un campo `prompt` più questi campi [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd`, e `isolation`. Usi `prompt` per il prompt di sistema, equivalente al corpo markdown nei subagent basati su file. `color` e `experimental` non sono accettati qui e vengono ignorati piuttosto che rifiutati.

234 234

235Ogni chiave di primo livello nel JSON è il nome dell'agente. Non inizi un nome con `-`.235Ogni chiave di primo livello nel JSON è il nome dell'agente. Non inizi un nome con `-`.

236 236

295 295

296Quando la conversazione principale stessa viene eseguita isolata in un worktree, Claude Code applica gli stessi controlli alla sessione e a ogni subagent che genera, inclusi i subagent senza `isolation: worktree`; consulti [Come Claude Code applica l'isolamento](/docs/it/worktrees#how-claude-code-enforces-isolation).296Quando la conversazione principale stessa viene eseguita isolata in un worktree, Claude Code applica gli stessi controlli alla sessione e a ogni subagent che genera, inclusi i subagent senza `isolation: worktree`; consulti [Come Claude Code applica l'isolamento](/docs/it/worktrees#how-claude-code-enforces-isolation).

297 297

298<h4 id="supported-frontmatter-fields">298<h3 id="supported-frontmatter-fields">

299 Campi frontmatter supportati299 Riferimento frontmatter

300</h4>300</h3>

301

302Configuri un subagent con YAML [frontmatter](/docs/it/glossary#frontmatter) tra marcatori `---` all'inizio del suo file, e scriva il suo prompt di sistema come Markdown dopo la chiusura `---`. Solo `name` e `description` sono obbligatori.

301 303

302I seguenti campi possono essere utilizzati nel frontmatter YAML. Solo `name` e `description` sono obbligatori.304I nomi di campo con più parole utilizzano camelCase, come `maxTurns` e `disallowedTools`, e devono corrispondere esattamente alla tabella: Claude Code ignora un campo che non riconosce senza segnalare un errore. Per scoprire perché un file subagent non si è caricato, consulti [File subagent che Claude Code salta](#subagent-files-claude-code-skips).

303 305

305| :---------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |307| :---------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

306| `name` | Yes | Identificatore univoco utilizzando lettere minuscole e trattini. [Hooks](/docs/it/hooks#subagentstart) ricevono questo valore come `agent_type`. Il nome del file non deve corrispondere. I nomi non possono contenere `:`, che è riservato per [identificatori con ambito plugin](/docs/it/plugins) come `my-plugin:reviewer`. Claude Code non carica un file il cui nome contiene uno e registra un errore nel log di debug. Prima di v2.1.218, tali nomi erano accettati |308| `name` | Yes | Identificatore univoco, come `code-reviewer` o `reviewer-v2`. [Hooks](/docs/it/hooks#subagentstart) ricevono questo valore come `agent_type`. Il nome del file non deve corrispondere. I nomi non possono contenere `:`, che è riservato per [identificatori con ambito plugin](/docs/it/plugins) come `my-plugin:reviewer`. Claude Code non carica un file il cui nome contiene uno e registra un errore nel log di debug. Prima di v2.1.218, tali nomi erano accettati |

307| `description` | Yes | Quando Claude dovrebbe delegare a questo subagent |309| `description` | Yes | Quando Claude dovrebbe delegare a questo subagent |

308| `tools` | No | [Strumenti](#available-tools) che il subagent può utilizzare. Eredita ogni strumento disponibile per i subagent se omesso. Se nessuna voce nell'elenco si risolve in uno strumento, il subagent di solito [non si avvia](/docs/it/errors#agent-would-be-spawned-with-zero-tools) con un errore che nomina le voci. Per precaricare Skills nel contesto, usi il campo `skills` piuttosto che elencare `Skill` qui |310| `tools` | No | [Strumenti](#available-tools) che il subagent può utilizzare, come una stringa separata da virgole come `Read, Grep, Bash` o un elenco YAML. Eredita ogni strumento disponibile per i subagent se omesso. Se nessuna voce nell'elenco si risolve in uno strumento, il subagent di solito [non si avvia](/docs/it/errors#agent-would-be-spawned-with-zero-tools) con un errore che nomina le voci. Per precaricare Skills nel contesto, usi il campo `skills` piuttosto che elencare `Skill` qui |

309| `disallowedTools` | No | Strumenti da negare, rimossi dall'elenco ereditato o specificato. Una voce con uno specificatore, come `Bash(git push *)`, comunque [rimuove lo strumento intero](#available-tools) |311| `disallowedTools` | No | Strumenti da negare, rimossi dall'elenco ereditato o specificato. Stesso formato di `tools`. Una voce con uno specificatore, come `Bash(git push *)`, comunque [rimuove lo strumento intero](#available-tools) |

310| `model` | No | [Modello](#choose-a-model) da utilizzare: `sonnet`, `opus`, `haiku`, `fable`, un ID modello completo come `claude-opus-5`, o `inherit`. Quando lo omette, Claude Code sceglie il modello nell'[ordine del modello subagent](#choose-a-model) |312| `model` | No | [Modello](#choose-a-model) da utilizzare: `sonnet`, `opus`, `haiku`, `fable`, un ID modello completo come `claude-opus-5-5`, o `inherit`. Quando lo omette, Claude Code sceglie il modello nell'[ordine del modello subagent](#choose-a-model) |

311| `permissionMode` | No | [Modalità di autorizzazione](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, o `manual` come alias per `default`. L'alias `manual` richiede Claude Code v2.1.200 o successivo. Ignorato per [subagent plugin](#choose-the-subagent-scope) |313| `permissionMode` | No | [Modalità di autorizzazione](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, o `manual` come alias per `default`. L'alias `manual` richiede Claude Code v2.1.200 o successivo. Ignorato per [subagent plugin](#choose-the-subagent-scope) |

312| `maxTurns` | No | Numero massimo di turni agentici prima che il subagent si fermi. Quando il subagent raggiunge il limite, Claude Code restituisce il suo output contrassegnato come parziale, e Claude può [riprenderlo](#resume-subagents) per continuare. Il contrassegno parziale richiede Claude Code v2.1.246 o successivo |314| `maxTurns` | No | Numero massimo di turni agentici prima che il subagent si fermi. Quando il subagent raggiunge il limite, Claude Code restituisce il suo output contrassegnato come parziale, e Claude può [riprenderlo](#resume-subagents) per continuare. Il contrassegno parziale richiede Claude Code v2.1.246 o successivo |

313| `skills` | No | [Skills](/docs/it/skills) da precaricare nel contesto del subagent all'avvio. Il contenuto completo della skill viene iniettato, non solo la descrizione. I subagent possono ancora invocare skills di progetto, utente e plugin non elencate tramite lo strumento Skill |315| `skills` | No | [Skills](/docs/it/skills) da precaricare nel contesto del subagent all'avvio. Il contenuto completo della skill viene iniettato, non solo la descrizione. I subagent possono ancora invocare skills di progetto, utente e plugin non elencate tramite lo strumento Skill |

319| `effort` | No | Livello di sforzo quando questo subagent è attivo. Sostituisce il livello di sforzo della sessione. Predefinito: eredita dalla sessione. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`; i livelli disponibili dipendono dal modello |321| `effort` | No | Livello di sforzo quando questo subagent è attivo. Sostituisce il livello di sforzo della sessione. Predefinito: eredita dalla sessione. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`; i livelli disponibili dipendono dal modello |

320| `isolation` | No | Imposta su `worktree` per eseguire il subagent in un [git worktree](/docs/it/worktrees) temporaneo, dandogli una copia isolata del repository diramata per impostazione predefinita dal suo [ramo predefinito](/docs/it/worktrees#choose-the-base-branch) piuttosto che dall'`HEAD` della sessione principale. Il worktree viene automaticamente pulito se il subagent non apporta modifiche |322| `isolation` | No | Imposta su `worktree` per eseguire il subagent in un [git worktree](/docs/it/worktrees) temporaneo, dandogli una copia isolata del repository diramata per impostazione predefinita dal suo [ramo predefinito](/docs/it/worktrees#choose-the-base-branch) piuttosto che dall'`HEAD` della sessione principale. Il worktree viene automaticamente pulito se il subagent non apporta modifiche |

321| `color` | No | Colore di visualizzazione per il subagent nell'elenco attività e nella trascrizione. Accetta `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, o `cyan` |323| `color` | No | Colore di visualizzazione per il subagent nell'elenco attività e nella trascrizione. Accetta `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, o `cyan` |

322| `initialPrompt` | No | Auto-inviato come primo turno utente quando questo agente viene eseguito come agente della sessione principale (tramite `--agent` o l'impostazione `agent`). [Commands](/docs/it/commands) e [skills](/docs/it/skills) vengono elaborati. Anteposto a qualsiasi prompt fornito dall'utente |324| `initialPrompt` | No | Auto-inviato come primo turno utente quando questo agente viene eseguito come agente della sessione principale (tramite `--agent` o l'impostazione `agent`). [Commands](/docs/it/commands) e [skills](/docs/it/skills) vengono elaborati. Anteposto a qualsiasi prompt fornito dall'utente. Ignorato per [subagent plugin](#choose-the-subagent-scope) |

323| `experimental` | No | Mappa di opzioni sperimentali. Imposti la sua chiave `cacheTtl` su `5m` o `1h` per scegliere la [durata della cache del prompt](/docs/it/prompt-caching#choose-the-ttl-yourself) per le richieste di questo subagent, al posto del frontmatter nella [precedenza della durata della cache](/docs/it/prompt-caching#choose-the-ttl-yourself). Claude Code ignora qualsiasi altro valore, ignora `1h` mentre il suo abbonamento Claude sta utilizzando crediti di utilizzo, e legge il campo solo dai file subagent. Richiede Claude Code v2.1.248 o successivo |325| `experimental` | No | Mappa di opzioni sperimentali. Imposti la sua chiave `cacheTtl` su `5m` o `1h` per scegliere la [durata della cache del prompt](/docs/it/prompt-caching#choose-the-ttl-yourself) per le richieste di questo subagent, al posto del frontmatter nella [precedenza della durata della cache](/docs/it/prompt-caching#choose-the-ttl-yourself). Claude Code ignora qualsiasi altro valore, ignora `1h` mentre il suo abbonamento Claude sta utilizzando crediti di utilizzo, e legge il campo solo dai file subagent. Richiede Claude Code v2.1.248 o successivo |

324 326

325Scriva `cacheTtl` all'interno della mappa `experimental`, non al livello superiore del frontmatter.327Scriva `cacheTtl` all'interno della mappa `experimental`, non al livello superiore del frontmatter.

362Il campo `model` controlla quale modello utilizza il subagent:364Il campo `model` controlla quale modello utilizza il subagent:

363 365

364* **Alias modello**: usi uno degli alias disponibili: `sonnet`, `opus`, `haiku`, o `fable`366* **Alias modello**: usi uno degli alias disponibili: `sonnet`, `opus`, `haiku`, o `fable`

365* **ID modello completo**: usi un ID modello completo come `claude-opus-5` o `claude-sonnet-5`. Accetta gli stessi valori del flag `--model`367* **ID modello completo**: usi un ID modello completo come `claude-opus-5-5` o `claude-sonnet-5`. Accetta gli stessi valori del flag `--model`

366* **inherit**: usi lo stesso modello della conversazione principale368* **inherit**: usi lo stesso modello della conversazione principale

367 369

368Quando Claude invoca un subagent, può anche passare un parametro `model` per quella specifica invocazione. Claude Code risolve il modello del subagent in questo ordine:370Quando Claude invoca un subagent, può anche passare un parametro `model` per quella specifica invocazione. Claude Code risolve il modello del subagent in questo ordine:

3723. La variabile di ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/it/model-config#environment-variables), quando la imposta su un alias modello o ID modello3743. La variabile di ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/it/model-config#environment-variables), quando la imposta su un alias modello o ID modello

3734. Il modello della conversazione principale3754. Il modello della conversazione principale

374 376

377In due casi, un alias di famiglia come `opus` nel parametro per invocazione o nel frontmatter si risolve al modello della conversazione principale invece della [versione a cui l'alias punta](/docs/it/model-config#model-aliases):

378

379* **Il modello della conversazione principale appartiene a quella famiglia**: il subagent viene eseguito sul modello esatto della conversazione principale, incluso qualsiasi suffisso `[1m]`, quindi ottiene la stessa finestra di [contesto esteso](/docs/it/model-config#extended-context) della conversazione principale.

380* **Claude Code non può dire la famiglia del modello della conversazione principale, su [un provider diverso dall'API Anthropic](/docs/it/third-party-integrations)**: questo può accadere con un [ARN del profilo di inferenza dell'applicazione](/docs/it/amazon-bedrock#iam-configuration) su Amazon Bedrock che Claude Code non ha risolto a un modello di supporto. Questo caso copre solo l'alias `opus`, e non si applica quando imposta [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/it/model-config#environment-variables), poiché `opus` allora si risolve al modello che imposta.

381

382Un alias in `CLAUDE_CODE_SUBAGENT_MODEL` si risolve sempre alla versione a cui l'alias punta, anche quando nomina la famiglia della conversazione principale.

383

375L'impostazione di `CLAUDE_CODE_SUBAGENT_MODEL` da sola non cambia il modello su cui vengono eseguiti i subagent Explore e Plan integrati. Per cambiarlo, consulti [Esegui ogni subagent su un modello](#run-every-subagent-on-one-model).384L'impostazione di `CLAUDE_CODE_SUBAGENT_MODEL` da sola non cambia il modello su cui vengono eseguiti i subagent Explore e Plan integrati. Per cambiarlo, consulti [Esegui ogni subagent su un modello](#run-every-subagent-on-one-model).

376 385

377Prima di v2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` veniva per primo in questo ordine e sostituiva sia il parametro per invocazione che il frontmatter, incluso `model: inherit`.386Prima di v2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` veniva per primo in questo ordine e sostituiva sia il parametro per invocazione che il frontmatter, incluso `model: inherit`.

438* `EnterPlanMode`447* `EnterPlanMode`

439* `ExitPlanMode`, a meno che la [`permissionMode`](#permission-modes) del subagent non sia `plan`448* `ExitPlanMode`, a meno che la [`permissionMode`](#permission-modes) del subagent non sia `plan`

440* `ScheduleWakeup`449* `ScheduleWakeup`

441* `TaskOutput`

442* `WaitForMcpServers`450* `WaitForMcpServers`

443* `Workflow`451* `Workflow`

444 452

445Il secondo filtro si applica ai subagent in esecuzione in background. A parte `Agent` e `ExitPlanMode`, che seguono le condizioni del primo filtro ovunque il subagent venga eseguito, un subagent in background mantiene ogni strumento MCP ma solo questi strumenti integrati: `Read`, `Grep`, `Glob`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage`, e `Artifact`, più [`SubagentHandoff`](/docs/it/tools-reference) per un subagent che segnala attraverso di esso. Claude Code rimuove ogni altro strumento integrato da un subagent in background, sia ereditato che elencato nel campo `tools`, quindi la stessa definizione può risolvere in strumenti diversi in foreground e background. La rimozione non segnala alcun errore a meno che non lasci l'elenco `tools` [risolvere a nulla](/docs/it/errors#agent-would-be-spawned-with-zero-tools).453Il secondo filtro si applica ai subagent in esecuzione in background. A parte `Agent` e `ExitPlanMode`, che seguono le condizioni del primo filtro ovunque il subagent venga eseguito, un subagent in background mantiene ogni strumento MCP ma solo questi strumenti integrati: `Read`, `Grep`, `Glob`, `LSP`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage`, e `Artifact`, più [`SubagentHandback`](/docs/it/tools-reference) per un subagent che segnala attraverso di esso. Claude Code rimuove ogni altro strumento integrato da un subagent in background, sia ereditato che elencato nel campo `tools`, quindi la stessa definizione può risolvere in strumenti diversi in foreground e background. La rimozione non segnala alcun errore a meno che non lasci l'elenco `tools` [risolvere a nulla](/docs/it/errors#agent-would-be-spawned-with-zero-tools).

454

455Prima di v2.1.280, i subagent in background non potevano utilizzare `LSP`.

446 456

447[`ListAgents`](/docs/it/cross-session-messaging) segue questi filtri come qualsiasi strumento integrato: un subagent in foreground lo eredita nelle sessioni dove la messaggistica tra sessioni è abilitata, e un subagent in background non lo mantiene.457[`ListAgents`](/docs/it/cross-session-messaging) segue questi filtri come qualsiasi strumento integrato: un subagent in foreground lo eredita nelle sessioni dove la messaggistica tra sessioni è abilitata, e un subagent in background non lo mantiene.

448 458

987 997

988La scansione non giudica se il contenuto è dannoso, e non cambia cosa un'istruzione in un rapporto può fare: una chiamata di strumento che il rapporto porta Claude a fare passa comunque attraverso i [controlli di autorizzazione](/docs/it/permissions) della sessione e il [sandboxing](/docs/it/sandboxing). Non è un sostituto per [limitare cosa un subagent può raggiungere](#control-subagent-capabilities).998La scansione non giudica se il contenuto è dannoso, e non cambia cosa un'istruzione in un rapporto può fare: una chiamata di strumento che il rapporto porta Claude a fare passa comunque attraverso i [controlli di autorizzazione](/docs/it/permissions) della sessione e il [sandboxing](/docs/it/sandboxing). Non è un sostituto per [limitare cosa un subagent può raggiungere](#control-subagent-capabilities).

989 999

1000Un rapporto che ritorna a Claude come risultato del subagent arriva anche sotto un'intestazione che lo contrassegna come output del subagent. L'intestazione afferma che le istruzioni o le affermazioni di approvazione all'interno del rapporto sono le parole del subagent e non portano alcuna autorità da lei.

1001

1002Un [rapporto di un subagent in background](#run-subagents-in-foreground-or-background) arriva all'interno di una notifica di completamento, che è contrassegnata come un evento automatizzato piuttosto che un messaggio da lei.

1003

990<Note>1004<Note>

991 La scansione dell'output del subagent richiede Claude Code v2.1.210 o successivo.1005 La scansione dell'output del subagent richiede Claude Code v2.1.210 o successivo.

992</Note>1006</Note>

1076 1090

1077Un subagent annidato è configurato nello stesso modo di uno di livello superiore e si risolve dagli stessi [ambiti](#choose-the-subagent-scope). Per impedire a un subagent di generare mentre l'annidamento è attivo, come un revisore che dovrebbe rimanere di sola lettura, ometta `Agent` dal suo elenco [`tools`](#available-tools) o aggiunga a `disallowedTools`.1091Un subagent annidato è configurato nello stesso modo di uno di livello superiore e si risolve dagli stessi [ambiti](#choose-the-subagent-scope). Per impedire a un subagent di generare mentre l'annidamento è attivo, come un revisore che dovrebbe rimanere di sola lettura, ometta `Agent` dal suo elenco [`tools`](#available-tools) o aggiunga a `disallowedTools`.

1078 1092

1079Claude Code mostra i subagent annidati come un albero nel pannello subagent sotto l'input del prompt e contrassegna ogni riga che ha ancora discendenti nel pannello con un conteggio `(+N)` di loro. Apra una riga per vedere i fratelli e i figli diretti di quel subagent con un percorso di ritorno a `main`.1093Nel terminale, Claude Code mostra i subagent annidati come un albero nel pannello subagent sotto l'input del prompt e contrassegna ogni riga che ha ancora discendenti nel pannello con un conteggio `(+N)` di loro. Apra una riga per vedere i fratelli e i figli diretti di quel subagent con un percorso di ritorno a `main`.

1080 1094

1081<Note>1095<Note>

1082 Le versioni precedenti usavano predefiniti diversi:1096 Le versioni precedenti usavano predefiniti diversi:

terminal-config.md +20 −6

Details

343 Incollare contenuti di grandi dimensioni343 Incollare contenuti di grandi dimensioni

344</h2>344</h2>

345 345

346Quando incollate più di 800 caratteri o più di tre righe nel prompt, Claude Code comprime l'input in un segnaposto come `[Pasted text #1 +120 lines]` in modo che la casella di input rimanga utilizzabile. In una finestra del terminale più corta di 12 righe il limite di righe si riduce, quindi Claude Code comprime un incollamento di tre righe a 11 righe e qualsiasi incollamento multi-riga a 10 righe o meno. Claude Code invia comunque il contenuto completo quando inviate.346Quando incollate più di 800 caratteri o più di tre righe nel prompt, Claude Code comprime l'input in un segnaposto come `[Pasted text #1 +120 lines]` in modo che la casella di input rimanga utilizzabile e invia comunque il contenuto completo quando inviate. Per input molto grandi come interi file o log lunghi, scrivete il contenuto in un file e chiedete a Claude di leggerlo invece di incollare. La trascrizione della conversazione rimane leggibile e Claude può fare riferimento al file per percorso nei turni successivi. Il terminale integrato di VS Code può anche perdere caratteri da incollamenti molto grandi prima che raggiungano Claude Code, quindi utilizzate un file lì.

347 347

348Quando eliminate con una scorciatoia da tastiera di parola o riga come `Ctrl+W` o `Ctrl+K`, o con un'eliminazione vim attraverso un movimento `f`/`t` come `df]`, e l'intervallo eliminato raggiunge l'interno di un segnaposto, Claude Code rimuove il segnaposto completamente. Potete incollare l'eliminazione per ripristinarla, con [`Ctrl+Y`](/docs/it/interactive-mode#text-editing) dopo una scorciatoia da tastiera di parola o riga, o con [`p` in NORMAL mode](/docs/it/interactive-mode#editing-normal-mode) dopo un'eliminazione vim.348Se l'incollamento contiene [caratteri Unicode invisibili](/docs/it/interactive-mode#invisible-characters-in-prompts), Claude Code li rimuove quando premete Invio e rimette il prompt pulito nella casella di input affinché lo inviate con un altro Invio.

349 349

350Claude Code mantiene il contenuto compresso in `~/.claude/paste-cache/`, quindi quando richiamate un prompt dalla [cronologia dei comandi](/docs/it/interactive-mode#command-history) e lo reinviate, Claude Code invia di nuovo il contenuto incollato completo, incluso in una sessione successiva, fino a quando la scansione di conservazione non rimuove il file della cache.350<h3 id="how-claude-treats-pasted-text">

351 Come Claude tratta il testo incollato

352</h3>

353

354Quando inviate, Claude vede il contenuto dietro ogni segnaposto `[Pasted text #N]` contrassegnato come testo che avete incollato da qualche parte piuttosto che digitato. Claude è informato che un incollamento può contenere istruzioni che non avete scritto e deve seguire le istruzioni al suo interno solo dove il messaggio che avete digitato lo chiede. Nelle sessioni che non [recuperano i flag delle funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), gli incollamenti non sono contrassegnati.

351 355

352Claude Code elimina i file della cache più vecchi di [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), seguendo le [regole di scansione di conservazione](/docs/it/claude-directory#cleaned-up-automatically), quindi un prompt richiamato può fare riferimento a testo incollato che non esiste più. Quando inviate un prompt di questo tipo, Claude Code non invia mai la stringa letterale `[Pasted text #N]`, e mostra una notifica che nomina l'incollamento mancante:356<h3 id="delete-and-restore-a-collapsed-paste">

357 Eliminare e ripristinare un incollamento compresso

358</h3>

359

360Quando eliminate con una scorciatoia da tastiera di parola o riga come `Ctrl+W` o `Ctrl+K`, o con un'eliminazione vim attraverso un movimento `f`/`t` come `df]`, e l'intervallo eliminato raggiunge l'interno di un segnaposto `[Pasted text #N]`, Claude Code rimuove il segnaposto completamente. Per ripristinarlo, incollate l'eliminazione con [`Ctrl+Y`](/docs/it/interactive-mode#text-editing) dopo una scorciatoia da tastiera di parola o riga, o con [`p` in NORMAL mode](/docs/it/interactive-mode#editing-normal-mode) dopo un'eliminazione vim.

361

362<h3 id="recall-a-prompt-that-had-pasted-text">

363 Richiamare un prompt che aveva testo incollato

364</h3>

365

366Claude Code mantiene il contenuto dietro ogni segnaposto `[Pasted text #N]` in `~/.claude/paste-cache/`, quindi quando richiamate un prompt dalla [cronologia dei comandi](/docs/it/interactive-mode#command-history) e lo reinviate, il contenuto incollato completo viene inviato di nuovo, incluso in una sessione successiva.

367

368I file della cache più vecchi di [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays) vengono eliminati secondo le [regole di scansione di conservazione](/docs/it/claude-directory#cleaned-up-automatically), quindi un prompt richiamato può fare riferimento a testo incollato che non esiste più. Quando inviate un prompt di questo tipo, Claude Code non invia mai la stringa letterale `[Pasted text #N]` e mostra una notifica che nomina l'incollamento mancante:

353 369

354* In un prompt semplice con testo rimanente, Claude Code rimuove il segnaposto e invia il testo rimanente.370* In un prompt semplice con testo rimanente, Claude Code rimuove il segnaposto e invia il testo rimanente.

355* In un comando [shell mode](/docs/it/interactive-mode#shell-mode-with-prefix) o in un comando `/`, dove la rimozione cambierebbe ciò che viene eseguito, e in qualsiasi prompt la cui rimozione lascia vuoto, Claude Code annulla l'invio e mantiene il testo originale nell'input, con il segnaposto ancora in esso. Eliminate il segnaposto o modificate il comando, quindi reinviate.371* In un comando [shell mode](/docs/it/interactive-mode#shell-mode-with-prefix) o in un comando `/`, dove la rimozione cambierebbe ciò che viene eseguito, e in qualsiasi prompt la cui rimozione lascia vuoto, Claude Code annulla l'invio e mantiene il testo originale nell'input, con il segnaposto ancora in esso. Eliminate il segnaposto o modificate il comando, quindi reinviate.

356 372

357Il terminale integrato di VS Code può perdere caratteri da incollamenti molto grandi prima che raggiungano Claude Code, quindi preferite flussi di lavoro basati su file lì. Per input molto grandi come interi file o log lunghi, scrivete il contenuto in un file e chiedete a Claude di leggerlo invece di incollare. Questo mantiene la trascrizione della conversazione leggibile e consente a Claude di fare riferimento al file per percorso nei turni successivi.

~~358~~

359<h2 id="edit-prompts-with-vim-keybindings">373<h2 id="edit-prompts-with-vim-keybindings">

360 Modificare i prompt con le scorciatoie da tastiera di Vim374 Modificare i prompt con le scorciatoie da tastiera di Vim

361</h2>375</h2>

third-party-integrations.md +4 −4

Details

86 86

87Per la maggior parte delle organizzazioni, Claude for Teams o Claude for Enterprise offre la migliore esperienza. I membri del team ottengono accesso sia a Claude Code che a Claude sul web con un'unica sottoscrizione, fatturazione centralizzata e nessuna configurazione dell'infrastruttura richiesta.87Per la maggior parte delle organizzazioni, Claude for Teams o Claude for Enterprise offre la migliore esperienza. I membri del team ottengono accesso sia a Claude Code che a Claude sul web con un'unica sottoscrizione, fatturazione centralizzata e nessuna configurazione dell'infrastruttura richiesta.

88 88

89**Claude for Teams** è self-service e include funzionalità di collaborazione, strumenti di amministrazione e gestione della fatturazione. Ideale per team più piccoli che hanno bisogno di iniziare rapidamente.89**Claude for Teams** è self-service e include funzionalità di collaborazione, strumenti di amministrazione, SSO, gestione della fatturazione e [impostazioni gestite dal server](/docs/it/server-managed-settings) per la configurazione di Claude Code a livello organizzativo. Ideale per team più piccoli che hanno bisogno di iniziare rapidamente.

90 90

91**Claude for Enterprise** aggiunge SSO e domain capture, autorizzazioni basate sui ruoli, accesso all'API di conformità e impostazioni di policy gestite per la distribuzione di configurazioni Claude Code a livello organizzativo. Ideale per organizzazioni più grandi con requisiti di sicurezza e conformità.91**Claude for Enterprise** aggiunge domain capture, autorizzazioni basate sui ruoli e accesso all'API di conformità. Ideale per organizzazioni più grandi con requisiti di sicurezza e conformità.

92 92

93Scopri di più su [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) e [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).93Scopri di più su [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) e [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

94 94

95Le opzioni di distribuzione confrontate di seguito riguardano dove viene eseguita l'inferenza del modello. Per eseguire sessioni di [Claude Code sul web](/docs/it/claude-code-on-the-web) su risorse di calcolo gestite dalla tua organizzazione, vedi [ambienti self-hosted](/docs/it/self-hosted-environments).95Le opzioni di distribuzione confrontate di seguito riguardano dove viene eseguita l'inferenza del modello. Per eseguire [sessioni cloud](/docs/it/claude-code-on-the-web) di Claude Code su risorse di calcolo gestite dalla tua organizzazione, vedi [ambienti self-hosted](/docs/it/self-hosted-environments).

96 96

97Se la tua organizzazione ha requisiti infrastrutturali specifici, confronta le opzioni di seguito:97Se la tua organizzazione ha requisiti infrastrutturali specifici, confronta le opzioni di seguito:

98 98

152 152

153 <tr>153 <tr>

154 <td>Autenticazione</td>154 <td>Autenticazione</td>

155 <td>Claude.ai SSO o email</td>155 <td>claude.ai SSO o email</td>

156 <td>API key o [accesso Console senza API key](/docs/it/authentication#sign-in-without-an-api-key)</td>156 <td>API key o [accesso Console senza API key](/docs/it/authentication#sign-in-without-an-api-key)</td>

157 <td>API key o credenziali AWS</td>157 <td>API key o credenziali AWS</td>

158 <td>API key o credenziali AWS</td>158 <td>API key o credenziali AWS</td>

troubleshoot-install.md +119 −119

Details

24| `Raw mode is not supported` durante l'installazione | [Riesegui il programma di installazione](#raw-mode-is-not-supported-during-install) |24| `Raw mode is not supported` durante l'installazione | [Riesegui il programma di installazione](#raw-mode-is-not-supported-during-install) |

26| `Failed to fetch version` o impossibile raggiungere il server di download | [Controlla le impostazioni di rete e proxy](#check-network-connectivity) |26| `Failed to fetch version` o impossibile raggiungere il server di download | [Controlla le impostazioni di rete e proxy](#check-network-connectivity) |

27| `irm is not recognized` o `&& is not valid` | [Usa il comando giusto per la tua shell](#wrong-install-command-on-windows) |27| `irm is not recognized` o `The token '&&' is not a valid statement separator` | [Usa il comando giusto per la tua shell](#wrong-install-command-on-windows) |

28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Aggiorna Homebrew](#homebrew-cask-unavailable-or-outdated) |28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Aggiorna Homebrew](#homebrew-cask-unavailable-or-outdated) |

29| `'bash' is not recognized as the name of a cmdlet` | [Usa il comando del programma di installazione di Windows](#wrong-install-command-on-windows) |29| `'bash' is not recognized as the name of a cmdlet` | [Usa il comando del programma di installazione di Windows](#wrong-install-command-on-windows) |

30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Usa il comando del programma di installazione di Windows](#wrong-install-command-on-windows) |30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Usa il comando del programma di installazione di Windows](#wrong-install-command-on-windows) |

337```337```

338 338

339<h2 id="common-installation-issues">339<h2 id="common-installation-issues">

340 Problemi di installazione comuni340 Problemi comuni di installazione

341</h2>341</h2>

342 342

343Questi sono i problemi di installazione più frequentemente riscontrati e le loro soluzioni.343Questi sono i problemi di installazione più frequentemente riscontrati e le loro soluzioni.

346 Lo script di installazione restituisce HTML invece di uno script shell346 Lo script di installazione restituisce HTML invece di uno script shell

347</h3>347</h3>

348 348

349Quando esegui il comando di installazione, potresti vedere uno di questi errori:349Quando si esegue il comando di installazione, è possibile che si veda uno di questi errori:

350 350

351```text theme={null}351```text theme={null}

352bash: line 1: syntax error near unexpected token `<'352bash: line 1: syntax error near unexpected token `<'

362...362...

363```363```

364 364

365La formulazione varia a seconda della versione di PowerShell e della lingua del sistema: potresti vedere `Missing expression after unary operator '--'` o un `ParserError` con `ParseException` invece. I tag HTML o CSS nel testo tra virgolette identificano questo errore. Se scarichi con `-OutFile install.ps1` invece, il file salvato è la stessa pagina web, quindi nemmeno questo aiuta.365La formulazione varia a seconda della versione di PowerShell e della lingua del sistema: è possibile che si veda `Missing expression after unary operator '--'` o un `ParserError` con `ParseException`. I tag HTML o CSS nel testo tra virgolette identificano questo errore. Se si scarica con `-OutFile install.ps1`, il file salvato è la stessa pagina web, quindi nemmeno questo aiuta.

366 366

367A seconda di come la richiesta è stata instradata, potresti invece vedere un 403 senza corpo HTML:367A seconda di come è stata instradata la richiesta, è possibile che si veda invece un 403 senza corpo HTML:

368 368

369```text theme={null}369```text theme={null}

370curl: (22) The requested URL returned error: 403370curl: (22) The requested URL returned error: 403

371```371```

372 372

373Tutti questi significano che l'URL di installazione ha restituito una pagina HTML o uno stato di errore invece dello script di installazione. Se la pagina HTML dice "App unavailable in region," Claude Code non è disponibile nel tuo paese. Vedi [paesi supportati](https://www.anthropic.com/supported-countries).373Tutti questi significano che l'URL di installazione ha restituito una pagina HTML o uno stato di errore invece dello script di installazione. Se la pagina HTML dice "App unavailable in region", Claude Code non è disponibile nel vostro paese. Vedere [paesi supportati](https://www.anthropic.com/supported-countries).

374 374

375Un 403 nudo senza corpo spesso ha la stessa causa, ma può anche provenire da un proxy aziendale o da un firewall che blocca il download. Se sei in un paese supportato e vedi ancora il 403, esamina [Controlla la connettività di rete](#check-network-connectivity) prima di provare i programmi di installazione alternativi di seguito, poiché quelli raggiungono gli stessi host.375Un 403 nudo senza corpo spesso ha la stessa causa, ma può anche provenire da un proxy aziendale o da un firewall che blocca il download. Se siete in un paese supportato e vedete ancora il 403, consultate [Verificare la connettività di rete](#check-network-connectivity) prima di provare i programmi di installazione alternativi di seguito, poiché raggiungono gli stessi host.

376 376

377Altrimenti, questo può accadere a causa di problemi di rete, routing regionale, o un'interruzione temporanea del servizio.377Altrimenti, questo può accadere a causa di problemi di rete, routing regionale o un'interruzione temporanea del servizio.

378 378

379**Soluzioni:**379**Soluzioni:**

380 380

3811. **Usa un metodo di installazione alternativo**:3811. **Utilizzare un metodo di installazione alternativo**:

382 382

383 Su macOS, installa tramite Homebrew:383 Su macOS, installare tramite Homebrew:

384 384

385 ```bash theme={null}385 ```bash theme={null}

386 brew install --cask claude-code386 brew install --cask claude-code

387 ```387 ```

388 388

389 Su Windows, installa tramite WinGet:389 Su Windows, installare tramite WinGet:

390 390

391 ```powershell theme={null}391 ```powershell theme={null}

392 winget install Anthropic.ClaudeCode392 winget install Anthropic.ClaudeCode

393 ```393 ```

394 394

395 Quindi esegui `claude --version` per confermare: il comando stampa un numero di versione come `2.1.211 (Claude Code)`. Se la shell segnala che `claude` non è trovato, apri una nuova finestra di terminale e riprova: la sessione da cui hai installato mantiene il vecchio `PATH`.395 Quindi eseguire `claude --version` per confermare: il comando stampa un numero di versione come `2.1.211 (Claude Code)`. Se la shell segnala che `claude` non è trovato, aprire una nuova finestra del terminale e riprovare: la sessione da cui avete installato mantiene il vecchio `PATH`.

396 396

3972. **Riprova dopo alcuni minuti**: il problema è spesso temporaneo. Aspetta e prova di nuovo il comando originale.3972. **Riprovare dopo alcuni minuti**: il problema è spesso temporaneo. Attendere e riprovare il comando originale.

398 398

399<h3 id="command-not-found-claude-after-installation">399<h3 id="command-not-found-claude-after-installation">

400 `command not found: claude` dopo l'installazione400 `command not found: claude` dopo l'installazione

401</h3>401</h3>

402 402

403L'installazione è terminata ma `claude` non funziona. L'errore esatto varia in base alla piattaforma:403L'installazione è terminata ma `claude` non funziona. L'errore esatto varia a seconda della piattaforma:

404 404

405| Piattaforma | Messaggio di errore |405| Piattaforma | Messaggio di errore |

406| :---------- | :--------------------------------------------------------------------- |406| :---------- | :--------------------------------------------------------------------- |

411 411

412Questo significa che la directory di installazione non è nel percorso di ricerca della tua shell. Vedi [Verifica il tuo PATH](#verify-your-path) per la correzione su ogni piattaforma.412Questo significa che la directory di installazione non è nel percorso di ricerca della shell. Vedere [Verificare il vostro PATH](#verify-your-path) per la correzione su ogni piattaforma.

413 413

414<h3 id="curl-56-failure-writing-output-to-destination">414<h3 id="curl-56-failure-writing-output-to-destination">

415 `curl: (56) Failure writing output to destination`415 `curl: (56) Failure writing output to destination`

416</h3>416</h3>

417 417

418Il comando `curl ... | bash` scarica lo script e lo invia a Bash per l'esecuzione. Questo errore, e l'errore correlato `curl: (23) Failure writing output to destination`, significa che Bash non ha ricevuto lo script completo. Il codice di uscita 56 indica che il download stesso è stato interrotto, e il codice di uscita 23 indica che curl non ha potuto scrivere quello che ha ricevuto al pipe, di solito perché Bash è uscito anticipatamente.418Il comando `curl ... | bash` scarica lo script e lo invia a Bash per l'esecuzione. Questo errore, e il correlato `curl: (23) Failure writing output to destination`, significa che Bash non ha ricevuto lo script completo. Il codice di uscita 56 indica che il download stesso è stato interrotto, e il codice di uscita 23 indica che curl non poteva scrivere ciò che ha ricevuto alla pipe, solitamente perché Bash è uscito prematuramente.

419 419

420Testa che puoi raggiungere `downloads.claude.ai` con il controllo in [Controlla la connettività di rete](#check-network-connectivity). Se hai raggiunto il server, il fallimento originale era probabilmente intermittente; riprova il comando di installazione. Puoi anche [provare un metodo di installazione alternativo](/docs/it/setup#install-claude-code).420Verificare che sia possibile raggiungere `downloads.claude.ai` con il controllo in [Verificare la connettività di rete](#check-network-connectivity). Se avete raggiunto il server, il fallimento originale era probabilmente intermittente; riprovare il comando di installazione. Potete anche [provare un metodo di installazione alternativo](/docs/it/setup#install-claude-code).

421 421

422<h3 id="homebrew-cask-unavailable-or-outdated">422<h3 id="homebrew-cask-unavailable-or-outdated">

423 Cask Homebrew non disponibile o obsoleto423 Cask Homebrew non disponibile o obsoleto

424</h3>424</h3>

425 425

426Homebrew segnala `Error: Cask 'claude-code' is unavailable: No Cask with this name exists` quando la tua copia locale dell'indice cask di Homebrew è precedente alla pubblicazione del cask. Aggiorna l'indice e riprova:426Homebrew segnala `Error: Cask 'claude-code' is unavailable: No Cask with this name exists` quando la copia locale dell'indice cask di Homebrew è precedente alla pubblicazione del cask. Aggiornare l'indice e riprovare:

427 427

428```bash theme={null}428```bash theme={null}

429brew update429brew update

430brew install --cask claude-code430brew install --cask claude-code

431```431```

432 432

433Se Homebrew installa una versione di Claude Code più vecchia di quella che ti aspetti, di solito la stessa causa è l'indice obsoleto. Il cask `claude-code` traccia il canale stabile ed è in genere circa una settimana dietro l'ultima versione; per la versione più recente esegui `brew install --cask claude-code@latest` invece. Vedi [Configura il canale di rilascio](/docs/it/setup#configure-release-channel) per la differenza tra i due cask.433Se Homebrew installa una versione di Claude Code più vecchia di quella prevista, lo stesso indice obsoleto è solitamente la causa. Il cask `claude-code` traccia il canale stabile ed è tipicamente circa una settimana dietro l'ultima versione; per la versione più recente eseguire `brew install --cask claude-code@latest`. Vedere [Configurare il canale di rilascio](/docs/it/setup#configure-release-channel) per la differenza tra i due cask.

434 434

435<h3 id="tls-or-ssl-connection-errors">435<h3 id="tls-or-ssl-connection-errors">

436 Errori di connessione TLS o SSL436 Errori di connessione TLS o SSL

440 440

441**Soluzioni:**441**Soluzioni:**

442 442

4431. **Aggiorna i certificati CA del tuo sistema**:4431. **Aggiornare i certificati CA del sistema**:

444 444

445 Su Ubuntu/Debian:445 Su Ubuntu/Debian:

446 446

450 450

451 Su macOS, il curl di sistema utilizza l'archivio di fiducia Keychain; l'aggiornamento di macOS stesso aggiorna i certificati root.451 Su macOS, il curl di sistema utilizza l'archivio di fiducia Keychain; l'aggiornamento di macOS stesso aggiorna i certificati root.

452 452

4532. **Su Windows, abilita TLS 1.2** in PowerShell prima di eseguire il programma di installazione:4532. **Su Windows, abilitare TLS 1.2** in PowerShell prima di eseguire il programma di installazione:

454 ```powershell theme={null}454 ```powershell theme={null}

455 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12455 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

456 irm https://claude.ai/install.ps1 | iex456 irm https://claude.ai/install.ps1 | iex

457 ```457 ```

458 458

4593. **Controlla l'interferenza del proxy o del firewall**: i proxy aziendali che eseguono l'ispezione TLS possono causare questi errori, inclusi `unable to get local issuer certificate` e `SELF_SIGNED_CERT_IN_CHAIN`. Per il passaggio di installazione, fai in modo che il download di installazione si fidi del CA aziendale:4593. **Verificare l'interferenza di proxy o firewall**: i proxy aziendali che eseguono l'ispezione TLS possono causare questi errori, inclusi `unable to get local issuer certificate` e `SELF_SIGNED_CERT_IN_CHAIN`. Per il passaggio di installazione, fare in modo che il download di installazione si fidi del CA del proxy aziendale:

460 460

461 <Tabs>461 <Tabs>

462 <Tab title="macOS/Linux">462 <Tab title="macOS/Linux">

466 </Tab>466 </Tab>

467 467

468 <Tab title="Windows PowerShell">468 <Tab title="Windows PowerShell">

469 Il programma di installazione PowerShell scarica tramite .NET, che convalida TLS rispetto all'archivio certificati di Windows. Chiedi al tuo team IT di aggiungere il certificato CA del proxy all'archivio di Windows se non è già lì, quindi esegui il programma di installazione:469 Il programma di installazione PowerShell scarica tramite .NET, che convalida TLS rispetto all'archivio certificati di Windows. Chiedere al team IT di aggiungere il certificato CA del proxy all'archivio di Windows se non è già presente, quindi eseguire il programma di installazione:

470 470

471 ```powershell theme={null}471 ```powershell theme={null}

472 irm https://claude.ai/install.ps1 | iex472 irm https://claude.ai/install.ps1 | iex

474 </Tab>474 </Tab>

475 </Tabs>475 </Tabs>

476 476

477 Per Claude Code stesso una volta installato, imposta `NODE_EXTRA_CA_CERTS` in modo che le richieste API si fidino dello stesso bundle:477 Per Claude Code stesso una volta installato, impostare `NODE_EXTRA_CA_CERTS` in modo che le richieste API si fidino dello stesso bundle:

478 478

479 <Tabs>479 <Tabs>

480 <Tab title="macOS/Linux">480 <Tab title="macOS/Linux">

490 </Tab>490 </Tab>

491 </Tabs>491 </Tabs>

492 492

493 Chiedi al tuo team IT il file di certificato se non lo hai. Puoi anche provare su una connessione diretta per confermare che il proxy è la causa.493 Chiedere al team IT il file del certificato se non lo avete. Potete anche provare su una connessione diretta per confermare che il proxy è la causa.

494 494

4954. **Su Windows, aggira i controlli di revoca bloccati**. Gli errori `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` e `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` significano che curl ha raggiunto il server ma la tua rete blocca la ricerca di revoca del certificato, che è comune dietro firewall aziendali. Se il comando che fallisce è il `curl` che scarica `install.cmd`, rieseguilo da un Prompt dei comandi con `--ssl-revoke-best-effort` aggiunto:4954. **Su Windows, aggirare i controlli di revoca bloccati**. Gli errori `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` e `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` significano che curl ha raggiunto il server ma la vostra rete blocca la ricerca di revoca del certificato, il che è comune dietro i firewall aziendali. Se il comando che fallisce è il `curl` che scarica `install.cmd`, rieseguirlo da un Command Prompt con `--ssl-revoke-best-effort` aggiunto:

496 ```batch theme={null}496 ```batch theme={null}

497 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd497 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

498 ```498 ```

499 Quando i download dello script stesso colpiscono gli stessi errori, li ritenta con il controllo di revoca best-effort automaticamente, quindi il flag è necessario solo sul comando che esegui tu stesso. Il controllo best-effort tollera un server di revoca irraggiungibile ma rifiuta comunque un certificato che è noto essere revocato, corrispondendo a come i browser gestiscono la revoca. Puoi anche evitare completamente il controllo di revoca di curl eseguendo il programma di installazione PowerShell da PowerShell, che scarica tramite .NET e non fallisce quando il server di revoca è irraggiungibile:499 Quando i download dello script stesso colpiscono gli stessi errori, li ritenta con il controllo di revoca best-effort automaticamente, quindi il flag è necessario solo sul comando che eseguite voi stessi. Il controllo best-effort tollera un server di revoca irraggiungibile ma rifiuta comunque un certificato che è noto essere revocato, corrispondendo a come i browser gestiscono la revoca. Potete anche evitare completamente il controllo di revoca di curl eseguendo il programma di installazione PowerShell da PowerShell, che scarica tramite .NET e non fallisce quando il server di revoca è irraggiungibile:

500 ```powershell theme={null}500 ```powershell theme={null}

501 irm https://claude.ai/install.ps1 | iex501 irm https://claude.ai/install.ps1 | iex

502 ```502 ```

503 Puoi anche installare con `winget install Anthropic.ClaudeCode`, che evita curl completamente.503 Potete anche installare con `winget install Anthropic.ClaudeCode`, che evita curl completamente.

504 504

505<h3 id="failed-to-fetch-version-from-downloads-claude-ai">505<h3 id="failed-to-fetch-version-from-downloads-claude-ai">

506 `Failed to fetch version from downloads.claude.ai`506 `Failed to fetch version from downloads.claude.ai`

507</h3>507</h3>

508 508

509Il programma di installazione non ha potuto raggiungere il server di download. Questo in genere significa che `downloads.claude.ai` è bloccato sulla tua rete. Vedi [Controlla la connettività di rete](#check-network-connectivity).509Il programma di installazione non poteva raggiungere il server di download. Questo tipicamente significa che `downloads.claude.ai` è bloccato sulla vostra rete. Vedere [Verificare la connettività di rete](#check-network-connectivity).

510 510

511<h3 id="wrong-install-command-on-windows">511<h3 id="wrong-install-command-on-windows">

512 Comando di installazione sbagliato su Windows512 Comando di installazione errato su Windows

513</h3>513</h3>

514 514

515Se vedi `'irm' is not recognized`, `The token '&&' is not valid`, `A parameter cannot be found that matches parameter name 'fsSL'`, o `'bash' is not recognized as the name of a cmdlet`, hai copiato il comando di installazione per una shell o un sistema operativo diverso. Se il comando stampa il testo dello script invece di installare qualcosa, hai eseguito solo parte di esso.515Se vedete `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'`, o `'bash' is not recognized as the name of a cmdlet`, avete copiato il comando di installazione per una shell o un sistema operativo diverso. Se il comando stampa il testo dello script invece di installare qualcosa, avete eseguito solo una parte di esso.

516 516

517* **`irm` non riconosciuto**: sei in CMD, non PowerShell. Hai due opzioni:517* **`irm` non riconosciuto**: siete in CMD, non in PowerShell. Avete due opzioni:

518 518

519 Apri PowerShell cercando "PowerShell" nel menu Start, quindi esegui il comando di installazione originale:519 Aprire PowerShell cercando "PowerShell" nel menu Start, quindi eseguire il comando di installazione originale:

520 520

521 ```powershell theme={null}521 ```powershell theme={null}

522 irm https://claude.ai/install.ps1 | iex522 irm https://claude.ai/install.ps1 | iex

523 ```523 ```

524 524

525 Oppure rimani in CMD e usa il programma di installazione CMD invece:525 Oppure rimanere in CMD e utilizzare il programma di installazione CMD:

526 526

527 ```batch theme={null}527 ```batch theme={null}

528 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd528 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

529 ```529 ```

530 530

531* **`&&` non valido**: sei in PowerShell ma hai eseguito il comando del programma di installazione CMD. Usa il programma di installazione PowerShell:531* **`&&` non è un separatore di istruzioni valido**: siete in PowerShell ma avete eseguito il comando del programma di installazione CMD. Utilizzare il programma di installazione PowerShell:

532 ```powershell theme={null}532 ```powershell theme={null}

533 irm https://claude.ai/install.ps1 | iex533 irm https://claude.ai/install.ps1 | iex

534 ```534 ```

535 535

536* **`A parameter cannot be found that matches parameter name 'fsSL'`**: hai eseguito il programma di installazione macOS/Linux `curl -fsSL ... | bash` in Windows PowerShell, dove `curl` è un alias per `Invoke-WebRequest` e rifiuta i flag `-fsSL`. Usa il programma di installazione PowerShell invece:536* **`A parameter cannot be found that matches parameter name 'fsSL'`**: avete eseguito il programma di installazione `curl -fsSL ... | bash` di macOS/Linux in Windows PowerShell, dove `curl` è un alias per `Invoke-WebRequest` e rifiuta i flag `-fsSL`. Utilizzare il programma di installazione PowerShell:

537 ```powershell theme={null}537 ```powershell theme={null}

538 irm https://claude.ai/install.ps1 | iex538 irm https://claude.ai/install.ps1 | iex

539 ```539 ```

540 540

541* **`bash` non riconosciuto**: hai eseguito il programma di installazione macOS/Linux su Windows. Usa il programma di installazione PowerShell invece:541* **`bash` non riconosciuto**: avete eseguito il programma di installazione di macOS/Linux su Windows. Utilizzare il programma di installazione PowerShell:

542 ```powershell theme={null}542 ```powershell theme={null}

543 irm https://claude.ai/install.ps1 | iex543 irm https://claude.ai/install.ps1 | iex

544 ```544 ```

545 545

546* **Il comando stampa il testo dello script invece di installare**: hai eseguito la metà del download del comando senza la parte che lo esegue. `irm https://claude.ai/install.ps1` da solo stampa lo script scaricato al terminale. Invialo a `iex` per eseguirlo:546* **Il comando stampa il testo dello script invece di installare**: avete eseguito la metà del download del comando senza la parte che lo esegue. `irm https://claude.ai/install.ps1` da solo stampa lo script scaricato al terminale. Inviarlo a `iex` per eseguirlo:

547 547

548 ```powershell theme={null}548 ```powershell theme={null}

549 irm https://claude.ai/install.ps1 | iex549 irm https://claude.ai/install.ps1 | iex

550 ```550 ```

551 551

552 In CMD, `curl -fsSL https://claude.ai/install.cmd` senza `-o` stampa lo script batch invece di salvarlo. Esegui il comando completo:552 In CMD, `curl -fsSL https://claude.ai/install.cmd` senza `-o` stampa lo script batch invece di salvarlo. Eseguire il comando completo:

553 553

554 ```batch theme={null}554 ```batch theme={null}

555 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd555 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

556 ```556 ```

557 557

558Qualunque programma di installazione usi, conferma che ha funzionato: apri un nuovo terminale ed esegui `claude --version`, che stampa un numero di versione come `2.1.211 (Claude Code)`.558Qualunque programma di installazione utilizziate, confermare che ha funzionato: aprire un nuovo terminale ed eseguire `claude --version`, che stampa un numero di versione come `2.1.211 (Claude Code)`.

559 559

560<h3 id="running-scripts-is-disabled-on-this-system">560<h3 id="running-scripts-is-disabled-on-this-system">

561 `running scripts is disabled on this system`561 `running scripts is disabled on this system`

569 + CategoryInfo : SecurityError: (:) [], PSSecurityException569 + CategoryInfo : SecurityError: (:) [], PSSecurityException

570```570```

571 571

572Lo stesso errore nomina `claude.ps1` quando esegui `claude` dopo un'installazione npm. La politica di esecuzione di PowerShell sta bloccando gli script launcher `.ps1` che npm crea per i suoi comandi. La politica si applica ai file di script, quindi non influisce sul programma di installazione PowerShell `irm https://claude.ai/install.ps1 | iex`, che esegue il testo scaricato direttamente.572Lo stesso errore nomina `claude.ps1` quando eseguite `claude` dopo un'installazione npm. La politica di esecuzione di PowerShell sta bloccando gli script launcher `.ps1` che npm crea per i suoi comandi. La politica si applica ai file di script, quindi non influisce sul programma di installazione PowerShell `irm https://claude.ai/install.ps1 | iex`, che esegue il testo scaricato direttamente.

573 573

574**Soluzioni:**574**Soluzioni:**

575 575

5761. **Consenti gli script creati localmente per il tuo utente**, quindi riprova:5761. **Consentire gli script creati localmente per il vostro utente**, quindi riprovare:

577 ```powershell theme={null}577 ```powershell theme={null}

578 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser578 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

579 ```579 ```

5802. **Chiama il launcher `.cmd` invece**: `npm.cmd` e `claude.cmd` fanno lo stesso lavoro, e la politica non li copre.5802. **Chiamare il launcher `.cmd`**: `npm.cmd` e `claude.cmd` fanno lo stesso lavoro, e la politica non li copre.

5813. **Usa il [programma di installazione PowerShell](/docs/it/setup#install-claude-code)** invece di npm. Installa un binario piuttosto che uno script `.ps1`.5813. **Utilizzare il [programma di installazione PowerShell](/docs/it/setup#install-claude-code)** invece di npm. Installa un binario piuttosto che uno script `.ps1`.

582 582

583<h3 id="the-process-cannot-access-the-file-during-windows-install">583<h3 id="the-process-cannot-access-the-file-during-windows-install">

584 `The process cannot access the file` durante l'installazione su Windows584 `The process cannot access the file` durante l'installazione su Windows

585</h3>585</h3>

586 586

587Se il programma di installazione PowerShell non riesce con `Failed to download binary: The process cannot access the file ... because it is being used by another process`, il programma di installazione non ha potuto scrivere in `%USERPROFILE%\.claude\downloads`. Questo di solito significa che un tentativo di installazione precedente è ancora in esecuzione, o il software antivirus sta scansionando un binario parzialmente scaricato in quella cartella.587Se il programma di installazione PowerShell fallisce con `Failed to download binary: The process cannot access the file ... because it is being used by another process`, il programma di installazione non poteva scrivere in `%USERPROFILE%\.claude\downloads`. Questo solitamente significa che un tentativo di installazione precedente è ancora in esecuzione, o il software antivirus sta scansionando un binario parzialmente scaricato in quella cartella.

588 588

589Chiudi tutte le altre finestre di PowerShell che eseguono il programma di installazione e aspetta che le scansioni antivirus rilascino il file. Quindi elimina la cartella dei download e esegui di nuovo il programma di installazione:589Chiudere qualsiasi altra finestra PowerShell che esegue il programma di installazione e attendere che le scansioni antivirus rilascino il file. Quindi eliminare la cartella dei download ed eseguire di nuovo il programma di installazione:

590 590

591```powershell theme={null}591```powershell theme={null}

592Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"592Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"

594```594```

595 595

596<h3 id="install-killed-on-low-memory-linux-servers">596<h3 id="install-killed-on-low-memory-linux-servers">

597 L'installazione viene interrotta su server Linux a bassa memoria597 Installazione interrotta su server Linux con poca memoria

598</h3>598</h3>

599 599

600Un messaggio `Killed` durante l'installazione di solito significa che il killer OOM (out-of-memory) di Linux ha terminato il passaggio `claude install` perché il sistema ha esaurito la memoria libera. Questo è comune su piccoli VPS e istanze cloud. Lo script di installazione segnala la causa e esce con codice 137. In questo esempio, il numero di riga e l'ID del processo variano in base alla versione e all'esecuzione:600Un messaggio `Killed` durante l'installazione solitamente significa che il killer out-of-memory (OOM) di Linux ha terminato il passaggio `claude install` perché il sistema ha esaurito la memoria libera. Questo è comune su piccoli VPS e istanze cloud. Lo script di installazione segnala la causa e esce con il codice 137. In questo esempio, il numero di riga e l'ID del processo variano a seconda della versione e dell'esecuzione:

601 601

602```text theme={null}602```text theme={null}

603Setting up Claude Code...603Setting up Claude Code...

606Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.606Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

607```607```

608 608

609L'installazione richiede approssimativamente 512 MB di memoria libera, e l'esecuzione di Claude Code ne richiede di più. Vedi i [requisiti di sistema](/docs/it/setup#system-requirements).609L'installazione ha bisogno di circa 512 MB di memoria libera, e l'esecuzione di Claude Code ne ha bisogno di più. Vedere i [requisiti di sistema](/docs/it/setup#system-requirements).

610 610

611**Soluzioni:**611**Soluzioni:**

612 612

6131. **Aggiungi spazio di swap** se il tuo server ha RAM limitata. Lo swap utilizza lo spazio su disco come memoria di overflow, consentendo al programma di installazione di completarsi anche con RAM fisica bassa.6131. **Aggiungere spazio di swap** se il vostro server ha RAM limitata. Lo swap utilizza lo spazio su disco come memoria di overflow, permettendo all'installazione di completarsi anche con poca RAM fisica.

614 614

615 Crea un file di swap da 2 GB e abilitalo:615 Creare un file di swap di 2 GB e abilitarlo:

616 616

617 ```bash theme={null}617 ```bash theme={null}

618 sudo fallocate -l 2G /swapfile618 sudo fallocate -l 2G /swapfile

621 sudo swapon /swapfile621 sudo swapon /swapfile

622 ```622 ```

623 623

624 Quindi riprova l'installazione:624 Quindi riprovare l'installazione:

625 625

626 ```bash theme={null}626 ```bash theme={null}

627 curl -fsSL https://claude.ai/install.sh | bash627 curl -fsSL https://claude.ai/install.sh | bash

628 ```628 ```

629 629

6302. **Chiudi altri processi** per liberare memoria prima di installare.6302. **Chiudere altri processi** per liberare memoria prima di installare.

631 631

6323. **Usa un'istanza più grande** se possibile. Claude Code richiede almeno 4 GB di RAM.6323. **Utilizzare un'istanza più grande** se possibile. Claude Code richiede almeno 4 GB di RAM.

633 633

634<h3 id="install-hangs-in-docker">634<h3 id="install-hangs-in-docker">

635 L'installazione si blocca in Docker635 L'installazione si blocca in Docker

636</h3>636</h3>

637 637

638Quando installi Claude Code in un contenitore Docker, l'installazione come root in `/` può causare blocchi.638Quando si installa Claude Code in un contenitore Docker, l'installazione come root in `/` può causare blocchi.

639 639

640**Soluzioni:**640**Soluzioni:**

641 641

6421. **Imposta una directory di lavoro** prima di eseguire il programma di installazione. Quando eseguito da `/`, il programma di installazione scansiona l'intero filesystem, il che causa un utilizzo eccessivo della memoria. L'impostazione di `WORKDIR` limita la scansione a una piccola directory:6421. **Impostare una directory di lavoro** prima di eseguire il programma di installazione. Quando eseguito da `/`, il programma di installazione scansiona l'intero filesystem, il che causa un utilizzo eccessivo della memoria. L'impostazione di `WORKDIR` limita la scansione a una piccola directory:

643 ```dockerfile theme={null}643 ```dockerfile theme={null}

644 WORKDIR /tmp644 WORKDIR /tmp

645 RUN curl -fsSL https://claude.ai/install.sh | bash645 RUN curl -fsSL https://claude.ai/install.sh | bash

646 ```646 ```

647 647

6482. **Dai a Docker più memoria** se usi Docker Desktop. I contenitori di build condividono la memoria allocata alla macchina virtuale Docker Desktop, quindi apri **Settings > Resources** in Docker Desktop, aumenta il limite di memoria, e riesegui la build.6482. **Dare a Docker più memoria** se si utilizza Docker Desktop. I contenitori di build condividono la memoria allocata alla macchina virtuale Docker Desktop, quindi aprire **Settings > Resources** in Docker Desktop, aumentare il limite di memoria e rieseguire la build.

649 649

650<h3 id="raw-mode-is-not-supported-during-install">650<h3 id="raw-mode-is-not-supported-during-install">

651 `Raw mode is not supported` durante l'installazione651 `Raw mode is not supported` durante l'installazione

652</h3>652</h3>

653 653

654Quando le [impostazioni gestite dal server](/docs/it/server-managed-settings) della tua organizzazione includono modifiche che necessitano di [approvazione di sicurezza](/docs/it/server-managed-settings#security-approval-dialogs), le versioni di Claude Code precedenti a 2.1.246 tentano di mostrare la finestra di dialogo di approvazione durante `claude install`. La finestra di dialogo ha bisogno di un terminale su stdin. Quando il programma di installazione esegue `claude install` da un pipe, come fa `curl -fsSL https://claude.ai/install.sh | bash`, stdin è il pipe piuttosto che un terminale, quindi l'installazione fallisce con un errore contenente `Raw mode is not supported`.654Quando le [impostazioni gestite dal server](/docs/it/server-managed-settings) della vostra organizzazione includono modifiche che necessitano di [approvazione di sicurezza](/docs/it/server-managed-settings#security-approval-dialogs), le versioni di Claude Code precedenti a 2.1.246 tentano di mostrare la finestra di dialogo di approvazione durante `claude install`. La finestra di dialogo ha bisogno di un terminale su stdin. Quando il programma di installazione esegue `claude install` da una pipe, come fa `curl -fsSL https://claude.ai/install.sh | bash`, stdin è la pipe piuttosto che un terminale, quindi l'installazione fallisce con un errore contenente `Raw mode is not supported`.

655 655

656Claude Code v2.1.246 e versioni successive non mostrano la finestra di dialogo durante `claude install` o `claude update`. Il comando viene eseguito con le impostazioni che hai approvato l'ultima volta, e Claude Code mostra la finestra di dialogo nella tua prossima sessione interattiva. Se la configurazione di avvio della tua organizzazione [attende il recupero delle impostazioni](/docs/it/server-managed-settings#enforce-fail-closed-startup), come quando imposta `forceRemoteSettingsRefresh`, la finestra di dialogo appare comunque durante questi comandi, e un'esecuzione di installazione da un pipe fallisce comunque.656Claude Code v2.1.246 e successivi non mostrano la finestra di dialogo durante `claude install` o `claude update`. Il comando viene eseguito con le impostazioni che avete approvato l'ultima volta, e Claude Code mostra la finestra di dialogo nella vostra prossima sessione interattiva. Se la configurazione di avvio della vostra organizzazione [attende il recupero delle impostazioni](/docs/it/server-managed-settings#enforce-fail-closed-startup), come quando imposta `forceRemoteSettingsRefresh`, la finestra di dialogo appare comunque durante questi comandi, e un'esecuzione di installazione da una pipe fallisce comunque.

657 657

658In ogni altra configurazione, rieseguire il programma di installazione supera questo errore, perché lo script esegue il comando `install` della versione più recente anche quando chiedi di installare una versione precedente. Riesegui il comando per la tua piattaforma:658In ogni altra configurazione, rieseguire il programma di installazione supera questo errore, perché lo script esegue il comando `install` della versione più recente anche quando chiedete di installare una versione precedente. Rieseguire il comando per la vostra piattaforma:

659 659

660<Tabs>660<Tabs>

661 <Tab title="macOS/Linux">661 <Tab title="macOS/Linux">

677 `claude update` o `claude doctor` si blocca677 `claude update` o `claude doctor` si blocca

678</h3>678</h3>

679 679

680`claude update` e `claude doctor` scansionano i tuoi file di configurazione della shell per un alias `claude` obsoleto: `~/.zshrc`, `~/.bashrc`, e `~/.config/fish/config.fish`, più su macOS il primo di `~/.bash_profile`, `~/.bash_login`, o `~/.profile` che esiste. Se imposti `ZDOTDIR`, il file Zsh è `$ZDOTDIR/.zshrc` invece. Quando uno di questi percorsi è una directory, Claude Code lo salta e entrambi i comandi si completano normalmente. Prima della v2.1.214, una directory in uno di questi percorsi faceva bloccare entrambi i comandi e lasciava la sezione System diagnostics di `/status` vuota. `claude doctor` si bloccava senza output; `claude update` si bloccava subito dopo aver stampato `Checking for updates`.680`claude update` e `claude doctor` scansionano i file di configurazione della shell per un alias `claude` obsoleto: `~/.zshrc`, `~/.bashrc`, e `~/.config/fish/config.fish`, più su macOS il primo di `~/.bash_profile`, `~/.bash_login`, o `~/.profile` che esiste. Se impostate `ZDOTDIR`, il file Zsh è `$ZDOTDIR/.zshrc`. Quando uno di questi percorsi è una directory, Claude Code lo salta e entrambi i comandi si completano normalmente. Prima di v2.1.214, una directory in uno di questi percorsi faceva bloccare entrambi i comandi e lasciava la sezione System diagnostics di `/status` vuota. `claude doctor` si bloccava senza output; `claude update` si bloccava subito dopo aver stampato `Checking for updates`.

681 681

682Se colpisci il blocco su una versione precedente, trova la directory. Nell'output di questo comando, una riga che inizia con `d` contrassegna quel percorso come una directory. Una riga `No such file or directory` significa che nulla esiste in quel percorso e non è la causa:682Se colpite il blocco su una versione precedente, trovate la directory. Nell'output di questo comando, una riga che inizia con `d` contrassegna quel percorso come una directory. Una riga `No such file or directory` significa che nulla esiste in quel percorso e non è la causa:

683 683

684```bash theme={null}684```bash theme={null}

685ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish685ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

686```686```

687 687

688Sposta la directory da parte, o aggiorna a v2.1.214 o successivo. Poiché `claude update` si blocca sulle versioni interessate, aggiorna rieseguendo lo [script di installazione](/docs/it/setup#install-claude-code) invece.688Spostare la directory da parte, o aggiornare a v2.1.214 o successivo. Poiché `claude update` si blocca sulle versioni interessate, aggiornare rieseguendo lo [script di installazione](/docs/it/setup#install-claude-code).

689 689

690<h3 id="claude-desktop-overrides-the-claude-command-on-windows">690<h3 id="claude-desktop-overrides-the-claude-command-on-windows">

691 Claude Desktop sostituisce il comando `claude` su Windows691 Claude Desktop sostituisce il comando `claude` su Windows

692</h3>692</h3>

693 693

694Se hai installato una versione precedente di Claude Desktop, potrebbe registrare un `Claude.exe` nella directory `WindowsApps` che ha priorità nel PATH rispetto a Claude Code CLI. L'esecuzione di `claude` apre l'app Desktop invece della CLI.694Se avete installato una versione precedente di Claude Desktop, potrebbe registrare un `Claude.exe` nella directory `WindowsApps` che ha priorità su PATH rispetto a Claude Code CLI. L'esecuzione di `claude` apre l'app Desktop invece della CLI.

695 695

696Aggiorna Claude Desktop alla versione più recente per risolvere questo problema.696Aggiornare Claude Desktop all'ultima versione per risolvere questo problema.

697 697

698<h3 id="claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell">698<h3 id="claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell">

699 Claude Code su Windows richiede Git for Windows (per bash) o PowerShell699 Claude Code su Windows richiede Git for Windows (per bash) o PowerShell

700</h3>700</h3>

701 701

702Git for Windows è facoltativo. Claude Code utilizza lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) quando Git Bash è assente, quindi questo errore significa che nessuna delle due shell è stata trovata.702Git for Windows è opzionale. Claude Code utilizza lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) quando Git Bash è assente, quindi questo errore significa che nessuna shell è stata trovata.

703 703

704**Se PowerShell manca dal tuo PATH**, la sua posizione predefinita è `C:\Windows\System32\WindowsPowerShell\v1.0\`. Aggiungi quella directory al tuo `PATH`, o installa [PowerShell 7](https://aka.ms/powershell), che fornisce `pwsh`.704**Se PowerShell manca dal vostro PATH**, la sua posizione predefinita è `C:\Windows\System32\WindowsPowerShell\v1.0\`. Aggiungere quella directory al vostro `PATH`, o installare [PowerShell 7](https://aka.ms/powershell), che fornisce `pwsh`.

705 705

706**Per installare Git for Windows invece**, scaricalo da [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Durante la configurazione, seleziona "Add to PATH." Riavvia il tuo terminale dopo l'installazione. L'installazione abilita lo strumento Bash, utile quando si lavora con script e strumenti basati su Bash.706**Per installare Git for Windows**, scaricarlo da [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Durante l'installazione, selezionare "Add to PATH". Riavviare il terminale dopo l'installazione. L'installazione abilita lo strumento Bash, utile quando si lavora con script e strumenti basati su Bash.

707 707

708**Se Git è già installato** ma Claude Code non riesce a trovarlo, confronta la sua posizione rispetto ai posti che Claude Code controlla. Quando `CLAUDE_CODE_GIT_BASH_PATH` non è impostato, Claude Code cerca `bash.exe` in questo ordine:708**Se Git è già installato** ma Claude Code non riesce a trovarlo, confrontare la sua posizione rispetto ai posti in cui Claude Code cerca. Quando `CLAUDE_CODE_GIT_BASH_PATH` non è impostato, Claude Code cerca `bash.exe` in questo ordine:

709 709

7101. Le posizioni di installazione predefinite `C:\Program Files\Git` e `C:\Program Files (x86)\Git`.7101. Le posizioni di installazione predefinite `C:\Program Files\Git` e `C:\Program Files (x86)\Git`.

7112. Il `git` sul tuo `PATH`, usando il `bin\bash.exe` da quella installazione di Git.7112. Il `git` sul vostro `PATH`, utilizzando il `bin\bash.exe` da quella installazione di Git.

712 712

713Nel passaggio 2, Claude Code salta un `git` che si trova nella cartella da cui hai lanciato Claude Code, o sotto di essa in un percorso che contiene `node_modules` o una cartella di ambiente virtuale come `.venv` o `env`, ad esempio `C:\dev\env\myproject\Git` quando hai lanciato da `C:\dev\env\myproject`. Questo impedisce a Claude Code di eseguire un eseguibile che un progetto ha messo lì. Se il tuo Git è in una posizione come quella, punta `CLAUDE_CODE_GIT_BASH_PATH` ad esso.713Nel passaggio 2, Claude Code salta un `git` che si trova nella cartella da cui avete lanciato Claude Code, o sotto di essa in un percorso che contiene `node_modules` o una cartella di ambiente virtuale come `.venv` o `env`, ad esempio `C:\dev\env\myproject\Git` quando avete lanciato da `C:\dev\env\myproject`. Questo impedisce a Claude Code di eseguire un eseguibile che un progetto ha messo lì. Se il vostro Git è in una posizione come quella, puntate `CLAUDE_CODE_GIT_BASH_PATH` ad esso.

714 714

715**Per puntare Claude Code a un'installazione Git specifica**, trovalo eseguendo `where.exe git` in PowerShell, quindi imposta il percorso `bin\bash.exe` da quella installazione come `CLAUDE_CODE_GIT_BASH_PATH` nel tuo [file settings.json](/docs/it/settings):715**Per puntare Claude Code a un'installazione Git specifica**, trovarla eseguendo `where.exe git` in PowerShell, quindi impostare il percorso `bin\bash.exe` da quella installazione come `CLAUDE_CODE_GIT_BASH_PATH` nel vostro [file settings.json](/docs/it/settings):

716 716

717```json theme={null}717```json theme={null}

718{718{

722}722}

723```723```

724 724

725**Se `CLAUDE_CODE_GIT_BASH_PATH` è impostato al percorso corretto e il file esiste** ma Claude Code ancora non lo usa, controlla prima il nome del file. Claude Code accetta solo un file denominato `bash.exe`, `sh.exe`, `bash`, o `sh`; con qualsiasi altro nome, come il launcher `git-bash.exe` di Git for Windows, ignora la variabile e auto-rileva Git Bash come se fosse non impostato, registrando un avviso visibile con `--debug`. Un percorso che non esiste ottiene lo stesso fallback e avviso. Prima della v2.1.219, Claude Code usava qualsiasi file esistente come shell senza controllare il suo nome, e usciva all'avvio con `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` quando il percorso non esisteva.725**Se `CLAUDE_CODE_GIT_BASH_PATH` è impostato al percorso corretto e il file esiste** ma Claude Code ancora non lo utilizza, controllare il nome del file per primo. Claude Code accetta solo un file denominato `bash.exe`, `sh.exe`, `bash`, o `sh`; con qualsiasi altro nome, come il launcher `git-bash.exe` di Git for Windows, ignora la variabile e auto-rileva Git Bash come se fosse non impostato, registrando un avviso visibile con `--debug`. Un percorso che non esiste ottiene lo stesso fallback e avviso. Prima di v2.1.219, Claude Code utilizzava qualsiasi file esistente come shell senza controllare il suo nome, e usciva all'avvio con `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` quando il percorso non esisteva.

726 726

727Se il nome del file è corretto, il software di sicurezza degli endpoint come AppLocker, i criteri di restrizione software di Criteri di gruppo, o gli agenti EDR potrebbero interferire. Chiedi al tuo team IT di aggiungere alla whitelist `claude.exe` e i processi che genera, inclusi `cmd.exe` e `bash.exe`, nella tua politica di protezione degli endpoint.727Se il nome del file è corretto, il software di sicurezza degli endpoint come AppLocker, le politiche di restrizione software di Group Policy, o gli agenti EDR potrebbero interferire. Chiedere al vostro team IT di inserire nella whitelist `claude.exe` e i processi che genera, inclusi `cmd.exe` e `bash.exe`, nella vostra politica di protezione degli endpoint.

728 728

729<h3 id="claude-code-does-not-support-32-bit-windows">729<h3 id="claude-code-does-not-support-32-bit-windows">

730 Claude Code non supporta Windows a 32 bit730 Claude Code non supporta Windows a 32 bit

731</h3>731</h3>

732 732

733Windows include due voci di PowerShell nel menu Start: `Windows PowerShell` e `Windows PowerShell (x86)`. La voce x86 viene eseguita come processo a 32 bit e attiva questo errore anche su una macchina a 64 bit. Per verificare quale caso sei, esegui questo nella stessa finestra che ha prodotto l'errore:733Windows include due voci di PowerShell nel menu Start: `Windows PowerShell` e `Windows PowerShell (x86)`. La voce x86 viene eseguita come processo a 32 bit e attiva questo errore anche su una macchina a 64 bit. Per verificare quale caso siete, eseguire questo nella stessa finestra che ha prodotto l'errore:

734 734

735```powershell theme={null}735```powershell theme={null}

736[Environment]::Is64BitOperatingSystem736[Environment]::Is64BitOperatingSystem

737```737```

738 738

739Se questo stampa `True`, il tuo sistema operativo va bene. Chiudi la finestra, apri `Windows PowerShell` senza il suffisso x86, e esegui di nuovo il comando di installazione.739Se stampa `True`, il vostro sistema operativo va bene. Chiudere la finestra, aprire `Windows PowerShell` senza il suffisso x86, ed eseguire di nuovo il comando di installazione.

740 740

741Se questo stampa `False`, sei su un'edizione Windows a 32 bit. Claude Code richiede un sistema operativo a 64 bit. Vedi i [requisiti di sistema](/docs/it/setup#system-requirements).741Se stampa `False`, siete su un'edizione Windows a 32 bit. Claude Code richiede un sistema operativo a 64 bit. Vedere i [requisiti di sistema](/docs/it/setup#system-requirements).

742 742

743<h3 id="linux-musl-or-glibc-binary-mismatch">743<h3 id="linux-musl-or-glibc-binary-mismatch">

744 Mancata corrispondenza binaria musl o glibc di Linux744 Mancata corrispondenza binaria musl o glibc su Linux

745</h3>745</h3>

746 746

747Se vedi errori su librerie condivise mancanti come `libstdc++.so.6` o `libgcc_s.so.1` dopo l'installazione, il programma di installazione potrebbe aver scaricato la variante binaria sbagliata per il tuo sistema.747Se vedete errori su librerie condivise mancanti come `libstdc++.so.6` o `libgcc_s.so.1` dopo l'installazione, il programma di installazione potrebbe aver scaricato la variante binaria sbagliata per il vostro sistema.

748 748

749```text theme={null}749```text theme={null}

750Error loading shared library libstdc++.so.6: No such file or directory750Error loading shared library libstdc++.so.6: No such file or directory

754 754

755**Soluzioni:**755**Soluzioni:**

756 756

7571. **Controlla quale libc usa il tuo sistema**:7571. **Verificare quale libc utilizza il vostro sistema**:

758 ```bash theme={null}758 ```bash theme={null}

759 ldd --version 2>&1 | head -1759 ldd --version 2>&1 | head -1

760 ```760 ```

761 L'output che menziona `GNU libc` o `GLIBC` significa glibc. L'output che menziona `musl` significa musl.761 L'output che menziona `GNU libc` o `GLIBC` significa glibc. L'output che menziona `musl` significa musl.

762 762

7632. **Se sei su glibc ma hai ottenuto il binario musl**, rimuovi l'installazione e reinstalla. Puoi anche scaricare manualmente il binario corretto usando il manifesto in `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Apri un [problema GitHub](https://github.com/anthropics/claude-code/issues) con l'output di `ldd --version` e `ls /lib/libc.musl*`.7632. **Se siete su glibc ma avete ottenuto il binario musl**, rimuovere l'installazione e reinstallare. Potete anche scaricare manualmente il binario corretto utilizzando il manifesto in `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Presentare un [problema GitHub](https://github.com/anthropics/claude-code/issues) con l'output di `ldd --version` e `ls /lib/libc.musl*`.

764 764

7653. **Se sei effettivamente su musl**, come Alpine Linux, installa i pacchetti richiesti:7653. **Se siete effettivamente su musl**, come Alpine Linux, installare i pacchetti richiesti:

766 ```bash theme={null}766 ```bash theme={null}

767 apk add libgcc libstdc++ ripgrep767 apk add libgcc libstdc++ ripgrep

768 ```768 ```

769 Su Alpine, `ripgrep` è nel repository community. Se `apk` segnala che il pacchetto manca, vedi [Configurazione di Alpine Linux](/docs/it/setup#alpine-linux-and-musl-based-distributions).769 Su Alpine, `ripgrep` è nel repository community. Se `apk` segnala che il pacchetto manca, vedere [Configurazione Alpine Linux](/docs/it/setup#alpine-linux-and-musl-based-distributions).

770 770

771<h3 id="illegal-instruction">771<h3 id="illegal-instruction">

772 `Illegal instruction`772 `Illegal instruction`

773</h3>773</h3>

774 774

775Se l'esecuzione di `claude` o del programma di installazione stampa `Illegal instruction`, il binario nativo utilizza istruzioni CPU che il tuo processore non supporta. Ci sono due cause distinte.775Se l'esecuzione di `claude` o del programma di installazione stampa `Illegal instruction`, il binario nativo utilizza istruzioni CPU che il vostro processore non supporta. Ci sono due cause distinte.

776 776

777**Mancata corrispondenza dell'architettura.** Il programma di installazione ha scaricato il binario sbagliato, ad esempio x86 su un server ARM. Controlla con `uname -m` su macOS o Linux, o `$env:PROCESSOR_ARCHITECTURE` in PowerShell. Se il risultato non corrisponde al binario che hai ricevuto, [apri un problema GitHub](https://github.com/anthropics/claude-code/issues) con l'output.777**Mancata corrispondenza dell'architettura.** Il programma di installazione ha scaricato il binario sbagliato, ad esempio x86 su un server ARM. Controllare con `uname -m` su macOS o Linux, o `$env:PROCESSOR_ARCHITECTURE` in PowerShell. Se il risultato non corrisponde al binario che avete ricevuto, [presentare un problema GitHub](https://github.com/anthropics/claude-code/issues) con l'output.

778 778

779**Set di istruzioni AVX mancante.** Se la tua architettura è corretta ma vedi ancora `Illegal instruction`, la tua CPU probabilmente manca di AVX o di un'altra istruzione che il binario richiede. Questo colpisce approssimativamente i processori Intel e AMD pre-2013, e le macchine virtuali dove l'hypervisor non passa AVX al guest.779**Set di istruzioni AVX mancante.** Se la vostra architettura è corretta ma vedete ancora `Illegal instruction`, il vostro CPU probabilmente manca di AVX o di un'altra istruzione che il binario richiede. Questo influisce approssimativamente sui processori Intel e AMD pre-2013, e sulle macchine virtuali dove l'hypervisor non passa AVX all'ospite.

780 780

781Su un VPS o VM, esegui `grep -m1 -ow avx /proc/cpuinfo`; un risultato vuoto significa che AVX non è disponibile per il guest.781Su un VPS o VM, eseguire `grep -m1 -ow avx /proc/cpuinfo`; un risultato vuoto significa che AVX non è disponibile per l'ospite.

782 782

783Non c'è una soluzione binaria nativa; traccia il [problema #50384](https://github.com/anthropics/claude-code/issues/50384) per lo stato, e includi il modello della tua CPU da `grep -m1 "model name" /proc/cpuinfo` su Linux o `sysctl -n machdep.cpu.brand_string` su macOS quando segnali.783Non c'è una soluzione binaria nativa; tracciare il [problema #50384](https://github.com/anthropics/claude-code/issues/50384) per lo stato, e includere il vostro modello di CPU da `grep -m1 "model name" /proc/cpuinfo` su Linux o `sysctl -n machdep.cpu.brand_string` su macOS quando segnalate.

784 784

785I metodi di installazione alternativi scaricano lo stesso binario nativo e non risolveranno nessuna delle due cause.785I metodi di installazione alternativi scaricano lo stesso binario nativo e non risolveranno nessuna delle due cause.

786 786

788 `dyld: cannot load` su macOS788 `dyld: cannot load` su macOS

789</h3>789</h3>

790 790

791Se vedi `dyld: Symbol not found`, `dyld: cannot load`, o `Abort trap: 6` durante l'installazione, il binario è incompatibile con la tua versione di macOS o hardware.791Se vedete `dyld: Symbol not found`, `dyld: cannot load`, o `Abort trap: 6` durante l'installazione, il binario è incompatibile con la vostra versione di macOS o hardware.

792 792

793Un errore `Symbol not found` che fa riferimento a `libicucore` significa che la tua versione di macOS è più vecchia di quella supportata dal binario:793Un errore `Symbol not found` che fa riferimento a `libicucore` significa che la vostra versione di macOS è più vecchia di quella che il binario supporta:

794 794

795```text theme={null}795```text theme={null}

796dyld: Symbol not found: _ubrk_clone796dyld: Symbol not found: _ubrk_clone

798 Expected in: /usr/lib/libicucore.A.dylib798 Expected in: /usr/lib/libicucore.A.dylib

799```799```

800 800

801Il caricatore può invece rifiutare i comandi di caricamento del binario, il che significa anche che la tua versione di macOS è troppo vecchia:801Il loader può invece rifiutare i comandi di caricamento del binario, il che significa anche che la vostra versione di macOS è troppo vecchia:

802 802

803```text theme={null}803```text theme={null}

804dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)804dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)

807 807

808**Soluzioni:**808**Soluzioni:**

809 809

8101. **Controlla la tua versione di macOS**: Claude Code richiede macOS 13.0 o successivo. Apri il menu Apple e seleziona About This Mac per controllare la tua versione.8101. **Verificare la vostra versione di macOS**: Claude Code richiede macOS 13.0 o successivo. Aprire il menu Apple e selezionare About This Mac per verificare la vostra versione.

811 811

8122. **Aggiorna macOS** se sei su una versione precedente. Il binario utilizza comandi di caricamento e librerie di sistema che le versioni macOS precedenti non supportano. I metodi di installazione alternativi come Homebrew scaricano lo stesso binario e non risolveranno questo errore.8122. **Aggiornare macOS** se siete su una versione precedente. Il binario utilizza comandi di caricamento e librerie di sistema che le versioni precedenti di macOS non supportano. I metodi di installazione alternativi come Homebrew scaricano lo stesso binario e non risolveranno questo errore.

813 813

814<h3 id="exec-format-error-on-wsl1">814<h3 id="exec-format-error-on-wsl1">

815 `Exec format error` su WSL1815 `Exec format error` su WSL1

816</h3>816</h3>

817 817

818Se l'esecuzione di `claude` in WSL stampa `cannot execute binary file: Exec format error`, sei su WSL1 e stai colpendo una regressione binaria nativa nota tracciata nel [problema #38788](https://github.com/anthropics/claude-code/issues/38788). Le intestazioni del programma del binario sono cambiate in un modo che il caricatore di WSL1 non può gestire.818Se l'esecuzione di `claude` in WSL stampa `cannot execute binary file: Exec format error`, siete su WSL1 e colpite una regressione binaria nativa nota tracciata nel [problema #38788](https://github.com/anthropics/claude-code/issues/38788). Le intestazioni del programma del binario sono cambiate in un modo che il loader di WSL1 non può gestire.

819 819

820La correzione più pulita è convertire la tua distribuzione a WSL2 da PowerShell:820La correzione più pulita è convertire la vostra distribuzione a WSL2 da PowerShell:

821 821

822```powershell theme={null}822```powershell theme={null}

823wsl --set-version <DistroName> 2823wsl --set-version <DistroName> 2

824```824```

825 825

826Se devi rimanere su WSL1, invoca il binario attraverso il linker dinamico. Aggiungi questa funzione a `~/.bashrc` all'interno di WSL, sostituendo il percorso se la tua directory home è diversa:826Se dovete rimanere su WSL1, invocare il binario attraverso il linker dinamico. Aggiungere questa funzione a `~/.bashrc` dentro WSL, sostituendo il percorso se la vostra directory home è diversa:

827 827

828```bash theme={null}828```bash theme={null}

829claude() {829claude() {

831}831}

832```832```

833 833

834Quindi esegui `source ~/.bashrc` e riprova `claude`.834Quindi eseguire `source ~/.bashrc` e riprovare `claude`.

835 835

836<h3 id="npm-install-errors-in-wsl">836<h3 id="npm-install-errors-in-wsl">

837 Errori di installazione npm in WSL837 Errori di installazione npm in WSL

838</h3>838</h3>

839 839

840Questi problemi si applicano se hai installato Claude Code con `npm install -g` all'interno di WSL. Se hai usato il [programma di installazione nativo](/docs/it/setup), salta questa sezione.840Questi problemi si applicano se avete installato Claude Code con `npm install -g` dentro WSL. Se avete utilizzato il [programma di installazione nativo](/docs/it/setup), saltare questa sezione.

841 841

842**Problemi di rilevamento del sistema operativo o della piattaforma.** Se npm segnala una mancata corrispondenza della piattaforma durante l'installazione, WSL probabilmente sta raccogliendo il `npm` di Windows. Esegui prima `npm config set os linux`, quindi installa con `npm install -g @anthropic-ai/claude-code --force`. Non usare `sudo`.842**Problemi di rilevamento del sistema operativo o della piattaforma.** Se npm segnala una mancata corrispondenza della piattaforma durante l'installazione, WSL probabilmente sta raccogliendo il `npm` di Windows. Eseguire `npm config set os linux` per primo, quindi installare con `npm install -g @anthropic-ai/claude-code --force`. Non utilizzare `sudo`.

843 843

844**`exec: node: not found` quando esegui `claude`.** Il tuo ambiente WSL probabilmente sta usando l'installazione di Node.js di Windows. Conferma con `which npm` e `which node`: i percorsi che iniziano con `/mnt/c/` sono binari Windows, mentre i percorsi Linux iniziano con `/usr/`. Per risolvere questo, installa Node tramite il gestore di pacchetti della tua distribuzione Linux o tramite [`nvm`](https://github.com/nvm-sh/nvm).844**`exec: node: not found` quando si esegue `claude`.** Il vostro ambiente WSL probabilmente sta utilizzando l'installazione di Node.js di Windows. Confermare con `which npm` e `which node`: i percorsi che iniziano con `/mnt/c/` sono binari di Windows, mentre i percorsi Linux iniziano con `/usr/`. Per risolvere questo, installare Node tramite il gestore di pacchetti della vostra distribuzione Linux o tramite [`nvm`](https://github.com/nvm-sh/nvm).

845 845

846**Conflitti di versione nvm.** Se hai nvm installato sia in WSL che in Windows, il cambio delle versioni di Node in WSL potrebbe interrompersi perché WSL importa il PATH di Windows per impostazione predefinita e nvm di Windows ha priorità. La causa più comune è che nvm non è caricato nella tua shell. Aggiungi il caricatore nvm a `~/.bashrc` o `~/.zshrc`:846**Conflitti di versione nvm.** Se avete nvm installato sia in WSL che in Windows, il cambio di versioni di Node in WSL potrebbe rompersi perché WSL importa il PATH di Windows per impostazione predefinita e il nvm di Windows ha priorità. La causa più comune è che nvm non è caricato nella vostra shell. Aggiungere il caricatore nvm a `~/.bashrc` o `~/.zshrc`:

847 847

848```bash theme={null}848```bash theme={null}

849export NVM_DIR="$HOME/.nvm"849export NVM_DIR="$HOME/.nvm"

851[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"851[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

852```852```

853 853

854Oppure caricalo nella tua sessione corrente:854O caricarlo nella vostra sessione corrente:

855 855

856```bash theme={null}856```bash theme={null}

857source ~/.nvm/nvm.sh857source ~/.nvm/nvm.sh

858```858```

859 859

860Se nvm è caricato ma i percorsi di Windows hanno ancora priorità, anteponi esplicitamente il tuo percorso Node di Linux:860Se nvm è caricato ma i percorsi di Windows hanno ancora priorità, anteporre esplicitamente il vostro percorso di Node Linux:

861 861

862```bash theme={null}862```bash theme={null}

863export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"863export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

864```864```

865 865

866<Warning>866<Warning>

867 Evita di disabilitare l'importazione del PATH di Windows tramite `appendWindowsPath = false` poiché questo interrompe la capacità di chiamare eseguibili di Windows da WSL. Allo stesso modo, evita di disinstallare Node.js da Windows se lo usi per lo sviluppo di Windows.867 Evitare di disabilitare l'importazione del PATH di Windows tramite `appendWindowsPath = false` poiché questo rompe la capacità di chiamare eseguibili di Windows da WSL. Allo stesso modo, evitare di disinstallare Node.js da Windows se lo utilizzate per lo sviluppo di Windows.

868</Warning>868</Warning>

869 869

870<h3 id="permission-errors-during-installation">870<h3 id="permission-errors-during-installation">

871 Errori di permessi durante l'installazione871 Errori di permesso durante l'installazione

872</h3>872</h3>

873 873

874Se il programma di installazione nativo non riesce con errori di permessi, la directory di destinazione potrebbe non essere scrivibile. Vedi [Controlla i permessi della directory](#check-directory-permissions).874Se il programma di installazione nativo fallisce con errori di permesso, la directory di destinazione potrebbe non essere scrivibile. Vedere [Verificare i permessi della directory](#check-directory-permissions).

875 875

876Se hai precedentemente installato con npm e stai riscontrando errori di permessi specifici di npm, passa al programma di installazione nativo:876Se avete precedentemente installato con npm e state colpendo errori di permesso specifici di npm, passare al programma di installazione nativo:

877 877

878```bash theme={null}878```bash theme={null}

879curl -fsSL https://claude.ai/install.sh | bash879curl -fsSL https://claude.ai/install.sh | bash

883 Binario nativo non trovato dopo l'installazione npm883 Binario nativo non trovato dopo l'installazione npm

884</h3>884</h3>

885 885

886Il pacchetto npm `@anthropic-ai/claude-code` scarica il binario nativo come dipendenza opzionale per piattaforma, come `@anthropic-ai/claude-code-darwin-arm64`. npm quindi esegue lo script postinstall del pacchetto, che copia quel binario in posizione come comando `claude`; fino a quando non viene eseguito, `claude` è uno script placeholder. Se uno dei due passaggi di download o postinstall viene saltato, il placeholder rimane in posizione, e l'esecuzione di `claude` su macOS e Linux stampa:886Il pacchetto npm `@anthropic-ai/claude-code` scarica il binario nativo come dipendenza opzionale per piattaforma, come `@anthropic-ai/claude-code-darwin-arm64`. npm quindi esegue lo script postinstall del pacchetto, che copia quel binario in posizione come comando `claude`; fino a quando non viene eseguito, `claude` è uno script segnaposto. Se uno dei due passaggi di download o postinstall viene saltato, il segnaposto rimane in posizione, e l'esecuzione di `claude` su macOS e Linux stampa:

887 887

888```text theme={null}888```text theme={null}

889Error: claude native binary not installed.889Error: claude native binary not installed.

898Or reinstall without --ignore-scripts / --omit=optional.898Or reinstall without --ignore-scripts / --omit=optional.

899```899```

900 900

901Su Windows, `bin/claude.exe` è quello stesso placeholder di script shell piuttosto che un vero eseguibile, quindi PowerShell e CMD segnalano che non possono eseguire il file invece di stampare questo messaggio.901Su Windows, `bin/claude.exe` è quello stesso segnaposto di script shell piuttosto che un eseguibile reale, quindi PowerShell e CMD segnalano che non possono eseguire il file invece di stampare questo messaggio.

902 902

903Controlla le seguenti cause:903Controllare le seguenti cause:

904 904

905* **Le dipendenze opzionali sono disabilitate.** Rimuovi `--omit=optional` dal tuo comando di installazione npm, `--no-optional` da pnpm, o `--ignore-optional` da yarn, e controlla che `.npmrc` non imposti `optional=false`. Quindi reinstalla. Il binario nativo viene consegnato solo come dipendenza opzionale, quindi non c'è fallback JavaScript se viene saltato, e l'esecuzione di `install.cjs` di nuovo non può mettere un binario che non è mai stato scaricato.905* **Le dipendenze opzionali sono disabilitate.** Rimuovere `--omit=optional` dal vostro comando di installazione npm, `--no-optional` da pnpm, o `--ignore-optional` da yarn, e verificare che `.npmrc` non imposti `optional=false`. Quindi reinstallare. Il binario nativo viene consegnato solo come dipendenza opzionale, quindi non c'è fallback JavaScript se viene saltato, e l'esecuzione di `install.cjs` di nuovo non può posizionare un binario che non è mai stato scaricato.

906* **Gli script di installazione sono disabilitati.** `--ignore-scripts` e alcune configurazioni pnpm saltano il passaggio postinstall ma scaricano comunque il pacchetto della piattaforma. Esegui `node node_modules/@anthropic-ai/claude-code/install.cjs` come il messaggio suggerisce, o reinstalla senza il flag. Se postinstall non può essere eseguito nel tuo ambiente affatto, `node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` trova il pacchetto scaricato e lo avvia, al costo di un processo Node extra ad ogni avvio. Se il wrapper stampa `Could not find native binary package` invece, il pacchetto della piattaforma non è mai stato scaricato, quindi prima correggi la causa delle dipendenze opzionali sopra.906* **Gli script di installazione sono disabilitati.** `--ignore-scripts` e alcune configurazioni pnpm saltano il passaggio postinstall ma scaricano comunque il pacchetto della piattaforma. Eseguire `node node_modules/@anthropic-ai/claude-code/install.cjs` come il messaggio suggerisce, o reinstallare senza il flag. Se postinstall non può essere eseguito nel vostro ambiente affatto, `node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` trova il pacchetto scaricato e lo avvia, al costo di un processo Node aggiuntivo su ogni avvio. Se il wrapper stampa `Could not find native binary package`, il pacchetto della piattaforma non è mai stato scaricato, quindi correggere prima la causa delle dipendenze opzionali sopra.

907* **Piattaforma non supportata.** I binari precompilati vengono pubblicati per `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64`, e `win32-arm64`. Claude Code non spedisce un binario per altre piattaforme; vedi i [requisiti di sistema](/docs/it/setup#system-requirements). Su FreeBSD, il programma di installazione segnala la piattaforma come non supportata. Prima della v2.1.205, ha trattato FreeBSD come Linux e ha scaricato un binario che non poteva essere eseguito.907* **Piattaforma non supportata.** I binari precompilati sono pubblicati per `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64`, e `win32-arm64`. Claude Code non spedisce un binario per altre piattaforme; vedere i [requisiti di sistema](/docs/it/setup#system-requirements). Su FreeBSD, il programma di installazione segnala la piattaforma come non supportata. Prima di v2.1.205, la trattava come Linux e scaricava un binario che non poteva essere eseguito.

908* **Lo specchio npm aziendale manca dei pacchetti della piattaforma.** Assicurati che il tuo registro rispecchi tutti gli otto pacchetti `@anthropic-ai/claude-code-*` della piattaforma oltre al pacchetto meta.908* **Lo specchio npm aziendale manca dei pacchetti della piattaforma.** Assicurarsi che il vostro registro specchi tutti gli otto pacchetti della piattaforma `@anthropic-ai/claude-code-*` oltre al pacchetto meta.

909 909

910<h3 id="npm-enotempty-during-update-or-reinstall">910<h3 id="npm-enotempty-during-update-or-reinstall">

911 Errore npm `ENOTEMPTY` durante l'aggiornamento o la reinstallazione911 Errore npm `ENOTEMPTY` durante l'aggiornamento o la reinstallazione

912</h3>912</h3>

913 913

914Quando esegui `npm install -g @anthropic-ai/claude-code` su un'installazione esistente, npm può fallire mentre sposta la vecchia directory del pacchetto da parte:914Quando eseguite `npm install -g @anthropic-ai/claude-code` su un'installazione esistente, npm può fallire mentre sposta la vecchia directory del pacchetto da parte:

915 915

916```text theme={null}916```text theme={null}

917npm error code ENOTEMPTY917npm error code ENOTEMPTY

922npm error ENOTEMPTY: directory not empty, rename '...'922npm error ENOTEMPTY: directory not empty, rename '...'

923```923```

924 924

925La riga `npm error path` nomina la directory che npm non ha potuto spostare. Elimina quella directory e qualsiasi directory `.claude-code-*` rimanente accanto ad essa, che le esecuzioni interrotte precedenti possono lasciare dietro. I comandi di seguito trovano la tua directory di pacchetto globale con `npm root -g`; se la directory che la riga `npm error path` nomina non è sotto la directory che `npm root -g` stampa, ad esempio perché hai cambiato versioni di Node con nvm, elimina le directory che l'errore nomina invece:925La riga `npm error path` nomina la directory che npm non poteva spostare. Eliminare quella directory e qualsiasi directory `.claude-code-*` rimanente accanto ad essa, che le esecuzioni interrotte precedenti possono lasciare dietro. I comandi di seguito trovano la vostra directory di pacchetto globale con `npm root -g`; se la directory che la riga `npm error path` nomina non è sotto la directory che `npm root -g` stampa, ad esempio perché avete cambiato versioni di Node con nvm, eliminare le directory che l'errore nomina:

926 926

927<Tabs>927<Tabs>

928 <Tab title="macOS/Linux">928 <Tab title="macOS/Linux">

930 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"930 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

931 ```931 ```

932 932

933 Quindi rimuovi qualsiasi directory temp rimanente. Se zsh stampa `no matches found`, non ce n'erano da rimuovere:933 Quindi rimuovere qualsiasi directory temp rimanente. Se Zsh stampa `no matches found`, non ce n'erano da rimuovere:

934 934

935 ```bash theme={null}935 ```bash theme={null}

936 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*936 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

944 </Tab>944 </Tab>

945</Tabs>945</Tabs>

946 946

947Quindi reinstalla:947Quindi reinstallare:

948 948

949```bash theme={null}949```bash theme={null}

950npm install -g @anthropic-ai/claude-code950npm install -g @anthropic-ai/claude-code

951```951```

952 952

953Conferma con `claude --version`, che stampa un numero di versione come `2.1.211 (Claude Code)`.953Confermare con `claude --version`, che stampa un numero di versione come `2.1.211 (Claude Code)`.

954 954

955<h2 id="login-and-authentication">955<h2 id="login-and-authentication">

956 Accesso e autenticazione956 Accesso e autenticazione

troubleshooting.md +5 −1

Details

413. Considera di aggiungere grandi directory di build al tuo file `.gitignore`413. Considera di aggiungere grandi directory di build al tuo file `.gitignore`

424. Riavvia con [`claude --safe-mode`](/docs/it/cli-reference#cli-flags) per verificare se un plugin, un server MCP o un hook è la fonte. Disabilita tutte le personalizzazioni per la sessione; se l'utilizzo diminuisce, vedi [Debug your configuration](/docs/it/debug-your-config#test-against-a-clean-configuration) per trovare quale sia424. Riavvia con [`claude --safe-mode`](/docs/it/cli-reference#cli-flags) per verificare se un plugin, un server MCP o un hook è la fonte. Disabilita tutte le personalizzazioni per la sessione; se l'utilizzo diminuisce, vedi [Debug your configuration](/docs/it/debug-your-config#test-against-a-clean-configuration) per trovare quale sia

43 43

44Se la memoria della sessione supera 2,5GB, appare un avviso critico di utilizzo della memoria. Per liberare la memoria, riavvia Claude Code ed esegui [`claude --continue`](/docs/it/cli-reference#cli-flags) per riprendere la conversazione in un nuovo processo.

46Al di fuori del [fullscreen rendering](/docs/it/fullscreen), l'esecuzione di `/compact` libera anche la memoria. L'avviso scompare una volta che l'utilizzo della memoria scende di nuovo sotto 2,5GB.

44Se l'utilizzo della memoria rimane elevato dopo questi passaggi, esegui `/heapdump` per scrivere due file su `~/Desktop`: uno snapshot dell'heap JavaScript denominato `<session-id>.heapsnapshot` e una suddivisione della memoria denominata `<session-id>-diagnostics.json`. Claude Code [nasconde il comando dal menu dei comandi](/docs/it/commands#how-the-command-menu-matches-what-you-type); digitalo per intero. Su Linux senza una cartella Desktop, i file vengono scritti nella tua directory home.48Se l'utilizzo della memoria rimane elevato dopo questi passaggi, esegui `/heapdump` per scrivere due file su `~/Desktop`: uno snapshot dell'heap JavaScript denominato `<session-id>.heapsnapshot` e una suddivisione della memoria denominata `<session-id>-diagnostics.json`. Claude Code [nasconde il comando dal menu dei comandi](/docs/it/commands#how-the-command-menu-matches-what-you-type); digitalo per intero. Su Linux senza una cartella Desktop, i file vengono scritti nella tua directory home.

45 49

46<Warning>50<Warning>

108 112

109Per mettere l'output di Claude negli appunti, chiedi a Claude di stampare il contenuto nella sua risposta, quindi esegui [`/copy`](/docs/it/commands). `/copy` scrive negli appunti dal processo Claude Code stesso piuttosto che da un comando in sandbox, quindi il sandboxing non lo blocca. Può copiare un singolo blocco di codice invece dell'intera risposta, e scrive anche ciò che ha copiato in un file e stampa il percorso, il che ti dà un fallback quando la scrittura degli appunti non raggiunge il tuo terminale, ad esempio su SSH.113Per mettere l'output di Claude negli appunti, chiedi a Claude di stampare il contenuto nella sua risposta, quindi esegui [`/copy`](/docs/it/commands). `/copy` scrive negli appunti dal processo Claude Code stesso piuttosto che da un comando in sandbox, quindi il sandboxing non lo blocca. Può copiare un singolo blocco di codice invece dell'intera risposta, e scrive anche ciò che ha copiato in un file e stampa il percorso, il che ti dà un fallback quando la scrittura degli appunti non raggiunge il tuo terminale, ad esempio su SSH.

110 114

111Per consentire a un comando inviato di raggiungere direttamente gli appunti, aggiungi `pbcopy *`, `wl-copy *` o `xclip *` a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) in modo che il comando venga eseguito al di fuori della sandbox.115Quando Claude invia il testo a uno di questi strumenti, aggiungere `pbcopy *`, `wl-copy *` o `xclip *` a [`excludedCommands`](/docs/it/settings-reference#sandbox-excludedcommands) non toglie quella chiamata dalla sandbox da sola.

112 116

113<h3 id="copied-text-doesn’t-reach-your-local-clipboard-over-ssh">117<h3 id="copied-text-doesn’t-reach-your-local-clipboard-over-ssh">

114 Copied text doesn't reach your local clipboard over SSH118 Copied text doesn't reach your local clipboard over SSH

ultrareview.md +10 −4

Details

42 Revisione rispetto a una base diversa42 Revisione rispetto a una base diversa

43</h3>43</h3>

44 44

~~45Per confrontare rispetto a una base diversa dal ramo predefinito, passate il nome del ramo. Questo esempio esamina il vostro ramo attuale rispetto a `develop`:~~45Per confrontare rispetto a una base diversa dal ramo predefinito, passate il nome del ramo. Questo esempio esamina il vostro ramo attuale rispetto a `develop` invece:

46 46

47```text theme={null}47```text theme={null}

48/code-review ultra develop48/code-review ultra develop

50 50

51Il ramo base non deve esistere nel vostro clone locale; Claude Code lo recupera da `origin`. Se il nome contiene un errore di battitura, Claude Code suggerisce il nome del ramo più simile nell'errore.51Il ramo base non deve esistere nel vostro clone locale; Claude Code lo recupera da `origin`. Se il nome contiene un errore di battitura, Claude Code suggerisce il nome del ramo più simile nell'errore.

52 52

53Un ID commit o un tag funziona anche come base, e la revisione copre quindi i cambiamenti sul vostro ramo da quel commit.

53<h3 id="review-a-pull-request">55<h3 id="review-a-pull-request">

54 Esamina una pull request56 Esamina una pull request

55</h3>57</h3>

114Ultrareview controlla il diff prima che qualsiasi lavoro di revisione venga eseguito e vi dice quando non può esaminarla così com'è:116Ultrareview controlla il diff prima che qualsiasi lavoro di revisione venga eseguito e vi dice quando non può esaminarla così com'è:

115 117

116* **Diff troppo grande**: una revisione di ramo può includere fino a 500 file modificati e 8.000 righe modificate per impostazione predefinita. I valori esatti possono cambiare, e il [rifiuto](/docs/it/errors#diff-is-too-large-for-ultrareview) nomina quelli in vigore, la dimensione del vostro diff e i file con il maggior numero di righe modificate. Claude Code rifiuta una pull request troppo grande allo stesso modo, nominando i conteggi di file e righe ma non la suddivisione per file118* **Diff troppo grande**: una revisione di ramo può includere fino a 500 file modificati e 8.000 righe modificate per impostazione predefinita. I valori esatti possono cambiare, e il [rifiuto](/docs/it/errors#diff-is-too-large-for-ultrareview) nomina quelli in vigore, la dimensione del vostro diff e i file con il maggior numero di righe modificate. Claude Code rifiuta una pull request troppo grande allo stesso modo, nominando i conteggi di file e righe ma non la suddivisione per file

117* **Nulla da esaminare**: quando il diff rispetto alla base è vuoto, Claude Code lo dice e suggerisce di mettere in staging o committare le modifiche locali, o di passare una base diversa119* **Nulla da esaminare**: quando il diff rispetto alla base è vuoto, ultrareview rifiuta e nomina il ramo o il commit rispetto al quale ha confrontato e il caso in cui vi trovate, come trovarsi sul ramo base stesso senza nulla di non committato, o un ramo i cui commit fanno già parte della base. Suggerisce anche il modo per uscire da quel caso, come passare al ramo con il vostro lavoro, mettere in staging o committare le modifiche locali, o passare una base diversa.

118* **Nessuna base di merge**: quando il vostro ramo non condivide alcuna cronologia con il ramo base, Claude Code ricade all'esame di ogni file tracciato nel repository; il fallback richiede un clone completo e applica gli stessi limiti di dimensione. Su un checkout senza rami o altri ref, come un HEAD staccato creato controllando `FETCH_HEAD` dopo il recupero di un URL, Claude Code [rifiuta la revisione](/docs/it/errors#your-checkout-has-no-branches) e suggerisce di creare prima un ramo120

121 Un primo commit viene esaminato completamente solo dopo quella conferma, quindi il subcommand `claude ultrareview` e `claude -p` lo rifiutano e vi indirizzano a una sessione interattiva invece. Richiede Claude Code v2.1.277 o successivo

122* **Nessuna base di merge**: quando il vostro ramo non condivide alcuna cronologia con il ramo base, o il repository non ha un ramo base con cui confrontare, ultrareview esamina ogni file tracciato nel repository invece. Il fallback richiede un clone completo e applica gli stessi limiti di dimensione. Si avvia solo quando confermate nella finestra di dialogo di avvio o eseguite il subcommand `claude ultrareview` voi stessi. In `claude -p` e ovunque nessuno dei due accada, ultrareview rifiuta, dice che la revisione coprirebbe ogni file, e vi indirizza a una sessione interattiva.

123

124 Su un checkout senza rami o altri ref, come un HEAD staccato creato controllando `FETCH_HEAD` dopo il recupero di un URL, Claude Code [rifiuta la revisione](/docs/it/errors#your-checkout-has-no-branches) e suggerisce di creare prima un ramo

119 125

120<h2 id="pricing-and-free-runs">126<h2 id="pricing-and-free-runs">

121 Prezzi e run gratuiti127 Prezzi e run gratuiti

166 172

167Senza argomenti, il sottocomando esamina il diff tra il vostro ramo attuale e il ramo predefinito, con lo stesso [fallback dell'intero repository](#diff-limits-and-fallbacks) di `/code-review ultra` quando non esiste una base di merge. Passate un numero di PR per esaminare una pull request, o un ramo di base per esaminare il diff rispetto a esso; la [gestione del ramo di base](#review-against-a-different-base) corrisponde al comando interattivo.173Senza argomenti, il sottocomando esamina il diff tra il vostro ramo attuale e il ramo predefinito, con lo stesso [fallback dell'intero repository](#diff-limits-and-fallbacks) di `/code-review ultra` quando non esiste una base di merge. Passate un numero di PR per esaminare una pull request, o un ramo di base per esaminare il diff rispetto a esso; la [gestione del ramo di base](#review-against-a-different-base) corrisponde al comando interattivo.

168 174

169Voi acconsentite al fallback dell'intero repository e al prompt di fatturazione e termini quando eseguite il sottocomando, quindi l'esecuzione inizia senza attendere l'input.175Voi acconsentite al fallback dell'intero repository e al prompt di fatturazione e termini quando eseguite il sottocomando, quindi l'esecuzione inizia senza attendere l'input. L'esecuzione da parte vostra è ciò che conta come consenso. Quando Claude esegue il sottocomando per voi, ad esempio tramite lo strumento Bash, Claude Code rifiuta la revisione dell'intero repository.

170 176

171Su Claude Code v2.1.218 o successivo, potete anche avviare la revisione cloud eseguendo `/code-review ultra` in una sessione non interattiva, ad esempio `claude -p '/code-review ultra'`. Claude Code avvia la revisione e stampa un link di tracciamento senza attendere i risultati, a differenza di `claude ultrareview`, che si blocca fino al loro arrivo. Quando la revisione comporterebbe la fatturazione dei crediti di utilizzo, Claude Code si ferma prima di avviare e vi indirizza a `claude ultrareview`, perché la conferma della fatturazione richiede una sessione interattiva. Prima della v2.1.218, `/code-review ultra` in una sessione non interattiva eseguiva una revisione locale.177Su Claude Code v2.1.218 o successivo, potete anche avviare la revisione cloud eseguendo `/code-review ultra` in una sessione non interattiva, ad esempio `claude -p '/code-review ultra'`. Claude Code avvia la revisione e stampa un link di tracciamento senza attendere i risultati, a differenza di `claude ultrareview`, che si blocca fino al loro arrivo. Quando la revisione comporterebbe la fatturazione dei crediti di utilizzo, Claude Code si ferma prima di avviare e vi indirizza a `claude ultrareview`, perché la conferma della fatturazione richiede una sessione interattiva. Prima della v2.1.218, `/code-review ultra` in una sessione non interattiva eseguiva una revisione locale.

172 178

vs-code.md +79 −14

Details

90 * In modalità Manual, quando Claude vuole modificare un file, mostra un confronto affiancato dell'originale e delle modifiche proposte, quindi chiede l'autorizzazione. Puoi accettare, rifiutare o dire a Claude cosa fare invece. Se modifichi il contenuto proposto direttamente nella vista diff prima di accettare, Claude viene informato che l'hai modificato in modo che non assuma che il file corrisponda alla sua proposta originale.90 * In modalità Manual, quando Claude vuole modificare un file, mostra un confronto affiancato dell'originale e delle modifiche proposte, quindi chiede l'autorizzazione. Puoi accettare, rifiutare o dire a Claude cosa fare invece. Se modifichi il contenuto proposto direttamente nella vista diff prima di accettare, Claude viene informato che l'hai modificato in modo che non assuma che il file corrisponda alla sua proposta originale.

91 91

92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code che mostra un diff delle modifiche proposte da Claude con un prompt di autorizzazione che chiede se effettuare la modifica" width="3292" height="1876" data-path="images/vs-code-edits.png" />92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code che mostra un diff delle modifiche proposte da Claude con un prompt di autorizzazione che chiede se effettuare la modifica" width="3292" height="1876" data-path="images/vs-code-edits.png" />

94 Per rivedere una modifica proposta una modifica alla volta, utilizza i pulsanti **Accept this change** e **Reject this change** sotto ogni modifica nel diff. Rifiutare una modifica la ripristina nel contenuto proposto; accettarla la contrassegna come revisionata. Accettare o rifiutare l'intero file completa comunque la revisione. Un diff con più di 100 modifiche si apre senza i pulsanti per modifica, quindi revisionalo come un intero file. La revisione per modifica richiede Claude Code v2.1.275 o successivo.

96 Le stesse azioni sono disponibili al cursore dal menu contestuale dell'editor e dalla Command Palette come **Claude Code: Accept Change at Cursor** e **Claude Code: Reject Change at Cursor**.

93 </Step>97 </Step>

94</Steps>98</Steps>

95 99

110 * **Manual**: Claude chiede l'autorizzazione prima delle modifiche ai file e della maggior parte dei comandi shell.114 * **Manual**: Claude chiede l'autorizzazione prima delle modifiche ai file e della maggior parte dei comandi shell.

111 * **Plan**: Claude descrive cosa farà e attende l'approvazione prima di apportare modifiche. VS Code apre automaticamente il piano come documento Markdown completo dove puoi aggiungere commenti inline per fornire feedback prima che Claude inizi.115 * **Plan**: Claude descrive cosa farà e attende l'approvazione prima di apportare modifiche. VS Code apre automaticamente il piano come documento Markdown completo dove puoi aggiungere commenti inline per fornire feedback prima che Claude inizi.

112 * **Edit automatically**: Claude apporta modifiche senza chiedere.116 * **Edit automatically**: Claude apporta modifiche senza chiedere.

113* **Model**: seleziona **Switch model…** dal menu dei comandi per cambiare il modello durante la sessione. Puoi anche fare clic sul nome del modello nella parte inferiore della casella di prompt per aprire lo stesso selettore. Quando il modello attuale supporta [livelli di sforzo](/docs/it/model-config#adjust-effort-level), il selettore mostra anche una riga **Effort** e il pulsante del nome del modello mostra il livello selezionato. Il pulsante del nome del modello e la riga **Effort** richiedono Claude Code v2.1.257 o successivo.117* **Model**: seleziona **Switch model…** dal menu dei comandi per cambiare il modello durante la sessione. Puoi anche fare clic sul nome del modello nella parte inferiore della casella di prompt per aprire lo stesso selettore.

114* **Command menu**: fai clic su `/` o digita `/` per aprire il menu dei comandi. Le opzioni includono l'allegazione di file, il cambio di modelli e l'attivazione del pensiero esteso. La sezione Customize fornisce accesso ai server MCP, slash commands, stili di output, hooks, memoria, autorizzazioni e plugin. Gli elementi con un'icona di terminale si aprono nel terminale integrato.118

119 Quando il modello attuale supporta [livelli di sforzo](/docs/it/model-config#adjust-effort-level), il selettore mostra anche una riga **Effort** e il pulsante del nome del modello mostra il livello selezionato. Quando scegli un livello diverso da `max`, Claude Code lo salva per il modello attuale come predefinito, sotto [`modelSettings`](/docs/it/settings-reference#modelsettings) nelle impostazioni utente; `max` si applica solo alla sessione corrente. Il pulsante del nome del modello e la riga **Effort** richiedono Claude Code v2.1.257 o successivo.

120* **Command menu**: fai clic su `/` o digita `/` per aprire il menu dei comandi. Le opzioni includono l'allegazione di file, il cambio di modelli e l'attivazione del pensiero esteso.

121

122 La sezione Customize fornisce accesso ai server MCP, comandi, stili di output, hooks, memoria, istruzioni, autorizzazioni e plugin. Gli elementi con un'icona di terminale si aprono nel terminale integrato.

123

115 * Per sfogliare comandi come `/usage` o [`/remote-control`](/docs/it/remote-control), seleziona **Slash commands** nella sezione Customize. Una finestra di dialogo li elenca con una casella di filtro. Scegline uno per eseguirlo. Digitare `/` nella casella di prompt suggerisce comunque i comandi inline. Richiede Claude Code v2.1.257 o successivo.124 * Per sfogliare comandi come `/usage` o [`/remote-control`](/docs/it/remote-control), seleziona **Slash commands** nella sezione Customize. Una finestra di dialogo li elenca con una casella di filtro. Scegline uno per eseguirlo. Digitare `/` nella casella di prompt suggerisce comunque i comandi inline. Richiede Claude Code v2.1.257 o successivo.

116 * Seleziona **Output styles** nella sezione Customize per scegliere uno [stile di output](/docs/it/output-styles), inclusi i tuoi stili personalizzati. Richiede Claude Code v2.1.257 o successivo.125 * Seleziona **Output styles** nella sezione Customize per scegliere uno [stile di output](/docs/it/output-styles), inclusi i tuoi stili personalizzati. Richiede Claude Code v2.1.257 o successivo.

117 126

118 Per creare uno stile personalizzato, seleziona **Build a custom style** dal menu **Output styles**. Claude Code scrive il [file di stile](/docs/it/output-styles#create-a-custom-output-style) per te a livello di progetto o utente. Richiede Claude Code v2.1.261 o successivo.127 Per creare uno stile personalizzato, seleziona **Build a custom style** dal menu **Output styles**. Claude Code scrive il [file di stile](/docs/it/output-styles#create-a-custom-output-style) per te a livello di progetto o utente. Richiede Claude Code v2.1.261 o successivo.

119 * Seleziona **Hooks** nella sezione Customize per visualizzare gli [hooks](/docs/it/hooks) caricati nella sessione, raggruppati per evento. Puoi aggiungere, modificare o rimuovere gli hooks salvati nei tuoi file di impostazioni utente, progetto e locale. Gli hooks da altre fonti, come impostazioni gestite o plugin, sono di sola lettura. Richiede Claude Code v2.1.269 o successivo.128 * Seleziona **Hooks** nella sezione Customize per visualizzare gli [hooks](/docs/it/hooks) caricati nella sessione, raggruppati per evento. Puoi aggiungere, modificare o rimuovere gli hooks salvati nei tuoi file di impostazioni utente, progetto e locale. Gli hooks da altre fonti, come impostazioni gestite o plugin, sono di sola lettura. Richiede Claude Code v2.1.269 o successivo.

120 * Seleziona **Permissions** nella sezione Customize per visualizzare le [regole di autorizzazione](/docs/it/permissions) della sessione, raggruppate in Allow, Ask e Deny. Puoi aggiungere regole ai tuoi file di impostazioni utente, progetto o locale e rimuovere le regole salvate lì. Le regole da altre fonti, come impostazioni gestite o approvazioni effettuate solo per questa sessione, sono di sola lettura. Richiede Claude Code v2.1.269 o successivo.129 * Seleziona **Permissions** nella sezione Customize per visualizzare le [regole di autorizzazione](/docs/it/permissions) della sessione, raggruppate in Allow, Ask e Deny. Puoi aggiungere regole ai tuoi file di impostazioni utente, progetto o locale e rimuovere le regole salvate lì. Le regole da altre fonti, come impostazioni gestite o approvazioni effettuate solo per questa sessione, sono di sola lettura. Richiede Claude Code v2.1.269 o successivo.

130 * Seleziona **Memory** nella sezione Customize per attivare o disattivare la [memoria automatica](/docs/it/memory#auto-memory). Mentre è attiva, puoi anche sfogliare i ricordi che Claude ha salvato e rivelare le cartelle che li archiviano nel tuo file manager. Richiede Claude Code v2.1.274 o successivo.

131

132 Fai clic su un ricordo salvato per leggerlo nella finestra di dialogo, dove puoi modificare il testo, eliminare il ricordo, o aprire il suo file nell'editor. La visualizzazione, la modifica e l'eliminazione di un ricordo nella finestra di dialogo richiedono Claude Code v2.1.275 o successivo.

133 * Seleziona **Instructions** nella sezione Customize per modificare i [file CLAUDE.md](/docs/it/memory#claude-md-files) che Claude legge. Scegli un file per aprirlo nell'editor. Se il file non esiste ancora, Claude Code lo crea prima. Richiede Claude Code v2.1.274 o successivo.

121 * La sezione Settings include **Enable Remote Control for all sessions**, che imposta [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) per controllare se [le nuove sessioni interattive si connettono a Remote Control automaticamente](/docs/it/remote-control#enable-remote-control-for-all-sessions). Richiede Claude Code v2.1.203 o successivo.134 * La sezione Settings include **Enable Remote Control for all sessions**, che imposta [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) per controllare se [le nuove sessioni interattive si connettono a Remote Control automaticamente](/docs/it/remote-control#enable-remote-control-for-all-sessions). Richiede Claude Code v2.1.203 o successivo.

122 135

123 Quando attivi o disattivi l'interruttore in una finestra di VS Code, la modifica si applica alle sessioni già aperte in quella finestra di VS Code, non solo alle sessioni che avvii successivamente. Se lo disattivi, le sessioni aperte si disconnettono. Con Claude Code v2.1.261 o successivo, la modifica raggiunge anche le sessioni aperte nelle altre finestre di VS Code.136 Quando attivi o disattivi l'interruttore in una finestra di VS Code, la modifica si applica alle sessioni già aperte in quella finestra di VS Code, non solo alle sessioni che avvii successivamente. Se lo disattivi, le sessioni aperte si disconnettono. Con Claude Code v2.1.261 o successivo, la modifica raggiunge anche le sessioni aperte nelle altre finestre di VS Code.

124 * La sezione Settings include anche **Focus view**, che nasconde le chiamate di strumenti, i risultati degli strumenti e il pensiero dietro righe espandibili, lasciando i tuoi prompt e le risposte di Claude. Attivalo lì, con `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), o dalla Tavolozza dei comandi con **Claude Code: Toggle Focus view**. La modifica si applica a ogni sessione aperta e persiste tra le sessioni. Richiede Claude Code v2.1.221 o successivo.137 * La sezione Settings include anche **Focus view**, che nasconde le chiamate di strumenti, i risultati degli strumenti e il pensiero dietro righe espandibili, lasciando i tuoi prompt e le risposte di Claude. Attivalo lì, con `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), o dalla Tavolozza dei comandi con **Claude Code: Toggle Focus view**. La modifica si applica a ogni sessione aperta e persiste tra le sessioni. Richiede Claude Code v2.1.221 o successivo.

125 138

126 L'elenco di cose da fare più recente di Claude rimane visibile, così come il testo di una domanda in sospeso da Claude; questo richiede Claude Code v2.1.225 o successivo. Mentre Claude esegue [subagenti](/docs/it/sub-agents), le righe di progresso in tempo reale con la loro attività più recente appaiono sotto il gruppo di chiamate di strumenti che le ha avviate. Questo richiede Claude Code v2.1.269 o successivo.139 L'elenco di cose da fare più recente di Claude rimane visibile, così come il testo di una domanda in sospeso da Claude; questo richiede Claude Code v2.1.225 o successivo. Mentre Claude esegue [subagenti](/docs/it/sub-agents), le righe di progresso in tempo reale con la loro attività più recente appaiono sotto il gruppo di chiamate di strumenti che le ha avviate. Questo richiede Claude Code v2.1.269 o successivo.

140 * Per disconnetterti dal tuo account Anthropic, seleziona **Sign out** nella sezione Settings, o digita `/logout`. Su un [provider di terze parti](#use-third-party-providers), il menu non offre nessuno dei due. Richiede Claude Code v2.1.277 o successivo.

127 * Per segnalare un bug, fai clic su **Report a problem** nella parte inferiore del menu, o digita `/bug` o `/feedback` con una descrizione facoltativa che precompila il rapporto. Quando invii il rapporto e sei connesso ad Anthropic su una connessione di prima parte, Claude Code lo invia ad Anthropic. Su un provider di terze parti, o senza credenziali Anthropic, la finestra di dialogo si apre comunque, ma l'invio mostra un errore e non invia nulla: a differenza di `/bug` della CLI, l'estensione non scrive un archivio locale. Richiede Claude Code v2.1.229 o successivo.141 * Per segnalare un bug, fai clic su **Report a problem** nella parte inferiore del menu, o digita `/bug` o `/feedback` con una descrizione facoltativa che precompila il rapporto. Quando invii il rapporto e sei connesso ad Anthropic su una connessione di prima parte, Claude Code lo invia ad Anthropic. Su un provider di terze parti, o senza credenziali Anthropic, la finestra di dialogo si apre comunque, ma l'invio mostra un errore e non invia nulla: a differenza di `/bug` della CLI, l'estensione non scrive un archivio locale. Richiede Claude Code v2.1.229 o successivo.

128 142

129 Se la politica della tua organizzazione disattiva il feedback sui prodotti, **Report a problem** non appare nel menu, e `/bug` e `/feedback` mostrano un avviso `Feedback is turned off by your organization's policy or this environment's settings.` invece di aprire il rapporto.143 Se la politica della tua organizzazione disattiva il feedback sui prodotti, **Report a problem** non appare nel menu, e `/bug` e `/feedback` mostrano un avviso `Feedback is turned off by your organization's policy or this environment's settings.` invece di aprire il rapporto.

130* **Side questions**: digita `/btw` seguito da una domanda per chiedere informazioni sulla tua sessione [senza aggiungere alla conversazione](/docs/it/interactive-mode#side-questions-with-%2Fbtw). La risposta si apre in un pannello accanto alla chat, dove puoi fare domande di follow-up. Il thread sopravvive ai ricaricamenti della finestra. Claude Code mantiene i 20 scambi più recenti e scade i thread archiviati secondo la pianificazione [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), purché Claude Code possa [determinare in sicurezza il periodo di conservazione](/docs/it/claude-directory#cleaned-up-automatically). Per cancellare un thread, fai clic sull'icona del cestino nel pannello. Richiede Claude Code v2.1.227 o successivo.144* **Side questions**: digita `/btw` seguito da una domanda per chiedere informazioni sulla tua sessione [senza aggiungere alla conversazione](/docs/it/interactive-mode#side-questions-with-%2Fbtw). La risposta si apre in un pannello accanto alla chat, dove puoi fare domande di follow-up. Il thread sopravvive ai ricaricamenti della finestra. Claude Code mantiene i 20 scambi più recenti e scade i thread archiviati secondo la pianificazione [`cleanupPeriodDays`](/docs/it/settings-reference#cleanupperioddays), purché Claude Code possa [determinare in sicurezza il periodo di conservazione](/docs/it/claude-directory#cleaned-up-automatically). Per cancellare un thread, fai clic sull'icona del cestino nel pannello. Richiede Claude Code v2.1.227 o successivo.

145* **Copy a response**: passa il mouse su una risposta e fai clic su **Copy response** per copiarla negli appunti, o digita `/copy` per copiare l'ultima risposta. `/copy 2` copia la penultima. Richiede Claude Code v2.1.277 o successivo.

131* **Context indicator**: la casella di prompt mostra quanto della finestra di contesto di Claude stai utilizzando. Claude compatta automaticamente quando necessario, oppure puoi eseguire `/compact` manualmente.146* **Context indicator**: la casella di prompt mostra quanto della finestra di contesto di Claude stai utilizzando. Claude compatta automaticamente quando necessario, oppure puoi eseguire `/compact` manualmente.

132* **Prompt cache clock**: un'icona di orologio accanto all'indicatore di contesto stima quanto tempo rimane alla [prompt cache](/docs/it/prompt-caching) della conversazione prima che scada. Fa il conto alla rovescia dalla [durata](/docs/it/prompt-caching#cache-lifetime) della cache di cinque minuti o un'ora, e ogni risposta che utilizza la cache riavvia il conto alla rovescia. A parte la compattazione, le [azioni che invalidano la cache](/docs/it/prompt-caching#actions-that-invalidate-the-cache) non ripristinano l'orologio, quindi può ancora mostrare minuti rimasti dopo che cambi modelli.147* **Prompt cache clock**: un'icona di orologio accanto all'indicatore di contesto stima quanto tempo rimane alla [prompt cache](/docs/it/prompt-caching) della conversazione prima che scada. Fa il conto alla rovescia dalla [durata](/docs/it/prompt-caching#cache-lifetime) della cache di cinque minuti o un'ora, e ogni risposta che utilizza la cache riavvia il conto alla rovescia. A parte la compattazione, le [azioni che invalidano la cache](/docs/it/prompt-caching#actions-that-invalidate-the-cache) non ripristinano l'orologio, quindi può ancora mostrare minuti rimasti dopo che cambi modelli.

133 * Fino a quando il conto alla rovescia non termina, l'icona mostra i minuti rimasti, come **12m**.148 * Fino a quando il conto alla rovescia non termina, l'icona mostra i minuti rimasti, come **12m**.

136* **Agent map**: quando la conversazione include [subagenti](/docs/it/sub-agents), un conteggio di agenti come **2 agents** appare nella parte inferiore della casella di prompt. Il suo punto mostra se un subagente sta lavorando o in attesa della tua autorizzazione.151* **Agent map**: quando la conversazione include [subagenti](/docs/it/sub-agents), un conteggio di agenti come **2 agents** appare nella parte inferiore della casella di prompt. Il suo punto mostra se un subagente sta lavorando o in attesa della tua autorizzazione.

137 152

138 Fai clic sul conteggio degli agenti per aprire la mappa degli agenti, che disegna i subagenti della conversazione come un albero sotto l'agente principale, ognuno con il suo stato, tempo trascorso e conteggio dei token. Fai clic su un subagente per vedere il suo prompt e le chiamate di strumenti, aprire la sua trascrizione di sola lettura, o fermarlo mentre è in esecuzione. Richiede Claude Code v2.1.269 o successivo.153 Fai clic sul conteggio degli agenti per aprire la mappa degli agenti, che disegna i subagenti della conversazione come un albero sotto l'agente principale, ognuno con il suo stato, tempo trascorso e conteggio dei token. Fai clic su un subagente per vedere il suo prompt e le chiamate di strumenti, aprire la sua trascrizione di sola lettura, o fermarlo mentre è in esecuzione. Richiede Claude Code v2.1.269 o successivo.

154

155 La mappa elenca anche gli altri [compiti in background](/docs/it/tools-reference#background-commands) della sessione, come comandi shell in background e [monitor](/docs/it/tools-reference#monitor-tool), sotto gli agenti. Fai clic su una riga per aprire la scheda del compito e fermarlo lì.

156

157 Per aprire la mappa quando non è visualizzato alcun conteggio di agenti, ad esempio quando Claude ha avviato una shell in background ma nessun subagente, digita `/tasks` nella casella di prompt. I compiti in background nella mappa e il `/tasks` digitato richiedono Claude Code v2.1.277 o successivo.

139* **Extended thinking**: consente a Claude di dedicare più tempo al ragionamento su problemi complessi. Attivalo tramite il menu dei comandi (`/`). Il ragionamento di Claude appare nella conversazione come blocchi compressi: fai clic su un blocco per leggerlo, o premi `Ctrl+O` per espandere o comprimere ogni blocco di pensiero nella sessione. Consulta [Extended thinking](/docs/it/model-config#extended-thinking) per i dettagli.158* **Extended thinking**: consente a Claude di dedicare più tempo al ragionamento su problemi complessi. Attivalo tramite il menu dei comandi (`/`). Il ragionamento di Claude appare nella conversazione come blocchi compressi: fai clic su un blocco per leggerlo, o premi `Ctrl+O` per espandere o comprimere ogni blocco di pensiero nella sessione. Consulta [Extended thinking](/docs/it/model-config#extended-thinking) per i dettagli.

140* **Multi-line input**: premi `Shift+Enter` per aggiungere una nuova riga senza inviare. Questo funziona anche nell'input di testo libero "Other" delle finestre di dialogo delle domande.159* **Multi-line input**: premi `Shift+Enter` per aggiungere una nuova riga senza inviare. Questo funziona anche nell'input di testo libero "Other" delle finestre di dialogo delle domande.

141 160

154 173

155Quando selezioni il testo nell'editor, Claude può vedere il tuo codice evidenziato automaticamente. Il piè di pagina della casella di prompt mostra quante righe sono selezionate. Premi `Option+K` (Mac) / `Alt+K` (Windows/Linux) per inserire una menzione @-mention con il percorso del file e i numeri di riga (ad es. `@app.ts#5-10`). Fai clic sulla **X** sull'indicatore di selezione per rimuoverlo in modo che Claude non riceva la selezione. L'indicatore riappare quando selezioni altro testo.174Quando selezioni il testo nell'editor, Claude può vedere il tuo codice evidenziato automaticamente. Il piè di pagina della casella di prompt mostra quante righe sono selezionate. Premi `Option+K` (Mac) / `Alt+K` (Windows/Linux) per inserire una menzione @-mention con il percorso del file e i numeri di riga (ad es. `@app.ts#5-10`). Fai clic sulla **X** sull'indicatore di selezione per rimuoverlo in modo che Claude non riceva la selezione. L'indicatore riappare quando selezioni altro testo.

156 175

176L'estensione trattiene il testo selezionato da alcuni file. Quando il file si trova all'interno del tuo workspace e corrisponde alle tue impostazioni `files.exclude` o `search.exclude`, Claude riceve al massimo il percorso del file e non il testo che hai selezionato. Lo stesso vale per un file che git ignora, purché l'impostazione `search.useIgnoreFiles` di VS Code e l'impostazione [`respectGitIgnore`](#extension-settings) dell'estensione siano entrambe attive, il che è l'impostazione predefinita. Questo filtro copre solo il pannello della chat: quando Claude Code viene eseguito nel terminale integrato, la CLI invia il tuo testo selezionato indipendentemente dal file, quindi aggiungi una [regola di negazione `Read`](#the-built-in-ide-mcp-server) per impedire che i contenuti di un file raggiungano Claude lì.

177

157Claude vede anche quale file hai aperto nell'editor, anche quando nulla è selezionato, e la casella di prompt mostra il suo nome. Per aggiungere solo il testo selezionato, disattiva l'[impostazione Attach Open File](vscode://settings/claudeCode.attachOpenFile). L'impostazione richiede Claude Code v2.1.271 o successivo.178Claude vede anche quale file hai aperto nell'editor, anche quando nulla è selezionato, e la casella di prompt mostra il suo nome. Per aggiungere solo il testo selezionato, disattiva l'[impostazione Attach Open File](vscode://settings/claudeCode.attachOpenFile). L'impostazione richiede Claude Code v2.1.271 o successivo.

158 179

159Per allegare un'immagine, incollala dagli appunti nella casella di prompt. Puoi anche tenere premuto `Shift` mentre trascini i file nella casella di prompt per aggiungerli come allegati. Fai clic sulla X su qualsiasi allegato per rimuoverlo dal contesto.180Puoi anche allegare immagini e file al tuo messaggio:

181

182* Per allegare un'immagine, incollala dagli appunti nella casella di prompt.

183* Per allegare file, tieni premuto `Shift` mentre li trascini nella casella di prompt.

184* Per rimuovere un allegato dal contesto, fai clic sulla X su di esso.

160 185

161<h3 id="resume-past-conversations">186<h3 id="resume-past-conversations">

162 Riprendi conversazioni passate187 Riprendi conversazioni passate

171 196

172Per impostazione predefinita, una sessione senza attività per 14 giorni si sposta automaticamente in **Archived sessions**, a meno che non sia aperta, non letta o in un [gruppo](#organize-sessions-into-groups). L'archiviazione automatica richiede Claude Code v2.1.265 o successivo. Per modificare il periodo o disattivarlo, apri l'[impostazione Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) e seleziona un numero di giorni o **Never**.197Per impostazione predefinita, una sessione senza attività per 14 giorni si sposta automaticamente in **Archived sessions**, a meno che non sia aperta, non letta o in un [gruppo](#organize-sessions-into-groups). L'archiviazione automatica richiede Claude Code v2.1.265 o successivo. Per modificare il periodo o disattivarlo, apri l'[impostazione Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) e seleziona un numero di giorni o **Never**.

173 198

174Per ripristinare una sessione archiviata, espandi **Archived sessions** e fai clic su **Unarchive session**. Prima della v2.1.257, l'azione era **Delete session**, che nascondeva una sessione senza modo di ripristinarla. Le sessioni che hai eliminato allora appaiono sotto **Archived sessions** dopo l'aggiornamento.199Per ripristinare una sessione archiviata, espandi **Archived sessions** e fai clic su **Unarchive session**. Per ripristinare ogni sessione archiviata contemporaneamente, passa il mouse sull'intestazione **Archived sessions** nell'elenco delle sessioni nella Activity Bar e fai clic sulla sua icona di ripristino, che richiede Claude Code v2.1.277 o successivo. Prima della v2.1.257, l'azione era **Delete session**, che nascondeva una sessione senza modo di ripristinarla. Le sessioni che hai eliminato allora appaiono sotto **Archived sessions** dopo l'aggiornamento.

175 200

176Quando la conversazione che riprendi è terminata in modalità plan, Claude Code ripristina la modalità plan. Richiede Claude Code v2.1.246 o successivo. Claude Code non la ripristina in due casi:201Quando la conversazione che riprendi è terminata in modalità plan, Claude Code ripristina la modalità plan. Richiede Claude Code v2.1.246 o successivo. Claude Code non la ripristina in due casi:

177 202

206 Controlla account e utilizzo231 Controlla account e utilizzo

207</h3>232</h3>

208 233

209Esegui `/usage` per aprire la finestra di dialogo Account & usage. La finestra di dialogo richiede un accesso a claude.ai, quindi non è offerta su un [provider di terze parti](#use-third-party-providers). Mostra il tuo account connesso, il tuo piano e le barre di utilizzo per i limiti del tuo piano, come la sessione corrente e la settimana. Ogni barra mostra quanto tempo rimane prima che il suo limite si ripristini.234Esegui `/usage` per aprire la finestra di dialogo Account & usage. Mostra il tuo account connesso, e l'utilizzo che riporta differisce in base all'accesso:

210 235

211La finestra di dialogo suddivide anche ciò che contribuisce ai limiti del tuo piano. Contrassegna i comportamenti che rappresentano il 10% o più dell'utilizzo recente, come mancate cache, contesto lungo e sessioni pesanti di subagent o altamente parallele, ognuna con un suggerimento per ridurlo. Le tabelle di attribuzione mostrano quanto utilizzo è provenuto da ogni skill, subagent, plugin e server MCP.236* **Piano claude.ai**: barre di utilizzo per i limiti del tuo piano, come la sessione corrente e la settimana. Ogni barra mostra quanto tempo rimane prima che il suo limite si ripristini.

212 237

213Usa l'interruttore Day e Week per passare tra le ultime 24 ore e gli ultimi 7 giorni. Le cifre sono approssimative e calcolate dalle sessioni locali su questa macchina, quindi l'utilizzo da altri dispositivi o da claude.ai non è incluso. Per ulteriori informazioni sul tracciamento e la riduzione dell'utilizzo, consulta [Track your costs](/docs/it/costs#track-your-costs).238 La finestra di dialogo suddivide anche ciò che contribuisce ai limiti del tuo piano. Contrassegna i comportamenti che rappresentano il 10% o più dell'utilizzo recente, come mancate cache, contesto lungo e sessioni pesanti di subagent o altamente parallele, ognuna con un suggerimento per ridurlo. Le tabelle di attribuzione mostrano quanto utilizzo è provenuto da ogni skill, subagent, plugin e server MCP.

239

240 Usa l'interruttore Day e Week per passare tra le ultime 24 ore e gli ultimi 7 giorni. Le cifre sono approssimative e calcolate dalle sessioni locali su questa macchina, quindi l'utilizzo da altri dispositivi o da claude.ai non è incluso.

241* **Altri accessi**: quando i limiti del piano non si applicano al tuo accesso, ad esempio su un [provider di terze parti](#use-third-party-providers) o con una chiave API, la sezione Usage mostra il costo della sessione e l'utilizzo dei token invece. Il `/usage` della CLI mostra gli stessi totali nel suo [blocco Session](/docs/it/costs#track-your-costs). L'elenco delle sessioni nella Activity Bar mostra anche i totali della sessione attiva sotto la sua intestazione **Account & usage**. Richiede Claude Code v2.1.277 o successivo.

242

243Per ulteriori informazioni sul tracciamento e la riduzione dell'utilizzo, consulta [Track your costs](/docs/it/costs#track-your-costs).

214 244

215<h2 id="customize-your-workflow">245<h2 id="customize-your-workflow">

216 Personalizza il tuo flusso di lavoro246 Personalizza il tuo flusso di lavoro

228* **Barra laterale primaria**: la barra laterale sinistra con icone per Explorer, Search, ecc.258* **Barra laterale primaria**: la barra laterale sinistra con icone per Explorer, Search, ecc.

229* **Area editor**: apre Claude come scheda accanto ai tuoi file. Utile per attività secondarie.259* **Area editor**: apre Claude come scheda accanto ai tuoi file. Utile per attività secondarie.

230 260

261Quando Claude apre una scheda in un nuovo gruppo di editor, l'estensione blocca quel gruppo, quindi i file che apri mentre la scheda Claude è attiva vanno in un altro gruppo invece che accanto ad essa.

262

263Per impedire all'estensione di bloccare i gruppi, disattiva l'[impostazione Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). I gruppi già bloccati rimangono bloccati finché non li sblocchi. L'impostazione richiede Claude Code v2.1.274 o successivo.

264

231<Tip>265<Tip>

232 Usa la barra laterale per la tua sessione Claude principale e apri schede aggiuntive per attività secondarie. Claude ricorda la tua posizione preferita. L'icona dell'elenco delle sessioni della Activity Bar è separata dal pannello Claude: l'elenco delle sessioni è sempre visibile nella Activity Bar, mentre l'icona del pannello Claude appare lì solo quando il pannello è ancorato alla barra laterale sinistra.266 Usa la barra laterale per la tua sessione Claude principale e apri schede aggiuntive per attività secondarie. Claude ricorda la tua posizione preferita. L'icona dell'elenco delle sessioni della Activity Bar è separata dal pannello Claude: l'elenco delle sessioni è sempre visibile nella Activity Bar, mentre l'icona del pannello Claude appare lì solo quando il pannello è ancorato alla barra laterale sinistra.

233</Tip>267</Tip>

237* **Scheda editor**: la conversazione torna con la sua scheda.271* **Scheda editor**: la conversazione torna con la sua scheda.

238* **Barra laterale**: la conversazione torna se hai inviato un messaggio o Claude ha risposto in essa negli ultimi 10 minuti. Se non torna, riprendi la conversazione da [Cronologia sessioni](#resume-past-conversations).272* **Barra laterale**: la conversazione torna se hai inviato un messaggio o Claude ha risposto in essa negli ultimi 10 minuti. Se non torna, riprendi la conversazione da [Cronologia sessioni](#resume-past-conversations).

239 273

274Se il ricaricamento ha interrotto Claude a metà di un passaggio, Claude continua quel passaggio quando la conversazione torna, e un avviso nella chat contrassegna la continuazione. Richiede Claude Code v2.1.274 o successivo. Se il passaggio è stato interrotto più di un'ora fa o la sessione è aperta altrove, la conversazione torna inattiva.

275

276Per disattivare la continuazione, apri l'[impostazione Continue After Reload](vscode://settings/claudeCode.continueAfterReload) e deselezionala.

277

240<h3 id="run-multiple-conversations">278<h3 id="run-multiple-conversations">

241 Esegui più conversazioni279 Esegui più conversazioni

242</h3>280</h3>

304L'URL accetta due parametri di query:342L'URL accetta due parametri di query:

305 343

306| Parametro | Descrizione |344| Parametro | Descrizione |

307| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |345| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

309| `marketplace` | Da dove proviene il plugin, in qualsiasi forma la [scheda Marketplaces](#manage-marketplaces) accetti, come un `owner/repo` di GitHub o un URL git. Codificatelo in URL se contiene caratteri come `&`. Per impostazione predefinita è `anthropics/claude-plugins-official` quando omesso. |347| `marketplace` | Da dove proviene il plugin: un `owner/repo` di GitHub, un URL `https://` o un URL SSH git come `git@github.com:owner/repo.git`. Predefinito a `anthropics/claude-plugins-official` quando omesso. |

348

349Alcuni valori che la [scheda Marketplaces](#manage-marketplaces) accetta non funzionano in un collegamento, come un percorso locale o un indirizzo `http://`. Per questi, VS Code mostra un messaggio di errore e la finestra di dialogo non si apre.

310 350

311Due casi terminano con un messaggio nella finestra di dialogo invece della scelta dell'ambito:351Due casi terminano con un messaggio nella finestra di dialogo invece della scelta dell'ambito:

312 352

364</Note>404</Note>

365 405

367| -------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |407| -------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

409| Focus last message | - | Sposta lo stato attivo della tastiera al messaggio più recente nella conversazione, o a un prompt di autorizzazione in attesa, in modo da poter leggere da lì con la tastiera o un lettore di schermo. Non disponibile in [modalità terminale](#switch-to-terminal-mode). Richiede Claude Code v2.1.268 o successivo |

369| Open in Side Bar | - | Apri Claude nella barra laterale |410| Open in Side Bar | - | Apri Claude nella barra laterale |

370| Open in Terminal | - | Apri Claude in modalità terminale |411| Open in Terminal | - | Apri Claude in modalità terminale |

373| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Avvia una nuova conversazione. Richiede che Claude sia attivo e `enableNewConversationShortcut` impostato su `true` |414| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Avvia una nuova conversazione. Richiede che Claude sia attivo e `enableNewConversationShortcut` impostato su `true` |

374| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Riapri la scheda sessione Claude chiusa più di recente. Ricade al normale riapertura-editor-chiuso di VS Code quando l'ultima scheda chiusa non era una sessione Claude. Disabilita con `enableReopenClosedSessionShortcut` |415| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Riapri la scheda sessione Claude chiusa più di recente. Ricade al normale riapertura-editor-chiuso di VS Code quando l'ultima scheda chiusa non era una sessione Claude. Disabilita con `enableReopenClosedSessionShortcut` |

375| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Inserisci un riferimento al file corrente e alla selezione (richiede che l'editor sia attivo) |416| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Inserisci un riferimento al file corrente e alla selezione (richiede che l'editor sia attivo) |

417| Accept Change at Cursor | - | Accetta la modifica al cursore mentre [esamini una modifica proposta](#get-started) una modifica alla volta. Richiede Claude Code v2.1.275 o successivo |

418| Reject Change at Cursor | - | Ripristina la modifica al cursore mentre esamini una modifica proposta una modifica alla volta. Richiede Claude Code v2.1.275 o successivo |

376| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Nascondi o mostra l'attività dello strumento nella conversazione. Funziona mentre un pannello Claude o la barra laterale è visibile. Richiede Claude Code v2.1.221 o successivo |419| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Nascondi o mostra l'attività dello strumento nella conversazione. Funziona mentre un pannello Claude o la barra laterale è visibile. Richiede Claude Code v2.1.221 o successivo |

377| Rename Session Tab | - | Rinomina la sessione nella scheda Claude attiva. Richiede Claude Code v2.1.257 o successivo |420| Rename Session Tab | - | Rinomina la sessione nella scheda Claude attiva. Richiede Claude Code v2.1.257 o successivo |

378| Add Session Tab to Group | - | Aggiungi la sessione nella scheda Claude attiva a un [gruppo di sessioni](#organize-sessions-into-groups) che scegli o crei. Richiede Claude Code v2.1.257 o successivo |421| Add Session Tab to Group | - | Aggiungi la sessione nella scheda Claude attiva a un [gruppo di sessioni](#organize-sessions-into-groups) che scegli o crei. Richiede Claude Code v2.1.257 o successivo |

458| `initialPermissionMode` | - | Controlla i prompt di approvazione per le nuove conversazioni: `default`, `plan`, `acceptEdits` o `bypassPermissions`. `manual` è un alias per `default` e seleziona la modalità etichettata **Manual** nell'indicatore di modalità. Quando lo lasciate non impostato, l'estensione sceglie la modalità di autorizzazione iniziale come descritto in [Switch permission modes](/docs/it/permission-modes#switch-permission-modes). |501| `initialPermissionMode` | - | Controlla i prompt di approvazione per le nuove conversazioni: `default`, `plan`, `acceptEdits` o `bypassPermissions`. `manual` è un alias per `default` e seleziona la modalità etichettata **Manual** nell'indicatore di modalità. Quando lo lasciate non impostato, l'estensione sceglie la modalità di autorizzazione iniziale come descritto in [Switch permission modes](/docs/it/permission-modes#switch-permission-modes). |

503| `lockEditorGroups` | `true` | [Blocca i gruppi di editor che Claude avvia per le sue schede](#choose-where-claude-lives), in modo che i file aperti mentre una scheda Claude è attiva vadano a un altro gruppo. Quando disattivato, l'estensione non blocca mai un gruppo di editor. Richiede Claude Code v2.1.274 o successivo |

461| `attachOpenFile` | `true` | Aggiunge il file aperto nell'editor ai vostri messaggi e lo mostra nella casella dei prompt. Quando disattivato, viene aggiunto solo il testo selezionato. Richiede Claude Code v2.1.271 o successivo |505| `attachOpenFile` | `true` | Aggiunge il file aperto nell'editor ai vostri messaggi e lo mostra nella casella dei prompt. Quando disattivato, viene aggiunto solo il testo selezionato. Richiede Claude Code v2.1.271 o successivo |

507| `scrollToBottomOnSend` | `true` | Scorri la conversazione verso il basso quando inviate un messaggio. Quando disattivato, la conversazione rimane dove l'avete lasciata. Richiede Claude Code v2.1.275 o successivo |

464| `enableReopenClosedSessionShortcut` | `true` | Usa Cmd/Ctrl+Maiusc+T per riaprire la scheda della sessione Claude chiusa più di recente. Quando l'ultima scheda chiusa non era una sessione Claude, la scorciatoia esegue il comando di riapertura dell'editor chiuso normale di VS Code. |509| `enableReopenClosedSessionShortcut` | `true` | Usa Cmd/Ctrl+Maiusc+T per riaprire la scheda della sessione Claude chiusa più di recente. Quando l'ultima scheda chiusa non era una sessione Claude, la scorciatoia esegue il comando di riapertura dell'editor chiuso normale di VS Code. |

465| `archiveInactiveSessions` | `14` | [Archivia una sessione automaticamente](#resume-past-conversations) dopo questo numero di giorni senza attività: `1`, `2`, `7` o `14`. Impostare `0` per disattivarlo. Richiede Claude Code v2.1.265 o successivo |510| `archiveInactiveSessions` | `14` | [Archivia una sessione automaticamente](#resume-past-conversations) dopo questo numero di giorni senza attività: `1`, `2`, `7` o `14`. Impostare `0` per disattivarlo. Richiede Claude Code v2.1.265 o successivo |

511| `continueAfterReload` | `true` | Dopo un ricaricamento della finestra, Claude [continua il passaggio che è stato interrotto](#choose-where-claude-lives) nella sessione ripristinata. Richiede Claude Code v2.1.274 o successivo |

467| `focusView` | `false` | Nascondi le chiamate di strumenti, i risultati degli strumenti e il pensiero dietro righe espandibili, lasciando i vostri prompt e le risposte di Claude. L'elenco di cose da fare più recente di Claude rimane visibile; questo richiede Claude Code v2.1.225 o successivo. È anche possibile attivare/disattivare Focus view dal menu dei comandi. Richiede Claude Code v2.1.221 o successivo |513| `focusView` | `false` | Nascondi le chiamate di strumenti, i risultati degli strumenti e il pensiero dietro righe espandibili, lasciando i vostri prompt e le risposte di Claude. L'elenco di cose da fare più recente di Claude rimane visibile; questo richiede Claude Code v2.1.225 o successivo. È anche possibile attivare/disattivare Focus view dal menu dei comandi. Richiede Claude Code v2.1.221 o successivo |

470| `environmentVariables` | `[]` | Imposta le variabili di ambiente per il processo Claude. Utilizzare le impostazioni di Claude Code per la configurazione condivisa. |516| `environmentVariables` | `[]` | Imposta le variabili di ambiente per il processo Claude. Utilizzare le impostazioni di Claude Code per la configurazione condivisa. |

487* **Cambiamenti di stato**: l'estensione annuncia quando Claude inizia a lavorare, quando Claude è pronto per il tuo input e quando Claude Code inizia a compattare la conversazione.533* **Cambiamenti di stato**: l'estensione annuncia quando Claude inizia a lavorare, quando Claude è pronto per il tuo input e quando Claude Code inizia a compattare la conversazione.

488* **Errori e prompt del modello**: l'estensione annuncia gli errori nella conversazione e annuncia quando appare il [prompt di consenso per i crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits) o il [prompt di richiesta contrassegnata](/docs/it/model-config#ask-before-switching).534* **Errori e prompt del modello**: l'estensione annuncia gli errori nella conversazione e annuncia quando appare il [prompt di consenso per i crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits) o il [prompt di richiesta contrassegnata](/docs/it/model-config#ask-before-switching).

489 535

490Ogni turno nella trascrizione inizia con un'intestazione visivamente nascosta etichettata con il prompt che ha avviato il turno, in modo da poter saltare tra i turni utilizzando la navigazione per intestazioni del lettore di schermo. Puoi anche spostare lo stato attivo sulla trascrizione stessa con `Tab`, poiché l'estensione la espone come una regione etichettata, e leggerla al tuo ritmo. Mentre Claude lavora, il lettore di schermo legge un'etichetta di testo al posto dell'animazione dello spinner di avanzamento.536Mentre Claude lavora, il lettore di schermo legge un'etichetta di testo al posto dell'animazione dello spinner di avanzamento.

491 537

492Quando riapri una sessione o passi a un'altra, l'estensione non annuncia nulla: la cronologia ripristinata, i prompt di autorizzazione in sospeso e lo stato in corso rimangono silenziosi fino a quando non accade qualcosa di nuovo.538Quando riapri una sessione o passi a un'altra, l'estensione non annuncia nulla: la cronologia ripristinata, i prompt di autorizzazione in sospeso e lo stato in corso rimangono silenziosi fino a quando non accade qualcosa di nuovo.

493 539

540<h3 id="use-the-chat-panel-from-the-keyboard">

541 Utilizzare il pannello di chat dalla tastiera

542</h3>

543

544Ogni turno nella trascrizione inizia con un'intestazione visivamente nascosta etichettata con il prompt che ha avviato il turno, in modo da poter saltare tra i turni utilizzando la navigazione per intestazioni del lettore di schermo.

545

546All'interno di un turno, il lettore di schermo annuncia di chi è il messaggio mentre ti muovi attraverso di esso:

547

548* **I tuoi messaggi**: "Tu"

549* **Messaggi di Claude**: "Claude"

550* **Passaggi dello strumento**: "Claude" più il nome dello strumento, ad esempio "Claude, Bash"

551* **Blocchi di pensiero**: "Claude, thinking"

552

553Poiché l'estensione espone la trascrizione come una regione etichettata, puoi anche spostare lo stato attivo sulla trascrizione stessa con `Tab` e leggerla al tuo ritmo. Per spostare lo stato attivo al messaggio più recente o a un prompt di autorizzazione in attesa, esegui **Claude Code: Focus last message** dalla [Command Palette](#vs-code-commands-and-shortcuts).

554

555Quando un'opzione su un prompt di autorizzazione salva una regola di autorizzazione o l'accesso a una directory, la sua etichetta termina indicando dove viene salvata l'approvazione, ad esempio "tutti i progetti" o "questa sessione". Con l'opzione attiva, premi il tasto freccia `Sinistra` o `Destra` per cambiare la destinazione, e l'estensione annuncia ogni destinazione mentre vi arrivi. Puoi anche fare clic sulla destinazione nell'etichetta. I tasti freccia richiedono Claude Code v2.1.268 o versione successiva.

556

494<h2 id="vs-code-extension-vs-claude-code-cli">557<h2 id="vs-code-extension-vs-claude-code-cli">

495 Estensione VS Code vs. Claude Code CLI558 Estensione VS Code vs. Claude Code CLI

496</h2>559</h2>

543 Monitorare i processi in background606 Monitorare i processi in background

544</h3>607</h3>

545 608

546La visibilità per le attività in background nell'estensione è limitata rispetto alla CLI. Per una migliore visibilità, chiedi a Claude di generare il comando in modo da poterlo eseguire nel terminale integrato di VS Code.609Digita `/tasks` nella casella del prompt per aprire la [mappa dell'agente](#use-the-prompt-box), che elenca i task in background della sessione, come un server di sviluppo che Claude ha lasciato in esecuzione come comando shell in background. Fai clic su un task per aprire la sua scheda e fermarlo lì. Richiede Claude Code v2.1.277 o versione successiva.

547 610

548<h3 id="connect-to-external-tools-with-mcp">611<h3 id="connect-to-external-tools-with-mcp">

549 Connettere strumenti esterni con MCP612 Connettere strumenti esterni con MCP

610 </Step>673 </Step>

611</Steps>674</Steps>

612 675

613Su un provider di terze parti, l'estensione non offre funzionalità che richiedono un account claude.ai, come il tracciamento dell'utilizzo, la [dettatura vocale](/docs/it/voice-dictation) e la scheda Web per le [sessioni cloud](#resume-cloud-sessions-from-claude-ai). Un accesso claude.ai rimasto da un precedente `/login` rimane inutilizzato: l'estensione non lo invia con alcuna richiesta.676Su un provider di terze parti, l'estensione non offre funzionalità che richiedono un account claude.ai, come le barre di tracciamento dell'utilizzo, la [dettatura vocale](/docs/it/voice-dictation) e la scheda Web per le [sessioni cloud](#resume-cloud-sessions-from-claude-ai). Per informazioni su ciò che la finestra di dialogo Account e utilizzo mostra su questi accessi, consultate [Controllare account e utilizzo](#check-account-and-usage).

677

678Un accesso claude.ai rimasto da un precedente `/login` rimane inutilizzato: l'estensione non lo invia con alcuna richiesta.

614 679

615<h2 id="security-and-privacy">680<h2 id="security-and-privacy">

616 Sicurezza e privacy681 Sicurezza e privacy

workflows.md +4 −2

Details

231 231

232Prima della v2.1.216, Claude Code seguiva il link, che potrebbe posizionare il file al di fuori della posizione che hai scelto.232Prima della v2.1.216, Claude Code seguiva il link, che potrebbe posizionare il file al di fuori della posizione che hai scelto.

233 233

234In un monorepo con diverse directory `.claude/`, puoi mantenere i flussi di lavoro insieme al pacchetto a cui si applicano. A partire dalla v2.1.178, il salvataggio nella posizione del progetto scrive nella directory `.claude/workflows/` più vicina che già esiste tra la tua directory di lavoro e la radice del repository, o nella radice del repository se non ne esiste ancora nessuna. I flussi di lavoro del progetto si caricano anche da ogni `.claude/workflows/` lungo quel percorso, e quando più di uno definisce lo stesso nome Claude Code esegue quello più vicino alla directory di lavoro.234In un monorepo con diverse directory `.claude/`, puoi mantenere i flussi di lavoro insieme al pacchetto a cui si applicano. Il salvataggio nella posizione del progetto scrive nella directory `.claude/workflows/` più vicina che già esiste tra la tua directory di lavoro e la radice del repository, o nella radice del repository se non ne esiste ancora nessuna. I flussi di lavoro del progetto si caricano anche da ogni `.claude/workflows/` lungo quel percorso, e quando più di uno definisce lo stesso nome Claude Code esegue quello più vicino alla directory di lavoro.

235 235

236Se un flusso di lavoro di progetto e un flusso di lavoro personale condividono un nome, viene eseguito quello di progetto.236Se un flusso di lavoro di progetto e un flusso di lavoro personale condividono un nome, viene eseguito quello di progetto.

237 237

348 348

349Il corpo è JavaScript semplice con `await` di livello superiore. `agent()` genera un subagente, `pipeline()` ne esegue uno per elemento in un elenco, e `parallel()` esegue un insieme di attività di agente contemporaneamente e attende che tutte si completino.349Il corpo è JavaScript semplice con `await` di livello superiore. `agent()` genera un subagente, `pipeline()` ne esegue uno per elemento in un elenco, e `parallel()` esegue un insieme di attività di agente contemporaneamente e attende che tutte si completino.

350 350

351Una chiamata `agent()` si risolve in `null` se la interrompi a metà esecuzione o se raggiunge un errore API irrecuperabile. In [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), il classificatore può bloccare una chiamata `agent()` prima che il subagente inizi. Una chiamata bloccata si risolve in `null` e viene visualizzata nella vista di avanzamento dell'esecuzione con il motivo. `pipeline()` mantiene ogni `null` nell'array dei risultati, motivo per cui l'esempio termina con `.filter(Boolean)` per eliminare quelle voci.351Una chiamata `agent()` si risolve in `null` se la interrompi a metà esecuzione o se raggiunge un errore API irrecuperabile. `pipeline()` mantiene ogni `null` nell'array dei risultati, motivo per cui l'esempio termina con `.filter(Boolean)` per eliminare quelle voci.

352

353In [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode), il prompt che il tuo script passa a `agent()` non conta come una richiesta da te quando il classificatore esamina le azioni di quel subagente, perché Claude Code lo contrassegna come testo che lo script ha calcolato.

352 354

353Se passi uno `schema` su una chiamata `agent()`, quel subagente restituisce JSON corrispondente alla forma invece di prosa. Claude Code verifica lo schema prima di avviare il subagente: quando può provare che lo schema contraddice se stesso, la chiamata fallisce con un errore che nomina la contraddizione, e il subagente non viene mai avviato. Una contraddizione che può provare è una chiave `required` che `additionalProperties: false` esclude.355Se passi uno `schema` su una chiamata `agent()`, quel subagente restituisce JSON corrispondente alla forma invece di prosa. Claude Code verifica lo schema prima di avviare il subagente: quando può provare che lo schema contraddice se stesso, la chiamata fallisce con un errore che nomina la contraddizione, e il subagente non viene mai avviato. Una contraddizione che può provare è una chiave `required` che `additionalProperties: false` esclude.

354 356

worktrees.md +10 −5

Details

59 Pulire i worktree59 Pulire i worktree

60</h2>60</h2>

61 61

~~62Quando uscite da una sessione di worktree interattiva, Claude controlla il worktree per il lavoro che la rimozione eliminerebbe: file modificati o non tracciati, e nuovi commit.~~62Quando uscite da una sessione di worktree interattiva, Claude controlla il worktree per il lavoro che la rimozione eliminerebbe: file modificati o non tracciati, lavoro non committato all'interno di submodule estratti, e nuovi commit.

63 63

64* **Il worktree è pulito**: per una sessione senza nome, Claude rimuove il worktree e il suo branch automaticamente. Una sessione [denominata](/docs/it/sessions#name-your-sessions) vi chiede prima in modo da poter mantenere il worktree per dopo64* **Il worktree è pulito**: per una sessione senza nome, Claude rimuove il worktree e il suo branch automaticamente. Una sessione [denominata](/docs/it/sessions#name-your-sessions) vi chiede prima in modo da poter mantenere il worktree per dopo

65* **Il worktree ha lavoro in esso**: Claude vi chiede di mantenere o rimuovere il worktree. Mantenere preserva la directory e il branch in modo da poter tornare in seguito. Rimuovere elimina la directory del worktree e il suo branch, insieme a tutto il lavoro in essi65* **Il worktree ha lavoro in esso**: Claude vi chiede di mantenere o rimuovere il worktree. Mantenere preserva la directory e il branch in modo da poter tornare in seguito. Rimuovere elimina la directory del worktree e il suo branch, insieme a tutto il lavoro in essi

66* **Lo stato del worktree non può essere verificato**: quando Claude Code non riesce a contare i cambiamenti del worktree o non riesce a ispezionare i checkout dei suoi submodule, vi chiede piuttosto che rimuovere il worktree automaticamente. Il prompt nomina ciò che non ha potuto controllare

66 67

67Le esecuzioni non interattive con `-p` non hanno un prompt di uscita, quindi Claude non pulisce i loro worktree, e Claude Code lascia il blocco che ha preso su ognuno al momento della creazione in posizione fino a quando una [scansione di blocco stale](#clean-up-subagent-and-background-session-worktrees) successiva della sessione lo rilascia. Per rimuoverne uno, eseguite `git worktree remove`; se git rifiuta perché il worktree è bloccato, eseguite prima `git worktree unlock` su di esso.68Le esecuzioni non interattive con `-p` non hanno un prompt di uscita, quindi Claude non pulisce i loro worktree, e Claude Code lascia il blocco che ha preso su ognuno al momento della creazione in posizione fino a quando una [scansione di blocco stale](#clean-up-subagent-and-background-session-worktrees) successiva della sessione lo rilascia. Per rimuoverne uno, eseguite `git worktree remove`; se git rifiuta perché il worktree è bloccato, eseguite prima `git worktree unlock` su di esso.

68 69

101* **Modifiche ai file**: Claude Code blocca un `Edit`, `Write`, o `NotebookEdit` che ha come target un percorso nel checkout principale.102* **Modifiche ai file**: Claude Code blocca un `Edit`, `Write`, o `NotebookEdit` che ha come target un percorso nel checkout principale.

102* **Directory di lavoro del comando**: Claude Code blocca un comando Bash, PowerShell, o Monitor la cui directory di lavoro si risolve nel checkout principale, o la cui directory di lavoro non può verificare che rimanga al di fuori di esso.103* **Directory di lavoro del comando**: Claude Code blocca un comando Bash, PowerShell, o Monitor la cui directory di lavoro si risolve nel checkout principale, o la cui directory di lavoro non può verificare che rimanga al di fuori di esso.

103* **Reindirizzamenti git**: Claude Code blocca un comando Bash o Monitor che reindirizza git nel checkout principale. Il reindirizzamento può provenire attraverso `git -C`, `--git-dir`, una variabile `GIT_DIR` o `GIT_WORK_TREE`, o un `cd` nel checkout principale prima di eseguire git.104* **Reindirizzamenti git**: Claude Code blocca un comando Bash o Monitor che reindirizza git nel checkout principale. Il reindirizzamento può provenire attraverso `git -C`, `--git-dir`, una variabile `GIT_DIR` o `GIT_WORK_TREE`, o un `cd` nel checkout principale prima di eseguire git.

104* **Forma del comando**: Claude Code blocca un comando Bash o Monitor quando non può verificare dal testo del comando che qualsiasi git che il comando esegue rimane all'interno del worktree, ad esempio quando il nome del comando è calcolato a runtime o la sintassi non può essere analizzata. Claude Code dice a Claude come riscrivere il comando rifiutato, come dividerlo in comandi semplici e separati. Non potete disattivare questo controllo.105* **Forma del comando**: Claude Code blocca un comando Bash o Monitor quando non può verificare dal testo del comando che qualsiasi git che il comando esegue rimane all'interno del worktree. Questo accade, ad esempio, quando il nome del comando è calcolato a runtime, quando la sintassi non può essere analizzata, o quando un'espansione come `${!name}` o `${ command; }` potrebbe eseguire un comando che il testo non esplicita. Claude Code dice a Claude come riscrivere il comando rifiutato, come dividerlo in comandi semplici e separati. Non potete disattivare questo controllo.

105 106

106I controlli si applicano al repository da cui avete lanciato Claude Code. Coprono anche il checkout principale da cui un worktree collegato è collegato. Per i comandi PowerShell, Claude Code applica solo il controllo della directory di lavoro.107I controlli si applicano al repository da cui avete lanciato Claude Code. Coprono anche il checkout principale da cui un worktree collegato è collegato. Per i comandi PowerShell, Claude Code applica solo il controllo della directory di lavoro.

107 108

108Claude vede ogni rifiuto come un errore di strumento che nomina il worktree e dice come procedere.109Claude vede ogni rifiuto come un errore di strumento che nomina il worktree e dice come procedere. Per un comando rifiutato, consultate [cosa significa il messaggio di rifiuto e come cancellarlo](/docs/it/errors#command-blocked-by-the-worktree-isolation-checks).

109 110

110<h2 id="isolate-subagents-with-worktrees">111<h2 id="isolate-subagents-with-worktrees">

111 Isolare i subagent con worktree112 Isolare i subagent con worktree

139Quando [inviate in background](/docs/it/agent-view#send-the-session-to-the-background) una sessione `--worktree`, il suo worktree diventa un worktree di sessione in background che la scansione può rimuovere. La scansione lascia un worktree in posizione in questi casi:140Quando [inviate in background](/docs/it/agent-view#send-the-session-to-the-background) una sessione `--worktree`, il suo worktree diventa un worktree di sessione in background che la scansione può rimuovere. La scansione lascia un worktree in posizione in questi casi:

140 141

141* Il worktree contiene ancora lavoro: file modificati o non tracciati, o commit non spinti.142* Il worktree contiene ancora lavoro: file modificati o non tracciati, o commit non spinti.

143* Un submodule estratto nel worktree contiene file modificati o non tracciati, oppure Claude Code non può ispezionare i submodule del worktree. Questo controllo richiede Claude Code v2.1.274 o successivo.

142* Uno dei [quattro casi che bloccano anche la creazione del worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) si applica: Claude Code non può determinare quali driver di filtro la configurazione del repository definisce, o trova un'impostazione lì che non può disattivare.144* Uno dei [quattro casi che bloccano anche la creazione del worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) si applica: Claude Code non può determinare quali driver di filtro la configurazione del repository definisce, o trova un'impostazione lì che non può disattivare.

143* Il worktree appartiene a una sessione `--worktree` che non avete inviato in background, indipendentemente dalla sua età.145* Il worktree appartiene a una sessione `--worktree` che non avete inviato in background, indipendentemente dalla sua età.

144* Avete creato il worktree voi stessi con `git worktree add`, anche se poi avete eseguito una sessione `--worktree <name>` in esso e l'avete inviata in background.146* Avete creato il worktree voi stessi con `git worktree add`, anche se poi avete eseguito una sessione `--worktree <name>` in esso e l'avete inviata in background.

251 Cosa i worktree condividono con il checkout principale253 Cosa i worktree condividono con il checkout principale

252</h2>254</h2>

253 255

254Un worktree ottiene i suoi propri file e branch, ma condivide la directory `.git` del repository, i plugin a livello di progetto e le approvazioni di permesso salvate con il checkout principale:256Un worktree ottiene i suoi propri file e branch, ma condivide quanto segue con il checkout principale:

255 257

256* **La directory `.git` del repository**: i comandi git in un worktree scrivono nella directory `.git` condivisa del repository principale, e il [sandboxing](/docs/it/sandboxing#filesystem-isolation) consente quelle scritture, quindi comandi come `git commit` funzionano da dentro un worktree con la sandbox abilitata.258* **La directory `.git` del repository**: i comandi git in un worktree scrivono nella directory `.git` condivisa del repository principale, e il [sandboxing](/docs/it/sandboxing#filesystem-isolation) consente quelle scritture, quindi comandi come `git commit` funzionano da dentro un worktree con la sandbox abilitata.

257* **Plugin**: i plugin installati a [ambito del progetto](/docs/it/plugins-reference#plugin-installation-scopes) dal checkout principale caricano anche nei worktree dello stesso repository, quindi non è necessario reinstallarli per ogni worktree. Richiede Claude Code v2.1.200 o successivo.259* **Plugin**: i plugin installati a [ambito del progetto](/docs/it/plugins-reference#plugin-installation-scopes) dal checkout principale caricano anche nei worktree dello stesso repository, quindi non è necessario reinstallarli per ogni worktree. Richiede Claude Code v2.1.200 o successivo.

258* **Approvazioni di permesso**: scegliere "Sì, e non chiedere di nuovo" per un comando Bash in una sessione di worktree salva la regola nel `.claude/settings.local.json` del checkout principale, quindi si applica nel checkout principale e in ogni altro worktree del repository, e sopravvive alla rimozione del worktree. Su Windows e negli altri casi in cui Claude Code [non utilizza la radice del repository](/docs/it/settings#where-claude-code-looks-for-each-file), la regola rimane con quel worktree. Prima della v2.1.211, un'approvazione concessa in un worktree era salvata all'interno di quel worktree, non si applicava altrove, e era persa quando il worktree era rimosso. Vedere [dove le approvazioni sono salvate](/docs/it/permissions#permission-system).260* **Approvazioni di permesso**: scegliere "Sì, e non chiedere di nuovo" per un comando Bash in una sessione di worktree salva la regola nel `.claude/settings.local.json` del checkout principale, quindi si applica nel checkout principale e in ogni altro worktree del repository, e sopravvive alla rimozione del worktree. Su Windows e negli altri casi in cui Claude Code [non utilizza la radice del repository](/docs/it/settings#where-claude-code-looks-for-each-file), la regola rimane con quel worktree. Prima della v2.1.211, un'approvazione concessa in un worktree era salvata all'interno di quel worktree, non si applicava altrove, e era persa quando il worktree era rimosso. Vedere [dove le approvazioni sono salvate](/docs/it/permissions#permission-system).

261* **Skill, agenti e comandi non tracciati**: quando il checkout del worktree non ha una directory `.claude/skills` alla sua radice, ad esempio perché il vostro `.claude/skills` è gitignored, Claude Code carica le [skill del progetto](/docs/it/skills#where-skills-live) del checkout principale nella sessione del worktree. In un worktree con la sua propria directory `.claude/skills`, carica solo quella copia.

259 262

260Tutti e tre si applicano se create il worktree con `--worktree`, con `git worktree add`, o attraverso l'[app desktop](/docs/it/desktop#work-in-parallel-with-sessions).263 Lo stesso read-through copre `.claude/agents` e `.claude/commands`. Per le skill, il read-through richiede Claude Code v2.1.277 o successivo.

264

265Tutti questi si applicano indipendentemente dal fatto che creiate il worktree con `--worktree`, con `git worktree add`, o attraverso l'[app desktop](/docs/it/desktop#work-in-parallel-with-sessions).

261 266

262<h2 id="manage-worktrees-manually">267<h2 id="manage-worktrees-manually">

263 Gestire i worktree manualmente268 Gestire i worktree manualmente

Documentation 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC