SpyBara
Go Premium

env-vars.md 2026-10-01 23:59 UTC to 2026-10-02 18:00 UTC

This page contains 390 additions and 384 deletions.

2026
Thu 1 23:59 Fri 2 18:59

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 variabili d'ambiente

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

Nella tua shell

Imposta la variabile prima di avviare claude:

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.

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

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 d'ambiente che una chiave di impostazioni dedicata, e quale Claude Code legge per primo differisce per chiave. Per ANTHROPIC_MODEL e CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code legge prima la variabile e utilizza l'impostazione model o autoConnectIde solo quando la variabile non è impostata. Per la coppia che stai impostando, controlla la riga della variabile di seguito e la voce della chiave nel riferimento delle impostazioni.

Quando la stessa variabile è impostata sia nella tua shell che in un blocco env del file di impostazioni, nella maggior parte delle sessioni si applica il valore del file di impostazioni. Claude Code scrive ogni voce env nell'ambiente del processo, sostituendo il valore ereditato dalla shell. Come i valori env interagiscono con la tua shell descrive le sessioni che mantengono invece il valore ereditato, e l'impostazione env indica quando Claude Code li applica. Alcune variabili sono trattate come casi speciali; l'impostazione env elenca le eccezioni.

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

Tra i file di impostazioni, i valori env seguono la precedenza delle impostazioni, quindi una voce di impostazioni gestite sovrascrive la stessa variabile nelle impostazioni utente o progetto. Le impostazioni di progetto e locali non possono impostare alcune variabili, come CLAUDE_CONFIG_DIR e le variabili dell'esportatore OpenTelemetry. Le variabili che Claude Code ignora in env le elenca, insieme ai valori di disattivazione di OpenTelemetry che si applicano ancora.

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

Claude Code legge le variabili d'ambiente della shell all'avvio, quindi le modifiche ad esse hanno effetto la prossima volta che avvii claude. Le variabili impostate sotto la chiave env nei file di impostazioni vengono riapplicate a una sessione in esecuzione quando il file cambia, con l'eccezione di avvio-solo descritta in Nei file di impostazioni.

Variabili

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

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

Sono supportate anche le variabili standard degli exporter OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES e le varianti specifiche per segnale). Consulta Monitoraggio per i dettagli di configurazione.

Imposta CLAUDE_CODE_ENABLE_TELEMETRY e le variabili OpenTelemetry che attivano l'esportazione, ne scelgono la destinazione o acquisiscono contenuti nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Claude Code le ignora nelle impostazioni di progetto e locali, fatta eccezione per i valori di disattivazione descritti in quella sezione. OTEL_RESOURCE_ATTRIBUTES e le variabili relative a intervallo di esportazione, timeout e compressione, come OTEL_METRIC_EXPORT_INTERVAL, si applicano comunque dalle impostazioni di progetto e locali.

Funzionalità che richiedono il recupero dei feature flag

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

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

Con il recupero disattivato, non potete:

Prima sessione dopo un'installazione o un aggiornamento

Nella vostra prima sessione dopo aver installato Claude Code, o aggiornato a una versione che aggiunge una funzionalità, una funzionalità con gate flag può mancare. Quella sessione può anche avviarsi in una diversa modalità di autorizzazione rispetto alle vostre sessioni successive. Claude Code recupera i flag durante quella sessione, quindi la vostra sessione successiva ha la funzionalità e la modalità di autorizzazione iniziale usuale.

Dopo un'installazione pulita, in una sessione non interattiva come claude -p, l'Agent SDK, o l'estensione VS Code, Claude Code può comunque recuperare i flag prima di scegliere la modalità di autorizzazione iniziale.

Vedi anche