一、什么是 CC Switch？

CC Switch 是一个本地代理桌面应用，它可以将各种大模型（如小米 MiMo、Claude、Gemini 等）的 API 转换为 OpenAI 兼容格式，从而让 Codex CLI / Codex Desktop 使用任意第三方模型。

工作原理：

Codex ──请求──> CC Switch (本地代理 127.0.0.1:15721) ──转发──> 第三方模型 API

CC Switch 充当一个"翻译层"，将 Codex 发出的 OpenAI 格式请求转发到你配置的任意模型提供商。

---

二、前置准备

1. 已安装 Codex CLI 或 Codex Desktop

   • 验证：终端运行 codex --version 能正常输出版本号

2. 下载 CC Switch

   • 从 GitHub Release 下载：https://github.com/farion1231/cc-switch/releases
   • Windows 用户下载 .exe 安装包

3. 准备至少一个模型的 API Key

   • 例如：小米 MiMo (https://api.xiaomimimo.com)
   • 或其他兼容 OpenAI 格式的提供商

---

三、安装与启动 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/                       # 配置备份

---

十、总结

1. 安装并启动 CC Switch
2. 添加模型供应商（填入 API 地址和 Key）
3. 激活目标供应商
4. 正常使用 Codex、

如有问题，可以私信解决

如果cc-switch提供的配置有问题也可以找我