本文核心

1. 安装 Codex
2. 安装或升级 cc-switch 到 3.16.0 以上
3. 获取 DeepSeek API Key
4. 在 cc-switch 里配置 Codex，并添加 DeepSeek 供应商（以 DeepSeek 为例）
5. 常见问题

本文以 DeepSeek 为例，先把 Codex + cc-switch + DeepSeek 跑通。

跑通以后，你可以慢慢切换 Kimi、GLM、MiniMax、豆包、SiliconFlow 等其他模型。

为什么现在才写 Codex

前面我已经写过两篇类似教程：

1. Claude Code + cc-switch + DeepSeek
2. OpenCode + DeepSeek

之前一直没有优先写 Codex，原因很简单：

Codex 此前默认主要使用 OpenAI 官方账号或 OpenAI 兼容 API。

如果你想在 Codex 里用 DeepSeek、Kimi、GLM 这类国产模型，并不是点几下就能解决。

因为 Codex 走的是 OpenAI Responses API，而国内主流模型提供的 API 是 OpenAI Chat Completions 兼容接口。

这两个接口不是一个东西。

你不需要理解里面的技术细节，只要知道：

以前 Codex 和很多国产模型之间，差一层“翻译”。

所以在以前要解决这个问题，通常需要你在本地部署一个路由项目，让 Codex 先请求本地路由，再由路由转发给 DeepSeek。这样确实能用，但对普通用户很不友好：

1. 要装额外项目
2. 要配置端口
3. 要处理启动命令
4. 电脑重启后可能还要重新启动服务
5. 出错后很难判断问题在哪

所以之前我更推荐新手先用 Claude Code 或 OpenCode。

但 cc-switch 最近发布了一个重大更新，从 3.16.0 开始，把这件事做进了图形界面。

具体发布日志：https://github.com/farion1231/cc-switch/releases/tag/v3.16.0

它现在可以把 Codex 的 Responses 请求转换成上游模型常用的 Chat Completions 请求，再把返回结果转回 Codex 能理解的格式。

白话说就是：

以前要你自己搭桥，现在 cc-switch 帮你把桥搭好了。

所以这篇教程就可以写了。

1. Codex 是什么

Codex 是 OpenAI 推出的 AI Agent 工具。什么是 AI Agent 呢？

如果你之前看过我那篇《什么是 AI Agent》，这里就很好理解了。

它与 Claude Code 最显著的区别是：

Claude Code 更像命令行里的 AI 工程师，Codex 更像一个多入口的 AI 工作台。

Claude Code 的主战场是终端。你打开命令行，进入某个目录，输入 claude，然后围绕这个目录让它阅读、修改、执行、验证。它的控制感很强，适合已经习惯命令行、经常处理代码项目的人。

Codex App 的主战场是图形界面，它本质上是一个真正的软件，内部有编辑器、还可以和网页端的ChatGPT 里的 Codex 任务衔接，你还可以在手机上操控电脑上的 Codex App。对普通用户来说，Codex App 这种图形界面更容易理解：打开软件、选择目录、输入任务、看它执行。

这里插一嘴，手机上操控电脑上的 Codex App原先是需要登录真正的OpenAI 账号且只能使用官方套餐的，目前可以通过cc-switch 通过魔修实现：通过手机控制 部署DeepSeek等国产模型的Codex App，这个教程我会放在后面写出来，本文只讲基础部署安装配置

这也是为什么这篇文章要用 cc-switch。我们不是只安装 Codex，而是要通过 cc-switch 把 Codex 接到 DeepSeek 这类国产模型上。这样你用的是 Codex 的 Agent 工作流，底层模型可以切换成国内更方便使用和充值的 API。

2. 安装 Codex

Codex 官方地址：

1
https://openai.com/zh-Hans-CN/codex/

Codex 网页端 入口：

1
https://chatgpt.com/zh-Hans-CN/codex/?app-landing-page=true

Codex GitHub：

1
https://github.com/openai/codex

打开 Codex 官网后，根据你的系统下载安装即可。下载安装后，按普通软件方式打开。

3. 准备 ChatGPT 账号

打开 Codex 后，一般会让你登录 ChatGPT 账号。

这里准备一个普通的免费 ChatGPT 账号即可。

可以直接使用国内163等邮箱注册。

多数情况下，邮箱验证完就能正常使用。

如果魔法不够纯净，页面可能要求你验证手机号，如果需要接验证码可参考文档末尾QA模块的解决方案。

我们的目标是先把 Codex 打开，让它能进入主界面。后面真正调用 DeepSeek 时，模型请求会通过 cc-switch 的本地路由走 DeepSeek API的。

4. 安装或升级 cc-switch

这一步非常关键。必须使用 cc-switch-3.16.0 以上版本。

因为 cc-switch 是从 3.16.0 开始，重点增加了 Codex 的 Chat Completions 路由能力。

如果你用的是旧版本，可能找不到本文截图里的 Codex 路由配置，或者 DeepSeek 供应商无法正常给 Codex 使用。

cc-switch 官网：

1
https://ccswitch.io/zh

GitHub 下载页：

1
https://github.com/farion1231/cc-switch/releases

如果你还没安装 cc-switch，可以回看我主页第一篇文章《Claude Code + cc-switch 保姆级安装配置教程》。

那篇已经把 cc-switch 安装写得很细，这里不重复展开。

如果你已经安装了 cc-switch，先打开它，检查版本号。

如果版本低于 3.16.0，先升级。

注意：cc-switch 是免费开源工具。下载只认这几个官方入口：

