自带 Key（BYOK）已上线，每月 1,000,000 次免费 BYOK 请求，不需要充值了解详情
EN 登录 开始使用

实践指南2026-10-1614 分钟读完

Claude Code 接入其他模型：DeepSeek、Kimi、GLM、Qwen 实测

Claude Code 接入其他模型，关键只有一点：Claude Code 说的是 Anthropic Messages 格式，任何提供这种格式的接口都能回应它。把 Claude Code 指向这样的接口、写上模型名，同一个终端 agent、同一套工具和工作流程，就改由 DeepSeek、Kimi、GLM、Qwen 或 MiniMax 来跑，而不是 Claude。

这篇讲怎么配置、哪款模型适合哪类工作、我们 2026 年 10 月 16 日实测看到了什么，以及长时间使用前要知道的限制。先把一件事放在前面说清楚：Anthropic 自己的文档写明，不支持通过任何网关把 Claude Code 接到非 Claude 模型上。这套做法能用，是因为协议相通，不是因为有谁为这种组合做了认证。正式依赖之前，先拿自己的代码库测一遍。

为什么让 Claude Code 接入其他模型

常见的理由有三个。

  • 每个任务的成本。 编程 agent 每一轮都会重发系统提示、工具定义和对话记录。我们实测，在 Claude Code 2.1.295 里让它只回一个词，也发了 20,751 个输入 token。量到这个级别，账单主要由模型的单价决定，而不是某一条提示词。
  • 没有用量时间窗。 订阅按时间窗计量 agent 用量，重度使用时可能在任务中途用完。用 API Key 按 token 付费，没有要等的时间窗。
  • 按任务挑模型。 有的团队把规划和难排查的问题留给 Claude，把日常修改、跑测试、浏览代码库交给更便宜的模型。Claude Code 允许分别设置主模型、后台模型和子 agent 模型。

订阅时间窗和限速的问题，详见编程 agent 与限速墙。

工作原理

Claude Code 从 ANTHROPIC_BASE_URL 读取接口地址，从 ANTHROPIC_AUTH_TOKEN（以 Bearer token 发送）或 ANTHROPIC_API_KEY（以 x-api-key 发送）读取凭据。每个请求都按 Anthropic 格式发到这个地址下的 /v1/messages，带上你配置的模型名。

BoostRail 为目录里的每一款文本模型提供 /v1/messages，不只 Claude。请求会按承接该模型的线路转换，响应以 Anthropic 的流式事件返回，工具调用也一样。无法应用的字段列在 Messages 参考里，并在响应头 x-boostrail-degraded 中注明，不会悄悄丢掉。

三步完成配置

第 1 步。 在 BoostRail 控制台创建一个 Key。同一个 Key 可以调用模型目录里的所有模型。

第 2 步。 把配置写进 ~/.claude/settings.json。配置文件能覆盖从桌面启动的会话和后台 agent，只在 shell 里 export 做不到这一点。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.boostrail.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

每一行的作用：

  • ANTHROPIC_AUTH_TOKEN 是接口接受 Bearer token 时，Anthropic 文档推荐使用的凭据变量。设置之后，请求带的是这个 Key 而不是你的 claude.ai 登录，订阅的用量限制也不作用于这些请求。
  • ANTHROPIC_MODEL 设置主模型。后缀 [1m] 告诉 Claude Code 这款模型有一百万 token 的上下文窗口；Claude Code 发送前会去掉后缀，BoostRail 收到的是 kimi-k3。
  • ANTHROPIC_DEFAULT_HAIKU_MODEL 把会话标题、摘要这类后台工作挪到更便宜的模型上。
  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 让 Claude Code 不再发送只有 Anthropic 官方 API 才接受的预发布字段。

第 3 步。 开始长时间工作之前先检查连接。下面用同一个 Key 直接发一个请求：

curl https://api.boostrail.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "kimi-k3", "max_tokens": 256, "messages": [{"role": "user", "content": "Reply with OK"}]}'

返回的 JSON 里 content 数组装着回复，就说明 Key 和地址都没问题。max_tokens 要留够余量：推理模型会先用掉一部分来思考，我们把预算设成 16 个 token 时，Kimi K3 返回的 content 数组是空的。接着启动 claude，运行 /status，找 Anthropic base URL 这一行。如果没有，说明变量没传进会话。Codex CLI、Cline 等工具的同类配置见编程工具页。

哪款模型适合哪类活

下表的模型 ID 就是 BoostRail 接受的写法。定位描述来自各厂商自己的模型卡或发布公告，链接在最后一列，请把它当作厂商的说法，而不是我们的结论。

模型 ID厂商说它适合做什么上下文出处
kimi-k3长周期编程、agent 式知识工作和推理1MMoonshot 模型卡
glm-5.3编程；Z.ai 称它是自家开放权重模型里编程能力领先的一款见模型卡Z.ai 模型卡
qwen3.8-max自主编程和长周期任务执行1M阿里巴巴公告
minimax-m3长周期 agent 工作、编程和长上下文效率1MMiniMax 模型卡
deepseek-v4.1-flash注重成本、输入量大的 agent 工作1MDeepSeek 模型卡

