【保姆级教程】Codex 是什么？从下载安装到用 CC Switch 一键切换到 DeepSeek（Windows / macOS）

适合人群：想用 OpenAI Codex 做 AI 编程，但没有 ChatGPT 账号、注册受海外手机号限制，或嫌官方 API 太贵的开发者。
本文能帮你：安装官方 Codex 桌面客户端 → 通过开源工具 CC Switch 把底层模型一键切换为 DeepSeek（V4 系列）→ 价格低、国内可直连，不需要 ChatGPT 订阅也能体验 Agent 编程。
阅读时间：约 10 分钟，全程可照抄。

---

目录

1. 先看效果：这套方案能干什么
2. Codex 到底是什么？（新手必读）
3. 方案原理：一张图看懂三层链路
4. 准备工作：先备好这几样
5. Step 1：申请 DeepSeek API Key
6. Step 2：安装 Codex 桌面客户端
7. Step 3：安装 CC Switch
8. Step 4：在 CC Switch 中配置 DeepSeek 并切换
9. Step 5：打开 Codex 验证是否生效
10. 进阶：它到底改了 Codex 的什么文件？
11. 常见问题 FAQ（避坑合集）
12. 安全提醒与总结
13. 参考资料

---

一、先看效果：这套方案能干什么

很多同学在抖音 / B 站刷到"下载 Codex + CC Switch 切换到 DeepSeek"的视频，核心效果其实就三点：

1. 装上了 OpenAI 官方的 Codex 桌面客户端，界面、交互、Agent 能力都是原版；
2. 底层模型换成了 DeepSeek（deepseek-v4 系列），编程能力在线，价格只有 OpenAI 官方 API 的零头，按量计费、国内直连；
3. 没有 ChatGPT 账号也能用上 Codex：通过 CC Switch 配置第三方 API 后，Codex 使用你填写的 DeepSeek API Key 鉴权即可对话（原理见第三节），不再依赖官方账号。

说明：Codex 桌面客户端与 CLI 均从 OpenAI 官方渠道下载，本教程演示基于官方客户端 + CC Switch 第三方模型通道。

---

二、Codex 到底是什么？（新手必读）

2.1 一句话介绍

Codex 是 OpenAI 官方出品的 AI 编程智能体（Agentic Coding Agent），不是普通的"代码补全/聊天工具"。它能像一个会写代码的实习生那样，端到端地替你干活：

• 读取并理解你的整个代码仓库；
• 直接读写本地文件、新建/修改/删除项目文件；
• 执行终端命令：跑测试、装依赖、启动服务、git 提交；
• 完成"功能开发、复杂重构、代码迁移、修 Bug、写单元测试"等完整任务；
• 结合插件还能操作浏览器、操作电脑、做表格、做 PPT、定时跑任务等。

2.2 官方怎么定位它

OpenAI 官方产品页（openai.com/codex）的描述可以概括为：

• “The best way to build with agents”——用 Agent 构建软件的最佳方式；
• Codex in ChatGPT 是 agentic coding 的"指挥中心"：内置 worktree（工作树）与云端环境，支持多智能体并行，把"几周的活"压缩到"几天"；
• 支持 Skills（技能）：把团队规范、工作流教给 Codex，让它按统一标准干活；
• 支持定时后台任务：如自动处理 issue、监控告警、跑 CI/CD；
• 形态覆盖：ChatGPT 内的 Codex / 桌面 App / IDE 插件 / 命令行 CLI（codex）/ 云端。

2.3 三种常用形态

形态	适合谁	说明
Codex 桌面 App	新手、非纯程序员	图形界面，能操作本地文件夹，本文主角
Codex CLI（终端）	程序员	在项目目录跑 codex 即可对话干活，配置最灵活
Codex IDE 插件	程序员	在 VS Code / Cursor 等编辑器里使用

2.4 为什么大家都想"换成 DeepSeek"？

