Variabili d'ambiente - Claude Code Docs

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

Impostare le variabili d’ambiente nella vostra shell o in un file di impostazioni
Verificare quale valore si applica quando un comportamento può essere impostato in più di un modo
Cercare le variabili che Claude Code legge

Impostare le variabili d’ambiente

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

Nella vostra shell

Impostate la variabile prima di avviare claude:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

export API_TIMEOUT_MS="1200000"
claude

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

$env:API_TIMEOUT_MS = "1200000"
claude

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

set API_TIMEOUT_MS=1200000
claude

Per impostarla per ogni sessione, eseguite setx API_TIMEOUT_MS "1200000" e aprite un nuovo terminale.

Nei file di impostazioni

Aggiungete le variabili sotto la chiave env in un file settings.json. Claude Code le legge direttamente dal file all’avvio, quindi hanno effetto indipendentemente da come claude è stato avviato.

~/.claude/settings.json

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

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

File	Si applica a
`~/.claude/settings.json`	Voi, in ogni progetto
`.claude/settings.json`	Tutti coloro che lavorano nel progetto, archiviato nel controllo del codice sorgente
`.claude/settings.local.json`	Voi, solo in questo progetto (aggiungete al vostro gitignore se lo create manualmente)
Impostazioni gestite	Tutti nella vostra organizzazione, distribuiti da un amministratore

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

Precedenza

Quando lo stesso comportamento ha sia una variabile d’ambiente che un campo di impostazioni, la variabile d’ambiente ha la precedenza. Ad esempio, ANTHROPIC_MODEL sostituisce l’impostazione model e CLAUDE_CODE_AUTO_CONNECT_IDE sostituisce autoConnectIde. Il campo di impostazioni si applica quando la variabile d’ambiente non è impostata. Quando la stessa variabile è impostata sia nella shell che in un file di impostazioni nel blocco env, il valore del file di impostazioni si applica. Claude Code scrive ogni voce env nell’ambiente del processo all’avvio, sostituendo il valore ereditato dalla shell. Alcune variabili sono trattate come casi speciali; l’impostazione env elenca le eccezioni. Tra i file di impostazioni, i valori env seguono la precedenza delle impostazioni, quindi una voce di impostazioni gestita sostituisce la stessa variabile nelle impostazioni utente o progetto. Il modo in cui una variabile d’ambiente interagisce con i flag CLI e i comandi in-sessione varia per funzionalità: --model e /model sostituiscono ANTHROPIC_MODEL, mentre CLAUDE_CODE_EFFORT_LEVEL sostituisce /effort. Quando una variabile interagisce con un’altra fonte di configurazione, la sua riga nell’elenco Variabili dichiara la precedenza o si collega alla pagina che la documenta. Claude Code legge le variabili d’ambiente all’avvio, quindi le modifiche hanno effetto la prossima volta che avviate claude.

Variabili

