主题
12.2 环境变量速查
高价值环境变量清单，用于脚本、CI 和企业配置。
说明：环境变量会随版本变化，以官方 env-vars 文档为准。这里收录常用的。
一、模型与后端
| 变量 | 作用 |
|---|---|
ANTHROPIC_MODEL | 默认模型（被 --model 覆盖） |
CLAUDE_CODE_USE_BEDROCK | 设 1 用 Amazon Bedrock 承载 |
CLAUDE_CODE_USE_VERTEX | 设 1 用 Google Cloud Vertex 承载 |
二、记忆与会话
| 变量 | 作用 |
|---|---|
CLAUDE_CODE_DISABLE_AUTO_MEMORY | 设 1 关闭自动记忆 |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD | 设 1 加载 --add-dir 目录的 CLAUDE.md |
CLAUDE_CODE_SKIP_PROMPT_HISTORY | 不保存会话历史 |
CLAUDE_CODE_NEW_INIT | 设 1 启用交互式 /init |
三、启动模式
| 变量 | 作用 |
|---|---|
CLAUDE_CODE_SIMPLE | --bare 模式设置的标志 |
CLAUDE_CODE_SAFE_MODE | --safe-mode 设置的标志 |
四、网络与代理
| 变量 | 作用 |
|---|---|
HTTPS_PROXY | HTTPS 代理 |
HTTP_PROXY | HTTP 代理 |
MCP_TIMEOUT | MCP server 启动超时 |
五、调试
| 变量 | 作用 |
|---|---|
CLAUDE_CODE_DEBUG_LOGS_DIR | 调试日志目录 |
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT | 转发子代理文本（等价 --forward-subagent-text） |
六、CI 中的典型配置
bash
# CI 脚本头部的典型环境配置
export CLAUDE_CODE_SKIP_PROMPT_HISTORY=1 # 不保存会话
# 认证 token 从 CI secret 注入（变量名以官方文档为准）
# 企业内网
export HTTPS_PROXY=http://proxy.company.com:8080 # 需替换
# 用企业 Bedrock 后端
export CLAUDE_CODE_USE_BEDROCK=1七、设置项 vs 环境变量
很多行为既能用环境变量，也能用 settings.json 配。选择原则：
| 情况 | 用什么 |
|---|---|
| 临时、单次运行 | 环境变量或 flag |
| 持久、个人偏好 | ~/.claude/settings.json |
| 团队共享 | .claude/settings.json（提交） |
| 组织强制 | managed settings |
| CI/脚本 | 环境变量 |
设置项优先级见 06.8。
八、查阅完整列表
环境变量集会更新，查最新：
text
官方文档：code.claude.com/docs/en/env-vars或在会话中问：
text
> 列出当前版本支持的所有 CLAUDE_CODE_ 开头的环境变量及作用