Your provider setup needs a fix Some required fields are missing or malformed. Open Setup to finish configuring it. 同时,输入框左下角的第三方模型选择为空,只显示 Legacy Model 这类不可用状态。

这条路径适合使用 GPT 分组 API Key。不要把
https://www.bettertoken.ai/v1 直接填进 Claude Desktop Gateway。配置步骤
1
下载 Claude 桌面端
2
启用 developer mode
打开 Claude 桌面端后,在 macOS 左上角菜单中选择 Help → Troubleshooting → Enable Developer Mode。
在确认窗口中点击 Enable,然后重启 Claude 桌面端。


3
打开第三方推理配置
重启后,macOS 左上角菜单会出现 Developer 选项。选择 Developer → Configure Third-Party Inference…。

4
切到 Claude Code 并添加 provider
打开 CC Switch,切到 Claude Code,点击 Add Provider。

5
填写基础字段
- Provider Name:
BetterToken - Base URL:
https://www.bettertoken.ai - API Key:你的 BetterToken API Key
- Provider Name
- API Key
- Base URL

6
设置 API 格式和模型映射
打开 高级选项,在 API 格式 中选择 OpenAI Responses API。
在 模型映射 里点击 获取模型列表,将 主模型、推理模型(Thinking)、Haiku 默认模型、Sonnet 默认模型、Opus 默认模型 都从下拉列表中显式选中。
这里使用的模型都应来自 BetterToken 模型广场 当前可用的 GPT 分组模型 ID。


7
保存、切换,并开启代理
保存后,回到渠道列表页:
- 将刚保存的 BetterToken provider 设为 使用中
- 打开左上角的 CC Switch 代理功能

8
进入 CC Switch 设置
回到 CC Switch 主界面后,点击左上角的 设置。

9
确认路由已打开并复制服务地址
进入 路由 设置,确认图中标注的 路由总开关 和 Claude 路由开关都已打开。然后复制下方显示的 服务地址。

10
在 Claude 桌面端填入 Gateway base URL
回到 Claude 桌面端的第三方推理配置窗口,选择 Gateway。把刚才复制的 CC Switch 服务地址 填入 Gateway base URL,并填写你的 BetterToken API Key。Gateway auth scheme 选择 
bearer。
11
添加模型列表并应用到本机
在 Model list 里增加要展示的模型。每个模型都需要同时填写 Model ID 和 Display name。例如:
填写完成后点击 Apply locally。

12
确认重启客户端
Claude 写入本地配置后会提示保存并重启。点击 Save & Restart,让新网关配置生效。

13
选择 Gateway 网关登录
重启后等待约 3 秒,会出现登录方式选择界面。
选择 Continue with Gateway。进入 Claude 后,左下角显示 Cowork 3P | Gateway,即可正常使用。


排查建议
如果仍然看到 Your provider setup needs a fix,优先检查:- CC Switch 里的 BetterToken provider 是否已设为 使用中
- API 格式 是否已选择 OpenAI Responses API
- 模型映射 是否已为主模型、Thinking、Haiku、Sonnet、Opus 显式选择 GPT 分组模型
- CC Switch 代理功能、路由总开关 和 Claude 路由开关是否都已打开
- Claude Desktop 的 Gateway base URL 是否为 CC Switch 复制出的本地服务地址
- Model list 是否已为每个模型同时填写 Model ID 和 Display name