DeconBear LLM Router 接入文档

一条 db_sk_ key，把 Claude Code 接入 DeconBear 网关，即可在 DeepSeek / MiniMax / 火山方舟 / 智谱 GLM / 云知声 等多家提供商间自由切换——只需选模型，无需改配置。

一、工作原理

DeconBear Router 是一个翻译型网关。Claude Code 用 Anthropic Messages 协议（/v1/messages）访问网关，网关按你选的模型别名（alias）路由到对应上游：

• 上游是 OpenAI 兼容协议（DeepSeek / MiniMax / 豆包 / GLM / 云知声）→ 网关做 Anthropic ↔ OpenAI 双向翻译后转发，再把响应翻译回 Anthropic 格式。
• 上游是 Anthropic 兼容协议 → 网关原样转发。

所有上游的真实 API Key 只存在 DeconBear 后端（加密存储），客户端只持有一条 db_sk_ 自签发 key。

二、DeconBear 网关端点

用途	值
生产 Base URL	https://www.deconbear.cn/api/v1
本地开发 Base URL	http://localhost:9233/api/v1
推理端点（Anthropic）	POST /v1/messages → 实际命中 /api/v1/v1/messages
Token 计数	POST /v1/messages/count_tokens
模型列表	GET /v1/models（返回 {object:"list", data:[{id,...}]}）
OpenAI 兼容端点	POST /v1/chat/completions（供 OpenAI 风格客户端用）
认证	同时接受 Authorization: Bearer db_sk_… 和 x-api-key: db_sk_…

所以 Claude Code 的 ANTHROPIC_BASE_URL 设为 https://www.deconbear.cn/api/v1（末尾不带斜杠），model 设为你在「LLM 路由」页配的 alias。

三、接入 Claude Code

第 1 步：创建自签发 key

owner 登录后进入 LLM 路由 → deconbear 自签发 API Key，创建一个 key，明文 db_sk_… 只显示一次（owner 可随时从列表重新获取）。

第 2 步：配置 Claude Code

推荐用项目级配置（仅本项目目录生效，不影响全局配置）。在项目根目录新建 .claude/settings.local.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.deconbear.cn/api/v1",
    "ANTHROPIC_AUTH_TOKEN": "db_sk_替换成你的key",

    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro"
  }
}

字段	说明
ANTHROPIC_BASE_URL	网关地址 https://www.deconbear.cn/api/v1。本地测改成 http://localhost:9233/api/v1。末尾不带斜杠。
ANTHROPIC_AUTH_TOKEN	用 AUTH_TOKEN（发 Authorization: Bearer）而非 ANTHROPIC_API_KEY。API_KEY 在交互模式需一次性确认，曾被拒绝过的 key 会被静默忽略——这是常见"配了不生效"的坑。网关两种头都收。
ANTHROPIC_MODEL	主模型 = 路由 alias。也可在会话里 /model <alias> 临时切。
ANTHROPIC_DEFAULT_*_MODEL	必须都设成网关上真实存在的 alias。后台任务（标题生成、上下文压缩）用 Haiku 级模型，留空会默认 claude-haiku-…，网关没这个名字会报错。没别的便宜 alias 就先都填主模型。

第 3 步：验证

先用 curl 直接打一发确认链路通（绕开 Claude Code 更易定位）：

$h = @{ "Authorization" = "Bearer db_sk_你的key"; "anthropic-version" = "2023-06-01" }
$b = '{"model":"deepseek-v4-pro","max_tokens":16,"messages":[{"role":"user","content":"Reply with OK."}]}'
Invoke-RestMethod -Method Post -Uri "https://www.deconbear.cn/api/v1/v1/messages" -Headers $h -ContentType "application/json" -Body $b

应返回 {"id":"msg_…","type":"message","content":[{"type":"text","text":"…"}],…}。通了再启动 Claude Code，/status 应显示 base URL 指向 deconbear。

可选：让 alias 出现在 /model 选择器

Claude Code 的网关模型发现会过滤掉 id 不以 claude/anthropic 开头的条目，所以自定义 alias 默认不进选择器。要进选择器加：

"ANTHROPIC_CUSTOM_MODEL_OPTION": "deepseek-v4-pro",
"ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "DeepSeek V4 Pro",
"ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION": "经 DeconBear 网关"

不加也能用——会话里 /model deepseek-v4-pro 直接切，或靠 ANTHROPIC_MODEL 默认。

四、上游提供商与模型清单

五、常见问题

模型转发 404 "model not found"

alias 拼错、route 未启用、或 provider 未启用。到「LLM 路由」页核对，或用「端到端验证全部路由」一键测。

上游 400 / 字段不识别

DeconBear 是白名单式构造 OpenAI body，Claude Code 的 beta 字段（thinking、context_management、tools[].strict 等）会自动丢弃，正常不会到上游。若仍遇 400，多半是上游模型名错或该模型不支持你请求的功能（如某些模型不支持工具）。

流式上游报错不显示

流式路径下若上游报错（key 失效、模型名错），会返回一个"空但合法"的 Anthropic 流，错误不直接冒泡到 Claude Code。排查途径：deconbear「实时路由日志」（显示 502 + 错误信息）或用上面的非流式 curl 命令（非流式会正确返回 502 + 错误体）。

Claude Code 显示连接不上

• 确认 ANTHROPIC_BASE_URL 末尾不带斜杠，否则产生 /api/v1//v1/messages。
• 用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY。
• 生产 www.deconbear.cn 需部署了最新代码（翻译修复）；本地测用 http://localhost:9233 且 DECONBEAR_LOCAL_ONLY 未拦本机。