痛点	说明
① 账号门槛	官方登录需要 ChatGPT 账号，注册常受海外手机号/支付方式限制
② 额度限制	免费额度少，官方按订阅档位（Free / Plus / Pro）给限额，重度使用不够花
③ 价格高	官方 API 按 token 计费，跑 Agent 任务（频繁多轮调用）烧钱快
④ 网络问题	部分网络环境下访问不稳定

而 DeepSeek 编程能力强、价格低、国内手机号可注册、API 国内直连，因此成了"Codex 换芯"的首选。注意：Codex 是"壳"，模型是"芯"。CC Switch 只是把"芯"从 OpenAI 换成 DeepSeek，Codex 的界面和 Agent 能力原样保留。

---

三、方案原理：一张图看懂三层链路

① Codex 桌面客户端（发起 Responses API 请求）
        │
        ▼
② CC Switch 本地网关（默认 127.0.0.1:15721）
   · 供应商管理 / API Key 托管 / 模型映射
   · 协议转换：Responses ⇄ Chat Completions（本地路由）
        │
        ▼
③ DeepSeek API（https://api.deepseek.com）

为什么要中转一层？

• 新版 Codex 默认使用 OpenAI 的 Responses API 协议；
• DeepSeek 等大多数第三方只提供 Chat Completions（/chat/completions） 协议；
• 直接把 Chat 接口填进 Codex 配置，常见结果就是：模型列表不对、请求 404/400、流式响应解析失败；
• CC Switch 的本地路由负责把 Codex 的 Responses 请求"翻译"成 Chat Completions 发给 DeepSeek，再把响应"翻译"回 Responses 返回给 Codex——所以 Codex 全程无感。

为什么不需要 ChatGPT 账号也能用？

Codex 的配置核心是 ~/.codex/ 下的两个文件：config.toml（模型、供应商、地址）和 auth.json（登录态）。通过 CC Switch 切换到第三方供应商后，Codex 使用你在配置中填写的 DeepSeek API Key 完成鉴权，无需 ChatGPT 官方登录态也能发起对话（不同 CC Switch 版本表现略有差异，详见 FAQ）。

---

四、准备工作：先备好这几样

1. 系统：Windows 10/11 或 macOS（Linux 桌面版原理一致）；
2. DeepSeek 开放平台账号 + API Key（国内手机号即可注册，充少量钱按量扣费）；
3. 网络：能正常访问 DeepSeek API 即可（国内网络直连可用）；
4. 两个软件：Codex 桌面版 + CC Switch。

⚠️ 安全第一：只从官方渠道下载！

• Codex 官方页面：https://openai.com/codex/ 或 https://chatgpt.com/codex/（Windows 也可在微软商店搜索 OpenAI Codex）
• CC Switch 官方仓库：https://github.com/farion1231/cc-switch （点 Releases 下载）；官方文档站：https://ccswitch.io
• 不要从"xxxdown.cc"、网盘分享、QQ 群文件等非官方渠道下载安装包，谨防捆绑恶意软件、账号信息泄露等风险。

---

五、Step 1：申请 DeepSeek API Key

1. 打开 https://platform.deepseek.com，用国内手机号注册并登录；
2. 进入左侧 API Keys（API 密钥） 页面 → 点击 创建 API Key；
3. 复制生成的 sk-... 密钥并立即保存好（一般只完整显示一次，丢失只能删了重建）；
4. 在"充值"页面充少量金额（如 ¥10~¥50）用于测试，DeepSeek 按 token 计费，个人开发非常经用；
5. 建议单独建一个 Key 给 Codex / CC Switch 专用，方便日后单独撤销、控制额度。

📌 DeepSeek 接口要点（以官方文档为准）：

• OpenAI 兼容地址：https://api.deepseek.com
• 常用模型名：deepseek-v4-pro、deepseek-v4-flash（旧名 deepseek-chat / deepseek-reasoner 已计划停用）
• 本教程视频演示中填的是 deepseek-v4-pro；想省心也可以直接用预设默认的 deepseek-v4-flash。

说明：图中 Key 已由平台自动打码；完整 Key 仅在创建时显示一次，请妥善保存。

---

六、Step 2：安装 Codex 桌面客户端

