Variabili d'ambiente - Claude Code Docs

Le variabili d’ambiente possono controllare il comportamento di Claude Code come la selezione del modello, l’autenticazione, l’instradamento delle richieste e gli interruttori di funzionalità. Molti degli stessi comportamenti possono essere configurati anche tramite un file di impostazioni, un flag CLI o un comando in-sessione come /model. Questa pagina illustra come:

Impostare le variabili d’ambiente nella shell o in un file di impostazioni
Verificare quale valore si applica quando un comportamento può essere impostato in più di un modo
Cercare le variabili che Claude Code legge
Vedere quali funzionalità smettono di funzionare quando una variabile disattiva il recupero dei flag di funzionalità

Impostare variabili d’ambiente

Una variabile che imposti nella tua shell dura per quella sessione di terminale, mentre una variabile in un file di impostazioni si applica ogni volta che claude viene eseguito.

Nella tua shell

Imposta la variabile prima di avviare claude:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

export API_TIMEOUT_MS="1200000"
claude

Per impostarla per ogni sessione, aggiungi la riga export a ~/.bashrc, ~/.zshrc, o al file di profilo della tua shell.

$env:API_TIMEOUT_MS = "1200000"
claude

Per impostarla per ogni sessione, esegui [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") e apri un nuovo terminale.

set API_TIMEOUT_MS=1200000
claude

Per impostarla per ogni sessione, esegui setx API_TIMEOUT_MS "1200000" e apri un nuovo terminale.

La riga di assegnazione non stampa nulla in caso di successo. Per confermare che la variabile è impostata, stampala nella stessa shell:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

Nei file di impostazioni

Aggiungi variabili sotto la chiave env in un file settings.json, creando il file se non esiste. Claude Code le legge direttamente dal file, quindi hanno effetto indipendentemente da come claude è stato avviato. Una sessione in esecuzione applica i valori nuovi e modificati al suo ambiente quando salvi il file, ma una funzionalità che legge le sue variabili una sola volta all’avvio, come il monitoraggio OpenTelemetry, mantiene i suoi valori di avvio fino a quando non riavvii. Rimuovere una variabile dal file non la annulla in una sessione in esecuzione; la rimozione ha effetto la prossima volta che avvii claude.

~/.claude/settings.json

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

Il file che scegli controlla a chi si applicano le variabili:

File	Si applica a
`~/.claude/settings.json`	Te, in ogni progetto
`.claude/settings.json`	Tutti coloro che lavorano nel progetto, archiviati nel controllo del codice sorgente
`.claude/settings.local.json`	Te, solo in questo progetto, ignorato da git quando Claude Code salva un’impostazione; aggiungilo al tuo gitignore se lo crei manualmente
Impostazioni gestite	Tutti nella tua organizzazione, distribuiti da un amministratore

Vedi File di impostazioni per sapere dove si trova ogni file e Precedenza delle impostazioni per come si combinano quando più di uno imposta la stessa variabile.

Precedenza

Alcuni comportamenti hanno sia una variabile d’ambiente che una chiave di impostazioni dedicata, e quale Claude Code legge per primo differisce per chiave. Per ANTHROPIC_MODEL e CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code legge prima la variabile e utilizza l’impostazione model o autoConnectIde solo quando la variabile non è impostata. Per la coppia che stai impostando, controlla la riga della variabile di seguito e la voce della chiave nel riferimento delle impostazioni. Quando la stessa variabile è impostata sia nella tua shell che in un blocco env del file di impostazioni, nella maggior parte delle sessioni si applica il valore del file di impostazioni. Claude Code scrive ogni voce env nell’ambiente del processo, sostituendo il valore ereditato dalla shell. Come i valori env interagiscono con la tua shell descrive le sessioni che mantengono invece il valore ereditato, e l’impostazione env indica quando Claude Code li applica. Alcune variabili sono trattate come casi speciali; l’impostazione env elenca le eccezioni. In un file di impostazioni puoi impostare una variabile ma non puoi rimuoverne una. Per sovrascrivere una variabile che non puoi annullare, come una CLAUDE_CODE_USE_VERTEX obsoleta esportata da un profilo di shell che non controlli, impostala su una stringa vuota nel blocco env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code tratta il valore vuoto come non impostato per la selezione del provider. I sottoprocessi ereditano comunque il valore vuoto. Tra i file di impostazioni, i valori env seguono la precedenza delle impostazioni, quindi una voce di impostazioni gestite sovrascrive la stessa variabile nelle impostazioni utente o progetto. Le impostazioni di progetto e locali non possono impostare alcune variabili, come CLAUDE_CONFIG_DIR e le variabili dell’esportatore OpenTelemetry. Le variabili che Claude Code ignora in env le elenca, insieme ai valori di disattivazione di OpenTelemetry che si applicano ancora. Il modo in cui una variabile d’ambiente interagisce con i flag CLI e i comandi in-session varia per funzionalità: --model e /model sovrascrivono ANTHROPIC_MODEL, mentre CLAUDE_CODE_EFFORT_LEVEL sovrascrive --effort e /effort. Quando una variabile interagisce con un’altra fonte di configurazione, la sua riga nell’elenco Variabili dichiara la precedenza o rimanda alla pagina che la documenta. Claude Code legge le variabili d’ambiente della shell all’avvio, quindi le modifiche ad esse hanno effetto la prossima volta che avvii claude. Le variabili impostate sotto la chiave env nei file di impostazioni vengono riapplicate a una sessione in esecuzione quando il file cambia, con l’eccezione di avvio-solo descritta in Nei file di impostazioni.

Variabili

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

Per le variabili che attivano o disattivano un comportamento, imposta 1, true, yes o on per attivarlo e 0, false, no o off per disattivarlo, con qualsiasi combinazione di maiuscole e minuscole.Alcune variabili verificano solo se le hai impostate, quindi qualsiasi valore non vuoto, incluso 0, attiva il comportamento, e lo disattivi rimuovendo la variabile o impostandola su un valore vuoto. Queste variabili funzionano in questo modo:

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
DISABLE_TELEMETRY
DISABLE_ERROR_REPORTING
CLAUDE_CODE_TMUX_TRUECOLOR
FALLBACK_FOR_ALL_PRIMARY_MODELS
IS_DEMO

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

Variabile	Scopo
`ANTHROPIC_API_KEY`	Chiave API inviata come intestazione `X-Api-Key`. Quando è impostata, questa chiave viene usata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se hai effettuato l’accesso. In modalità non interattiva (`-p`), la chiave viene sempre usata quando presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sovrascriva il tuo abbonamento. Per usare invece il tuo abbonamento, esegui `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valore personalizzato per l’intestazione `Authorization` (il valore che imposti qui avrà il prefisso `Bearer` )
`ANTHROPIC_AWS_API_KEY`	Chiave API del workspace per Claude Platform on AWS, generata nella AWS Console. Inviata come `x-api-key` e ha la precedenza su AWS SigV4
`ANTHROPIC_AWS_BASE_URL`	Sovrascrive l’URL dell’endpoint di Claude Platform on AWS. Usala per regioni personalizzate o quando instradi le richieste tramite un gateway LLM. Il valore predefinito è `https://aws-external-anthropic.{region}.api.aws`. Claude Code determina la regione con la stessa precedenza usata su Amazon Bedrock
`ANTHROPIC_AWS_WORKSPACE_ID`	Obbligatoria per Claude Platform on AWS. Inviata in ogni richiesta come intestazione `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Sovrascrive l’endpoint API per instradare le richieste tramite un proxy o un gateway. Quando è impostata su un host non di prima parte, MCP Tool Search è disattivato per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il tuo proxy inoltra i blocchi `tool_reference`. A partire dalla v2.1.196, Remote Control è disattivato quando questa variabile punta a un host diverso da `api.anthropic.com`, in linea con il suo comportamento su Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry
`ANTHROPIC_BEDROCK_BASE_URL`	Sovrascrive l’URL dell’endpoint Amazon Bedrock. Usala per endpoint Amazon Bedrock personalizzati o quando instradi le richieste tramite un gateway LLM. Consulta Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Sovrascrive l’URL dell’endpoint Amazon Bedrock Mantle. Consulta Endpoint Mantle
`ANTHROPIC_BEDROCK_REGION_PREFIX`	Prefisso del profilo di inferenza tra regioni (`us`, `eu`, `apac`, `jp`, `au` o `global`) che Claude Code prova per primo al posto di quello derivato dalla regione AWS. Ignorata nelle regioni AWS GovCloud. Richiede Claude Code v2.1.224 o successiva. Consulta Amazon Bedrock
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Livello di servizio di Amazon Bedrock (`default`, `flex` o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Consulta Amazon Bedrock
`ANTHROPIC_BETAS`	Elenco separato da virgole di valori aggiuntivi dell’intestazione `anthropic-beta` da includere nelle richieste API. Claude Code invia già le intestazioni beta di cui ha bisogno; usa questa variabile per aderire a una beta dell’API Anthropic prima che Claude Code aggiunga il supporto nativo. A differenza del flag `--betas`, che richiede l’autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione, incluso l’abbonamento Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	Intestazioni personalizzate da aggiungere alle richieste (formato `Name: Value`, separate da un a capo per più intestazioni). Se un nome o un valore contiene un carattere che un’intestazione HTTP non può trasportare, come una virgoletta curva o uno spazio a larghezza zero, la richiesta fallisce con un errore che identifica la coppia in base alla posizione. Richiede Claude Code v2.1.227 o successiva. Valore dell’intestazione di richiesta non valido elenca l’esatto set di caratteri e dove viene eseguito il controllo. Un valore che imposta un’intestazione di credenziali, organizzazione o tenant, instradamento o comportamento dell’API, come `Authorization` o `Host`, conta come impostazione che richiede approvazione quando viene fornito dalle impostazioni gestite dal server. Dalle impostazioni di progetto o locali, un valore di questo tipo segue le regole su quando si applicano i valori `env`
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID del modello da aggiungere come voce personalizzata nel selettore `/model`. Usala per rendere selezionabile un modello non standard o specifico del gateway senza sostituire gli alias integrati. Consulta Configurazione del modello
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Descrizione visualizzata per la voce del modello personalizzato nel selettore `/model`. Il valore predefinito è `Custom model (<model-id>)` quando non è impostata
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	Nome visualizzato 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, altrimenti l’ID del modello
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Elenco separato da virgole delle funzionalità supportate dal modello personalizzato, ad esempio `effort,thinking`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID del modello a cui si risolve l’alias `fable` e ID che Claude Code riconosce come modello Fable per il fallback automatico del modello sui provider di terze parti. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Descrizione visualizzata per il modello Fable fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Nome visualizzato per il modello Fable fissato nel selettore `/model`. Quando non è impostato, la riga mostra il nome del modello se Claude Code riconosce l’ID fissato, altrimenti l’ID fissato. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole delle funzionalità supportate dal modello Fable fissato, ad esempio `effort,thinking`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	ID del modello a cui si risolve l’alias `haiku`, usato anche per le funzionalità in background. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Descrizione visualizzata per il modello Haiku fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Nome visualizzato per il modello Haiku fissato nel selettore `/model`. Quando non è impostato, la riga mostra il nome del modello se Claude Code riconosce l’ID fissato, altrimenti l’ID fissato. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole delle funzionalità supportate dal modello Haiku fissato, ad esempio `effort,thinking`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_MODEL`	Modello con cui le nuove sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva. Consulta Impostare un modello predefinito per le nuove sessioni
`ANTHROPIC_DEFAULT_OPUS_MODEL`	ID del modello a cui si risolve l’alias `opus` e che `opusplan` usa mentre il Plan Mode è attivo. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descrizione visualizzata per il modello Opus fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nome visualizzato per il modello Opus fissato nel selettore `/model`. Quando non è impostato, la riga mostra il nome del modello se Claude Code riconosce l’ID fissato, altrimenti l’ID fissato. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole delle funzionalità supportate dal modello Opus fissato, ad esempio `effort,thinking`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL`	ID del modello a cui si risolve l’alias `sonnet` e che `opusplan` usa quando il Plan Mode non è attivo. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Descrizione visualizzata per il modello Sonnet fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Nome visualizzato per il modello Sonnet fissato nel selettore `/model`. Quando non è impostato, la riga mostra il nome del modello se Claude Code riconosce l’ID fissato, altrimenti l’ID fissato. Consulta Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole delle funzionalità supportate dal modello Sonnet fissato, ad esempio `effort,thinking`. Consulta Configurazione del modello
`ANTHROPIC_FEDERATION_RULE_ID`	ID della regola di federazione per Workload Identity Federation. Quando la imposti insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno priorità superiore rispetto alla tua credenziale `/login`. Consulta precedenza di autenticazione
`ANTHROPIC_FOUNDRY_API_KEY`	Chiave API per l’autenticazione Microsoft Foundry (consulta Microsoft Foundry)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Token bearer per l’autenticazione Microsoft Foundry, come un token di accesso Microsoft Entra. Claude Code lo invia come intestazione `Authorization: Bearer`. Ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita di Azure. Consulta Microsoft Foundry. Richiede Claude Code v2.1.203 o successiva
`ANTHROPIC_FOUNDRY_BASE_URL`	URL di base completo per la risorsa Microsoft Foundry (ad esempio, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulta Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Obbligatoria se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostata (consulta Microsoft Foundry)
`ANTHROPIC_MODEL`	Nome dell’impostazione del modello da usare (consulta Configurazione del modello)
`ANTHROPIC_ORGANIZATION_ID`	ID dell’organizzazione per Workload Identity Federation. Impostala insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Consulta precedenza di autenticazione
`ANTHROPIC_PROFILE`	Nome del profilo Anthropic con cui autenticarsi, come uno creato da `ant auth login` o accedendo a un account Console senza una chiave API. Consulta precedenza di autenticazione
`ANTHROPIC_SMALL_FAST_MODEL`	[DEPRECATA] Nome del modello di classe Haiku per le attività in background
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Sovrascrive la regione AWS per il modello di classe Haiku quando usi Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, ha effetto solo quando è impostata anche `ANTHROPIC_DEFAULT_HAIKU_MODEL` o la deprecata `ANTHROPIC_SMALL_FAST_MODEL`, poiché altrimenti Amazon Bedrock esegue le attività in background sul modello Sonnet predefinito o sul modello principale nella regione della sessione
`ANTHROPIC_VERTEX_BASE_URL`	Sovrascrive l’URL dell’endpoint di Google Cloud’s Agent Platform. Usala per endpoint personalizzati di Google Cloud’s Agent Platform o quando instradi le richieste tramite un gateway LLM. Consulta Google Cloud’s Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID del progetto GCP a cui sono indirizzate le richieste a Google Cloud’s Agent Platform. Consulta Configurare le credenziali GCP
`ANTHROPIC_WORKSPACE_ID`	ID del workspace per la federazione delle identità dei carichi di lavoro. Impostala quando la tua regola di federazione è limitata a più di un workspace, in modo che lo scambio di token sappia quale workspace usare come destinazione
`API_FORCE_IDLE_TIMEOUT`	Sovrascrive il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Imposta `0` per disattivare il timeout, ad esempio quando un gateway lento o un modello locale fa pause più lunghe di 5 minuti tra un blocco e l’altro, oppure `1` per mantenerlo attivo per ogni provider. Quando non è impostata, il timeout è attivo sui provider diversi dall’API Anthropic diretta, da Claude Platform on AWS e da Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostata. I watchdog dello stream funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando imposti `0` qui
`API_TIMEOUT_MS`	Timeout per le richieste API in millisecondi (predefinito: 600000, ovvero 10 minuti; massimo: 2147483647). Aumentalo quando le richieste vanno in timeout su reti lente o quando instradi le richieste tramite un proxy. I valori superiori al massimo causano l’overflow del timer sottostante e fanno fallire immediatamente le richieste
`AWS_BEARER_TOKEN_BEDROCK`	Chiave API di Amazon Bedrock per l’autenticazione (consulta Chiavi API di Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Timeout predefinito per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 120000, ovvero 2 minuti). Un valore predefinito superiore a 30 minuti diventa anche il limite di tempo predefinito per i comandi in background. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva
`BASH_MAX_OUTPUT_LENGTH`	Numero massimo di caratteri dell’output bash che Claude Code rilegge nel risultato di un comando (predefinito: 30000; massimo: 150000). Se configuri l’impostazione `bashOutputMaxChars`, Claude Code ignora questa variabile. Consulta Limiti di output
`BASH_MAX_TIMEOUT_MS`	Timeout massimo che il modello può impostare per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 600000, ovvero 10 minuti). Il limite effettivo è il maggiore tra questo valore e `BASH_DEFAULT_TIMEOUT_MS`. Un limite effettivo superiore a 2 ore diventa anche il limite di tempo massimo per i comandi in background. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva
`BETA_TRACING_ENDPOINT`	Endpoint OTLP per il tracing beta dettagliato: con `ENABLE_BETA_TRACING_DETAILED=1`, log e trace vengono inviati lì invece che agli exporter configurati. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali
`CCR_FORCE_BUNDLE`	Imposta su `1` per forzare `claude --cloud` a creare un bundle del tuo repository locale e caricarlo invece di clonarlo dal suo remote
`CLAUDECODE`	Impostata su `1` nei sottoprocessi avviati da Claude Code (strumenti Bash e PowerShell, sessioni tmux, comandi degli hook, comandi della riga di stato, sottoprocessi dei server MCP stdio). Anche le estensioni IDE la impostano nei loro terminali integrati. Usala per rilevare quando uno script è in esecuzione all’interno di un sottoprocesso avviato da Claude Code. Per verificare se il processo corrente è stato avviato direttamente da una chiamata a uno strumento o da un hook, anziché all’interno di un server MCP stdio avviato da Claude Code, usa invece `CLAUDE_CODE_CHILD_SESSION`
`CLAUDE_AFK_COUNTDOWN_MS`	Quanti millisecondi prima della continuazione automatica compare il conto alla rovescia sullo schermo in una finestra di dialogo `AskUserQuestion` senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di continuazione automatica. Non ha effetto a meno che la continuazione automatica non sia attiva; consulta l’impostazione `askUserQuestionTimeout` e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successiva
`CLAUDE_AFK_TIMEOUT_MS`	Quanti millisecondi di inattività prima che una finestra di dialogo `AskUserQuestion` senza risposta prosegua automaticamente senza di te. La continuazione automatica è disattivata per impostazione predefinita; attivala con l’impostazione `askUserQuestionTimeout`. Questa variabile è un override per demo e test automatizzati: quando è impostata, ha la precedenza su quell’impostazione e attiva la continuazione automatica anche quando l’impostazione non è configurata o è `never`. Impostare `0` non disattiva il timeout; chiude immediatamente la finestra di dialogo. Nella v2.1.198 e nella v2.1.199, la continuazione automatica era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successiva
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	Imposta su `1` per disattivare tutti i tipi di subagent integrati, come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti dell’SDK che vogliono partire da zero. Questo rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata allo strumento Agent omette `subagent_type`. Una chiamata di questo tipo fallisce quindi con `subagent_type is required`
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	Imposta su `1` per omettere il prefisso `mcp__<server>__` nei nomi degli strumenti dei server MCP creati tramite SDK. Gli strumenti usano i loro nomi originali. Solo per l’uso con l’SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumenti `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog dello stream è attivo, il valore predefinito aumenta di conseguenza, come descritto in Gestire risposte API lente o bloccate. Il timer si azzera a ogni evento di avanzamento dello streaming; se non arriva alcun avanzamento entro la finestra, Claude Code interrompe il subagent e segnala lo stallo all’agente padre
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Imposta la percentuale (1-100) della finestra di compattazione automatica alla quale si attiva la compattazione automatica. Usa valori più bassi come `50` per compattare prima; la variabile non può alzare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo nelle sessioni che compattano prima del limite di contesto del modello. Si applica sia alle conversazioni principali sia ai subagent
`CLAUDE_AUTO_BACKGROUND_TASKS`	Imposta su `1` per forzare l’attivazione dello spostamento automatico in background delle attività degli agenti a lunga esecuzione. Quando è attiva, i subagent vengono spostati in background dopo circa due minuti di esecuzione. Attiva anche lo spostamento automatico in background delle chiamate lunghe agli strumenti MCP in modalità non interattiva su Claude Code v2.1.212 o successiva
`CLAUDE_AX_PREPARK_MS`	In modalità screen reader, quanti millisecondi Claude Code attende prima di scrivere una riga nuova o modificata. Predefinito `0`, quindi Claude Code non attende. Prima della v2.1.287, il valore predefinito era `50`. Claude Code limita l’attesa a `5000`. Richiede Claude Code v2.1.233 o successiva
`CLAUDE_AX_SCREEN_READER`	Imposta su `1` per generare un output adatto agli screen reader: testo semplice senza bordi decorativi o animazioni. Imposta su `0` per forzare la disattivazione della modalità screen reader anche quando `axScreenReader` è `true`. Il flag `--ax-screen-reader` ha la precedenza. Richiede Claude Code v2.1.181 o successiva
`CLAUDE_AX_STARTUP_QUIET_MS`	In modalità screen reader, per quanti millisecondi Claude Code trattiene il primo rendering dell’interfaccia dopo la riga di conferma dell’avvio, in modo che il tuo screen reader possa leggere la riga per intero prima che nuovo output la interrompa. Predefinito `3000`. Imposta `0` per eseguire subito il rendering. Claude Code limita l’attesa a `600000` (10 minuti). Il primo tasto che premi termina l’attesa in anticipo. Richiede Claude Code v2.1.217 o successiva
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Torna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale
`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS`	Timeout in millisecondi per il watchdog di inattività dello streaming a livello di byte; quando è impostata, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia invariato il watchdog a livello di evento. Claude Code limita questa variabile a un valore compreso tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successiva
`CLAUDE_CLIENT_PRESENCE_FILE`	Percorso di un file che uno strumento esterno, come un listener del blocco schermo, crea quando sblocchi lo schermo ed elimina quando lo blocchi. Finché il file esiste, Claude Code salta le notifiche push mobili di Remote Control, così smetti di ricevere notifiche push mentre usi attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per ogni evento che attiva una notifica push, anziché interrogarlo periodicamente. Richiede Claude Code v2.1.181 o successiva
`CLAUDE_CODE_ACCESSIBILITY`	Imposta su `1` per mantenere visibile il cursore nativo del terminale e disattivare l’indicatore del cursore a testo invertito. Consente agli ingranditori dello schermo come Zoom di macOS di seguire la posizione del cursore
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`	Imposta su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria
`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT`	Imposta su `1` per ridisegnare l’intero schermo a ogni frame nel rendering a schermo intero invece di inviare aggiornamenti incrementali. Usala se la modalità a schermo intero mostra frammenti di testo obsoleti o fuori posto. Claude Code la attiva automaticamente per le sessioni in background e per la vista agenti su Windows
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Imposta su `1` per inviare il parametro effort con ogni richiesta, anche quando Claude Code non riconosce l’ID del modello come compatibile con effort. Usala quando instradi le richieste tramite un gateway LLM o un provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort a livello di API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, restano comunque esclusi, così le richieste non falliscono
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	Intervallo in millisecondi con cui le credenziali devono essere aggiornate (quando usi `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Imposta su `0` per impedire a Claude Code di aprire automaticamente il browser quando viene pubblicato un nuovo artefatto
`CLAUDE_CODE_ARTIFACT_COMMENTS`	Imposta su `0` per impedire a Claude di leggere e rispondere ai commenti su un artefatto. Non ha effetto quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha disattivato gli artefatti. Richiede Claude Code v2.1.221 o successiva
`CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT`	Imposta su `0` per impedire a Claude di rispondere autonomamente ai commenti che gli vengono inviati. Richiede Claude Code v2.1.228 o successiva
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Imposta su `0` per omettere il blocco di attribuzione, che contiene la versione del client e un’impronta del prompt, dall’inizio del prompt di sistema. La memorizzazione nella cache su una connessione diretta all’API Anthropic non è influenzata in nessun caso. In alcune configurazioni con connessione diretta, Claude Code mantiene il blocco nelle richieste al classificatore della modalità auto anche quando imposti `0`. In Blocco di attribuzione del prompt di sistema, verifica quali connessioni e credenziali sono interessate. Prima della v2.1.181 il blocco includeva un token per richiesta sugli URL di base personalizzati e sulle connessioni Microsoft Foundry, quindi su quelle versioni impostala su `0` quando il tuo gateway LLM memorizza nella cache in base al corpo della richiesta o inoltra le richieste a un provider di terze parti, oppure quando ti connetti direttamente a Microsoft Foundry
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è attiva, secondi tra i promemoria a Claude per controllare i subagent in background ancora in esecuzione. Accetta solo un intero semplice da `1` a `86400`; qualsiasi altro valore o grafia viene letto come non impostato. Quando non è impostata, non ci sono promemoria di controllo. Richiede Claude Code v2.1.248 o successiva
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Imposta la finestra di compattazione automatica in token, da `100000` a `1000000`. Accetta solo un intero semplice come `500000`: un valore come `500k` viene letto come `500` e viene portato al minimo di 100K. La finestra effettiva è inoltre limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, sul flag `--autocompact` e sull’impostazione `autoCompactWindow`. Il valore `used_percentage` della riga di stato si misura sempre rispetto all’intera finestra di contesto del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Sovrascrive la connessione IDE automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando viene avviato nel terminale integrato di un IDE supportato. Imposta su `false` per impedirlo. Imposta su `true` per forzare un tentativo di connessione quando il rilevamento automatico non riesce, ad esempio quando tmux nasconde il terminale padre. Ha la precedenza sull’impostazione di configurazione globale `autoConnectIde`
`CLAUDE_CODE_AUTO_MODE_SERVER`	Controlla se Claude Code chiede al server di esaminare le azioni della modalità auto. Imposta su `0` per usare invece le richieste al classificatore di Claude Code stesso. Su una connessione diretta all’API Anthropic, richiede la v2.1.281 o successiva. La sezione collegata elenca quali sessioni interpellano il server quando la variabile non è impostata, e da quale versione. Richiede Claude Code v2.1.271 o successiva
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tempo in millisecondi che Claude Code attende affinché la catena predefinita dei provider di credenziali AWS produca le credenziali prima che la richiesta fallisca con `AWS default-chain credential resolve timed out` (predefinito: `60000`). Aumentalo quando un passaggio della tua catena richiede legittimamente più tempo, come un accesso SSO basato su browser con MFA tramite un wrapper come `aws-vault`. Si applica ovunque Claude Code firmi con la catena predefinita: Amazon Bedrock, Claude Platform on AWS e l’endpoint Mantle. Richiede Claude Code v2.1.207 o successiva
`CLAUDE_CODE_BASH_EDIT_DIFF`	Imposta su `0` per disattivare il diff dei file modificati durante l’esecuzione di un comando Bash, oppure su `1` per registrarlo in ogni modalità di permesso. Ha la precedenza sull’impostazione `bashEditDiffEnabled`. Richiede Claude Code v2.1.269 o successiva
`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`	Imposta su `0` per fare in modo che una sessione non interattiva segnali al proprio host uno stato inattivo alla fine di ogni turno, anche mentre è ancora in corso lavoro in background. Per impostazione predefinita, la sessione continua a segnalare uno stato in esecuzione dopo la fine del turno finché il lavoro in background, come un agente in background o un’esecuzione di un workflow, è ancora attivo. Questo impedisce a un host che osserva lo stato, come un elenco di sessioni remote, di annunciare che Claude è in attesa del tuo input a metà lavoro. I comandi shell in background, come un server di sviluppo, non mantengono lo stato in esecuzione. Il valore predefinito dello stato in esecuzione e la disattivazione con `0` richiedono Claude Code v2.1.269 o successiva; nelle versioni precedenti, imposta `1` per mantenere lo stato in esecuzione
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Impostata automaticamente nei sottoprocessi dello strumento Bash e dei comandi degli hook mentre la sessione ha una connessione Remote Control attiva, e rimossa al termine della connessione. Il valore è l’ID della sessione nel formato `session_`, lo stesso identificatore che compare nell’URL `claude.ai/code` della sessione, così uno script può collegarsi alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successiva. Nelle sessioni cloud, leggi invece `CLAUDE_CODE_REMOTE_SESSION_ID`
`CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`	Imposta su `0` per fare in modo che Claude Code legga il byte `0x08`, scritto anche `^H`, come semplice Backspace, oppure su `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono il comportamento predefinito della piattaforma. Per impostazione predefinita, Claude Code lo legge come Ctrl+Backspace su Windows, tranne quando `TERM_PROGRAM` è `mintty` o `TERM` è `cygwin`, e come semplice Backspace su macOS e Linux. Imposta `0` in un terminale Windows in cui Backspace elimina un’intera parola
`CLAUDE_CODE_CERT_STORE`	Elenco separato da virgole delle origini dei certificati CA per le connessioni TLS. `bundled` è il set di CA Mozilla fornito con Claude Code. `system` è l’archivio di attendibilità del sistema operativo, letto solo sui runtime con `tls.getCACertificates`: il binario nativo, oppure Node 22.15 o successivo per le installazioni npm. Consulta Archivio dei certificati CA. Il valore predefinito è `bundled,system`
`CLAUDE_CODE_CHILD_SESSION`	Impostata su `1` nei sottoprocessi che Claude Code avvia tramite gli strumenti Bash, PowerShell e Monitor, i comandi degli hook e i comandi della riga di stato. Non è impostata per i sottoprocessi dei server MCP stdio, che sono di lunga durata e sopravvivono alla sessione che li ha avviati. A differenza di `CLAUDECODE`, viene impostata solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione annidata da un `claude` di primo livello avviato in un terminale integrato nell’IDE. Una TUI `claude` interattiva annidata avviata in questo modo viene esclusa automaticamente da `--resume`, `--continue`, dalla cronologia con freccia su e dall’elenco `claude agents`. Le sessioni non interattive `claude -p` vengono comunque salvate. Imposta `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per sovrascrivere questa esclusione. Richiede Claude Code v2.1.172 o successiva
`CLAUDE_CODE_CLIENT_CERT`	Percorso del file del certificato client per l’autenticazione mTLS
`CLAUDE_CODE_CLIENT_KEY`	Percorso del file della chiave privata del client per l’autenticazione mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Passphrase per la CLAUDE_CODE_CLIENT_KEY crittografata (facoltativa)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Rimossa nella v2.1.186 e ora non ha alcun effetto. In precedenza impostava un timeout separato per la fase di connessione, TLS e intestazioni di risposta di una richiesta API in streaming. Usa `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase delle intestazioni di risposta di una richiesta in streaming, consulta `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Sovrascrive il percorso del file di log di debug. Nonostante il nome, si tratta di un percorso di file, non di una directory. Richiede che la modalità di debug sia attivata separatamente tramite `--debug`, `/debug` o la variabile d’ambiente `DEBUG`: impostare solo questa variabile non attiva il logging. Il flag `--debug-file` fa entrambe le cose contemporaneamente. Il valore predefinito è `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	Livello minimo di log scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l’output completo del comando della riga di stato, oppure alza a `error` per ridurre il rumore
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Imposta su `1` per disattivare il supporto della finestra di contesto da 1M. Quando è impostata, le varianti dei modelli da 1M non sono disponibili nel selettore dei modelli e Claude Code limita a una finestra di 200K le sessioni sui modelli con una finestra nativa da 1M, come Sonnet 5.5 e i modelli Fable; consulta Contesto esteso per sapere come viene applicato il limite. Utile per ambienti aziendali con requisiti di conformità. Per il suo ruolo nella correzione della finestra per un ID di modello `[1m]` non riconosciuto, consulta Correggere la finestra per un gateway o un ID di modello personalizzato
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Imposta su `1` per disattivare il ragionamento adattivo su Opus 4.6 e Sonnet 4.6 e ripiegare sul budget di ragionamento fisso controllato da `MAX_THINKING_TOKENS`. Non ha effetto sui modelli Fable, su Sonnet 5 e successivi o su Opus 4.7 e successivi, che usano sempre il ragionamento adattivo
`CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION`	Imposta su `1` per impedire a Claude Code di unire per chiave i blocchi `env` delle impostazioni gestite tra le origini di amministrazione, in modo che si applichi solo l’intero blocco `env` dell’origine con priorità più alta, come prima della v2.1.223. Impostala nell’ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.223 o successiva
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Imposta su `1` per disattivare lo strumento 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
`CLAUDE_CODE_DISABLE_AGENT_VIEW`	Imposta su `1` per disattivare gli agenti in background e la vista agenti: `claude agents`, `--bg`, `/background` e il supervisore on demand. Equivalente all’impostazione `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Imposta su `1` per disattivare il rendering a schermo intero e usare il renderer classico sullo schermo principale. La conversazione resta nello scrollback nativo del terminale, così `Cmd+f` e la modalità copia di tmux funzionano come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull’impostazione `tui`. Puoi anche passare con `/tui default`. Non si applica alle sessioni in background aperte dalla vista agenti, che usano sempre il rendering a schermo intero
`CLAUDE_CODE_DISABLE_ARTIFACT`	Imposta su `1` per disattivare lo strumento Artifact, che pubblica l’output della sessione come pagina web privata su claude.ai. Una volta impostata, nessun file di impostazioni riattiva lo strumento. Per disattivare invece lo strumento da un file di impostazioni, imposta `enableArtifact` su `false`; anche la chiave deprecata `disableArtifact` lo disattiva
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Imposta su `1` per disattivare l’elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file
`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`	Imposta su `1` per fare in modo che un processo Claude Code esegua da sé il comando `gcpAuthRefresh` o `awsAuthRefresh` invece di attendere mentre un altro processo lo esegue. Richiede Claude Code v2.1.286 o successiva
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Imposta su `1` per disattivare la memoria automatica. Imposta su `0` per forzare l’attivazione della memoria automatica anche quando la modalità `--bare` o `autoMemoryEnabled: false` la disattiverebbero. Quando è disattivata, Claude non crea né carica i file di memoria automatica
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Imposta su `1` per disattivare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` negli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT`	Imposta su `1` per impedire a Claude Code di trattare una risposta in streaming di 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, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche il flusso come server-sent events; Claude Code legge quindi il corpo senza intestazione come server-sent events. Richiede Claude Code v2.1.239 o successiva
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Imposta su `1` per saltare il controllo che verifica che una risposta in streaming di Amazon Bedrock abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un gateway o un proxy sta trasformando la risposta. Configura il gateway in modo che inoltri l’intestazione `Content-Type` e il corpo senza modifiche, anziché impostare questa variabile. Richiede Claude Code v2.1.208 o successiva
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	Imposta su `1` per arrestare, in una sessione in background, i comandi shell in background in esecuzione, i workflow dinamici e, a partire dalla v2.1.198, i subagent in background quando il supervisore arresta, riavvia o aggiorna il processo di quella sessione, invece di passarli al processo successivo della sessione. Riguarda solo quel passaggio: mettere in background una sessione con `←` o `/background` trasferisce comunque il lavoro in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successiva
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Imposta su `1` per impedire a Claude Code di terminare i comandi shell in background in caso di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è rimasta inattiva per 30 minuti senza turni o subagent in esecuzione. Windows non ha un segnale di pressione sulla memoria, quindi lì questa variabile non ha effetto. Richiede Claude Code v2.1.193 o successiva
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Imposta su `1` per disattivare le skill e i workflow inclusi in Claude Code: le skill e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma vengono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; nascondilo invece con `DISABLE_DOCTOR_COMMAND`. Le skill provenienti dai plugin, da `.claude/skills/` e da `.claude/commands/` non sono interessate. Equivalente all’impostazione `disableBundledSkills`
`CLAUDE_CODE_DISABLE_CFC_PROMPT`	Imposta su `1` per mantenere disponibili gli strumenti del browser di Claude in Chrome omettendo la sezione Chrome del prompt di sistema e la skill inclusa `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono le proprie indicazioni sul browser. Richiede Claude Code v2.1.257 o successiva
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Imposta su `1` per impedire il caricamento nel contesto di qualsiasi file di memoria CLAUDE.md, inclusi i file di memoria utente, di progetto e di memoria automatica
`CLAUDE_CODE_DISABLE_CRON`	Imposta su `1` per disattivare le attività pianificate. La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse quelle già in esecuzione a metà sessione
`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`	Imposta su `1` per disattivare il limite di tempo sulle richieste di conferma per la rimozione di percorsi critici. In modalità `auto` Claude Code invia invece queste rimozioni al classificatore, e in modalità `bypassPermissions` la richiesta attende la tua risposta. Impostala nell’ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Imposta su `1` per rimuovere dalle richieste API gli header `anthropic-beta` pre-release, i campi del body associati e i campi beta dello schema degli strumenti come `defer_loading` ed `eager_input_streaming`. Usala quando un gateway proxy rifiuta le richieste con un errore `Unexpected value(s)` per l’header `anthropic-beta` o un errore `Extra inputs are not permitted`. Disattivare le funzionalità pre-release elenca cosa rimuove la variabile, incluso MCP Tool Search, e cosa Claude Code continua a inviare
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Imposta su `1` per disattivare i subagent Explore e Plan integrati. Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il plan mode legge i file direttamente anziché avviare gli agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere tutti i tipi di subagent integrati nell’Agent SDK o in modalità non interattiva, usa invece `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successiva
`CLAUDE_CODE_DISABLE_FAST_MODE`	Imposta su `1` per disattivare la modalità veloce
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Imposta su `1` per disattivare i sondaggi sulla qualità della sessione “How is Claude doing?”. I sondaggi sono disattivati anche quando è impostata `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non li riattivi. Per impostare una frequenza di campionamento invece di disattivarli del tutto, usa l’impostazione `feedbackSurveyRate`. Consulta Sondaggi sulla qualità della sessione
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Imposta su `1` per disattivare il checkpointing dei file. Il comando `/rewind` non potrà ripristinare le modifiche al codice. Sovrascrive l’impostazione `fileCheckpointingEnabled`
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Imposta su `1` per rimuovere dal contesto di Claude le istruzioni integrate sui workflow di commit e PR e lo snapshot dello stato git. Utile quando usi le tue skill per il workflow git. Quando è impostata, ha la precedenza sull’impostazione `includeGitInstructions`
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Imposta su `1` per impedire la rimappatura automatica di Opus 4.0 e 4.1 alla versione Opus corrente sull’API Anthropic. Usala quando vuoi intenzionalmente fissare un modello più vecchio. La rimappatura non viene eseguita su Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK`	Imposta su `1` per impedire a Claude Code su Amazon Bedrock e Google Cloud’s Agent Platform di passare a un modello più vecchio quando il tuo account perde l’accesso al modello di una sessione a metà sessione; la richiesta rifiutata fallisce invece immediatamente. Una catena di modelli di fallback che configuri passa comunque a un altro modello in caso di quel rifiuto, e i controlli dei modelli all’avvio eseguono comunque il fallback all’avvio. Richiede Claude Code v2.1.285 o successiva
`CLAUDE_CODE_DISABLE_MOUSE`	Imposta su `1` per disattivare il tracciamento del mouse nel rendering a schermo intero. Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Usala per mantenere il comportamento nativo del terminale di copia alla selezione
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Imposta su `1` per disattivare la gestione di clic, trascinamento e passaggio del mouse nel rendering a schermo intero mantenendo lo scorrimento con la rotellina. Usala quando vuoi che lo scorrimento con la rotellina funzioni in Claude Code ma non vuoi che i clic posizionino il cursore, espandano l’output degli strumenti o aprano link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando sono impostate entrambe. Richiede Claude Code v2.1.195 o successiva
`CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION`	Imposta su `1` per impedire a Claude Code di rileggere il certificato client e la chiave mTLS quando una richiesta API fallisce con un errore a livello di connessione, come un reset della connessione o un errore di handshake TLS. Con la ricarica disattivata, Claude Code carica i file ruotati solo alla successiva applicazione delle impostazioni o al successivo avvio. Richiede Claude Code v2.1.232 o successiva
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Imposta su qualsiasi valore non vuoto, come `1`, per disattivare il traffico di rete non essenziale: aggiornamenti automatici, telemetria, segnalazione degli errori, il comando `/feedback`, il feedback redatto da Claude, le note di rilascio, i controlli del badge di stato di PR e MR e i controlli di disponibilità come quello della modalità veloce. Interrompe anche le esecuzioni in background delle origini `command` dei plugin, che sono comandi locali anziché traffico di rete, perché possono attivare installazioni di dipendenze. Impostarla su `0` o `false` disattiva comunque questo traffico, a differenza della maggior parte delle variabili di attivazione/disattivazione; rimuovi la variabile per consentirlo di nuovo. Disattiva anche il recupero dei feature flag, il che rende non disponibili Remote Control e le altre funzionalità che richiedono il recupero dei feature flag. L’installazione automatica del marketplace ufficiale dei plugin non è inclusa; disattivala con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sul rilevamento dei modelli del gateway, che ha un proprio consenso esplicito
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Imposta su `1` per disattivare il fallback non in streaming quando una richiesta in streaming fallisce a metà stream. Gli errori di streaming vengono invece propagati al livello dei nuovi tentativi. Utile quando un proxy o un gateway fa sì che il fallback produca un’esecuzione duplicata degli strumenti
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Imposta su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre stai digitando nel terminale o il terminale ha il focus. Per impostazione predefinita lo strumento salta sia la notifica desktop sia la notifica push mobile quando rileva attività recente della tastiera o il focus sul terminale. Questa variabile disattiva solo quel controllo locale, quindi il server può comunque sopprimere la notifica push mobile quando rileva che sei attivo. Richiede Claude Code v2.1.193 o successiva
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Imposta su `1` per disattivare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo su una macchina. Se in quel momento la variabile è impostata, Claude Code salta la registrazione in modo permanente. Rimuovere la variabile in seguito non annulla il salto. Esegui `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento
`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`	Imposta su `1` per impedire a Claude Code di eseguire i tuoi hook `Notification` per le richieste di permesso senza risposta nelle sessioni in cui Claude Code le invia alla callback `canUseTool` dell’Agent SDK, che è il modo in cui Claude Desktop e l’estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni del terminale. Richiede Claude Code v2.1.233 o successiva
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Imposta su `1` per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni in container o CI che non devono caricare skill fornite dall’operatore
`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`	Imposta su `1` per disattivare il controllo dello strumento PowerShell che nega i comandi integrati di `cmd` `rd`, `rmdir`, `del` ed `erase` su un percorso di sistema, come la radice di un’unità o la tua directory home. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.283 o successiva
`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`	Imposta su `1` per disattivare il controllo dei percorsi critici per un `rm` ricorsivo il cui obiettivo è interamente l’output di una sostituzione di comando, come `rm -rf "$(pwd)"`. Gli altri controlli dei percorsi critici continuano a essere eseguiti. Impostala nell’ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Imposta su `1` per disattivare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta in background al modello piccolo/veloce che genera un titolo per la sessione
`CLAUDE_CODE_DISABLE_THINKING`	Imposta su `1` per omettere completamente il parametro `thinking` dalle richieste API. Si tratta di un’opzione di compatibilità per proxy e gateway che rifiutano il parametro. Sui modelli che ragionano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque ragionare. Per disattivare esplicitamente il ragionamento esteso sull’API Anthropic, usa invece `MAX_THINKING_TOKENS=0`. Nessuna delle due variabili disattiva il ragionamento su Opus 5.5, Sonnet 5.5 o sui modelli Fable, per i quali il ragionamento non può essere disattivato. Sui provider di terze parti, anche `MAX_THINKING_TOKENS=0` omette il parametro, quindi lì le due variabili si comportano allo stesso modo
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Imposta su `1` per saltare la compattazione automatica proattiva quando Claude Code non riconosce l’ID del modello, come un alias di un gateway LLM. Senza questa variabile, Claude Code compatta in base alla finestra di contesto che presume per l’ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può invece correggere la finestra presunta; consulta Correggere la finestra per un gateway o un ID di modello personalizzato per sapere quando si applica ciascuna variabile. Richiede Claude Code v2.1.223 o successiva
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Imposta su `1` per disattivare lo scorrimento virtuale nel rendering a schermo intero e mostrare ogni messaggio della trascrizione. Usala se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero comparire i messaggi
`CLAUDE_CODE_DISABLE_WEB_FETCH`	Imposta su `1` per disattivare lo strumento WebFetch. Lo strumento WebSearch resta disponibile. Richiede Claude Code v2.1.285 o successiva
`CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER`	Imposta su `1` per avviare i comandi dello strumento PowerShell su Windows direttamente anziché tramite il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell in esecuzione in background di essere trasferito al processo successivo della sessione, ad esempio quando metti in background la sessione. Se imposti la variabile, un comando PowerShell in background si arresta quando il processo della sessione termina. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successiva
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Imposta su `1` per disattivare i workflow. Equivalente all’impostazione `disableWorkflows`
`CLAUDE_CODE_EFFORT_LEVEL`	Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max` oppure `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e sulle impostazioni `modelSettings` ed `effortLevel`. Un limite `maxEffortLevel` si applica comunque. Consulta Regolare il livello di sforzo
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Accettata per compatibilità con le versioni precedenti e non ha alcun effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry e le sessioni con accesso effettuato al gateway delle app Claude. Dalla v2.1.158 alla v2.1.206, era necessario impostarla su `1` per rendere disponibile la modalità auto su quei provider
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Sovrascrive la disponibilità del riepilogo della sessione. Imposta su `0` per forzare la disattivazione dei riepiloghi indipendentemente dall’opzione in `/config`. Imposta su `1` per forzare l’attivazione dei riepiloghi quando `awaySummaryEnabled` è `false`. Ha la precedenza sull’impostazione e sull’opzione in `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Imposta su `1` per aggiornare lo stato dei plugin ai confini dei turni in modalità non interattiva dopo il completamento di un’installazione in background. Disattivata per impostazione predefinita perché l’aggiornamento modifica il prompt di sistema a metà sessione, il che invalida il prompt caching per quel turno
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Imposta a `1` per inviare il sondaggio sulla qualità della sessione “How is Claude doing?” al tuo collector OpenTelemetry quando il traffico non essenziale diretto ad Anthropic è bloccato. Le valutazioni del sondaggio vengono emesse solo come eventi OTEL verso il collector che hai configurato. In questa modalità nessun dato del sondaggio viene inviato ad Anthropic. Si applica quando è impostata `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, e non ha alcun effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la policy dell’organizzazione sul feedback del prodotto hanno la precedenza
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controlla se gli input delle chiamate agli strumenti vengono trasmessi in streaming dall’API man mano che Claude li genera. Con questa opzione disattivata, un input di grandi dimensioni, come la scrittura di un file lungo, arriva solo dopo che Claude ha finito di generarlo, il che può sembrare un blocco. Abilitata per impostazione predefinita sull’API Anthropic. Su Amazon Bedrock e su Agent Platform di Google Cloud, è abilitata per modello dove il container distribuito lo supporta. Imposta a `0` per disattivarla. Imposta a `1` per forzarne l’attivazione quando instradi il traffico attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivata per impostazione predefinita su Microsoft Foundry e sulle connessioni tramite gateway
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Imposta a `1` per popolare il selettore `/model` dall’endpoint `/v1/models` del tuo gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivata per impostazione predefinita perché altrimenti i gateway basati su una chiave API condivisa mostrerebbero a ogni utente tutti i modelli a cui la chiave può accedere. I modelli individuati vengono comunque filtrati da un’allowlist `availableModels` ricevuta dalla sessione; distribuisci l’elenco tramite MDM o un file di impostazioni gestite, poiché la distribuzione gestita dal server non è disponibile nelle configurazioni con gateway
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Rimossa nella v2.1.142, quando il modello predefinito della modalità veloce è passato da Opus 4.6 a Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Imposta a `false` per disattivare i suggerimenti di prompt, le previsioni in grigio che appaiono nell’input del prompt. Ha la precedenza sull’impostazione `promptSuggestionEnabled`, che è quella scritta dall’interruttore Prompt suggestions in `/config`. Claude Code inoltre mette in pausa i suggerimenti quando il tuo account è vicino al limite di utilizzo o lo ha raggiunto. Imposta a `true` per mantenerli attivi finché non raggiungi il limite. Richiede Claude Code v2.1.238 o successiva. Consulta Suggerimenti di prompt
`CLAUDE_CODE_ENABLE_TASKS`	Seleziona quali strumenti di tracciamento delle attività Claude Code fornisce nelle sessioni che li prevedono. Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Imposta a `0` per ottenere invece lo strumento legacy `TodoWrite`. Consulta Elenco delle attività
`CLAUDE_CODE_ENABLE_TELEMETRY`	Imposta a `1` per abilitare la raccolta dei dati OpenTelemetry per metriche e logging. Necessaria prima di configurare gli exporter OTel. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali. Consulta Monitoraggio
`CLAUDE_CODE_ENABLE_TODO_TOOLS`	Imposta a `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di essa, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in Disponibilità dello strumento Task. `CLAUDE_CODE_ENABLE_TASKS` continua a selezionare gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successiva
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tempo in millisecondi da attendere dopo che il ciclo delle query diventa inattivo prima di uscire automaticamente. Utile per workflow automatizzati e script che usano la modalità SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Imposta a `1` per abilitare i team di agenti. I team di agenti sono sperimentali e disabilitati per impostazione predefinita
`CLAUDE_CODE_EXTRA_BODY`	Oggetto JSON da unire al livello superiore del corpo di ogni richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella tua shell si applica anche alle sessioni in background che avvii con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e usavano la copia ereditata dal processo supervisore in background
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Sovrascrive il limite di token predefinito per la lettura dei file. Utile quando devi leggere per intero file più grandi
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Imposta a `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione in `claude agents` anche quando questo `claude` è stato avviato dall’interno di un’altra sessione di Claude Code. Usala quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o da un launcher in background avviato inizialmente dallo strumento Bash di Claude Code, fa sì che una vera sessione di primo livello venga erroneamente classificata come annidata. Dalla v2.1.178, Claude Code rileva automaticamente il caso di tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Rispettata anche nella v2.1.169 e precedenti; non ha effetto nelle v2.1.170 e v2.1.171, in cui il rilevamento delle sessioni annidate che sovrascrive era stato rimosso
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Imposta a `1` per forzare la visualizzazione barrata di `~~text~~` nelle risposte di Claude quando il tuo terminale la supporta ma non viene rilevato automaticamente, ad esempio tramite SSH senza l’inoltro di `TERM_PROGRAM`. Senza di essa, i terminali non rilevati mostrano i marcatori `~~` letterali invece di visualizzare il testo barrato. Richiede Claude Code v2.1.186 o successiva
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	Imposta a `1` per forzare l’abilitazione dell’output sincronizzato della modalità privata DEC 2026 quando il tuo terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono al rilevamento delle funzionalità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al rendering a schermo intero, questa non cambia il renderer
`CLAUDE_CODE_FORK_SUBAGENT`	Controlla la modalità fork, che consente a Claude di generare autonomamente subagent fork ed è attiva per impostazione predefinita solo nelle sessioni interattive. Imposta a `1` per attivarla anche in `claude -p` e nell’Agent SDK, oppure a `0` per disattivarla in ogni tipo di sessione. Puoi eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. Il comportamento predefinito interattivo richiede Claude Code v2.1.232 o successiva; nelle versioni precedenti, imposta la variabile a `1` per attivare la modalità fork
`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`	Imposta a `1` per emettere il testo e i blocchi di ragionamento dei subagent nell’output di `claude -p --output-format stream-json`, con lo stesso comportamento del flag `--forward-subagent-text`. Usa la variabile quando un harness invoca `claude` e non può passare il flag da sé. A differenza del flag, che termina con un errore al di fuori della modalità non interattiva con output stream-json, in quel caso la variabile viene ignorata, così le invocazioni annidate continuano a funzionare quando è impostata per l’intero processo. Richiede Claude Code v2.1.211 o successiva
`CLAUDE_CODE_GATEWAY_HINT_HEADERS`	Imposta a `1` per inviare gli header di suggerimento per il gateway, come `x-claude-code-request-class` e `x-claude-code-compaction`, su un proxy personalizzato o su un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Imposta a `0` per smettere di inviarli su ogni connessione, inclusa una connessione diretta all’API Anthropic, dove Claude Code li invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successiva
`CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS`	Timeout in millisecondi per la richiesta di individuazione dei modelli del gateway attivata da `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (predefinito: `3000`). Aumentalo quando il tuo gateway impiega più di tre secondi per rispondere a `/v1/models` all’avvio. Accetta solo cifre semplici; `0`, i valori negativi e altre scritture mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successiva
`CLAUDE_CODE_GIT_BASH_PATH`	Solo Windows: percorso dell’eseguibile di Git Bash (`bash.exe`). Usala quando Git Bash è installato ma non si trova nel tuo PATH. Se il percorso non esiste o il file non si chiama `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e rileva automaticamente Git Bash come se non fosse impostata, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code terminava all’avvio quando il percorso non esisteva e usava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Consulta Configurazione su Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Imposta a `false` per escludere i dotfile dai risultati quando Claude invoca lo strumento Glob. Inclusi per impostazione predefinita. Non influisce sul completamento automatico dei file con `@`, su `ls`, Grep o Read
`CLAUDE_CODE_GLOB_NO_IGNORE`	Imposta a `false` per fare in modo che lo strumento Glob rispetti i pattern di `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti, inclusi quelli ignorati da Git. Non influisce sul completamento automatico dei file con `@`, che ha una propria impostazione `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Timeout in secondi per l’individuazione dei file da parte dello strumento Glob. Il valore predefinito è 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL
`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`	Per quanti minuti il lavoro in background può tenere in attesa un obiettivo attivo prima che Claude Code chieda a Claude di verificarlo. Predefinito `30`. Imposta `0` per disattivare le verifiche. Specifica minuti interi in cifre semplici, al massimo `10080`, cioè una settimana. Claude Code tratta qualsiasi altro valore come non impostato e usa il valore predefinito. Richiede Claude Code v2.1.234 o successiva
`CLAUDE_CODE_HIDE_CWD`	Imposta a `1` per nascondere la directory di lavoro nel logo di avvio. Utile per condivisioni dello schermo o registrazioni in cui il percorso rivela il nome utente del tuo sistema operativo
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Sovrascrive l’indirizzo host usato per connettersi all’estensione dell’IDE. Per impostazione predefinita Claude Code rileva automaticamente l’indirizzo corretto, incluso l’instradamento da WSL a Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Imposta a `1` per saltare l’installazione automatica delle estensioni dell’IDE. Equivale a impostare `autoInstallIdeExtension` a `false`
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Imposta a `1` per saltare la convalida delle voci del lockfile dell’IDE durante la connessione. Usala quando la connessione automatica non riesce a trovare il tuo IDE nonostante sia in esecuzione
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	Quanti subagent possono essere in esecuzione in una sessione prima che lo strumento Agent si rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi la variabile può modificare il limite ma non disabilitarlo. Richiede Claude Code v2.1.217 o successiva
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Sovrascrive la dimensione della finestra di contesto che Claude Code presume per il modello attivo. Dalla v2.1.193, il modo in cui si applica dipende da come Claude Code risolve l’ID del modello; consulta Correggere la finestra per un gateway o un ID di modello personalizzato. Usala quando instradi verso un modello tramite `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione integrata associata al suo nome
`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`	Lunghezza massima in caratteri di ciascuna descrizione degli strumenti MCP e delle istruzioni di ciascun server MCP che Claude Code invia al modello (predefinito: 2048). Claude Code tronca il testo più lungo. Accetta un numero intero positivo in cifre semplici. Qualsiasi altro valore viene ignorato e si applica il valore predefinito. Richiede Claude Code v2.1.280 o successiva
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e i limiti variano in base al modello; consulta max output tokens. Claude Code riduce al limite un valore superiore al limite del modello. Per un ID di modello che Claude Code non riesce a ricondurre a un modello noto, il valore predefinito è 32000 e il limite è 128000. Aumentare questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la compattazione automatica
`CLAUDE_CODE_MAX_RETRIES`	Sovrascrive il numero di volte in cui riprovare le richieste API non riuscite (predefinito: 10). Limitato a 15 dalla v2.1.186; dalla v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Per le sessioni non presidiate che devono attendere interruzioni più lunghe, imposta invece `CLAUDE_CODE_RETRY_WATCHDOG`
`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`	Rimossa nella v2.1.224 e ora non ha alcun effetto. In precedenza limitava il numero totale di subagent che Claude poteva generare con lo strumento Agent in una sessione (predefinito: 200); la generazione oltre il limite falliva con `Subagent spawn limit reached`. Il limite di subagent simultanei e il limite di profondità si applicano ancora
`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	Numero di livelli di subagent consentiti sotto la conversazione principale (predefinito: 3). Con il valore predefinito, i subagent possono generare i propri subagent e un subagent al terzo livello non può generarne altri; imposta `1` per disattivare l’annidamento. Dalla v2.1.217 alla v2.1.218, il valore predefinito era 1, quindi un subagent non poteva generarne di propri a meno che tu non aumentassi il limite; la v2.1.219 ha portato il valore predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi il limite può essere modificato ma non rimosso. Richiede Claude Code v2.1.217 o successiva
`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`	Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse
`CLAUDE_CODE_MAX_TURNS`	Limita il numero di turni agentici quando non viene passato un limite esplicito. Equivale a passare `--max-turns`, che ha la precedenza quando sono impostati entrambi. Un valore che non è un intero positivo viene rifiutato all’avvio con un errore invece di essere trattato come assenza di limite
`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`	Limite al numero totale di chiamate a WebSearch che una sessione può effettuare (predefinito: 200). Quando Claude raggiunge il limite, le ulteriori chiamate a WebSearch restituiscono un avviso che gli dice di proseguire con le informazioni già raccolte. Accetta un numero intero positivo senza limite superiore. Qualsiasi altro valore viene ignorato e si applica il valore predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successiva
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Imposta a `1` per avviare i server MCP stdio solo con un ambiente di base sicuro più l’`env` configurato per il server, invece di ereditare l’ambiente della tua shell
`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`	Tempo trascorso in millisecondi prima che una chiamata a uno strumento MCP ancora in esecuzione passi a un’attività in background (predefinito: 120000, ovvero 2 minuti). Imposta a `0` per disattivare il passaggio automatico in background. Richiede Claude Code v2.1.212 o successiva
`CLAUDE_CODE_MCP_STARTUP_WAIT_MS`	Per quanti millisecondi il primo turno di una sessione non interattiva attende i server MCP ancora in fase di connessione, al posto dell’attesa predefinita del primo turno. Quando è impostata, l’attesa copre tutti i server in sospeso. Imposta a `0` per saltare l’attesa. Un server `--permission-prompt-tool` mantiene la propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successiva
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Timeout di inattività in millisecondi per le chiamate agli strumenti MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o un connettore claude.ai non invia alcuna risposta né alcuna notifica di avanzamento per questo intervallo, la chiamata allo strumento si interrompe con un errore invece di attendere il `MCP_TOOL_TIMEOUT` complessivo. Sovrascrive i valori predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Imposta a `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono portati a un secondo e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 porta la finestra di inattività di quel server almeno al valore di `timeout`. Non si applica ai server dell’IDE né ai server in-process dell’SDK. Richiede Claude Code v2.1.187 o successiva. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività
`CLAUDE_CODE_MESSAGING_SOCKET`	Impostata da Claude Code, non da te: nelle sessioni che associano un socket della casella di posta, Claude Code esporta il percorso di quel socket verso gli hook e i comandi Bash quando associa il socket. In una sessione che si avvia con la messaggistica attiva, Claude Code associa il socket prima dell’esecuzione di qualsiasi hook. Le altre sessioni sulla macchina recapitano i messaggi a questo percorso. Ogni sessione esporta il proprio socket anziché uno ereditato da una sessione padre, e i messaggi che vi arrivano passano attraverso i controlli in ingresso della sessione. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.224 o successiva
`CLAUDE_CODE_MESSAGING_TOKEN`	Impostata da Claude Code, non da te: nelle sessioni che associano un socket della casella di posta, Claude Code esporta questo token per sessione verso gli hook e i comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che scrive sul socket può inviare `{"type":"auth","token":"<token>"}` come prima riga per dimostrare di appartenere alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non si apra con una riga valida. Le regole sui processi figli propri indicano quando Claude Code consulta il token. Ogni sessione esporta il proprio token, mai uno ereditato da una sessione padre. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.228 o successiva
`CLAUDE_CODE_NATIVE_CURSOR`	Imposta a `1` per mostrare il cursore proprio del terminale nel punto di inserimento invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggiamento, forma e focus del terminale
`CLAUDE_CODE_NEW_INIT`	Imposta a `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare il codebase e scriverli. Senza questa variabile, `/init` genera automaticamente un CLAUDE.md senza chiedere nulla
`CLAUDE_CODE_NONBLOCKING_STDOUT`	Imposta a `1` per scrivere l’output del terminale attraverso un secondo file descriptor non bloccante, in modo che un terminale che smette di leggere, come un pannello tmux in control mode messo in pausa o una connessione SSH bloccata, non possa bloccare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successiva
`CLAUDE_CODE_NO_FLICKER`	Imposta a `1` per abilitare il rendering a schermo intero, un’anteprima di ricerca che riduce lo sfarfallio e mantiene costante l’uso della memoria nelle conversazioni lunghe. Sovrascrive l’impostazione `tui`; puoi anche passare a questa modalità con `/tui fullscreen`
`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`	Token di aggiornamento OAuth per l’autenticazione Claude.ai. Quando è impostato, `claude auth login` scambia direttamente questo token invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per predisporre l’autenticazione in ambienti automatizzati
`CLAUDE_CODE_OAUTH_SCOPES`	Scope OAuth separati da spazi con cui è stato emesso il token di aggiornamento, ad esempio `"user:profile user:inference user:sessions:claude_code"`. Obbligatoria quando è impostata `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`
`CLAUDE_CODE_OAUTH_TOKEN`	Token di accesso OAuth per l’autenticazione claude.ai. Alternativa a `/login` per l’SDK e gli ambienti automatizzati. Ha la precedenza sulle credenziali memorizzate nel portachiavi. Generane uno con `claude setup-token`. A meno che tu non esegua `/login`, Claude Code usa il token che hai impostato per l’intera sessione. Per sostituire un token scaduto, generane uno nuovo e riavvia
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Rimossa nella v2.1.160 e ora non ha alcun effetto. In precedenza fissava la modalità veloce su Claude Opus 4.6 invece che sul modello predefinito attuale. Opus 4.6 non supporta più la modalità veloce
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Lunghezza massima degli attributi OpenTelemetry che contengono contenuti (risposte del modello, contenuti degli strumenti, prompt di sistema, corpi API grezzi), incluso il marcatore di troncamento, in unità di codice UTF-16 (predefinito: 61440, ovvero 60 KB). Aumentala solo se il tuo backend di telemetria accetta valori di attributo superiori a 64 KB, oppure riducila per diminuire il volume della telemetria. Richiede Claude Code v2.1.214 o successiva. Consulta Monitoraggio
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Imposta a `1` per scrivere su stderr gli errori diagnostici dell’exporter OpenTelemetry. Per impostazione predefinita questi errori compaiono solo con `--debug`, quindi un exporter configurato male, ad esempio per una collisione di porta di Prometheus, altrimenti fallisce in silenzio. Richiede Claude Code v2.1.179 o successiva. Consulta Monitoraggio
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Timeout in millisecondi per lo svuotamento degli span OpenTelemetry in sospeso (predefinito: 5000). Consulta Monitoraggio
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervallo in millisecondi per l’aggiornamento degli header OpenTelemetry dinamici (predefinito: 1740000 / 29 minuti). Consulta Header dinamici
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Timeout in millisecondi entro cui l’exporter OpenTelemetry deve terminare alla chiusura (predefinito: 2000). Aumentalo se le metriche vengono perse all’uscita. Consulta Monitoraggio
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Imposta a `1` per consentire a Claude Code di eseguire in background il comando di aggiornamento del tuo gestore di pacchetti quando è disponibile una nuova versione. Si applica alle installazioni tramite Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Consulta Aggiornamenti automatici
`CLAUDE_CODE_PERFORCE_MODE`	Imposta a `1` per abilitare la protezione in scrittura compatibile con Perforce. Quando è impostata, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione non ha il bit di scrittura per il proprietario, che Perforce rimuove dai file sincronizzati finché `p4 edit` non li apre. Ciò impedisce a Claude Code di aggirare il tracciamento delle modifiche di Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Sovrascrive la directory radice dei plugin. Nonostante il nome, imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory di questo percorso. Il valore predefinito è `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_DIRS`	Directory dei plugin da caricare per la sessione, ciascuna caricata nel modo in cui la carica un flag `--plugin-dir`. Separa più percorsi con `:` su Unix o `;` su Windows. Specifica ogni percorso come percorso assoluto o iniziandolo con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successiva. Consulta Caricare un plugin per una sessione
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Timeout in millisecondi per la clonazione o l’aggiornamento di un marketplace di plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Consulta Timeout del git clone
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Imposta a `1` per saltare il tentativo di nuova clonazione e continuare a usare il checkout esistente del marketplace quando un aggiornamento del marketplace non riesce a raggiungere il remoto o ad autenticarsi. Utile in ambienti offline o airgapped in cui una nuova clonazione fallirebbe allo stesso modo. Consulta Gli aggiornamenti del marketplace falliscono negli ambienti offline
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Imposta a `1` per clonare le sorgenti GitHub in forma abbreviata `owner/repo` tramite HTTPS invece che tramite SSH. Si applica all’installazione e all’aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner di CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com`
`CLAUDE_CODE_PLUGIN_SEED_DIR`	Percorso di una o più directory seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Usala per includere una directory di plugin prepopolata in un’immagine container. Claude Code registra i marketplace da queste directory all’avvio e usa i plugin già presenti nella cache senza clonarli di nuovo. Consulta Prepopolare i plugin per i container
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Imposta a `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando avvia PowerShell per le chiamate agli strumenti, gli hook e i comandi della riga di stato, rispettando invece la execution policy effettiva della macchina. Per impostazione predefinita Claude Code aggira la execution policy nell’ambito del processo, così gli script `.ps1` e le importazioni di moduli funzionano nelle installazioni di Windows con il valore predefinito Restricted. L’aggiramento nell’ambito del processo non sovrascrive mai le policy di gruppo `MachinePolicy` o `UserPolicy`, indipendentemente da questa impostazione
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Limite massimo in millisecondi dell’attesa inattiva per i subagent e i workflow in background dopo il turno finale in modalità non interattiva con il flag `-p`. L’attesa inattiva ricomincia ogni volta che Claude esegue un turno per gestire un risultato in background. Predefinito: `600000`, ovvero 10 minuti. Quando l’attesa inattiva raggiunge il limite, Claude Code smette di attendere le restanti attività in background ed esce. Imposta a `0` per attendere indefinitamente. Questo limite è separato dal periodo di tolleranza di cinque secondi che si applica alle semplici shell in background. Richiede Claude Code v2.1.182 o successiva
`CLAUDE_CODE_PROCESS_WRAPPER`	Avvia i processi che Claude Code lancia dal proprio binario, come il servizio in background che ospita le sessioni di agent view, tramite un launcher aziendale specificato come prefisso argv, ad esempio `/opt/corp/launcher`. Impostala nel blocco `env` delle impostazioni utente o delle impostazioni gestite, non come export della shell, in modo che il servizio in background scollegato la erediti; le impostazioni di progetto e locali non possono impostarla. Equivale all’impostazione `processWrapper`, che richiede Claude Code v2.1.210 o successiva; questa variabile ha la precedenza quando sono impostate entrambe. L’estensione di VS Code configura il proprio launcher separatamente tramite la sua impostazione `claudeProcessWrapper`. Ignorata su Windows. Consulta Eseguire Claude Code dietro un launcher aziendale per il formato del valore, ciò che il launcher copre e il contratto che il launcher deve rispettare. Richiede Claude Code v2.1.208 o successiva
`CLAUDE_CODE_PROJECT_DIR_NAME`	Da impostare insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory in `projects/` in cui Claude Code archivia le trascrizioni e la memoria automatica di quella sessione, al posto di un nome derivato dal percorso della directory di lavoro. Ad esempio, avviando Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` le archivia in `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostata, e la legge solo dall’ambiente da cui avvii `claude`, mai da un blocco `env` di un file di impostazioni. Consulta Assegnare tu il nome alla directory del progetto. Richiede Claude Code v2.1.234 o successiva
`CLAUDE_CODE_PROMPT_CACHE_TTL`	Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il TTL del prompt caching per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper che vengono eseguiti in linea con essi. Ha la precedenza sull’impostazione `promptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L’API fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Imposta a `1` per propagare il trace context W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione riguarda l’header `traceparent` sulle richieste al modello e ai server MCP HTTP e la variabile d’ambiente `TRACEPARENT` per i sottoprocessi di Bash, PowerShell e degli hook. Per impostazione predefinita, la propagazione è abilitata solo quando la connessione è diretta all’API Anthropic. Aggiunta nella v2.1.152. Consulta Tracce (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Impostata dalle piattaforme host che incorporano Claude Code e gestiscono per suo conto l’instradamento verso il provider del modello. Quando è impostata, Claude Code ignora le variabili di selezione del provider, dell’endpoint e di autenticazione, come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY`, nei file di impostazioni, così le impostazioni utente non possono sovrascrivere l’instradamento dell’host. Claude Code ignora inoltre le chiavi di selezione del modello come `model`, `fallbackModel` e `modelOverrides` nelle impostazioni gestite, qualunque sia la fonte gestita che le distribuisce, così la configurazione del modello dell’host ha la precedenza su un modello fissato nelle impostazioni gestite 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` nelle impostazioni gestite si applica comunque, a meno che l’host non ne fornisca una propria. Claude Code salta inoltre la disattivazione automatica della telemetria che altrimenti applica sui provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Agent Platform di Google Cloud e Microsoft Foundry, quindi la telemetria segue la disattivazione standard tramite `DISABLE_TELEMETRY`. Consulta Comportamenti predefiniti per provider API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Imposta a `1` per consentire al proxy di eseguire la risoluzione DNS al posto del chiamante. Opzione facoltativa per gli ambienti in cui il proxy deve gestire la risoluzione dei nomi host
`CLAUDE_CODE_REMOTE`	Impostata automaticamente a `true` quando Claude Code è in esecuzione come sessione cloud. Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud
`CLAUDE_CODE_REMOTE_SESSION_ID`	Impostata automaticamente nelle sessioni cloud all’ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Consulta Collegare l’output alla sessione
`CLAUDE_CODE_RESTRICTED`	Imposta a `1` per avviare la sessione in modalità con restrizioni, come passando `--restricted`. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.248 o successiva
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Imposta su `1` per riprendere automaticamente se la sessione precedente è terminata a metà di un turno. Usata in modalità SDK affinché il modello continui senza che l’SDK debba inviare di nuovo il prompt. Per disattivarla, rimuovi la variabile o impostala su `0`. Per il pannello di chat di VS Code, consulta Continuare le conversazioni dopo un ricaricamento
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS`	Età massima in millisecondi dell’ultimo messaggio della trascrizione perché una sessione terminata a metà di un turno prosegua automaticamente alla ripresa. Quando l’ultimo messaggio è più vecchio di questo limite, Claude Code salta la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e il relativo messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT`, e la sessione si avvia inattiva in modo che tu prosegua esplicitamente. Non impostata o `0` significa nessun limite, tranne per il fatto che un turno la cui ultima richiesta è fallita con un errore API riprende solo finché quell’errore ha meno di 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 avvio per agenti di lunga durata possono impostarla in modo che un riavvio su una trascrizione vecchia non riesegua un prompt obsoleto. Claude Code imposta autonomamente un limite di un’ora quando riavvia una sessione di agent view andata in crash che ha ereditato la conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successiva
`CLAUDE_CODE_RESUME_PROMPT`	Sovrascrive il messaggio di continuazione che Claude Code invia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` prosegue un turno interrotto invece di inviare di nuovo il suo prompt, oppure quando riprendi una chiamata a uno strumento rinviata con `-p`. Il valore predefinito è `Continue from where you left off.`. Una stringa vuota usa il valore predefinito
`CLAUDE_CODE_RETRY_WATCHDOG`	Imposta a `1` per le sessioni non presidiate come harness di valutazione, job di CI o worker remoti. Riprova indefinitamente in caso di errori di capacità `429` e `529` invece di fallire dopo `CLAUDE_CODE_MAX_RETRIES` tentativi. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche se proviene da un limite di spesa del gateway che si azzera periodicamente. Prima della v2.1.239, il watchdog riprovava indefinitamente anche in questi casi. Per le richieste in modalità veloce, consulta Gestire i rate limit. Il watchdog attende fino a 5 minuti tra un tentativo e l’altro, oppure fino all’azzeramento del limite quando la risposta include un orario di azzeramento del rate limit, così una sessione che raggiunge un limite di utilizzo attende la fine della finestra rimanente. Nella v2.1.199 o successiva aumenta inoltre a 300 il numero predefinito di nuovi tentativi per gli altri errori transitori, come errori del server, timeout e connessioni interrotte, pari a circa tre ore di attesa, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successiva
`CLAUDE_CODE_SAFE_MODE`	Imposta a `1` per avviare in modalità provvisoria: CLAUDE.md, skill, plugin, hook, server MCP, comandi e agenti personalizzati, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della riga di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione non funzionante. La policy delle impostazioni gestite si applica comunque, inclusi gli hook, la riga di stato e i comandi dei suggerimenti di file configurati dalla policy; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla policy no. Equivale a passare `--safe-mode`. I processi figli avviati direttamente ereditano la variabile
`CLAUDE_CODE_SCRIPT_CAPS`	Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando è impostata `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Le chiavi sono sottostringhe confrontate con il testo del comando; i valori sono limiti interi di chiamate. Ad esempio, `{"deploy.sh": 2}` consente di chiamare `deploy.sh` al massimo due volte. Il confronto si basa su sottostringhe, quindi trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` vengono comunque conteggiati nel limite. Le diramazioni a runtime tramite `xargs` o `find -exec` non vengono rilevate; si tratta di un controllo di difesa in profondità
`CLAUDE_CODE_SCROLL_SPEED`	Imposta il moltiplicatore di scorrimento della rotellina del mouse nel rendering a schermo intero. Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato del trackpad e della rotellina nei terminali che già amplificano gli eventi della rotellina. Imposta a `3` per corrispondere a `vim` se il tuo terminale invia un evento della rotellina per scatto senza amplificazione. Ignorata nel terminale degli IDE JetBrains, dove Claude Code usa una propria gestione dello scorrimento
`CLAUDE_CODE_SEND_FEEDBACK`	Imposta a `0` per disattivare il feedback redatto da Claude per una sessione. Imposta a `1` per attivarlo dove il tuo account ha già accesso; la variabile non può concedere l’accesso da sola, e gli altri interruttori che disattivano il feedback, come `DISABLE_FEEDBACK_COMMAND` e il valore `off` dell’impostazione `feedbackDrafts`, si applicano comunque
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Sovrascrive il tempo disponibile in millisecondi per gli hook SessionEnd. Il valore è anche il timeout per ogni hook che non imposta un proprio `timeout`. Si applica all’uscita dalla sessione, a `/clear` e al cambio di sessione tramite `/resume` interattivo. Per impostazione predefinita il tempo disponibile è di 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout degli hook forniti dai plugin non aumentano il tempo disponibile
`CLAUDE_CODE_SESSION_ID`	Impostata automaticamente all’ID della sessione corrente nei sottoprocessi degli strumenti Bash e PowerShell, nei sottoprocessi dei comandi hook e nei sottoprocessi dei server MCP stdio. Per Bash, PowerShell e gli hook corrisponde al campo `session_id` nell’input JSON degli hook e viene aggiornata con `/clear`. Un sottoprocesso di un server MCP mantiene l’ID con cui è stato avviato. Con `--resume <session-id>` riceve l’ID ripreso, come gli hook e Bash. Con `--continue` o `--resume` senza un ID esplicito potrebbe invece ricevere l’ID iniziale di avvio. Usala per correlare script e strumenti esterni con la sessione di Claude Code che li ha avviati
`CLAUDE_CODE_SHELL`	Imposta la shell che Claude Code usa per eseguire i comandi dello strumento Bash. Accetta il percorso di un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e ripiega sul rilevamento automatico. Il rilevamento automatico usa la tua `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` e poi `bash` funzionante trovato nel tuo `PATH` e nei percorsi di installazione standard
`CLAUDE_CODE_SHELL_PREFIX`	Prefisso di comando che racchiude i comandi di shell avviati da Claude Code: chiamate allo strumento Bash, comandi degli hook, comandi della riga di stato e comandi di avvio dei server MCP stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per il logging o l’auditing. Impostare un semplice percorso di eseguibile come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come singolo argomento quotato per la shell in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un semplice percorso di eseguibile rompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate allo strumento Bash, `$1` contiene l’intera invocazione della shell assemblata da Claude Code, inclusa la preparazione dell’ambiente, non solo il comando eseguito da Claude
`CLAUDE_CODE_SIMPLE`	Imposta a `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, di lettura file e di modifica file. Gli strumenti MCP da `--mcp-config` restano disponibili. Disabilita l’individuazione automatica di hook, skill, comandi personalizzati, subagent, plugin installati, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory che passi con `--add-dir` vengono comunque caricate. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l’autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivale a passare `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Imposta a `1` per usare un prompt di sistema più breve e descrizioni degli strumenti abbreviate su qualsiasi modello. Imposta a `0`, `false`, `no` o `off` per disattivarla anche sui modelli in cui l’esperimento o la configurazione del server la abiliterebbero altrimenti. L’intero set di strumenti, gli hook, i server MCP e l’individuazione di CLAUDE.md restano abilitati
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Salta l’autenticazione lato client per Claude Platform on AWS, per i gateway che firmano autonomamente le richieste
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	Imposta a `1` per disattivare la cache in-process delle credenziali risolte dalla catena predefinita dei provider di credenziali AWS, in modo che Claude Code risolva la catena a ogni richiesta API. Con la cache disattivata, un profilo basato su SSO richiede le credenziali a IAM Identity Center a ogni richiesta. Consulta memorizzazione nella cache delle credenziali e timeout di risoluzione. Richiede Claude Code v2.1.207 o successiva
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Salta l’autenticazione AWS per Amazon Bedrock (ad esempio, quando usi un gateway LLM)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	Imposta a `1` per considerare disponibile la modalità veloce quando il controllo di disponibilità fallisce, per le reti che bloccano la richiesta diretta del controllo a `api.anthropic.com`. Claude Code rispetta comunque una risposta “disabled by your organization”
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	Imposta a `1` per saltare il controllo lato client della disponibilità della modalità veloce, per i proxy che intercettano la richiesta del controllo invece di rifiutarla. L’API rifiuta comunque le richieste in modalità veloce quando la tua organizzazione ha disabilitato la modalità veloce
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Salta l’autenticazione Azure per Microsoft Foundry, per un proxy o un gateway che inserisce un proprio header `Authorization`. Claude Code invia le richieste senza una credenziale Azure e preserva l’header `Authorization` che fornisci, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorata quando è impostata `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. Prima della v2.1.203, questa variabile rendeva il client Microsoft Foundry incapace di inviare richieste a meno che non fosse impostata anche una chiave API
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Salta l’autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando usi un gateway LLM)
`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY`	I controlli dei modelli all’avvio su Amazon Bedrock e su Agent Platform di Google Cloud ricordano su questa macchina, per un massimo di un giorno, quali modelli il tuo account non può invocare. Imposta a `1` per disattivare questa memoria. Richiede Claude Code v2.1.285 o successiva
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	Imposta a `1` per non scrivere su disco la cronologia dei prompt e le trascrizioni delle sessioni. Le sessioni avviate con questa variabile impostata non compaiono in `--resume`, `--continue` né nella cronologia richiamabile con la freccia su. Utile per sessioni effimere gestite da script
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Salta l’autenticazione Google per Agent Platform di Google Cloud (ad esempio, quando usi un gateway LLM)
`CLAUDE_CODE_STARTUP_FAILURE_RESULTS`	Imposta a `1` per fare in modo che una sessione avviata con `--output-format stream-json` scriva un messaggio di risultato che indica perché Claude Code si è rifiutato di avviarsi per gli errori di avvio che altrimenti terminano solo con stderr. Richiede Claude Code v2.1.274 o successiva
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Numero massimo di volte consecutive in cui un hook Stop o SubagentStop può impedire la conclusione del turno prima che Claude Code lo sovrascriva e concluda comunque il turno (predefinito: 8). Imposta a `0` per disabilitare il limite. Aumentalo se il tuo hook ha legittimamente bisogno di più iterazioni per risolversi
`CLAUDE_CODE_SUBAGENT_MODEL`	Il modello predefinito per i subagent, i compagni di squadra dei team di agenti e gli agenti dei workflow a cui non è assegnato un modello in altro modo. Accetta un alias come `haiku` o il nome completo di un modello. Due fonti hanno la precedenza su di essa: un modello che Claude passa quando genera l’agente e un campo `model` nella definizione dell’agente, incluso `inherit`. Per cambiare questo comportamento, imposta `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`. Consulta Scegliere un modello per l’ordine completo. Impostarla a `inherit` equivale a lasciarla non impostata. Prima della v2.1.251, questa variabile sovrascriveva sia il modello per singola invocazione sia il campo `model` della definizione
`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`	Imposta a `1` per imporre un unico modello a subagent, compagni di squadra e agenti dei workflow. Eseguire ogni subagent su un unico modello indica di quale modello si tratta. Richiede Claude Code v2.1.257 o successiva
`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`	Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il TTL del prompt caching per le richieste al di fuori della conversazione principale, come subagent, workflow e lavoro in background. Ha la precedenza sull’impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L’API fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Imposta a `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio): le credenziali di Anthropic e dei provider cloud, qualsiasi altra variabile che Claude Code riconosce come credenziale e le credenziali incorporate negli URL dei registri di pacchetti. Il processo Claude padre conserva queste credenziali per le chiamate API, ma i processi figli non possono leggerle, riducendo l’esposizione agli attacchi di prompt injection che tentano di esfiltrare segreti tramite l’espansione della shell. Nella v2.1.251 o successiva, la pulizia rimuove anche le variabili che puntano all’archivio di configurazione di Claude Code (come `CLAUDE_CONFIG_DIR`), così un processo figlio non può individuare una directory di configurazione spostata. Lascia la pulizia non impostata se un sottoprocesso ha bisogno di queste variabili. Su Linux, esegue inoltre i sottoprocessi Bash in un namespace PID isolato, in modo che non possano leggere gli ambienti dei processi dell’host tramite `/proc`; come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere né inviare segnali ai processi dell’host. `claude-code-action` la imposta automaticamente quando è configurato `allowed_non_write_users`
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Imposta a `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell’installazione dei plugin prima della prima query. Senza di essa, i plugin vengono installati in background e potrebbero non essere disponibili al primo turno. Combinala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l’attesa
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`	Timeout in millisecondi per l’installazione sincrona dei plugin. Quando viene superato, Claude Code prosegue senza plugin e registra un errore. Nessun valore predefinito: senza questa variabile, l’installazione sincrona attende fino al completamento
`CLAUDE_CODE_SYNC_SKILLS`	Imposta a `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi in quell’esecuzione le skill abilitate per il tuo account claude.ai e ne attenda l’elenco, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. I download veri e propri terminano in background, e Claude attende il download di una skill quando la invoca. Richiede l’autenticazione claude.ai. Le sessioni da terminale in cui accedi con il tuo account claude.ai scaricano queste skill in `~/.claude/skills/synced/` e le risincronizzano circa ogni 10 minuti senza questa variabile, quindi impostala solo quando un’esecuzione `-p` ha bisogno delle tue skill aggiornate alla prima query. Prima della v2.1.273, le sessioni da terminale le scaricavano solo in un’esecuzione `-p` con questa variabile impostata. Il nome della cartella `synced` è riservato a questo download. Prima della v2.1.227, le skill venivano scaricate direttamente in `~/.claude/skills/`. Claude Code applica regole aggiuntive alle skill scaricate, ad esempio non eseguire i loro comandi `!` sulla tua macchina
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Timeout in millisecondi per la risincronizzazione delle skill eseguita a metà sessione quando un’app basata sull’Agent SDK ricarica le skill (predefinito: 30000). Quando viene superato, il ricaricamento prosegue con le skill già arrivate e i download rimanenti terminano in background
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Timeout in millisecondi entro cui la prima query attende l’elenco iniziale delle skill quando è impostata `CLAUDE_CODE_SYNC_SKILLS` (predefinito: 5000). Quando viene superato, la prima query viene eseguita con le skill già arrivate. I download terminano comunque in background, e Claude attende il download di una skill quando la invoca
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Imposta a `false` per disabilitare l’evidenziazione della sintassi nell’output dei diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disabilitare l’evidenziazione anche nei blocchi di codice e nelle anteprime dei file, usa l’impostazione `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Condivide un elenco di attività tra sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinarle su un elenco di attività condiviso, nelle sessioni che dispongono degli strumenti Task. Consulta Elenco delle attività
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Sovrascrive, in millisecondi, quanto a lungo una sessione non interattiva attende all’uscita che il suo team di agenti completi lo smantellamento. Accetta valori da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il valore predefinito di 10000. Richiede Claude Code v2.1.206 o successiva
`CLAUDE_CODE_TMPDIR`	Sovrascrive la directory temporanea usata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` a questo percorso su Unix, oppure `/claude/` su Windows. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash in sandbox ricevono un `$TMPDIR` di fallback breve nella posizione predefinita di sistema quando il tuo override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non in sandbox ereditano il `$TMPDIR` della tua shell quando è impostato. Su Windows nativo, quando la tua shell non imposta `$TMPDIR`, un comando Bash che fa riferimento a `$TMPDIR` riceve il tuo override, oppure `%TEMP%` quando non ne hai impostato uno. I file temporanei di Claude Code usano sempre il tuo override. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali
`CLAUDE_CODE_TMUX_TRUECOLOR`	Imposta a un qualsiasi valore non vuoto, come `1`, per consentire l’output truecolor a 24 bit all’interno di tmux. Impostarla a `0` o `false` consente comunque il truecolor, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare la limitazione a 256 colori. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostata, perché tmux non lascia passare le sequenze di escape truecolor a meno che non sia configurato per farlo. Impostala dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al tuo `~/.tmux.conf`. Consulta Configurazione del terminale per altre impostazioni di tmux
`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`	Su Linux e WSL, imposta un elenco separato da virgole dei tipi di processi che Claude Code esclude dal limite di memoria degli strumenti, come `mcp` o `lsp`. Imposta `none` per limitare tutti i tipi, oppure `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 tu elenchi. Richiede Claude Code v2.1.246 o successiva
`CLAUDE_CODE_TOOL_MEMORY_LIMIT`	Su Linux e WSL, imposta una dimensione come `4G` per limitare la memoria che i comandi degli strumenti Bash e PowerShell possono usare, e i comandi dello strumento Monitor nella v2.1.246 o successiva. Scrivi la dimensione in cifre semplici, da sola per un numero di byte oppure con un suffisso `K`, `M`, `G` o `T`. Imposta `0` o `off` per disattivare il limite. Una volta che il primo processo avviato da Claude Code ha attivato o disattivato il limite, un valore modificato ha effetto al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva
`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`	Scadenza in millisecondi prima che Claude Code annulli una finestra di dialogo che inoltra a un client remoto come un host Remote Control o SDK, oppure la finestra di approvazione per un messaggio tra sessioni trattenuto; le richieste di permesso e le domande di `AskUserQuestion` usano flussi propri e non sono regolate da questa variabile. In Claude Code v2.1.236 o successiva, limita anche la richiesta di consenso ai crediti di utilizzo di Fable a metà sessione in una sessione che potrebbe essere in esecuzione senza supervisione. Controllare i messaggi in ingresso e Sessioni non interattive descrivono tutte le regole di scadenza dei messaggi trattenuti, inclusi i casi in cui la scadenza non si applica. Sovrascrive l’impostazione `dialogExpiry`. `0` o un valore negativo disabilita la scadenza
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Usa Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Usa Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Usa Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Usa l’endpoint Mantle di Amazon Bedrock
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	Imposta a `1` per individuare comandi personalizzati, subagent e stili di output usando le API dei file di Node.js invece di ripgrep. Impostala se il binario di ripgrep incluso non è disponibile o è bloccato nel tuo ambiente. Non influisce su Grep né sugli strumenti di ricerca dei file
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento viene abilitato automaticamente; imposta a `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; imposta a `1` per abilitarlo nelle sessioni Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, oppure a `0` per disattivarlo. Su Linux, macOS e WSL, imposta a `1` per abilitarlo, il che richiede `pwsh` nel tuo `PATH`. Quando è abilitato su Windows, Claude può eseguire i comandi PowerShell in modo nativo invece di passare attraverso Git Bash. Consulta Strumento PowerShell
`CLAUDE_CODE_USE_VERTEX`	Usa Agent Platform di Google Cloud
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	Imposta il numero di millisecondi per cui WebFetch mantiene nella cache la risposta di ciascun URL recuperato. Il valore predefinito è `900000`, ovvero 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra scrittura mantengono il valore predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	Limite massimo in millisecondi per quanto a lungo WebFetch attende il download di una pagina, inclusi gli eventuali reindirizzamenti che segue. Un download non completato entro quel tempo fallisce con un errore di scadenza. Il valore predefinito è `300000`, ovvero cinque minuti. Imposta a `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra scrittura mantengono il valore predefinito. Richiede Claude Code v2.1.268 o successiva
`CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS`	Quanti agenti una singola esecuzione di un workflow esegue contemporaneamente, da `1` a `256`. Per impostazione predefinita, un’esecuzione esegue fino a 16 agenti contemporaneamente, meno quando Claude Code dispone di meno CPU; le chiamate `agent()` in coda attendono uno slot libero. La trascrizione di ogni agente in esecuzione resta nella memoria di Claude Code, quindi valori più alti aumentano l’uso della memoria. Accetta solo cifre semplici; i valori fuori intervallo e altre scritture mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successiva
`CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS`	Limite superiore, in millisecondi, del tempo per cui un agente di un workflow attende che inizi la prima risposta di un agente fratello con lo stesso prefisso prima di inviare la propria prima richiesta. Quando un fan-out avvia diversi agenti che condividono un prefisso della cache dei prompt, Claude Code trattiene tutti gli agenti tranne il primo fino a questo tempo, in modo che gli altri leggano il prefisso memorizzato nella cache invece di elaborarlo ciascuno senza cache. Valore predefinito `5000`. Imposta `0` per disabilitare l’attesa. Quando `DISABLE_PROMPT_CACHING` è impostata, gli agenti non attendono mai. Richiede Claude Code v2.1.229 o successivo
`CLAUDE_CONFIG_DIR`	Sovrascrive la directory di configurazione (predefinita: `~/.claude`). Tutte le impostazioni, la cronologia delle sessioni e i plugin vengono archiviati in questo percorso. Per le credenziali, consulta dove Claude Code archivia le credenziali. Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali
`CLAUDE_DISABLE_ADOPT`	Imposta `1` per interrompere il lavoro in background in corso invece di trasferirlo quando metti in background una sessione premendo `←` o con `/background`. Claude Code ti chiede conferma prima di mettere in background, quindi interrompe le attività che altrimenti verrebbero trasferite. Richiede Claude Code v2.1.195 o successivo
`CLAUDE_EFFORT`	Impostata automaticamente nei sottoprocessi dello strumento Bash e nei comandi degli hook al livello di sforzo in vigore all’avvio del sottoprocesso: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli hook. Impostata solo quando il modello corrente supporta il parametro effort
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Imposta `1` per forzare l’abilitazione del watchdog di inattività dello streaming a livello di byte, oppure `0` per forzarne la disabilitazione. `0` disattiva anche la scadenza del primo byte sulle connessioni in cui tale scadenza è attiva. Quando non è impostata, il watchdog è abilitato per impostazione predefinita per le connessioni dirette all’API Anthropic e a Claude Platform on AWS, e per le risposte in streaming sulle connessioni tramite gateway raggiunte attraverso `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non veniva eseguito su queste connessioni tramite gateway, quindi il watchdog a livello di evento poteva segnalare uno stallo anche mentre arrivavano ping keep-alive. Per i timeout e il modo in cui i timer interagiscono, consulta Watchdog di inattività dello streaming
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Imposta `1` per abilitare il watchdog di inattività dello streaming a livello di byte sulle risposte `vnd.amazon.eventstream` di Amazon Bedrock, il che abilita anche la scadenza del primo byte sulle richieste in streaming a Bedrock. Disattivata per impostazione predefinita. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Imposta `0` per forzare la disabilitazione del watchdog di inattività dello streaming a livello di evento, oppure `1` per forzarne l’abilitazione. Quando non è impostata, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il valore predefinito in assenza di impostazione era controllato dal server sull’API Anthropic diretta e disattivato sugli altri provider. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che vengono eseguiti insieme a questo, consulta Watchdog di inattività dello streaming
`CLAUDE_ENV_FILE`	Percorso di uno script shell il cui contenuto Claude Code esegue prima di ogni comando Bash nello stesso processo shell, in modo che le esportazioni nel file siano visibili al comando. Usala per mantenere l’attivazione di virtualenv o conda tra i comandi. Viene anche popolata dinamicamente dagli hook SessionStart, Setup, CwdChanged e FileChanged
`CLAUDE_JOB_DIR`	Impostata da Claude Code in ogni sessione in background sulla directory `~/.claude/jobs/<id>` di quella sessione. I comandi shell eseguiti dalla sessione la ereditano. Scrivi i file temporanei in `$CLAUDE_JOB_DIR/tmp`. Le chiamate `Write` e `Edit` di Claude in quella posizione non richiedono permessi, e la directory viene rimossa quando la sessione viene eliminata
`CLAUDE_PID`	Claude Code la imposta sul proprio ID di processo nei sottoprocessi che avvia: i comandi degli strumenti Bash e PowerShell e i comandi degli hook. Su Linux, l’integrazione shell dello strumento Bash la usa per rifiutare un pattern `pkill` che corrisponderebbe al processo stesso di Claude Code; consulta il riferimento agli errori. Leggila dai tuoi script per identificare o inviare segnali deliberatamente al processo Claude Code padre. Richiede Claude Code v2.1.214 o successivo
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefisso per i nomi delle sessioni di Remote Control generati automaticamente quando non viene fornito un nome esplicito. Il valore predefinito è l’hostname della tua macchina, che produce nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione
`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`	Scadenza in millisecondi per il primo byte della risposta di una richiesta in streaming, sulle connessioni in cui è attiva la scadenza del primo byte. Per il modo in cui Claude Code la limita, il tempo aggiuntivo che aggiunge per i corpi di richiesta di grandi dimensioni e il modo in cui sceglie la scadenza quando non la imposti, consulta Nessuna risposta dall’API. Richiede Claude Code v2.1.242 o successivo
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Timeout in millisecondi prima che i watchdog di inattività dello streaming a livello di evento e di byte chiudano una connessione in stallo. Quando imposti esplicitamente questa variabile, il minimo è `300000` (5 minuti); i valori inferiori vengono limitati silenziosamente per assorbire le pause del ragionamento esteso e il buffering dei proxy, e il watchdog a livello di byte limita il valore a 30 minuti. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` ha la precedenza su questa variabile per il watchdog a livello di byte. Per i valori predefiniti di ciascun watchdog in assenza di impostazione, consulta Watchdog di inattività dello streaming
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	Rimossa nella v2.1.260 e ora senza effetto. In precedenza limitava, in millisecondi, la durata di esecuzione di un comando shell in background avviato da un subagent, con un valore predefinito di 60 minuti. Consulta le regole sulla durata dei comandi in background
`DEBUG`	Imposta `1` per abilitare la modalità di debug, equivalente all’avvio con `--debug`. I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, oppure nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori veri `1`, `true`, `yes` e `on` abilitano la modalità di debug, quindi i pattern di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano
`DISABLE_AUTOUPDATER`	Imposta `1` per disabilitare gli aggiornamenti automatici in background. Il comando manuale `claude update` continua a funzionare. Usa `DISABLE_UPDATES` per bloccare entrambi
`DISABLE_AUTO_COMPACT`	Imposta `1` per disabilitare la compattazione automatica quando ci si avvicina al limite di contesto. Il comando manuale `/compact` rimane disponibile. Usala quando vuoi un controllo esplicito su quando avviene la compattazione. Sovrascrive l’impostazione `autoCompactEnabled`
`DISABLE_COMPACT`	Imposta `1` per disabilitare tutta la compattazione: sia la compattazione automatica sia il comando manuale `/compact`
`DISABLE_COST_WARNINGS`	Imposta `1` per disabilitare i messaggi di avviso sui costi
`DISABLE_DOCTOR_COMMAND`	Imposta `1` per nascondere la skill di controllo della configurazione `/doctor` e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire la diagnostica della configurazione da una sessione. Non influisce sul comando da terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva il comando della schermata di diagnostica `/doctor`
`DISABLE_ERROR_REPORTING`	Imposta un qualsiasi valore non vuoto, come `1`, per disattivare la segnalazione degli errori. Impostarla su `0` o `false` la disattiva comunque, a differenza della maggior parte delle variabili on/off; rimuovi l’impostazione della variabile per riattivare la segnalazione degli errori
`DISABLE_EXTRA_USAGE_COMMAND`	Imposta `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i rate limit
`DISABLE_FEEDBACK_COMMAND`	Imposta `1` per disabilitare il comando `/feedback` e il feedback redatto da Claude. Disabilita anche `/bug` e `/share`, che inviano segnalazioni attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando veniva disabilitato con ogni nome. È accettato anche il nome precedente `DISABLE_BUG_COMMAND`
`DISABLE_GROWTHBOOK`	Imposta `1` o `true` per disabilitare il recupero dei feature flag di GrowthBook e usare i valori predefiniti del codice per ogni flag. Questo rende non disponibili Remote Control e le altre funzionalità che richiedono il recupero dei feature flag. Impostarla su `0` o `false` lascia attivo il recupero. La registrazione degli eventi di telemetria rimane attiva a meno che non sia impostata anche `DISABLE_TELEMETRY`
`DISABLE_INSTALLATION_CHECKS`	Imposta `1` per disabilitare gli avvisi di installazione. Usala solo quando gestisci manualmente la posizione di installazione, poiché può nascondere problemi con le installazioni standard
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Imposta `1` per nascondere il comando `/install-github-app`. Già nascosto quando si usano provider di terze parti (Amazon Bedrock, Agent Platform di Google Cloud o Microsoft Foundry)
`DISABLE_INTERLEAVED_THINKING`	Imposta `1` per impedire l’invio dell’header beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il ragionamento interleaved
`DISABLE_LOGIN_COMMAND`	Imposta `1` per nascondere il comando `/login`. Utile quando l’autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper`
`DISABLE_LOGOUT_COMMAND`	Imposta `1` per nascondere il comando `/logout`
`DISABLE_PROMPT_CACHING`	Imposta `1` per disabilitare il prompt caching per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello)
`DISABLE_PROMPT_CACHING_FABLE`	Imposta `1` per disabilitare il prompt caching per i modelli Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Imposta `1` per disabilitare il prompt caching per il modello Haiku predefinito, ovunque venga eseguito
`DISABLE_PROMPT_CACHING_OPUS`	Imposta `1` per disabilitare il prompt caching per il modello Opus predefinito
`DISABLE_PROMPT_CACHING_SONNET`	Imposta `1` per disabilitare il prompt caching per il modello Sonnet predefinito
`DISABLE_TELEMETRY`	Imposta un qualsiasi valore non vuoto, come `1`, per disattivare la telemetria. Impostarla su `0` o `false` la disattiva comunque, a differenza della maggior parte delle variabili on/off; rimuovi 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 feature flag. Consulta Disattivare la telemetria per la tua organizzazione
`DISABLE_UPDATES`	Imposta `1` per bloccare tutti gli aggiornamenti, inclusi i comandi manuali `claude update` e `claude install`. Più restrittiva di `DISABLE_AUTOUPDATER`. Usala quando distribuisci Claude Code attraverso i tuoi canali e gli utenti non devono aggiornarlo autonomamente
`DISABLE_UPGRADE_COMMAND`	Imposta `1` per nascondere il comando `/upgrade`
`DO_NOT_TRACK`	Imposta `1` per disattivare la telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso sul recupero dei feature flag. Claude Code legge questa variabile come un booleano standard, quindi `0` lascia attiva la telemetria, e la rispetta come la convenzione trasversale riconosciuta da molte CLI per sviluppatori
`ENABLE_BETA_TRACING_DETAILED`	Imposta `1`, insieme a `BETA_TRACING_ENDPOINT`, per attivare il tracing beta dettagliato, che aggiunge attributi di span con contenuto e lo span `claude_code.hook`. Le sessioni CLI interattive richiedono inoltre che la tua organizzazione sia inclusa nella lista di autorizzati per la beta. Entrambe le variabili vengono ignorate nelle impostazioni di progetto e locali
`ENABLE_CLAUDEAI_MCP_SERVERS`	Imposta `false` per impedire a Claude Code di recuperare i server MCP di claude.ai. Abilitata per impostazione predefinita per gli utenti che hanno effettuato l’accesso. Per disabilitarla per progetto o per organizzazione, imposta invece `disableClaudeAiConnectors` nelle impostazioni
`ENABLE_PROMPT_CACHING_1H`	Imposta `1` per richiedere un TTL della cache dei prompt di 1 ora invece dei 5 minuti predefiniti. Pensata per gli utenti con chiave API, Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry e Claude Platform on AWS. Gli utenti con abbonamento che rientrano nell’utilizzo incluso ricevono automaticamente il TTL di 1 ora sulla conversazione principale. Gli utenti con abbonamento che attingono ai crediti di utilizzo possono impostarla per mantenere il TTL di 1 ora. Le scritture nella cache di 1 ora vengono fatturate a una tariffa più alta. Per scegliere invece il TTL per ogni categoria di richieste, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Deprecata. Usa invece `ENABLE_PROMPT_CACHING_1H`
`ENABLE_TOOL_SEARCH`	Controlla MCP Tool Search. Se non è impostata, Claude Code rinvia tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo sui modelli di Agent Platform di Google Cloud precedenti alla generazione Claude 4.5, su un deploy di Microsoft Foundry ospitato su Azure e quando `ANTHROPIC_BASE_URL` punta a un host non first-party. `true` rinvia sempre e invia l’header beta, tranne su quegli stessi modelli di Agent Platform e deploy di Microsoft Foundry; le richieste falliscono sui proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti rientrano nel 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore impostato da te viene ignorato quando è impostata `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli su Agent Platform di Google Cloud a meno che non impostassi questa variabile su `true`
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Imposta un qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di riprovare in caso di errori di sovraccarico ripetuti per ogni modello quando non è configurato alcun modello di fallback. Impostarla su `0` o `false` abilita comunque questo comportamento, a differenza della maggior parte delle variabili on/off; rimuovi l’impostazione della variabile per ripristinare il comportamento predefinito dei nuovi tentativi. Senza di essa, Claude Code smette di riprovare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando ti autentichi con una chiave API o un provider di terze parti anziché con un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla catena di modelli di fallback configurata in caso di errori di sovraccarico ripetuti per qualsiasi modello principale, quindi questa variabile non influisce sul passaggio a un modello di fallback
`FORCE_AUTOUPDATE_PLUGINS`	Imposta `1` per forzare gli aggiornamenti automatici dei plugin anche quando l’aggiornamento automatico principale è disabilitato tramite `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Imposta `1` per abilitare i collegamenti ipertestuali OSC 8 cliccabili quando il tuo terminale li supporta ma non viene rilevato automaticamente, oppure `0` per disabilitarli. Quando non è impostata, Claude Code abilita i collegamenti ipertestuali solo quando rileva il supporto del terminale. Claude Code interpreta questo valore come un numero, non come un booleano, quindi un valore come `false`, `no` o `off` abilita i collegamenti ipertestuali anziché disabilitarli. Il badge della PR o della merge request nel piè di pagina viene visualizzato come collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del terminale, ad esempio tramite SSH. Imposta `0` per visualizzare il badge come testo semplice
`FORCE_PROMPT_CACHING_5M`	Imposta `1` per forzare il TTL della cache dei prompt di 5 minuti anche quando altrimenti si applicherebbe il TTL di 1 ora. Sovrascrive `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl`
`HTTP_PROXY`	Specifica il server proxy HTTP per le connessioni di rete
`HTTPS_PROXY`	Specifica il server proxy HTTPS per le connessioni di rete
`IS_DEMO`	Imposta un qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde la tua email e il nome dell’organizzazione dall’intestazione e dall’output di `/status`, e salta l’onboarding. Impostarla su `0` o `false` abilita comunque la modalità demo, a differenza della maggior parte delle variabili on/off; rimuovi l’impostazione della variabile per disattivarla. Utile quando trasmetti in streaming o registri una sessione
`MAX_MCP_OUTPUT_TOKENS`	Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code mostra un avviso quando l’output supera i 10.000 token. Gli strumenti che dichiarano `anthropic/maxResultSizeChars` usano invece quel limite di caratteri per il contenuto testuale, ma il contenuto immagine di tali strumenti è comunque soggetto a questa variabile (predefinito: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto a `--json-schema` in modalità non interattiva con il flag `-p`; dopo altrettanti tentativi falliti senza output valido, l’esecuzione fallisce. Lo stesso limite si applica quando l’output strutturato di un subagent di un workflow non supera la convalida. Il valore predefinito è 5, un primo tentativo più quattro nuovi tentativi
`MAX_THINKING_TOKENS`	Budget fisso di token per il ragionamento esteso. Claude Code lo limita a un token in meno rispetto ai token di output massimi della richiesta e mai al di sotto di 1.024. Consulta `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per sapere come viene impostato quel limite. Quando non è impostata e il ragionamento è abilitato, i modelli con ragionamento adattivo scelgono autonomamente la profondità del ragionamento, mentre gli altri modelli usano il limite. Imposta `0` per disabilitare il ragionamento sull’API Anthropic, tranne su Opus 5.5, Sonnet 5.5 e i modelli Fable, per i quali il ragionamento non può essere disattivato. Sui provider di terze parti, `0` omette invece il parametro `thinking`. Con il ragionamento disattivato sull’API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa non accettare quella combinazione, come Opus 5. Claude Code ignora i valori diversi da zero sui modelli con ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo
`MCP_CLIENT_SECRET`	Client secret OAuth per i server MCP che richiedono credenziali preconfigurate. Evita la richiesta interattiva quando aggiungi un server con `--client-secret`
`MCP_CONNECTION_NONBLOCKING`	Controlla se l’avvio attende la connessione dei server MCP prima della prima query. L’avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che completano la connessione. Imposta `0` per fare in modo che Claude Code attenda la connessione dei server prima della prima query. I server configurati con `alwaysLoad: true` fanno comunque attendere l’avvio, tranne quando vengono serviti dalla cache di discovery, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code attende inoltre i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passi esplicitamente `--mcp-config`, l’attesa ha una scadenza più lunga; consulta la voce di quel flag per l’eccezione relativa ai server nella cache
`MCP_CONNECT_TIMEOUT_MS`	Per quanto tempo, in millisecondi, l’avvio MCP bloccante attende il gruppo di connessioni prima di acquisire l’elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati con `alwaysLoad: true`. I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinta da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server
`MCP_DISCOVERY_CACHE`	Attiva o disattiva la cache di discovery MCP. Con la cache attiva, un server HTTP o SSE remoto che hai già usato può mostrare lo stato `cached`, e Claude Code lo connette alla sua prima chiamata a uno strumento anziché all’avvio. La cache è disattivata per impostazione predefinita, a meno che un rilascio graduale non l’abbia abilitata per il tuo account. Imposta `1` per attivarla, oppure `0` per mantenerla disattivata anche quando il rilascio l’ha abilitata. Prima della v2.1.238, la cache era attiva per impostazione predefinita. Lo stato `cached` richiede Claude Code v2.1.221 o successivo
`MCP_DISCOVERY_CACHE_MAX_STALE_S`	Età massima, in secondi, di una voce della cache di discovery (predefinito: 14400, ovvero 4 ore). A un avvio in cui la voce è più vecchia di tale valore, Claude Code la scarta e connette il server all’avvio, come fa con la cache disattivata. Claude Code limita il valore a 7 giorni. Prima della v2.1.238, il valore predefinito era 86400, ovvero 24 ore, e Claude Code non limitava il valore
`MCP_DISCOVERY_CACHE_STRIKES`	A un avvio in cui una voce della cache di discovery è più vecchia di `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la aggiorna in background. Questa variabile imposta quanti aggiornamenti consecutivi possono fallire prima che Claude Code scarti la voce e connetta invece il server all’avvio successivo (predefinito: 1). Aumentala se la tua connessione di rete cade occasionalmente, in modo che un singolo aggiornamento fallito non scarti la voce. Richiede Claude Code v2.1.238 o successivo
`MCP_DISCOVERY_CACHE_TTL_S`	Secondi per cui Claude Code usa una voce della cache di discovery senza aggiornarla (predefinito: 900). A un avvio in cui la voce è più vecchia di tale valore, Claude Code la usa comunque ma la aggiorna in background. Quando 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 per impostazione predefinita è 4 ore. Prima della v2.1.238, Claude Code non limitava il valore
`MCP_OAUTH_CALLBACK_PORT`	Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando aggiungi un server MCP con credenziali preconfigurate
`MCP_PROTOCOL_NEGOTIATION`	Solo sul runtime client MCP v2, determina se Claude Code sonda i server per la revisione del protocollo MCP 2026-07-28. Imposta `auto` per sondare i server HTTP, i server dei connettori claude.ai e i server stdio; un server che non risponde al sondaggio si connette invece con il protocollo precedente, come fanno sempre i server SSE e WebSocket. Imposta `legacy` per saltare il sondaggio per ogni server. Senza la variabile, Claude Code sonda i server HTTP, e sonda anche i server dei connettori claude.ai nelle sessioni in cui recupera i feature flag. Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successivo
`MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE`	Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l’avvio (predefinito: 20)
`MCP_SDK_GENERATION`	Fissa il runtime client MCP con cui questo processo si connette ai server MCP: `v1`, basato su MCP TypeScript SDK 1.x, oppure `v2`, basato su MCP TypeScript SDK 2.0. Senza la variabile, Claude Code usa v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 verifica l’emittente restituito da un server OAuth MCP nella sua risposta di autorizzazione e, quando non corrisponde, fa fallire l’accesso con un errore che inizia con `Issuer mismatch in authorization response`. Il runtime v1 non esegue questo controllo. Se imposti un valore non riconosciuto, Claude Code lo ignora e scrive un avviso nel log di debug. Claude Code legge il valore una volta per processo. Richiede Claude Code v2.1.218 o successivo
`MCP_SERVER_CONNECTION_BATCH_SIZE`	Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l’avvio (predefinito: 3)
`MCP_TIMEOUT`	Timeout in millisecondi per l’avvio dei server MCP (predefinito: 30000, ovvero 30 secondi)
`MCP_TOOL_TIMEOUT`	Timeout in millisecondi per l’esecuzione degli strumenti MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta va inoltre in timeout dopo 60 secondi per impostazione predefinita; imposta questa variabile, o il `timeout` per singolo server, a un valore superiore a 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout complessivo di esecuzione dello strumento, ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per singolo server in `.mcp.json` sovrascrive questo valore per quel server. Un `timeout` per singolo server di almeno 1000 imposta anche la finestra minima di inattività per le chiamate agli strumenti di quel server, in modo che `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompa mai prima; questo valore minimo richiede Claude Code v2.1.203 o successivo. Per la variabile d’ambiente, i valori inferiori a 1000 vengono arrotondati a un secondo; per il campo per singolo server, i valori inferiori a 1000 vengono ignorati
`NO_PROXY`	Elenco di domini e IP a cui le richieste verranno inviate direttamente, aggirando il proxy
`OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT`	Limite standard dell’SDK OpenTelemetry sulla lunghezza dei valori degli attributi. Claude Code limita gli attributi di telemetria con contenuto al valore minore tra questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che l’indicatore di troncamento rimanga entro il limite dell’SDK. Claude Code legge allo stesso modo le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, e il valore impostato più piccolo si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Consulta Monitoraggio
`OTEL_LOG_ASSISTANT_RESPONSES`	Imposta `1` per includere il testo della risposta del modello negli eventi di log OpenTelemetry `assistant_response`. Quando non è impostata, Claude Code usa invece il valore di `OTEL_LOG_USER_PROMPTS`. Imposta `0` per mantenere le risposte oscurate anche quando `OTEL_LOG_USER_PROMPTS` è impostata. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali. Richiede Claude Code v2.1.193 o successivo. Consulta Monitoraggio
`OTEL_LOG_MANAGED_SETTINGS`	Imposta `1` per aggiungere le impostazioni gestite oscurate, e un digest SHA-256 delle impostazioni prima dell’oscuramento, agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitata per impostazione predefinita. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite; un valore nelle impostazioni di progetto o locali non la attiva. Richiede Claude Code v2.1.274 o successivo. Consulta Monitoraggio
`OTEL_LOG_RAW_API_BODIES`	Emette il JSON delle richieste e delle risposte della Messages API di Anthropic come eventi di log `api_request_body` / `api_response_body`. Imposta `1` per corpi inline troncati al limite del contenuto, oppure `file:<dir>` per scrivere su disco i corpi non troncati ed emettere invece un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite del contenuto, 60 KB per impostazione predefinita. Disabilitata per impostazione predefinita; i corpi includono l’intera cronologia della conversazione. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali. Consulta Monitoraggio
`OTEL_LOG_TOOL_CONTENT`	Imposta `1` per includere il contenuto degli strumenti nell’evento di span OpenTelemetry `tool.output`. Gli attributi di span riportano il contenuto degli strumenti secondo i propri vincoli. Richiede il tracing. Disabilitata per impostazione predefinita per proteggere i dati sensibili. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali, fatta eccezione per i valori di disattivazione descritti in quella sezione. Consulta Monitoraggio
`OTEL_LOG_TOOL_DETAILS`	Imposta `1` per includere gli argomenti di input degli strumenti; i nomi dei server MCP; i nomi dei workflow creati dagli utenti; le stringhe di errore grezze in caso di errori degli strumenti; la `category` del rifiuto negli eventi `api_refusal`; i nomi reali di agenti, skill, plugin e server MCP nelle metriche di costo e token; e altri dettagli degli strumenti nelle metriche, nelle tracce e nei log di OpenTelemetry. Disabilitata per impostazione predefinita per proteggere le PII. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali, fatta eccezione per i valori di disattivazione descritti in quella sezione. Consulta Monitoraggio
`OTEL_LOG_USER_PROMPTS`	Imposta `1` per includere il testo dei prompt dell’utente nelle tracce e nei log di OpenTelemetry. Disabilitata per impostazione predefinita (i prompt vengono oscurati). Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle impostazioni di progetto e locali, fatta eccezione per i valori di disattivazione descritti in quella sezione. Consulta Monitoraggio
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Imposta `false` per escludere l’UUID dell’account dagli attributi delle metriche (predefinito: incluso). Consulta Monitoraggio
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Imposta `true` per includere l’entrypoint della sessione negli attributi delle metriche (predefinito: escluso). Aggiunta nella v2.1.152. Consulta Monitoraggio
`OTEL_METRICS_INCLUDE_REPOSITORY`	Imposta `true` per contrassegnare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Consulta Attributi del repository
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partire dalla v2.1.161, Claude Code associa le chiavi di `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei datapoint delle metriche. Imposta `false` per escluderle (predefinito: incluse). Consulta Monitoraggio
`OTEL_METRICS_INCLUDE_SESSION_ID`	Imposta `false` per escludere l’ID della sessione dagli attributi delle metriche (predefinito: incluso). Consulta Monitoraggio
`OTEL_METRICS_INCLUDE_VERSION`	Imposta `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: esclusa). Consulta Monitoraggio
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Sovrascrive il budget di caratteri per i metadati delle skill mostrati allo strumento Skill. Il budget si adatta dinamicamente all’1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per compatibilità con le versioni precedenti
`TASK_MAX_OUTPUT_LENGTH`	Rimossa nella v2.1.277 e ora senza effetto, insieme allo strumento `TaskOutput` di cui definiva la dimensione. In precedenza impostava il numero massimo di caratteri dell’output di un’attività in background che lo strumento `TaskOutput` conservava. Claude legge invece il file di output di un’attività in background con `Read`
`USE_BUILTIN_RIPGREP`	Imposta `0` per usare `rg` installato nel sistema invece di `rg` incluso in Claude Code
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Sovrascrive la regione per Claude 3.5 Haiku quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Sovrascrive la regione per Claude 3.5 Sonnet quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Sovrascrive la regione per Claude 3.7 Sonnet quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Sovrascrive la regione per Claude 4.0 Opus quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Sovrascrive la regione per Claude 4.0 Sonnet quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Sovrascrive la regione per Claude 4.1 Opus quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Sovrascrive la regione per Claude Opus 4.5 quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Sovrascrive la regione per Claude Sonnet 4.5 quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Sovrascrive la regione per Claude Opus 4.6 quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Sovrascrive la regione per Claude Sonnet 4.6 quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Sovrascrive la regione per Claude Opus 4.7 quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Sovrascrive la regione per Claude Opus 4.8 quando usi Agent Platform di Google Cloud
`VERTEX_REGION_CLAUDE_5_5_OPUS`	Sovrascrive la regione per Claude Opus 5.5 quando usi Agent Platform di Google Cloud. Aggiunta nella v2.1.280
`VERTEX_REGION_CLAUDE_5_5_SONNET`	Sovrascrive la regione per Claude Sonnet 5.5 quando usi Agent Platform di Google Cloud. Aggiunta nella v2.1.284
`VERTEX_REGION_CLAUDE_5_OPUS`	Sovrascrive la regione per Claude Opus 5 quando usi Agent Platform di Google Cloud. Aggiunta nella v2.1.219
`VERTEX_REGION_CLAUDE_5_SONNET`	Sovrascrive la regione per Claude Sonnet 5 quando usi Agent Platform di Google Cloud. Aggiunta nella v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Sovrascrive la regione per Claude Fable 5 quando usi Agent Platform di Google Cloud. Aggiunta nella v2.1.170
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Sovrascrive la regione per Claude Fable 5.1 quando usi Agent Platform di Google Cloud. Aggiunta nella v2.1.257
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Sovrascrive la regione per Claude Haiku 4.5 quando usi Agent Platform di Google Cloud

