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