用 CC Switch 对接 Codex：一键接入 DeepSeek 等任意模型

用 CC Switch 对接 Codex：一键接入 DeepSeek 等任意模型

问题场景：你装好了 Codex，兴冲冲地打开想让它干活，却发现它要求用 ChatGPT 账号登录——要么没账号，要么订阅太贵，要么网络连不上。好不容易听说可以接 DeepSeek 的 API，一查教程，发现要手动编辑 config.toml、写 model_providers 配置，改错一个字母整个工具就罢工。有没有一种办法，像切换 Wi-Fi 一样，点一下鼠标就能在官方模型和第三方模型之间来回切？

答案就是 CC Switch：一个专门管理各类 AI 编程工具的桌面软件，把「手改配置文件」变成「图形界面点几下」。本教程不需要编程基础，我会讲清楚 CC Switch 是什么、为什么用它、怎么一步步把 Codex 接上 DeepSeek（或其他任意模型），以及踩坑了怎么排查。

一、先搞清楚：Codex 为什么需要「对接」

Codex 本身并不只认 OpenAI 一家模型。它支持两种用法：

1. 官方登录：用 ChatGPT 账号登录，消耗订阅额度，用 GPT 系列模型；
2. API 接入：填一个第三方模型的 API 地址和密钥，把 DeepSeek、Kimi、GLM 等模型接进来。

第二种方式之所以诱人，是因为：便宜（DeepSeek 几块钱能用很久）、国内直连（不用魔法）、中文友好。但它有个大麻烦——Codex 的模型配置是写在配置文件里的（终端版是 ~/.codex/config.toml，要手写 TOML 语法）。对新手来说，手改配置文件既容易出错，改错了还难恢复。

于是问题就变成了：怎么安全、方便地给 Codex 换模型？ 这正是 CC Switch 要解决的事。

二、CC Switch 是什么：AI 编程工具的「换卡管家」

CC Switch 是一个开源的跨平台桌面应用（基于 Tauri 构建，支持 Windows / macOS / Linux）。

它的定位是一句话：同时管理 Claude Code、Codex、Gemini CLI、Grok、OpenCode 等 8 种 AI 编程工具的「一站式换卡工具」。

这些工具各有各的配置格式（JSON、TOML、.env……），平时想换个 API 供应商，得挨个文件手动改。CC Switch 用一个图形界面把这些活全包了：

对本文来说，我们只需要用到它最核心的功能：给 Codex 添加一个第三方模型供应商，并一键启用。

顺带搞懂原理：CC Switch 其实是个「翻译官」

很多人以为 CC Switch 只是「帮你改配置文件」，其实它的关键作用是在本地做协议转换。

这里有个容易忽略的背景：Codex 默认按 OpenAI 的 Responses API（一种「任务委托型」接口）发请求；而 DeepSeek 等很多模型早期只提供 Chat Completions API（「你问我答」型接口）。两者格式不同，直接对接会「鸡同鸭讲」。

CC Switch 的解决办法是在你电脑上起一个本地代理（默认监听 127.0.0.1:15721），干三件事：

1. 接收 Codex 发来的 Responses API 请求；
2. 把它「翻译」成 DeepSeek 能懂的 Chat Completions API，转发给 DeepSeek；
3. 把 DeepSeek 的回复再「翻译」回 Responses API 格式，还给 Codex。

这也是为什么教程里反复强调要开启本地路由——路由不开，中转站没工作，Codex 自然连不上。理解了这一点，后面排错时看到各种「正在重新连接」就不慌了。

三、开始前的准备

动手之前，准备三样东西：

1. 装好 Codex

本教程以 Codex 桌面版为例（终端 CLI 版原理相同）。如果你还没装 Codex，先把桌面 App 装好、能打开登录界面即可——注意：不需要先登录 ChatGPT 账号，后面我们直接用第三方 API 接入，登录界面这一步会被跳过。

💡 如果你用的是 CLI 版，也可以通过 CC Switch 对接，步骤几乎一致，只是最后重启的是终端里的 codex 命令。

2. 准备一个 DeepSeek API Key（以 DeepSeek 为例）

CC Switch 支持接任意模型，本文以国内最常用的 DeepSeek 为例，你也可以换成其他 OpenAI 兼容的 API 服务商。