Variabile	Scopo
`ANTHROPIC_API_KEY`	Chiave API inviata come intestazione `X-Api-Key`. Quando impostata, questa chiave viene utilizzata al posto del vostro abbonamento Claude Pro, Max, Team o Enterprise anche se siete connessi. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente. In modalità interattiva, vi viene chiesto di approvare la chiave una volta prima che sostituisca il vostro abbonamento. Per utilizzare il vostro abbonamento, eseguite `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valore personalizzato per l’intestazione `Authorization` (il valore che impostate qui sarà preceduto da `Bearer` )
`ANTHROPIC_AWS_API_KEY`	Chiave API dell’area di lavoro per Claude Platform on AWS, generata nella Console AWS. Inviata come `x-api-key` e ha la precedenza su AWS SigV4
`ANTHROPIC_AWS_BASE_URL`	Sovrascrivi l’URL dell’endpoint Claude Platform on AWS. Utilizza per regioni personalizzate o quando instrada attraverso un gateway LLM. Per impostazione predefinita `https://aws-external-anthropic.{AWS_REGION}.api.aws`
`ANTHROPIC_AWS_WORKSPACE_ID`	Obbligatorio per Claude Platform on AWS. Inviato su ogni richiesta come intestazione `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Sovrascrivi l’endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, la ricerca degli strumenti MCP è disabilitata per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il vostro proxy inoltra i blocchi `tool_reference`. A partire da v2.1.196, il Remote Control è disabilitato quando questo punta a un host diverso da `api.anthropic.com`, corrispondendo al suo comportamento su Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry
`ANTHROPIC_BEDROCK_BASE_URL`	Sovrascrivi l’URL dell’endpoint Amazon Bedrock. Utilizza per endpoint Amazon Bedrock personalizzati o quando instrada attraverso un gateway LLM. Vedi Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Sovrascrivi l’URL dell’endpoint Amazon Bedrock Mantle. Vedi Endpoint Mantle
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Amazon Bedrock service tier (`default`, `flex` o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Vedi 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; utilizza questo per aderire a un beta API Anthropic prima che Claude Code aggiunga il supporto nativo. A differenza del flag `--betas`, che richiede l’autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione incluso l’abbonamento Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	Intestazioni personalizzate da aggiungere alle richieste (formato `Name: Value`, separate da newline per più intestazioni)
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID del modello da aggiungere come voce personalizzata nel selettore `/model`. Utilizza questo per rendere selezionabile un modello non standard o specifico del gateway senza sostituire gli alias integrati. Vedi Configurazione del modello
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Descrizione di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Per impostazione predefinita, `Custom model (<model-id>)` quando non impostato
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	Nome di visualizzazione per la voce del modello personalizzato nel selettore `/model`. Per impostazione predefinita, l’ID del modello quando non impostato
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Vedi Configurazione del modello
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Vedi Configurazione del modello
`ANTHROPIC_FOUNDRY_API_KEY`	Chiave API per l’autenticazione Microsoft Foundry (vedi 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. Vedi Microsoft Foundry. Richiede Claude Code v2.1.203 o successivo
`ANTHROPIC_FOUNDRY_BASE_URL`	URL base completo per la risorsa Microsoft Foundry (ad esempio, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (vedi Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Obbligatorio se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostato (vedi Microsoft Foundry)
`ANTHROPIC_MODEL`	Nome dell’impostazione del modello da utilizzare (vedi Configurazione del modello)
`ANTHROPIC_SMALL_FAST_MODEL`	[DEPRECATO] Nome del modello di classe Haiku per attività in background
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Sovrascrivi la regione AWS per il modello di classe Haiku quando utilizzate Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, questo ha effetto solo quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` o il deprecato `ANTHROPIC_SMALL_FAST_MODEL` è anche impostato, poiché Amazon Bedrock altrimenti esegue attività in background sul modello Sonnet predefinito o sul modello primario nella regione della sessione
`ANTHROPIC_VERTEX_BASE_URL`	Sovrascrivi l’URL dell’endpoint Google Cloud’s Agent Platform. Utilizza per endpoint Google Cloud’s Agent Platform personalizzati o quando instrada attraverso un gateway LLM. Vedi Google Cloud’s Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID progetto GCP per le richieste Google Cloud’s Agent Platform. Sovrascritto da `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` o dal progetto nel vostro file di credenziali `GOOGLE_APPLICATION_CREDENTIALS`. Vedi Google Cloud’s Agent Platform
`ANTHROPIC_WORKSPACE_ID`	ID area di lavoro per la federazione dell’identità del carico di lavoro. Impostate questo quando la vostra regola di federazione è limitata a più di un’area di lavoro in modo che lo scambio di token sappia quale area di lavoro indirizzare
`API_FORCE_IDLE_TIMEOUT`	Sovrascrivi il timeout di inattività di 5 minuti che interrompe una risposta del modello di streaming quando nessun byte arriva. Imposta su `0` per disabilitare il timeout, ad esempio quando un gateway lento o un modello locale pausa più di 5 minuti tra i chunk. Imposta su `1` per mantenere il timeout su ogni provider. Se non impostato, il timeout è inattivo su connessioni API Anthropic dirette e Claude Platform on AWS, dove il watchdog di stream a livello di byte di Claude Code viene eseguito, ed è attivo su ogni altro provider, inclusi Google Cloud’s Agent Platform, Microsoft Foundry, Mantle, Amazon Bedrock e connessioni gateway, quindi uno stream bloccato si interrompe invece di bloccarsi. A partire da v2.1.169
`API_TIMEOUT_MS`	Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumentate questo valore quando le richieste scadono su reti lente o quando instradate attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste
`AWS_BEARER_TOKEN_BEDROCK`	Chiave API Amazon Bedrock per l’autenticazione (vedi Chiavi API Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Timeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti)
`BASH_MAX_OUTPUT_LENGTH`	Numero massimo di caratteri negli output bash prima che l’output completo venga salvato in un file e Claude riceva il percorso più un’anteprima breve. Vedi Comportamento dello strumento Bash
`BASH_MAX_TIMEOUT_MS`	Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti)
`CCR_FORCE_BUNDLE`	Imposta su `1` per forzare `claude --cloud` a raggruppare e caricare il vostro repository locale anche quando l’accesso a GitHub è disponibile
`CLAUDECODE`	Imposta su `1` nei sottoprocessi che Claude Code genera (strumento Bash e PowerShell, sessioni tmux, comandi hook, comandi della linea di stato, sottoprocessi del server MCP stdio). Le estensioni IDE impostano anche questo nei loro terminali integrati. Utilizza per rilevare quando uno script è in esecuzione all’interno di un sottoprocesso generato da Claude Code. Per verificare se il processo corrente è stato generato direttamente da una chiamata di strumento o hook, piuttosto che all’interno di un server MCP stdio che Claude Code ha avviato, utilizzate `CLAUDE_CODE_CHILD_SESSION`
`CLAUDE_AFK_COUNTDOWN_MS`	Quanti millisecondi prima dell’auto-continuazione il conto alla rovescia sullo schermo appare su una finestra di dialogo `AskUserQuestion` senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di auto-continuazione. Non ha effetto a meno che l’auto-continuazione non sia attiva; vedi l’impostazione `askUserQuestionTimeout` e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successivo
`CLAUDE_AFK_TIMEOUT_MS`	Quanti millisecondi di tempo inattivo prima che una finestra di dialogo `AskUserQuestion` senza risposta continui automaticamente senza di voi. L’auto-continuazione è disattivata per impostazione predefinita; aderite con l’impostazione `askUserQuestionTimeout`. Questa variabile è un override per demo e test automatizzati: quando impostata, ha la precedenza su quella impostazione e attiva l’auto-continuazione anche quando l’impostazione non è impostata o è `never`. L’impostazione di `0` non disattiva il timeout; chiude la finestra di dialogo immediatamente. In v2.1.198 e v2.1.199, l’auto-continuazione era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successivo
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	Imposta su `1` per disabilitare tutti i tipi di subagent integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti SDK che desiderano una lavagna pulita
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	Imposta su `1` per saltare il prefisso `mcp__<server>__` sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Timeout di stallo in millisecondi per i subagent in background. Predefinito `600000` (10 minuti). Il timer si ripristina su ogni evento di progresso dello streaming; se nessun progresso arriva entro la finestra, il subagent viene interrotto e l’attività viene contrassegnata come non riuscita, mostrando qualsiasi risultato parziale al genitore
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Imposta la percentuale (1-100) della finestra di compattazione automatica a cui viene attivata la compattazione automatica. Utilizzate valori inferiori come `50` per compattare prima. Questa variabile causa solo una compattazione più precoce quando Claude Code compatta in modo proattivo: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` è impostato, nelle sessioni cloud e su Sonnet 4.6 e Opus 4.6 senza contesto esteso, che compattano al limite di 200K per impostazione predefinita. Su Sonnet 5, la compattazione proattiva si applica alla soglia predefinita del modello. In altri casi, come una sessione locale su Opus 4.8, la compattazione automatica si attiva quando la conversazione raggiunge il limite del contesto del modello. L’override può solo abbassare la soglia, quindi i valori superiori al valore predefinito non hanno effetto. Si applica sia alle conversazioni principali che ai subagent
`CLAUDE_AUTO_BACKGROUND_TASKS`	Imposta su `1` per forzare l’abilitazione dello sfondo automatico delle attività di agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l’esecuzione per circa due minuti
`CLAUDE_AX_SCREEN_READER`	Imposta su `1` per renderizzare l’output adatto ai lettori di schermo: testo piatto senza bordi decorativi o animazioni. Imposta su `0` per forzare la disabilitazione della modalità lettore di schermo anche quando `axScreenReader` è `true`. Il flag `--ax-screen-reader` ha la precedenza. Richiede Claude Code v2.1.181 o successivo
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Ritorna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale
`CLAUDE_CLIENT_PRESENCE_FILE`	Percorso a un file che uno strumento esterno, come un listener di blocco dello schermo, crea quando sbloccare lo schermo e cancella quando lo blocca. Mentre il file esiste, Claude Code salta le notifiche push Remote Control mobile, quindi smettete di ricevere push mentre state utilizzando attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per evento di attivazione push piuttosto che eseguire il polling. Richiede Claude Code v2.1.181 o successivo
`CLAUDE_CODE_ACCESSIBILITY`	Imposta su `1` per mantenere visibile il cursore del terminale nativo e disabilitare l’indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`	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 su ogni frame nel rendering a schermo intero invece di inviare aggiornamenti incrementali. Utilizza questo se la modalità a schermo intero mostra frammenti di testo stantii o mal posizionati. Claude Code abilita questo automaticamente per le sessioni in background e la visualizzazione degli 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 effort-capable. Utilizza questo quando instrada attraverso un gateway LLM o provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort all’API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, sono comunque esclusi in modo che le richieste non falliscano
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	Intervallo in millisecondi a cui le credenziali devono essere aggiornate (quando si utilizza `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Imposta su `0` per impedire a Claude Code di aprire il browser automaticamente quando viene pubblicato un nuovo artifact. La ripubblicazione di un artifact esistente non apre il browser indipendentemente da questa impostazione
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Imposta su `0` per omettere il blocco di attribuzione (versione client e impronta digitale del prompt) dall’inizio del prompt di sistema. Disabilitarlo migliora i tassi di hit della cache dei prompt quando si instrada attraverso un gateway LLM. Il caching dell’API Anthropic non è interessato
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Imposta la capacità del contesto in token utilizzata per i calcoli di compattazione automatica. Per impostazione predefinita, la finestra del contesto del modello: 200K per i modelli standard o 1M per i modelli con contesto esteso, tranne su Sonnet 5, che ha la sua propria soglia predefinita. Utilizzate un valore inferiore come `500000` su un modello 1M per trattare la finestra come 500K ai fini della compattazione. Il valore è limitato alla finestra del contesto effettiva del modello. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` viene applicato come percentuale di questo valore. L’impostazione di questa variabile disaccoppia la soglia di compattazione dalla `used_percentage` della linea di stato, che utilizza sempre la finestra del contesto completa del modello
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Sovrascrivi la connessione IDE automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all’interno del terminale integrato di un IDE supportato. Imposta su `false` per impedire questo. Imposta su `true` per forzare un tentativo di connessione quando l’auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale padre. Ha la precedenza sull’impostazione globale `autoConnectIde`
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tempo in millisecondi che Claude Code attende affinché la catena del provider di credenziali predefinito AWS produca credenziali prima che la richiesta fallisca con `AWS default-chain credential resolve timed out` (predefinito: `60000`). Aumentatelo quando un passaggio nella vostra catena ha legittimamente bisogno di più tempo, come un accesso SSO basato su browser con MFA attraverso un wrapper come `aws-vault`. Si applica ovunque Claude Code firma con la catena predefinita: Amazon Bedrock, Claude Platform on AWS e l’endpoint Mantle. Richiede Claude Code v2.1.207 o successivo
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Impostato automaticamente nel sottoprocesso dello strumento Bash e nel comando hook mentre la sessione ha una connessione Remote Control attiva, e rimosso quando la connessione termina. Il valore è l’ID della sessione in forma `session_`, lo stesso identificatore che appare nell’URL `claude.ai/code` della sessione, quindi uno script può collegarsi di nuovo alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successivo. Nelle sessioni cloud, leggete `CLAUDE_CODE_REMOTE_SESSION_ID`
`CLAUDE_CODE_CERT_STORE`	Elenco separato da virgole di fonti di certificati CA per le connessioni TLS. `bundled` è il set Mozilla CA fornito con Claude Code. `system` è l’archivio di fiducia del sistema operativo, di sola lettura su runtime con `tls.getCACertificates`: il binario nativo, o Node 22.15 o successivo per installazioni npm. Vedi Archivio certificati CA. Per impostazione predefinita è `bundled,system`
`CLAUDE_CODE_CHILD_SESSION`	Imposta su `1` nei sottoprocessi che Claude Code genera tramite gli strumenti Bash, PowerShell e Monitor, i comandi hook e i comandi della linea di stato. Non impostato per i sottoprocessi del server MCP stdio, che sono di lunga durata e sopravvivono alla sessione che li ha generati. A differenza di `CLAUDECODE`, questo viene impostato 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 livello superiore avviato in un terminale integrato IDE. Una TUI `claude` interattiva annidata avviata in questo modo viene automaticamente esclusa da `--resume`, `--continue`, dalla cronologia della freccia su e dall’elenco `claude agents`. Le sessioni non interattive `claude -p` persistono comunque. Impostare `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per sostituire questa esclusione. Richiede Claude Code v2.1.172 o successivo
`CLAUDE_CODE_CLIENT_CERT`	Percorso del file del certificato client per l’autenticazione mTLS
`CLAUDE_CODE_CLIENT_KEY`	Percorso del file della chiave privata client per l’autenticazione mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Passphrase per CLAUDE_CODE_CLIENT_KEY crittografato (facoltativo)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Rimosso in v2.1.186 e ora un no-op. In precedenza impostava un timeout separato per la fase di connessione, TLS e intestazione di risposta di una richiesta API di streaming. Utilizza `API_TIMEOUT_MS` per il timeout per richiesta
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Sovrascrivi il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede che la modalità debug sia abilitata separatamente tramite `--debug`, `/debug` o la variabile d’ambiente `DEBUG`: l’impostazione di questa variabile da sola non abilita la registrazione. Il flag `--debug-file` fa entrambi contemporaneamente. Per impostazione predefinita `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l’output completo del comando della linea di stato, o aumenta a `error` per ridurre il rumore
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Imposta su `1` per disabilitare il supporto della finestra del contesto 1M. Se impostato, le varianti del modello 1M non sono disponibili nel selettore di modelli, e le sessioni Sonnet 5 vengono trattate come aventi una finestra di 200K. Utile per ambienti aziendali con requisiti di conformità
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Imposta su `1` per disabilitare il ragionamento adattivo su Opus 4.6 e Sonnet 4.6 e tornare al budget di thinking fisso controllato da `MAX_THINKING_TOKENS`. Da v2.1.111, non ha effetto su Fable 5, Sonnet 5 o Opus 4.7 e versioni successive, che utilizzano sempre il ragionamento adattivo
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Imposta su `1` per disabilitare lo strumento advisor. Il comando `/advisor` diventa non disponibile, qualsiasi `advisorModel` configurato viene ignorato e il flag `--advisor` viene accettato ma non ha effetto, quindi gli script esistenti che lo passano continuano a funzionare senza errori
`CLAUDE_CODE_DISABLE_AGENT_VIEW`	Imposta su `1` per disattivare gli agenti in background e la visualizzazione degli agenti: `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all’impostazione `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Imposta su `1` per disabilitare il rendering a schermo intero e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del vostro terminale in modo che `Cmd+f` e la modalità di copia di tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull’impostazione `tui`. Potete anche passare con `/tui default`. Non si applica alle sessioni in background aperte dalla visualizzazione degli agenti, che utilizzano sempre il rendering a schermo intero
`CLAUDE_CODE_DISABLE_ARTIFACT`	Imposta su `1` per disabilitare lo strumento Artifact, che pubblica l’output della sessione come pagina web privata su claude.ai. Equivalente all’impostazione `disableArtifact`
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Imposta su `1` per disabilitare l’elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Imposta su `1` per disabilitare la memoria automatica. Imposta su `0` per forzare la memoria automatica anche quando la modalità `--bare` o `autoMemoryEnabled: false` altrimenti la disabiliterebbe. Quando disabilitato, Claude non crea o carica i file di memoria automatica
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Imposta su `1` per disabilitare tutta la funzionalità di attività in background, incluso il parametro `run_in_background` su strumenti Bash e subagent, auto-backgrounding e la scorciatoia Ctrl+B
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Imposta su `1` per saltare il controllo che una risposta di streaming Amazon Bedrock porti il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, una risposta con un content-type diverso fallisce con un errore che nomina quel content-type, il che significa che un gateway o proxy sta trasformando la risposta. Impostatela solo quando il gateway riscrive l’intestazione `Content-Type` ma passa il corpo del flusso di eventi binario invariato; se il corpo stesso è stato trasformato, le richieste falliscono con `Truncated event message received`. Richiede Claude Code v2.1.208 o successivo
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	Imposta su `1` per interrompere i comandi shell in background in esecuzione, i workflow dinamici e, a partire da v2.1.198, i subagent in background di una sessione in background quando il supervisore si ferma, si riavvia o aggiorna il processo di quella sessione, invece di trasferirli al processo successivo della sessione. Influisce solo su quel trasferimento: mettere una sessione in background con `←` o `/background` continua a portare il lavoro in volo, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successivo
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Imposta su `1` per impedire a Claude Code di terminare i comandi shell in background quando il sistema operativo segnala pressione di memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina un shell in background avviato nella sessione principale su un segnale di pressione di memoria una volta che la sessione è stata inattiva per 30 minuti e nessun turno o subagent è in esecuzione. Windows non ha un segnale di pressione di memoria, quindi questa variabile non ha effetto lì. Richiede Claude Code v2.1.193 o successivo
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Imposta su `1` per disabilitare le skill e i workflow che vengono forniti con Claude Code: le skill raggruppate e i workflow vengono rimossi completamente, mentre i comandi slash integrati come `/init` rimangono digitabili ma sono nascosti dal modello. `/doctor` rimane digitabile come i comandi integrati; nascondilo con `DISABLE_DOCTOR_COMMAND`. Le skill dai plugin, `.claude/skills/` e `.claude/commands/` non sono interessate. Equivalente all’impostazione `disableBundledSkills`; `0` non la sostituisce
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Imposta su `1` per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di utente, progetto e memoria automatica
`CLAUDE_CODE_DISABLE_CRON`	Imposta su `1` per disabilitare le attività pianificate. La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse le attività già in esecuzione a metà sessione
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Imposta su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema degli strumenti beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizza questo quando un gateway proxy rifiuta le richieste con errori come “Unexpected value(s) for the `anthropic-beta` header” o “Extra inputs are not permitted”. I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. La ricerca degli strumenti MCP è disabilitata e tutti gli strumenti MCP vengono caricati in primo piano, anche quando `ENABLE_TOOL_SEARCH` è impostato
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Imposta su `1` per disabilitare i subagent Explore e Plan integrati. Claude esplora con i suoi strumenti di ricerca o il subagent di uso generale, e la modalità plan legge i file direttamente piuttosto che lanciare agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent integrato in Agent SDK o modalità non interattiva, utilizza `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successivo
`CLAUDE_CODE_DISABLE_FAST_MODE`	Imposta su `1` per disabilitare la modalità veloce
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Imposta su `1` per disabilitare i sondaggi sulla qualità della sessione “Come sta andando Claude?”. I sondaggi sono anche disabilitati quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non opti di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizzate l’impostazione `feedbackSurveyRate`. Vedi Sondaggi sulla qualità della sessione
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Imposta su `1` per disabilitare il checkpointing dei file. Il comando `/rewind` non sarà in grado di ripristinare le modifiche al codice
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Imposta su `1` per rimuovere le istruzioni di workflow commit e PR integrate e lo snapshot dello stato git dal prompt di sistema di Claude. Utile quando si utilizzano le proprie skill di workflow git. Ha la precedenza sull’impostazione `includeGitInstructions` se impostato
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Imposta su `1` per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull’API Anthropic. Utilizza quando desiderate intenzionalmente fissare un modello più vecchio. Il remapping non viene eseguito su Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
`CLAUDE_CODE_DISABLE_MOUSE`	Imposta su `1` per disabilitare il tracciamento del mouse nel rendering a schermo intero. Lo scorrimento da tastiera con `PgUp` e `PgDn` funziona ancora. Utilizza questo per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Imposta su `1` per disabilitare il clic, il trascinamento e il passaggio del mouse nel rendering a schermo intero mantenendo lo scorrimento della rotella del mouse. Utilizza questo quando desiderate che lo scorrimento della rotella funzioni all’interno di Claude Code ma non desiderate che i clic posizionino il cursore, espandano l’output dello strumento o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando entrambi sono impostati. Richiede Claude Code v2.1.195 o successivo
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Equivalente all’impostazione di `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY`
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Imposta su `1` per disabilitare il fallback non-streaming quando una richiesta di streaming fallisce a metà stream. Gli errori di streaming si propagano al livello di retry. Utile quando un proxy o gateway causa il fallback per produrre l’esecuzione duplicata dello strumento
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Imposta su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre state digitando o siete focalizzati sul terminale. Per impostazione predefinita lo strumento salta sia la notifica desktop che il push mobile quando rileva attività recente della tastiera o focus del terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere il push mobile quando rileva che siete attivi. Richiede Claude Code v2.1.193 o successivo
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Imposta su `1` per saltare l’aggiunta automatica del marketplace ufficiale dei plugin al primo avvio
`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 container o CI che non dovrebbero caricare skill fornite dall’operatore
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Imposta su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. In sessioni Agent SDK e `claude -p`, questo salta anche la richiesta di Haiku in background che genera il titolo della sessione
`CLAUDE_CODE_DISABLE_THINKING`	Imposta su `1` per omettere il parametro `thinking` dalle richieste API interamente. Questa è un’opzione di compatibilità per proxy e gateway che rifiutano il parametro. Il comportamento della variabile è invariato rispetto alle versioni precedenti; sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il thinking esteso sull’API Anthropic, utilizzate `MAX_THINKING_TOKENS=0` invece, che è anche inefficace su Fable 5 poiché non può avere il thinking disattivato. Su provider di terze parti, `0` allo stesso modo omette il parametro, quindi le due variabili si comportano allo stesso modo lì
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Imposta su `1` per disabilitare lo scorrimento virtuale nel rendering a schermo intero e renderizzare ogni messaggio nella trascrizione. Utilizza questo se lo scorrimento in modalità a schermo intero mostra regioni vuote dove dovrebbero apparire i messaggi
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Imposta su `1` per disabilitare 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` o `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `/effort` e sull’impostazione `effortLevel`. Vedi Regola il livello di sforzo
`CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT`	Imposta su `1` per abilitare l’aggiunta di testo extra alla fine del prompt di sistema di ogni subagent. Il flag `--append-subagent-system-prompt` fornisce il testo aggiunto e imposta questa variabile automaticamente, quindi non è necessario impostarla voi stessi. Richiede Claude Code v2.1.205 o successivo
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Accettato per compatibilità con versioni precedenti e non ha effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry e sessioni gateway app Claude con accesso. In v2.1.158 attraverso v2.1.206, l’impostazione di questo su `1` era richiesta per rendere la modalità auto disponibile su quei provider
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Sovrascrivi la disponibilità del riepilogo della sessione. Imposta su `0` per forzare i riepiloghi disattivati indipendentemente dall’interruttore `/config`. Imposta su `1` per forzare i riepiloghi attivati quando `awaySummaryEnabled` è `false`. Ha la precedenza sull’impostazione e sull’interruttore `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Imposta su `1` per aggiornare lo stato del plugin ai confini dei turni in modalità non interattiva dopo il completamento di un’installazione in background. Disattivato per impostazione predefinita perché l’aggiornamento cambia il prompt di sistema a metà sessione, il che invalida il caching dei prompt per quel turno
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Imposta su `1` per instradare il sondaggio sulla qualità della sessione “Come sta andando Claude?” al vostro collettore OpenTelemetry quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro collettore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK` è impostato, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la politica di feedback del prodotto dell’organizzazione hanno la precedenza
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controlla se gli input delle chiamate di strumento vengono trasmessi dall’API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull’API Anthropic. Su Amazon Bedrock e Google Cloud’s Agent Platform, abilitato per modello dove il container distribuito lo supporta. Imposta su `0` per rinunciare. Imposta su `1` per forzare l’abilitazione quando instrada attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Microsoft Foundry e connessioni gateway
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Imposta su `1` per popolare il selettore `/model` dall’endpoint `/v1/models` del vostro gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivato per impostazione predefinita perché i gateway supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati dall’allowlist `availableModels` che la sessione riceve; consegnate l’elenco tramite MDM o un file di impostazioni gestito, poiché la consegna gestita dal server non è disponibile su configurazioni gateway
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Rimosso in v2.1.142, quando il valore predefinito della modalità veloce è passato da Opus 4.6 a Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Imposta su `false` per disabilitare i suggerimenti di prompt (l’interruttore “Prompt suggestions” in `/config`). Questi sono i suggerimenti predetti in grigio che appaiono nel vostro input di prompt dopo che Claude risponde. Vedi Suggerimenti di prompt
`CLAUDE_CODE_ENABLE_TASKS`	Controlla se le sessioni utilizzano gli strumenti Task strutturati (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) o lo strumento legacy `TodoWrite`. A partire da Claude Code v2.1.142, gli strumenti Task sono il valore predefinito in tutte le modalità. Imposta su `0` per tornare a `TodoWrite`. Vedi Elenco attività e Migra agli strumenti Task
`CLAUDE_CODE_ENABLE_TELEMETRY`	Imposta su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Obbligatorio prima di configurare gli esportatori OTel. Vedi Monitoraggio
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tempo in millisecondi da attendere dopo che il loop di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Imposta su `1` per abilitare i team di agenti. I team di agenti sono sperimentali e disabilitati per impostazione predefinita
`CLAUDE_CODE_EXTRA_BODY`	Oggetto JSON da unire al livello superiore di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella vostra shell si applica anche alle sessioni in background che inviate con `claude agents` o `--bg`. Prima di v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e utilizzavano qualsiasi copia il processo supervisore in background ereditava
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Sovrascrivi il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Imposta su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione di `claude agents` anche quando questo `claude` è stato avviato dall’interno di un’altra sessione Claude Code. Utilizza quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione tmux o un launcher in background avviato per la prima volta dallo strumento Bash di Claude Code, causa una sessione di livello superiore genuina a essere classificata erroneamente come annidata. A partire da v2.1.178, Claude Code rileva automaticamente il caso tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Anche onorato su v2.1.169 e versioni precedenti; non ha effetto su v2.1.170 e v2.1.171, dove il rilevamento della sessione annidata che sostituisce è stato rimosso
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Imposta su `1` per forzare il rendering del barrato per `~~text~~` nelle risposte di Claude quando il vostro terminale lo supporta ma non viene rilevato automaticamente, ad esempio su SSH senza `TERM_PROGRAM` inoltrato. Senza questo, i terminali non rilevati mostrano i marcatori letterali `~~` invece di renderizzare il testo come barrato. Richiede Claude Code v2.1.186 o successivo
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	Imposta su `1` per forzare l’abilitazione della modalità privata DEC 2026 synchronized output quando il vostro terminale la supporta ma non viene rilevato automaticamente. Utile per emulatori come Emacs `eat` che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al rendering a schermo intero, questo non cambia il renderer
`CLAUDE_CODE_FORK_SUBAGENT`	Imposta su `1` per consentire a Claude di generare subagent biforcati, o `0` per disabilitarli, sostituendo qualsiasi rollout lato server. Quando abilitato, Claude può richiedere il tipo di subagent `fork` per generare un fork, un subagent che eredita il contesto della conversazione completa invece di iniziare da zero. Gli spawn senza un tipo di subagent utilizzano comunque il subagent di uso generale, e tutti gli spawn di subagent vengono eseguiti in background. Il comando esplicito `/fork` funziona senza questa variabile. Funziona in modalità interattiva e tramite SDK o `claude -p`
`CLAUDE_CODE_GIT_BASH_PATH`	Solo Windows: percorso dell’eseguibile Git Bash (`bash.exe`). Utilizza quando Git Bash è installato ma non nel vostro PATH. Vedi Configurazione di Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Imposta su `false` per escludere i dotfile dai risultati quando Claude richiama lo strumento Glob. Incluso per impostazione predefinita. Non influisce su `@` file autocomplete, `ls`, Grep o Read
`CLAUDE_CODE_GLOB_NO_IGNORE`	Imposta su `false` per fare in modo che lo strumento Glob rispetti i modelli `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su `@` file autocomplete, che ha la sua propria impostazione `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Timeout in secondi per la scoperta dei file dello strumento Glob. Per impostazione predefinita 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL
`CLAUDE_CODE_HIDE_CWD`	Imposta su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni in cui il percorso espone il vostro nome utente del sistema operativo
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Sovrascrivi l’indirizzo host utilizzato per connettersi all’estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l’indirizzo corretto, incluso il routing WSL-to-Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Imposta su `1` per saltare l’installazione automatica delle estensioni IDE. Equivalente all’impostazione di `autoInstallIdeExtension` su `false`
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Imposta su `1` per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizza quando l’auto-connessione non riesce a trovare il vostro IDE nonostante sia in esecuzione
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Sovrascrivi la dimensione della finestra del contesto che Claude Code assume per il modello attivo. A partire da v2.1.193, applicato direttamente per i nomi di modelli che Claude Code non riconosce come modello Claude; per i modelli Claude riconosciuti ha effetto solo quando `DISABLE_COMPACT` è anche impostato. Utilizza questo quando instrada a un modello attraverso `ANTHROPIC_BASE_URL` la cui finestra del contesto non corrisponde alla dimensione integrata per il suo nome
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e massimi variano in base al modello; vedi max output tokens. L’aumento di questo valore riduce la finestra del contesto effettiva disponibile prima che venga attivata la compattazione automatica
`CLAUDE_CODE_MAX_RETRIES`	Sovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10). Limitato a 15 a partire da v2.1.186; a partire da v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Per sessioni non presidiate che devono attendere attraverso interruzioni più lunghe, imposta `CLAUDE_CODE_RETRY_WATCHDOG`
`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. Equivalente a passare `--max-turns`, che ha la precedenza quando entrambi sono impostati. Un valore che non è un intero positivo viene rifiutato all’avvio con un errore piuttosto che trattato come nessun limite
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Imposta su `1` per generare server MCP stdio con solo un ambiente di base sicuro più il `env` configurato del server, invece di ereditare l’ambiente della vostra shell
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Timeout di inattività in millisecondi per le chiamate di strumento MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o connettore claude.ai non invia risposta e nessuna notifica di progresso per questo tempo, la chiamata dello strumento si interrompe con un errore invece di attendere il `MCP_TOOL_TIMEOUT` complessivo. Sostituisce i valori predefiniti per trasporto di 300000 (5 minuti) per server di rete e 1800000 (30 minuti) per server stdio. Imposta su `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono aumentati a un secondo, e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 aumenta la finestra di inattività di quel server ad almeno il valore `timeout`. Non si applica ai server IDE o SDK in-process. Richiede Claude Code v2.1.187 o successivo. Prima di v2.1.203, i server stdio erano esenti dal timeout di inattività
`CLAUDE_CODE_NATIVE_CURSOR`	Imposta su `1` per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e focus del terminale
`CLAUDE_CODE_NEW_INIT`	Imposta su `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare la base di codice e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere
`CLAUDE_CODE_NO_FLICKER`	Imposta su `1` per abilitare il rendering a schermo intero, un’anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Equivalente all’impostazione `tui`; potete anche passare con `/tui fullscreen`
`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`	Token di aggiornamento OAuth per l’autenticazione Claude.ai. Se impostato, `claude auth login` scambia questo token direttamente invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell’autenticazione in ambienti automatizzati
`CLAUDE_CODE_OAUTH_SCOPES`	Ambiti OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatorio quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostato
`CLAUDE_CODE_OAUTH_TOKEN`	Token di accesso OAuth per l’autenticazione Claude.ai. Alternativa a `/login` per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali archiviate nel portachiavi. Generatene uno con `claude setup-token`
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Rimosso in v2.1.160 e ora un no-op. In precedenza fissava la modalità veloce a Claude Opus 4.6 invece del valore predefinito corrente. Opus 4.6 non supporta più la modalità veloce
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Imposta su `1` per scrivere gli errori diagnostici dell’esportatore OpenTelemetry su stderr. Per impostazione predefinita questi errori appaiono solo con `--debug`, quindi un esportatore non configurato correttamente come una collisione di porta Prometheus altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successivo. Vedi Monitoraggio
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Timeout in millisecondi per lo scaricamento dei span OpenTelemetry in sospeso (predefinito: 5000). Vedi Monitoraggio
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervallo per l’aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedi Intestazioni dinamiche
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Timeout in millisecondi per l’esportatore OpenTelemetry per terminare all’arresto (predefinito: 2000). Aumentate se le metriche vengono eliminate all’uscita. Vedi Monitoraggio
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Imposta su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando una nuova versione è disponibile. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedi Aggiornamenti automatici
`CLAUDE_CODE_PERFORCE_MODE`	Imposta su `1` per abilitare la protezione da scrittura consapevole di Perforce. Se impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca del bit di scrittura del proprietario, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Sovrascrivi la directory radice dei plugin. Nonostante il nome, questo imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory sotto questo percorso. Per impostazione predefinita `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Timeout in millisecondi per le operazioni git durante l’installazione o l’aggiornamento dei plugin (predefinito: 120000). Aumentate questo valore per repository di grandi dimensioni o connessioni di rete lente. Vedi Le operazioni Git scadono
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Imposta su `1` per mantenere la cache del marketplace esistente quando un `git pull` fallisce invece di cancellare e ri-clonare. Utile in ambienti offline o airgapped dove il ri-cloning fallirebbe allo stesso modo. Vedi Gli aggiornamenti del marketplace falliscono in ambienti offline
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Imposta su `1` per clonare le fonti plugin GitHub `owner/repo` su HTTPS invece di SSH. Si applica all’installazione e all’aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com`
`CLAUDE_CODE_PLUGIN_SEED_DIR`	Percorso di una o più directory di seed plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizza questo per raggruppare una directory plugin pre-popolata in un’immagine container. Claude Code registra i marketplace da queste directory all’avvio e utilizza i plugin pre-memorizzati nella cache senza ri-clonare. Vedi Pre-popola i plugin per i container
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Imposta su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumento, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite con Restricted. Il bypass a livello di processo non sostituisce mai la Politica di gruppo `MachinePolicy` o `UserPolicy` indipendentemente da questa impostazione
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Tempo massimo in millisecondi che la modalità non interattiva con il flag `-p` attende dopo il turno finale per i subagent in background e i workflow il cui risultato fa parte dell’output. Predefinito: `600000`, o 10 minuti. Quando il limite viene superato, i subagent in background rimanenti vengono terminati e il processo esce. Imposta su `0` per attendere indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica ai semplici shell in background
`CLAUDE_CODE_PROCESS_WRAPPER`	Avvia i processi che Claude Code avvia dal suo binario attraverso un wrapper eseguibile, dato come prefisso argv come `/opt/corp/launcher`. Copre il servizio in background che ospita le sessioni agent view, ogni sessione che genera, e il riavvio che Claude Code esegue di se stesso per finire di installare un aggiornamento. Il primo token deve essere il percorso assoluto di un eseguibile che termina eseguendo `exec "$@"`, e la maggior parte dei launcher è quel singolo percorso. Il valore è un elenco di argomenti, non un comando di shell: lo spazio separa i token, le virgolette doppie raggruppano un percorso che contiene spazi, e un valore che inizia con `[` viene letto come un array di stringhe JSON. Impostatelo nel blocco `env` delle impostazioni utente o gestite, non come esportazione di shell, in modo che il servizio in background staccato lo erediti; le impostazioni di progetto e locali non possono impostarlo. Il wrapper dell’estensione VS Code configura il suo launcher separatamente attraverso la sua impostazione `claudeProcessWrapper`. Ignorato su Windows. `CLAUDE_CODE_SHELL_PREFIX` è un controllo separato: avvolge i comandi shell che Claude Code esegue come una singola stringa quoted, mentre questa variabile avvolge i processi di Claude Code stesso come prefisso argv. Vedi Esegui Claude Code dietro un launcher aziendale
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Imposta su `1` per propagare il contesto di traccia W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l’intestazione `traceparent` su richieste di modello e MCP HTTP e la variabile d’ambiente `TRACEPARENT` per sottoprocessi Bash, PowerShell e hook. Per impostazione predefinita, la propagazione è abilitata solo quando connessi direttamente all’API Anthropic. Aggiunto in v2.1.152. Vedi Tracce (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Impostato da piattaforme host che incorporano Claude Code e gestiscono l’instradamento del provider di modelli per suo conto. Se impostato, la selezione del provider, l’endpoint e le variabili di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni vengono ignorate in modo che le impostazioni dell’utente non possono sovrascrivere l’instradamento dell’host. Anche l’opt-out automatico della telemetria per Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry viene saltato, quindi la telemetria segue l’opt-out standard `DISABLE_TELEMETRY`. Vedi Comportamenti predefiniti per provider API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Imposta su `1` per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per ambienti in cui il proxy deve gestire la risoluzione del nome host
`CLAUDE_CODE_REMOTE`	Impostato automaticamente su `true` quando Claude Code è in esecuzione come una sessione cloud. Leggete questo da un hook o script di configurazione per rilevare se siete in un ambiente cloud
`CLAUDE_CODE_REMOTE_SESSION_ID`	Impostato automaticamente nelle sessioni cloud all’ID della sessione corrente. Leggete questo per costruire un collegamento alla trascrizione della sessione. Vedi Collegare l’output alla sessione
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Imposta su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all’SDK di reinviare il prompt
`CLAUDE_CODE_RESUME_PROMPT`	Sovrascrivi il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Per impostazione predefinita `Continue from where you left off.`. Gli script di spawn per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il valore predefinito
`CLAUDE_CODE_RETRY_WATCHDOG`	Imposta su `1` per sessioni non presidiate come harness di valutazione, lavori CI o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Il watchdog si ritira fino a 5 minuti tra i tentativi, o fino a quando il limite si ripristina quando la risposta porta un tempo di ripristino del limite di velocità, quindi una sessione che raggiunge un limite di utilizzo attende la finestra rimanente. A partire da v2.1.199 aumenta anche il conteggio dei retry predefiniti per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backoff, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se impostate esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successivo
`CLAUDE_CODE_SAFE_MODE`	Imposta su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi hook, linea di stato e comandi dei suggerimenti di file configurati dalla politica; plugin gestiti, skill gestite, CLAUDE.md gestito e server MCP configurati dalla politica non lo fanno. Equivalente a passare `--safe-mode`. I processi figlio direttamente generati ereditano la variabile
`CLAUDE_CODE_SCRIPT_CAPS`	Oggetto JSON che limita quante volte script specifici possono essere richiamati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di chiamate intere. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L’abbinamento è basato su sottostringhe quindi trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contano comunque rispetto al limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità
`CLAUDE_CODE_SCROLL_SPEED`	Imposta il moltiplicatore di scorrimento della rotella del mouse nel rendering a schermo intero. Accetta valori da 1 a 20 e valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato del trackpad e della rotella nei terminali che già amplificano gli eventi della rotella. Imposta su `3` per corrispondere a `vim` se il vostro terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Sovrascrivi il budget di tempo in millisecondi per gli hook SessionEnd. Si applica all’uscita della sessione, `/clear` e al cambio di sessioni tramite `/resume` interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al massimo `timeout` per hook configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget
`CLAUDE_CODE_SESSION_ID`	Impostato automaticamente nei sottoprocessi dello strumento Bash e PowerShell all’ID della sessione corrente, nei sottoprocessi del comando hook e nei sottoprocessi del server MCP stdio. Per Bash, PowerShell e hook questo corrisponde al campo `session_id` nell’input JSON dell’hook e viene aggiornato su `/clear`. Un sottoprocesso del server MCP mantiene l’ID con cui è stato generato. Su `--resume <session-id>` riceve l’ID ripreso, corrispondente a hook e Bash. Su `--continue` o `--resume` senza un ID esplicito potrebbe ricevere l’ID di avvio iniziale. Utilizza per correlare script e strumenti esterni con la sessione Claude Code che li ha avviati
`CLAUDE_CODE_SHELL`	Imposta la shell che Claude Code utilizza per eseguire i comandi dello strumento Bash. Accetta un percorso a un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e torna all’auto-rilevamento. L’auto-rilevamento utilizza il vostro `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` funzionante quindi `bash` trovato nel vostro `PATH` e nei percorsi di installazione standard
`CLAUDE_CODE_SHELL_PREFIX`	Prefisso del comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi hook, comandi della linea di stato e comandi di avvio del server MCP stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per logging o auditing. L’impostazione di un percorso eseguibile nudo come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come un singolo argomento shell-quoted in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un percorso eseguibile nudo interrompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate dello strumento Bash, `$1` contiene l’invocazione della shell completa che Claude Code assembla, inclusa la configurazione dell’ambiente, non solo il comando che Claude ha eseguito
`CLAUDE_CODE_SIMPLE`	Imposta su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura file e modifica file. Gli strumenti MCP da `--mcp-config` sono ancora disponibili. Disabilita l’auto-discovery di hook, skill, plugin, server MCP, memoria automatica e CLAUDE.md. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l’autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivalente a passare `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Imposta su `1` per utilizzare il prompt di sistema minimo e le descrizioni degli strumenti compresse su qualsiasi modello. Imposta su `0`, `false`, `no` o `off` per rinunciare anche su modelli dove l’esperimento o la configurazione del server altrimenti lo abiliterebbero. Il set di strumenti completo, hook, server MCP e scoperta CLAUDE.md rimangono abilitati
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Salta l’autenticazione lato client per Claude Platform on AWS, per gateway che firmano le richieste stessi
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	Imposta su `1` per disattivare la cache in-process delle credenziali risolte dalla catena del provider di credenziali predefinito AWS, in modo che Claude Code risolva la catena su ogni richiesta API. Con la cache disattivata, un profilo supportato da SSO richiede credenziali da IAM Identity Center su ogni richiesta. Vedi credential caching and resolution timeout. Richiede Claude Code v2.1.207 o successivo
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Salta l’autenticazione AWS per Amazon Bedrock (ad esempio, quando si utilizza un gateway LLM)
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Salta l’autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inietta la propria intestazione `Authorization`. Claude Code invia richieste senza una credenziale Azure e preserva l’intestazione `Authorization` che fornite, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorato quando `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN` è impostato. Prima di v2.1.203, questa variabile lasciava il client Microsoft Foundry incapace di inviare richieste a meno che una chiave API non fosse anche impostata
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Salta l’autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM)
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	Imposta su `1` per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in `--resume`, `--continue` o nella cronologia della freccia su. Utile per sessioni di script effimere
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Salta l’autenticazione Google per Google Cloud’s Agent Platform (ad esempio, quando si utilizza un gateway LLM)
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Numero massimo di volte consecutive che un hook Stop o SubagentStop può bloccare il turno dal terminare prima che Claude Code lo sostituisca e termini il turno comunque (predefinito: 8). Imposta su `0` per disabilitare il limite. Aumentate questo se il vostro hook ha legittimamente bisogno di più iterazioni per risolvere
`CLAUDE_CODE_SUBAGENT_MODEL`	Vedi Configurazione del modello. A partire da v2.1.196, l’impostazione su `inherit` è la stessa di lasciarla non impostata; le versioni precedenti trattavano `inherit` come un override che forzava ogni subagent sul modello della conversazione principale
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Imposta su `1` per rimuovere le credenziali Anthropic e del provider cloud dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio). Il processo Claude padre mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l’esposizione agli attacchi di prompt injection che tentano di esfiltare i segreti tramite l’espansione della shell. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi PID isolato in modo che non possano leggere gli ambienti dei processi host tramite `/proc`; come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere o segnalare i processi host. `claude-code-action` imposta questo automaticamente quando `allowed_non_write_users` è configurato
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Imposta su `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell’installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combina con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l’attesa
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`	Timeout in millisecondi per l’installazione sincrona del plugin. Se superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l’installazione sincrona attende fino al completamento
`CLAUDE_CODE_SYNC_SKILLS`	Imposta su `1` per scaricare le vostre skill abilitate di claude.ai in `~/.claude/skills/` prima della prima query e risincronizzare ogni 10 minuti. Si applica solo in modalità non interattiva con il flag `-p`. Richiede l’autenticazione di claude.ai. Le sessioni Claude Code on the web ricevono le vostre skill abilitate di claude.ai automaticamente; non è necessario impostare questo lì
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Timeout in millisecondi per una risincronizzazione delle skill a metà sessione quando `CLAUDE_CODE_SYNC_SKILLS` è impostato (predefinito: 30000). Limita il download attivato quando l’host richiede un ricaricamento delle skill durante la sessione. Se superato, la risincronizzazione si ferma e i download delle skill rimanenti continuano in background
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Timeout in millisecondi per la prima query da attendere sulla sincronizzazione iniziale delle skill quando `CLAUDE_CODE_SYNC_SKILLS` è impostato (predefinito: 5000). Se superato, la query procede e i download delle skill rimanenti continuano in background
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Imposta su `false` per disabilitare l’evidenziazione della sintassi nell’output diff. Utile quando i colori interferiscono con la configurazione del vostro terminale. Per disabilitare anche l’evidenziazione nei blocchi di codice e nelle anteprime di file, utilizzate l’impostazione `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Condividi un elenco di attività tra le sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso. Vedi Elenco attività
`CLAUDE_CODE_TEAM_NAME`	Nome del team di agenti a cui appartiene questo compagno di squadra. Impostato automaticamente sui membri del team di agenti
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Sovrascrivi, in millisecondi, quanto tempo una sessione non interattiva attende all’uscita affinché il suo team di agenti finisca di smontarsi. Accetta 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il valore predefinito di 10000. Richiede Claude Code v2.1.206 o successivo
`CLAUDE_CODE_TMPDIR`	Sovrascrivi la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` su Unix o `/claude/` su Windows a questo percorso. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. A partire da v2.1.161, su macOS e Linux, i sottoprocessi Bash sandboxed ricevono un fallback `$TMPDIR` breve sotto il valore predefinito del sistema quando il vostro override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non sandboxed ereditano il vostro `$TMPDIR` della shell invariato. I file temporanei di Claude Code stesso utilizzano sempre il vostro override
`CLAUDE_CODE_TMUX_TRUECOLOR`	Imposta su `1` per consentire l’output truecolor a 24 bit all’interno di tmux. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato per farlo. Imposta questo dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al vostro `~/.tmux.conf`. Vedi Configurazione del terminale per altre impostazioni di tmux
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Utilizza Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Utilizza Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Utilizza Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Utilizza l’endpoint Mantle di Amazon Bedrock
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	Imposta su `1` per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Imposta questo se il binario ripgrep raggruppato non è disponibile o bloccato nel vostro ambiente. Non influisce su Grep o strumenti di ricerca file
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta su `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è in rollout progressivo: imposta su `1` per aderire o `0` per rinunciare. Su Linux, macOS e WSL, imposta su `1` per abilitarlo, che richiede `pwsh` nel vostro `PATH`. Se abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedi Strumento PowerShell
`CLAUDE_CODE_USE_VERTEX`	Utilizza Google Cloud’s Agent Platform
`CLAUDE_CONFIG_DIR`	Sovrascrivi la directory di configurazione (predefinito: `~/.claude`). Tutte le impostazioni, la cronologia della sessione e i plugin sono archiviati sotto questo percorso, così come le credenziali su Linux e Windows; su macOS, le credenziali sono nel Keychain di sistema. Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`
`CLAUDE_DISABLE_ADOPT`	Imposta su `1` per interrompere il lavoro in volo in background invece di portarlo quando mettete una sessione in background premendo `←` o con `/background`. Claude Code vi chiede di confermare prima di mettere in background, quindi interrompe le attività che altrimenti verrebbero portate. Richiede Claude Code v2.1.195 o successivo
`CLAUDE_EFFORT`	Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al livello di sforzo attivo per il turno: `low`, `medium`, `high`, `xhigh` o `max`. Ultracode non è un livello distinto e riporta come `xhigh`. Corrisponde al campo `effort.level` passato agli hook. Impostato solo quando il modello corrente supporta il parametro effort
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Imposta su `1` per forzare l’abilitazione del watchdog di inattività a livello di byte, o imposta su `0` per forzare la disabilitazione. Se non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic dirette e Claude Platform on AWS. Il byte watchdog interrompe una connessione quando nessun byte arriva sul filo per 180 secondi per impostazione predefinita su connessioni API Anthropic dirette, 300 secondi su Claude Platform on AWS e quando abilitato su Amazon Bedrock, o per il valore di `CLAUDE_STREAM_IDLE_TIMEOUT_MS` quando è impostato, che è limitato a un minimo di 5 minuti, indipendente dal watchdog a livello di evento
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Imposta su `1` per abilitare il watchdog di inattività a livello di byte su risposte Amazon Bedrock `vnd.amazon.eventstream`. Disattivato per impostazione predefinita. Configurate il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Imposta su `0` per forzare la disabilitazione del watchdog di inattività dello streaming a livello di evento, o imposta su `1` per forzare l’abilitazione. Se non impostato, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima di v2.1.196, il valore predefinito non impostato era controllato dal server sull’API Anthropic diretta e disattivato su altri provider. A partire da v2.1.169, i provider diversi dall’API Anthropic diretta e da Claude Platform on AWS hanno anche un timeout di inattività del corpo di 5 minuti predefinito indipendente da questa variabile; vedi `API_FORCE_IDLE_TIMEOUT`. Su Amazon Bedrock, potete anche abilitare il watchdog indipendente a livello di byte con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; i due vengono eseguiti insieme quando entrambi sono impostati. Configurate il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENV_FILE`	Percorso di uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizza per persistere l’attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente dagli hook SessionStart, Setup, CwdChanged e FileChanged
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefisso per i nomi delle sessioni Remote Control generati automaticamente quando non viene fornito un nome esplicito. Per impostazione predefinita il nome host della vostra macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Timeout in millisecondi prima che il watchdog di inattività dello streaming chiuda una connessione bloccata. Quando impostate questa variabile esplicitamente, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente limitati per assorbire le pause di thinking esteso e il buffering del proxy. Se non impostato, il watchdog a livello di evento per impostazione predefinita è 300 secondi e il watchdog a livello di byte per impostazione predefinita è 180 secondi su connessioni API Anthropic dirette (300 secondi su Claude Platform on AWS e altri provider). Il valore predefinito di 180 secondi del byte-watchdog non impostato è un valore separato e non è soggetto al limite di 5 minuti. Il timeout di inattività del corpo descritto in `API_FORCE_IDLE_TIMEOUT` si applica indipendentemente. Su Amazon Bedrock, si applica anche quando `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`
`DEBUG`	Imposta su `1` per abilitare la modalità debug, equivalente al lancio con `--debug`. I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, o nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori truthy `1`, `true`, `yes` e `on` abilitano la modalità debug, quindi i modelli di namespace come `DEBUG=express:*` impostati per altri strumenti non lo attivano
`DISABLE_AUTOUPDATER`	Imposta su `1` per disabilitare gli aggiornamenti automatici in background. Il manuale `claude update` funziona ancora. Utilizza `DISABLE_UPDATES` per bloccare entrambi
`DISABLE_AUTO_COMPACT`	Imposta su `1` per disabilitare la compattazione automatica quando ci si avvicina al limite del contesto. Il comando manuale `/compact` rimane disponibile. Utilizza quando desiderate un controllo esplicito su quando si verifica la compattazione
`DISABLE_COMPACT`	Imposta su `1` per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale `/compact`
`DISABLE_COST_WARNINGS`	Imposta su `1` per disabilitare i messaggi di avviso sui costi
`DISABLE_DOCTOR_COMMAND`	Imposta su `1` per nascondere il comando `/doctor`. Utile per distribuzioni gestite in cui gli utenti non dovrebbero eseguire diagnostiche di installazione
`DISABLE_ERROR_REPORTING`	Imposta su `1` per rinunciare alla segnalazione degli errori
`DISABLE_EXTRA_USAGE_COMMAND`	Imposta su `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità
`DISABLE_FEEDBACK_COMMAND`	Imposta su `1` per disabilitare il comando `/feedback`. Il nome più vecchio `DISABLE_BUG_COMMAND` è anche accettato
`DISABLE_GROWTHBOOK`	Imposta su `1` per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i valori predefiniti del codice per ogni flag. La registrazione degli eventi di telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato
`DISABLE_INSTALLATION_CHECKS`	Imposta su `1` per disabilitare gli avvisi di installazione. Utilizza solo quando gestite manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Imposta su `1` per nascondere il comando `/install-github-app`. Già nascosto quando si utilizzano provider di terze parti (Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry)
`DISABLE_INTERLEAVED_THINKING`	Imposta su `1` per impedire l’invio dell’intestazione beta interleaved-thinking. Utile quando il vostro gateway LLM o provider non supporta il thinking interleaved
`DISABLE_LOGIN_COMMAND`	Imposta su `1` per nascondere il comando `/login`. Utile quando l’autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper`
`DISABLE_LOGOUT_COMMAND`	Imposta su `1` per nascondere il comando `/logout`
`DISABLE_PROMPT_CACHING`	Imposta su `1` per disabilitare il caching dei prompt per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello)
`DISABLE_PROMPT_CACHING_FABLE`	Imposta su `1` per disabilitare il caching dei prompt per i modelli Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Imposta su `1` per disabilitare il caching dei prompt per i modelli Haiku
`DISABLE_PROMPT_CACHING_OPUS`	Imposta su `1` per disabilitare il caching dei prompt per i modelli Opus
`DISABLE_PROMPT_CACHING_SONNET`	Imposta su `1` per disabilitare il caching dei prompt per i modelli Sonnet
`DISABLE_TELEMETRY`	Imposta su `1` per rinunciare alla telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità con lo stesso effetto di `DISABLE_GROWTHBOOK`, quindi alcune funzionalità ancora in rollout potrebbero non essere disponibili
`DISABLE_UPDATES`	Imposta su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizza quando distribuite Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornarsi
`DISABLE_UPGRADE_COMMAND`	Imposta su `1` per nascondere il comando `/upgrade`
`DO_NOT_TRACK`	Imposta su `1` per rinunciare alla telemetria. Equivalente all’impostazione di `DISABLE_TELEMETRY`. Claude Code onora questa come la convenzione standard tra strumenti riconosciuta da molti CLI per sviluppatori
`ENABLE_CLAUDEAI_MCP_SERVERS`	Imposta su `false` per disabilitare i server MCP claude.ai in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi. Per disabilitare per progetto o per organizzazione, imposta `disableClaudeAiConnectors` nelle impostazioni
`ENABLE_PROMPT_CACHING_1H`	Imposta su `1` per richiedere un TTL della cache dei prompt di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di chiave API, Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry e Claude Platform on AWS. Gli utenti di abbonamento ricevono automaticamente il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più elevata
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Deprecato. Utilizza `ENABLE_PROMPT_CACHING_1H` invece
`ENABLE_TOOL_SEARCH`	Controlla la ricerca degli strumenti MCP. Non impostato: tutti gli strumenti MCP differiti per impostazione predefinita, ma caricati in primo piano su Google Cloud’s Agent Platform o quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte. Valori: `true` (sempre differire e inviare l’intestazione beta, le richieste falliscono su modelli Google Cloud’s Agent Platform precedenti a Sonnet 4.5 o Opus 4.5, o su proxy che non supportano `tool_reference`), `auto` (modalità soglia: carica in primo piano se gli strumenti si adattano entro il 10% del contesto), `auto:N` (soglia personalizzata, ad es. `auto:5` per il 5%), `false` (carica tutto in primo piano). Ignorato quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` è impostato, che forza tutti gli strumenti a caricarsi in primo piano
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Imposta su qualsiasi valore non vuoto per fare in modo che tutti i modelli, non solo Opus, smettano di riprovare con un errore di sovraccarico ripetuto quando nessun modello di fallback è configurato. A partire da v2.1.160, una catena di modelli di fallback configurata si attiva su errori di sovraccarico ripetuti per qualsiasi modello primario, quindi questa variabile non influisce sul passaggio a un modello di fallback
`FORCE_AUTOUPDATE_PLUGINS`	Imposta su `1` per forzare gli aggiornamenti automatici dei plugin anche quando l’auto-updater principale è disabilitato tramite `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Imposta su `1` per abilitare i hyperlink OSC 8 cliccabili quando il vostro terminale li supporta ma non viene rilevato automaticamente, o `0` per disabilitarli
`FORCE_PROMPT_CACHING_5M`	Imposta su `1` per forzare il TTL della cache dei prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce `ENABLE_PROMPT_CACHING_1H`
`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 su `1` per abilitare la modalità demo: nasconde la vostra email e il nome dell’organizzazione dall’intestazione e dall’output `/status`, e salta l’onboarding. Utile quando si trasmette in streaming o si registra una sessione
`MAX_MCP_OUTPUT_TOKENS`	Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l’output supera 10.000 token. Gli strumenti che dichiarano `anthropic/maxResultSizeChars` utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell’immagine da questi strumenti è ancora soggetto a questa variabile (predefinito: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Numero di volte per riprovare quando la risposta del modello non supera la convalida rispetto a `--json-schema` in modalità non interattiva (il flag `-p`). Per impostazione predefinita 5
`MAX_THINKING_TOKENS`	Sovrascrivi il budget del token di extended thinking. Il massimale è il max output tokens del modello meno uno. Imposta su `0` per disabilitare il thinking sull’API Anthropic tranne su Fable 5, che non può avere il thinking disattivato. Su provider di terze parti, `0` allo stesso modo omette il parametro `thinking`, e i modelli con ragionamento adattivo potrebbero comunque pensare. Per valori diversi da zero su modelli di ragionamento adattivo, il budget viene ignorato a meno che il ragionamento adattivo non sia disabilitato tramite `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`
`MCP_CLIENT_SECRET`	Segreto client OAuth per i server MCP che richiedono credenziali preconfigurate. Evita il prompt interattivo quando si aggiunge un server con `--client-secret`
`MCP_CONNECTION_NONBLOCKING`	Controlla se l’avvio attende che i server MCP si connettano prima della prima query. A partire da Claude Code v2.1.142, l’avvio MCP è non-bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Imposta su `0` per ripristinare l’attesa di connessione bloccante di 5 secondi. I server configurati con `alwaysLoad: true` bloccano comunque l’avvio indipendentemente, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt
`MCP_CONNECT_TIMEOUT_MS`	Quanto tempo l’avvio bloccante attende, in millisecondi, per il batch di connessione prima di acquisire uno snapshot dell’elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati `alwaysLoad: true`. I server ancora in sospeso alla scadenza continuano a connettersi in background ma non appariranno fino alla query successiva. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server
`MCP_OAUTH_CALLBACK_PORT`	Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando si aggiunge un server MCP con credenziali preconfigurate
`MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE`	Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l’avvio (predefinito: 20)
`MCP_SERVER_CONNECTION_BATCH_SIZE`	Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l’avvio (predefinito: 3)
`MCP_TIMEOUT`	Timeout in millisecondi per l’avvio del server MCP (predefinito: 30000, o 30 secondi)
`MCP_TOOL_TIMEOUT`	Timeout in millisecondi per l’esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade anche dopo 60 secondi per impostazione predefinita; impostate questa variabile, o il `timeout` per server, sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout complessivo di esecuzione dello strumento ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sostituisce questo per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra di inattività minima per le chiamate di strumento di quel server, quindi `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompe mai prima; questo floor richiede Claude Code v2.1.203 o successivo. Per la variabile env, i valori inferiori a 1000 vengono arrotondati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati
`NO_PROXY`	Elenco di domini e IP a cui le richieste verranno emesse direttamente, bypassando il proxy
`OTEL_LOG_ASSISTANT_RESPONSES`	Imposta su `1` per includere il testo della risposta del modello su eventi di log OpenTelemetry `assistant_response`. Se non impostato, viene utilizzato il valore di `OTEL_LOG_USER_PROMPTS`. Imposta su `0` per mantenere le risposte redatte anche quando `OTEL_LOG_USER_PROMPTS` è impostato. Richiede Claude Code v2.1.193 o successivo. Vedi Monitoraggio
`OTEL_LOG_RAW_API_BODIES`	Emetti il JSON della richiesta e della risposta dell’API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Imposta su `1` per i corpi inline troncati a 60 KB, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref` invece. Disabilitato per impostazione predefinita; i corpi includono l’intera cronologia della conversazione. Vedi Monitoraggio
`OTEL_LOG_TOOL_CONTENT`	Imposta su `1` per includere il contenuto di input e output dello strumento negli eventi span OpenTelemetry. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedi Monitoraggio
`OTEL_LOG_TOOL_DETAILS`	Imposta su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, i nomi dei workflow creati dall’utente, le stringhe di errore non elaborate sui fallimenti degli strumenti, la categoria di rifiuto su eventi `api_refusal` e altri dettagli degli strumenti nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le informazioni personali. Vedi Monitoraggio
`OTEL_LOG_USER_PROMPTS`	Imposta su `1` per includere il testo del prompt dell’utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedi Monitoraggio
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Imposta su `false` per escludere l’UUID dell’account dagli attributi delle metriche (predefinito: incluso). Vedi Monitoraggio
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Imposta su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto in v2.1.152. Vedi Monitoraggio
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partire da v2.1.161, Claude Code allega le chiavi `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei punti dati delle metriche. Imposta su `false` per escluderle (predefinito: incluse). Vedi Monitoraggio
`OTEL_METRICS_INCLUDE_SESSION_ID`	Imposta su `false` per escludere l’ID della sessione dagli attributi delle metriche (predefinito: incluso). Vedi Monitoraggio
`OTEL_METRICS_INCLUDE_VERSION`	Imposta su `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Vedi Monitoraggio
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Sovrascrivi il budget dei caratteri per i metadati della skill mostrati allo strumento Skill. Il budget si ridimensiona dinamicamente all’1% della finestra del contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per la compatibilità all’indietro
`TASK_MAX_OUTPUT_LENGTH`	Numero massimo di caratteri nell’output del subagent prima del troncamento (predefinito: 32000, massimo: 160000). Se troncato, l’output completo viene salvato su disco e il percorso è incluso nella risposta troncata
`USE_BUILTIN_RIPGREP`	Imposta su `0` per utilizzare il `rg` installato dal sistema invece del `rg` incluso con Claude Code
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Sovrascrivi la regione per Claude 3.5 Haiku quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Sovrascrivi la regione per Claude 3.5 Sonnet quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Sovrascrivi la regione per Claude 3.7 Sonnet quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Sovrascrivi la regione per Claude 4.0 Opus quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Sovrascrivi la regione per Claude 4.0 Sonnet quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Sovrascrivi la regione per Claude 4.1 Opus quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Sovrascrivi la regione per Claude Opus 4.5 quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Sovrascrivi la regione per Claude Sonnet 4.5 quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Sovrascrivi la regione per Claude Opus 4.6 quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Sovrascrivi la regione per Claude Sonnet 4.6 quando si utilizza Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Sovrascrivi la regione per Claude Opus 4.7 quando si utilizza Google Cloud’s Agent Platform. Aggiunto in v2.1.111
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Sovrascrivi la regione per Claude Opus 4.8 quando si utilizza Google Cloud’s Agent Platform. Aggiunto in v2.1.154
`VERTEX_REGION_CLAUDE_5_SONNET`	Sovrascrivi la regione per Claude Sonnet 5 quando si utilizza Google Cloud’s Agent Platform. Aggiunto in v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Sovrascrivi la regione per Claude Fable 5 quando si utilizza Google Cloud’s Agent Platform. Aggiunto in v2.1.170
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Sovrascrivi la regione per Claude Haiku 4.5 quando si utilizza Google Cloud’s Agent Platform

Sono supportate anche le variabili standard dell’esportatore 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 varianti specifiche del segnale). Vedi Monitoraggio per i dettagli di configurazione.

Vedi anche

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

​Impostare le variabili d’ambiente

​Nella vostra shell

​Nei file di impostazioni

​Precedenza

​Variabili

​Vedi anche