Claude Code 接入 DDS Hub 后报 401/403/503：按认证变量、Key 分组、客户端限制三层排查

把 Claude Code 接到第三方 Anthropic 兼容服务，配置本身只有两三行环境变量，但第一次调用失败时，报错往往只给一个状态码。401、403、503 看起来都像"Key 不对"，实际分别指向不同的层：请求头有没有带对、令牌有没有分组、分组允不允许当前客户端。

本文以 DDS Hub（呆呆兽 Hub）的公开文档和 FAQ 为例，整理一条从配置到报错的核对顺序。适用对象是已经装好 Claude Code、准备改用 API 方式接入的开发者。文中所有命令都是按文档整理的配置示例，不是终端实测输出；价格、分组和模型以你访问时的官方页面为准。

一、动手前先确认三个前提

1. Claude Code 版本

DDS Hub 的 Claude Code 教程要求 v2.1.68 或以上。Claude Code 更新很频繁，11 月初的版本号已经到了 2.1.3xx（见 官方 changelog），一般装过的版本都满足要求，但老机器上残留的旧安装值得先看一眼：

claude --version

2. 用哪个分组的令牌

DDS Hub 的令牌按分组创建，一个令牌属于一个分组，不同分组对应不同的模型系列、倍率和客户端限制。到 模型广场 找到你要用的模型，确认它在哪个分组下，再去控制台在这个分组里创建令牌。分组倍率会调整，预算以当前页面为准。

3. Base URL 不带版本路径

文档示例的地址是 https://www.ddshub.cc，末尾不加 /v1。Claude Code 会自己拼 /v1/messages，手动加上就变成 /v1/v1/messages，结果多半是 404。

二、最短配置路径

macOS / Linux 下，把下面两行写进 shell 配置（如 ~/.zshrc），Key 用你自己的值替换占位符：

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

Windows 用户按 DDS Hub 文档 中的 Windows 教程设置用户环境变量，系统要求 Windows 10 1809 及以上。

重新打开终端后，先确认变量已生效。只检查"有没有设置"，不要把令牌本身打印出来，避免出现在日志或截图里：

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

启动 claude 后执行 /status，看当前实际使用的是哪种凭据和哪个地址。如果显示的还是 claude.ai 账号登录，说明环境变量没被读到，先排查这一步，再看后面的报错。

三、按状态码定位

401：请求头里没有服务端要读的凭据

Claude Code 有两个认证变量，放进的请求头不一样（官方认证文档）：

官方文档明确写了：凭据放错变量，网关在它不读的请求头里拿不到 Key，就会返回 401。DDS Hub FAQ 里对应的报错是"401 缺少 Authorization"，这种情况优先检查是不是把令牌放进了 ANTHROPIC_API_KEY，而没有设置 ANTHROPIC_AUTH_TOKEN。

另一个常见来源是变量写在 ~/.zshrc，却从 IDE 或另一个 shell 启动，进程根本没继承到。/status 能直接看出来。

403：令牌没有可用分组

DDS Hub FAQ 列出的"403 API Key 未分配分组"，意思是令牌还没绑定任何可用分组。处理方式是在控制台给这个令牌分配需要的分组，而不是反复换模型名。

顺带检查：用 Claude 系列模型时，令牌是不是建在了 CodeX 或其他系列的分组里。模型出现在模型广场上，只说明平台列出了它，调用能否成功还取决于令牌所属的分组。

503：分开看三种情况

503 在 DDS Hub FAQ 里有好几条，含义不同：

• 503 No available accounts：上游或分组暂时没有可用资源，常见于高峰或分组并发达到上限。FAQ 的建议是等几分钟重试。
• 503 该分组仅允许 Claude Code 客户端：部分分组只接受 Claude Code 客户端发起的请求。如果你用 curl、Postman、Chatbox 或自己写的 SDK 脚本去调这个分组的令牌，就会被拒。要么改用 Claude Code，要么换一个不限制客户端的分组。
• CC Switch 下出现 503：FAQ 把它归到同一类客户端限制，在 Claude Code 内部正常使用不受影响。

所以，同样是 503，第一种等一等就好，后两种重试多少次都不会好。

429 与 502：额度、限流和上游

FAQ 还区分了"429 上游限流"和"429 Key 日限额用完"：前者降低并发或稍后再试，后者要到控制台看令牌的日限额设置。502 和 ECONNRESET、EAI_AGAIN 这类网络错误，先排除本地代理、DNS 和公司网络的影响，再判断是不是上游问题。

四、一张排查顺序表

前五步是配置问题，改对了就不会再出现；后两步跟时段和用量有关。按这个顺序走，可以少做很多"换个 Key 试试"的无效操作。

五、适用边界

• 本文只覆盖 Claude Code CLI 和 VS Code 插件（它们读同一套环境变量）。Claude Desktop 和云端会话不读这些变量，不适用这套配置。
• Codex CLI 走的是 ~/.codex/config.toml，字段和分组都不同，需要看 DDS Hub 文档中的 Codex 章节。
• 第三方 API 服务不是 Anthropic 官方服务。接入前请自行评估数据经过第三方的影响，以及是否符合你所在团队的合规要求。

如果准备通过 DDS Hub 配置，可以先看 对应工具的教程，再到 模型广场 核对当前模型和分组；遇到上面没覆盖的报错，FAQ 里有按错误信息分类的说明。