6.6 完整环境变量参考手册

基于源码 process.env.* 全量扫描整理。共 70+ 个环境变量，按功能分类。

使用方式

# 一次性使用
ANTHROPIC_MODEL=claude-opus-4-5 claude

# 写入 shell 配置（永久生效）
echo 'export CLAUDE_CODE_DISABLE_THINKING=1' >> ~/.zshrc

# .env 文件（项目级别）
echo 'ANTHROPIC_BASE_URL=http://my-proxy.com' > .env

一、核心 API 配置

环境变量说明示例值
ANTHROPIC_API_KEYAnthropic API 密钥（标准变量）sk-ant-...
ANTHROPIC_BASE_URL覆盖 API 基础 URL（代理/私有部署）https://my-proxy.com
ANTHROPIC_MODEL覆盖默认模型claude-opus-4-5
CLAUDE_CODE_API_BASE_URLFiles API 基础 URL 覆盖https://api.anthropic.com

二、模型与推理控制

环境变量说明默认值
CLAUDE_CODE_MAX_OUTPUT_TOKENS最大输出 token 数模型上限
CLAUDE_CODE_DISABLE_THINKING禁用 Extended Thinkingfalse
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING禁用自适应 thinking budget 调整false
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK禁用非流式回退（出错时）false
MAX_THINKING_TOKENS最大思考 token 数（仅 ant 用户）无
CLAUDE_CODE_DISABLE_FAST_MODE禁用快速模式false

三、功能模式开关

环境变量说明
CLAUDE_CODE_PROACTIVE开启 Proactive 主动自主模式（等同 --proactive）
CLAUDE_CODE_COORDINATOR_MODE开启 Coordinator 多 Agent 编排模式
CLAUDE_CODE_BRIEF开启 Brief 简报模式（KAIROS）
CLAUDE_CODE_SIMPLESimple Worker 模式（Coordinator 专用，缩减工具集）
CLAUDE_CODE_EMIT_TOOL_USE_SUMMARIES触发工具使用摘要生成
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION控制提示建议功能（false 禁用）

四、云平台集成（第三方模型）

环境变量说明
CLAUDE_CODE_USE_BEDROCK使用 AWS Bedrock 作为 API 提供商
CLAUDE_CODE_SKIP_BEDROCK_AUTH跳过 Bedrock 认证（测试/代理场景）
CLAUDE_CODE_USE_VERTEX使用 Google Vertex AI
CLAUDE_CODE_SKIP_VERTEX_AUTH跳过 Vertex 认证（使用 mock GoogleAuth）
CLAUDE_CODE_USE_FOUNDRY使用 Foundry
CLAUDE_CODE_SKIP_FOUNDRY_AUTH跳过 Foundry 认证
ANTHROPIC_FOUNDRY_API_KEYFoundry API 密钥

五、上下文压缩控制

环境变量说明默认值
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEAutoCompact 触发阈值（覆盖自动计算的百分比）自动（约 85%）
CLAUDE_CODE_AUTO_COMPACT_WINDOWAutoCompact 上下文窗口大小上限（token 数）模型上限
CLAUDE_NO_SESSION_PERSISTENCE禁用会话历史持久化（CI 环境推荐）false

六、API 扩展与元数据

环境变量说明示例值
CLAUDE_CODE_EXTRA_BODY附加到 API 请求 body 的 JSON{"betas": ["..."]}
CLAUDE_CODE_EXTRA_METADATA附加到 API 请求的元数据 JSON{"session_type": "dev"}
CLAUDE_CODE_ATTRIBUTION_HEADER归属标识请求头内容任意字符串
CLAUDE_CODE_ADDITIONAL_PROTECTION启用额外保护头部（防止 SSRF 等）true
CLAUDE_CODE_TAGS会话标签（遥测用，随 API 请求上报）project=foo,env=dev
CLAUDE_AGENT_SDK_CLIENT_APPSDK 客户端应用标识（用于 API 请求头）任意字符串

七、身份与认证

环境变量说明
CLAUDE_CODE_OAUTH_TOKEN直接提供 OAuth access token（跳过正常登录流程）
CLAUDE_CODE_OAUTH_REFRESH_TOKENOAuth refresh token
CLAUDE_CODE_ACCOUNT_UUID指定账户 UUID
CLAUDE_CODE_ORGANIZATION_UUID指定组织 UUID
CLAUDE_CODE_CUSTOM_OAUTH_URL自定义 OAuth 服务器 URL

八、性能与限制

环境变量说明默认值
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY最大工具并发执行数10
CLAUDE_CODE_IDLE_THRESHOLD_MINUTES空闲超时阈值（分钟）75
CLAUDE_CODE_UNATTENDED_RETRY无人值守自动重试（UNATTENDED_RETRY feature 下）false

