Kitcoding

简体中文

English

简体中文

English

外观

高阶指南 ​

进阶配置与调优。刚上手的话先看 快速开始 和各客户端的配置页，这里的内容按需查阅。

Codex：多分组一键切换（profile） ​

同时开了几个分组的令牌？比如用 Codex特价 跑探索、Codex专用 做收尾——不用来回手改 config.toml，Codex 支持 profile 叠加。

在 ~/.codex/ 下按用途各建一个文件，只写要覆盖的字段，其余自动继承 config.toml：

toml
# 探索档：走 Codex特价
model = "gpt-5.6-sol"

[model_providers.kitcoding]
name = "kitcoding"
base_url = "https://kitcoding.com/v1"
wire_api = "responses"
env_key = "KIT_CHEAP_KEY"
toml
# 收尾档：走 Codex专用
model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"

[model_providers.kitcoding]
name = "kitcoding"
base_url = "https://kitcoding.com/v1"
wire_api = "responses"
env_key = "KIT_PRO_KEY"

⚠️ 两个 profile 的 provider 名必须一致

注意上面两个文件的 provider 都叫 kitcoding，只换了 model 和 env_key——这是故意的。

Codex 的会话历史按 provider 名字隔离：如果你给两个档位起了不同的 provider 名（比如 kit-cheap 和 kit-pro），那么 codex -p cheap 时看不到 codex -p pro 的历史会话，反之亦然。详见 Codex 疑难解答。

用的时候：

bash
codex -p cheap    # 探索：Codex特价分组
codex -p pro      # 收尾：Codex专用分组
codex             # 不带 -p，走 config.toml 的默认配置

不同 profile 用不同令牌

auth.json 是全局的，只能存一个 Key。要让每个 profile 用各自分组的令牌，就在 profile 里用 env_key 指定环境变量名，然后在 shell 配置（~/.zshrc / ~/.bashrc）里分别设置：

bash
export KIT_CHEAP_KEY="你的-Codex特价分组令牌"
export KIT_PRO_KEY="你的-Codex专用分组令牌"

官方也更推荐 env_key 而非把 Key 明文写进配置文件。

Claude Code 环境变量大全 ​

整理自 linux.do 社区 @哈雷彗星（Haleclipse） 的实践总结。这些环境变量能解决 Claude Code 使用中的高频痛点，但请只在需要时添加——不了解用途的变量不要盲目写入。

所有环境变量均写入 ~/.claude/settings.json 的 env 节点即可生效：

