使用 CC-Switch 配置 Codex

CC-Switch 的作用

CC-Switch 是一个本地配置管理工具，可以帮你写入和切换 Codex 的 API 配置。它不是另一种 Codex 客户端：导入完成后，你仍然在 Codex 桌面版 或 Codex CLI 中使用 Codex。

桌面版、CLI 和 IDE 扩展共用本机的 Codex 配置，因此通常只需要导入一次。

它主要解决这几件事：

• 一键切换不同客户端或供应商配置
• 可视化管理 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 客户端不会自动重新加载。请根据使用方式完成验证：

Codex 桌面版

1. 完全退出桌面应用，包括仍在系统托盘或后台运行的进程。
2. 重新打开应用并选择 Codex。
3. 打开一个本地项目，发送一条简单任务。

能够正常收到回复，就说明桌面版配置已经生效。

Codex CLI

先按 Ctrl + C 退出正在运行的 Codex 会话，再运行：

codex

进入会话并正常收到回复，就说明 CLI 配置已经生效。

什么时候需要手动配置？

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

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

手动配置入口：

• Codex 手动配置