不少团队从这样的分工开始：用一款强模型当主模型，负责规划和跨文件修改；用 deepseek-v4.1-flash 跑后台工作和读代码、写摘要的子 agent。每款模型的输入、输出价格见模型页。想更全面地了解这几家厂商，可以看2026 年的中国大模型。

我们实测了什么

2026 年 10 月 16 日，我们用 BoostRail 内部测试 Key 做了两项检查。

通过 /v1/messages 的两轮工具调用。 给每款模型一个 read_file 工具，问它「这个项目需要哪个 Python 版本」。上表五款模型都调用了工具、读了正确的文件，接收工具结果后给出正确回答，以 end_turn 结束。这说明 Claude Code 依赖的请求和响应结构，在这几款模型上能完整往返。每款模型只测了一次，不代表每条线路都有保证。

Claude Code 本身。 我们用 Claude Code 2.1.295 的非交互模式连 BoostRail，主模型设为 glm-5.3，让它新建一个 Python 文件并运行。它写好文件，用 python3 运行，三轮内报告了正确的输出。主模型换成 kimi-k3 和 deepseek-v4.1-flash 的几次较短运行也都正常返回。这几次运行里有两个细节可供参考：

  • 用量数据显示，Kimi K3 和 DeepSeek V4.1 Flash 有缓存读取（cache_read_input_tokens 大于零），所以这几次运行里重复的上下文按缓存读取价计费。GLM-5.3 几乎没有。
  • Claude Code 自己显示的费用，是按它内置的价格表算的，不是你的账单。那次只回一个词的 DeepSeek 请求，它显示 $0.083；同样的 token 按 DeepSeek V4.1 Flash 的目录价算，大约是 $0.003。实际花费以 BoostRail 控制台为准，里面记录了每个请求实际使用的价格。

长时间使用前要知道的限制

  • /model 选单里不会出现这些模型。 打开网关模型发现后，Claude Code 只保留 ID 里含「claude」或「anthropic」的模型。直接输入 ID 即可：/model glm-5.3 会切换当前会话。
  • 上下文窗口。 遇到不认识的 ID，Claude Code 按 200K token 估算，并在到达之前压缩对话。一百万 token 窗口的模型加上 [1m]。上限低于 200K 的模型，比如 BoostRail 上的 qwen3-coder-flash，把 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设成它的上限。
  • token 计数。 BoostRail 不提供 /v1/messages/count_tokens。Claude Code 会改用自己的估算，所以 /context 显示的是近似值。
  • 思考块。 对话历史里先前的思考块会被接收后丢弃，并在 x-boostrail-degraded 中注明。每款模型按自己的方式推理。
  • 自动模式。 自动模式每做一个操作都要另发一次安全分类请求，我们这次运行里，它发给的是一款 Claude 模型，而不是我们配置的那款。在 Claude Code 2.1.295 上、主模型不是 Claude 时，自动模式拦下了它判断不了的 shell 命令。建议用默认权限模式，再给信得过的命令加放行规则。
  • 一行诊断信息。 遇到不认识的 ID，非交互模式输出开头会有一行 [claude-code:unrecognized_model]。这只是提示，请求照常发出。

Claude 和其他模型混着用

不必一次全部切换。所有模型都在同一个接口、同一个 Key 后面，你可以继续用 claude-sonnet-5 当主模型，只把后台工作交给 deepseek-v4.1-flash，反过来也行。CLAUDE_CODE_SUBAGENT_MODEL 设置子 agent 的默认模型，子 agent 的定义里仍可以写自己的模型。某一步难题需要 Claude 判断时，/model claude-sonnet-5 就能切回去，不用改配置文件。

如果团队已经和模型厂商签了合同，BYOK 可以在同一个接口后面用你自己的厂商 Key 跑目录里的模型，见 BYOK 指南。

常见问题

Anthropic 支持 Claude Code 接入其他模型吗？

不支持。Anthropic 的文档写明，不支持通过任何网关把 Claude Code 接到非 Claude 模型。这套配置能用，是因为 Messages 格式相通。请把它当成你自己负责的配置，用自己的代码测试。

我的 Claude 订阅还会被扣用量吗？

不会。设置 ANTHROPIC_AUTH_TOKEN 之后，Claude Code 发送的是这个 Key 而不是你的 claude.ai 登录，订阅的用量限制不作用于这些请求。费用按 token 记到这个 Key 所属的 BoostRail 账户。

为什么 /model 里找不到 DeepSeek、Kimi 或 GLM？

网关模型发现只添加 ID 含「claude」或「anthropic」的模型。在 ANTHROPIC_MODEL 里设置模型，或在会话中输入 /model 加模型 ID。

非 Claude 模型能用提示词缓存吗？

取决于该模型的线路。支持缓存的，缓存读取会出现在 cache_read_input_tokens 里，按模型页上的缓存读取价计费。我们的运行中，Kimi K3 和 DeepSeek V4.1 Flash 有缓存读取，GLM-5.3 很少。

应该用哪个配置文件？

自己的电脑用 ~/.claude/settings.json。不要把 Key 放进项目里的 .claude/settings.json，那个文件会提交到代码库，所有克隆仓库的人都能看到。

从一个 API Key 开始

BoostRail 用一个 OpenAI 兼容 API 提供 68 款文本、图片和视频模型。获取 API Key 大约只要一分钟。

获取 API Key全部文章

更新日期：2026-10-16