CC Switch 接入 Codex 详细教程

一、什么是 CC SwitchCC 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/releasesWindows 用户下载.exe安装包准备至少一个模型的 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 MiMoAPI 基础 URL模型的 API 地址https://api.xiaomimimo.com/v1API 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-promodel_catalog_json模型能力目录文件名base_url指向 CC Switch 本地代理http://127.0.0.1:15721/v1wire_api通信协议responsesrequires_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提供的配置有问题也可以找我