1. 打开 DeepSeek 开放平台（platform.deepseek.com），注册并登录；
2. 进入「API Keys」页面，点击「创建 API Key」；
3. 复制生成的 Key（形如 sk-xxxx），保存好，只显示一次；
4. 给账户充一点钱（几块钱就够测试了）。

⚠️ 记下你的 Key 和模型的 API 地址。DeepSeek 的官方接口地址是 https://api.deepseek.com，模型名通常是 deepseek-chat（对话）和 deepseek-reasoner（推理）。这些信息等会儿要填进 CC Switch。

3. 下载安装 CC Switch

• Windows：到 GitHub Releases 页面下载 CC-Switch-v{版本号}-Windows.msi 安装包，或 .zip 绿色版，双击安装；
• macOS：推荐用 Homebrew 一键装——brew install --cask cc-switch；也可以下载 .dmg 手动安装；
• Linux：下载 .deb / .rpm / .AppImage 对应版本。

安装后首次打开，界面是中文的（支持简中/繁中/英/日），跟着下一步走完即可。

四、核心步骤：把 DeepSeek 接进 Codex

下面是最关键的部分。整体思路只有三步：加供应商 → 开启路由 → 重启 Codex。

第 1 步：在 CC Switch 里添加供应商

1. 打开 CC Switch，在左侧或顶部选择你要管理的工具为 Codex；
2. 点击「添加供应商」（Add Provider），进入配置页；
3. 供应商类型选择 OpenAI 兼容（DeepSeek 的接口兼容 OpenAI 协议，所以要把 DeepSeek 配置在 OpenAI 栏目下，这一步位置选错会导致后面路由打不开）；
4. 填写关键信息：
   • API 地址（Base URL）：填 https://api.deepseek.com；
   • API Key：粘贴刚才复制的 DeepSeek Key；
   • 模型列表：点「获取模型列表」按钮自动拉取（Key 和地址填对就能拉到），或手动填 deepseek-chat、deepseek-reasoner；
   • 关闭「完整 URL / isFullUrl」选项（如果不关，部分场景会强制走 Responses→Chat 转换，容易报 502）；
5. 在「模型 / Model」设置处，把默认模型改成上面拉取到的推荐模型，类型选 Custom（自定义），其余保持默认；
6. 保存配置。

第 2 步：启用供应商、开启本地路由

1. 回到主界面，选中刚添加的 DeepSeek 供应商，点击「启用」（Enable）；
2. 找到「代理 / 本地路由」相关开关，确认已开启（CC Switch 会在本地起一个转发端口，把 Codex 发来的请求转发到 DeepSeek，默认地址形如 127.0.0.1:15721）。

这一步的作用是「应用级接管」：CC Switch 在本地扮演一个中转站，Codex 以为是连官方服务器，实际上请求被转发给了 DeepSeek。

第 3 步：彻底重启 Codex，验证

1. 彻底退出 Codex：不是点右上角的叉，而是右键任务栏/菜单里的图标选择「退出」（Windows 上从系统托盘彻底退出，否则配置不生效）；
2. 重新打开 Codex；
3. 正常对话测试一句，比如「用一句话介绍你自己」，如果返回正常回答，就说明对接成功了。

💡 判断是否接通的技巧：问它「你是什么模型」，如果它回答 DeepSeek 或相关模型，说明走的是第三方 API；如果它回答自己是 GPT，也不一定代表失败——CC Switch 会写入一些提示词约束，让接入的模型默认自称 GPT，这属于正常现象，以「能否正常对话、能否干活」为准。

五、日常使用：切换模型、切回官方

装好之后，CC Switch 的最大价值才开始体现——随时一键换模型：

• 切换到另一个第三方模型：在 CC Switch 里再添加一个供应商（比如 Kimi、GLM 或某个中转服务），点「启用」即可，不用重新配置；
• 快速切换：在系统托盘（右下角图标）上直接点目标供应商名，立即生效；
• 切回官方 ChatGPT 登录：添加一个「官方登录」预设并启用，重启 Codex 后按正常的账号登录/OAuth 流程走一遍，就回到官方模型了。

也就是说，官方和第三方、多个第三方之间，都能像切歌一样来回换。

六、踩坑排查：90% 的问题都在这

