Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Impostare le variabili d’ambiente

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

​
Nella vostra shell

Impostate la variabile prima di avviare claude: 
export API_TIMEOUT_MS="1200000"
claude
Per impostarla per ogni sessione, aggiungete la riga export a ~/.bashrc, ~/.zshrc o al file di profilo della vostra shell.

​
Nei file di impostazioni

Aggiungete le variabili sotto la chiave env in un file settings.json. Claude Code le legge direttamente dal file all’avvio, quindi hanno effetto indipendentemente da come claude è stato avviato.
~/.claude/settings.json
{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}
Il file che scegliete controlla a chi si applicano le variabili:
FileSi applica a
~/.claude/settings.jsonVoi, in ogni progetto
.claude/settings.jsonTutti coloro che lavorano nel progetto, archiviato nel controllo del codice sorgente
.claude/settings.local.jsonVoi, solo in questo progetto, non archiviato
Impostazioni gestiteTutti nella vostra organizzazione, distribuiti da un amministratore
Vedi File di impostazioni per dove si trova ogni file e Precedenza delle impostazioni per come si combinano quando più di uno imposta la stessa variabile.

​
Precedenza

Quando lo stesso comportamento ha sia una variabile d’ambiente che un campo di impostazioni, la variabile d’ambiente ha la precedenza. Ad esempio, ANTHROPIC_MODEL sostituisce l’impostazione model e CLAUDE_CODE_AUTO_CONNECT_IDE sostituisce autoConnectIde. Il campo di impostazioni si applica quando la variabile d’ambiente non è impostata. Il modo in cui una variabile d’ambiente interagisce con i flag CLI e i comandi in-sessione varia per funzionalità: --model e /model sostituiscono ANTHROPIC_MODEL, mentre CLAUDE_CODE_EFFORT_LEVEL sostituisce /effort. Quando una variabile interagisce con un’altra fonte di configurazione, la sua riga nell’elenco Variabili dichiara la precedenza o si collega alla pagina che la documenta. Claude Code legge le variabili d’ambiente all’avvio, quindi le modifiche hanno effetto la prossima volta che avviate claude.

​
Variabili

