不墨 Router

发布于 2026 年 10 月 22 日 星期四

Claude Code 怎么接国产大模型?DeepSeek / Kimi / GLM 一个 Key 配好(附 Codex CLI 配置)

Claude Code 只认 Anthropic 接口,国内直连困难。改两个环境变量把 Base URL 指向兼容 Claude 接口的网关,就能用 DeepSeek、Kimi、GLM 等国产模型跑 Claude Code,Codex CLI 同理。

Claude Code 怎么接国产大模型?DeepSeek / Kimi / GLM 一个 Key 配好(附 Codex CLI 配置)

能接。Claude Code 只要求后端「说 Anthropic Messages 协议」,并不检查背后是不是 Claude 模型。所以只要把 ANTHROPIC_BASE_URL 指向一个兼容 Claude 接口的网关,再把模型名换成国产模型,DeepSeek、Kimi、GLM、Qwen 都能直接驱动 Claude Code,全程不用改一行代码,也不用科学上网。

下面是完整配置步骤,Codex CLI 的配置放在后半段。

终端里的 Claude Code 通过网关调用多个国产大模型
终端里的 Claude Code 通过网关调用多个国产大模型

为什么 Claude Code 能用国产模型

Claude Code 和模型之间只隔着一层 HTTP 接口:它把对话、工具调用(读文件、跑命令、改代码)打包成 /v1/messages 请求发出去,再按返回结果决定下一步。只要网关能:

  1. 接收 Anthropic 格式的 /v1/messages 请求;
  2. 转成目标模型的格式调用上游;
  3. 把结果(包括工具调用)按 Anthropic 格式还回来;

Claude Code 就感知不到差别。国产模型这一年在代码和工具调用上进步很快,DeepSeek、Kimi、GLM 都已经能稳定完成「读代码 → 改文件 → 跑测试」的循环,日常写业务代码完全够用,价格却只有 Claude 的零头。

三步配置 Claude Code

以 不墨 Router 为例,它同时兼容 OpenAI 和 Claude 两套接口,国产模型按各自报价计费。

第一步:拿 API Key。 登录 Router 控制台,在「API Key」页面新建一个 Key,形如 sk-xxxx。

第二步:设置环境变量。 在终端执行:

npm install -g @anthropic-ai/claude-code

export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export ANTHROPIC_BASE_URL="https://router.bumo.cc"
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek/deepseek-flash
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek/deepseek-flash
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek/deepseek-flash

注意 Base URL 不要带 /v1,Claude Code 会自己拼上 /v1/messages,多写一层会 404。

第三步:启动。 直接运行 claude 即可。想换模型,把上面三个模型名换成模型广场里的其他 ID;也可以在 Claude Code 里用 /model 模型ID 临时切换。

想长期生效,把这几行 export 写进 ~/.zshrc 或 ~/.bashrc。

三个模型变量分别管什么

Claude Code 内部把模型分成三档,不同任务用不同档位:

变量 用在哪里 建议
ANTHROPIC_DEFAULT_OPUS_MODEL 复杂规划、Plan 模式 选能力最强的模型
ANTHROPIC_DEFAULT_SONNET_MODEL 日常写代码的主力 选性价比最高的模型
ANTHROPIC_DEFAULT_HAIKU_MODEL 生成标题、简单判断等后台小任务 选最快最便宜的模型

刚上手全部填同一个模型最省事;用顺了再按「贵模型做难事、便宜模型做杂事」拆开,能明显省钱。

Codex CLI 也能这样配

OpenAI 的 Codex CLI 新版只支持 Responses API,Router 也兼容这个接口。为了不影响原有配置,单独建一个 profile:

npm install -g @openai/codex

mkdir -p ~/.codex && cat > ~/.codex/bumo.config.toml <<'EOF'
model_provider = "bumo"
model = "deepseek/deepseek-flash"

[model_providers.bumo]
name = "Bumo"
base_url = "https://router.bumo.cc/v1"
env_key = "BUMO_API_KEY"
wire_api = "responses"
EOF

export BUMO_API_KEY="sk-你的Key"
codex --profile bumo

和 Claude Code 相反,Codex 的 base_url 要带 /v1。

常见问题

报 401 / 鉴权失败? 先检查 Key 是否复制完整。如果这台电脑之前登录过 Anthropic 账号,在 Claude Code 里执行 /logout 退出后再启动,避免旧的登录态覆盖环境变量。

报 404? 九成是 Base URL 多写了 /v1(Claude Code)或少写了 /v1(Codex)。

工具调用不稳定、一直重复读文件? 换一个代码能力更强的模型做 Sonnet 档。不同模型对长上下文和工具调用的稳定性差别很大,值得多试两个。

会不会被上游限流? 网关的价值就在这里:多线路调度,某条上游故障时自动切换,比自己直连单个厂商稳定。

总结

Claude Code 接国产模型只需要改 Base URL 和模型名两件事。用一个兼容 Claude + OpenAI 接口的网关,一个 Key 就能在 DeepSeek、Kimi、GLM、Qwen 之间随时切换,Claude Code 和 Codex CLI 共用同一个 Key。

前往不墨 Router 获取 API Key,按量付费、按模型报价,几分钟就能让 Claude Code 跑起来。

Router 开发者接入与价格