1. 打开 Codex 官方页面 → 点击 Download / Get started；
2. 下载对应系统安装包：Windows 为 .exe，macOS 为 .dmg；
3. 双击运行，按提示完成安装（Windows 建议安装路径不要含中文/空格，避免个别组件读取异常）；
4. 第一次启动会进入登录界面——先别急着登录，走第三方 API 方案时也可以不登录直接使用（想保留官方能力可选登录，见 8.4）；
5. 可选验证：打开终端（PowerShell / 终端.app）执行：

codex --version

能输出版本号即安装成功（若提示"不是内部或外部命令"，重开一个终端再试）。

安装完成后先完全退出 Codex（右下角托盘/菜单栏退出，不只是关窗口），我们配置完再打开。

---

七、Step 3：安装 CC Switch

1. 打开 https://github.com/farion1231/cc-switch → 右侧 Releases → 下载最新版；
2. Windows 下载 .exe / .msi（或 zip 解压）；macOS 下载 .dmg；
3. 双击安装/运行。若 Windows SmartScreen 弹出提示，选择"更多信息 → 仍要运行"（开源软件，介意可先查看仓库 Star 数与源码再决定）；
4. 首次打开，供应商列表为空属正常现象。

CC Switch 是什么？ 一句话：开源的"AI 编程工具配置管家"，支持 Codex、Claude Code、Gemini CLI、OpenCode 等多个工具的 API 供应商一键切换，不用手改配置文件，还帮你托管密钥、记录用量。

说明：顶部应用栏切换到 Codex（GPT 图标），右上角 + 号用于添加供应商；DeepSeek 卡片带"需要路由"标识。

---

八、Step 4：在 CC Switch 中配置 DeepSeek 并切换

8.1 先选中 Codex 应用

在 CC Switch 顶部应用栏切换到 Codex（图标通常是 GPT/OpenAI 标识）。这一步很重要：表示接下来的供应商配置只对 Codex 生效，不会干扰 Claude Code 等其他工具。

8.2 添加 DeepSeek 供应商

点击右上角 +（添加供应商），有两种方式：

方式 A（推荐）：选官方预设

• 在预设列表里选择 DeepSeek，系统会自动填好请求地址（https://api.deepseek.com）、默认模型、模型映射和协议格式；
• 你只需要把 API Key 粘贴进去 → 保存。

方式 B：自定义手动填写

• 供应商名称：随便填（如 DeepSeek-V4）；
• API 请求地址：https://api.deepseek.com（填文档给出的服务端点即可，不要手动拼 /chat/completions 后缀）；
• 模型名称：deepseek-v4-pro 或 deepseek-v4-flash；
• 展开高级选项，把"上游格式"选为 Chat Completions（需开启路由）——这是视频演示的老路径，也是 deepseek-v4-pro 最稳的选择；若你的版本里 DeepSeek 预设已支持原生 Responses，也可保持 Responses（原生） 直连。

保存后列表会多出一张供应商卡片。若卡片带"需要路由"徽章，说明它是 Chat 格式供应商，必须走 8.3 的本地路由。

说明：预设会自动填好请求地址与模型；Chat 格式供应商保存后卡片会出现"需要路由"徽章。

8.3 打开本地路由（Chat 格式供应商必需）

1. 进入 设置 → 路由 → 本地路由；
2. 打开路由总开关，启动本地代理服务（默认监听 127.0.0.1:15721）；
3. 在"路由启用 / 应用路由"列表中勾选 Codex（即 Codex 接管）；
4. CC Switch 顶部状态栏显示"运行中"，说明本地代理就绪。

原理回顾：这一步之后，CC Switch 会把 Codex 的 live 配置临时指向 http://127.0.0.1:15721/v1，并强制保持 wire_api = "responses"；真实 DeepSeek Key 仍托管在 CC Switch 内，不会明文写进 Codex 配置。

8.4（可选但强烈推荐）保留官方登录态

如果你有 ChatGPT 账号（Free 也可以），建议多做这一步，能让桌面端更稳定：

