用 CC Switch 把 DeepSeek 接入 Codex：完整配置指南
Codex 是 OpenAI 推出的 AI 编程助手，功能强大。本文介绍如何通过 CC Switch 将 DeepSeek 等国内大模型接入 Codex，无需登录 OpenAI 账号，保留完整功能。文章涵盖工作原理、环境准备、分步配置、模型选择及常见问题排查，适合想降低 AI 编程成本的开发者参考。
引言：为什么要给 Codex 换个"大脑"
Codex 是 OpenAI 推出的 AI 编程助手，内置代码补全、多步推理、插件系统，用起来确实顺手。但要真正跑起来，门槛不低——你得有 OpenAI 账号，得能稳定访问境外网络，有时候还要手机号验证。对很多开发者来说，这几道关卡比学会用它本身还烦。
与此同时，国内已经有一批大模型 API 质量不差，价格更低，访问也更稳定。DeepSeek、Kimi、MiniMax、通义千问……这些服务在国内直连没什么障碍，还都兼容 OpenAI 的 API 格式，看起来天然适合接入 Codex。
问题在于，"兼容 OpenAI 格式"这件事没有那么简单。Codex 内部用的是 OpenAI 最新的 Responses API，而国内这些供应商普遍提供的是旧版 Chat Completions 接口（/chat/completions）。两者不是同一套协议，直接对接会报 404 或 400 错误，根本跑不起来。
这就是 CC Switch 要解决的问题。它是一款免费开源的跨平台桌面工具，核心功能是在本机启动一个代理服务，把 Codex 发出的 Responses API 请求"翻译"成第三方供应商能理解的 Chat Completions 格式，再把响应转换回来还给 Codex。整个过程对 Codex 完全透明——它不知道自己实际上在跟 DeepSeek 对话。
接入之后的效果值得一提：不需要登录 OpenAI 账号，不用担心手机号验证，而且 Codex 原有的 Plugins、Skills、自动化流程等功能全部保留，没有任何阉割。
工作原理：透明代理与协议转换
理解 CC Switch 的工作方式，有助于后面配置时少走弯路。
CC Switch 启动后，会在本机绑定一个代理地址（默认是 127.0.0.1:15721）。Codex 的请求先打到这个地址，CC Switch 再根据你的配置决定转发到哪个供应商。整个转发链路完全在本地完成，不经过任何第三方服务器。
关键在于协议转换这一层。Codex 使用的是 OpenAI 的 Responses API，这是一套较新的接口规范，国内大多数供应商还没有跟进支持。DeepSeek、Kimi、MiniMax 目前提供的仍是旧版的 Chat Completions 接口，两者的请求结构和响应格式都不一样。如果直接把 Codex 的请求转发过去，供应商那边根本不认识，自然报错。
CC Switch 的本地路由功能就是干这个的：识别 Codex 发出的 Responses API 请求，将其改写成 Chat Completions 格式，发送给第三方供应商；收到响应后再反向转换，伪装成 Responses API 的格式返回给 Codex。
这也解释了为什么配置时会看到"需要路由"的提示——这不是可选项，而是让第三方模型正常工作的必要条件。跳过这一步，请求就会报错，Codex 表现出来就是不断重连或直接 404。
用一张图来理解整个链路：
Codex → CC Switch（本地代理 + 协议转换）→ DeepSeek API
↑ ↓
Responses API 格式 Chat Completions 格式对 Codex 来说，它一直以为自己在和 OpenAI 官方接口通信。实际上，请求已经悄悄绕了一圈。
开始之前：环境准备与工具清单
正式配置之前，有几件事需要提前确认好。
需要准备的三件套：
工具 | 获取地址 | 备注 |
|---|---|---|
Codex 客户端 | openai.com 官网下载 | 选对应操作系统版本 |
CC Switch | github.com/farion1231/cc-switch Releases 页 | 建议下载最新版，注意防盗版 |
DeepSeek API Key | platform.deepseek.com | 注册后在控制台创建 |
CC Switch 支持 Windows 10+、macOS 12+ 以及主流 Linux 发行版（提供 deb、rpm、AppImage 三种格式）。macOS 用户也可以通过 Homebrew 安装：
brew install --cask cc-switch有几个细节要注意：
- Codex 首次启动必须联网。它启动时需要访问 OpenAI 的服务做初始化，如果网络不通，会长时间卡在启动界面，和 CC Switch 无关。
- DeepSeek 账户需要提前充值。余额不足时请求会直接报错，容易误以为是配置问题，其实是钱的问题。
- API Key 从官方平台获取。platform.deepseek.com 是官方入口，注册后在控制台里创建一个 Key，复制备用。
部分教程还提到需要准备一个配置用的 .json 文件，用于解决某些环境下 Codex 启动时出现红色报错的兼容问题。如果你在配置过程中遇到这类情况，后面的步骤里会具体说明。
手把手配置：CC Switch 接入 DeepSeek 全流程
整套流程分五个步骤，按顺序来，不要跳。
第一步：安装并更新 CC Switch
从官方 GitHub（github.com/farion1231/cc-switch）的 Releases 页面下载最新版安装包，建议使用 v3.16.0 或更高版本。安装过程和普通桌面软件没什么区别。
如果你之前已经装了旧版 CC Switch，打开软件后进入「设置 → 关于 → 检查更新」，升级到最新版本再往下操作。旧版本在路由配置界面和预设模型上都有差异，容易踩坑。
第二步：添加 DeepSeek 供应商
打开 CC Switch，顶部切换到 Codex / OpenAI 标签页。
点击右上角的「+」按钮，进入供应商添加界面。在预设列表中找到 DeepSeek，CC Switch 内置了两个预设版本：
- DeepSeek V4 flash
- DeepSeek V4 pro
选好之后，API 地址已经自动填好，不需要改。你只需要填入一项内容：从 platform.deepseek.com 复制来的 API Key。
填好后点击「添加」。CC Switch 会自动处理模型映射，不需要手动指定模型名称。
第三步：开启本地路由（这一步不能跳）
进入「设置 → 路由 → 本地路由」，依次开启以下开关：
- 路由总开关
- 主页面显示本地路由开关
- Codex 路由项（单独勾选，确保 Codex 的请求走路由转换）
保存后回到 CC Switch 首页，确认路由状态显示为「运行中」。如果这里没有显示运行中，后面 Codex 的请求就没法正确转换，会一直报错。
这是整个配置里最容易漏掉的一步。很多人配置完发现还是 404，回头一查就是路由没开。
第四步：启用供应商并重启 Codex
回到 CC Switch 首页，找到刚才添加的 DeepSeek 供应商，点击「启用」。
然后完全退出 Codex——不是最小化，是真正退出进程——再重新打开。配置变更必须重启才能生效，这一点没有快捷方式。
如果重启后 Codex 出现红色报错提示，说明遇到了兼容性问题。解决方法是：把对应的 .json 配置文件复制到你系统上的 .codex 目录，然后再重启一次 Codex。具体的 .json 文件内容可以在相关教程或 CC Switch 的文档里找到。
第五步：验证接入是否成功
Codex 重启后，如果一切正常，你会注意到：
- 原本需要登录的界面消失了，或者登录状态自动通过
- 右下角或左上角的模型名称显示为 DeepSeek（比如 DeepSeek V4）
在对话框里输入「你好」，能正常收到回复，说明接入成功。
整个配置流程到这里就完成了，用时通常在 5 分钟以内。
接入之后：模型选择与 Codex 完整功能体验
DeepSeek V4 两个版本怎么选
CC Switch 预置了 DeepSeek V4 的两个版本，实际使用时按需切换就好：
版本 | 特点 | 适合场景 |
|---|---|---|
flash | 响应速度快，token 成本低 | 日常代码补全、简单问答、频繁调用 |
pro | 能力更强，支持推理内容输出 | 复杂架构设计、多步推理、代码重构 |
切换方式很简单：在 CC Switch 的供应商编辑界面修改即可，改完立即生效，不需要重启 Codex。日常用 flash 跑起来，遇到复杂任务临时换 pro，两边成本和速度都能顾到。
DeepSeek 的定价相较于 OpenAI 官方模型有明显优势，flash 版本尤其适合高频调用的编程场景，长期用下来的成本差距会比较显著。
Codex 功能没有被阉割
通过 CC Switch 接入第三方模型，Codex 的原生功能完整保留，这一点值得单独说。
有些接入方案会对 Codex 做定制或裁剪，功能上打折扣。CC Switch 走的是透明代理路线，它只负责在请求层面做协议转换，Codex 应用本身没有任何修改。所以你能用到：
- Plugins（插件）：左上角的插件入口正常可用
- Skills（技能）：自定义技能功能不受影响
- 自动化流程：Codex 的自动化任务同样可以驱动
实际测试中，接入 DeepSeek 后调用 HyperFrames 插件制作视频，整个流程跑下来没有问题。第三方模型可以正常驱动 Codex 的插件生态，并不局限于代码相关任务。
换句话说，Codex 能干的事，换了 DeepSeek 之后基本都还能干，不是只剩个代码补全壳子。
遇到问题？常见报错与解决方法
配置过程中遇到问题，先对照下面这几类情况排查，大多数情况都能找到对应解法。
Q：Codex 报 404 错误，或不断重连
原因几乎都是协议不兼容——本地路由没有开启。打开 CC Switch，检查两件事：路由总开关是否开启，Codex 路由项是否单独勾选。两个都确认后重启 Codex。
Q：Codex 卡在启动界面，长时间无法进入
这是网络问题，不是 CC Switch 的问题。Codex 首次启动需要能访问 OpenAI 的服务器做初始化，网络不通就会卡住。切换网络环境（比如开启代理），完全退出后重试。
Q：DeepSeek 已经启用，但 Codex 里显示的还是旧模型
按顺序检查：① CC Switch 首页路由开关是否显示「运行中」；② Codex 路由项是否已勾选；③ 完全退出 Codex 再重启；④ 在 CC Switch 中重新点击一次「启用」。
Q：请求报错或没有响应
有两个常见原因：API Key 填错了，或者 DeepSeek 账户余额不足。在 CC Switch 的供应商详情里确认 Key 是否有效，同时登录 platform.deepseek.com 查看账户余额。
Q：想切回官方 OpenAI
在 CC Switch 中关闭本地路由，或者直接切换回官方 OpenAI 供应商。Codex 会自动恢复使用原始配置，整个切换过程可逆，随时能换回来。
关于安全性
CC Switch 是纯本地应用，所有配置（包括 API Key）只存储在你自己的机器上，不会上传到任何服务器。代理服务绑定在 127.0.0.1，只监听本地流量，外部无法访问。
结语：一个工具，打开更多可能
CC Switch 做的事情说起来并不复杂：在本地启一个协议转换层，让 Codex 能和不同的大模型后端对话。但这个"不复杂"的事情，解决了一个很实际的问题——让开发者可以用更低的成本、更少的障碍，跑起来一个功能完整的 AI 编程助手。
整套配置的核心只有三步：安装工具、填入 API Key、开启路由。熟悉之后 5 分钟内可以完成。
DeepSeek 只是其中一个选项。同样的方法可以复用在 Kimi、MiniMax、通义千问（Qwen）、SiliconFlow 等其他供应商上——只要在 CC Switch 里换一个供应商预设，填上对应的 Key，其他配置基本不变。
CC Switch 也在持续更新。早期版本需要 CC Switch 和 CC Chart 两个工具配合使用，现在已经简化成单一工具方案，操作流程比之前清晰了不少。后续随着国内模型对 Responses API 的支持逐渐跟进，配置可能还会进一步简化。
如果你之前因为各种门槛一直没用上 Codex，可以从这里重新试一试。