json
{
  "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" 关闭，否则可能导致请求失败。这是最常见的"升级后连不上"的根因。

上下文 & 压缩控制 ​

✅ 想「晚点压缩」请用 autoCompactWindow（官方设置项） ​

这不是环境变量，而是 settings.json 的顶层设置项——想充分利用长上下文，用它才对：

json
{
  "autoCompactWindow": 190000
}
  • 类型：token 数，取值 100000 – 1000000
  • Claude Code 会按你所用模型的实际上下文窗口自动封顶
  • 也可以在会话里用 /autocompact 命令设置，它会把这个 key 写进你的用户设置

配合特价分组使用

Kitcoding 的 Claude特价-缓存优化 分组支持 200K 上下文，设 190000 左右即可把自动压缩推到接近窗口上限再触发。

⚠️ CLAUDE_AUTOCOMPACT_PCT_OVERRIDE —— 只能调低，不能调高 ​

类型：数字字符串｜取值：1–100（百分比）

官方原文明确写着：

Use lower values like 50 to compact earlier; the variable can't raise the threshold, so values above the default percentage are ignored.

也就是说，它只能让压缩来得更早。想靠调高它来「更充分利用上下文窗口」是无效的——超过默认值的设置会被直接忽略。要往后推请用上面的 autoCompactWindow。

json
// 只有这个方向有效：让它更早压缩
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "40"

CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE ​

类型：数字字符串（如 "193000"）

覆盖压缩提示的阻塞阈值，社区常用来避免频繁弹窗。

官方文档未收录

该变量不在 Anthropic 官方环境变量列表中（2026-09-03 核对），属于社区实践，行为可能随版本变化。优先使用官方的 autoCompactWindow，确有需要再叠加此项。

连接 & 网络 ​

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 历史文件锁会因竞态条件导致"检测到已删除"的误报，概率随实例数飙升。暂时关掉历史记录即可规避。

json
"CLAUDE_CODE_SKIP_PROMPT_HISTORY": "1"

安装 & 界面 ​

DISABLE_INSTALLATION_CHECKS ​

类型："1" 或 "0"

禁用 Claude Code 的安装检查提示。当 Claude.exe 位于非默认路径或自行管理环境变量时，每次启动均会弹出"未检测到标准安装"警告，设置此变量可关闭该提示。

模型别名重定向（接中转站很实用） ​

Claude Code 的 /model 里有 opus / sonnet / haiku 三个别名，它们默认指向 Anthropic 官方的模型 ID。接中转站时，如果上游没有那个确切 ID，选别名就会失败。这三个变量可以把别名重新指向中转站实际可用的模型：

json
{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}
变量作用
ANTHROPIC_DEFAULT_OPUS_MODELopus 别名指向谁；opusplan 在 Plan Mode 下也用它
ANTHROPIC_DEFAULT_SONNET_MODELsonnet 别名指向谁；opusplan 非 Plan Mode 时用它
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名指向谁，后台任务（如对话摘要）也走它

为什么值得配

ANTHROPIC_DEFAULT_HAIKU_MODEL 尤其值得设——后台任务（生成标题、摘要等）默认走 haiku，如果这个别名解析失败，会表现为一些莫名其妙的报错或功能失灵。

模型 ID 请照抄 模型广场。另有 _NAME / _DESCRIPTION 后缀变量可自定义在 /model 里的显示名。

⚠️ 旧变量 ANTHROPIC_SMALL_FAST_MODEL 已被官方标记为 DEPRECATED，请改用 ANTHROPIC_DEFAULT_HAIKU_MODEL。

功能开关（需新版 Claude Code） ​

CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS ​

类型："1" 或 "0"｜最低版本：2.1.69+

移除内置的 Git 提交信息说明。等同于 includeGitInstructions 设置项。如果你不想让 Claude Code 在每次提交时插入格式说明，启用此项。

类型："true"｜最低版本：2.1.72+

官方说明：设置 ANTHROPIC_BASE_URL 指向非官方主机（也就是接中转站）时，MCP tool search 会被默认关闭。若你的中转站能转发 tool_reference 块，就手动打开它：

json
"ENABLE_TOOL_SEARCH": "true"

官方写法是 true

官方文档中该变量的取值写作 ENABLE_TOOL_SEARCH=true，建议照此填写而非 "1"。

ANTHROPIC_CUSTOM_MODEL_OPTION ​

类型：模型 ID 字符串｜最低版本：2.1.78+

向 /model 命令的模型选择器列表中添加自定义模型，无需再用模型别名替代。

可配合后缀变量自定义显示名和描述：

json
"ANTHROPIC_CUSTOM_MODEL_OPTION": "claude-opus-4-8",
"ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "Opus 4.8",
"ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION": "最强模型，贵但好用"

速查表 ​

变量用途推荐值版本要求
ANTHROPIC_BASE_URL端点地址https://kitcoding.com全部
ANTHROPIC_AUTH_TOKEN中转站鉴权你的令牌全部
CLAUDE_CODE_ATTRIBUTION_HEADER归因头"0"2.1.15+
autoCompactWindow ⭐压缩窗口（官方设置项，非 env）190000（200K 上下文）全部
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE压缩百分比（只能调低）按需全部
CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE阻塞阈值（官方未收录）按需全部
ANTHROPIC_DEFAULT_OPUS_MODELopus 别名重定向claude-opus-4-8全部
ANTHROPIC_DEFAULT_SONNET_MODELsonnet 别名重定向claude-sonnet-5全部
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名 + 后台任务claude-haiku-4-5-20251001全部
CLAUDE_CODE_PROXY_RESOLVES_HOSTSDNS 代理按需全部
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"true"2.1.72+
ANTHROPIC_CUSTOM_MODEL_OPTION给 /model 加自定义项模型 ID2.1.78+

原则

不知道干什么用的变量不要加。 上面大部分变量都是"有特定问题才用"的开关，不是配置越全越好。默认配置已经覆盖了绝大多数使用场景。

内容来源

本页「Claude Code 环境变量大全」整理自 linux.do 社区用户 哈雷彗星（Haleclipse） 的环境变量总结（原帖），并按 Kitcoding 场景精选适配。感谢原作者的细致总结。

欢迎通过 投稿 补充你遇到的问题与解法。