Variabili d'ambiente

Riferimento per le variabili d'ambiente che controllano il comportamento di Claude Code.

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 di 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:

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, quindi conferma che la variabile è impostata stampandola nella stessa shell prima di eseguire claude:

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.

{
  "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 di 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 state impostando, controllate la riga della variabile di seguito e la voce della chiave nel riferimento delle impostazioni.

Quando la stessa variabile è impostata sia nella vostra shell che in un blocco env del file di impostazioni, il valore del file di impostazioni si applica. Claude Code scrive ogni voce env nell'ambiente del processo, sostituendo il valore ereditato dalla shell. L'impostazione env indica quando la applica. Alcune variabili sono trattate come casi speciali; l'impostazione env elenca le eccezioni.

In un file di impostazioni potete impostare una variabile ma non potete rimuoverne una. Per sovrascrivere una variabile che non potete annullare, come una CLAUDE_CODE_USE_VERTEX obsoleta esportata da un profilo di shell che non controllate, impostatela su una stringa vuota nel blocco env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code tratta il valore vuoto come non impostato per la selezione del provider. I sottoprocessi ereditano comunque il valore vuoto.

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.

Il modo in cui una variabile di ambiente interagisce con i flag CLI e i comandi in-session varia per funzionalità: --model e /model sovrascrivono ANTHROPIC_MODEL, mentre CLAUDE_CODE_EFFORT_LEVEL sovrascrive --effort e /effort. Quando una variabile interagisce con un'altra fonte di configurazione, la sua riga nell'elenco Variabili dichiara la precedenza o rimanda alla pagina che la documenta.

Claude Code legge le variabili di ambiente della shell all'avvio, quindi le modifiche ad esse hanno effetto la prossima volta che avviate 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 conteggi di tentativi accettano notazione scientifica e ortografia con separatori di cifre oltre alle cifre semplici, tranne dove la riga di una variabile nota che accetta solo cifre semplici. Ad esempio, Claude Code legge 2e3 come 2000 e 64_000 come 64000. Prima della v2.1.211, queste ortografie potevano impostare silenziosamente un valore molto più piccolo, come 1e6 che impostava un timeout a 1.

Variabile	Scopo
`ANTHROPIC_API_KEY`	Chiave API inviata come intestazione `X-Api-Key`. Quando impostata, questa chiave viene utilizzata al posto del vostro abbonamento Claude Pro, Max, Team o Enterprise anche se siete connessi. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente. In modalità interattiva, vi viene chiesto di approvare la chiave una volta prima che sostituisca il vostro abbonamento. Per utilizzare il vostro abbonamento, eseguite `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valore personalizzato per l'intestazione `Authorization` (il valore che impostate qui sarà preceduto da `Bearer` )
`ANTHROPIC_AWS_API_KEY`	Chiave API dell'area di lavoro per Claude Platform on AWS, generata nella Console AWS. Inviata come `x-api-key` e ha la precedenza su AWS SigV4
`ANTHROPIC_AWS_BASE_URL`	Sostituire l'URL dell'endpoint Claude Platform on AWS. Utilizzare per aree personalizzate o quando si instrada attraverso un gateway LLM. Impostazione predefinita: `https://aws-external-anthropic.{region}.api.aws`. Claude Code risolve l'area con la stessa precedenza di Amazon Bedrock
`ANTHROPIC_AWS_WORKSPACE_ID`	Obbligatorio per Claude Platform on AWS. Inviato su ogni richiesta come intestazione `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Sostituire l'endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, ricerca strumenti MCP è disabilitata per impostazione predefinita. Impostare `ENABLE_TOOL_SEARCH=true` se il vostro proxy inoltra blocchi `tool_reference`. A partire dalla v2.1.196, Remote Control è disabilitato quando questo punta a un host diverso da `api.anthropic.com`, corrispondendo al suo comportamento su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry
`ANTHROPIC_BEDROCK_BASE_URL`	Sostituire l'URL dell'endpoint Amazon Bedrock. Utilizzare per endpoint Amazon Bedrock personalizzati o quando si instrada attraverso un gateway LLM. Vedere Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Sostituire l'URL dell'endpoint Amazon Bedrock Mantle. Vedere endpoint Mantle
`ANTHROPIC_BEDROCK_REGION_PREFIX`	Prefisso del profilo di inferenza tra aree (`us`, `eu`, `apac`, `jp`, `au`, o `global`) che Claude Code prova per primo al posto di quello derivato dall'area AWS. Ignorato nelle aree AWS GovCloud. Richiede Claude Code v2.1.224 o successivo. Vedere Amazon Bedrock
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Livello di servizio Amazon Bedrock (`default`, `flex`, o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Vedere Amazon Bedrock
`ANTHROPIC_BETAS`	Elenco separato da virgole di valori di intestazione `anthropic-beta` aggiuntivi da includere nelle richieste API. Claude Code invia già gli intestazioni beta di cui ha bisogno; utilizzare questo per aderire a un beta API Anthropic 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`, separato da nuova riga per più intestazioni). Se un nome o un valore contiene un carattere che un'intestazione HTTP non può trasportare, come una virgoletta ricurva o uno spazio di larghezza zero, la richiesta fallisce con un errore che identifica la coppia per posizione. Richiede Claude Code v2.1.227 o successivo. Invalid request header value elenca l'insieme esatto di caratteri e dove viene eseguito il controllo. Un valore che imposta un'intestazione di credenziale, organizzazione o tenant, instradamento o comportamento API, come `Authorization` o `Host`, conta come un impostazione che necessita approvazione quando le impostazioni gestite dal server la consegnano. Dalle impostazioni di progetto o locali, tale valore segue le regole per quando i valori `env` si applicano
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID modello da aggiungere come voce personalizzata nel selettore `/model`. Utilizzare per rendere selezionabile un modello non standard o specifico del gateway senza sostituire gli alias incorporati. Vedere Configurazione del modello
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Descrizione di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Impostazione predefinita: `Custom model (<model-id>)` quando non impostato
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	Nome di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Quando non impostato, la voce mostra il nome del modello se Claude Code riconosce l'ID, e l'ID del modello altrimenti
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Elenco separato da virgole di capacità supportate dal modello personalizzato, ad esempio `effort,thinking`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID modello a cui l'alias `fable` si risolve, e l'ID che Claude Code riconosce come modello Fable per il fallback automatico del modello su provider di terze parti. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Descrizione di visualizzazione per il modello Fable bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Nome di visualizzazione per il modello Fable bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole di capacità supportate dal modello Fable bloccato, ad esempio `effort,thinking`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	ID modello a cui l'alias `haiku` si risolve, utilizzato anche per funzionalità in background. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Descrizione di visualizzazione per il modello Haiku bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Nome di visualizzazione per il modello Haiku bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole di capacità supportate dal modello Haiku bloccato, ad esempio `effort,thinking`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_MODEL`	Modello su cui le nuove sessioni iniziano per impostazione predefinita. Richiede Claude Code v2.1.236 o successivo. Vedere Impostare un modello predefinito per le nuove sessioni
`ANTHROPIC_DEFAULT_OPUS_MODEL`	ID modello a cui l'alias `opus` si risolve, e che `opusplan` utilizza mentre Plan Mode è attivo. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descrizione di visualizzazione per il modello Opus bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nome di visualizzazione per il modello Opus bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole di capacità supportate dal modello Opus bloccato, ad esempio `effort,thinking`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL`	ID modello a cui l'alias `sonnet` si risolve, e che `opusplan` utilizza quando Plan Mode non è attivo. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Descrizione di visualizzazione per il modello Sonnet bloccato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Nome di visualizzazione per il modello Sonnet bloccato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID bloccato, e l'ID bloccato altrimenti. Vedere Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Elenco separato da virgole di capacità supportate dal modello Sonnet bloccato, ad esempio `effort,thinking`. Vedere Configurazione del modello
`ANTHROPIC_FEDERATION_RULE_ID`	ID regola di federazione per Workload Identity Federation. Quando lo impostate insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno la precedenza sulla vostra credenziale `/login`. Vedere precedenza di autenticazione
`ANTHROPIC_FOUNDRY_API_KEY`	Chiave API per l'autenticazione Microsoft Foundry (vedere 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. Vedere Microsoft Foundry. Richiede Claude Code v2.1.203 o successivo
`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` (vedere Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Obbligatorio se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostato (vedere Microsoft Foundry)
`ANTHROPIC_MODEL`	Nome dell'impostazione del modello da utilizzare (vedere Configurazione del modello)
`ANTHROPIC_ORGANIZATION_ID`	ID organizzazione per Workload Identity Federation. Impostatelo insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Vedere precedenza di autenticazione
`ANTHROPIC_PROFILE`	Nome del profilo Anthropic con cui autenticarsi, come uno creato da `ant auth login` o da accesso a un account Console senza chiave API. Vedere precedenza di autenticazione
`ANTHROPIC_SMALL_FAST_MODEL`	[DEPRECATO] Nome di modello di classe Haiku per attività in background
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Sostituire l'area AWS per il modello di classe Haiku quando si utilizza Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, questo ha effetto solo quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` o il deprecato `ANTHROPIC_SMALL_FAST_MODEL` è anche impostato, poiché Amazon Bedrock altrimenti esegue attività in background sul modello Sonnet predefinito o sul modello primario nell'area della sessione
`ANTHROPIC_VERTEX_BASE_URL`	Sostituire l'URL dell'endpoint Google Cloud's Agent Platform. Utilizzare per endpoint Google Cloud's Agent Platform personalizzati o quando si instrada attraverso un gateway LLM. Vedere Google Cloud's Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID progetto GCP a cui sono indirizzate le richieste di Google Cloud's Agent Platform. Vedere Configurare le credenziali GCP
`ANTHROPIC_WORKSPACE_ID`	ID area di lavoro per federazione dell'identità del carico di lavoro. Impostatelo quando la vostra regola di federazione è limitata a più di un'area di lavoro in modo che lo scambio di token sappia quale area di lavoro scegliere come destinazione
`API_FORCE_IDLE_TIMEOUT`	Sostituire il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Impostare su `0` per disattivare il timeout, ad esempio quando un gateway lento o un modello locale fa una pausa più lunga di 5 minuti tra i chunk, o `1` per mantenerlo attivo per ogni provider. Quando non impostato, il timeout è attivo su provider diversi dall'API Anthropic diretta e Claude Platform on AWS. I watchdog di flusso funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando impostate `0` qui
`API_TIMEOUT_MS`	Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumentare quando le richieste scadono su reti lente o quando si instrada attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste
`AWS_BEARER_TOKEN_BEDROCK`	Chiave API Amazon Bedrock per l'autenticazione (vedere Chiavi API Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Timeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti)
`BASH_MAX_OUTPUT_LENGTH`	Numero massimo di caratteri dell'output bash che Claude Code legge di nuovo nel risultato di un comando (predefinito: 30000; massimo: 150000). Se impostate l'impostazione `bashOutputMaxChars`, Claude Code ignora questa variabile. Vedere Limiti di output
`BASH_MAX_TIMEOUT_MS`	Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti). Il limite effettivo è il maggiore tra questo e `BASH_DEFAULT_TIMEOUT_MS`
`BETA_TRACING_ENDPOINT`	Endpoint OTLP per tracciamento beta dettagliato: con `ENABLE_BETA_TRACING_DETAILED=1`, i log e le tracce vanno lì invece che agli esportatori configurati. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle impostazioni di progetto e locali
`CCR_FORCE_BUNDLE`	Impostare su `1` per forzare `claude --cloud` a raggruppare e caricare il vostro repository locale invece di clonarlo dal suo remoto
`CLAUDECODE`	Impostare su `1` nei sottoprocessi che Claude Code genera (strumenti Bash e PowerShell, sessioni tmux, comandi hook, comandi linea di stato, sottoprocessi server MCP stdio). Le estensioni IDE impostano anche questo nei loro terminali integrati. Utilizzare per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso generato da Claude Code. Per verificare se il processo corrente è stato generato direttamente da una chiamata di strumento o hook, piuttosto che all'interno di un server MCP stdio che Claude Code ha avviato, utilizzare `CLAUDE_CODE_CHILD_SESSION`
`CLAUDE_AFK_COUNTDOWN_MS`	Quanti millisecondi prima dell'auto-continuazione il conto alla rovescia sullo schermo appare su una finestra di dialogo `AskUserQuestion` senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di auto-continuazione. Non ha effetto a meno che l'auto-continuazione non sia attiva; vedere l'impostazione `askUserQuestionTimeout` e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successivo
`CLAUDE_AFK_TIMEOUT_MS`	Quanti millisecondi di tempo di inattività prima che una finestra di dialogo `AskUserQuestion` senza risposta continui automaticamente senza di voi. L'auto-continuazione è disattivata per impostazione predefinita; aderire con l'impostazione `askUserQuestionTimeout`. Questa variabile è un override per demo e test automatizzati: quando impostata, ha la precedenza su tale impostazione e attiva l'auto-continuazione anche quando l'impostazione non è impostata o è `never`. L'impostazione di `0` non disattiva il timeout; chiude la finestra di dialogo immediatamente. Nella v2.1.198 e v2.1.199, l'auto-continuazione era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successivo
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	Impostare su `1` per disabilitare tutti i tipi di subagent incorporati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti SDK che desiderano una lavagna pulita. Questo rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata dello strumento Agent omette `subagent_type`. Tale chiamata fallisce quindi con `subagent_type is required`
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	Impostare su `1` per saltare il prefisso `mcp__<server>__` sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumentate `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog di flusso è attivo, il predefinito aumenta con esso, come Gestire risposte API lente o bloccate descrive. Il timer si ripristina su ogni evento di progresso di streaming; se nessun progresso arriva entro la finestra, Claude Code interrompe il subagent e segnala lo stallo al genitore
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Impostare la percentuale (1-100) della finestra di auto-compattazione in cui si attiva la compattazione automatica. Utilizzare valori inferiori come `50` per compattare prima; la variabile non può aumentare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo alle sessioni che compattano prima del limite di contesto del modello. Si applica sia alle conversazioni principali che ai subagent
`CLAUDE_AUTO_BACKGROUND_TASKS`	Impostare su `1` per forzare l'abilitazione dello sfondo automatico dei compiti agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l'esecuzione per circa due minuti. Abilita anche lo sfondo automatico delle lunghe chiamate di strumenti MCP in modalità non interattiva su Claude Code v2.1.212 o successivo
`CLAUDE_AX_PREPARK_MS`	In modalità lettore di schermo, quanti millisecondi Claude Code aspetta, con il cursore all'inizio della riga, prima di scrivere una riga nuova o modificata. Predefinito `50`. Impostare `0` per scrivere immediatamente. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successivo
`CLAUDE_AX_SCREEN_READER`	Impostare su `1` per eseguire il rendering dell'output compatibile con il lettore di schermo: testo piatto senza bordi decorativi o animazioni. Impostare su `0` per forzare la disattivazione della modalità lettore di schermo anche quando `axScreenReader` è `true`. Il flag `--ax-screen-reader` ha la precedenza. Richiede Claude Code v2.1.181 o successivo
`CLAUDE_AX_STARTUP_QUIET_MS`	In modalità lettore di schermo, quanti millisecondi Claude Code mantiene il primo rendering dell'interfaccia dopo la riga di conferma di avvio, in modo che il vostro lettore di schermo possa pronunciare la riga completamente prima che il nuovo output l'interrompa. Predefinito `3000`. Impostare `0` per eseguire il rendering immediatamente. Claude Code limita la sospensione a `600000` (10 minuti). La vostra prima pressione di tasto termina la sospensione in anticipo. Richiede Claude Code v2.1.217 o successivo
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Tornare 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à di flusso a livello di byte; quando impostato, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia il watchdog a livello di evento invariato. Claude Code limita questa variabile tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successivo
`CLAUDE_CLIENT_PRESENCE_FILE`	Percorso a un file che uno strumento esterno, come un listener di blocco dello schermo, crea quando sbloccare lo schermo e elimina quando lo blocca. Mentre il file esiste, Claude Code salta notifiche push mobili di Remote Control, quindi smettete di ricevere push mentre state utilizzando attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per evento di attivazione push piuttosto che eseguire il polling. Richiede Claude Code v2.1.181 o successivo
`CLAUDE_CODE_ACCESSIBILITY`	Impostare su `1` per mantenere visibile il cursore del terminale nativo e disabilitare l'indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`	Impostare su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria
`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT`	Impostare su `1` per ridisegnare l'intero schermo su ogni frame nel rendering a schermo intero invece di inviare aggiornamenti incrementali. Utilizzare se la modalità a schermo intero mostra frammenti di testo stantii o posizionati male. Claude Code abilita questo automaticamente per le sessioni in background e visualizzazione agente su Windows
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Impostare su `1` per inviare il parametro effort con ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come in grado di supportare lo sforzo. Utilizzare quando si instrada attraverso un gateway LLM o provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort all'API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1, e Haiku 4.5, sono comunque esclusi in modo che le richieste non falliscano
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	Intervallo in millisecondi in cui le credenziali devono essere aggiornate (quando si utilizza `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Impostare su `0` per impedire a Claude Code di aprire il browser automaticamente quando viene pubblicato un nuovo artifact
`CLAUDE_CODE_ARTIFACT_COMMENTS`	Impostare su `0` per impedire a Claude di leggere e rispondere ai commenti su un artifact. Non ha effetto quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha disattivato gli artifact. Richiede Claude Code v2.1.221 o successivo
`CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT`	Impostare su `0` per impedire a Claude di rispondere da solo ai commenti inviatigli. Richiede Claude Code v2.1.228 o successivo
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Impostare su `0` per omettere il blocco di attribuzione, che trasporta la versione del client e un'impronta digitale del prompt, dall'inizio del prompt di sistema. La memorizzazione in cache su una connessione diretta all'API Anthropic non è interessata in entrambi i casi. In alcuni setup di connessione diretta, Claude Code mantiene il blocco sulle richieste del classificatore modalità auto anche quando impostate `0`. In Blocco di attribuzione del prompt di sistema, controllate quali connessioni e credenziali questo copre. Prima della v2.1.181 il blocco includeva un token per richiesta su URL di base personalizzati e connessioni Microsoft Foundry, quindi su quelle versioni impostatelo su `0` quando il vostro gateway LLM memorizza in cache il corpo della richiesta o inoltra le richieste a un provider di terze parti, o quando vi connettete a Microsoft Foundry direttamente
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è abilitato, secondi tra i promemoria a Claude di controllare i subagent in background ancora in esecuzione. Accetta un numero intero semplice da `1` a `86400` solo; qualsiasi altro valore o ortografia legge come non impostato. Quando non impostato, non ci sono promemoria di check-in. Richiede Claude Code v2.1.248 o successivo
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Impostare la finestra di auto-compattazione in token, da `100000` a `1000000`. Accetta un numero intero semplice come `500000` solo: un valore come `500k` legge come `500` e si limita al minimo di 100K. La finestra effettiva è anche limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, il flag `--autocompact` e l'impostazione `autoCompactWindow`. La percentuale `used_percentage` della linea di stato misura sempre contro la finestra di contesto completa del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Sostituire la connessione IDE automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all'interno del terminale integrato di un IDE supportato. Impostare su `false` per impedire questo. Impostare su `true` per forzare un tentativo di connessione quando l'auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale genitore. Ha la precedenza sull'impostazione di configurazione globale `autoConnectIde`
`CLAUDE_CODE_AUTO_MODE_SERVER`	Controlla se Claude Code chiede al server di rivedere le azioni della modalità auto. Quando non impostato, Claude Code chiede al server su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, e quando puntate `ANTHROPIC_BASE_URL` a un gateway LLM o proxy. Impostare su `0` per utilizzare le richieste del classificatore di Claude Code. Non letto su una connessione diretta all'API Anthropic. Richiede Claude Code v2.1.271 o successivo; chiedere al server per impostazione predefinita richiede v2.1.278 o successivo
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tempo in millisecondi che Claude Code aspetta affinché la catena del provider di credenziali predefinito AWS produca credenziali prima che la richiesta fallisca con `AWS default-chain credential resolve timed out` (predefinito: `60000`). Aumentare quando un passaggio nella vostra catena ha legittimamente bisogno di più tempo, come un accesso SSO basato su browser con MFA attraverso un wrapper come `aws-vault`. Si applica ovunque Claude Code firmi con la catena predefinita: Amazon Bedrock, Claude Platform on AWS, e l'endpoint Mantle. Richiede Claude Code v2.1.207 o successivo
`CLAUDE_CODE_BASH_EDIT_DIFF`	Impostare su `0` per disattivare il diff dei file che sono cambiati mentre un comando Bash era in esecuzione, o `1` per registrarlo in ogni modalità di autorizzazione. Ha la precedenza sull'impostazione `bashEditDiffEnabled`. Richiede Claude Code v2.1.269 o successivo
`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`	Impostare su `0` per fare in modo che una sessione non interattiva segnali uno stato di inattività al suo host alla fine di ogni turno, anche mentre il lavoro in background è ancora in esecuzione. Per impostazione predefinita, la sessione continua a segnalare uno stato di esecuzione oltre la fine del turno mentre il lavoro in background come un agente in background o un'esecuzione di workflow è ancora attivo. Questo impedisce a un host che osserva lo stato, come un elenco di sessioni remote, di annunciare che Claude sta aspettando il vostro input a metà lavoro. I comandi shell in background, come un server di sviluppo, non mantengono lo stato di esecuzione. Il predefinito dello stato di esecuzione e l'opt-out di `0` richiedono Claude Code v2.1.269 o successivo; su versioni precedenti, impostare `1` per mantenere lo stato di esecuzione
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Impostato automaticamente nei sottoprocessi dello strumento Bash e comando hook mentre la sessione ha una connessione Remote Control attiva, e rimosso quando la connessione termina. Il valore è l'ID della sessione in forma `session_`, lo stesso identificatore che appare nell'URL `claude.ai/code` della sessione, quindi uno script può collegarsi di nuovo alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successivo. Nelle sessioni cloud, leggere `CLAUDE_CODE_REMOTE_SESSION_ID`
`CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`	Impostare su `0` per fare in modo che Claude Code legga il byte `0x08`, anche scritto `^H`, come Backspace semplice, o `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono il predefinito della piattaforma. Per impostazione predefinita, Claude Code lo legge come Ctrl+Backspace su Windows, tranne quando `TERM_PROGRAM` è `mintty` o `TERM` è `cygwin`, e come Backspace semplice su macOS e Linux. Impostare `0` in un terminale Windows dove Backspace elimina un'intera parola
`CLAUDE_CODE_CERT_STORE`	Elenco separato da virgole di fonti di certificati CA per le connessioni TLS. `bundled` è l'insieme Mozilla CA fornito con Claude Code. `system` è l'archivio di fiducia del sistema operativo, letto solo su runtime con `tls.getCACertificates`: il binario nativo, o Node 22.15 o successivo per le installazioni npm. Vedere Archivio di certificati CA. Il predefinito è `bundled,system`
`CLAUDE_CODE_CHILD_SESSION`	Impostato su `1` nei sottoprocessi che Claude Code genera tramite gli strumenti Bash, PowerShell e Monitor, comandi hook e comandi linea di stato. Non impostato per i sottoprocessi server MCP stdio, che sono di lunga durata e sopravvivono alla sessione che li ha generati. A differenza di `CLAUDECODE`, questo è impostato solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione nidificata da un `claude` di primo livello avviato in un terminale integrato IDE. Una `claude` TUI interattiva nidificata avviata in questo modo è automaticamente esclusa da `--resume`, `--continue`, cronologia freccia su e l'elenco `claude agents`. Le sessioni non interattive `claude -p` persistono comunque. Impostare `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per ignorare questa esclusione. Richiede Claude Code v2.1.172 o successivo
`CLAUDE_CODE_CLIENT_CERT`	Percorso al file del certificato client per l'autenticazione mTLS
`CLAUDE_CODE_CLIENT_KEY`	Percorso al file della chiave privata client per l'autenticazione mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Passphrase per `CLAUDE_CODE_CLIENT_KEY` crittografato (facoltativo)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Rimosso nella v2.1.186 e ora un no-op. In precedenza impostava un timeout separato per la fase di connessione, TLS e intestazione di risposta di una richiesta API in streaming. Utilizzare `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase di intestazione di risposta di una richiesta in streaming, vedere `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Sostituire il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede l'abilitazione della modalità debug separatamente tramite `--debug`, `/debug` o la variabile di ambiente `DEBUG`: l'impostazione di questa variabile da sola non abilita la registrazione. Il flag `--debug-file` fa entrambi contemporaneamente. Impostazione predefinita: `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Impostare su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della linea di stato, o aumentare a `error` per ridurre il rumore
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Impostare su `1` per disabilitare il supporto della finestra di contesto 1M. Quando impostato, le varianti del modello 1M non sono disponibili nel selettore del modello, e Claude Code mantiene le sessioni su modelli con una finestra nativa 1M, come Sonnet 5 e i modelli Fable, a una finestra 200K; vedere Contesto esteso per come viene applicato il blocco. Utile per gli ambienti aziendali con requisiti di conformità. Per il suo ruolo nel correggere la finestra per un ID modello non riconosciuto `[1m]`, vedere Correggere la finestra per un ID modello gateway o personalizzato
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Impostare su `1` per disabilitare il ragionamento adattivo su Opus 4.6 e Sonnet 4.6 e tornare al budget di pensiero fisso controllato da `MAX_THINKING_TOKENS`. Non ha effetto sui modelli Fable, Sonnet 5, o Opus 4.7 e successivi, che utilizzano sempre il ragionamento adattivo
`CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION`	Impostare su `1` per impedire a Claude Code di unire i blocchi `env` delle impostazioni gestite per chiave tra le fonti di amministrazione, in modo che si applichi solo il blocco `env` della fonte con la priorità più alta, come prima della v2.1.223. Impostatelo nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia consegnata attraverso un blocco `env` delle impostazioni. Richiede Claude Code v2.1.223 o successivo
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Impostare su `1` per disabilitare 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`	Impostare su `1` per disattivare agenti in background e visualizzazione agente: `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all'impostazione `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Impostare su `1` per disabilitare il rendering a schermo intero e utilizzare il renderer della schermata principale classica. La conversazione rimane nella cronologia nativa del vostro terminale in modo che `Cmd+f` e la modalità di copia tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e l'impostazione `tui`. Potete anche passare con `/tui default`. Non si applica alle sessioni in background aperte da visualizzazione agente, che utilizzano sempre il rendering a schermo intero
`CLAUDE_CODE_DISABLE_ARTIFACT`	Impostare su `1` per disattivare lo strumento Artifact, che pubblica l'output della sessione come pagina web privata su claude.ai. Una volta impostato, nessun file di impostazioni riattiva lo strumento. Per disattivare lo strumento da un file di impostazioni, impostare `enableArtifact` su `false`; la chiave deprecata `disableArtifact` lo disattiva anche
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Impostare su `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Impostare su `1` per disabilitare la memoria automatica. Impostare su `0` per forzare la memoria automatica anche quando la modalità `--bare` o `autoMemoryEnabled: false` la disabiliterebbero altrimenti. Quando disabilitata, Claude non crea o carica i file di memoria automatica
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Impostare su `1` per disabilitare tutta la funzionalità di attività in background, incluso il parametro `run_in_background` sugli strumenti Bash e subagent, l'auto-backgrounding e la scorciatoia Ctrl+B
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT`	Impostare su `1` per impedire a Claude Code di trattare una risposta in streaming Amazon Bedrock con un'intestazione `Content-Type` mancante o vuota come flusso di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia eliminato l'intestazione da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostare questo solo per un gateway che anche ri-emette il flusso come server-sent events; Claude Code legge il corpo senza intestazione come server-sent events. Richiede Claude Code v2.1.239 o successivo
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Impostare su `1` per saltare il controllo che una risposta in streaming Amazon Bedrock trasporta il tipo di contenuto `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta trasporta un tipo di contenuto diverso, Claude Code fallisce la richiesta con un errore che nomina quel tipo, il che significa che un gateway o proxy sta trasformando la risposta. Configurare il gateway per inoltrare l'intestazione `Content-Type` e il corpo senza modifiche piuttosto che impostare questa variabile. Richiede Claude Code v2.1.208 o successivo
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	Impostare su `1` per impedire ai comandi shell in background in esecuzione di una sessione in background, flussi di lavoro dinamici, e, a partire dalla v2.1.198, subagent in background quando il supervisore arresta, riavvia o aggiorna il processo di quella sessione, invece di consegnarli al processo successivo della sessione. Influisce solo su quel passaggio: lo sfondo di una sessione con `←` o `/background` continua a trasportare il lavoro in volo, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successivo
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Impostare su `1` per impedire a Claude Code di terminare i comandi shell in background sotto pressione di memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione di memoria critica e la sessione è stata inattiva per 30 minuti senza turno o subagent in esecuzione. Windows non ha un segnale di pressione di memoria, quindi questa variabile non ha effetto lì. Richiede Claude Code v2.1.193 o successivo
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Impostare su `1` per disabilitare le skill e i flussi di lavoro inclusi con Claude Code: le skill e i flussi di lavoro raggruppati vengono rimossi completamente, mentre i comandi incorporati come `/init` rimangono digitabili ma nascosti dal modello. `/doctor` rimane digitabile come i comandi incorporati; nasconderlo con `DISABLE_DOCTOR_COMMAND`. Le skill dai plugin, `.claude/skills/` e `.claude/commands/` non sono interessate. Equivalente all'impostazione `disableBundledSkills`
`CLAUDE_CODE_DISABLE_CFC_PROMPT`	Impostare su `1` per mantenere disponibili gli strumenti del browser Claude in Chrome mentre si omette la sezione Chrome del prompt di sistema e la skill bundled `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono la loro guida del browser. Richiede Claude Code v2.1.257 o successivo
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Impostare su `1` per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di memoria utente, progetto e automatica
`CLAUDE_CODE_DISABLE_CRON`	Impostare su `1` per disabilitare i compiti programmati. La skill `/loop` e gli strumenti cron diventano non disponibili e qualsiasi compito già programmato smette di attivarsi, inclusi i compiti che sono già in esecuzione a metà sessione
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Impostare su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema dello strumento beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizzare quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. Ricerca strumenti MCP è disabilitata e tutti gli strumenti MCP si caricano in anticipo, anche quando impostate `ENABLE_TOOL_SEARCH`. Su Claude Code v2.1.227 o successivo, le impostazioni gestite possono mantenere la ricerca degli strumenti attiva. Disabilitare le capacità pre-release copre dove si applica l'override
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Impostare su `1` per disabilitare i subagent Explore e Plan incorporati. Claude esplora con i suoi strumenti di ricerca o il subagent di uso generale, e la modalità piano legge i file direttamente piuttosto che lanciare agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent incorporato in Agent SDK o modalità non interattiva, utilizzare `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successivo
`CLAUDE_CODE_DISABLE_FAST_MODE`	Impostare su `1` per disabilitare la modalità veloce
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Impostare su `1` per disabilitare i sondaggi sulla qualità della sessione "Come sta andando Claude?". I sondaggi sono anche disabilitati quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non aderisca di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizzare l'impostazione `feedbackSurveyRate`. Vedere Sondaggi sulla qualità della sessione
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Impostare su `1` per disabilitare il checkpointing dei file. Il comando `/rewind` non sarà in grado di ripristinare le modifiche al codice. Sostituisce l'impostazione `fileCheckpointingEnabled`
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Impostare su `1` per rimuovere le istruzioni di flusso di lavoro di commit e PR incorporate e lo snapshot dello stato git dal contesto di Claude. Utile quando si utilizzano le proprie skill di flusso di lavoro git. Ha la precedenza sull'impostazione `includeGitInstructions` quando impostato
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Impostare su `1` per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull'API Anthropic. Utilizzare quando desiderate intenzionalmente bloccare un modello più vecchio. Il remapping non viene eseguito su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry
`CLAUDE_CODE_DISABLE_MOUSE`	Impostare su `1` per disabilitare il tracciamento del mouse nel rendering a schermo intero. Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Utilizzare per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Impostare su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel rendering a schermo intero mantenendo lo scorrimento della rotella del mouse. Utilizzare quando desiderate che lo scorrimento della rotella funzioni all'interno di Claude Code ma non desiderate che i clic posizionino il cursore, espandano l'output dello strumento o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambi sono impostati. Richiede Claude Code v2.1.195 o successivo
`CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION`	Impostare su `1` per impedire a Claude Code di rileggere il certificato client mTLS e la chiave quando una richiesta API fallisce con un errore a livello di connessione, come un ripristino della connessione o un errore di handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo quando applica successivamente le impostazioni o al prossimo avvio. Richiede Claude Code v2.1.232 o successivo
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Impostare su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: auto-aggiornamenti, telemetria, segnalazione di errori, il comando `/feedback`, feedback redatto da Claude, note di rilascio, i controlli del badge di stato PR e MR, e i controlli di disponibilità come il controllo della modalità veloce. Interrompe anche le esecuzioni in background delle fonti di comando del plugin, che sono comandi locali piuttosto che traffico di rete, perché possono attivare installazioni di dipendenze. L'impostazione su `0` o `false` disabilita comunque questo traffico, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per consentirlo di nuovo. Disabilita anche il recupero dei flag di funzionalità, che rende Remote Control e le altre funzionalità che necessitano del recupero dei flag di funzionalità non disponibili. L'auto-installazione del marketplace ufficiale dei plugin non è coperta; disabilitarla con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sulla scoperta del modello gateway, che ha il suo opt-in
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Impostare su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà flusso. Gli errori di streaming si propagano al livello di ripetizione. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione dello strumento duplicata
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Impostare su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre state digitando nel terminale o siete focalizzati su di esso. Per impostazione predefinita lo strumento salta sia la notifica desktop che il push mobile quando rileva un'attività di tastiera recente o la messa a fuoco del terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere il push mobile quando rileva che siete attivi. Richiede Claude Code v2.1.193 o successivo
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Impostare su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo di una macchina. Se la variabile è impostata a quel punto, Claude Code salta la registrazione in modo permanente. L'annullamento dell'impostazione della variabile in seguito non annulla il salto. Eseguire `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento
`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`	Impostare su `1` per impedire a Claude Code di eseguire i vostri hook `Notification` per le richieste di autorizzazione senza risposta nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Impostare su `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per le sessioni di container o CI che non dovrebbero caricare le skill fornite dall'operatore
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Impostare su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta del modello piccolo/veloce in background che genera un titolo di sessione
`CLAUDE_CODE_DISABLE_THINKING`	Impostare su `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il pensiero esteso sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il pensiero su Opus 5.5 o sui modelli Fable, che non possono avere il pensiero disattivato. Su provider di terze parti, `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Impostare su `1` per saltare la auto-compattazione proattiva quando Claude Code non riconosce l'ID del modello, come un alias di gateway LLM. Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere Correggere la finestra per un ID modello gateway o personalizzato per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Impostare su `1` per disabilitare lo scorrimento virtuale nel rendering a schermo intero e eseguire il rendering di ogni messaggio nella trascrizione. Utilizzare se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero apparire i messaggi
`CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER`	Impostare su `1` per avviare i comandi dello strumento PowerShell su Windows direttamente invece che attraverso il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell in esecuzione in background di trasferirsi al processo successivo della sessione, ad esempio quando mettete in background la sessione. Se impostate la variabile, un comando PowerShell messo in background si arresta quando il processo della sessione esce. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successivo
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Impostare su `1` per disabilitare i flussi di lavoro. Equivalente all'impostazione `disableWorkflows`
`CLAUDE_CODE_EFFORT_LEVEL`	Impostare il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max`, o `auto` per utilizzare il predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e le impostazioni `modelSettings` e `effortLevel`. Un limite `maxEffortLevel` si applica comunque. Vedere Regolare il livello di sforzo
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Accettato per la compatibilità con le versioni precedenti e non ha effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessioni del gateway app Claude con accesso. Nella v2.1.158 attraverso v2.1.206, l'impostazione su `1` era necessaria per rendere la modalità auto disponibile su quei provider
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Sostituire la disponibilità del riepilogo della sessione. Impostare su `0` per forzare i riepiloghi disattivati indipendentemente dall'interruttore `/config`. Impostare su `1` per forzare i riepiloghi attivati quando `awaySummaryEnabled` è `false`. Ha la precedenza sull'impostazione e sull'interruttore `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Impostare su `1` per aggiornare lo stato del plugin ai confini dei turni in modalità non interattiva dopo il completamento di un'installazione in background. Disattivato per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, il che invalida la memorizzazione in cache del prompt per quel turno
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Impostare su `1` per instradare il sondaggio sulla qualità della sessione "Come sta andando Claude?" al vostro raccoglitore OpenTelemetry quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro raccoglitore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK` è impostato, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la politica di feedback del prodotto dell'organizzazione hanno la precedenza
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controlla se gli input delle chiamate di strumento vengono trasmessi dall'API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su Amazon Bedrock e Google Cloud's Agent Platform, abilitato per modello dove il contenitore distribuito lo supporta. Impostare su `0` per rinunciare. Impostare su `1` per forzare l'attivazione quando si instrada attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Microsoft Foundry e connessioni gateway
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Impostare su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del vostro gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivato per impostazione predefinita perché i gateway supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati da un'allowlist `availableModels` che la sessione riceve; consegnare l'elenco tramite MDM o un file di impostazioni gestite, poiché la consegna gestita dal server non è disponibile su configurazioni gateway
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Rimosso nella v2.1.142, quando il predefinito della modalità veloce si è spostato da Opus 4.6 a Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Impostare su `false` per disattivare i suggerimenti di prompt, le previsioni grigie che appaiono nel vostro input di prompt. Ha la precedenza sull'impostazione `promptSuggestionEnabled`, che è quello che l'interruttore Suggerimenti di prompt in `/config` scrive. Claude Code inoltre mette in pausa i suggerimenti mentre il vostro account è vicino o al limite di utilizzo. Impostare su `true` per mantenerli attivi fino a raggiungere il limite. Richiede Claude Code v2.1.238 o successivo. Vedere Suggerimenti di prompt
`CLAUDE_CODE_ENABLE_TASKS`	Seleziona quali strumenti di tracciamento delle attività Claude Code fornisce nelle sessioni che li hanno. Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Impostare su `0` per ottenere lo strumento legacy `TodoWrite`. Vedere Elenco attività
`CLAUDE_CODE_ENABLE_TELEMETRY`	Impostare su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e registrazione. Obbligatorio prima di configurare gli esportatori OTel. Vedere Monitoraggio
`CLAUDE_CODE_ENABLE_TODO_TOOLS`	Impostare su `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di esso, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in Disponibilità dello strumento Task. `CLAUDE_CODE_ENABLE_TASKS` seleziona comunque gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successivo
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tempo in millisecondi da aspettare dopo che il ciclo di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Impostare su `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 di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella vostra shell si applica anche alle sessioni in background che inviate con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e utilizzavano qualsiasi copia ereditata dal processo supervisore in background
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Sostituire il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Impostare su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione di `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione Claude Code. Utilizzare quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o un launcher in background avviato per la prima volta dallo strumento Bash di Claude Code, causa una sessione di primo livello genuina a essere classificata erroneamente come nidificata. A partire dalla v2.1.178, Claude Code rileva automaticamente il caso tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Anche onorato su v2.1.169 e precedenti; non ha effetto su v2.1.170 e v2.1.171, dove il rilevamento della sessione nidificata che sostituisce è stato rimosso
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Impostare su `1` per forzare il rendering del barrato per `~~text~~` nelle risposte di Claude quando il vostro terminale lo supporta ma non viene rilevato automaticamente, ad esempio su SSH senza `TERM_PROGRAM` inoltrato. Senza questo, i terminali non rilevati mostrano i marcatori letterali `~~` invece di eseguire il rendering del testo come barrato. Richiede Claude Code v2.1.186 o successivo
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	Impostare su `1` per forzare l'abilitazione della modalità privata DEC 2026 output sincronizzato quando il vostro terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al rendering a schermo intero, questo non cambia il renderer
`CLAUDE_CODE_FORK_SUBAGENT`	Controlla la modalità fork, che consente a Claude di generare subagent forkati da solo ed è attiva per impostazione predefinita solo nelle sessioni interattive. Impostare su `1` per attivarla anche in `claude -p` e Agent SDK, o `0` per disattivarla in ogni tipo di sessione. Potete eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. Il predefinito interattivo richiede Claude Code v2.1.232 o successivo; su versioni precedenti, impostare la variabile su `1` per attivare la modalità fork
`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`	Impostare su `1` per emettere blocchi di testo e pensiero del subagent nell'output `claude -p --output-format stream-json`, lo stesso comportamento del flag `--forward-subagent-text`. Utilizzare la variabile quando un harness invoca `claude` e non può passare il flag stesso. A differenza del flag, che esce con un errore al di fuori della modalità non interattiva con output stream-json, la variabile viene ignorata lì in modo che le invocazioni nidificate continuino a funzionare quando è impostata a livello di processo. Richiede Claude Code v2.1.211 o successivo
`CLAUDE_CODE_GATEWAY_HINT_HEADERS`	Impostare su `1` per inviare le intestazioni di suggerimento gateway, come `x-claude-code-request-class` e `x-claude-code-compaction`, su un proxy personalizzato o un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Impostare su `0` per smettere di inviarle su ogni connessione, inclusa una connessione diretta all'API Anthropic, dove Claude Code le invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successivo
`CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS`	Timeout in millisecondi per la richiesta di scoperta del modello gateway che `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` attiva (predefinito: `3000`). Aumentare quando il vostro gateway ha bisogno di più di tre secondi per rispondere a `/v1/models` all'avvio. Accetta solo cifre semplici; `0`, valori negativi e altre ortografie mantengono il predefinito. Richiede Claude Code v2.1.269 o successivo
`CLAUDE_CODE_GIT_BASH_PATH`	Solo Windows: percorso all'eseguibile Git Bash (`bash.exe`). Utilizzare quando Git Bash è installato ma non nel vostro PATH. Se il percorso non esiste o il file non è denominato `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e auto-rileva Git Bash come se fosse non impostato, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code usciva all'avvio quando il percorso non esisteva e utilizzava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Vedere Configurazione di Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Impostare su `false` per escludere i dotfile dai risultati quando Claude invoca lo strumento Glob. Incluso per impostazione predefinita. Non influisce su `@` autocomplete di file, `ls`, Grep o Read
`CLAUDE_CODE_GLOB_NO_IGNORE`	Impostare su `false` per fare in modo che lo strumento Glob rispetti i modelli `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su `@` autocomplete di file, che ha la sua impostazione `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Timeout in secondi per la scoperta dei file dello strumento Glob. Impostazione predefinita: 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL
`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`	Quanti minuti il lavoro in background può mantenere un obiettivo attivo in attesa prima che Claude Code chieda a Claude di controllarlo. Predefinito `30`. Impostare `0` per disattivare i check-in. Fornire minuti interi in cifre semplici, al massimo `10080`, che è una settimana. Claude Code tratta qualsiasi altro valore come non impostato e utilizza il predefinito. Richiede Claude Code v2.1.234 o successivo
`CLAUDE_CODE_HIDE_CWD`	Impostare su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni dove il percorso espone il vostro nome utente del sistema operativo
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Sostituire l'indirizzo host utilizzato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code auto-rileva l'indirizzo corretto, incluso l'instradamento WSL-to-Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Impostare su `1` per saltare l'auto-installazione delle estensioni IDE. Equivalente all'impostazione `autoInstallIdeExtension` su `false`
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Impostare su `1` per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizzare quando l'auto-connessione non riesce a trovare il vostro IDE nonostante sia in esecuzione
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	Quanti subagent possono essere in esecuzione in una sessione prima che lo strumento Agent rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altra cosa viene ignorata, quindi la variabile può regolare il limite ma non disabilitarlo. Richiede Claude Code v2.1.217 o successivo
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Sostituire la dimensione della finestra di contesto che Claude Code presume per il modello attivo. A partire dalla v2.1.193, come si applica dipende da come Claude Code risolve l'ID del modello; vedere Correggere la finestra per un ID modello gateway o personalizzato. Utilizzare quando si instrada a un modello attraverso `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione incorporata per il suo nome
`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`	Lunghezza massima in caratteri di ogni descrizione dello strumento MCP e delle istruzioni di ogni 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 altra cosa viene ignorato e si applica il predefinito. Richiede Claude Code v2.1.280 o successivo
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Impostare il numero massimo di token di output per la maggior parte delle richieste. I predefiniti e i limiti variano per modello; vedere token di output massimi. Claude Code impostazione predefinita a 32000 per gli ID modello che non riconosce, come i nomi specifici del gateway, e abbassa i valori superiori al limite di un modello al limite. L'aumento di questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la auto-compattazione
`CLAUDE_CODE_MAX_RETRIES`	Sostituire il numero di volte per riprovare le richieste API non riuscite (predefinito: 10). Limitato a 15 a partire dalla v2.1.186; a partire dalla v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il predefinito e rimuove il limite. Per le sessioni non presidiate che devono aspettare attraverso interruzioni più lunghe, impostare `CLAUDE_CODE_RETRY_WATCHDOG`
`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`	Rimosso nella v2.1.224 e ora un no-op. 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 concorrente e il limite di profondità si applicano comunque
`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	Numero di livelli di subagent consentiti sotto la conversazione principale (predefinito: 3). Al predefinito, i subagent possono generare i loro subagent e un subagent al terzo livello non può generare ulteriormente; impostare `1` per disattivare l'annidamento. Nella v2.1.217 attraverso v2.1.218, il predefinito era 1, quindi un subagent non poteva generare il suo a meno che non aumentaste il limite; v2.1.219 ha aumentato il predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altra cosa viene ignorata, quindi il limite può essere regolato ma non rimosso. Richiede Claude Code v2.1.217 o successivo
`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`	Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). I valori più alti aumentano il parallelismo ma consumano più risorse
`CLAUDE_CODE_MAX_TURNS`	Limitare il numero di turni agenti quando non viene passato un limite esplicito. Equivalente a passare `--max-turns`, che ha la precedenza quando entrambi sono impostati. Un valore che non è un numero intero positivo viene rifiutato all'avvio con un errore piuttosto che trattato come nessun limite
`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`	Limite sul numero totale di chiamate WebSearch che una sessione può effettuare (predefinito: 200). Quando Claude raggiunge il limite, le ulteriori chiamate WebSearch restituiscono un avviso che gli dice di continuare con le informazioni che ha già raccolto. Accetta un numero intero positivo senza limite superiore. Qualsiasi altra cosa viene ignorata e si applica il predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successivo
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Impostare su `1` per generare i server MCP stdio con solo un ambiente di base sicuro più il `env` configurato del server, invece di ereditare l'ambiente della vostra shell
`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`	Tempo trascorso in millisecondi prima che una chiamata di strumento MCP ancora in esecuzione si sposti a un'attività in background (predefinito: 120000, o 2 minuti). Impostare su `0` per disattivare l'auto-backgrounding. Richiede Claude Code v2.1.212 o successivo
`CLAUDE_CODE_MCP_STARTUP_WAIT_MS`	Quanto a lungo in millisecondi il primo turno di una sessione non interattiva aspetta i server MCP ancora in connessione, al posto dell'attesa del primo turno predefinita. Quando impostato, l'attesa copre ogni server in sospeso. Impostare su `0` per saltare l'attesa. Un server `--permission-prompt-tool` mantiene la sua propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successivo
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Timeout di inattività in millisecondi per le chiamate di strumenti MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o connettore claude.ai non invia risposta e nessuna notifica di progresso per questo lungo, la chiamata dello strumento si interrompe con un errore invece di aspettare il `MCP_TOOL_TIMEOUT` complessivo. Sostituisce i predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Impostare su `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono aumentati a un secondo e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 aumenta la finestra di inattività di quel server ad almeno il valore `timeout`. Non si applica ai server IDE o ai server in-process SDK. Richiede Claude Code v2.1.187 o successivo. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività
`CLAUDE_CODE_MESSAGING_SOCKET`	Impostato da Claude Code, non da voi: nelle sessioni che vincolano un socket della posta in arrivo, Claude Code esporta il percorso di quel socket ai hook e ai comandi Bash quando vincola il socket. In una sessione che inizia con la messaggistica attiva, Claude Code vincola il socket prima che qualsiasi hook venga eseguito. Altre sessioni sulla macchina consegnano i messaggi a questo percorso. Ogni sessione esporta il suo socket piuttosto che uno ereditato da un genitore, e i messaggi che arrivano su di esso passano attraverso i controlli in entrata della sessione. I blocchi `env` delle impostazioni non possono impostarlo. Richiede Claude Code v2.1.224 o successivo
`CLAUDE_CODE_MESSAGING_TOKEN`	Impostato da Claude Code, non da voi: nelle sessioni che vincolano un socket della posta in arrivo, Claude Code esporta questo token per sessione ai hook e ai comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che invia al socket può inviare `{"type":"auth","token":"<token>"}` come sua prima riga per provare che appartiene alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non si apre con una valida. Le regole dei propri figli dicono quando Claude Code consulta il token. Ogni sessione esporta il suo token, mai uno ereditato da una sessione genitore. I blocchi `env` delle impostazioni non possono impostarlo. Richiede Claude Code v2.1.228 o successivo
`CLAUDE_CODE_NATIVE_CURSOR`	Impostare su `1` per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e messa a fuoco del terminale
`CLAUDE_CODE_NEW_INIT`	Impostare su `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare la base di codice e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere
`CLAUDE_CODE_NONBLOCKING_STDOUT`	Impostare su `1` per scrivere l'output del terminale attraverso un secondo descrittore di file non bloccante, in modo che un terminale che smette di leggere, come un riquadro di controllo tmux in pausa o una connessione SSH bloccata, non possa congelare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successivo
`CLAUDE_CODE_NO_FLICKER`	Impostare su `1` per abilitare il rendering a schermo intero, un'anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Sostituisce l'impostazione `tui`; potete anche passare con `/tui fullscreen`
`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`	Token di aggiornamento OAuth per l'autenticazione Claude.ai. Quando impostato, `claude auth login` scambia questo token direttamente invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell'autenticazione in ambienti automatizzati
`CLAUDE_CODE_OAUTH_SCOPES`	Ambiti OAuth separati da spazi con cui il token di aggiornamento è stato emesso, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatorio quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostato
`CLAUDE_CODE_OAUTH_TOKEN`	Token di accesso OAuth per l'autenticazione claude.ai. Alternativa a `/login` per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali archiviate nel portachiavi. Generarne uno con `claude setup-token`. A meno che non eseguiate `/login`, Claude Code utilizza il token che impostate per l'intera sessione. Per sostituire un token scaduto, generarne uno nuovo e riavviate
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Rimosso nella v2.1.160 e ora un no-op. In precedenza bloccava la modalità veloce a Claude Opus 4.6 invece del predefinito corrente. Opus 4.6 non supporta più la modalità veloce
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Lunghezza massima degli attributi OpenTelemetry che trasportano contenuto (risposte del modello, contenuto dello strumento, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, cioè 60 KB). Aumentare solo se il vostro backend di telemetria accetta valori di attributo più grandi di 64 KB, o abbassare per ridurre il volume di telemetria. Richiede Claude Code v2.1.214 o successivo. Vedere Monitoraggio
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Impostare su `1` per scrivere gli errori diagnostici dell'esportatore OpenTelemetry su stderr. Per impostazione predefinita questi errori appaiono solo con `--debug`, quindi un esportatore non configurato correttamente come una collisione di porta Prometheus altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successivo. Vedere Monitoraggio
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Timeout in millisecondi per lo scaricamento degli span OpenTelemetry in sospeso (predefinito: 5000). Vedere Monitoraggio
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervallo per l'aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedere Intestazioni dinamiche
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Timeout in millisecondi affinché l'esportatore OpenTelemetry finisca all'arresto (predefinito: 2000). Aumentare se le metriche vengono eliminate all'uscita. Vedere Monitoraggio
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Impostare su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando è disponibile una nuova versione. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedere Auto-aggiornamenti
`CLAUDE_CODE_PERFORCE_MODE`	Impostare su `1` per abilitare la protezione da scrittura consapevole di Perforce. Quando impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca il bit di proprietario-scrittura, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Sostituire la directory radice dei plugin. Nonostante il nome, questo imposta la directory genitore, non la cache stessa: i marketplace e la cache dei plugin vivono in sottodirectory sotto questo percorso. Impostazione predefinita: `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_DIRS`	Directory dei plugin da caricare per la sessione, ognuna caricata nel modo in cui un flag `--plugin-dir` la carica. Separare più percorsi con `:` su Unix o `;` su Windows. Fornire ogni percorso come percorso assoluto o iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successivo
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumentare questo valore per repository grandi o connessioni di rete lente. Vedere Le operazioni Git scadono
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Impostare su `1` per saltare il tentativo di re-clone e continuare a utilizzare il checkout del marketplace esistente quando un aggiornamento del marketplace non riesce a raggiungere o autenticarsi al remoto. Utile negli ambienti offline o airgapped dove il re-cloning fallirebbe allo stesso modo. Vedere Gli aggiornamenti del marketplace falliscono negli ambienti offline
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Impostare su `1` per clonare le fonti di scorciatoia GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com`
`CLAUDE_CODE_PLUGIN_SEED_DIR`	Percorso a una o più directory di seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizzare per raggruppare una directory di plugin pre-popolata in un'immagine di container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati in cache senza re-clonare. Vedere Pre-popolare i plugin per i container
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Impostare su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumenti, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite-Restricted. Il bypass a livello di processo non sostituisce mai la `MachinePolicy` o la `UserPolicy` di Group Policy indipendentemente da questa impostazione
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Limite in millisecondi sull'attesa inattiva per i subagent in background e i flussi di lavoro dopo il turno finale in modalità non interattiva con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude prende un turno per gestire un risultato in background. Predefinito: `600000`, o 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di aspettare i compiti in background rimanenti e esce. Impostare su `0` per aspettare indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica alle shell in background semplici. Richiede Claude Code v2.1.182 o successivo
`CLAUDE_CODE_PROCESS_WRAPPER`	Avviare i processi che Claude Code avvia dal suo binario, come il servizio in background che ospita le sessioni di visualizzazione agente, attraverso un launcher aziendale fornito come prefisso argv come `/opt/corp/launcher`. Impostatelo nel blocco `env` delle impostazioni utente o gestite, non come esportazione di shell, in modo che il servizio in background staccato lo erediti; le impostazioni di progetto e locali non possono impostarlo. Equivalente all'impostazione `processWrapper`, che richiede Claude Code v2.1.210 o successivo; questa variabile ha la precedenza quando entrambi sono impostati. L'estensione VS Code configura il suo launcher separatamente attraverso la sua impostazione `claudeProcessWrapper`. Ignorato su Windows. Vedere Eseguire Claude Code dietro un launcher aziendale per il formato del valore, cosa copre il launcher e il contratto che il launcher deve soddisfare. Richiede Claude Code v2.1.208 o successivo
`CLAUDE_CODE_PROJECT_DIR_NAME`	Impostare insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory `projects/` in cui Claude Code memorizza le trascrizioni e la memoria automatica di quella sessione, al posto di uno derivato dal percorso della directory di lavoro. Ad esempio, avviare Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` le memorizza sotto `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostato e la legge solo dall'ambiente da cui avviate `claude`, mai da un blocco `env` del file di impostazioni. Vedere Denominare la directory del progetto voi stessi. Richiede Claude Code v2.1.234 o successivo
`CLAUDE_CODE_PROMPT_CACHE_TTL`	Impostare `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il TTL della cache del prompt per la conversazione principale: i vostri turni interattivi, `-p` e SDK, più gli helper che vengono eseguiti in linea con essi. Ha la precedenza sull'impostazione `promptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` la sostituisce. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Richiede Claude Code v2.1.242 o successivo
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Impostare su `1` per propagare il contesto di traccia W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'intestazione `traceparent` sulle richieste del modello e MCP HTTP e la variabile di ambiente `TRACEPARENT` per i sottoprocessi Bash, PowerShell e hook. Per impostazione predefinita, la propagazione è abilitata solo quando connessi direttamente all'API Anthropic. Aggiunto nella v2.1.152. Vedere Tracce (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Impostato da piattaforme host che incorporano Claude Code e gestiscono l'instradamento del provider di modelli per suo conto. Quando impostato, Claude Code ignora le variabili di selezione del provider, endpoint e autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni, in modo che le impostazioni utente non possono ignorare l'instradamento dell'host. Claude Code ignora anche le chiavi di selezione del modello come `model`, `fallbackModel` e `modelOverrides` nelle impostazioni gestite, qualunque fonte gestita le consegni, in modo che la configurazione del modello dell'host ha la precedenza su un pin del modello gestito non aggiornato. Claude Code ignora anche le variabili di selezione del modello come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL` in un blocco `env` gestito; un'allowlist `availableModels` nelle impostazioni gestite si applica comunque a meno che l'host non fornisca la sua. Claude Code salta anche l'opt-out di telemetria automatica che altrimenti applica su provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, in modo che la telemetria segua l'opt-out standard `DISABLE_TELEMETRY`. Vedere Comportamenti predefiniti per provider API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Impostare su `1` per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per gli ambienti in cui il proxy dovrebbe gestire la risoluzione del nome host
`CLAUDE_CODE_REMOTE`	Impostato automaticamente su `true` quando Claude Code è in esecuzione come una sessione cloud. Leggere questo da un hook o script di configurazione per rilevare se siete in una sessione cloud
`CLAUDE_CODE_REMOTE_SESSION_ID`	Impostato automaticamente nelle sessioni cloud all'ID della sessione corrente. Leggere questo per costruire un link di ritorno alla trascrizione della sessione. Vedere Collegare l'output di nuovo alla sessione
`CLAUDE_CODE_RESTRICTED`	Impostare su `1` per avviare la sessione in modalità ristretta, lo stesso che passare `--restricted`. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.248 o successivo
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Impostare su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di inviare di nuovo il prompt. Per disattivare questo, annullare l'impostazione della variabile o impostarla su `0`. Prima della v2.1.221, Claude Code ignorava `0` e altri valori falsy, quindi l'impostazione di `0` attivava comunque la ripresa in modalità non interattiva e l'annullamento dell'impostazione della variabile era l'unico modo per disattivarla
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS`	Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione che è terminata a metà turno continui automaticamente al ripristino. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta sia la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` che il messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT` iniettato, e la sessione inizia inattiva in modo che continuiate esplicitamente. Non impostato o `0` significa nessun limite, tranne che un turno la cui ultima richiesta ha fallito con un errore API riprende solo mentre quell'errore è inferiore a sei ore. Un valore positivo limita ogni turno, inclusi quelli; un valore negativo o non numerico applica un limite di un'ora. Gli script di generazione per agenti a lunga esecuzione possono impostare questo in modo che un riavvio rispetto a una trascrizione vecchia non ri-esegua un prompt stantio. Claude Code imposta un limite di un'ora da solo quando riavvia una sessione di visualizzazione agente bloccata che ha ereditato la sua conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successivo
`CLAUDE_CODE_RESUME_PROMPT`	Sostituire il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Impostazione predefinita: `Continue from where you left off.`. Gli script di generazione per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il predefinito
`CLAUDE_CODE_RETRY_WATCHDOG`	Impostare su `1` per le sessioni non presidiate come harness di valutazione, lavori CI o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429`che segnala un limite di spesa o crediti di utilizzo esauriti, anche uno da un limite di spesa gateway che si ripristina su un programma. Prima della v2.1.239, il watchdog ritentava questi indefinitamente. Per le richieste in modalità veloce, vedere Gestire i limiti di velocità. Il watchdog fa un backup fino a 5 minuti tra i tentativi, o fino al ripristino del limite quando la risposta trasporta un tempo di ripristino del limite di velocità, quindi una sessione che colpisce un limite di utilizzo aspetta la finestra rimanente. Su v2.1.199 o successivo aumenta anche il conteggio di ripetizione predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backup, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se impostate esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successivo
`CLAUDE_CODE_SAFE_MODE`	Impostare su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e suggerimento di file, server LSP e memoria automatica non si caricano, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la linea di stato e i comandi di suggerimento di file; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla politica non si caricano. Equivalente a passare `--safe-mode`. I processi figlio generati direttamente ereditano la variabile
`CLAUDE_CODE_SCRIPT_CAPS`	Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di conteggio di interi. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe in modo che i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contino comunque contro il limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità
`CLAUDE_CODE_SCROLL_SPEED`	Impostare il moltiplicatore di scorrimento della rotella 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 del trackpad e della rotella accelerato nei terminali che già amplificano gli eventi della rotella. Impostare su `3` per corrispondere a `vim` se il vostro terminale invia un evento della rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza la sua gestione dello scorrimento
`CLAUDE_CODE_SEND_FEEDBACK`	Impostare su `0` per disattivare il feedback redatto da Claude per una sessione. Impostare su `1` per attivarlo dove il vostro account ha già accesso; la variabile non può concedere l'accesso da sola, e gli altri interruttori che disattivano il feedback, come `DISABLE_FEEDBACK_COMMAND` e il valore `off` dell'impostazione `feedbackDrafts`, si applicano comunque
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Sostituire il budget di tempo in millisecondi per gli hook SessionEnd. Il valore è anche il timeout per ogni hook che non imposta il suo `timeout`. Si applica all'uscita della sessione, `/clear` e al passaggio delle sessioni tramite `/resume` interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget
`CLAUDE_CODE_SESSION_ID`	Impostato automaticamente all'ID della sessione corrente nei sottoprocessi dello strumento Bash e PowerShell, nei sottoprocessi del comando hook e nei sottoprocessi server MCP stdio. Per Bash, PowerShell e hook questo corrisponde al campo `session_id` nell'input JSON dell'hook e viene aggiornato su `/clear`. Un sottoprocesso del server MCP mantiene l'ID con cui è stato generato. Su `--resume <session-id>` riceve l'ID ripreso, corrispondente agli hook e Bash. Su `--continue` o `--resume` senza un ID esplicito potrebbe ricevere l'ID di avvio iniziale. Utilizzare per correlare gli script e gli strumenti esterni con la sessione Claude Code che li ha avviati
`CLAUDE_CODE_SHELL`	Impostare la shell che Claude Code utilizza per eseguire i comandi dello strumento Bash. Accetta un percorso a un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e torna all'auto-rilevamento. L'auto-rilevamento utilizza il vostro `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` funzionante quindi `bash` trovato sul vostro `PATH` e nelle posizioni di installazione standard
`CLAUDE_CODE_SHELL_PREFIX`	Prefisso di comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi hook, comandi linea di stato e comandi di avvio server MCP stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per la registrazione o il controllo. L'impostazione di un percorso eseguibile nudo come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come un singolo argomento con shell-quoted in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un percorso eseguibile nudo interrompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate dello strumento Bash, `$1` contiene l'invocazione della shell completa che Claude Code assembla, inclusa la configurazione dell'ambiente, non solo il comando che Claude ha eseguito
`CLAUDE_CODE_SIMPLE`	Impostare su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura di file e modifica di file. Gli strumenti MCP da `--mcp-config` sono comunque disponibili. Disabilita l'auto-scoperta di hook, skill, comandi personalizzati, subagent, plugin, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory che passate con `--add-dir` si caricano comunque. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l'autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivalente a passare `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Impostare su `1` per utilizzare un prompt di sistema più breve e descrizioni di strumenti abbreviate su qualsiasi modello. Impostare su `0`, `false`, `no` o `off` per rinunciare anche sui modelli in cui l'esperimento o la configurazione del server lo abiliterebbero altrimenti. L'insieme completo di strumenti, gli hook, i server MCP e la scoperta di CLAUDE.md rimangono abilitati
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Saltare l'autenticazione lato client per Claude Platform on AWS, per i gateway che firmano le richieste da soli
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	Impostare su `1` per disattivare la cache in-process delle credenziali risolte dalla catena del provider di credenziali predefinito AWS, in modo che Claude Code risolva la catena su ogni richiesta API. Con la cache disattivata, un profilo supportato da SSO richiede credenziali da IAM Identity Center su ogni richiesta. Vedere memorizzazione in cache delle credenziali e timeout di risoluzione. Richiede Claude Code v2.1.207 o successivo
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Saltare l'autenticazione AWS per Amazon Bedrock (ad esempio, quando si utilizza un gateway LLM)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	Impostare su `1` per trattare un controllo di disponibilità della modalità veloce non riuscito come disponibile, per le reti che bloccano la richiesta diretta del controllo a `api.anthropic.com`. Claude Code onora comunque una risposta "disabilitato dalla vostra organizzazione"
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	Impostare su `1` per saltare il controllo di disponibilità della modalità veloce lato client, per i proxy che intercettano la richiesta del controllo piuttosto che rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la vostra organizzazione ha la modalità veloce disabilitata
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Saltare l'autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inietta la sua intestazione `Authorization`. Claude Code invia richieste senza una credenziale Azure e preserva l'intestazione `Authorization` che fornite, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorato quando `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN` è impostato. Prima della v2.1.203, questa variabile lasciava il client Microsoft Foundry incapace di inviare richieste a meno che una chiave API non fosse anche impostata
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Saltare l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM)
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	Impostare su `1` per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in `--resume`, `--continue` o nella cronologia della freccia su. Utile per le sessioni di script effimere
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Saltare l'autenticazione Google per Google Cloud's Agent Platform (ad esempio, quando si utilizza un gateway LLM)
`CLAUDE_CODE_STARTUP_FAILURE_RESULTS`	Impostare su `1` per fare in modo che una sessione avviata con `--output-format stream-json` scriva un messaggio di risultato che nomina il motivo per cui Claude Code ha rifiutato di avviare per i fallimenti di avvio che altrimenti terminano solo con stderr. Richiede Claude Code v2.1.274 o successivo
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Numero massimo di volte consecutive che un hook Stop o SubagentStop può bloccare la fine del turno prima che Claude Code lo ignori e termini il turno comunque (predefinito: 8). Impostare su `0` per disabilitare il limite. Aumentare se il vostro hook ha legittimamente bisogno di più iterazioni per risolvere
`CLAUDE_CODE_SUBAGENT_MODEL`	Il modello predefinito per i subagent, i compagni di team di agenti e gli agenti di flusso di lavoro che non sono assegnati a un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Due fonti hanno la precedenza su di esso: un modello che Claude passa quando genera l'agente e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare quello, impostare `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`. Vedere Scegliere un modello per l'ordine completo. L'impostazione su `inherit` è la stessa che lasciarla non impostata. Prima della v2.1.251, questa variabile sostituiva sia il modello per invocazione che il campo `model` della definizione
`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`	Impostare su `1` per forzare un modello sui subagent, i compagni e gli agenti del flusso di lavoro. Eseguire ogni subagent su un modello dice quale modello è. Richiede Claude Code v2.1.257 o successivo
`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`	Impostare `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il TTL della cache del prompt per le richieste al di fuori della conversazione principale, come subagent, flussi di lavoro e lavoro in background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` la sostituisce. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Richiede Claude Code v2.1.242 o successivo
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Impostare su `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio): credenziali Anthropic e provider cloud, qualsiasi altra variabile che Claude Code riconosce come credenziale e credenziali incorporate negli URL del registro dei pacchetti. Il processo Claude genitore mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l'esposizione agli attacchi di iniezione di prompt che tentano di esfiltare i segreti tramite l'espansione della shell. Su v2.1.251 o successivo, lo scrub rimuove anche le variabili del puntatore dell'archivio di configurazione di Claude Code (come `CLAUDE_CONFIG_DIR`), in modo che un processo figlio non possa individuare una directory di configurazione rilocata. Lasciare lo scrub non impostato se un sottoprocesso ha bisogno di queste variabili. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi PID isolato in modo che non possano leggere gli ambienti dei processi host tramite `/proc`; come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere o segnalare i processi host. `claude-code-action` imposta questo automaticamente quando `allowed_non_write_users` è configurato
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Impostare su `1` in modalità non interattiva (il flag `-p`) per aspettare il completamento dell'installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combinare con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`	Timeout in millisecondi per l'installazione sincrona del plugin. Quando superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l'installazione sincrona aspetta fino al completamento
`CLAUDE_CODE_SYNC_SKILLS`	Impostare su `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi le skill abilitate per il vostro account claude.ai in quella esecuzione e aspetti l'elenco di esse, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. Gli scaricamenti stessi finiscono in background e Claude aspetta il download di una skill quando la invoca. Richiede l'autenticazione claude.ai. Le sessioni di terminale in cui accedete con il vostro account claude.ai scaricano queste skill in `~/.claude/skills/synced/` e risincronizzano circa ogni 10 minuti senza questa variabile, quindi impostatela solo quando un'esecuzione `-p` ha bisogno delle vostre skill attuali al primo turno. Prima della v2.1.273, le sessioni di terminale le scaricavano solo in un'esecuzione `-p` con questa variabile impostata. Il nome della cartella `synced` è riservato per questo download. Prima della v2.1.227, le skill scaricate in `~/.claude/skills/` direttamente. Claude Code applica regole extra alle skill scaricate, come non eseguire i loro comandi `!` sulla vostra macchina
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Timeout in millisecondi per la risincronizzazione delle skill che viene eseguita a metà sessione quando un'app costruita su Agent SDK ricarica le skill (predefinito: 30000). Quando superato, il ricaricamento continua con qualunque skill sia arrivata e i download rimanenti finiscono in background
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Timeout in millisecondi affinché la prima query aspetti l'elenco di skill iniziale quando `CLAUDE_CODE_SYNC_SKILLS` è impostato (predefinito: 5000). Quando superato, la prima query viene eseguita con qualunque skill sia arrivata. I download finiscono in background in entrambi i casi e Claude aspetta il download di una skill quando la invoca
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Impostare su `false` per disabilitare l'evidenziazione della sintassi nell'output diff. Utile quando i colori interferiscono con la configurazione del vostro terminale. Per disabilitare anche l'evidenziazione nei blocchi di codice e nelle anteprime di file, utilizzare l'impostazione `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Condividere un elenco di attività tra le sessioni. Impostare lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso, nelle sessioni che hanno gli strumenti Task. Vedere Elenco attività
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Sostituire, in millisecondi, quanto a lungo una sessione non interattiva aspetta all'uscita affinché il suo team di agenti finisca di smontarsi. Accetta da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il predefinito di 10000. Richiede Claude Code v2.1.206 o successivo
`CLAUDE_CODE_TMPDIR`	Sostituire la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` su Unix o `/claude/` su Windows a questo percorso. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash sandboxed ricevono un fallback `$TMPDIR` breve sotto il predefinito del sistema quando il vostro override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non sandboxed ereditano il vostro `$TMPDIR` della shell quando è impostato. I file temporanei di Claude Code utilizzano sempre il vostro override. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle impostazioni di progetto e locali
`CLAUDE_CODE_TMUX_TRUECOLOR`	Impostare su qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. L'impostazione su `0` o `false` consente comunque il truecolor, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per ripristinare il blocco a 256 colori. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato. Impostare questo dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al vostro `~/.tmux.conf`. Vedere Configurazione del terminale per altre impostazioni tmux
`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`	Su Linux e WSL, impostare su un elenco separato da virgole dei tipi di processi che Claude Code esclude dal limite di memoria dello strumento, come `mcp` o `lsp`. Impostare `none` per limitare ogni tipo, o `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene i comandi degli strumenti Bash, PowerShell e Monitor sotto il limite qualunque cosa elenchiate. Richiede Claude Code v2.1.246 o successivo
`CLAUDE_CODE_TOOL_MEMORY_LIMIT`	Su Linux e WSL, impostare su una dimensione come `4G` per limitare la memoria che i comandi degli strumenti Bash e PowerShell possono utilizzare, e i comandi dello strumento Monitor su v2.1.246 o successivo. Scrivere la dimensione in cifre semplici, sole per un numero di byte o con un suffisso `K`, `M`, `G` o `T`. Impostare `0` o `off` per disattivare il limite. Una volta che il primo processo che Claude Code avvia ha attivato o disattivato il limite, un valore modificato ha effetto la prossima volta che avviate `claude`. Richiede Claude Code v2.1.233 o successivo
`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`	Scadenza in millisecondi prima che Claude Code annulli una finestra di dialogo che inoltra a un client remoto come un Remote Control o host SDK, o la finestra di dialogo di approvazione per un messaggio tra sessioni in sospeso; i prompt di autorizzazione e le domande `AskUserQuestion` utilizzano i loro flussi e non sono governati da esso. Su Claude Code v2.1.236 o successivo, limita anche il prompt di consenso dei crediti di utilizzo Fable a metà sessione in una sessione che potrebbe essere in esecuzione senza supervisione. Controllare i messaggi in entrata e sessioni non interattive coprono le regole di scadenza del messaggio in sospeso completo, inclusi i casi in cui la scadenza non si applica. Sostituisce l'impostazione `dialogExpiry`. `0` o un valore negativo disabilita la scadenza
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Utilizzare Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Utilizzare Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Utilizzare Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Utilizzare l'endpoint Mantle di Amazon Bedrock
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	Impostare su `1` per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Impostare questo se il binario ripgrep raggruppato non è disponibile o bloccato nel vostro ambiente. Non influisce sugli strumenti Grep o ricerca di file
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; impostare su `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; impostare su `1` per abilitarlo nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, o `0` per disattivarlo. Su Linux, macOS e WSL, impostare su `1` per abilitarlo, che richiede `pwsh` sul vostro `PATH`. Quando abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedere Strumento PowerShell
`CLAUDE_CODE_USE_VERTEX`	Utilizzare Google Cloud's Agent Platform
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	Impostare al numero di millisecondi che WebFetch mantiene la risposta di ogni URL recuperato memorizzata in cache. Il predefinito è `900000`, che è 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra ortografia mantiene il predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica quando avviate successivamente `claude`. Richiede Claude Code v2.1.233 o successivo
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	Limite superiore in millisecondi su quanto a lungo WebFetch aspetta il download di una pagina, inclusi i reindirizzamenti che segue. Un download che non è stato completato entro allora fallisce con un errore di scadenza. Il predefinito è `300000`, che è cinque minuti. Impostare su `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra ortografia mantiene il predefinito. Richiede Claude Code v2.1.268 o successivo
`CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS`	Quanti agenti un'esecuzione di flusso di lavoro singolo esegue contemporaneamente, da `1` a `256`. Per impostazione predefinita, un'esecuzione esegue fino a 16 agenti contemporaneamente, meno quando Claude Code ha meno CPU disponibili; le chiamate `agent()` in coda aspettano uno slot libero. La trascrizione di ogni agente in esecuzione rimane nella memoria di Claude Code, quindi i valori più alti aumentano l'utilizzo della memoria. Accetta solo cifre semplici; i valori fuori intervallo e altre ortografie mantengono il predefinito. Richiede Claude Code v2.1.269 o successivo
`CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS`	Limite superiore in millisecondi su quanto a lungo un agente di flusso di lavoro aspetta la prima risposta di un fratello con lo stesso prefisso prima di inviare la sua prima richiesta. Quando un fan-out avvia diversi agenti che condividono un prefisso della cache del prompt, Claude Code mantiene tutti tranne il primo agente per fino a questo lungo in modo che il resto legga il prefisso memorizzato in cache invece di elaborarlo senza cache. Predefinito `5000`. Impostare su `0` per disabilitare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostato, gli agenti non aspettano mai. Richiede Claude Code v2.1.229 o successivo
`CLAUDE_CONFIG_DIR`	Sostituire la directory di configurazione (predefinito: `~/.claude`). Tutte le impostazioni, la cronologia della sessione e i plugin vengono memorizzati sotto questo percorso. Per le credenziali, vedere dove Claude Code memorizza le credenziali. Utile per eseguire più account fianco a fianco: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle impostazioni di progetto e locali
`CLAUDE_DISABLE_ADOPT`	Impostare su `1` per impedire il trasferimento del lavoro in background in volo quando mettete in background una sessione premendo `←` o con `/background`. Claude Code vi chiede di confermare prima di mettere in background, quindi arresta i compiti che altrimenti si trasferirebbero. Richiede Claude Code v2.1.195 o successivo
`CLAUDE_EFFORT`	Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al livello di sforzo in vigore quando il sottoprocesso inizia: `low`, `medium`, `high`, `xhigh` o `max`. Ultracode non è un livello distinto e segnala come `xhigh`. Corrisponde al campo `effort.level` passato agli hook. Impostato solo quando il modello corrente supporta il parametro effort
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Impostare su `1` per forzare l'abilitazione del watchdog di inattività di flusso a livello di byte, o impostare su `0` per forzare la disabilitazione. `0` disattiva anche la scadenza del primo byte sulle connessioni in cui viene eseguita quella scadenza. Quando non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic dirette e Claude Platform on AWS, e per le risposte in streaming su connessioni gateway raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non veniva eseguito su quelle connessioni gateway, quindi il watchdog a livello di evento potrebbe segnalare uno stallo lì anche mentre i ping keep-alive stavano arrivando. Per i timeout e come i timer interagiscono, vedere Watchdog di inattività di flusso
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Impostare su `1` per abilitare il watchdog di inattività di flusso a livello di byte sulle risposte Amazon Bedrock `vnd.amazon.eventstream`, che abilita anche la scadenza del primo byte sulle richieste di streaming Bedrock. Disattivato per impostazione predefinita. Configurare il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Impostare su `0` per forzare la disabilitazione del watchdog di inattività di flusso a livello di evento, o impostare su `1` per forzare l'abilitazione. Quando non impostato, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il predefinito non impostato era controllato dal server sull'API Anthropic diretta e disattivato su altri provider. Configurare il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che vengono eseguiti insieme a questo, vedere Watchdog di inattività di flusso
`CLAUDE_ENV_FILE`	Percorso a uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizzare per persistere l'attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente da hook SessionStart, Setup, CwdChanged e FileChanged
`CLAUDE_JOB_DIR`	Impostato da Claude Code in ogni sessione in background alla directory `~/.claude/jobs/<id>` di quella sessione. I comandi shell che la sessione esegue lo ereditano. Scrivere i file di scratch a `$CLAUDE_JOB_DIR/tmp`. Le chiamate `Write` e `Edit` di Claude lì non richiedono l'autorizzazione e la directory viene rimossa quando la sessione viene eliminata
`CLAUDE_PID`	Claude Code imposta questo al suo ID di processo nei sottoprocessi che genera: comandi dello strumento Bash e PowerShell e comandi hook. Su Linux, l'integrazione della shell dello strumento Bash lo utilizza per rifiutare un modello `pkill` che corrisponderebbe al processo Claude Code stesso; vedere il riferimento degli errori. Leggerlo dai vostri script per identificare o segnalare deliberatamente il processo Claude Code genitore. Richiede Claude Code v2.1.214 o successivo
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefisso per i nomi di sessione Remote Control generati automaticamente quando non viene fornito un nome esplicito. Impostazione predefinita: il nome host della vostra macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione
`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`	Scadenza in millisecondi per il primo byte di risposta di una richiesta in streaming, sulle connessioni in cui viene eseguita la scadenza del primo byte. Per come Claude Code la limita, il tempo extra che aggiunge per i corpi di richiesta grandi e come sceglie la scadenza quando la lasciate non impostata, vedere Nessuna risposta dall'API. Richiede Claude Code v2.1.242 o successivo
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Timeout in millisecondi prima che i watchdog di inattività di flusso a livello di evento e byte chiudano una connessione bloccata. Quando impostate questa variabile esplicitamente, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente limitati per assorbire le pause di pensiero esteso e il buffering del proxy, e il watchdog a livello di byte limita il valore a 30 minuti. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` ha la precedenza su questa variabile per il watchdog a livello di byte. Per i predefiniti non impostati per watchdog, vedere Watchdog di inattività di flusso
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	Rimosso nella v2.1.260 e ora un no-op. In precedenza limitava quanto a lungo un comando shell in background che un subagent ha avviato poteva eseguire, in millisecondi, con un predefinito di 60 minuti. Vedere le regole della durata del comando in background
`DEBUG`	Impostare su `1` per abilitare la modalità debug, equivalente all'avvio con `--debug`. I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, o nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori truthy `1`, `true`, `yes` e `on` abilitano la modalità debug, quindi i modelli di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano
`DISABLE_AUTOUPDATER`	Impostare su `1` per disabilitare gli aggiornamenti automatici in background. Il manuale `claude update` continua a funzionare. Utilizzare `DISABLE_UPDATES` per bloccare entrambi
`DISABLE_AUTO_COMPACT`	Impostare su `1` per disabilitare la compattazione automatica quando ci si avvicina al limite di contesto. Il comando manuale `/compact` rimane disponibile. Utilizzare quando desiderate il controllo esplicito su quando si verifica la compattazione. Sostituisce l'impostazione `autoCompactEnabled`
`DISABLE_COMPACT`	Impostare su `1` per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale `/compact`
`DISABLE_COST_WARNINGS`	Impostare su `1` per disabilitare i messaggi di avviso sui costi
`DISABLE_DOCTOR_COMMAND`	Impostare su `1` per nascondere la skill `/doctor` di controllo della configurazione e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire i diagnostici di configurazione da una sessione. Non influisce sul comando del terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva la schermata dei diagnostici `/doctor`
`DISABLE_ERROR_REPORTING`	Impostare su qualsiasi valore non vuoto, come `1`, per rinunciare alla segnalazione degli errori. L'impostazione su `0` o `false` rinuncia comunque, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la segnalazione degli errori
`DISABLE_EXTRA_USAGE_COMMAND`	Impostare su `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità
`DISABLE_FEEDBACK_COMMAND`	Impostare su `1` per disabilitare il comando `/feedback` e il feedback redatto da Claude. Disabilita anche `/bug` e `/share`, che segnalano attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando era disabilitato con ogni nome. Il nome più vecchio `DISABLE_BUG_COMMAND` è anche accettato
`DISABLE_GROWTHBOOK`	Impostare su `1` o `true` per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i predefiniti del codice per ogni flag. Questo rende Remote Control e le altre funzionalità che necessitano del recupero dei flag di funzionalità non disponibili. L'impostazione su `0` o `false` lascia il recupero attivo. La registrazione degli eventi di telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato
`DISABLE_INSTALLATION_CHECKS`	Impostare su `1` per disabilitare gli avvisi di installazione. Utilizzare solo quando gestite manualmente il percorso di installazione, poiché questo può mascherare i problemi con le installazioni standard
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Impostare su `1` per nascondere il comando `/install-github-app`. Già nascosto quando si utilizzano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry)
`DISABLE_INTERLEAVED_THINKING`	Impostare su `1` per impedire l'invio dell'intestazione beta del pensiero intercalato. Utile quando il vostro gateway LLM o provider non supporta il pensiero intercalato
`DISABLE_LOGIN_COMMAND`	Impostare su `1` per nascondere il comando `/login`. Utile quando l'autenticazione viene gestita esternamente tramite chiavi API o `apiKeyHelper`
`DISABLE_LOGOUT_COMMAND`	Impostare su `1` per nascondere il comando `/logout`
`DISABLE_PROMPT_CACHING`	Impostare su `1` per disabilitare la memorizzazione in cache del prompt per tutti i modelli (ha la precedenza sulle impostazioni per modello)
`DISABLE_PROMPT_CACHING_FABLE`	Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Haiku
`DISABLE_PROMPT_CACHING_OPUS`	Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Opus
`DISABLE_PROMPT_CACHING_SONNET`	Impostare su `1` per disabilitare la memorizzazione in cache del prompt per i modelli Sonnet
`DISABLE_TELEMETRY`	Impostare su qualsiasi valore non vuoto, come `1`, per rinunciare alla telemetria. L'impostazione su `0` o `false` rinuncia comunque, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità con lo stesso effetto di `DISABLE_GROWTHBOOK`, che rende Remote Control e le altre funzionalità che necessitano del recupero dei flag di funzionalità non disponibili. Vedere Disattivare la telemetria per la vostra organizzazione
`DISABLE_UPDATES`	Impostare su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizzare quando si distribuisce Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornare
`DISABLE_UPGRADE_COMMAND`	Impostare su `1` per nascondere il comando `/upgrade`
`DO_NOT_TRACK`	Impostare su `1` per rinunciare alla telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, incluso il rendere Remote Control e le altre funzionalità che necessitano del recupero dei flag di funzionalità non disponibili. Claude Code legge questa variabile come un booleano standard, quindi `0` lascia la telemetria attiva e la onora come la convenzione tra strumenti riconosciuta da molti CLI di sviluppatori
`ENABLE_BETA_TRACING_DETAILED`	Impostare su `1`, insieme a `BETA_TRACING_ENDPOINT`, per attivare il tracciamento beta dettagliato, che aggiunge attributi che trasportano contenuto e l'intervallo `claude_code.hook`. Le sessioni CLI interattive richiedono anche che la vostra organizzazione sia nella lista di autorizzazione per il beta. Entrambe le variabili vengono ignorate nelle impostazioni di progetto e locali
`ENABLE_CLAUDEAI_MCP_SERVERS`	Impostare su `false` per impedire a Claude Code di recuperare i server MCP claude.ai. Abilitato per impostazione predefinita per gli utenti connessi. Per disabilitare per progetto o per organizzazione, impostare `disableClaudeAiConnectors` nelle impostazioni
`ENABLE_PROMPT_CACHING_1H`	Impostare su `1` per richiedere un TTL della cache del prompt di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di chiave API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS. Gli utenti di abbonamento entro l'utilizzo incluso ricevono il TTL di 1 ora automaticamente sulla conversazione principale. Gli utenti di abbonamento che attingono ai crediti di utilizzo possono impostarlo per mantenere il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta. Per scegliere il TTL per bucket di richiesta, utilizzare `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Deprecato. Utilizzare `ENABLE_PROMPT_CACHING_1H`
`ENABLE_TOOL_SEARCH`	Controlla la ricerca degli strumenti MCP. Non impostato, Claude Code rinvia tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, su una distribuzione Microsoft Foundry ospitata su Azure e quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte. `true` rinvia sempre e invia l'intestazione beta, tranne su quei modelli di Agent Platform e distribuzioni Microsoft Foundry; le richieste falliscono su proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti si adattano entro il 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore che impostate voi stessi viene ignorato quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` è impostato. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli su Google Cloud's Agent Platform a meno che non impostaste questa variabile su `true`
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Impostare su qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di ritentare su errori di sovraccarico ripetuti per ogni modello quando nessun modello di fallback è configurato. L'impostazione su `0` o `false` abilita comunque questo, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per ripristinare il comportamento di ripetizione predefinito. Senza di esso, Claude Code smette di ritentare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando vi autenticate con una chiave API o un provider di terze parti piuttosto che un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla vostra catena del modello di fallback configurata su errori di sovraccarico ripetuti per qualsiasi modello primario, quindi questa variabile non influisce sul passaggio a un modello di fallback
`FORCE_AUTOUPDATE_PLUGINS`	Impostare su `1` per forzare gli auto-aggiornamenti dei plugin anche quando l'auto-updater principale è disabilitato tramite `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Impostare su `1` per abilitare i hyperlink OSC 8 cliccabili quando il vostro terminale li supporta ma non viene rilevato automaticamente, o `0` per disabilitarli. Quando non impostato, Claude Code abilita i hyperlink solo quando rileva il supporto del terminale. Claude Code analizza questo valore come un numero, non un booleano, quindi un valore come `false`, `no` o `off` abilita i hyperlink piuttosto che disabilitarli. Il badge del PR o merge request del footer viene eseguito come hyperlink anche quando Claude Code non riesce a rilevare il supporto del terminale, come su SSH. Impostare `0` per eseguire il rendering del badge come testo semplice
`FORCE_PROMPT_CACHING_5M`	Impostare su `1` per forzare il TTL della cache del prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl`
`HTTP_PROXY`	Specificare il server proxy HTTP per le connessioni di rete
`HTTPS_PROXY`	Specificare il server proxy HTTPS per le connessioni di rete
`IS_DEMO`	Impostare su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. L'impostazione su `0` o `false` abilita comunque la modalità demo, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione
`MAX_MCP_OUTPUT_TOKENS`	Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano `anthropic/maxResultSizeChars` utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da quei strumenti è comunque soggetto a questa variabile (predefinito: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo `--json-schema` in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di flusso di lavoro non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro tentativi
`MAX_THINKING_TOKENS`	Budget di token fisso per il pensiero esteso. Claude Code lo limita a un token al di sotto dei token di output massimi della richiesta e mai al di sotto di 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il pensiero è abilitato, i modelli con ragionamento adattivo scelgono la loro profondità di pensiero e gli altri modelli utilizzano il limite. Impostare su `0` per disabilitare il pensiero sull'API Anthropic, tranne su Opus 5.5 e sui modelli Fable, che non possono avere il pensiero disattivato. Su provider di terze parti, `0` omette il parametro `thinking`. Con il pensiero disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa non accettano quella combinazione, come Opus 5. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo
`MCP_CLIENT_SECRET`	Segreto client OAuth per i server MCP che richiedono credenziali pre-configurate. Evita il prompt interattivo quando si aggiunge un server con `--client-secret`
`MCP_CONNECTION_NONBLOCKING`	Controlla se l'avvio aspetta i server MCP per connettersi prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare su `0` per fare in modo che Claude Code aspetti i server per connettersi prima della prima query. I server configurati con `alwaysLoad: true` fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla cache di scoperta, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passate `--mcp-config` esplicitamente, l'attesa ha una scadenza più lunga; vedere la voce di quel flag per l'eccezione del server memorizzato in cache
`MCP_CONNECT_TIMEOUT_MS`	Quanto a lungo l'avvio MCP bloccante aspetta, in millisecondi, il batch di connessione prima di fare uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati `alwaysLoad: true`. I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server
`MCP_DISCOVERY_CACHE`	Attiva o disattiva la cache di scoperta MCP. Con la cache attiva, un server HTTP o SSE remoto che avete utilizzato prima può mostrare lo stato `cached`, e Claude Code lo connette alla sua prima chiamata di strumento invece che all'avvio. La cache è disattivata per impostazione predefinita a meno che un rollout graduale non l'abbia abilitata per il vostro account. Impostare su `1` per attivarla, o `0` per mantenerla disattivata anche quando il rollout l'ha abilitata. Prima della v2.1.238, la cache era attiva per impostazione predefinita. Lo stato `cached` richiede Claude Code v2.1.221 o successivo
`MCP_DISCOVERY_CACHE_MAX_STALE_S`	Età massima, in secondi, di una voce della cache di scoperta (predefinito: 14400, o 4 ore). All'avvio in cui la voce è più vecchia di quella, Claude Code la scarta e connette il server all'avvio, come fa con la cache disattivata. Claude Code limita il valore a 7 giorni. Prima della v2.1.238, il predefinito era 86400, o 24 ore, e Claude Code non limitava il valore
`MCP_DISCOVERY_CACHE_STRIKES`	All'avvio in cui una voce della cache di scoperta è più vecchia di `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la aggiorna in background. Questa variabile imposta quanti aggiornamenti di fila possono fallire prima che Claude Code scarta la voce e connette il server al prossimo avvio (predefinito: 1). Aumentare se la vostra connessione di rete cade occasionalmente, in modo che un aggiornamento non riuscito non scarta la voce. Richiede Claude Code v2.1.238 o successivo
`MCP_DISCOVERY_CACHE_TTL_S`	Secondi per i quali Claude Code utilizza una voce della cache di scoperta senza aggiornarla (predefinito: 900). All'avvio in cui la voce è più vecchia di quella, Claude Code la utilizza comunque ma l'aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la scarta. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che è 4 ore per impostazione predefinita. Prima della v2.1.238, Claude Code non limitava il valore
`MCP_OAUTH_CALLBACK_PORT`	Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando si aggiunge un server MCP con credenziali pre-configurate
`MCP_PROTOCOL_NEGOTIATION`	Solo sul runtime client MCP v2, se Claude Code esamina i server per la revisione del protocollo MCP 2026-07-28. Impostare `auto` per esaminare i server HTTP, connettore claude.ai e stdio; un server che non risponde al probe si connette sul protocollo precedente, come i server SSE e WebSocket fanno sempre. Impostare `legacy` per saltare il probe per ogni server. Senza la variabile, Claude Code esamina i server HTTP e esamina anche i server del connettore claude.ai nelle sessioni in cui recupera i flag di funzionalità. 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`	Bloccare quale runtime client MCP questo processo si connette ai server MCP con: `v1`, costruito su MCP TypeScript SDK 1.x, o `v2`, costruito su MCP TypeScript SDK 2.0. Senza la variabile, Claude Code utilizza v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 controlla l'emittente che un server OAuth MCP restituisce nella sua risposta di autorizzazione e fallisce l'accesso con un errore che inizia `Issuer mismatch in authorization response` quando non corrisponde. Il runtime v1 non esegue questo controllo. Se impostate un valore non riconosciuto, Claude Code lo ignora e scrive un avviso nel log di debug. Claude Code legge il valore una volta per processo. Richiede Claude Code v2.1.218 o successivo
`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 del server MCP (predefinito: 30000, o 30 secondi)
`MCP_TOOL_TIMEOUT`	Timeout in millisecondi per l'esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade anche dopo 60 secondi per impostazione predefinita; impostare questa variabile o il `timeout` per server sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout di esecuzione dello strumento complessivo ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sostituisce questo per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate di strumento di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo floor richiede Claude Code v2.1.203 o successivo. Per la variabile env, i valori inferiori a 1000 sono limitati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati
`NO_PROXY`	Elenco di domini e IP a cui le richieste verranno emesse direttamente, bypassando il proxy
`OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT`	Limite standard OpenTelemetry SDK sulla lunghezza del valore dell'attributo. Claude Code limita gli attributi di telemetria che trasportano contenuto al minore di questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento rimanga entro il limite dell'SDK. Claude Code legge le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` allo stesso modo e il valore più piccolo impostato si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Vedere Monitoraggio
`OTEL_LOG_ASSISTANT_RESPONSES`	Impostare su `1` per includere il testo della risposta del modello sugli eventi di log OpenTelemetry `assistant_response`. Quando non impostato, viene utilizzato il valore di `OTEL_LOG_USER_PROMPTS`. Impostare su `0` per mantenere le risposte redatte anche quando `OTEL_LOG_USER_PROMPTS` è impostato. Richiede Claude Code v2.1.193 o successivo. Vedere Monitoraggio
`OTEL_LOG_MANAGED_SETTINGS`	Impostare su `1` per aggiungere le impostazioni gestite redatte e un digest SHA-256 delle impostazioni prima della redazione agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitato per impostazione predefinita. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite; un valore nelle impostazioni di progetto o locali non lo attiva. Richiede Claude Code v2.1.274 o successivo. Vedere Monitoraggio
`OTEL_LOG_RAW_API_BODIES`	Emettere il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Impostare su `1` per i corpi in linea troncati al limite di contenuto, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostatelo nella vostra shell, impostazioni utente o impostazioni gestite. Ignorato nelle impostazioni di progetto e locali. Vedere Monitoraggio
`OTEL_LOG_TOOL_CONTENT`	Impostare su `1` per includere il contenuto dello strumento nell'evento di intervallo OpenTelemetry `tool.output`. Gli attributi di intervallo trasportano il contenuto dello strumento sotto i loro propri gate. Richiede il tracciamento. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedere Monitoraggio
`OTEL_LOG_TOOL_DETAILS`	Impostare su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, i nomi dei flussi di lavoro creati dall'utente, le stringhe di errore grezze sui fallimenti degli strumenti, la `category` di rifiuto sugli eventi `api_refusal` e altri dettagli dello strumento nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le PII. Vedere Monitoraggio
`OTEL_LOG_USER_PROMPTS`	Impostare su `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedere Monitoraggio
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Impostare su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedere Monitoraggio
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Impostare su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto nella v2.1.152. Vedere Monitoraggio
`OTEL_METRICS_INCLUDE_REPOSITORY`	Impostare su `true` per taggare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Vedere Attributi del repository
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partire dalla v2.1.161, Claude Code allega le chiavi `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei punti dati delle metriche. Impostare su `false` per escluderle (predefinito: incluso). Vedere Monitoraggio
`OTEL_METRICS_INCLUDE_SESSION_ID`	Impostare su `false` per escludere l'ID della sessione dagli attributi delle metriche (predefinito: incluso). Vedere Monitoraggio
`OTEL_METRICS_INCLUDE_VERSION`	Impostare su `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Vedere Monitoraggio
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Sostituire il budget di caratteri per i metadati della skill mostrati allo strumento Skill. Il budget si ridimensiona dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per la compatibilità all'indietro
`TASK_MAX_OUTPUT_LENGTH`	Rimosso nella v2.1.277 e ora un no-op, insieme allo strumento `TaskOutput` che ha dimensionato. In precedenza impostava il numero massimo di caratteri dell'output di un compito in background che lo strumento `TaskOutput` manteneva. Claude legge l'output di un compito in background con `Read`
`USE_BUILTIN_RIPGREP`	Impostare su `0` per utilizzare il `rg` installato dal sistema invece di `rg` incluso con Claude Code
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Sostituire l'area per Claude 3.5 Haiku quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Sostituire l'area per Claude 3.5 Sonnet quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Sostituire l'area per Claude 3.7 Sonnet quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Sostituire l'area per Claude 4.0 Opus quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Sostituire l'area per Claude 4.0 Sonnet quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Sostituire l'area per Claude 4.1 Opus quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Sostituire l'area per Claude Opus 4.5 quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Sostituire l'area per Claude Sonnet 4.5 quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Sostituire l'area per Claude Opus 4.6 quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Sostituire l'area per Claude Sonnet 4.6 quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Sostituire l'area per Claude Opus 4.7 quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Sostituire l'area per Claude Opus 4.8 quando si utilizza Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_5_5_OPUS`	Sostituire l'area per Claude Opus 5.5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.280
`VERTEX_REGION_CLAUDE_5_OPUS`	Sostituire l'area per Claude Opus 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.219
`VERTEX_REGION_CLAUDE_5_SONNET`	Sostituire l'area per Claude Sonnet 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Sostituire l'area per Claude Fable 5 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.170
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Sostituire l'area per Claude Fable 5.1 quando si utilizza Google Cloud's Agent Platform. Aggiunto nella v2.1.257
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Sostituire l'area per Claude Haiku 4.5 quando si utilizza Google Cloud's Agent Platform

Sono supportate anche le variabili dell'esportatore OpenTelemetry standard (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES e varianti specifiche del segnale). Vedere Monitoraggio per i dettagli di configurazione.

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:

Avviare sessioni in modalità auto per impostazione predefinita sui piani Pro, Max e Team
Far leggere all'estensione VS Code i file di impostazioni per la modalità di autorizzazione iniziale
Eseguire /auto-mode-setup per elaborare le voci autoMode.environment
Utilizzare Remote Control
Inviare messaggi alle sessioni oltre questa macchina; 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
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, e la sessione può avviarsi in modalità Manual su un piano che altrimenti si avvia in modalità auto. Claude Code recupera i flag durante quella sessione, quindi entrambi sono presenti nella vostra sessione successiva.

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

env-vars.md 2026-09-23 23:57 UTC to 2026-09-24 22:57 UTC

Variabili d'ambiente

Impostare variabili di 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

env-vars.md +2 −2