对接过程中最容易卡住的是「正在重新连接」（Reconnecting）和各种报错。下面按常见现象整理排查方向：

1. Codex 一直显示「正在重新连接」

这个现象要分情况看，错误提示里通常带一个状态码，对号入座即可：

2. 接入后不显示模型名称

有些版本接入第三方模型后，模型选择器里不显示模型名。一般是本地网络问题导致语言/模型列表没同步下来；保持网络畅通后重启 Codex 会自动识别。英文界面不影响使用。

3. 配置好了还是停在登录界面

大概率是没有彻底退出 Codex。Windows 上要在系统托盘右键图标选择「退出」，而不是只关窗口，然后重新打开。

4. CC Switch 打不开路由 / 路由开关置灰

最常见的原因是供应商配错栏目：DeepSeek 这类 OpenAI 兼容接口要配置在 OpenAI 分类下，而不是 DeepSeek 分类下。删掉重建一个即可。

5. 安装时报错：安装包不支持

多半是下错了 CPU 架构版本。Windows 下载页里同时有普通版和 Windows-ARM64.msi，如果你用的是 Intel/AMD 的电脑却下载了 ARM64 版，就会装不上或打不开。判断方法：右键「此电脑」→「属性」查看处理器信息，是 ARM 架构才选 ARM64，否则就下普通 Windows 版。

6. Codex 界面是英文 / 不支持中文

Codex 需要联网下载语言包，本地网络受限时即使选了中文也仍是英文。配好网络环境后重启，会自动下载语言包并跟随系统语言；英文界面不影响核心功能。

7. 发送图片报错

DeepSeek 的 API 目前不支持多模态，图片识别会报错。这是上游模型能力限制，不是配置问题。注意：发图报错后，当前对话窗口可能会反复报同样的错，需要新开一个对话才能继续。

七、进阶思考：一定要用 CC Switch 吗？

网上也有不少声音说「别再用 CC Switch 对接 Codex」，理由是：CC Switch 走的是本地代理中转，多一跳协议转换，理论上会多耗一点 Token、响应稍慢。更重要的是，情况正在变化——2026 年 8 月 DeepSeek 发布的 V4 Pro 模型已经原生支持 Responses API，不再需要 CC Switch 做协议翻译，Codex 可以直接「裸连」。

DeepSeek 官方为此提供了一键配置脚本，操作大致是：

1. 打开 DeepSeek 开放平台 →「接口文档」→ 接入引擎选 Codex；
2. 复制官方给的一键脚本，Windows 用户在 PowerShell 里粘贴执行（macOS 在终端执行）；
3. 脚本会问你要配哪个模型（选 V4 Pro 或 V4 Flash）、输入 API Key；
4. 完成后再打开 Codex 即可直接使用；想换模型就重新跑一次脚本、选另一个。

两种思路各有道理，可以这样选：

• 适合用 CC Switch：你经常在多个模型/多个账号之间切换，不想碰配置文件，或者还要同时管 MCP、Skills——CC Switch 的图形界面和快切能力无可替代；
• 适合原生直连：你只用 DeepSeek V4 Pro / V4 Flash 一个模型且追求极致省 Token，那用官方脚本直接配置 config.toml 更干净，少一层中转。

对绝大多数用户来说，CC Switch 是性价比最高的入门方案：先跑通、先能用，等真正理解了配置原理，再考虑要不要「裸奔」也不迟。

八、总结

回顾一下整条链路：

1. 为什么要对接：Codex 默认用 ChatGPT 订阅，第三方 API 更便宜、更易连；
2. CC Switch 干什么：把「手改配置文件」变成「图形界面点几下」，支持一键换模型、快切、MCP/Skills 管理；
3. 三步搞定：加供应商（OpenAI 兼容栏目 + DeepSeek 地址和 Key + 关完整 URL）→ 开本地路由 → 彻底重启 Codex；
4. 踩坑靠状态码：401 看 Key、402 看余额、404 看路由和地址、502 看系统代理；
5. 是否必须用 CC Switch：想省事、要快切就选它；只用单模型追求极致可以原生改配置。

装好之后，你就拥有了一个「随时换大脑」的 Codex——今天用 DeepSeek 省钱，明天切回 GPT 攻坚，点一下的事。