跳转到主要内容

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 Desktop 新版本对第三方 API 接入做了调整。Gateway 模式会校验模型 ID，直接填写 GPT、DeepSeek、GLM 等非官方模型 ID 时，可能会被拦截。 常见表现是页面顶部出现这条报错：Your provider setup needs a fix Some required fields are missing or malformed. Open Setup to finish configuring it. 同时，输入框左下角的第三方模型选择为空，只显示 Legacy Model 这类不可用状态。
Claude Desktop 提示 Your provider setup needs a fix，并且左下角第三方模型为空。
如果你想在 Claude Desktop 里继续使用 Codex 等第三方模型，建议通过 CC Switch 建立本地路由：先在 CC Switch 的 Claude Code 配置里接入 BetterToken，再把 CC Switch 的本地服务地址填入 Claude Desktop Gateway。
这条路径适合使用 Codex 分组 API Key。不要把 https://www.bettertoken.ai/v1 直接填进 Claude Desktop 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。
4

切到 Claude Code 并添加 provider

打开 CC Switch，切到 Claude Code，点击 Add Provider。
CC Switch 的 Claude Code 页面，右上角加号按钮用于新增 provider。
5

填写基础字段

  • Provider Name：BetterToken
  • Base URL：https://www.bettertoken.ai
  • API Key：你的 BetterToken API Key
下图中的标注对应：
  1. Provider Name
  2. API Key
  3. Base URL
CC Switch 的 provider 编辑页面，标出了 Provider Name、API Key 和 Base URL 的填写位置。
6

设置 API 格式和模型映射

打开 高级选项，在 API 格式 中选择 OpenAI Responses API。
CC Switch 的高级选项区域，API 格式被设置为 OpenAI Responses API。
在 模型映射 里点击 获取模型列表，将 主模型、推理模型（Thinking）、Haiku 默认模型、Sonnet 默认模型、Opus 默认模型 都从下拉列表中显式选中。
CC Switch 的模型映射区域，展示了获取模型列表以及主模型、Thinking、Haiku、Sonnet、Opus 的映射位置。
这里使用的模型都应来自 BetterToken 模型广场 当前可用的 Codex 分组模型 ID。
7

保存、切换，并开启代理

保存后，回到渠道列表页：
  1. 将刚保存的 BetterToken provider 设为 使用中
  2. 打开左上角的 CC Switch 代理功能
保存后回到渠道列表页，将 BetterToken 设为使用中，并打开左上角的 CC Switch 代理开关。
8

进入 CC Switch 设置

回到 CC Switch 主界面后，点击左上角的 设置。
CC Switch 主界面中，左上角设置按钮被箭头标出。
9

确认路由已打开并复制服务地址

进入 路由 设置，确认图中标注的 路由总开关 和 Claude 路由开关都已打开。然后复制下方显示的 服务地址。
CC Switch 路由设置页中，路由总开关、Claude 路由开关和服务地址复制按钮被标出。
10

在 Claude 桌面端填入 Gateway base URL

回到 Claude 桌面端的第三方推理配置窗口，选择 Gateway。把刚才复制的 CC Switch 服务地址 填入 Gateway base URL，并填写你的 BetterToken API Key。Gateway auth scheme 选择 bearer。
Claude 桌面端 Gateway 配置页中填入 CC Switch 本地服务地址。
11

添加模型列表并应用到本机

在 Model list 里增加以下模型：
  • claude-opus
  • claude-sonnet
  • claude-haiku
填写完成后点击 Apply locally。
Claude 桌面端 Model list 中添加 claude-opus、claude-haiku、claude-sonnet，并点击 Apply locally。
12

确认重启客户端

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

选择 Gateway 网关登录

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

​
排查建议

如果仍然看到 Your provider setup needs a fix，优先检查：
  1. CC Switch 里的 BetterToken provider 是否已设为 使用中
  2. API 格式 是否已选择 OpenAI Responses API
  3. 模型映射 是否已为主模型、Thinking、Haiku、Sonnet、Opus 显式选择 Codex 分组模型
  4. CC Switch 代理功能、路由总开关 和 Claude 路由开关是否都已打开
  5. Claude Desktop 的 Gateway base URL 是否为 CC Switch 复制出的本地服务地址
  6. Model list 是否包含 claude-opus、claude-sonnet、claude-haiku