跳转到主要内容
Claude 桌面端支持通过 developer mode 配置第三方推理网关。你可以根据 BetterToken API Key 分组,选择直接填写 Anthropic 协议入口,或通过 CC Switch 本地路由转发请求。
如果你使用 Claude 分组 API Key,可以在 Claude 桌面端直接填写 https://www.bettertoken.ai。如果你使用 Codex 分组 API Key,建议先通过 CC Switch 建立本地路由,再把本地服务地址填入 Claude 桌面端。不要把 Codex / OpenAI-compatible 协议使用的 https://www.bettertoken.ai/v1 直接填进 Claude 桌面端 Gateway。

配置步骤

1

下载 Claude 桌面端

通过官方链接下载最新版 Claude 桌面端:下载 Claude for Mac安装完成后不要登录 Claude 账号,直接进入下一步启用 developer mode。
2

启用 developer mode

打开 Claude 桌面端后,在 macOS 左上角菜单中选择 HelpTroubleshootingEnable Developer Mode
在 Claude 桌面端 Help 菜单里选择 Enable Developer Mode。
在确认窗口中点击 Enable,然后重启 Claude 桌面端。
确认启用 Claude 桌面端 developer mode。
3

打开第三方推理配置

重启后,macOS 左上角菜单会出现 Developer 选项。选择 DeveloperConfigure Third-Party Inference…
在 Developer 菜单中选择 Configure Third-Party Inference。
完成前 3 步后,根据你的 BetterToken API Key 分组选择继续配置方式。
1

填写 BetterToken API 信息

在配置窗口中选择 Gateway,然后填写以下信息:
字段填写内容
Gateway base URLhttps://www.bettertoken.ai
Gateway API key在 BetterToken 控制台的 令牌管理 中复制 API Key
Gateway auth schemex-api-key
选择 Gateway auth scheme 后,Claude 桌面端会自动获取 Claude 分组下可用的模型。填写完成后点击 Apply locally
在 Claude 桌面端配置 BetterToken Gateway 信息并点击 Apply locally。
2

确认重启客户端

Claude 写入本地配置后会提示重启。点击 Relaunch now,让新网关配置生效。
Claude 桌面端提示 Relaunch Claude,点击 Relaunch now 重启客户端。
3

选择 Gateway 网关登录

重启后等待约 3 秒,会出现登录方式选择界面。
Claude 桌面端显示 Continue with Gateway 登录选项。
选择 Continue with Gateway。进入 Claude 后,左下角显示 Cowork 3P | Gateway,即可正常使用。
Claude 桌面端已通过 Gateway 进入并可以正常使用。

排查建议

如果 Claude 桌面端没有出现 Developer 菜单,确认你已经点击 Enable 并完全重启应用。 如果请求失败,优先检查:
  1. Gateway base URL 是否与分组路径一致:Claude 分组填写 https://www.bettertoken.aiCodex 分组填写 CC Switch 复制出的本地服务地址
  2. Gateway API key 是否来自 BetterToken 控制台的 令牌管理
  3. Gateway auth scheme 是否与 API Key 分组匹配:Claude 分组使用 x-api-keyCodex 分组使用 bearer
  4. 是否点击了 Apply locally
  5. 如果使用 Codex 分组,是否已在 CC Switch 路由设置中打开 路由总开关Claude 路由开关
  6. 是否点击 Relaunch now 并在重启后选择 Continue with Gateway