Variabili d'ambiente
Riferimento completo per le variabili d'ambiente che controllano il comportamento di Claude Code.
Claude Code supporta le seguenti variabili d'ambiente per controllare il suo comportamento. Impostale nella tua shell prima di avviare claude, oppure configurale in settings.json sotto la chiave env per applicarle a ogni sessione o distribuirle nel tuo team.
| Variable | Purpose |
|---|---|
ANTHROPIC_API_KEY |
Chiave API inviata come intestazione X-Api-Key. Quando impostata, questa chiave viene utilizzata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se sei connesso. In modalità non interattiva (-p), la chiave viene sempre utilizzata quando presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sostituisca il tuo abbonamento. Per utilizzare il tuo abbonamento, esegui unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN |
Valore personalizzato per l'intestazione Authorization (il valore che imposti qui sarà preceduto da Bearer ) |
ANTHROPIC_BASE_URL |
Sovrascrivi l'endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, la ricerca degli strumenti MCP è disabilitata per impostazione predefinita. Imposta ENABLE_TOOL_SEARCH=true se il tuo proxy inoltra i blocchi tool_reference |
ANTHROPIC_BEDROCK_BASE_URL |
Sovrascrivi l'URL dell'endpoint Bedrock. Utilizza per endpoint Bedrock personalizzati o quando instrada attraverso un gateway LLM. Vedi Amazon Bedrock |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL |
Sovrascrivi l'URL dell'endpoint Bedrock Mantle. Vedi Endpoint Mantle |
ANTHROPIC_BEDROCK_SERVICE_TIER |
Bedrock service tier (default, flex o priority). Inviato come intestazione X-Amzn-Bedrock-Service-Tier. Vedi Amazon Bedrock |
ANTHROPIC_BETAS |
Elenco separato da virgole di valori aggiuntivi dell'intestazione anthropic-beta da includere nelle richieste API. Claude Code invia già le intestazioni beta di cui ha bisogno; utilizza questo per aderire a un beta API Anthropic prima che Claude Code aggiunga il supporto nativo. A differenza del flag --betas, che richiede l'autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione incluso l'abbonamento Claude.ai |
ANTHROPIC_CUSTOM_HEADERS |
Intestazioni personalizzate da aggiungere alle richieste (formato Name: Value, separate da newline per più intestazioni) |
ANTHROPIC_CUSTOM_MODEL_OPTION |
ID del modello da aggiungere come voce personalizzata nel selettore /model. Utilizza questo per rendere selezionabile un modello non standard o specifico del gateway senza sostituire gli alias integrati. Vedi Configurazione del modello |
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION |
Descrizione di visualizzazione per la voce del modello personalizzato nel selettore /model. Per impostazione predefinita, Custom model (<model-id>) quando non impostato |
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME |
Nome di visualizzazione per la voce del modello personalizzato nel selettore /model. Per impostazione predefinita, l'ID del modello quando non impostato |
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_OPUS_MODEL |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME |
Vedi Configurazione del modello |
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES |
Vedi Configurazione del modello |
ANTHROPIC_FOUNDRY_API_KEY |
Chiave API per l'autenticazione Microsoft Foundry (vedi Microsoft Foundry) |
ANTHROPIC_FOUNDRY_BASE_URL |
URL 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_RESOURCE |
Nome della risorsa Foundry (ad esempio, my-resource). Obbligatorio se ANTHROPIC_FOUNDRY_BASE_URL non è impostato (vedi Microsoft Foundry) |
ANTHROPIC_MODEL |
Nome dell'impostazione del modello da utilizzare (vedi Configurazione del modello) |
ANTHROPIC_SMALL_FAST_MODEL |
[DEPRECATO] Nome del modello di classe Haiku per attività in background |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION |
Sovrascrivi la regione AWS per il modello di classe Haiku quando utilizzi Bedrock o Bedrock Mantle |
ANTHROPIC_VERTEX_BASE_URL |
Sovrascrivi 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_ID |
ID progetto GCP per le richieste Vertex AI. Sovrascritto da GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT o dal progetto nel tuo file di credenziali GOOGLE_APPLICATION_CREDENTIALS. Vedi Google Vertex AI |
API_TIMEOUT_MS |
Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumenta questo valore quando le richieste scadono su reti lente o quando 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 Bedrock per l'autenticazione (vedi Chiavi API Bedrock) |
BASH_DEFAULT_TIMEOUT_MS |
Timeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti) |
BASH_MAX_OUTPUT_LENGTH |
Numero massimo di caratteri negli output bash prima che vengano troncati al centro |
BASH_MAX_TIMEOUT_MS |
Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti) |
CCR_FORCE_BUNDLE |
Imposta su 1 per forzare claude --remote a raggruppare e caricare il tuo repository locale anche quando l'accesso a GitHub è disponibile |
CLAUDECODE |
Imposta 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_AGENTS |
Imposta su 1 per disabilitare tutti i tipi di subagent integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag -p). Utile per gli utenti SDK che desiderano una lavagna pulita |
CLAUDE_AGENT_SDK_MCP_NO_PREFIX |
Imposta su 1 per saltare il prefisso mcp__<server>__ sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK |
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS |
Timeout di stallo in millisecondi per i subagent in background. Predefinito 600000 (10 minuti). Il timer si ripristina su ogni evento di progresso dello streaming; se nessun progresso arriva entro la finestra, il subagent viene interrotto e l'attività viene contrassegnata come non riuscita, mostrando qualsiasi risultato parziale al genitore |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
Imposta la percentuale 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à. Utilizza 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_TASKS |
Imposta su 1 per forzare l'abilitazione dello sfondo automatico delle attività di agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l'esecuzione per circa due minuti |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR |
Ritorna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |
CLAUDE_CODE_ACCESSIBILITY |
Imposta su 1 per mantenere visibile il cursore del terminale nativo e disabilitare l'indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD |
Imposta su 1 per caricare i file di memoria dalle directory specificate con --add-dir. Carica CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md e CLAUDE.local.md. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS |
Intervallo in millisecondi a cui le credenziali devono essere aggiornate (quando si utilizza apiKeyHelper) |
CLAUDE_CODE_ATTRIBUTION_HEADER |
Imposta su 0 per omettere il blocco di attribuzione (versione client e impronta digitale del prompt) dall'inizio del prompt di sistema. Disabilitarlo migliora i tassi di hit della cache dei prompt quando si instrada attraverso un gateway LLM. Il caching dell'API Anthropic non è interessato |
CLAUDE_CODE_AUTO_COMPACT_WINDOW |
Imposta la capacità del contesto in token utilizzata per i calcoli di compattazione automatica. Per impostazione predefinita, la finestra del contesto del modello: 200K per i modelli standard o 1M per i modelli con contesto esteso. Utilizza un valore inferiore come 500000 su un modello 1M per trattare la finestra come 500K ai fini della compattazione. Il valore è limitato alla finestra del contesto effettiva del modello. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE viene applicato come percentuale di questo valore. L'impostazione di questa variabile disaccoppia la soglia di compattazione dalla used_percentage della linea di stato, che utilizza sempre la finestra del contesto completa del modello |
CLAUDE_CODE_AUTO_CONNECT_IDE |
Sovrascrivi la connessione IDE automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all'interno del terminale integrato di un IDE supportato. Imposta su false per impedire questo. Imposta su true per forzare un tentativo di connessione quando l'auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale padre. Ha la precedenza sull'impostazione globale autoConnectIde |
CLAUDE_CODE_CERT_STORE |
Elenco separato da virgole di fonti di certificati CA per le connessioni TLS. bundled è il set Mozilla CA fornito con Claude Code. system è l'archivio di fiducia del sistema operativo. Per impostazione predefinita è bundled,system |
CLAUDE_CODE_CLIENT_CERT |
Percorso del file del certificato client per l'autenticazione mTLS |
CLAUDE_CODE_CLIENT_KEY |
Percorso del file della chiave privata client per l'autenticazione mTLS |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE |
Passphrase per CLAUDE_CODE_CLIENT_KEY crittografato (facoltativo) |
CLAUDE_CODE_DEBUG_LOGS_DIR |
Sovrascrivi il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede che la modalità debug sia abilitata separatamente tramite --debug o /debug: l'impostazione di questa variabile da sola non abilita la registrazione. Il flag --debug-file fa entrambi contemporaneamente. Per impostazione predefinita ~/.claude/debug/<session-id>.txt |
CLAUDE_CODE_DEBUG_LOG_LEVEL |
Livello di log minimo scritto nel file di log di debug. Valori: verbose, debug (predefinito), info, warn, error. Imposta su verbose per includere diagnostica ad alto volume come l'output completo del comando della linea di stato, o aumenta a error per ridurre il rumore |
CLAUDE_CODE_DISABLE_1M_CONTEXT |
Imposta su 1 per disabilitare il supporto della finestra del contesto 1M. Se impostato, le varianti del modello 1M non sono disponibili nel selettore di modelli. Utile per ambienti aziendali con requisiti di conformità |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING |
Imposta su 1 per disabilitare il ragionamento adattivo su Opus 4.6 e Sonnet 4.6 e tornare al budget di thinking fisso controllato da MAX_THINKING_TOKENS. {/* min-version: 2.1.111 */}Non ha effetto su Opus 4.7, che utilizza sempre il ragionamento adattivo |
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN |
Imposta su 1 per disabilitare il rendering a schermo intero e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del tuo 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. Puoi anche passare con /tui default |
CLAUDE_CODE_DISABLE_ATTACHMENTS |
Imposta su 1 per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi @ vengono inviate come testo semplice invece di essere espanse nel contenuto del file |
CLAUDE_CODE_DISABLE_AUTO_MEMORY |
Imposta su 1 per disabilitare la memoria automatica. Imposta su 0 per forzare la memoria automatica durante il rollout graduale quando autoMemoryEnabled: false altrimenti la disabiliterebbe. Quando disabilitato, Claude non crea o carica i file di memoria automatica |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS |
Imposta su 1 per disabilitare tutta la funzionalità di attività in background, incluso il parametro run_in_background su strumenti Bash e subagent, auto-backgrounding e la scorciatoia Ctrl+B |
CLAUDE_CODE_DISABLE_CLAUDE_MDS |
Imposta su 1 per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di utente, progetto e memoria automatica |
CLAUDE_CODE_DISABLE_CRON |
Imposta su 1 per disabilitare le attività pianificate. La skill /loop e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse le attività già in esecuzione a metà sessione |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS |
Imposta su 1 per rimuovere le intestazioni di richiesta anthropic-beta specifiche di Anthropic e i campi dello schema degli strumenti beta (come defer_loading e eager_input_streaming) dalle richieste API. Utilizza questo quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the anthropic-beta header" o "Extra inputs are not permitted". I campi standard (name, description, input_schema, cache_control) vengono preservati. |
CLAUDE_CODE_DISABLE_FAST_MODE |
Imposta su 1 per disabilitare la modalità veloce |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY |
Imposta su 1 per disabilitare i sondaggi sulla qualità della sessione "Come sta andando Claude?". I sondaggi sono anche disabilitati quando DISABLE_TELEMETRY o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC è impostato. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizza l'impostazione feedbackSurveyRate. Vedi Sondaggi sulla qualità della sessione |
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING |
Imposta su 1 per disabilitare il checkpointing dei file. Il comando /rewind non sarà in grado di ripristinare le modifiche al codice |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS |
Imposta su 1 per rimuovere le istruzioni di workflow commit e PR integrate e lo snapshot dello stato git dal prompt di sistema di Claude. Utile quando si utilizzano le proprie skill di workflow git. Ha la precedenza sull'impostazione includeGitInstructions se impostato |
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP |
Imposta su 1 per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull'API Anthropic. Utilizza quando desideri intenzionalmente fissare un modello più vecchio. Il remapping non viene eseguito su Bedrock, Vertex o Foundry |
CLAUDE_CODE_DISABLE_MOUSE |
Imposta su 1 per disabilitare il tracciamento del mouse nel rendering a schermo intero. Lo scorrimento da tastiera con PgUp e PgDn funziona ancora. Utilizza questo per mantenere il comportamento nativo di copia al passaggio del mouse del tuo terminale |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
Equivalente all'impostazione di DISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING e DISABLE_TELEMETRY |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK |
Imposta su 1 per disabilitare il fallback non-streaming quando una richiesta di streaming fallisce a metà stream. Gli errori di streaming si propagano al livello di retry. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione duplicata dello strumento |
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL |
Imposta su 1 per saltare l'aggiunta automatica del marketplace ufficiale dei plugin al primo avvio |
CLAUDE_CODE_DISABLE_POLICY_SKILLS |
Imposta su 1 per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni container o CI che non dovrebbero caricare skill fornite dall'operatore |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE |
Imposta su 1 per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione |
CLAUDE_CODE_DISABLE_THINKING |
Imposta 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_SCROLL |
Imposta su 1 per disabilitare lo scorrimento virtuale nel rendering a schermo intero e renderizzare ogni messaggio nella trascrizione. Utilizza questo se lo scorrimento in modalità a schermo intero mostra regioni vuote dove dovrebbero apparire i messaggi |
CLAUDE_CODE_EFFORT_LEVEL |
Imposta il livello di sforzo per i modelli supportati. Valori: low, medium, high, xhigh, max o auto per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su /effort e sull'impostazione effortLevel. Vedi Regola il livello di sforzo |
CLAUDE_CODE_ENABLE_AWAY_SUMMARY |
Sovrascrivi la disponibilità del riepilogo della sessione. Imposta su 0 per forzare i riepiloghi disattivati indipendentemente dall'interruttore /config. Imposta su 1 per forzare i riepiloghi attivati quando awaySummaryEnabled è false. Ha la precedenza sull'impostazione e sull'interruttore /config |
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH |
Imposta su 1 per aggiornare lo stato del plugin ai confini dei turni in modalità non interattiva dopo il completamento di un'installazione in background. Disattivato per impostazione predefinita perché l'aggiornamento cambia il prompt di sistema a metà sessione, il che invalida il caching dei prompt per quel turno |
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING |
Controlla se gli input delle chiamate di strumento vengono trasmessi dall'API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su 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_DISCOVERY |
Imposta su 1 per popolare il selettore /model dall'endpoint /v1/models del tuo gateway quando ANTHROPIC_BASE_URL punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. 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_PROMPT_SUGGESTION |
Imposta su false per disabilitare i suggerimenti di prompt (l'interruttore "Prompt suggestions" in /config). Questi sono i suggerimenti predetti in grigio che appaiono nel tuo input di prompt dopo che Claude risponde. Vedi Suggerimenti di prompt |
CLAUDE_CODE_ENABLE_TASKS |
Imposta su 1 per abilitare il sistema di tracciamento delle attività in modalità non interattiva (il flag -p). Le attività sono abilitate per impostazione predefinita in modalità interattiva. Vedi Elenco attività |
CLAUDE_CODE_ENABLE_TELEMETRY |
Imposta su 1 per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Obbligatorio prima di configurare gli esportatori OTel. Vedi Monitoraggio |
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY |
Tempo in millisecondi da attendere dopo che il loop di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS |
Imposta su 1 per abilitare i team di agenti. I team di agenti sono sperimentali e disabilitati per impostazione predefinita |
CLAUDE_CODE_EXTRA_BODY |
Oggetto JSON da unire al livello superiore di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente |
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS |
Sovrascrivi il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero |
CLAUDE_CODE_FORCE_SYNC_OUTPUT |
Imposta su 1 per forzare l'abilitazione della modalità privata DEC 2026 synchronized output quando il tuo 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_SUBAGENT |
Imposta 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_PATH |
Solo Windows: percorso dell'eseguibile Git Bash (bash.exe). Utilizza quando Git Bash è installato ma non nel tuo PATH. Vedi Configurazione di Windows |
CLAUDE_CODE_GLOB_HIDDEN |
Imposta su false per escludere i dotfile dai risultati quando Claude richiama lo strumento Glob. Incluso per impostazione predefinita. Non influisce su @ file autocomplete, ls, Grep o Read |
CLAUDE_CODE_GLOB_NO_IGNORE |
Imposta su false per fare in modo che lo strumento Glob rispetti i modelli .gitignore. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su @ file autocomplete, che ha la sua propria impostazione respectGitignore |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS |
Timeout in secondi per la scoperta dei file dello strumento Glob. Per impostazione predefinita 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |
CLAUDE_CODE_HIDE_CWD |
Imposta su 1 per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni in cui il percorso espone il tuo nome utente del sistema operativo |
CLAUDE_CODE_IDE_HOST_OVERRIDE |
Sovrascrivi l'indirizzo host utilizzato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso il routing WSL-to-Windows |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL |
Salta l'installazione automatica delle estensioni IDE. Equivalente all'impostazione di autoInstallIdeExtension su false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK |
Imposta su 1 per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizza quando l'auto-connessione non riesce a trovare il tuo IDE nonostante sia in esecuzione |
CLAUDE_CODE_MAX_CONTEXT_TOKENS |
Sovrascrivi la dimensione della finestra del contesto che Claude Code assume per il modello attivo. Ha effetto solo quando DISABLE_COMPACT è anche impostato. Utilizza questo quando instrada a un modello attraverso ANTHROPIC_BASE_URL la cui finestra del contesto non corrisponde alla dimensione integrata per il suo nome |
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e massimi variano in base al modello; vedi max output tokens. L'aumento di questo valore riduce la finestra del contesto effettiva disponibile prima che venga attivata la compattazione automatica. |
CLAUDE_CODE_MAX_RETRIES |
Sovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10) |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY |
Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |
CLAUDE_CODE_MCP_ALLOWLIST_ENV |
Imposta su 1 per generare server MCP stdio con solo un ambiente di base sicuro più il env configurato del server, invece di ereditare l'ambiente della tua shell |
CLAUDE_CODE_NEW_INIT |
Imposta su 1 per fare in modo che /init esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare la base di codice e scriverli. Senza questa variabile, /init genera un CLAUDE.md automaticamente senza chiedere. |
CLAUDE_CODE_NO_FLICKER |
Imposta su 1 per abilitare il rendering a schermo intero, un'anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Equivalente all'impostazione tui; puoi anche passare con /tui fullscreen |
CLAUDE_CODE_OAUTH_REFRESH_TOKEN |
Token di aggiornamento OAuth per l'autenticazione Claude.ai. Se impostato, claude auth login scambia questo token direttamente invece di aprire un browser. Richiede CLAUDE_CODE_OAUTH_SCOPES. Utile per il provisioning dell'autenticazione in ambienti automatizzati |
CLAUDE_CODE_OAUTH_SCOPES |
Ambiti OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come "user:profile user:inference user:sessions:claude_code". Obbligatorio quando CLAUDE_CODE_OAUTH_REFRESH_TOKEN è impostato |
CLAUDE_CODE_OAUTH_TOKEN |
Token di accesso OAuth per l'autenticazione Claude.ai. Alternativa a /login per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali archiviate nel portachiavi. Generane uno con claude setup-token |
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS |
Timeout in millisecondi per lo scaricamento dei span OpenTelemetry in sospeso (predefinito: 5000). Vedi Monitoraggio |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS |
Intervallo per l'aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedi Intestazioni dinamiche |
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS |
Timeout in millisecondi per l'esportatore OpenTelemetry per terminare all'arresto (predefinito: 2000). Aumenta se le metriche vengono eliminate all'uscita. Vedi Monitoraggio |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE |
Imposta su 1 per consentire a Claude Code di eseguire il comando di aggiornamento del tuo gestore di pacchetti in background quando una nuova versione è disponibile. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedi Aggiornamenti automatici |
CLAUDE_CODE_PERFORCE_MODE |
Imposta su 1 per abilitare la protezione da scrittura consapevole di Perforce. Se impostato, Edit, Write e NotebookEdit falliscono con un suggerimento p4 edit <file> se il file di destinazione manca del bit di scrittura del proprietario, che Perforce cancella sui file sincronizzati fino a quando p4 edit non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |
CLAUDE_CODE_PLUGIN_CACHE_DIR |
Sovrascrivi la directory radice dei plugin. Nonostante il nome, questo imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory sotto questo percorso. Per impostazione predefinita ~/.claude/plugins |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS |
Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Vedi Le operazioni Git scadono |
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE |
Imposta su 1 per mantenere la cache del marketplace esistente quando un git pull fallisce invece di cancellare e ri-clonare. Utile in ambienti offline o airgapped dove il ri-cloning fallirebbe allo stesso modo. Vedi Gli aggiornamenti del marketplace falliscono in ambienti offline |
CLAUDE_CODE_PLUGIN_SEED_DIR |
Percorso di una o più directory di seed plugin di sola lettura, separate da : su Unix o ; su Windows. Utilizza questo per raggruppare una directory plugin pre-popolata in un'immagine container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati nella cache senza ri-clonare. Vedi Pre-popola i plugin per i container |
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST |
Impostato da piattaforme host che incorporano Claude Code e gestiscono l'instradamento del provider di modelli per suo conto. Se impostato, la selezione del provider, l'endpoint e le variabili di autenticazione come CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY nei file di impostazioni vengono ignorate in modo che le impostazioni dell'utente non possono sovrascrivere l'instradamento dell'host. Anche l'opt-out automatico della telemetria per 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_HOSTS |
Imposta su 1 per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per ambienti in cui il proxy deve gestire la risoluzione del nome host |
CLAUDE_CODE_REMOTE |
Impostato automaticamente su true quando Claude Code è in esecuzione come una sessione cloud. Leggi questo da un hook o script di configurazione per rilevare se sei in un ambiente cloud |
CLAUDE_CODE_REMOTE_SESSION_ID |
Impostato automaticamente nelle sessioni cloud all'ID della sessione corrente. Leggi questo per costruire un collegamento alla trascrizione della sessione. Vedi Collegare gli artefatti alla sessione |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN |
Imposta su 1 per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di reinviare il prompt |
CLAUDE_CODE_SCRIPT_CAPS |
Oggetto JSON che limita quante volte script specifici possono essere richiamati per sessione quando CLAUDE_CODE_SUBPROCESS_ENV_SCRUB è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di chiamate intere. Ad esempio, {"deploy.sh": 2} consente a deploy.sh di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe quindi trucchi di espansione della shell come ./scripts/deploy.sh $(evil) contano comunque rispetto al limite. Il fan-out di runtime tramite xargs o find -exec non viene rilevato; questo è un controllo di difesa in profondità |
CLAUDE_CODE_SCROLL_SPEED |
Imposta il moltiplicatore di scorrimento della rotella del mouse nel rendering a schermo intero. Accetta valori da 1 a 20. Imposta su 3 per corrispondere a vim se il tuo terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS |
Sovrascrivi il budget di tempo in millisecondi per gli hook SessionEnd. Si applica all'uscita della sessione, /clear e al cambio di sessioni tramite /resume interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al massimo timeout per hook configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget |
CLAUDE_CODE_SESSION_ID |
Impostato automaticamente nei sottoprocessi dello strumento Bash e PowerShell all'ID della sessione corrente. 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_SHELL |
Sovrascrivi il rilevamento automatico della shell. Utile quando la tua shell di login differisce dalla tua shell di lavoro preferita (ad esempio, bash vs zsh) |
CLAUDE_CODE_SHELL_PREFIX |
Prefisso 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_SIMPLE |
Imposta su 1 per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura file e modifica file. Gli strumenti MCP da --mcp-config sono ancora disponibili. Disabilita l'auto-discovery di hook, skill, plugin, server MCP, memoria automatica e CLAUDE.md. Il flag CLI --bare imposta questo |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT |
Imposta su 1 per utilizzare il prompt di sistema minimo e le descrizioni degli strumenti compresse su Opus 4.7. Non ha effetto su altri modelli. Il set di strumenti completo, hook, server MCP e scoperta CLAUDE.md rimangono abilitati |
CLAUDE_CODE_SKIP_BEDROCK_AUTH |
Salta l'autenticazione AWS per Bedrock (ad esempio, quando si utilizza un gateway LLM) |
CLAUDE_CODE_SKIP_FOUNDRY_AUTH |
Salta l'autenticazione Azure per Microsoft Foundry (ad esempio, quando si utilizza un gateway LLM) |
CLAUDE_CODE_SKIP_MANTLE_AUTH |
Salta l'autenticazione AWS per Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM) |
CLAUDE_CODE_SKIP_PROMPT_HISTORY |
Imposta su 1 per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in --resume, --continue o nella cronologia della freccia su. Utile per sessioni di script effimere |
CLAUDE_CODE_SKIP_VERTEX_AUTH |
Salta l'autenticazione Google per Vertex (ad esempio, quando si utilizza un gateway LLM) |
CLAUDE_CODE_SUBAGENT_MODEL |
Vedi Configurazione del modello |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB |
Imposta su 1 per rimuovere le credenziali Anthropic e del provider cloud dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio). Il processo Claude padre mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l'esposizione agli attacchi di prompt injection che tentano di esfiltare i segreti tramite l'espansione della shell. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi PID isolato in modo che non possano leggere gli ambienti dei processi host tramite /proc; come effetto collaterale, ps, pgrep e kill non possono vedere o segnalare i processi host. claude-code-action imposta questo automaticamente quando allowed_non_write_users è configurato |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL |
Imposta su 1 in modalità non interattiva (il flag -p) per attendere il completamento dell'installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combina con CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS per limitare l'attesa |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS |
Timeout in millisecondi per l'installazione sincrona del plugin. Se superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |
CLAUDE_CODE_SYNTAX_HIGHLIGHT |
Imposta su false per disabilitare l'evidenziazione della sintassi nell'output diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disabilitare anche l'evidenziazione nei blocchi di codice e nelle anteprime di file, utilizza l'impostazione syntaxHighlightingDisabled |
CLAUDE_CODE_TASK_LIST_ID |
Condividi un elenco di attività tra le sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso. Vedi Elenco attività |
CLAUDE_CODE_TEAM_NAME |
Nome del team di agenti a cui appartiene questo compagno di squadra. Impostato automaticamente sui membri del team di agenti |
CLAUDE_CODE_TMPDIR |
Sovrascrivi 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_TRUECOLOR |
Imposta su 1 per consentire l'output truecolor a 24 bit all'interno di tmux. Per impostazione predefinita, Claude Code si limita a 256 colori quando $TMUX è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato per farlo. Imposta questo dopo aver aggiunto set -ga terminal-overrides ',*:Tc' al tuo ~/.tmux.conf. Vedi Configurazione del terminale per altre impostazioni di tmux |
CLAUDE_CODE_USE_BEDROCK |
Utilizza Bedrock |
CLAUDE_CODE_USE_FOUNDRY |
Utilizza Microsoft Foundry |
CLAUDE_CODE_USE_MANTLE |
Utilizza l'endpoint Mantle di Bedrock |
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH |
Imposta su 1 per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Imposta questo se il binario ripgrep raggruppato non è disponibile o bloccato nel tuo ambiente. Non influisce su Grep o strumenti di ricerca file |
CLAUDE_CODE_USE_POWERSHELL_TOOL |
Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta su 0 per disabilitarlo. Su Windows con Git Bash installato, lo strumento è in rollout progressivo: imposta su 1 per aderire o 0 per rinunciare. Su Linux, macOS e WSL, imposta su 1 per abilitarlo, che richiede pwsh nel tuo PATH. Se abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedi Strumento PowerShell |
CLAUDE_CODE_USE_VERTEX |
Utilizza Vertex |
CLAUDE_CONFIG_DIR |
Sovrascrivi 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_EFFORT |
Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al livello di sforzo attivo per il turno: low, medium, high, xhigh o max. Corrisponde al campo effort.level passato agli hook. Impostato solo quando il modello corrente supporta il parametro effort |
CLAUDE_ENABLE_BYTE_WATCHDOG |
Imposta su 1 per forzare l'abilitazione del watchdog di inattività a livello di byte, o imposta su 0 per forzare la disabilitazione. Se non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic. 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_STREAM_WATCHDOG |
Imposta su 1 per abilitare il watchdog di inattività dello streaming a livello di evento. Disattivato per impostazione predefinita. Per Bedrock, Vertex e Foundry, questo è l'unico watchdog di inattività disponibile. Configura il timeout con CLAUDE_STREAM_IDLE_TIMEOUT_MS |
CLAUDE_ENV_FILE |
Percorso di uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizza per persistere l'attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente dagli hook SessionStart, Setup, CwdChanged e FileChanged |
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX |
Prefisso per i nomi delle sessioni Remote Control generati automaticamente quando non viene fornito un nome esplicito. Per impostazione predefinita il nome host della tua macchina, producendo nomi come myhost-graceful-unicorn. Il flag CLI --remote-control-session-name-prefix imposta lo stesso valore per una singola invocazione |
CLAUDE_STREAM_IDLE_TIMEOUT_MS |
Timeout in millisecondi prima che il watchdog di inattività dello streaming chiuda una connessione bloccata. 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 |
DISABLE_AUTOUPDATER |
Imposta su 1 per disabilitare gli aggiornamenti automatici in background. Il manuale claude update funziona ancora. Utilizza DISABLE_UPDATES per bloccare entrambi |
DISABLE_AUTO_COMPACT |
Imposta su 1 per disabilitare la compattazione automatica quando ci si avvicina al limite del contesto. Il comando manuale /compact rimane disponibile. Utilizza quando desideri un controllo esplicito su quando si verifica la compattazione |
DISABLE_COMPACT |
Imposta su 1 per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale /compact |
DISABLE_COST_WARNINGS |
Imposta su 1 per disabilitare i messaggi di avviso sui costi |
DISABLE_DOCTOR_COMMAND |
Imposta su 1 per nascondere il comando /doctor. Utile per distribuzioni gestite in cui gli utenti non dovrebbero eseguire diagnostiche di installazione |
DISABLE_ERROR_REPORTING |
Imposta su 1 per rinunciare alla segnalazione degli errori di Sentry |
DISABLE_EXTRA_USAGE_COMMAND |
Imposta su 1 per nascondere il comando /extra-usage che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità |
DISABLE_FEEDBACK_COMMAND |
Imposta su 1 per disabilitare il comando /feedback. Il nome più vecchio DISABLE_BUG_COMMAND è anche accettato |
DISABLE_GROWTHBOOK |
Imposta su 1 per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i valori predefiniti del codice per ogni flag. La registrazione degli eventi di telemetria rimane attiva a meno che DISABLE_TELEMETRY non sia anche impostato |
DISABLE_INSTALLATION_CHECKS |
Imposta su 1 per disabilitare gli avvisi di installazione. Utilizza solo quando gestisci manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard |
DISABLE_INSTALL_GITHUB_APP_COMMAND |
Imposta su 1 per nascondere il comando /install-github-app. Già nascosto quando si utilizzano provider di terze parti (Bedrock, Vertex o Foundry) |
DISABLE_INTERLEAVED_THINKING |
Imposta su 1 per impedire l'invio dell'intestazione beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il thinking interleaved |
DISABLE_LOGIN_COMMAND |
Imposta su 1 per nascondere il comando /login. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o apiKeyHelper |
DISABLE_LOGOUT_COMMAND |
Imposta su 1 per nascondere il comando /logout |
DISABLE_PROMPT_CACHING |
Imposta su 1 per disabilitare il caching dei prompt per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello) |
DISABLE_PROMPT_CACHING_HAIKU |
Imposta su 1 per disabilitare il caching dei prompt per i modelli Haiku |
DISABLE_PROMPT_CACHING_OPUS |
Imposta su 1 per disabilitare il caching dei prompt per i modelli Opus |
DISABLE_PROMPT_CACHING_SONNET |
Imposta su 1 per disabilitare il caching dei prompt per i modelli Sonnet |
DISABLE_TELEMETRY |
Imposta su 1 per rinunciare alla telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash |
DISABLE_UPDATES |
Imposta su 1 per bloccare tutti gli aggiornamenti incluso il manuale claude update e claude install. Più rigoroso di DISABLE_AUTOUPDATER. Utilizza quando distribuisci Claude Code attraverso i tuoi canali e gli utenti non dovrebbero auto-aggiornarsi |
DISABLE_UPGRADE_COMMAND |
Imposta su 1 per nascondere il comando /upgrade |
ENABLE_CLAUDEAI_MCP_SERVERS |
Imposta su false per disabilitare i server MCP claude.ai in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi |
ENABLE_PROMPT_CACHING_1H |
Imposta su 1 per richiedere un TTL della cache dei prompt di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di chiave API, Bedrock, Vertex e Foundry. Gli utenti di abbonamento ricevono automaticamente il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più elevata |
ENABLE_PROMPT_CACHING_1H_BEDROCK |
Deprecato. Utilizza ENABLE_PROMPT_CACHING_1H invece |
ENABLE_TOOL_SEARCH |
Controlla la ricerca degli strumenti MCP. Non impostato: tutti gli strumenti MCP differiti per impostazione predefinita, ma caricati in primo piano su Vertex AI o quando ANTHROPIC_BASE_URL punta a un host non di prima parte. Valori: true (sempre differire inclusi i proxy e Vertex AI), 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_MODELS |
Imposta 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_PLUGINS |
Imposta su 1 per forzare gli aggiornamenti automatici dei plugin anche quando l'auto-updater principale è disabilitato tramite DISABLE_AUTOUPDATER |
FORCE_PROMPT_CACHING_5M |
Imposta su 1 per forzare il TTL della cache dei prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce ENABLE_PROMPT_CACHING_1H |
HTTP_PROXY |
Specifica il server proxy HTTP per le connessioni di rete |
HTTPS_PROXY |
Specifica il server proxy HTTPS per le connessioni di rete |
IS_DEMO |
Imposta su 1 per abilitare la modalità demo: nasconde la tua email e il nome dell'organizzazione dall'intestazione e dall'output /status, e salta l'onboarding. Utile quando si trasmette in streaming o si registra una sessione |
MAX_MCP_OUTPUT_TOKENS |
Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano anthropic/maxResultSizeChars utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da questi strumenti è ancora soggetto a questa variabile (predefinito: 25000) |
MAX_STRUCTURED_OUTPUT_RETRIES |
Numero di volte per riprovare quando la risposta del modello non supera la convalida rispetto a --json-schema in modalità non interattiva (il flag -p). Per impostazione predefinita 5 |
MAX_THINKING_TOKENS |
Sovrascrivi il budget del token di extended thinking. Il massimale è il max output tokens del modello meno uno. Imposta su 0 per disabilitare 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_SECRET |
Segreto client OAuth per i server MCP che richiedono credenziali preconfigurate. Evita il prompt interattivo quando si aggiunge un server con --client-secret |
MCP_CONNECTION_NONBLOCKING |
Imposta su true in modalità non interattiva (-p) per saltare completamente l'attesa della connessione MCP. Utile per pipeline con script in cui gli strumenti MCP non sono necessari. Senza questa variabile, la prima query attende fino a 5 secondi per le connessioni del server --mcp-config. I server configurati con alwaysLoad: true bloccano sempre l'avvio indipendentemente da questa variabile, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt |
MCP_CONNECT_TIMEOUT_MS |
Quanto tempo la prima query attende, in millisecondi, per il batch di connessione MCP prima di acquisire uno snapshot dell'elenco degli strumenti (predefinito: 5000). 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. Più rilevante per le sessioni non interattive che emettono una singola query e hanno bisogno che i server a connessione lenta siano visibili |
MCP_OAUTH_CALLBACK_PORT |
Porta fissa per il callback di reindirizzamento OAuth, come alternativa a --callback-port quando si aggiunge un server MCP con credenziali preconfigurate |
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE |
Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |
MCP_SERVER_CONNECTION_BATCH_SIZE |
Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |
MCP_TIMEOUT |
Timeout in millisecondi per l'avvio del server MCP (predefinito: 30000, o 30 secondi) |
MCP_TOOL_TIMEOUT |
Timeout in millisecondi per l'esecuzione dello strumento MCP (predefinito: 100000000, circa 28 ore) |
NO_PROXY |
Elenco di domini e IP a cui le richieste verranno emesse direttamente, bypassando il proxy |
OTEL_LOG_RAW_API_BODIES |
Emetti il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log api_request_body / api_response_body. Imposta su 1 per i corpi inline troncati a 60 KB, o file:<dir> per scrivere i corpi non troncati su disco ed emettere un percorso body_ref invece. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Vedi Monitoraggio |
OTEL_LOG_TOOL_CONTENT |
Imposta su 1 per includere il contenuto di input e output dello strumento negli eventi span OpenTelemetry. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedi Monitoraggio |
OTEL_LOG_TOOL_DETAILS |
Imposta su 1 per includere gli argomenti di input dello strumento, i nomi dei server MCP, 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_PROMPTS |
Imposta su 1 per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedi Monitoraggio |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID |
Imposta su false per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedi Monitoraggio |
OTEL_METRICS_INCLUDE_SESSION_ID |
Imposta su false per escludere l'ID della sessione dagli attributi delle metriche (predefinito: incluso). Vedi Monitoraggio |
OTEL_METRICS_INCLUDE_VERSION |
Imposta su true per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Vedi Monitoraggio |
SLASH_COMMAND_TOOL_CHAR_BUDGET |
Sovrascrivi il budget dei caratteri per i metadati della skill mostrati allo strumento Skill. Il budget si ridimensiona dinamicamente all'1% della finestra del contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per la compatibilità all'indietro |
TASK_MAX_OUTPUT_LENGTH |
Numero massimo di caratteri nell'output del subagent prima del troncamento (predefinito: 32000, massimo: 160000). Se troncato, l'output completo viene salvato su disco e il percorso è incluso nella risposta troncata |
USE_BUILTIN_RIPGREP |
Imposta su 0 per utilizzare il rg installato dal sistema invece del rg incluso con Claude Code |
VERTEX_REGION_CLAUDE_3_5_HAIKU |
Sovrascrivi la regione per Claude 3.5 Haiku quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_3_5_SONNET |
Sovrascrivi la regione per Claude 3.5 Sonnet quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_3_7_SONNET |
Sovrascrivi la regione per Claude 3.7 Sonnet quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_0_OPUS |
Sovrascrivi la regione per Claude 4.0 Opus quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_0_SONNET |
Sovrascrivi la regione per Claude 4.0 Sonnet quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_1_OPUS |
Sovrascrivi la regione per Claude 4.1 Opus quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_5_OPUS |
Sovrascrivi la regione per Claude Opus 4.5 quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_5_SONNET |
Sovrascrivi la regione per Claude Sonnet 4.5 quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_6_OPUS |
Sovrascrivi la regione per Claude Opus 4.6 quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_6_SONNET |
Sovrascrivi la regione per Claude Sonnet 4.6 quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_4_7_OPUS |
{/* min-version: 2.1.111 */}Sovrascrivi la regione per Claude Opus 4.7 quando si utilizza Vertex AI |
VERTEX_REGION_CLAUDE_HAIKU_4_5 |
Sovrascrivi 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
- Impostazioni: configura le variabili d'ambiente in
settings.jsonin modo che si applichino a ogni sessione - Riferimento CLI: flag di avvio
- Configurazione di rete: configurazione proxy e TLS
- Monitoraggio: configurazione OpenTelemetry