本文讲解如何从零安装 Codex，并通过 cc-switch 将 Codex 接入 DeepSeek。配置完成后，可以在 Codex 的 Agent 工作流中使用 DeepSeek，也可以按同样思路切换到 Kimi、GLM、MiniMax、豆包、SiliconFlow 等兼容模型。

适用对象

这篇教程适合以下用户：

1. 想使用 Codex App，但希望底层模型走 DeepSeek 等国内 API。
2. 不想手动搭建本地 API 路由服务。
3. 希望通过图形界面完成模型供应商、路由和模型列表配置。
4. 已经有基础的 ChatGPT 账号，或愿意先注册一个普通账号用于打开 Codex。

本文以 DeepSeek 为例。先跑通一条稳定链路，再扩展到其他模型，排错成本会低很多。

最终效果

配置完成后，请求链路大致是：

Codex App
  -> cc-switch 本地路由
  -> DeepSeek API
  -> cc-switch 转换响应
  -> Codex App 显示结果

也就是说，Codex 仍然负责 Agent 工作流、任务执行和项目上下文管理；DeepSeek 负责底层模型推理。

为什么需要 cc-switch

Codex 和很多国产模型平台之间的关键差异在 API 格式。

Codex 新版本主要面向 OpenAI Responses API，而 DeepSeek、Kimi、GLM 等平台通常提供 OpenAI Chat Completions 兼容接口。两者并不是完全相同的接口格式。

如果没有中间层，常见做法是自己在本地部署一个路由项目，让 Codex 先请求本地服务，再由本地服务转发给 DeepSeek。这种方式可以用，但对普通用户并不友好：

1. 需要额外安装路由项目。
2. 需要配置本地端口。
3. 需要处理启动命令。
4. 电脑重启后可能还要重新启动服务。
5. 出错后不容易判断问题发生在哪一层。

cc-switch 从 3.16.0 开始增加了 Codex 相关的 Chat Completions 路由能力，可以在图形界面里完成这层转换。

发布页：

https://github.com/farion1231/cc-switch/releases/tag/v3.16.0

准备清单

开始前，建议先准备好这些内容：

1. 一台 Windows 或 macOS 电脑。
2. Codex App。
3. 一个可以登录 Codex 的 ChatGPT 账号。
4. cc-switch 3.16.0 或更高版本。
5. DeepSeek 开放平台账号。
6. DeepSeek API Key。
7. 可选：SiliconFlow 账号，用于免费体验多个兼容模型。

第 1 步：安装 Codex

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 官网后，根据自己的系统下载安装包。安装方式和普通桌面软件一样，安装完成后直接打开即可。

如果 GitHub 或官网下载打不开，也可以使用备用网盘下载本文配套安装包：

https://pan.qualk.cn/s/7b1c338f86a0

网盘里已整理好 Codex 和 cc-switch 的 macOS、Windows 安装包，适合网络不稳定或无法访问 GitHub 的用户。

第 2 步：准备 ChatGPT 账号

首次打开 Codex 时，一般会要求登录 ChatGPT 账号。普通免费账号即可用于进入 Codex 主界面。

如果页面要求手机号验证，可以先完成验证，再继续后面的 cc-switch 配置。本文的目标是先让 Codex 能正常打开，后续模型请求会通过 cc-switch 的本地路由转发到 DeepSeek API。

第 3 步：安装或升级 cc-switch

这一步非常关键。请使用 cc-switch 3.16.0 或更高版本。

低版本可能找不到 Codex 路由配置，也可能无法正常把 DeepSeek 供应商接入 Codex。

cc-switch 官网：

https://ccswitch.io/zh

GitHub Releases：

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

如果还没有安装 cc-switch，可以从官网或 GitHub Releases 下载对应系统的安装包。如果已经安装，请先打开 cc-switch，在设置或关于页面检查版本号。

如果 GitHub 下载失败，也可以从本文配套网盘获取 cc-switch 安装包：

https://pan.qualk.cn/s/7b1c338f86a0

第 4 步：创建 DeepSeek API Key

如果已经有 DeepSeek API Key，可以跳过本步骤。

DeepSeek 开放平台：

https://platform.deepseek.com

操作步骤：

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

API Key 类似这样：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

注意：API Key 相当于账户调用凭证，只应保存在自己的电脑上，不要发给别人，也不要发布到文章、截图、代码仓库或公开文档里。

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

可选方案：用 SiliconFlow 免费体验模型

如果暂时不想给 DeepSeek 充值，也可以先用 SiliconFlow 免费体验。

SiliconFlow 新用户可以获得价值 16 元的 token，可用于调用 DeepSeek、Kimi、GLM、MiniMax、千问等最新大模型。适合先测试 Codex + cc-switch 的整体流程，确认自己确实需要这套工作流后，再决定是否长期使用某个模型平台。

注册链接：

https://cloud.siliconflow.cn/i/CaXCS6ET

也可以直接扫码注册：

注意：免费额度、可用模型和活动规则可能会变化，实际情况以 SiliconFlow 页面显示为准。

第 5 步：在 cc-switch 添加 DeepSeek 供应商

打开 cc-switch，在顶部或侧边找到 Codex 入口。

然后按下面步骤配置：

1. 点击添加供应商。
2. 选择内置的 DeepSeek 预设。
3. 进入配置页面。
4. 填入 DeepSeek API Key。

建议优先使用 cc-switch 内置的 DeepSeek 预设，不要手动拼接接口地址。内置预设通常已经处理好这些配置：

