⚠ 官方声明
CC Switch 完全免费开源,不收取任何费用。近期出现多个山寨付费站点,请从 ccswitch.io 或 github.com 下载,任何收费均为假冒。
如果你在用 Codex,大概率遇到过这个问题:官方模型强但贵,国产模型便宜、中文友好,却根本接不进去。
原因在于 Codex 只认 OpenAI 的 Responses API,而几乎所有国产模型只输出 Chat Completions API。两套协议不互通。
CC Switch v3.16.0 在本地内置了一个协议转换层:它把 Codex 发出的 Responses 请求实时翻译为 Chat Completions,上游返回后再重新封装成 Responses 信封。整个过程对 Codex 完全透明,一键即可切换到 DeepSeek、MiMo、Kimi、GLM、MiniMax 等国产模型。
01 三步配通,不用手搭代理
1. 安装 CC Switch
macOS 已纳入 Homebrew 官方 cask 仓库:
brew install --cask cc-switch
Windows 下载 .msi;Linux 提供 AppImage / deb / rpm。均支持 x86 与 ARM64。
2. 添加模型供应商
打开 CC Switch,切到 Codex 标签,点右上角 + 号,在预设列表里选择你要用的供应商,填上 API Key,点击添加。内置模型预设,无需手动填写模型 ID。
3. 启用路由
点击供应商旁的启用开关,并开启本地路由,然后重启 Codex 应用。
必须重启 Codex,模型目录在启动时加载,热切不生效。
02 内置 22 个供应商预设
每个预设都配好了模型目录和上下文窗口,不用再手动填模型 ID。
| 供应商 |
模型支持 |
| DeepSeek |
v4-Flash / Pro,适配思考等级 |
| Kimi |
Kimi-K2.6 |
| 智谱 GLM |
GLM-5.1 |
| 小米 MiMo |
MiMo-v2.5-Pro |
| MiniMax |
MiniMax-M2.7 |
| 火山方舟 |
适配 ark-code-latest 混合模型 |
此外还有百度千帆、StepFun、Qwen、ModelScope、Novita AI、Nvidia 等。不在列表里的中转站,只需选 Custom 手填 Base URL,兼容任何 OpenAI Chat 格式端点。
03 用之前,这几件事要知道
推理等级不一定生效
不同供应商对「思考强度」的支持并不相同,大致分为两类:
- ✓ 支持 effort 分档:DeepSeek、OpenRouter、StepFun(部分模型)
- ✗ 仅支持开/关:Kimi、GLM、Qwen、MiniMax、MiMo、硅基流动
对于仅支持开/关的供应商,在 Codex 里调节 low / medium / high 等级不会产生任何效果。这并非 bug,而是供应商本身的限制。
切换供应商,历史不会丢了
以往切换 Codex 第三方供应商后,老会话常因 ID 变化而凭空消失。v3.16 将全部第三方供应商统一归并到稳定的 custom 桶,首次启动时自动迁移历史数据。
原始文件备份在 ~/.cc-switch/backups/,无需担心数据丢失。
推荐的供应商组合策略
官方 OAuth(兜底)+ 国产主力(日常)+ 备用(防限流),三行切换,不必每次重新填 Key。Key 仅保存在本地 ~/.cc-switch/config.json,原子写入,不会上传。
04 这一版还做了什么
应用内 CLI 工具管理面板
设置「关于」页现已升级为 Claude / Codex / Gemini / OpenCode 的工具管理面板,支持静默安装、一键全部升级、冲突诊断,并按实际安装来源锚定升级命令。「已安装但跑不起来」的状态现在清晰可见,不再静默失败。
模型矩阵升级
默认 Claude Opus 升至 4.8,GPT 默认升至 5.5。新增 APIKEY.FUN、APINebula、AtlasCloud、SudoCode 合作伙伴预设,以及 Claude Desktop 官方预设(附中/英/日使用指南)。
用量看板实时刷新
日志写入时即时更新,不再等待下一个轮询周期。修复了 subagent 会话 token 计费、自定义用量脚本摘要,以及非 ASCII 模型名导致的同步 panic。
繁体中文 UI 本地化
新增 zh-TW 界面语言支持,同时新增德文 README。代理稳定性修复:Gemini Native 工具调用重放、MiMo 推理输出、胜算云模型 ID 前缀路由,及多条易 panic 的代理路径。
下载
github.com/farion1231/cc-switch/releases
CC Switch 开源免费 · macOS / Windows / Linux
同时支持 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes。MCP 服务器配置一次、所有工具共用,用量面板汇总全部对话的 Token 消耗。
CC Switch v3.16.0 · 2026-05-29