Claude Code 环境变量大全
整理自 linux.do 社区 @哈雷彗星（Haleclipse） 的实践总结。这些环境变量能解决 Claude Code 使用中的高频痛点，但请只在需要时添加——不了解用途的变量不要盲目写入。
所有环境变量均写入 ~/.claude/settings.json 的 env 节点即可生效：
{
"env": {
"ANTHROPIC_BASE_URL": "https://kitcoding.com",
"ANTHROPIC_AUTH_TOKEN": "你的令牌",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}必配 / 强烈推荐
ANTHROPIC_BASE_URL
类型：string｜用途：API 端点地址
接中转站时设为你所用服务的地址，如 https://kitcoding.com。必须是 Anthropic 格式接口。
ANTHROPIC_AUTH_TOKEN
类型：string｜用途：API 鉴权令牌
中转站的 API Key 填写此项。与 ANTHROPIC_API_KEY 二选一，接中转站时使用此项。
ANTHROPIC_API_KEY
类型：string｜用途：Anthropic 官方 API Key
仅标准 Anthropic 官方接口使用。注意：只要这个变量存在，Claude Code 就不会再用 OAuth 登录态。接中转站时不应设置此项。
CLAUDE_CODE_ATTRIBUTION_HEADER
类型："0" 或 "1"｜推荐值："0"
Claude Code 2.1.15+ 引入的计费归因头。接中转站时设为 "0" 关闭，否则可能导致请求失败。这是最常见的"升级后连不上"的根因。
上下文 & 压缩控制
CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE
类型：数字字符串（如 "193000"）
覆盖 Claude Code 自动压缩的触发阈值。默认在约 80% 上下文窗口时弹出压缩提示——若需避免频繁弹窗，可手动调高此值。
"CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE": "193000"配合特价分组使用
Kitcoding 的 Claude 特价-缓存优化 分组支持 200K 上下文。建议配合此变量一起配置，将压缩阈值设在 190K-195K 附近，触发更精准的自动压缩而非过早弹窗。
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE
类型：数字字符串（如 "57"）
强制覆盖自动压缩的触发百分比。Claude Code 默认在上下文窗口约 50% 时触发压缩——对于 200K 上下文来说偏早。如果你希望更充分利用上下文窗口，可以调高此值。
计算公式：(目标触发token - 13000) / 上下文窗口 * 100
例如 200K 上下文下，想在 115K tokens 时触发压缩：
(115000 - 13000) / 200000 = 51% → 设 51// 200K 上下文，~115K tokens 触发自动压缩
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "51"连接 & 网络
CLAUDE_CODE_PROXY_RESOLVES_HOSTS
类型："1" 或 "0"｜默认：已默认禁用
控制 DNS 解析是否交给代理服务器。启用后代理服务器收到的是主机名（如 api.anthropic.com）而非 IP 地址。对 WebFetch / WebSearch 功能有帮助——如果经常拿不到 raw.githubusercontent.com 之类的内容，可以尝试开启。
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
类型："1" 或 "0"
禁用非必要网络流量（如遥测、版本检查等）。如果你在意隐私或在受限网络环境下使用，可以开启。
多开 & 稳定性
CLAUDE_CODE_SKIP_PROMPT_HISTORY
类型："1" 或 "0"
跳过 prompt 历史记录功能。多开 Claude Code 实例时，prompt 历史文件锁会因竞态条件导致"检测到已删除"的误报，概率随实例数飙升。暂时关掉历史记录即可规避。
"CLAUDE_CODE_SKIP_PROMPT_HISTORY": "1"安装 & 界面
DISABLE_INSTALLATION_CHECKS
类型："1" 或 "0"
禁用 Claude Code 的安装检查提示。当 Claude.exe 位于非默认路径或自行管理环境变量时，每次启动均会弹出"未检测到标准安装"警告，设置此变量可关闭该提示。
功能开关（需新版 Claude Code）
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS
类型："1" 或 "0"｜最低版本：2.1.69+
移除内置的 Git 提交信息说明。等同于 includeGitInstructions 设置项。如果你不想让 Claude Code 在每次提交时插入格式说明，启用此项。
ENABLE_TOOL_SEARCH
类型："1" 或 "0"｜最低版本：2.1.72+
强制开启 tool_search 功能。默认情况下，Claude Code 会自动判别是否启用——但接非官方上游时通常会回落到关闭。如果你确认上游支持（Sonnet 4+ 和 Opus 4+），可以强制启用。
"ENABLE_TOOL_SEARCH": "1"ANTHROPIC_CUSTOM_MODEL_OPTION
类型：模型 ID 字符串｜最低版本：2.1.78+
向 /model 命令的模型选择器列表中添加自定义模型，无需再用模型别名替代。
可配合后缀变量自定义显示名和描述：
"ANTHROPIC_CUSTOM_MODEL_OPTION": "claude-opus-4-1-20250805",
"ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "Opus 4.1",
"ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION": "最强模型，贵但好用"速查表
| 变量 | 用途 | 推荐值 | 版本要求 |
|---|---|---|---|
ANTHROPIC_BASE_URL | 端点地址 | https://kitcoding.com | 全部 |
ANTHROPIC_AUTH_TOKEN | 中转站鉴权 | 你的令牌 | 全部 |
CLAUDE_CODE_ATTRIBUTION_HEADER | 归因头 | "0" | 2.1.15+ |
CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE | 压缩阈值 | "193000" | 全部 |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | 压缩百分比 | "51"（200K 上下文） | 全部 |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS | DNS 代理 | 按需 | 全部 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 禁非必要流量 | 按需 | 全部 |
CLAUDE_CODE_SKIP_PROMPT_HISTORY | 跳历史（多开） | "1" | 全部 |
DISABLE_INSTALLATION_CHECKS | 禁安装检查 | "1" | 全部 |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS | 禁 Git 说明 | 按需 | 2.1.69+ |
ENABLE_TOOL_SEARCH | 强制 tool_search | "1" | 2.1.72+ |
ANTHROPIC_CUSTOM_MODEL_OPTION | 自定义模型 | 模型 ID | 2.1.78+ |
原则
不知道干什么用的变量不要加。 上面大部分变量都是"有特定问题才用"的开关，不是配置越全越好。默认配置已经覆盖了绝大多数使用场景。
内容来源
本页整理自 linux.do 社区用户 哈雷彗星（Haleclipse） 的 Claude Code 环境变量总结（原帖），并按 Kitcoding 场景精选适配。感谢原作者的细致总结。