Reference | 环境变量完整清单(~400 个)¶
来源:
grep -rhE "process\.env\.[A-Z_][A-Z0-9_]*" src/ | sort -u关联:topics/dce-feature-flags.md 的 env vs feature 区别
按用途分类¶
1. Anthropic / Claude API 配置(15)¶
ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
ANTHROPIC_BEDROCK_BASE_URL
ANTHROPIC_BETAS
ANTHROPIC_CUSTOM_HEADERS
ANTHROPIC_CUSTOM_MODEL_OPTION
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME
ANTHROPIC_DEFAULT_HAIKU_MODEL / _DESCRIPTION / _NAME
ANTHROPIC_DEFAULT_OPUS_MODEL / _DESCRIPTION / _NAME
ANTHROPIC_DEFAULT_SONNET_MODEL / _DESCRIPTION / _NAME
ANTHROPIC_FOUNDRY_API_KEY
ANTHROPIC_FOUNDRY_BASE_URL
ANTHROPIC_FOUNDRY_RESOURCE
ANTHROPIC_MODEL
ANTHROPIC_SMALL_FAST_MODEL
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION
ANTHROPIC_UNIX_SOCKET
ANTHROPIC_VERTEX_PROJECT_ID
2. Claude Code 行为控制(~200 个,最重要)¶
功能开关(DISABLE_*):
- CLAUDE_CODE_DISABLE_TELEMETRY
- CLAUDE_CODE_DISABLE_THINKING
- CLAUDE_CODE_DISABLE_BACKGROUND_TASKS
- CLAUDE_CODE_DISABLE_AUTO_MEMORY
- CLAUDE_CODE_DISABLE_ATTACHMENTS
- CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING
- CLAUDE_CODE_DISABLE_FAST_MODE
- CLAUDE_CODE_DISABLE_MOUSE / _MOUSE_CLICKS
- CLAUDE_CODE_DISABLE_CLAUDE_MDS
- CLAUDE_CODE_DISABLE_COMMAND_INJECTION_CHECK
- CLAUDE_CODE_DISABLE_CRON
- CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS
- CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY
- CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING
- CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS
- CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP
- CLAUDE_CODE_DISABLE_MESSAGE_ACTIONS
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
- CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK
- CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL
- CLAUDE_CODE_DISABLE_POLICY_SKILLS
- CLAUDE_CODE_DISABLE_PRECOMPACT_SKIP
- CLAUDE_CODE_DISABLE_TERMINAL_TITLE
- CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL
- CLAUDE_CODE_DISABLE_1M_CONTEXT
- CLAUDE_CODE_DISABLE_ADVISOR_TOOL
启用功能(ENABLE_*):
- CLAUDE_CODE_ENABLE_CFC
- CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING
- CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION
- CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING
- CLAUDE_CODE_ENABLE_TASKS
- CLAUDE_CODE_ENABLE_TELEMETRY
- CLAUDE_CODE_ENABLE_TOKEN_USAGE_ATTACHMENT
- CLAUDE_CODE_ENABLE_XAA
提供商选择:
- CLAUDE_CODE_USE_BEDROCK / CLAUDE_CODE_USE_VERTEX / CLAUDE_CODE_USE_FOUNDRY / CLAUDE_CODE_USE_CCR_V2 / CLAUDE_CODE_USE_COWORK_PLUGINS / CLAUDE_CODE_USE_NATIVE_FILE_SEARCH / CLAUDE_CODE_USE_POWERSHELL_TOOL
会话控制:
- CLAUDE_CODE_SESSION_ID / CLAUDE_CODE_SESSION_NAME / CLAUDE_CODE_SESSION_KIND / CLAUDE_CODE_SESSION_LOG
- CLAUDE_CODE_REMOTE_SESSION_ID
- CLAUDE_CODE_RESUME_INTERRUPTED_TURN
- CLAUDE_CODE_AGENT / CLAUDE_CODE_SUBAGENT_MODEL
- CLAUDE_CODE_AGENT_LIST_IN_MESSAGES
- CLAUDE_CODE_TAGS / CLAUDE_CODE_SESSION_ACCESS_TOKEN
- CLAUDE_CODE_AUTO_CONNECT_IDE
- CLAUDE_CODE_IDE_HOST_OVERRIDE
- CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL / CLAUDE_CODE_IDE_SKIP_VALID_CHECK
调试 / 性能:
- CLAUDE_CODE_DEBUG_LOG_LEVEL / CLAUDE_CODE_DEBUG_LOGS_DIR / CLAUDE_CODE_DEBUG_REPAINTS
- CLAUDE_CODE_PROFILE_STARTUP / CLAUDE_CODE_PROFILE_QUERY
- CLAUDE_CODE_FRAME_TIMING_LOG
- CLAUDE_CODE_FPS_LOG(推测)
- CLAUDE_CODE_PERFETTO_TRACE / CLAUDE_CODE_PERFETTO_WRITE_INTERVAL_S
- CLAUDE_CODE_SLOW_OPERATION_THRESHOLD_MS
- CLAUDE_CODE_STALL_TIMEOUT_MS_FOR_TESTING
- CLAUDE_CODE_NO_FLICKER
- CLAUDE_CODE_EAGER_FLUSH
- CLAUDE_CODE_STREAMLINED_OUTPUT
- CLAUDE_CODE_SIMPLE
- CLAUDE_CODE_SHELL / CLAUDE_CODE_SHELL_PREFIX
- CLAUDE_CODE_BASH_MAINTAIN_PROJECT_WORKING_DIR
OAuth / 鉴权:
- CLAUDE_CODE_OAUTH_CLIENT_ID / _REFRESH_TOKEN / _TOKEN / _SCOPES
- CLAUDE_CODE_OAUTH_TOKEN_FILE_DESCRIPTOR
- CLAUDE_CODE_API_KEY_FILE_DESCRIPTOR
- CLAUDE_CODE_WEBSOCKET_AUTH_FILE_DESCRIPTOR
- CLAUDE_CODE_CUSTOM_OAUTH_URL
- CLAUDE_CODE_TRUSTED_DEVICE_TOKEN
Bridge / IDE:
- CLAUDE_CODE_BRIDGE_BASE_URL
- CLAUDE_CODE_BRIDGE_OAUTH_TOKEN
- CLAUDE_CODE_BRIDGE_SESSION_INGRESS_URL
- CLAUDE_CODE_BRIDGE_USE_CCR_V2
- CLAUDE_CODE_REMOTE_ENVIRONMENT_TYPE
- CLAUDE_CODE_REMOTE_MEMORY_DIR
- CLAUDE_CODE_REMOTE_SEND_KEEPALIVES
Plan / Brief:
- CLAUDE_CODE_BRIEF / CLAUDE_CODE_BRIEF_UPLOAD
- CLAUDE_CODE_PLAN_MODE_REQUIRED / _INTERVIEW_PHASE
- CLAUDE_CODE_PLAN_V2_AGENT_COUNT / _V2_EXPLORE_AGENT_COUNT
- CLAUDE_CODE_ULTRAPLAN_PROMPT_FILE
容器 / 部署:
- CLAUDE_CODE_REMOTE / CLAUDE_CODE_REPL
- CLAUDE_CODE_CONTAINER_ID
- CLAUDE_CODE_BASE_REF
- CLAUDE_CODE_BUBBLEWRAP
- CLAUDE_CODE_CCR_MIRROR
- CLAUDE_CODE_AUTO_BACKGROUND_TASKS
- CLAUDE_CODE_EXIT_AFTER_FIRST_RENDER / _AFTER_STOP_DELAY
- CLAUDE_CODE_ENTRYPOINT
- CLAUDE_CODE_ENVIRONMENT_KIND / _RUNNER_VERSION
- CLAUDE_CODE_WORKSPACE_HOST_PATHS
- CLAUDE_CODE_WORKER_EPOCH
- CLAUDE_CODE_CLIENT_CERT / _KEY / _KEY_PASSPHRASE
- CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
- CLAUDE_CODE_PROXY_RESOLVES_HOSTS
实验性功能:
- CLAUDE_CODE_UNDERCOVER
- CLAUDE_CODE_FORCE_FULL_LOGO
- CLAUDE_CODE_QUESTION_PREVIEW_FORMAT
- CLAUDE_CODE_SYNTAX_HIGHLIGHT
- CLAUDE_CODE_VERIFY_PLAN
- CLAUDE_CODE_NEW_INIT
- CLAUDE_CODE_AUTOCOMPACT_PCT_OVERRIDE
- CLAUDE_CODE_AUTO_COMPACT_WINDOW
- CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE
- CLAUDE_CODE_COORDINATOR_MODE
- CLAUDE_CODE_COWORKER_TYPE
- CLAUDE_CODE_DUMP_AUTO_MODE
- CLAUDE_CODE_EFFORT_LEVEL
- CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS
- CLAUDE_CODE_EMIT_TOOL_USE_SUMMARIES
- CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
- CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS
- CLAUDE_CODE_GIT_BASH_PATH
- CLAUDE_CODE_GLOB_HIDDEN / CLAUDE_CODE_GLOB_NO_IGNORE / CLAUDE_CODE_GLOB_TIMEOUT_SECONDS
- CLAUDE_CODE_HOST_PLATFORM
- CLAUDE_CODE_IDLE_THRESHOLD_MINUTES / _IDLE_TOKEN_THRESHOLD
- CLAUDE_CODE_INCLUDE_PARTIAL_MESSAGES
- CLAUDE_CODE_IS_COWORK
- CLAUDE_CODE_JSONL_TRANSCRIPT
- CLAUDE_CODE_MAX_CONTEXT_TOKENS / _MAX_OUTPUT_TOKENS
- CLAUDE_CODE_MAX_RETRIES / _MAX_TOOL_USE_CONCURRENCY
- CLAUDE_CODE_MCP_INSTR_DELTA
- CLAUDE_CODE_MESSAGING_SOCKET
- CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS / _OTEL_HEADERS_HELPER_DEBOUNCE_MS / _OTEL_SHUTDOWN_TIMEOUT_MS
- CLAUDE_CODE_OVERRIDE_DATE
- CLAUDE_CODE_PLAN_MODE_INTERVIEW_PHASE (重复)
- CLAUDE_CODE_PLUGIN_CACHE_DIR / _PLUGIN_GIT_TIMEOUT_MS / _PLUGIN_SEED_DIR / _PLUGIN_USE_ZIP_CACHE
- CLAUDE_CODE_POST_FOR_SESSION_INGRESS_V2
- CLAUDE_CODE_PROACTIVE
- CLAUDE_CODE_PWSH_PARSE_TIMEOUT_MS
- CLAUDE_CODE_SAVE_HOOK_ADDITIONAL_CONTEXT
- CLAUDE_CODE_SCROLL_SPEED
- CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS
- CLAUDE_CODE_SKIP_BEDROCK_AUTH / _SKIP_FOUNDRY_AUTH / _SKIP_VERTEX_AUTH
- CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS
- CLAUDE_CODE_SKIP_PROMPT_HISTORY
- CLAUDE_CODE_SUBPROCESS_ENV_SCRUB
- CLAUDE_CODE_SYNC_PLUGIN_INSTALL / _SYNC_PLUGIN_INSTALL_TIMEOUT_MS
- CLAUDE_CODE_TELEMETRY(推测)
- CLAUDE_CODE_TMPDIR
- CLAUDE_CODE_TMUX_PREFIX / _CONFLICTS / _SESSION / _TRUECOLOR
- CLAUDE_CODE_TWO_STAGE_CLASSIFIER
- CLAUDE_CODE_UNATTENDED_RETRY
- CLAUDE_CODE_USER_EMAIL
- CLAUDE_CODE_WORKER_EPOCH (重复)
配置路径:
- CLAUDE_CONFIG_DIR
- CLAUDE_CODE_MANAGED_SETTINGS_PATH
- CLAUDE_CODE_REMOTE_MEMORY_DIR (重复)
事件 / 状态:
- CLAUDE_CODE_BASH_SANDBOX_SHOW_INDICATOR
- CLAUDE_CODE_CHROME_PERMISSION_MODE
- CLAUDE_CODE_ACCOUNT_TAGGED_ID / _ACCOUNT_UUID
- CLAUDE_CODE_ACTION
- CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD
- CLAUDE_CODE_ADDITIONAL_PROTECTION
- CLAUDE_CODE_ALWAYS_ENABLE_EFFORT
- CLAUDE_CODE_API_BASE_URL
- CLAUDE_CODE_API_KEY_HELPER_TTL_MS
- CLAUDE_CODE_ATTRIBUTION_HEADER
- CLAUDE_CODE_COMMIT_LOG
- CLAUDE_CODE_ENHANCED_TELEMETRY_BETA
- CLAUDE_CODE_ENVIRONMENT_KIND (重复)
- CLAUDE_CODE_TEST_FIXTURES_ROOT
- CLAUDE_CODE_TERMINAL_RECORDING
- CLAUDE_CODE_TASK_LIST_ID
- CLAUDE_CODE_SSE_PORT
3. Claude 通用(非 CODE)¶
CLAUDE_AFTER_LAST_COMPACTCLAUDE_AGENT_SDK_CLIENT_APPCLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSCLAUDE_AGENT_SDK_MCP_NO_PREFIXCLAUDE_AGENT_SDK_VERSIONCLAUDE_AUTO_BACKGROUND_TASKS(重复)CLAUDE_AUTOCOMPACT_PCT_OVERRIDE(重复)CLAUDE_BRIDGE_*(重复)CLAUDE_DEBUGCLAUDE_ENABLE_STREAM_WATCHDOGCLAUDE_ENV_FILECLAUDE_FORCE_DISPLAY_SURVEYCLAUDE_INTERNAL_FC_OVERRIDESCLAUDE_JOB_DIRCLAUDE_LOCAL_OAUTH_API_BASE/_OAUTH_APPS_BASE/_OAUTH_CONSOLE_BASECLAUDE_MOCK_HEADERLESS_429CLAUDE_MORERIGHTCLAUDE_REPL_MODECLAUDE_SESSION_INGRESS_TOKEN_FILECLAUDE_STREAM_IDLE_TIMEOUT_MSCLAUDE_TRUSTED_DEVICE_TOKEN(重复)CLAUDE_COWORK_MEMORY_EXTRA_GUIDELINESCLAUDE_COWORK_MEMORY_PATH_OVERRIDE
4. MCP 相关¶
MCP_CLIENT_SECRETMCP_OAUTH_CALLBACK_PORTMCP_OAUTH_CLIENT_METADATA_URLMCP_REMOTE_SERVER_CONNECTION_BATCH_SIZEMCP_SERVER_CONNECTION_BATCH_SIZEMCP_TIMEOUTMCP_TOOL_TIMEOUTMCP_XAA_IDP_CLIENT_SECRETMAX_MCP_OUTPUT_TOKENS
5. OpenTelemetry (OTel)¶
OTEL_EXPORTER_OTLP_ENDPOINTOTEL_EXPORTER_OTLP_HEADERSOTEL_EXPORTER_OTLP_LOGS_PROTOCOL/_METRICS_PROTOCOL/_TRACES_PROTOCOLOTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCEOTEL_EXPORTER_OTLP_PROTOCOLOTEL_LOG_TOOL_CONTENT/_LOG_TOOL_DETAILS/_LOG_USER_PROMPTSOTEL_LOGS_EXPORT_INTERVAL/_EXPORTEROTEL_METRIC_EXPORT_INTERVAL/_METRICS_EXPORTEROTEL_TRACES_EXPORT_INTERVAL/_TRACES_EXPORTER
6. AWS / Bedrock¶
AWS_BEARER_TOKEN_BEDROCKAWS_DEFAULT_REGIONAWS_EXECUTION_ENVAWS_LAMBDA_FUNCTION_NAMEAWS_REGIONBEDROCK_BASE_URLCLOUD_ML_REGION
7. GCP / Vertex¶
GOOGLE_CLOUD_PROJECTVERTEX_BASE_URL
8. Azure¶
AZURE_FUNCTIONS_ENVIRONMENT
9. CI / 部署平台检测¶
BUILDKITE/CI/CIRCLECI/CF_PAGES/CODESPACES/DENO_DEPLOYMENT_ID/DYNO/FLY_APP_NAME/FLY_MACHINE_ID/GITHUB_ACTIONS/GITLAB_CI/GITPOD_WORKSPACE_ID/KUBERNETES_SERVICE_HOST/K_SERVICE/NETLIFY/RAILWAY_ENVIRONMENT_NAME/RAILWAY_SERVICE_NAME/RENDER/REPL_ID/REPL_SLUG/RUNNER_ENVIRONMENT/RUNNER_OS/SWE_BENCH_INSTANCE_ID/SWE_BENCH_RUN_ID/SWE_BENCH_TASK_ID/VERCEL/WEBSITE_SITE_NAME/WEBSITE_SKU/WSL_DISTRO_NAME/WT_SESSION/COO_CREATOR/COO_RUNNING_ON_HOMESPACE/SAFEUSER/SPACE_CREATOR_USER_ID
10. 终端 / TTY 检测¶
ALACRITTY_LOG/COLORTERM/GNOME_TERMINAL_SERVICE/ITERM_SESSION_ID/KITTY_WINDOW_ID/KONSOLE_VERSION/MSYSTEM/STY/TERM/TERM_PROGRAM/TERM_PROGRAM_VERSION/TERMINAL/TERMINAL_EMULATOR/TERMINATOR_UUID/TILIX_ID/TMUX/TMUX_PANE/VTE_VERSION/WT_SESSION/XTERM_VERSION/ZED_TERM
11. 浏览器¶
BROWSER/VISUAL
12. SSH¶
SSH_CLIENT/SSH_CONNECTION/SSH_TTY
13. Shell¶
EDITOR/PATH/PWD/SHELL/LANG/LC_ALL/LC_TIME
14. 标准环境¶
HOME/USER/USERNAME/USERPROFILE/TMPDIR/TEMP/LOCALAPPDATA/APPDATA/XDG_CONFIG_HOME/P4PORT
15. 网络¶
HTTP_PROXY/HTTPS_PROXY/NO_PROXY/SSL_CERT_FILE/NODE_EXTRA_CA_CERTS
16. 调试¶
DEBUG/DEBUG_SDK/CURSOR_TRACE_ID/BUGHUNTER_DEV_BUNDLE_B64/IS_DEMO/IS_SANDBOX/V/VCR_RECORD/FORCE_VCR/CLAUDE_DEBUG
17. Node 运行时¶
NODE_ENV/NODE_OPTIONS/COREPACK_ENABLE_AUTO_PIN/UV_THREADPOOL_SIZE
18. 测试 / Demo¶
IS_DEMO/DEMO_VERSION/TEST_ENABLE_SESSION_PERSISTENCE/FORCE_AUTOUPDATE_PLUGINS/FORCE_CODE_TERMINAL/ENABLE_*一系列
19. 内部 / Ant¶
ALLOW_ANT_COMPUTER_USE_MCPANT_CLAUDE_CODE_METRICS_ENDPOINTANT_OTEL_EXPORTER_OTLP_ENDPOINT/_HEADERS/_PROTOCOLANT_OTEL_LOGS_EXPORTER/_METRICS_EXPORTER/_TRACES_EXPORTERBETA_TRACING_ENDPOINT/ENABLE_BETA_TRACING_DETAILEDCCR_ENABLE_BUNDLE/CCR_FORCE_BUNDLE/CCR_UPSTREAM_PROXY_ENABLEDCLAUBBITDISABLE_*一系列ENABLE_*一系列SESSION_INGRESS_URLTEAM_MEMORY_SYNC_URLULTRAPLAN_PROMPT_FILEUSE_API_CLEAR_TOOL_RESULTS/_USE_API_CLEAR_TOOL_USESUSE_API_CONTEXT_MANAGEMENTUSE_BUILTIN_RIPGREPUSE_CONNECTOR_TEXT_SUMMARIZATIONUSE_LOCAL_OAUTH/USE_STAGING_OAUTHUSER_TYPEVOICE_STREAM_BASE_URL
20. 其他 / 杂项¶
__CFBCLAUDE_CODE_MANAGED_SETTINGS_PATH(重复)CLAUDE_CODE_TMPDIR(重复)MONOREPO_ROOT_DIRPROJECT_DOMAINSESSIONNAMESLASH_COMMAND_TOOL_CHAR_BUDGETTASK_MAX_OUTPUT_LENGTHBASH_MAX_OUTPUT_LENGTHMAX_STRUCTURED_OUTPUT_RETRIESMAX_THINKING_TOKENSEMBEDDED_SEARCH_TOOLSLOCAL_BRIDGEBAT_THEME
关键洞察¶
1. 400+ env vars 体现"可配置性爆炸"¶
- 用户可改 + 内部可控 + CI 自动设 + 平台检测
- 多 = 灵活
- 也 = 学习曲线陡
2. CLAUDE_CODE_* 是主战场¶
约 200+ 个 CLAUDE_CODE_* env vars。
用户调 Claude Code 行为主要靠这些。
3. 与 feature() 的分工¶
feature('X')= build-time 决定(外部不可见)CLAUDE_CODE_X= runtime 决定(用户可改)
4. DISABLE_* 是"关闭开关"¶
CLAUDE_CODE_DISABLE_* 一系列 = 临时关闭某些功能。
这意味着 Claude Code 默认开启了 30+ 项高级功能,用户可按需关闭。
5. CI / 平台检测是一等公民¶
30+ CI 平台 env vars 都被识别(BUILDKITE、VERCEL、NETLIFY...)。
Claude Code 知道自己在哪个环境跑,会做适配。