九、记忆与数据

环境变量说明
CLAUDE_CODE_DISABLE_AUTO_MEMORY禁用 EXTRACT_MEMORIES 自动记忆提取
CLAUDE_CODE_CLIENT_CERT客户端 TLS 证书路径（企业 mTLS 场景）

十、UI 与显示

环境变量说明示例值
CLAUDE_CODE_SYNTAX_HIGHLIGHT语法高亮主题（终端代码块）Dracula / base16
BAT_THEME备用语法高亮主题（与 bat 工具共用）Monokai Extended
CLAUDE_CODE_USE_POWERSHELL_TOOL是否使用 PowerShell 工具（Windows）true/false

十一、遥测与可观测性

环境变量说明
CLAUDE_CODE_DATADOG_FLUSH_INTERVAL_MSDataDog 指标 flush 间隔（毫秒）
CLAUDE_CODE_REMOTE标记为远程运行（影响超时设置：300s→120s）
CLAUDE_CODE_REMOTE_ENVIRONMENT_TYPE远程环境类型（遥测上报）
CLAUDE_CODE_REMOTE_SESSION_ID远程会话 ID（遥测关联）
CLAUDE_CODE_CONTAINER_ID容器 ID（遥测关联）
CLAUDE_CODE_HOST_PLATFORM覆盖平台检测（darwin/linux/win32）
CLAUDE_CODE_COWORKER_TYPE协作者类型标记（COWORKER_TYPE_TELEMETRY feature）
CLAUDE_CODE_ACTION标记为 Claude Code Action 运行（GitHub Actions 集成）
GITHUB_ACTIONS标准 GitHub Actions 检测变量
CLAUBBIT标记为 Claubbit 运行（内部工具）

十二、运行模式与入口

环境变量说明可选值
CLAUDE_CODE_ENTRYPOINT运行入口标识cli / local-agent / sdk
CLAUDE_JOB_DIR任务目录（Stop Hook 的任务分类器使用）目录路径

十三、子代理与多代理

环境变量说明
CLAUDE_CODE_PARENT_SESSION_ID父会话 ID（子代理使用）
CLAUDE_CODE_MESSAGING_SOCKET_PATHUnix Domain Socket 路径（UDS_INBOX feature）

十四、仅内部用户（USER_TYPE=ant）

环境变量说明
USER_TYPE用户类型（外部版硬编码为 external，内部版可设为 ant）
CLAUDE_INTERNAL_FC_OVERRIDESGrowthBook 功能覆盖 JSON（例：{"tengu_kairos": true}）
CLAUDE_CODE_GB_BASE_URLGrowthBook API 地址覆盖
ULTRAPLAN_PROMPT_FILEUltraplan 提示文件路径覆盖
SESSION_INGRESS_URL会话入口 URL 覆盖（Bridge 使用）
IS_DEMO演示模式标记
CLAUBBITClaubbit 内部工具标记

十五、第三方标准变量（Claude Code 读取）

环境变量说明
ANTHROPIC_BASE_URLAPI Base URL（Anthropic SDK 标准变量）
NODE_ENV运行环境（test 时部分功能禁用）
HOME / USERPROFILE家目录（配置文件路径计算）
SHELL当前 Shell（Bash/Zsh/Fish 检测）
TERM终端类型（颜色支持检测）

环境变量 vs CLI 参数的关系

部分环境变量与 CLI 参数等价：

环境变量等价 CLI 参数
CLAUDE_CODE_PROACTIVE=1--proactive
CLAUDE_CODE_COORDINATOR_MODE=1（无对应 flag，需用环境变量）
CLAUDE_NO_SESSION_PERSISTENCE=1--no-session-persistence（如果有）
ANTHROPIC_MODEL=xxx--model xxx
ANTHROPIC_BASE_URL=xxx--base-url xxx（部分场景）

常用调试组合

# 切换到 Opus 模型 + 禁用思考（加速测试）
ANTHROPIC_MODEL=claude-opus-4-5 CLAUDE_CODE_DISABLE_THINKING=1 claude

# 使用代理 + 多输出 token
ANTHROPIC_BASE_URL=http://localhost:8080 CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192 claude

# 完全禁用持久化（纯 headless 测试）
CLAUDE_NO_SESSION_PERSISTENCE=1 claude -p "你好"

# 内部用户：覆盖 GrowthBook 开关
CLAUDE_INTERNAL_FC_OVERRIDES='{"tengu_kairos": true}' claude

# 使用 AWS Bedrock
CLAUDE_CODE_USE_BEDROCK=1 ANTHROPIC_MODEL=us.anthropic.claude-opus-4-5-20251101-v1:0 claude

下一步