1. 在 CC Switch 的 Codex 面板先切换到 OpenAI Official 供应商；
2. 打开 Codex，用官方账号登录一次（Free 订阅即可，只用于保留登录身份，不负责第三方计费）；
3. 回到 CC Switch：设置 → 通用 → Codex 应用增强 → 打开"切换第三方时保留官方登录"；
4. 再切回 DeepSeek 供应商。

说明：该开关默认关闭，需要桌面端显示自定义模型或保留官方插件/远程操作时再开启。

这样做有两个好处：

• 桌面端模型选择器能看到 DeepSeek：Codex 桌面 App 的模型下拉框会按当前登录身份"门控"，检测不到官方登录态时会把自定义模型藏起来；保留官方登录后，自定义模型才会出现在选择器里；
• 保留官方插件 / 手机远程操作：官方 Access Token 留在 auth.json，但模型流量仍然走 DeepSeek（官方 Token 不会被发往第三方）。

如果你没有也不想要 ChatGPT 账号，可跳过本步：直接按 8.2/8.3 配好第三方供应商后打开 Codex，多数版本无需登录即可进入主界面。

8.5 切换到 DeepSeek 并重启 Codex

1. 回到 CC Switch 的 Codex 面板，点击刚添加的 DeepSeek 供应商卡片 → 变成"使用中"；
2. 完全退出 Codex（不是关窗口），再重新打开。

为什么要重启？Codex 在启动时才读取 config.toml 和模型目录（model_catalog_json），不重启可能不生效。

---

九、Step 5：打开 Codex 验证是否生效

按照视频里的操作验证一遍：

1. 重新打开 Codex：走第三方 API 通道时，通常可以直接进入主界面开始对话；
2. 在对话框提问：

你现在使用的是哪个模型？请自我介绍一下。

如果它回答自己是 DeepSeek（V4 系列），说明切换成功；

3. 做一次"实操验收"，让它真的干活，例如：

帮我在当前工作区新建一个 demo 文件夹，并写一个用 Python 实现的贪吃蛇小游戏。

首次执行时 Codex 会申请电脑权限（如完全访问/自动审查），允许后它会自动建目录、写文件、运行命令——能看到它在工作区里创建文件、速度很快，就说明整条链路通了；

4. 回到 CC Switch，查看用量统计 / 路由日志，能看到本次请求记录，进一步确认流量确实走的是 DeepSeek，而不是官方 OpenAI；
5. （可选）命令行诊断模型列表：codex debug models。

说明：验证时确认"路由总开关"已打开且"路由启用"里勾选了 Codex；请求日志与用量统计会记录经本地路由转发的真实调用。

---

十、进阶：它到底改了 Codex 的什么文件？

想弄明白原理（或想手动折腾）的同学可以看这节。Codex 的配置集中在：

Windows: C:\Users\你的用户名\.codex\
macOS:   ~/.codex/

两个核心文件：

文件	作用
config.toml	当前模型、供应商、base_url、model_provider、模型目录等运行配置
auth.json	官方登录缓存 / Access Token（敏感文件，不要外传）

以"本地路由接管"为例，CC Switch 会把 config.toml 写成类似这样（示意）：

model = "deepseek-v4-flash"
model_provider = "custom_ccswitch"

[model_providers.custom_ccswitch]
name = "DeepSeek V4"
base_url = "http://127.0.0.1:15721/v1"
env_key = "PROXY_MANAGED"

要点：

• Codex 的请求发往 127.0.0.1:15721（CC Switch 本地路由），由它转发到 DeepSeek；
• auth.json 若保留官方登录则不动；纯第三方模式则使用代理托管鉴权（PROXY_MANAGED），真实 Key 不出现在 Codex 配置里；
• 手动改配置与用 CC Switch 二选一即可。CC Switch 的价值就是图形化、一键切换、密钥托管、免手改文件。

⚠️ 不要把 auth.json、API Key、以及含密钥的 config.toml 截图发到网上或提交进 Git 仓库。

---

十一、常见问题 FAQ（避坑合集）

