跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 左上角菜单中选择 Help → Troubleshooting → Enable Developer Mode。
在 Claude 桌面端 Help 菜单里选择 Enable Developer Mode。
在确认窗口中点击 Enable，然后重启 Claude 桌面端。
确认启用 Claude 桌面端 developer mode。
3

打开第三方推理配置

重启后，macOS 左上角菜单会出现 Developer 选项。选择 Developer → Configure 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.ai；Codex 分组填写 CC Switch 复制出的本地服务地址
  2. Gateway API key 是否来自 BetterToken 控制台的 令牌管理
  3. Gateway auth scheme 是否与 API Key 分组匹配：Claude 分组使用 x-api-key，Codex 分组使用 bearer
  4. 是否点击了 Apply locally
  5. 如果使用 Codex 分组，是否已在 CC Switch 路由设置中打开 路由总开关 和 Claude 路由开关
  6. 是否点击 Relaunch now 并在重启后选择 Continue with Gateway