1. 官网：ccswitch.io
2. GitHub：github.com/farion1231/cc-switch
3. GitHub Releases 下载页

不要从乱七八糟的网站下载。

5. 准备 DeepSeek API Key

如果你已经看过我前面的教程，并且已经申请过 DeepSeek API Key，这一步可以跳过。

DeepSeek 开放平台地址：

1
https://platform.DeepSeek.com

打开后按下面步骤操作：

1. 注册并登录 DeepSeek 开放平台
2. 进入 API Keys
3. 点击创建 API Key
4. 复制并保存好这串 sk- 开头的 Key

API Key 类似这样：

1
sk-xxxxxxxxxxxxxxxxxxxxxxxx

注意：API Key 只在自己的电脑上用且不要暴露给任何人

后面 cc-switch 调用 DeepSeek，本质上就是用这个 Key 去请求 DeepSeek API。

6. 在 cc-switch 里配置 Codex + DeepSeek

打开 cc-switch。

在顶部或侧边找到 Codex 入口。

点击添加供应商。

选择内置的 DeepSeek 预设。

进入配置页面后，填入你的 DeepSeek API Key。

这里优先使用 cc-switch 内置预设（如果没有的话请再检查一下是否版本不是3.16.0以上），不要自己手动拼接口地址，不然会路由失败。

使用预置配置的这类平台通常会有：Base URL、模型名、上下文长度、推理参数、路由

这些 cc-switch 已经帮你处理好了。建议先不要乱改。保持默认即可。

勾选config.toml (TOML)模块的 启用 Goal mode 和 启用远程压缩

然后点击下方的获取模型列表，测试一下API是否正常，获取完后不要调整，就看页面提示是否获取成功即可，这样就知道你填写的API是否正确了。

7. 开启 cc-switch 本地路由

接下来进入 cc-switch 的设置-通用页面。

找到本地路由，点击展开，开启在主页面显示本地路由开关选项，其余不变。

默认地址一般类似：

1
127.0.0.1:15721

这个地址不用你手动记。它的作用是Codex 先请求你电脑上的 cc-switch 本地路由，再由 cc-switch 转发给 DeepSeek。

然后我们回到首页，切换到codex菜单，左上角会出现一个路由按钮，我们打开，并切换到刚才配置好的DeepSeek供应商

这一步完成后，需要彻底退出当前 Codex，再重新打开。mac用户在Dock 栏右键退出，Windows用户在右下角菜单栏找到并右键退出。

8. 验证是否配置成功

重新打开 Codex。进入一个测试目录。

可以先新建一个空文件夹，或者打开一个不重要的测试文件夹。

切换到DeepSeek-v4-pro模型

然后输入一个简单问题：

1
你现在使用的是什么模型？

如果界面里能看到 DeepSeek 相关模型，或者回答能正常返回，说明第一步基本跑通。

更稳妥的验证方式，是打开 DeepSeek 后台，看 API 用量有没有变化。

DeepSeek 后台地址：

1
https://platform.DeepSeek.com

如果刚刚提问后，用量页面有变化，说明请求确实走了 DeepSeek。

9. Codex 能拿来做什么

Codex提供了丰富的智能体工作流，内置的工作树与云端环境，智能体能够在多个项目间并行工作。

Codex提供了丰富的官方技能，可以与其他工具实现无缝集成，此处不展开说明。

Codex提供了原生的自动化功能，能在无需提示的情况下自动运行，处理诸如监控问题，搜集日报，总结任务，CI/CD 等关键日常工作，让你能够专注于真正的工作。此处不展开说明。

Codex 的价值不是替代普通聊天窗口，而是让 AI 进入工作目录。

第一次用的时候，不建议直接让它大规模修改重要项目。

1. 先让它阅读
2. 再让它提计划
3. 你确认后再让它修改
4. 修改后让它说明改了什么
5. 最后让它跑验证

AI Agent 很强，但不是不会犯错。

尤其是涉及重要文件、合同、公司资料、客户数据、密钥、账单信息时，不要直接丢给它。

10. 常见问题

1
DeepSeek、智谱 GLM、Kimi、MiniMax、StepFun、百度千帆、百炼、ModelScope、Longcat、百灵、小米 MiMo、火山 Agentplan、BytePlus、豆包 Seed、SiliconFlow、Novita AI、Nvidia 等

1
https://api-docs.DeepSeek.com/zh-cn/quick_start/pricing

11. 总结

这篇文章只解决一个目标：让零基础用户把 Codex 跑起来，并且通过 cc-switch 接入 DeepSeek。

以前这件事对小白不友好，因为中间要自己处理接口转换和本地路由。

现在 cc-switch 3.16.0 把这件事做进了图形界面，所以可以按教程一步一步配置。

以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧。

如果想第一时间收到后续教程，也可以给我一个星标。

谢谢你看我的文章

晴时有记，阴时不更

我是晴天，我们下次再见。

相关链接

• Codex 官方文档：https://developers.openai.com/codex
• Codex App 入口：https://chatgpt.com/codex?app-landing-page=true
• Codex GitHub：https://github.com/openai/codex
• cc-switch 官网：https://ccswitch.io/zh
• cc-switch GitHub Releases：https://github.com/farion1231/cc-switch/releases
• cc-switch v3.16.0 发布说明：https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.16.0-zh.md
• cc-switch Codex + DeepSeek 路由教程：https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-DeepSeek-routing-guide-zh.md
• DeepSeek 开放平台：https://platform.DeepSeek.com
• DeepSeek 模型与价格：https://api-docs.DeepSeek.com/zh-cn/quick_start/pricing