开始使用 CC Switch

使用 CC Switch 管理客户端的供应商配置:导入密钥、选择目标应用,再验证连接。

创建 API 密钥

登录空想云并打开「API 密钥」。创建一枚名称易于识别的密钥,复制后用于客户端配置。

下载 CC Switch

从 CC Switch 官网下载与设备匹配的 macOS、Windows 或 Linux 安装包,并完成安装。

打开 CC Switch

macOS 用户从「应用程序」打开 CC Switch;Windows 用户从「开始」菜单打开;Linux 用户从应用列表打开。导入配置时请保持应用运行。

从 ReverixAI空想云 导入密钥

在「API 密钥」的密钥菜单中选择「CC Switch」。导入窗口会列出当前密钥可用的模型。

选择目标应用

Select the application you actually use, enter a provider name, and select an available model before opening CC Switch.

打开供应商

在 CC Switch 中为目标应用启用刚导入的供应商,并保存配置。

重启客户端

完全重启目标客户端,选择当前 API 密钥可用的模型并发送简短请求,确认能够收到正常回复。

请求失败时

请先阅读具体报错,再调整配置。401 可能与密钥缺失、过期、禁用或未正确加载有关;404 需核对接口地址和模型 ID;模型列表为空时,还需检查密钥分组的模型权限。

Codex 0.149.0 升级后出现 401

升级至 Codex 0.149.0 后,原本可用的自定义供应商可能出现 `API_KEY_REQUIRED` 或 `401 Unauthorized`。如果该配置依赖 `auth.json` 中保存的 API 密钥,且设为 `requires_openai_auth = false`,可按下方步骤检查鉴权设置。

备份并打开配置文件

请先退出客户端,将 `config.toml` 复制一份作为备份,再使用纯文本编辑器打开。默认路径如下;如果自行设置了 `CODEX_HOME`,请以该目录中的配置文件为准。

macOS:`~/.codex/config.toml`

Windows:`%USERPROFILE%\.codex\config.toml`

仅修改当前使用的供应商

先找到 `model_provider` 当前选中的供应商 ID,再定位对应的 `[model_providers.<id>]` 配置段。将该段中原有的 `requires_openai_auth = false` 改为下方内容,保留供应商 ID、接口地址、模型及其他设置。

requires_openai_auth = true

保存、重启并验证

Save the file, fully quit and reopen the ChatGPT client, then test a new conversation. If CC Switch manages the configuration, also check its saved provider settings so a later switch does not restore the old value.

仍然报错时

确认当前供应商指向 `https://reverix.ai/v1`,且保存的是有效的空想云 API 密钥,再检查密钥状态、有效期及客户端实际加载的配置。401 存在多种原因,此设置并非所有鉴权报错的通用修复。