Q1：Codex 桌面端模型选择器里看不到 DeepSeek？
桌面 App 有官方"登录门控"，检测不到官方登录态会把自定义模型藏起来（CLI 端正常）。解决：按 8.4 保留官方登录态（Free 账号即可），然后完全退出并重启 Codex；可用 codex debug models 确认 CLI 端模型已正确配置。

Q2：切换后还是走官方模型 / 没生效？
确认三点状态一致：① Codex 面板当前供应商是 DeepSeek（使用中）；② 本地路由"路由总开关"已打开；③ "路由启用"里 Codex 已勾选。然后彻底退出并重启 Codex。

Q3：请求报 404 / 400，或流式中断？
多为协议问题：Chat 格式供应商没开本地路由、或"上游格式"选错；也可能是 API Key 无权限 / 余额不足。若用 deepseek-v4-pro 直连报上游错误（官方未开通该模型的直连接口时），请把它走 Chat Completions + 本地路由路径，或改用预设默认的 deepseek-v4-flash。

Q4：提示 15721 端口被占用？
在 CC Switch 代理设置里更换监听端口，并保持 config.toml 里 base_url 端口一致（CC Switch 会自动同步）。

Q5：用了几天，模型选择器又空了？
官方登录态过期了。重新用官方账号登录一次 Codex 即可恢复。

Q6：第三方模型能用官方插件/远程操作吗？
能保留基础能力，但部分官方付费插件依赖官方会员额度，第三方模型无法解锁——这是官方限制，不是配置问题。

Q7：Windows 下打开报错 / 组件丢失？
多因网络问题导致安装不完整，可调整网络环境后重装（视频里也提到这一点）。

Q8：这样用安全/合规吗？
个人学习、开发完全没问题。本文仅用于技术学习与交流，请遵守 OpenAI、CC Switch、DeepSeek 各自的服务条款与当地法律法规。

---

十二、安全提醒与总结

安全提醒（再强调一遍）

1. 只从官方渠道下载：Codex 认准 openai.com/codex（或微软商店），CC Switch 认准 GitHub farion1231/cc-switch；
2. API Key 妥善保管，谁拿到谁就能花你的钱；
3. 不要把 ~/.codex/auth.json 和含密钥的配置文件发到网上；
4. 建议在 CC Switch 中托管密钥，避免把真实 Key 写进 Codex 明文配置。

总结（视频流程复盘）

① 下载安装 Codex 桌面版（官方渠道）
② 申请 DeepSeek API Key 并小额充值
③ 下载安装 CC Switch（GitHub Releases）
④ CC Switch 顶部切到 Codex → 添加 DeepSeek 供应商 → 填 API Key
⑤ 打开本地路由总开关 + 启用 Codex 接管（Chat 格式供应商必需）
⑥（可选）保留官方登录态，让桌面端模型选择器显示自定义模型
⑦ 点击 DeepSeek 卡片切换为"使用中" → 完全退出并重启 Codex
⑧ 提问"你当前是什么模型"验证 → 让它实操建项目/写代码

这套方案的核心价值是：保留 Codex 原版的图形界面和 Agent 能力，把昂贵、门槛高的官方模型后端替换成高性价比、国内可直连的 DeepSeek——“官方体验 + 国产模型”，是目前国内开发者低成本玩转 Agent 编程的主流姿势。

---

十三、参考资料

• Codex 官方产品页（OpenAI）：https://openai.com/codex/
• ChatGPT 中的 Codex（中文产品页）：https://chatgpt.com/zh-Hans-CN/codex/
• OpenAI Codex 开发文档：https://developers.openai.com/codex/
• CC Switch 官方仓库（GitHub）：https://github.com/farion1231/cc-switch
• CC Switch 官方文档/攻略：https://ccswitch.io/zh/tutorials/
• CC Switch《Codex 用 DeepSeek 等 Chat 格式 API：本地路由攻略》：https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-deepseek-routing-guide-zh.md
• DeepSeek 开放平台：https://platform.deepseek.com
• DeepSeek API 文档：https://api-docs.deepseek.com

免责声明：本文为个人学习笔记整理，第三方工具请以各自官方文档为准；配置界面可能随版本迭代略有变化，思路不变即可。