保姆级 Codex 安装配置 + 接入 DeepSeek 等国产模型教程

这篇文章教你从零安装 Codex，并通过 cc-switch 把 Codex 接入 DeepSeek、Kimi、GLM、MiniMax、豆包等国产模型。重点是：不用自己搭本地路由项目，不用手动改一堆配置文件，用 cc-switch 图形界面就能完成。

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

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

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

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

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

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

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

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

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

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

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

所以之前我更推荐新手先用 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 帮你把桥搭好了。

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

Codex 是 OpenAI 推出的 AI Agent 工具。什么是 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。

Codex 官方地址：

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

Codex 网页端 入口：

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

Codex GitHub：

https://github.com/openai/codex

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

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

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

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

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

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

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

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

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

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

cc-switch 官网：

https://ccswitch.io/zh

GitHub 下载页：

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

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

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

零基础小白也能学会的 Claude Code + cc-switch 保姆级安装配置教程

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

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

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

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

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

零基础小白也能学会的 Claude Code + cc-switch 保姆级安装配置教程

DeepSeek 开放平台地址：

https://platform.deepseek.com

打开后按下面步骤操作：

API Key 类似这样：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

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

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

打开 cc-switch。

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

点击添加供应商。

选择内置的 DeepSeek 预设。

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

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

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

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

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

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

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

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

默认地址一般类似：

127.0.0.1:15721

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

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

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

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

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

切换到DeepSeek-v4-pro模型

然后输入一个简单问题：

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

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

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

DeepSeek 后台地址：

https://platform.deepseek.com

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

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

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

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

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

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

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

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

可以。

Cc-switch 3.16.0 以后，Codex 这条路线已经支持很多 Chat Completions 兼容供应商。

目前官方发布说明里提到的包括：

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

但我建议你第一遍先用 DeepSeek 跑通。

因为 DeepSeek 的注册、充值、API Key 创建都比较简单，前面的教程也已经写过。

跑通后，再研究其他模型。

因为 Codex 和 DeepSeek 这类平台之间，关键差异在 API 格式。

Codex 新版本主要面向 OpenAI Responses API。

很多国产模型平台提供的是 OpenAI Chat Completions 兼容接口。

cc-switch 3.16.0 以后，新增了这层格式转换和本地路由能力。

大家可以自行去百度搜一下，关键字是“OPENAI+接码+短信”。

选购时按均价5毛钱左右去购买即可，太贵了不推荐。我用的基本都是几分钱的平台。

选巴西，泰国，尼日利亚等区域，因为特殊原因，我这里就不展开了。

要。DeepSeek API 是按量计费，不是包月聊天会员。

好处是日常使用成本通常很低，用多少算多少。

普通文章修改、简单代码分析、资料整理，一次请求一般不会太贵。但如果你让 Codex 读取大量文件、连续执行很多轮、生成很长内容，费用就会增加。价格以 DeepSeek 官网最新价格为准。

DeepSeek 价格页：

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

按这个顺序排查：

不要一上来乱改配置。

先从这几个最常见问题查。

想用图形界面管理多个 AI 工具和模型渠道，且日常生活中会涉及到高级功能需求的人。

如果你只想最简单地用一个国内 AI Agent 进行简单的任务，或者聊天，OpenCode + DeepSeek 可能更直接。

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

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

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

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

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

谢谢你看我的文章

晴时有记，阴时不更

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