Claude Code 接入 DDS Hub：环境变量、分组校验与常见报错排查

资料核对日期：2026-11-03。客户端版本要求、分组和倍率都可能调整，动手前请以文中链接的当前页面为准。

把 Claude Code 接到第三方接入服务，表面上只改两项：请求发往哪里（Base URL），用什么凭证（Token）。真正让人卡住的往往是第三项：这把 Key 能不能用这个模型、这个客户端。

本文以 DDS Hub（呆呆兽 Hub）的公开文档为例，按「概念 → 配置 → 验证 → 排错」走一遍。文中会注明每条结论的出处：Claude Code 官方文档，还是 DDS Hub 文档。

一、先分清三个概念

1. Base URL 填根地址，不带 /v1

Claude Code 官方的网关接入文档给的验证请求是 $ANTHROPIC_BASE_URL/v1/messages，/v1/messages 这段路径由客户端自己拼接。DDS Hub 文档给出的值是 https://www.ddshub.cc。如果手动加上 /v1，最终路径会重复。

2. 凭证放进哪个变量，决定了请求头

Claude Code 官方文档写明：ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 头发送，ANTHROPIC_API_KEY 以 x-api-key 头发送。变量放错，网关读不到凭证，就会返回 401。DDS Hub 的 Claude Code 教程用的是 ANTHROPIC_AUTH_TOKEN。

3. Key 属于分组，分组决定能用哪些模型

DDS Hub 的 Key 按分组划分。官方博客的原话是：一把 Key 属于某个分组（例如 Claude 分组或 CodeX 分组），并不覆盖所有模型系列，应按要用的客户端和模型来创建 Key（来源）。

截至 2026-11-03，模型页上的 Anthropic 分组有：Claude Kiro 分组（倍率 0.6）、Claude Max 号池分组（2）、Claude 稳定分组（3.5）和企业分组（定制倍率）。倍率影响最终计费，具体单价以模型页当前显示为准。

二、准备工作

• Claude Code 版本不低于 v2.1.68。这是 DDS Hub 文档的要求；Windows 还需要 Windows 10 1809 或更高版本。
• 用 claude --version 查看版本，用 claude doctor 做一次健康检查。
• 在 DDS Hub 控制台创建令牌，并选择与 Claude 模型对应的分组。具体步骤见文档里的「令牌创建 & Token 获取」章节。

三、配置环境变量

方式 A：写入 Shell 配置

macOS / Linux 把下面两行写入 ~/.zshrc 或 ~/.bashrc，再执行 source ~/.zshrc：

export ANTHROPIC_BASE_URL="https://www.ddshub.cc"
export ANTHROPIC_AUTH_TOKEN="<你的 DDS Hub 令牌>"

Windows 用 notepad $PROFILE 打开 PowerShell 配置文件，在末尾加入下面两行，保存后执行 . $PROFILE：

$env:ANTHROPIC_BASE_URL   = "https://www.ddshub.cc"
$env:ANTHROPIC_AUTH_TOKEN = "<你的 DDS Hub 令牌>"

方式 B：写入 Claude Code 的 settings.json

Claude Code 官方文档建议，需要长期生效时（包括后台代理）使用设置文件中的 env 块。文件位置是 ~/.claude/settings.json，Windows 上是 %USERPROFILE%\.claude\settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ddshub.cc",
    "ANTHROPIC_AUTH_TOKEN": "<你的 DDS Hub 令牌>"
  }
}

有两点要注意：

• Shell 和设置文件同时设置同一个变量时，以设置文件的值为准。改了 .zshrc 却不生效，先查这里。
• 不要把令牌写进项目里的 .claude/settings.json。这个文件通常会提交到仓库，与所有克隆者共享。

检查变量是否生效，但不要打印令牌

有些教程用 echo $ANTHROPIC_AUTH_TOKEN 做检查，截图或录屏时容易把令牌泄露出去。只判断「是否已设置」就够了：

[ -n "$ANTHROPIC_AUTH_TOKEN" ] && echo "token 已设置" || echo "token 未设置"
echo "$ANTHROPIC_BASE_URL"

四、分两步验证

第一步：绕过 Claude Code，直接发一个请求。 这是 Claude Code 官方文档推荐的做法：先确认地址和凭证可用，出问题时就能排除客户端配置。注意，这会产生一次很小的计费请求。

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-opus-5-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

claude-opus-5-5 取自 DDS Hub 博客中的示例，请以模型页和你的分组为准。按官方文档的说明，结果可以这样判断：

• 返回以 {"id":"msg_ 开头的 JSON：地址和凭证都可用。
• 返回「未知模型」一类的错误：同样说明地址和凭证没问题，只是模型名不对。
• 返回 401：凭证被拒，先检查变量名和令牌本身。

第二步：在同一个终端启动 claude，发一条消息，再运行 /status。 状态页里的 Anthropic base URL 一行应显示 https://www.ddshub.cc，同时应有一行 Auth token 指向你设置的变量。缺少 Anthropic base URL 这一行，说明变量没有传到当前会话。

五、按报错定位

DDS Hub FAQ 按类别列出了常见报错。各条的处理步骤是折叠内容，本文未能读到。下表是根据报错文字和 Claude Code 官方文档整理的检查顺序，具体处理方法请以 FAQ 展开后的内容为准。

推荐的排查次序是：地址与变量 → 令牌分组 → 额度 → 上游与网络。不要一看到 4xx、5xx 就先换 Key。

六、适用边界

• 这是第三方接入服务，不是 Anthropic 官方服务。 请求内容和令牌都会经过该平台。团队或有合规要求的场景，请先评估数据处理方式。
• 部分 Claude Code 功能不可用。 官方文档说明：只要设置了网关凭证，Remote Control 和语音听写就会停用。
• 不同入口的配置方法不同。 Claude Code 桌面 App 不读取 ANTHROPIC_BASE_URL；VS Code 扩展建议在 claudeCode.environmentVariables 中配置。具体见官方网关文档。
• 核算成本要同口径比较。 文本模型按每百万 tokens 分别计输入、输出和缓存费用，再乘以分组倍率。估算时用自己的实际用量代入模型页的当前单价，不要拿某一个折扣数字概括所有场景。

小结

把「地址、凭证变量、分组」三件事分开核对，大多数接入问题都能在 Claude Code 外面先定位清楚。准备实际配置时，可以先看 DDS Hub 的 Claude Code 教程，再到模型页核对分组和价格。

参考资料

• Claude Code 官方文档：Connect Claude Code to an LLM gateway
• Claude Code 官方文档：Settings files and precedence
• DDS Hub：使用教程、模型广场、常见问题