CC Switch 接入 Codex 详细教程
一、什么是 CC Switch？
CC Switch 是一个本地代理桌面应用，它可以将各种大模型（如小米 MiMo、Claude、Gemini 等）的 API 转换为 OpenAI 兼容格式，从而让 Codex CLI / Codex Desktop 使用任意第三方模型。
工作原理：
Codex ──请求──> CC Switch (本地代理 127.0.0.1:15721) ──转发──> 第三方模型 APICC Switch 充当一个"翻译层"，将 Codex 发出的 OpenAI 格式请求转发到你配置的任意模型提供商。
二、前置准备
已安装 Codex CLI 或 Codex Desktop
- 验证：终端运行
codex --version能正常输出版本号
- 验证：终端运行
下载 CC Switch
- 从 GitHub Release 下载：
https://github.com/farion1231/cc-switch/releases - Windows 用户下载
.exe安装包
- 从 GitHub Release 下载：
准备至少一个模型的 API Key
- 例如：小米 MiMo (
https://api.xiaomimimo.com) - 或其他兼容 OpenAI 格式的提供商
- 例如：小米 MiMo (
三、安装与启动 CC Switch
步骤 1：安装
双击下载的安装包，按提示完成安装。安装后桌面会出现快捷方式。
步骤 2：启动 CC Switch
双击桌面的CC Switch图标启动程序。首次启动后，它会在系统托盘中运行，并自动监听本地端口15721。
验证是否启动成功：
netstat -ano | Select-String "15721"看到类似TCP 127.0.0.1:15721 ... LISTENING即表示启动成功。
四、在 CC Switch 中添加模型提供商
步骤 1：打开供应商管理
打开 CC Switch 主界面，点击左侧边栏的"供应商"标签页。
步骤 2：添加新供应商
点击"+ 添加"按钮，填写以下信息：
| 字段 | 说明 | 示例 |
|---|---|---|
| 供应商名称 | 自定义名称 | Xiaomi MiMo |
| API 基础 URL | 模型的 API 地址 | https://api.xiaomimimo.com/v1 |
| API Key | 你的 API 密钥 | sk-xxxxxxxxxxxx |
| 模型 ID | 要使用的模型名称 | mimo-v2.5-pro |
步骤 3：激活供应商
在供应商列表中，点击你想使用的供应商右侧的激活按钮（圆形切换按钮），使其变为"当前激活"状态。
上图可以看到：
- 连接状态：已连接 ✅
- 代理端口：15721
- 代理模式：模型直连
- 当前激活：
Xiaomi MiMo178 copy/mimo-v2.5-pro
步骤 4：查看供应商列表
点击左侧"供应商"可以看到所有已配置的提供商：
每个供应商显示名称、API 地址、模型列表和连接状态。
五、CC Switch 自动管理的 Codex 配置
CC Switch 启用"接管"功能后，会自动修改~/.codex/config.toml：
关键配置说明：
| 配置项 | 作用 |
|---|---|
model_provider | 设为"custom"表示使用自定义提供商 |
model | 当前使用的模型 ID（如mimo-v2.5-pro） |
model_catalog_json | 模型能力目录文件名 |
base_url | 指向 CC Switch 本地代理http://127.0.0.1:15721/v1 |
wire_api | 通信协议（responses） |
requires_openai_auth | 是否需要 OpenAI 认证 |
重要：不要手动修改这些配置，CC Switch 会在切换供应商时自动更新。
六、在 Codex 中使用
配置完成后，正常使用 Codex 即可：
# 命令行模式 codex # 或者直接提问 codex "帮我写一个 Python 快速排序"七、CC Switch 核心功能
7.1 热切换供应商
在 CC Switch 中切换不同供应商时，Codex 的配置会实时更新，无需重启 Codex。
7.2 自动备份
CC Switch 会自动备份 Codex 配置到~/.cc-switch/backups/。
7.3 代理模式
| 模式 | 说明 |
|---|---|
| 模型直连 | 请求直接转发到目标模型 API |
| 负载均衡 | 在多个同模型供应商间轮转请求 |
7.4 设置页面
八、常见问题排查
Q1: Codex 连接失败— 检查 CC Switch 是否运行，端口 15721 是否监听。
Q2: 模型返回 500 错误— 查看日志~/.cc-switch/logs/cc-switch.log，通常是 API Key 无效或模型提供商异常。
Q3: 切换供应商后没生效— 重启 Codex 即可。
九、目录结构
~/.codex/ ├── config.toml # Codex 主配置（CC Switch 管理） ├── cc-switch-model-catalog.json # 自定义模型目录 ~/.cc-switch/ ├── settings.json # CC Switch 设置 ├── cc-switch.db # 数据库 ├── logs/cc-switch.log # 运行日志 └── backups/ # 配置备份十、总结
- 安装并启动 CC Switch
- 添加模型供应商（填入 API 地址和 Key）
- 激活目标供应商
- 正常使用 Codex、
如有问题，可以私信解决
如果cc-switch提供的配置有问题也可以找我