VariabileScopo
ANTHROPIC_API_KEYChiave API inviata come intestazione X-Api-Key. Quando impostata, questa chiave viene utilizzata al posto del vostro abbonamento Claude Pro, Max, Team o Enterprise anche se siete connessi. In modalità non interattiva (-p), la chiave viene sempre utilizzata quando presente. In modalità interattiva, vi viene chiesto di approvare la chiave una volta prima che sostituisca il vostro abbonamento. Per utilizzare il vostro abbonamento, eseguite unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKENValore personalizzato per l’intestazione Authorization (il valore che impostate qui sarà preceduto da Bearer )
ANTHROPIC_AWS_API_KEYChiave 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_URLSovrascrivi l’URL dell’endpoint Claude Platform on AWS. Utilizza per regioni personalizzate o quando instrada attraverso un gateway LLM. Per impostazione predefinita https://aws-external-anthropic.{AWS_REGION}.api.aws
ANTHROPIC_AWS_WORKSPACE_IDObbligatorio per Claude Platform on AWS. Inviato su ogni richiesta come intestazione anthropic-workspace-id
ANTHROPIC_BASE_URLSovrascrivi l’endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, la ricerca degli strumenti MCP è disabilitata per impostazione predefinita. Imposta ENABLE_TOOL_SEARCH=true se il vostro proxy inoltra i blocchi tool_reference
ANTHROPIC_BEDROCK_BASE_URLSovrascrivi l’URL dell’endpoint Bedrock. Utilizza per endpoint Bedrock personalizzati o quando instrada attraverso un gateway LLM. Vedi Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URLSovrascrivi l’URL dell’endpoint Bedrock Mantle. Vedi Endpoint Mantle
ANTHROPIC_BEDROCK_SERVICE_TIERBedrock service tier (default, flex o priority). Inviato come intestazione X-Amzn-Bedrock-Service-Tier. Vedi Amazon Bedrock
ANTHROPIC_BETASElenco separato da virgole di valori aggiuntivi dell’intestazione anthropic-beta da includere nelle richieste API. Claude Code invia già le intestazioni beta di cui ha bisogno; utilizza questo per aderire a un beta API Anthropic prima che Claude Code aggiunga il supporto nativo. A differenza del flag --betas, che richiede l’autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione incluso l’abbonamento Claude.ai
ANTHROPIC_CUSTOM_HEADERSIntestazioni personalizzate da aggiungere alle richieste (formato Name: Value, separate da newline per più intestazioni)
ANTHROPIC_CUSTOM_MODEL_OPTIONID del modello da aggiungere come voce personalizzata nel selettore /model. Utilizza questo per rendere selezionabile un modello non standard o specifico del gateway senza sostituire gli alias integrati. Vedi Configurazione del modello
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTIONDescrizione di visualizzazione per la voce del modello personalizzato nel selettore /model. Per impostazione predefinita, Custom model (<model-id>) quando non impostato
ANTHROPIC_CUSTOM_MODEL_OPTION_NAMENome di visualizzazione per la voce del modello personalizzato nel selettore /model. Per impostazione predefinita, l’ID del modello quando non impostato
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIESVedi Configurazione del modello
ANTHROPIC_DEFAULT_HAIKU_MODELVedi Configurazione del modello
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTIONVedi Configurazione del modello
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAMEVedi Configurazione del modello
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIESVedi Configurazione del modello
ANTHROPIC_DEFAULT_OPUS_MODELVedi Configurazione del modello
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTIONVedi Configurazione del modello
ANTHROPIC_DEFAULT_OPUS_MODEL_NAMEVedi Configurazione del modello
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIESVedi Configurazione del modello
ANTHROPIC_DEFAULT_SONNET_MODELVedi Configurazione del modello
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTIONVedi Configurazione del modello
ANTHROPIC_DEFAULT_SONNET_MODEL_NAMEVedi Configurazione del modello
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIESVedi Configurazione del modello
ANTHROPIC_FOUNDRY_API_KEYChiave API per l’autenticazione Microsoft Foundry (vedi Microsoft Foundry)
ANTHROPIC_FOUNDRY_BASE_URLURL base completo per la risorsa Foundry (ad esempio, https://my-resource.services.ai.azure.com/anthropic). Alternativa a ANTHROPIC_FOUNDRY_RESOURCE (vedi Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCENome della risorsa Foundry (ad esempio, my-resource). Obbligatorio se ANTHROPIC_FOUNDRY_BASE_URL non è impostato (vedi Microsoft Foundry)
ANTHROPIC_MODELNome dell’impostazione del modello da utilizzare (vedi Configurazione del modello)
ANTHROPIC_SMALL_FAST_MODEL[DEPRECATO] Nome del modello di classe Haiku per attività in background
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONSovrascrivi la regione AWS per il modello di classe Haiku quando utilizzate Bedrock o Bedrock Mantle. Su Bedrock, questo ha effetto solo quando ANTHROPIC_DEFAULT_HAIKU_MODEL o il deprecato ANTHROPIC_SMALL_FAST_MODEL è anche impostato, poiché Bedrock altrimenti utilizza il modello primario per le attività in background
ANTHROPIC_VERTEX_BASE_URLSovrascrivi l’URL dell’endpoint Vertex AI. Utilizza per endpoint Vertex personalizzati o quando instrada attraverso un gateway LLM. Vedi Google Vertex AI
ANTHROPIC_VERTEX_PROJECT_IDID progetto GCP per le richieste Vertex AI. Sovrascritto da GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT o dal progetto nel vostro file di credenziali GOOGLE_APPLICATION_CREDENTIALS. Vedi Google Vertex AI
ANTHROPIC_WORKSPACE_IDID area di lavoro per la federazione dell’identità del carico di lavoro. Impostate questo quando la vostra regola di federazione è limitata a più di un’area di lavoro in modo che lo scambio di token sappia quale area di lavoro indirizzare
API_TIMEOUT_MSTimeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumentate questo valore quando le richieste scadono su reti lente o quando instradate attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste
AWS_BEARER_TOKEN_BEDROCKChiave API Bedrock per l’autenticazione (vedi Chiavi API Bedrock)
BASH_DEFAULT_TIMEOUT_MSTimeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti)
BASH_MAX_OUTPUT_LENGTHNumero massimo di caratteri negli output bash prima che l’output completo venga salvato in un file e Claude riceva il percorso più un’anteprima breve. Vedi Comportamento dello strumento Bash
BASH_MAX_TIMEOUT_MSTimeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti)
CCR_FORCE_BUNDLEImposta su 1 per forzare claude --remote a raggruppare e caricare il vostro repository locale anche quando l’accesso a GitHub è disponibile
CLAUDECODEImposta su 1 negli ambienti shell che Claude Code genera (strumento Bash, sessioni tmux). Non impostato negli hook o nei comandi della linea di stato. Utilizza per rilevare quando uno script è in esecuzione all’interno di una shell generata da Claude Code
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSImposta su 1 per disabilitare tutti i tipi di subagent integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag -p). Utile per gli utenti SDK che desiderano una lavagna pulita
CLAUDE_AGENT_SDK_MCP_NO_PREFIXImposta su 1 per saltare il prefisso mcp__<server>__ sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSTimeout di stallo in millisecondi per i subagent in background. Predefinito 600000 (10 minuti). Il timer si ripristina su ogni evento di progresso dello streaming; se nessun progresso arriva entro la finestra, il subagent viene interrotto e l’attività viene contrassegnata come non riuscita, mostrando qualsiasi risultato parziale al genitore
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEImposta la percentuale della capacità del contesto (1-100) a cui viene attivata la compattazione automatica. Per impostazione predefinita, la compattazione automatica si attiva a circa il 95% della capacità. Utilizzate valori inferiori come 50 per compattare prima. I valori superiori alla soglia predefinita non hanno effetto. Si applica sia alle conversazioni principali che ai subagent. Questa percentuale si allinea con il campo context_window.used_percentage disponibile nella linea di stato
CLAUDE_AUTO_BACKGROUND_TASKSImposta su 1 per forzare l’abilitazione dello sfondo automatico delle attività di agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l’esecuzione per circa due minuti
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIRRitorna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale
CLAUDE_CODE_ACCESSIBILITYImposta su 1 per mantenere visibile il cursore del terminale nativo e disabilitare l’indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDImposta su 1 per caricare i file di memoria dalle directory specificate con --add-dir. Carica CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md e CLAUDE.local.md. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTImposta su 1 per ridisegnare l’intero schermo su ogni frame nel rendering a schermo intero invece di inviare aggiornamenti incrementali. Utilizza questo se la modalità a schermo intero mostra frammenti di testo stantii o mal posizionati. Claude Code abilita questo automaticamente per le sessioni in background su Windows
CLAUDE_CODE_API_KEY_HELPER_TTL_MSIntervallo in millisecondi a cui le credenziali devono essere aggiornate (quando si utilizza apiKeyHelper)
CLAUDE_CODE_ATTRIBUTION_HEADERImposta su 0 per omettere il blocco di attribuzione (versione client e impronta digitale del prompt) dall’inizio del prompt di sistema. Disabilitarlo migliora i tassi di hit della cache dei prompt quando si instrada attraverso un gateway LLM. Il caching dell’API Anthropic non è interessato
CLAUDE_CODE_AUTO_COMPACT_WINDOWImposta la capacità del contesto in token utilizzata per i calcoli di compattazione automatica. Per impostazione predefinita, la finestra del contesto del modello: 200K per i modelli standard o 1M per i modelli con contesto esteso. Utilizzate un valore inferiore come 500000 su un modello 1M per trattare la finestra come 500K ai fini della compattazione. Il valore è limitato alla finestra del contesto effettiva del modello. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE viene applicato come percentuale di questo valore. L’impostazione di questa variabile disaccoppia la soglia di compattazione dalla used_percentage della linea di stato, che utilizza sempre la finestra del contesto completa del modello
CLAUDE_CODE_AUTO_CONNECT_IDESovrascrivi la connessione IDE automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all’interno del terminale integrato di un IDE supportato. Imposta su false per impedire questo. Imposta su true per forzare un tentativo di connessione quando l’auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale padre. Ha la precedenza sull’impostazione globale autoConnectIde
CLAUDE_CODE_CERT_STOREElenco separato da virgole di fonti di certificati CA per le connessioni TLS. bundled è il set Mozilla CA fornito con Claude Code. system è l’archivio di fiducia del sistema operativo. Per impostazione predefinita è bundled,system
CLAUDE_CODE_CLIENT_CERTPercorso del file del certificato client per l’autenticazione mTLS
CLAUDE_CODE_CLIENT_KEYPercorso del file della chiave privata client per l’autenticazione mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASEPassphrase per CLAUDE_CODE_CLIENT_KEY crittografato (facoltativo)
CLAUDE_CODE_DEBUG_LOGS_DIRSovrascrivi il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede che la modalità debug sia abilitata separatamente tramite --debug, /debug o la variabile d’ambiente DEBUG: l’impostazione di questa variabile da sola non abilita la registrazione. Il flag --debug-file fa entrambi contemporaneamente. Per impostazione predefinita ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVELLivello di log minimo scritto nel file di log di debug. Valori: verbose, debug (predefinito), info, warn, error. Imposta su verbose per includere diagnostica ad alto volume come l’output completo del comando della linea di stato, o aumenta a error per ridurre il rumore
CLAUDE_CODE_DISABLE_1M_CONTEXTImposta su 1 per disabilitare il supporto della finestra del contesto 1M. Se impostato, le varianti del modello 1M non sono disponibili nel selettore di modelli. Utile per ambienti aziendali con requisiti di conformità
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGImposta su 1 per disabilitare il ragionamento adattivo su Opus 4.6 e Sonnet 4.6 e tornare al budget di thinking fisso controllato da MAX_THINKING_TOKENS. Non ha effetto su Opus 4.7, che utilizza sempre il ragionamento adattivo
CLAUDE_CODE_DISABLE_AGENT_VIEWImposta su 1 per disattivare gli agenti in background e la visualizzazione degli agenti: claude agents, --bg, /background e il supervisore su richiesta. Equivalente all’impostazione disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREENImposta su 1 per disabilitare il rendering a schermo intero e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del vostro terminale in modo che Cmd+f e la modalità di copia di tmux funzionino come al solito. Ha la precedenza su CLAUDE_CODE_NO_FLICKER e sull’impostazione tui. Potete anche passare con /tui default
CLAUDE_CODE_DISABLE_ATTACHMENTSImposta su 1 per disabilitare l’elaborazione degli allegati. Le menzioni di file con la sintassi @ vengono inviate come testo semplice invece di essere espanse nel contenuto del file
CLAUDE_CODE_DISABLE_AUTO_MEMORYImposta su 1 per disabilitare la memoria automatica. Imposta su 0 per forzare la memoria automatica anche quando la modalità --bare o autoMemoryEnabled: false altrimenti la disabiliterebbe. Quando disabilitato, Claude non crea o carica i file di memoria automatica
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSImposta su 1 per disabilitare tutta la funzionalità di attività in background, incluso il parametro run_in_background su strumenti Bash e subagent, auto-backgrounding e la scorciatoia Ctrl+B
CLAUDE_CODE_DISABLE_CLAUDE_MDSImposta su 1 per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di utente, progetto e memoria automatica
CLAUDE_CODE_DISABLE_CRONImposta su 1 per disabilitare le attività pianificate. La skill /loop e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse le attività già in esecuzione a metà sessione
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASImposta su 1 per rimuovere le intestazioni di richiesta anthropic-beta specifiche di Anthropic e i campi dello schema degli strumenti beta (come defer_loading e eager_input_streaming) dalle richieste API. Utilizza questo quando un gateway proxy rifiuta le richieste con errori come “Unexpected value(s) for the anthropic-beta header” o “Extra inputs are not permitted”. I campi standard (name, description, input_schema, cache_control) vengono preservati.
CLAUDE_CODE_DISABLE_FAST_MODEImposta su 1 per disabilitare la modalità veloce
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEYImposta su 1 per disabilitare i sondaggi sulla qualità della sessione “Come sta andando Claude?”. I sondaggi sono anche disabilitati quando DISABLE_TELEMETRY, DO_NOT_TRACK o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC è impostato, a meno che CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL non opti di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizzate l’impostazione feedbackSurveyRate. Vedi Sondaggi sulla qualità della sessione
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGImposta su 1 per disabilitare il checkpointing dei file. Il comando /rewind non sarà in grado di ripristinare le modifiche al codice
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSImposta su 1 per rimuovere le istruzioni di workflow commit e PR integrate e lo snapshot dello stato git dal prompt di sistema di Claude. Utile quando si utilizzano le proprie skill di workflow git. Ha la precedenza sull’impostazione includeGitInstructions se impostato
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPImposta su 1 per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull’API Anthropic. Utilizza quando desiderate intenzionalmente fissare un modello più vecchio. Il remapping non viene eseguito su Bedrock, Vertex o Foundry
CLAUDE_CODE_DISABLE_MOUSEImposta su 1 per disabilitare il tracciamento del mouse nel rendering a schermo intero. Lo scorrimento da tastiera con PgUp e PgDn funziona ancora. Utilizza questo per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICEquivalente all’impostazione di DISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING e DISABLE_TELEMETRY
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACKImposta su 1 per disabilitare il fallback non-streaming quando una richiesta di streaming fallisce a metà stream. Gli errori di streaming si propagano al livello di retry. Utile quando un proxy o gateway causa il fallback per produrre l’esecuzione duplicata dello strumento
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALLImposta su 1 per saltare l’aggiunta automatica del marketplace ufficiale dei plugin al primo avvio
CLAUDE_CODE_DISABLE_POLICY_SKILLSImposta su 1 per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni container o CI che non dovrebbero caricare skill fornite dall’operatore
CLAUDE_CODE_DISABLE_TERMINAL_TITLEImposta su 1 per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione
CLAUDE_CODE_DISABLE_THINKINGImposta su 1 per disabilitare forzatamente il thinking esteso indipendentemente dal supporto del modello o da altre impostazioni. Più diretto di MAX_THINKING_TOKENS=0
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLLImposta su 1 per disabilitare lo scorrimento virtuale nel rendering a schermo intero e renderizzare ogni messaggio nella trascrizione. Utilizza questo se lo scorrimento in modalità a schermo intero mostra regioni vuote dove dovrebbero apparire i messaggi
CLAUDE_CODE_EFFORT_LEVELImposta il livello di sforzo per i modelli supportati. Valori: low, medium, high, xhigh, max o auto per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su /effort e sull’impostazione effortLevel. Vedi Regola il livello di sforzo
CLAUDE_CODE_ENABLE_AWAY_SUMMARYSovrascrivi la disponibilità del riepilogo della sessione. Imposta su 0 per forzare i riepiloghi disattivati indipendentemente dall’interruttore /config. Imposta su 1 per forzare i riepiloghi attivati quando awaySummaryEnabled è false. Ha la precedenza sull’impostazione e sull’interruttore /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESHImposta su 1 per aggiornare lo stato del plugin ai confini dei turni in modalità non interattiva dopo il completamento di un’installazione in background. Disattivato per impostazione predefinita perché l’aggiornamento cambia il prompt di sistema a metà sessione, il che invalida il caching dei prompt per quel turno
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELImposta su 1 per instradare il sondaggio sulla qualità della sessione “Come sta andando Claude?” al vostro collettore OpenTelemetry quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro collettore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY o DO_NOT_TRACK è impostato, e non ha effetto altrimenti. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY e la politica di feedback del prodotto dell’organizzazione hanno la precedenza
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMINGControlla se gli input delle chiamate di strumento vengono trasmessi dall’API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull’API Anthropic. Su Bedrock e Vertex, abilitato per modello dove il container distribuito lo supporta. Imposta su 0 per rinunciare. Imposta su 1 per forzare l’abilitazione quando instrada attraverso un proxy tramite ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL o ANTHROPIC_BEDROCK_BASE_URL. Disattivato per impostazione predefinita su Foundry e connessioni gateway
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYImposta su 1 per popolare il selettore /model dall’endpoint /v1/models del vostro gateway quando ANTHROPIC_BASE_URL punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivato per impostazione predefinita perché i gateway supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati dall’allowlist availableModels
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODERimosso in v2.1.142. La modalità veloce per impostazione predefinita è Opus 4.7. Imposta CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 per mantenere Opus 4.6
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONImposta su false per disabilitare i suggerimenti di prompt (l’interruttore “Prompt suggestions” in /config). Questi sono i suggerimenti predetti in grigio che appaiono nel vostro input di prompt dopo che Claude risponde. Vedi Suggerimenti di prompt
CLAUDE_CODE_ENABLE_TASKSControlla se le sessioni utilizzano gli strumenti Task strutturati (TaskCreate, TaskUpdate, TaskGet, TaskList) o lo strumento legacy TodoWrite. A partire da Claude Code v2.1.142, gli strumenti Task sono il valore predefinito in tutte le modalità. Imposta su 0 per tornare a TodoWrite. Vedi Elenco attività e Migra agli strumenti Task
CLAUDE_CODE_ENABLE_TELEMETRYImposta su 1 per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Obbligatorio prima di configurare gli esportatori OTel. Vedi Monitoraggio
CLAUDE_CODE_EXIT_AFTER_STOP_DELAYTempo in millisecondi da attendere dopo che il loop di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSImposta su 1 per abilitare i team di agenti. I team di agenti sono sperimentali e disabilitati per impostazione predefinita
CLAUDE_CODE_EXTRA_BODYOggetto 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
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSSovrascrivi il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero
CLAUDE_CODE_FORCE_SYNC_OUTPUTImposta su 1 per forzare l’abilitazione della modalità privata DEC 2026 synchronized output quando il vostro terminale la supporta ma non viene rilevato automaticamente. Utile per emulatori come Emacs eat che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux
CLAUDE_CODE_FORK_SUBAGENTImposta su 1 per abilitare i subagent biforcati. Un subagent biforcato eredita il contesto della conversazione completa dalla sessione principale invece di iniziare da zero. Quando abilitato, /fork genera un subagent biforcato piuttosto che agire come alias per /branch, e tutti gli spawn di subagent vengono eseguiti in background. Funziona in modalità interattiva e tramite SDK o claude -p
CLAUDE_CODE_GIT_BASH_PATHSolo Windows: percorso dell’eseguibile Git Bash (bash.exe). Utilizza quando Git Bash è installato ma non nel vostro PATH. Vedi Configurazione di Windows
CLAUDE_CODE_GLOB_HIDDENImposta su false per escludere i dotfile dai risultati quando Claude richiama lo strumento Glob. Incluso per impostazione predefinita. Non influisce su @ file autocomplete, ls, Grep o Read
CLAUDE_CODE_GLOB_NO_IGNOREImposta su false per fare in modo che lo strumento Glob rispetti i modelli .gitignore. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su @ file autocomplete, che ha la sua propria impostazione respectGitignore
CLAUDE_CODE_GLOB_TIMEOUT_SECONDSTimeout in secondi per la scoperta dei file dello strumento Glob. Per impostazione predefinita 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL
CLAUDE_CODE_HIDE_CWDImposta su 1 per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni in cui il percorso espone il vostro nome utente del sistema operativo
CLAUDE_CODE_IDE_HOST_OVERRIDESovrascrivi l’indirizzo host utilizzato per connettersi all’estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l’indirizzo corretto, incluso il routing WSL-to-Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLSalta l’installazione automatica delle estensioni IDE. Equivalente all’impostazione di autoInstallIdeExtension su false
CLAUDE_CODE_IDE_SKIP_VALID_CHECKImposta su 1 per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizza quando l’auto-connessione non riesce a trovare il vostro IDE nonostante sia in esecuzione
CLAUDE_CODE_MAX_CONTEXT_TOKENSSovrascrivi la dimensione della finestra del contesto che Claude Code assume per il modello attivo. Ha effetto solo quando DISABLE_COMPACT è anche impostato. Utilizza questo quando instrada a un modello attraverso ANTHROPIC_BASE_URL la cui finestra del contesto non corrisponde alla dimensione integrata per il suo nome
CLAUDE_CODE_MAX_OUTPUT_TOKENSImposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e massimi variano in base al modello; vedi max output tokens. L’aumento di questo valore riduce la finestra del contesto effettiva disponibile prima che venga attivata la compattazione automatica.
CLAUDE_CODE_MAX_RETRIESSovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10)
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYNumero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse
CLAUDE_CODE_MAX_TURNSLimita il numero di turni agentici quando non viene passato un limite esplicito. Equivalente a passare --max-turns, che ha la precedenza quando entrambi sono impostati. Un valore che non è un intero positivo viene rifiutato all’avvio con un errore piuttosto che trattato come nessun limite
CLAUDE_CODE_MCP_ALLOWLIST_ENVImposta su 1 per generare server MCP stdio con solo un ambiente di base sicuro più il env configurato del server, invece di ereditare l’ambiente della vostra shell
CLAUDE_CODE_NATIVE_CURSORImposta su 1 per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e focus del terminale
CLAUDE_CODE_NEW_INITImposta su 1 per fare in modo che /init esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare la base di codice e scriverli. Senza questa variabile, /init genera un CLAUDE.md automaticamente senza chiedere.
CLAUDE_CODE_NO_FLICKERImposta su 1 per abilitare il rendering a schermo intero, un’anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Equivalente all’impostazione tui; potete anche passare con /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKENToken di aggiornamento OAuth per l’autenticazione Claude.ai. Se impostato, claude auth login scambia questo token direttamente invece di aprire un browser. Richiede CLAUDE_CODE_OAUTH_SCOPES. Utile per il provisioning dell’autenticazione in ambienti automatizzati
CLAUDE_CODE_OAUTH_SCOPESAmbiti OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come "user:profile user:inference user:sessions:claude_code". Obbligatorio quando CLAUDE_CODE_OAUTH_REFRESH_TOKEN è impostato
CLAUDE_CODE_OAUTH_TOKENToken di accesso OAuth per l’autenticazione Claude.ai. Alternativa a /login per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali archiviate nel portachiavi. Generatene uno con claude setup-token
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDEImposta su 1 per mantenere la modalità veloce su Claude Opus 4.6 invece del valore predefinito Opus 4.7. Con la variabile impostata, /fast viene eseguito su Opus 4.6. Senza di essa, /fast viene eseguito su Opus 4.7
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MSTimeout in millisecondi per lo scaricamento dei span OpenTelemetry in sospeso (predefinito: 5000). Vedi Monitoraggio
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MSIntervallo per l’aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedi Intestazioni dinamiche
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MSTimeout in millisecondi per l’esportatore OpenTelemetry per terminare all’arresto (predefinito: 2000). Aumentate se le metriche vengono eliminate all’uscita. Vedi Monitoraggio
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEImposta su 1 per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando una nuova versione è disponibile. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedi Aggiornamenti automatici
CLAUDE_CODE_PERFORCE_MODEImposta su 1 per abilitare la protezione da scrittura consapevole di Perforce. Se impostato, Edit, Write e NotebookEdit falliscono con un suggerimento p4 edit <file> se il file di destinazione manca del bit di scrittura del proprietario, che Perforce cancella sui file sincronizzati fino a quando p4 edit non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIRSovrascrivi la directory radice dei plugin. Nonostante il nome, questo imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory sotto questo percorso. Per impostazione predefinita ~/.claude/plugins
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSTimeout in millisecondi per le operazioni git durante l’installazione o l’aggiornamento dei plugin (predefinito: 120000). Aumentate questo valore per repository di grandi dimensioni o connessioni di rete lente. Vedi Le operazioni Git scadono
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILUREImposta su 1 per mantenere la cache del marketplace esistente quando un git pull fallisce invece di cancellare e ri-clonare. Utile in ambienti offline o airgapped dove il ri-cloning fallirebbe allo stesso modo. Vedi Gli aggiornamenti del marketplace falliscono in ambienti offline
CLAUDE_CODE_PLUGIN_PREFER_HTTPSImposta su 1 per clonare le fonti plugin GitHub owner/repo su HTTPS invece di SSH. Utile nei runner CI, container o in qualsiasi ambiente senza una chiave SSH configurata per github.com
CLAUDE_CODE_PLUGIN_SEED_DIRPercorso di una o più directory di seed plugin di sola lettura, separate da : su Unix o ; su Windows. Utilizza questo per raggruppare una directory plugin pre-popolata in un’immagine container. Claude Code registra i marketplace da queste directory all’avvio e utilizza i plugin pre-memorizzati nella cache senza ri-clonare. Vedi Pre-popola i plugin per i container
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICYImposta su 1 per impedire a Claude Code di passare -ExecutionPolicy Bypass quando genera PowerShell per le chiamate di strumento, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script .ps1 e gli import di moduli funzionino su installazioni Windows predefinite con Restricted. Il bypass a livello di processo non sostituisce mai la Politica di gruppo MachinePolicy o UserPolicy indipendentemente da questa impostazione
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTImpostato da piattaforme host che incorporano Claude Code e gestiscono l’instradamento del provider di modelli per suo conto. Se impostato, la selezione del provider, l’endpoint e le variabili di autenticazione come CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY nei file di impostazioni vengono ignorate in modo che le impostazioni dell’utente non possono sovrascrivere l’instradamento dell’host. Anche l’opt-out automatico della telemetria per Bedrock, Vertex e Foundry viene saltato, quindi la telemetria segue l’opt-out standard DISABLE_TELEMETRY. Vedi Comportamenti predefiniti per provider API
CLAUDE_CODE_PROXY_RESOLVES_HOSTSImposta su 1 per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per ambienti in cui il proxy deve gestire la risoluzione del nome host
CLAUDE_CODE_REMOTEImpostato automaticamente su true quando Claude Code è in esecuzione come una sessione cloud. Leggete questo da un hook o script di configurazione per rilevare se siete in un ambiente cloud
CLAUDE_CODE_REMOTE_SESSION_IDImpostato automaticamente nelle sessioni cloud all’ID della sessione corrente. Leggete questo per costruire un collegamento alla trascrizione della sessione. Vedi Collegare gli artefatti alla sessione
CLAUDE_CODE_RESUME_INTERRUPTED_TURNImposta su 1 per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all’SDK di reinviare il prompt
CLAUDE_CODE_RESUME_PROMPTSovrascrivi il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Per impostazione predefinita Continue from where you left off.. Gli script di spawn per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il valore predefinito
CLAUDE_CODE_SCRIPT_CAPSOggetto JSON che limita quante volte script specifici possono essere richiamati per sessione quando CLAUDE_CODE_SUBPROCESS_ENV_SCRUB è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di chiamate intere. Ad esempio, {"deploy.sh": 2} consente a deploy.sh di essere chiamato al massimo due volte. L’abbinamento è basato su sottostringhe quindi trucchi di espansione della shell come ./scripts/deploy.sh $(evil) contano comunque rispetto al limite. Il fan-out di runtime tramite xargs o find -exec non viene rilevato; questo è un controllo di difesa in profondità
CLAUDE_CODE_SCROLL_SPEEDImposta il moltiplicatore di scorrimento della rotella del mouse nel rendering a schermo intero. Accetta valori da 1 a 20. Imposta su 3 per corrispondere a vim se il vostro terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSSovrascrivi il budget di tempo in millisecondi per gli hook SessionEnd. Si applica all’uscita della sessione, /clear e al cambio di sessioni tramite /resume interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al massimo timeout per hook configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget
CLAUDE_CODE_SESSION_IDImpostato automaticamente nei sottoprocessi dello strumento Bash e PowerShell all’ID della sessione corrente. Corrisponde al campo session_id passato agli hook. Aggiornato su /clear. Utilizza per correlare script e strumenti esterni con la sessione Claude Code che li ha avviati
CLAUDE_CODE_SHELLSovrascrivi il rilevamento automatico della shell. Utile quando la vostra shell di login differisce dalla vostra shell di lavoro preferita (ad esempio, bash vs zsh)
CLAUDE_CODE_SHELL_PREFIXPrefisso del comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi hook e comandi di avvio del server MCP stdio. Utile per logging o auditing. Esempio: impostando /path/to/logger.sh esegue ogni comando come /path/to/logger.sh <command>
CLAUDE_CODE_SIMPLEImposta su 1 per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura file e modifica file. Gli strumenti MCP da --mcp-config sono ancora disponibili. Disabilita l’auto-discovery di hook, skill, plugin, server MCP, memoria automatica e CLAUDE.md. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l’autenticazione Anthropic deve provenire da ANTHROPIC_API_KEY o da un apiKeyHelper in --settings. Equivalente a passare --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTImposta su 1 per utilizzare il prompt di sistema minimo e le descrizioni degli strumenti compresse su qualsiasi modello. Imposta su 0, false, no o off per rinunciare anche su modelli dove l’esperimento o la configurazione del server altrimenti lo abiliterebbero. Il set di strumenti completo, hook, server MCP e scoperta CLAUDE.md rimangono abilitati
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTHSalta l’autenticazione lato client per Claude Platform on AWS, per gateway che firmano le richieste stessi
CLAUDE_CODE_SKIP_BEDROCK_AUTHSalta l’autenticazione AWS per Bedrock (ad esempio, quando si utilizza un gateway LLM)
CLAUDE_CODE_SKIP_FOUNDRY_AUTHSalta l’autenticazione Azure per Microsoft Foundry (ad esempio, quando si utilizza un gateway LLM)
CLAUDE_CODE_SKIP_MANTLE_AUTHSalta l’autenticazione AWS per Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM)
CLAUDE_CODE_SKIP_PROMPT_HISTORYImposta su 1 per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in --resume, --continue o nella cronologia della freccia su. Utile per sessioni di script effimere
CLAUDE_CODE_SKIP_VERTEX_AUTHSalta l’autenticazione Google per Vertex (ad esempio, quando si utilizza un gateway LLM)
CLAUDE_CODE_STOP_HOOK_BLOCK_CAPNumero massimo di volte consecutive che un hook Stop o SubagentStop può bloccare il turno dal terminare prima che Claude Code lo sostituisca e termini il turno comunque (predefinito: 8). Imposta su 0 per disabilitare il limite. Aumentate questo se il vostro hook ha legittimamente bisogno di più iterazioni per risolvere
CLAUDE_CODE_SUBAGENT_MODELVedi Configurazione del modello
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBImposta su 1 per rimuovere le credenziali Anthropic e del provider cloud dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio). Il processo Claude padre mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l’esposizione agli attacchi di prompt injection che tentano di esfiltare i segreti tramite l’espansione della shell. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi PID isolato in modo che non possano leggere gli ambienti dei processi host tramite /proc; come effetto collaterale, ps, pgrep e kill non possono vedere o segnalare i processi host. claude-code-action imposta questo automaticamente quando allowed_non_write_users è configurato
CLAUDE_CODE_SYNC_PLUGIN_INSTALLImposta su 1 in modalità non interattiva (il flag -p) per attendere il completamento dell’installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combina con CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS per limitare l’attesa
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MSTimeout in millisecondi per l’installazione sincrona del plugin. Se superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l’installazione sincrona attende fino al completamento
CLAUDE_CODE_SYNTAX_HIGHLIGHTImposta su false per disabilitare l’evidenziazione della sintassi nell’output diff. Utile quando i colori interferiscono con la configurazione del vostro terminale. Per disabilitare anche l’evidenziazione nei blocchi di codice e nelle anteprime di file, utilizzate l’impostazione syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_IDCondividi un elenco di attività tra le sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso. Vedi Elenco attività
CLAUDE_CODE_TEAM_NAMENome del team di agenti a cui appartiene questo compagno di squadra. Impostato automaticamente sui membri del team di agenti
CLAUDE_CODE_TMPDIRSovrascrivi la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge /claude-{uid}/ (Unix) o /claude/ (Windows) a questo percorso. Predefinito: /tmp su macOS, os.tmpdir() su Linux/Windows
CLAUDE_CODE_TMUX_TRUECOLORImposta su 1 per consentire l’output truecolor a 24 bit all’interno di tmux. Per impostazione predefinita, Claude Code si limita a 256 colori quando $TMUX è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato per farlo. Imposta questo dopo aver aggiunto set -ga terminal-overrides ',*:Tc' al vostro ~/.tmux.conf. Vedi Configurazione del terminale per altre impostazioni di tmux
CLAUDE_CODE_USE_ANTHROPIC_AWSUtilizza Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCKUtilizza Bedrock
CLAUDE_CODE_USE_FOUNDRYUtilizza Microsoft Foundry
CLAUDE_CODE_USE_MANTLEUtilizza l’endpoint Mantle di Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCHImposta su 1 per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Imposta questo se il binario ripgrep raggruppato non è disponibile o bloccato nel vostro ambiente. Non influisce su Grep o strumenti di ricerca file
CLAUDE_CODE_USE_POWERSHELL_TOOLControlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta su 0 per disabilitarlo. Su Windows con Git Bash installato, lo strumento è in rollout progressivo: imposta su 1 per aderire o 0 per rinunciare. Su Linux, macOS e WSL, imposta su 1 per abilitarlo, che richiede pwsh nel vostro PATH. Se abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedi Strumento PowerShell
CLAUDE_CODE_USE_VERTEXUtilizza Vertex
CLAUDE_CONFIG_DIRSovrascrivi la directory di configurazione (predefinito: ~/.claude). Tutte le impostazioni, le credenziali, la cronologia della sessione e i plugin sono archiviati sotto questo percorso. Utile per eseguire più account affiancati: ad esempio, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
CLAUDE_EFFORTImpostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al livello di sforzo attivo per il turno: low, medium, high, xhigh o max. Corrisponde al campo effort.level passato agli hook. Impostato solo quando il modello corrente supporta il parametro effort
CLAUDE_ENABLE_BYTE_WATCHDOGImposta su 1 per forzare l’abilitazione del watchdog di inattività a livello di byte, o imposta su 0 per forzare la disabilitazione. Se non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic. Il byte watchdog interrompe una connessione quando nessun byte arriva sul filo per la durata impostata da CLAUDE_STREAM_IDLE_TIMEOUT_MS, con un minimo di 5 minuti, indipendente dal watchdog a livello di evento
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCKImposta su 1 per abilitare il watchdog di inattività a livello di byte su risposte Amazon Bedrock vnd.amazon.eventstream. Disattivato per impostazione predefinita. Configurate il timeout con CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENABLE_STREAM_WATCHDOGImposta su 1 per abilitare il watchdog di inattività dello streaming a livello di evento. Disattivato per impostazione predefinita. Si applica a tutti i provider, incluso Bedrock. Per Vertex e Foundry, questo è l’unico watchdog di inattività disponibile. Su Bedrock, potete anche abilitare il watchdog indipendente a livello di byte con CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK; i due vengono eseguiti insieme quando entrambi sono impostati. Configurate il timeout con CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENV_FILEPercorso di uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizza per persistere l’attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente dagli hook SessionStart, Setup, CwdChanged e FileChanged
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIXPrefisso per i nomi delle sessioni Remote Control generati automaticamente quando non viene fornito un nome esplicito. Per impostazione predefinita il nome host della vostra macchina, producendo nomi come myhost-graceful-unicorn. Il flag CLI --remote-control-session-name-prefix imposta lo stesso valore per una singola invocazione
CLAUDE_STREAM_IDLE_TIMEOUT_MSTimeout in millisecondi prima che il watchdog di inattività dello streaming chiuda una connessione bloccata. Predefinito e minimo 300000 (5 minuti) per il watchdog a livello di byte e il watchdog a livello di evento; i valori inferiori vengono silenziosamente limitati per assorbire le pause di thinking esteso e il buffering del proxy. Per i provider di terze parti, richiede CLAUDE_ENABLE_STREAM_WATCHDOG=1. Su Bedrock, si applica anche quando CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1
DEBUGImposta su 1 per abilitare la modalità debug, equivalente al lancio con --debug. I log di debug vengono scritti in ~/.claude/debug/<session-id>.txt, o nel percorso impostato da CLAUDE_CODE_DEBUG_LOGS_DIR. Solo i valori truthy 1, true, yes e on abilitano la modalità debug, quindi i modelli di namespace come DEBUG=express:* impostati per altri strumenti non lo attivano
DISABLE_AUTOUPDATERImposta su 1 per disabilitare gli aggiornamenti automatici in background. Il manuale claude update funziona ancora. Utilizza DISABLE_UPDATES per bloccare entrambi
DISABLE_AUTO_COMPACTImposta su 1 per disabilitare la compattazione automatica quando ci si avvicina al limite del contesto. Il comando manuale /compact rimane disponibile. Utilizza quando desiderate un controllo esplicito su quando si verifica la compattazione
DISABLE_COMPACTImposta su 1 per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale /compact
DISABLE_COST_WARNINGSImposta su 1 per disabilitare i messaggi di avviso sui costi
DISABLE_DOCTOR_COMMANDImposta su 1 per nascondere il comando /doctor. Utile per distribuzioni gestite in cui gli utenti non dovrebbero eseguire diagnostiche di installazione
DISABLE_ERROR_REPORTINGImposta su 1 per rinunciare alla segnalazione degli errori di Sentry
DISABLE_EXTRA_USAGE_COMMANDImposta su 1 per nascondere il comando /usage-credits che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità
DISABLE_FEEDBACK_COMMANDImposta su 1 per disabilitare il comando /feedback. Il nome più vecchio DISABLE_BUG_COMMAND è anche accettato
DISABLE_GROWTHBOOKImposta su 1 per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i valori predefiniti del codice per ogni flag. La registrazione degli eventi di telemetria rimane attiva a meno che DISABLE_TELEMETRY non sia anche impostato
DISABLE_INSTALLATION_CHECKSImposta su 1 per disabilitare gli avvisi di installazione. Utilizza solo quando gestite manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard
DISABLE_INSTALL_GITHUB_APP_COMMANDImposta su 1 per nascondere il comando /install-github-app. Già nascosto quando si utilizzano provider di terze parti (Bedrock, Vertex o Foundry)
DISABLE_INTERLEAVED_THINKINGImposta su 1 per impedire l’invio dell’intestazione beta interleaved-thinking. Utile quando il vostro gateway LLM o provider non supporta il thinking interleaved
DISABLE_LOGIN_COMMANDImposta su 1 per nascondere il comando /login. Utile quando l’autenticazione è gestita esternamente tramite chiavi API o apiKeyHelper
DISABLE_LOGOUT_COMMANDImposta su 1 per nascondere il comando /logout
DISABLE_PROMPT_CACHINGImposta su 1 per disabilitare il caching dei prompt per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello)
DISABLE_PROMPT_CACHING_HAIKUImposta su 1 per disabilitare il caching dei prompt per i modelli Haiku
DISABLE_PROMPT_CACHING_OPUSImposta su 1 per disabilitare il caching dei prompt per i modelli Opus
DISABLE_PROMPT_CACHING_SONNETImposta su 1 per disabilitare il caching dei prompt per i modelli Sonnet
DISABLE_TELEMETRYImposta su 1 per rinunciare alla telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche il recupero dei flag di funzionalità con lo stesso effetto di DISABLE_GROWTHBOOK, quindi alcune funzionalità ancora in rollout potrebbero non essere disponibili
DISABLE_UPDATESImposta su 1 per bloccare tutti gli aggiornamenti incluso il manuale claude update e claude install. Più rigoroso di DISABLE_AUTOUPDATER. Utilizza quando distribuite Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornarsi
DISABLE_UPGRADE_COMMANDImposta su 1 per nascondere il comando /upgrade
DO_NOT_TRACKImposta su 1 per rinunciare alla telemetria. Equivalente all’impostazione di DISABLE_TELEMETRY. Onorato come la convenzione standard tra strumenti
ENABLE_CLAUDEAI_MCP_SERVERSImposta su false per disabilitare i server MCP claude.ai in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi
ENABLE_PROMPT_CACHING_1HImposta su 1 per richiedere un TTL della cache dei prompt di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di chiave API, Bedrock, Vertex, Foundry e Claude Platform on AWS. Gli utenti di abbonamento ricevono automaticamente il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più elevata
ENABLE_PROMPT_CACHING_1H_BEDROCKDeprecato. Utilizza ENABLE_PROMPT_CACHING_1H invece
ENABLE_TOOL_SEARCHControlla la ricerca degli strumenti MCP. Non impostato: tutti gli strumenti MCP differiti per impostazione predefinita, ma caricati in primo piano su Vertex AI o quando ANTHROPIC_BASE_URL punta a un host non di prima parte. Valori: true (sempre differire e inviare l’intestazione beta, le richieste falliscono su modelli Vertex AI precedenti a Sonnet 4.5 o Opus 4.5, o su proxy che non supportano tool_reference), auto (modalità soglia: carica in primo piano se gli strumenti si adattano entro il 10% del contesto), auto:N (soglia personalizzata, ad es. auto:5 per il 5%), false (carica tutto in primo piano)
FALLBACK_FOR_ALL_PRIMARY_MODELSImposta su qualsiasi valore non vuoto per attivare il fallback a --fallback-model dopo errori di sovraccarico ripetuti su qualsiasi modello primario. Per impostazione predefinita, solo i modelli Opus attivano il fallback
FORCE_AUTOUPDATE_PLUGINSImposta su 1 per forzare gli aggiornamenti automatici dei plugin anche quando l’auto-updater principale è disabilitato tramite DISABLE_AUTOUPDATER
FORCE_PROMPT_CACHING_5MImposta su 1 per forzare il TTL della cache dei prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce ENABLE_PROMPT_CACHING_1H
HTTP_PROXYSpecifica il server proxy HTTP per le connessioni di rete
HTTPS_PROXYSpecifica il server proxy HTTPS per le connessioni di rete
IS_DEMOImposta su 1 per abilitare la modalità demo: nasconde la vostra email e il nome dell’organizzazione dall’intestazione e dall’output /status, e salta l’onboarding. Utile quando si trasmette in streaming o si registra una sessione
MAX_MCP_OUTPUT_TOKENSNumero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l’output supera 10.000 token. Gli strumenti che dichiarano anthropic/maxResultSizeChars utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell’immagine da questi strumenti è ancora soggetto a questa variabile (predefinito: 25000)
MAX_STRUCTURED_OUTPUT_RETRIESNumero di volte per riprovare quando la risposta del modello non supera la convalida rispetto a --json-schema in modalità non interattiva (il flag -p). Per impostazione predefinita 5
MAX_THINKING_TOKENSSovrascrivi il budget del token di extended thinking. Il massimale è il max output tokens del modello meno uno. Imposta su 0 per disabilitare completamente il thinking. Sui modelli con ragionamento adattivo, il budget viene ignorato a meno che il ragionamento adattivo non sia disabilitato tramite CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING
MCP_CLIENT_SECRETSegreto client OAuth per i server MCP che richiedono credenziali preconfigurate. Evita il prompt interattivo quando si aggiunge un server con --client-secret
MCP_CONNECTION_NONBLOCKINGControlla se l’avvio attende che i server MCP si connettano prima della prima query. A partire da Claude Code v2.1.142, l’avvio MCP è non-bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Imposta su 0 per ripristinare l’attesa di connessione bloccante di 5 secondi. I server configurati con alwaysLoad: true bloccano comunque l’avvio indipendentemente, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt
MCP_CONNECT_TIMEOUT_MSQuanto tempo l’avvio bloccante attende, in millisecondi, per il batch di connessione prima di acquisire uno snapshot dell’elenco degli strumenti (predefinito: 5000). Si applica quando MCP_CONNECTION_NONBLOCKING=0 o per i server contrassegnati alwaysLoad: true. I server ancora in sospeso alla scadenza continuano a connettersi in background ma non appariranno fino alla query successiva. Distinto da MCP_TIMEOUT, che limita il tentativo di connessione di un singolo server
MCP_OAUTH_CALLBACK_PORTPorta fissa per il callback di reindirizzamento OAuth, come alternativa a --callback-port quando si aggiunge un server MCP con credenziali preconfigurate
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZENumero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l’avvio (predefinito: 20)
MCP_SERVER_CONNECTION_BATCH_SIZENumero massimo di server MCP locali (stdio) da connettere in parallelo durante l’avvio (predefinito: 3)
MCP_TIMEOUTTimeout in millisecondi per l’avvio del server MCP (predefinito: 30000, o 30 secondi)
MCP_TOOL_TIMEOUTTimeout in millisecondi per l’esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore)
NO_PROXYElenco di domini e IP a cui le richieste verranno emesse direttamente, bypassando il proxy
OTEL_LOG_RAW_API_BODIESEmetti il JSON della richiesta e della risposta dell’API Anthropic Messages come eventi di log api_request_body / api_response_body. Imposta su 1 per i corpi inline troncati a 60 KB, o file:<dir> per scrivere i corpi non troncati su disco ed emettere un percorso body_ref invece. Disabilitato per impostazione predefinita; i corpi includono l’intera cronologia della conversazione. Vedi Monitoraggio
OTEL_LOG_TOOL_CONTENTImposta su 1 per includere il contenuto di input e output dello strumento negli eventi span OpenTelemetry. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedi Monitoraggio
OTEL_LOG_TOOL_DETAILSImposta su 1 per includere gli argomenti di input dello strumento, i nomi dei server MCP, le stringhe di errore non elaborate sui fallimenti degli strumenti e altri dettagli degli strumenti nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le informazioni personali. Vedi Monitoraggio
OTEL_LOG_USER_PROMPTSImposta su 1 per includere il testo del prompt dell’utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedi Monitoraggio
OTEL_METRICS_INCLUDE_ACCOUNT_UUIDImposta su false per escludere l’UUID dell’account dagli attributi delle metriche (predefinito: incluso). Vedi Monitoraggio
OTEL_METRICS_INCLUDE_SESSION_IDImposta su false per escludere l’ID della sessione dagli attributi delle metriche (predefinito: incluso). Vedi Monitoraggio
OTEL_METRICS_INCLUDE_VERSIONImposta su true per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Vedi Monitoraggio
SLASH_COMMAND_TOOL_CHAR_BUDGETSovrascrivi il budget dei caratteri per i metadati della skill mostrati allo strumento Skill. Il budget si ridimensiona dinamicamente all’1% della finestra del contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per la compatibilità all’indietro
TASK_MAX_OUTPUT_LENGTHNumero massimo di caratteri nell’output del subagent prima del troncamento (predefinito: 32000, massimo: 160000). Se troncato, l’output completo viene salvato su disco e il percorso è incluso nella risposta troncata
USE_BUILTIN_RIPGREPImposta su 0 per utilizzare il rg installato dal sistema invece del rg incluso con Claude Code
VERTEX_REGION_CLAUDE_3_5_HAIKUSovrascrivi la regione per Claude 3.5 Haiku quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_3_5_SONNETSovrascrivi la regione per Claude 3.5 Sonnet quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_3_7_SONNETSovrascrivi la regione per Claude 3.7 Sonnet quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_0_OPUSSovrascrivi la regione per Claude 4.0 Opus quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_0_SONNETSovrascrivi la regione per Claude 4.0 Sonnet quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_1_OPUSSovrascrivi la regione per Claude 4.1 Opus quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_5_OPUSSovrascrivi la regione per Claude Opus 4.5 quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_5_SONNETSovrascrivi la regione per Claude Sonnet 4.5 quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_6_OPUSSovrascrivi la regione per Claude Opus 4.6 quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_6_SONNETSovrascrivi la regione per Claude Sonnet 4.6 quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_4_7_OPUSSovrascrivi la regione per Claude Opus 4.7 quando si utilizza Vertex AI
VERTEX_REGION_CLAUDE_HAIKU_4_5Sovrascrivi la regione per Claude Haiku 4.5 quando si utilizza Vertex AI
Sono supportate anche le variabili standard dell’esportatore OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES e varianti specifiche del segnale). Vedi Monitoraggio per i dettagli di configurazione.

​
Vedi anche