Claude Code 接入 DDS Hub：Windows/macOS 配置、验证与报错排查

Claude Code 默认连接 Anthropic 官方接口。想改走 DDS Hub（呆呆兽 Hub），本质上只改两件事：认证令牌和服务地址。真正容易卡住的地方通常在配置之外，比如客户端版本太旧、令牌没有分组、分组与客户端不匹配。

本文按「前提 → 安装 → 配置 → 验证 → 排错」的顺序讲一遍。配置项以 DDS Hub 使用教程为准，核对日期为 2026-10-23。下文命令为文档示例，不是本文作者在你的环境中的实测输出。

一、开始前先确认三件事

1. 系统与客户端版本

DDS Hub 文档写明需要 Claude Code v2.1.68 或以上版本；Windows 要求 Windows 10（版本 1809 / build 17763）及以上。Claude Code 更新频繁，GitHub Releases 显示 2026 年 10 月已发布到 2.1.30x 系列，旧版本建议先升级。

2. 令牌已创建，并且分配了分组

令牌需要在 DDS Hub 控制台创建（文档「令牌创建 & Token 获取」章节）。FAQ 中列有 403 API Key is not assigned to any group and cannot be used.，说明没有分组的 Key 不能直接用。

3. 选对分组

模型广场在 2026-10-23 列出的 Anthropic 分组有：Claude Kiro 分组（倍率 0.6）、Claude Max 号池分组（2）、Claude 稳定分组（3.5，页面标注推荐）、企业分组（定制）。倍率会调整，以你创建令牌时的页面为准。页面没有标明每个模型对应哪个分组，下单前可以在控制台或客服处确认。

二、安装 Node.js 与 Claude Code

macOS 文档示例使用 Homebrew：

bash 复制代码

brew install node
node -v
npm -v

Windows 文档示例在管理员 PowerShell 中使用 Chocolatey 安装 Node.js：

powershell 复制代码

choco install nodejs --version="24.13.0"

然后两个系统都用 npm 全局安装：

bash 复制代码

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

npm 下载慢时，文档给出的镜像设置是：

bash 复制代码

npm config set registry https://registry.npmmirror.com

macOS 遇到权限问题，可以把 npm 全局目录改到用户目录，尽量少用 sudo；Windows 用管理员身份重开 PowerShell。

三、配置令牌与服务地址

Claude Code 读取两个环境变量：ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。

macOS（zsh 为例） ，在 ~/.zshrc 末尾添加：

bash 复制代码

export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_BASE_URL="https://www.ddshub.cc"

保存后执行 source ~/.zshrc。

Windows（PowerShell） ，执行 notepad $PROFILE，在末尾添加：

powershell 复制代码

$env:ANTHROPIC_AUTH_TOKEN = "sk-你的令牌"
$env:ANTHROPIC_BASE_URL   = "https://www.ddshub.cc"

保存后重开终端，或执行 . $PROFILE。也可以在「系统设置 → 环境变量」里新建两个同名用户变量。

两点注意：

地址按文档写成 https://www.ddshub.cc，不要自行追加 /v1。这个地址只适用于 Claude Code 的这套配置，其他 SDK 或客户端要看各自的教程。
令牌不要写进项目仓库的脚本或 .env 后提交到 Git。一旦泄露，到控制台吊销重建。

四、验证配置

先确认变量已经生效。只检查是否设置，不把令牌打印到终端，避免出现在录屏和日志里：

powershell 复制代码

# Windows PowerShell
if ($env:ANTHROPIC_AUTH_TOKEN) { "TOKEN 已设置" } else { "TOKEN 未设置" }
$env:ANTHROPIC_BASE_URL

bash 复制代码

# macOS / Linux
[ -n "$ANTHROPIC_AUTH_TOKEN" ] && echo "TOKEN 已设置" || echo "TOKEN 未设置"
echo "$ANTHROPIC_BASE_URL"

然后运行环境检查，再进入任意项目目录启动：

bash 复制代码

claude doctor
claude

预期结果：claude doctor 没有报连通性错误；在 Claude Code 中输入一句「介绍一下你自己」，能正常返回回答。

五、常见报错的排查顺序

DDS Hub FAQ 页面列出了以下报错标题，具体处理说明默认折叠，请以页面展开内容为准。下面的排查顺序是编辑建议，帮助你先缩小范围：

报错	先查什么
`401 API key is required in Authorization header`	变量名是否写对、终端是否重开、`$PROFILE` 是否真的被加载
`403 API Key is not assigned to any group`	控制台里该令牌是否分配了分组
`503 No available accounts: this group only allows Claude Code clients`	当前分组仅限 Claude Code 客户端；如果你在用其他工具，换对应分组的令牌
`429 api key 日限额已用完`	令牌的日限额设置
`429 Upstream rate limit exceeded`	上游限流，降低并发，稍后重试
`502 Upstream service temporarily unavailable`	上游暂时不可用，稍后重试或查看公告
`UND_ERR_SOCKET` / `ECONNRESET` / `EAI_AGAIN`	本地网络、DNS 和代理设置
使用 CC Switch 时出现 503	先关掉 CC Switch 直接用环境变量对比，确认问题是否出在切换工具的配置

整体顺序可以记成：地址与客户端 → 令牌与分组 → 限额与并发 → 网络与上游。401、403 基本是本地配置或令牌问题，反复重试没有意义；429、502 更多和用量或上游状态有关，换 Key 也不一定能解决。

六、适用边界

这套配置只针对 Claude Code CLI。VS Code / JetBrains 插件、Cherry Studio、Chatbox 等工具在 DDS Hub 文档里各有章节，字段不完全一样。
模型出现在模型广场，只说明平台列出了它，能否调用还取决于令牌分组和客户端。
DDS Hub 是第三方接入服务，文中提到的 Claude、Claude Code 品牌属于 Anthropic，兼容接入不代表获得上游授权。
价格、分组倍率与折扣会变化，计算成本时以当天模型页为准。