使用 CC-Switch 配置

什么是 CC-Switch？

CC-Switch 是一个本地配置管理工具，可以帮你统一管理 Codex 等客户端的 API 配置。对新用户来说，它比手动改配置文件更省心，也方便后续在多个配置之间切换。

它主要解决这几件事：

• 一键切换不同客户端或供应商配置
• 可视化管理 API Key、接口地址和模型配置
• 支持系统托盘快捷操作
• 支持本地代理与配置热切换
• 支持把后台生成的配置直接导入到 CC-Switch

下载 CC-Switch

访问 CC-Switch Releases 下载适合当前系统的安装包。Windows 用户通常选择 .msi 或 Windows-Portable.zip。

在 Releases 页面下载适合当前系统的安装包。

安装完成后，先打开一次 CC-Switch，确保系统已经注册好导入协议。

从后台导入配置

先在后台创建一个 ApiKey。如果还没有创建，可以先看 ApiKey 管理。

导入流程按下面走即可：

1. 进入后台左侧菜单的 API 密钥。
2. 找到要使用的 ApiKey，确认它已经选择了可用分组。
3. 在该密钥的操作区点击 导入到 CCS。

在 API 密钥列表中点击导入按钮。

4. 浏览器会唤起 CC-Switch，并展示即将导入的配置。
5. 确认应用类型、供应商名称、API 端点和模型信息无误后，点击 导入。

确认信息无误后导入到 CC-Switch。

提示

如果提示 CC-Switch 未安装或协议处理程序未注册，先确认 CC-Switch 已经安装并打开过一次。
如果仍然无法唤起，可以重新安装 CC-Switch，或暂时改用后面的手动配置页面。

选择并验证配置

导入完成后，回到 CC-Switch 主界面，选择刚导入的配置作为当前配置。

导入完成后，在 CC-Switch 中启用刚导入的配置。

然后打开终端，运行 Codex 进行测试：

codex

如果能正常进入客户端并发送消息，就说明配置已经生效。

什么时候需要手动配置？

大多数情况下直接导入即可。只有在下面这些情况，才建议看后面的手动配置页面：

• 浏览器无法唤起 CC-Switch
• 当前系统无法安装 CC-Switch
• 你想自己维护配置文件
• 需要排查某个客户端的配置细节

手动配置入口：

• Codex 配置