Sono supportate anche le variabili standard degli exporter OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES e le varianti specifiche per segnale). Consulta Monitoraggio per i dettagli di configurazione. Imposta CLAUDE_CODE_ENABLE_TELEMETRY e le variabili OpenTelemetry che attivano l’esportazione, ne scelgono la destinazione o acquisiscono contenuti nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Claude Code le ignora nelle impostazioni di progetto e locali, fatta eccezione per i valori di disattivazione descritti in quella sezione. OTEL_RESOURCE_ATTRIBUTES e le variabili relative a intervallo di esportazione, timeout e compressione, come OTEL_METRIC_EXPORT_INTERVAL, si applicano comunque dalle impostazioni di progetto e locali.

Funzionalità che richiedono il recupero dei feature flag

Claude Code attiva alcune funzionalità tramite feature flag che recupera da Anthropic. Claude Code salta questo recupero in queste sessioni:

Una sessione in cui impostate DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK, o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; la riga di ogni variabile nella tabella delle variabili indica quali valori disattivano il recupero
Una sessione su un provider di terze parti, come Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, o Microsoft Foundry, a meno che una piattaforma host che incorpora Claude Code non imposti CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
Una sessione di gateway delle app Claude

Con il recupero disattivato, non potete:

Eseguire /auto-mode-setup per elaborare le voci autoMode.environment
Utilizzare Remote Control con CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_GROWTHBOOK impostati. Per DISABLE_TELEMETRY e DO_NOT_TRACK, consultate i requisiti di Remote Control
Inviare messaggi alle sessioni oltre questa macchina quando Remote Control non è disponibile. La messaggistica tra sessioni su questa macchina funziona con il recupero disattivato
Eseguire claude import o il comando /import
Eseguire /skill-doctor o aprire il suo rapporto nella scheda Stats di /plugin
Sincronizzare le skill e i plugin abilitati per il vostro account claude.ai nelle vostre sessioni di terminale
Utilizzare lo strumento advisor
Leggere o rispondere ai commenti su un artefatto
Far leggere a Claude l’artefatto pubblico di un’altra organizzazione
Avere Claude Code sondare i server del connettore claude.ai per la revisione del protocollo MCP 2026-07-28 a meno che non impostiate MCP_PROTOCOL_NEGOTIATION=auto
Ottenere lo strumento PowerShell 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
Ottenere il feedback elaborato da Claude, che Claude Code attiva tramite un flag recuperato
Far trattare a Claude i grandi incollamenti come testo incollato piuttosto che digitato; il contenuto dietro un segnaposto [Pasted text #N] raggiunge Claude senza marcatura
Avere Claude Code escludere i tool MCP il cui schema di input l’API rifiuterebbe; invia comunque lo schema, e una richiesta che lo include fallisce con un errore 400 che nomina il tool in base alla sua posizione

Prima sessione dopo un’installazione o un aggiornamento

Nella vostra prima sessione dopo aver installato Claude Code, o aggiornato a una versione che aggiunge una funzionalità, una funzionalità con gate flag può mancare. Quella sessione può anche avviarsi in una diversa modalità di autorizzazione rispetto alle vostre sessioni successive. Claude Code recupera i flag durante quella sessione, quindi la vostra sessione successiva ha la funzionalità e la modalità di autorizzazione iniziale usuale. Dopo un’installazione pulita, in una sessione non interattiva come claude -p, l’Agent SDK, o l’estensione VS Code, Claude Code può comunque recuperare i flag prima di scegliere la modalità di autorizzazione iniziale.

Vedi anche

Impostazioni: tutte le configurazioni settings.json, inclusa la chiave env
Riferimento CLI: flag di avvio
Configurazione di rete: configurazione proxy e TLS
Monitoraggio: configurazione OpenTelemetry

​Impostare variabili d’ambiente

​Nella tua shell

​Nei file di impostazioni

​Precedenza

​Variabili

​Funzionalità che richiedono il recupero dei feature flag

​Prima sessione dopo un’installazione o un aggiornamento

​Vedi anche