1. Base URL
2. 模型名称
3. 上下文长度
4. 推理参数
5. Codex 路由参数

配置页面中建议勾选：

• 启用 Goal mode
• 启用远程压缩

然后点击获取模型列表。如果页面提示获取成功，说明 API Key 和 DeepSeek 连接基本正常。

第 6 步：开启 cc-switch 本地路由

进入 cc-switch 的设置页面，找到 通用 或 本地路由 相关配置。

需要确认两件事：

1. 本地路由服务已启动。
2. 首页显示本地路由开关的选项已开启。

默认本地路由地址一般类似：

127.0.0.1:15721

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

随后回到 cc-switch 首页，切换到 Codex 菜单，打开左上角的路由按钮，并切换到刚才配置好的 DeepSeek 供应商。

完成这一步后，需要彻底退出并重新打开 Codex：

1. macOS：在 Dock 栏右键退出 Codex。
2. Windows：在右下角托盘找到 Codex 图标，右键退出。
3. 重新启动 Codex。

第 7 步：验证配置是否成功

重新打开 Codex，进入一个测试目录。建议使用空文件夹或不重要的测试项目。

在模型选择处切换到 DeepSeek 相关模型，例如 DeepSeek V4 Pro 或页面中显示的其他 DeepSeek 模型。

输入一个简单测试问题：

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

如果 Codex 能正常返回回答，说明基础链路已经跑通。

更稳妥的验证方式是打开 DeepSeek 后台查看 API 用量：

https://platform.deepseek.com

如果刚刚测试后用量发生变化，说明请求确实经过 DeepSeek API。

第 8 步：理解 Codex 的使用场景

Codex 不是普通聊天窗口。它更适合进入项目目录，围绕真实文件执行任务。

Codex 可以处理的典型工作包括：

1. 阅读项目结构。
2. 分析代码逻辑。
3. 修改指定文件。
4. 生成或补充文档。
5. 执行测试命令。
6. 解释改动内容。
7. 协助排查错误。

Codex 也提供自动化能力，可用于监控、汇总、定期任务和项目状态检查等场景。

第一次使用时，不建议直接让 Codex 大规模修改重要项目。更稳妥的流程是：

1. 先让它阅读项目并说明理解。
2. 再让它提出修改计划。
3. 确认计划后再执行修改。
4. 修改后要求它说明改动文件和改动原因。
5. 最后让它运行验证命令或给出人工检查清单。

涉及重要文件、合同、公司资料、客户数据、密钥或账单信息时，不要直接交给 AI Agent 处理。

常见问题

Q1：能不能使用其他模型？

可以。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 创建都比较直接，适合作为第一遍配置示例。

如果想一次测试多个模型，也可以优先使用 SiliconFlow。SiliconFlow 的模型广场里可以直接体验 DeepSeek、Kimi、GLM、MiniMax、千问等模型，新用户还有价值 16 元的 token，适合先免费测试哪类模型更适合自己的工作流。

SiliconFlow 注册链接：

https://cloud.siliconflow.cn/i/CaXCS6ET

Q2：为什么必须使用 cc-switch 3.16.0 以上？

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

Codex 新版本主要面向 OpenAI Responses API，很多国产模型平台提供的是 OpenAI Chat Completions 兼容接口。cc-switch 3.16.0 以后新增了这层格式转换和本地路由能力。

Q3：提示需要验证手机号怎么办？

如果 ChatGPT 账号注册或登录时提示手机号验证，需要先完成账号验证。验证完成后，再回到 Codex 和 cc-switch 配置流程。

Q4：DeepSeek API 要花钱吗？

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

日常使用成本通常较低，用多少算多少。普通文章修改、简单代码分析、资料整理，一次请求一般不会太贵。但如果让 Codex 读取大量文件、连续执行很多轮、生成很长内容，费用会增加。

如果担心一开始就充值，可以先用 SiliconFlow 的新人 token 测试。确认 Codex + cc-switch 的流程适合自己之后，再决定是否长期使用 DeepSeek 官方 API 或其他模型平台。

SiliconFlow 注册链接：

https://cloud.siliconflow.cn/i/CaXCS6ET

DeepSeek 价格页：

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

实际价格以 DeepSeek 官方页面为准。

Q5：配置后不能用，应该先检查什么？

按这个顺序排查：

1. cc-switch 是否为 3.16.0 或更高版本。
2. DeepSeek API Key 是否复制完整。
3. API Key 前后是否有多余空格。
4. DeepSeek 账户是否有余额。
5. cc-switch 本地路由是否已启动。
6. cc-switch 首页的 Codex 路由开关是否已开启。
7. DeepSeek 供应商是否已启用。
8. Codex 是否已经彻底退出并重新启动。
9. Codex 模型列表中是否能看到 DeepSeek 相关模型。

不要一上来乱改配置。先按链路逐层排查，定位问题会更快。

Q6：这套方案适合谁？

这套方案适合希望用图形界面管理多个 AI 工具和模型渠道，并且需要 Agent 工作流的人。

如果只是想找一个简单的国内 AI 工具聊天或处理轻量任务，可能不需要 Codex + cc-switch 这套配置。

总结

这套配置的核心目标只有一个：让 Codex 通过 cc-switch 接入 DeepSeek。

关键点有三个：

1. Codex 负责 Agent 工作流。
2. cc-switch 负责本地路由和接口格式转换。
3. DeepSeek 负责底层模型推理。

只要 Codex -> cc-switch -> DeepSeek 这条链路跑通，后面切换其他兼容供应商就会容易很多。