【保姆级教程】Codex 是什么？从下载安装到用 CC Switch 一键切换到 DeepSeek（Windows / macOS）
适合人群：想用 OpenAI Codex 做 AI 编程，但没有 ChatGPT 账号、注册受海外手机号限制，或嫌官方 API 太贵的开发者。 本文能帮你：安装官方 Codex 桌面客户端 → 通过开源工具 CC Switch 把底层模型一键切换为 DeepSeek（V4 系列）→ 价格低、国内可直连，不需要 ChatGPT 订阅也能体验 Agent 编程。 阅读时间：约 10 分钟，全程可照抄。
目录
一、先看效果：这套方案能干什么
很多同学在抖音 / B 站刷到"下载 Codex + CC Switch 切换到 DeepSeek"的视频，核心效果其实就三点：
说明：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）。
四、准备工作：先备好这几样
⚠️ 安全第一：只从官方渠道下载！
- 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
📌 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 桌面客户端
codex –version
能输出版本号即安装成功（若提示"不是内部或外部命令"，重开一个终端再试）。
安装完成后先完全退出 Codex（右下角托盘/菜单栏退出，不只是关窗口），我们配置完再打开。
七、Step 3：安装 CC Switch
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 格式供应商必需）
原理回顾：这一步之后，CC Switch 会把 Codex 的 live 配置临时指向 http://127.0.0.1:15721/v1，并强制保持 wire_api = "responses"；真实 DeepSeek Key 仍托管在 CC Switch 内，不会明文写进 Codex 配置。
8.4（可选但强烈推荐）保留官方登录态
如果你有 ChatGPT 账号（Free 也可以），建议多做这一步，能让桌面端更稳定：
说明：该开关默认关闭，需要桌面端显示自定义模型或保留官方插件/远程操作时再开启。
这样做有两个好处：
- 桌面端模型选择器能看到 DeepSeek：Codex 桌面 App 的模型下拉框会按当前登录身份"门控"，检测不到官方登录态时会把自定义模型藏起来；保留官方登录后，自定义模型才会出现在选择器里；
- 保留官方插件 / 手机远程操作：官方 Access Token 留在 auth.json，但模型流量仍然走 DeepSeek（官方 Token 不会被发往第三方）。
如果你没有也不想要 ChatGPT 账号，可跳过本步：直接按 8.2/8.3 配好第三方供应商后打开 Codex，多数版本无需登录即可进入主界面。
8.5 切换到 DeepSeek 并重启 Codex
为什么要重启？Codex 在启动时才读取 config.toml 和模型目录（model_catalog_json），不重启可能不生效。
九、Step 5：打开 Codex 验证是否生效
按照视频里的操作验证一遍：
你现在使用的是哪个模型？请自我介绍一下。
如果它回答自己是 DeepSeek（V4 系列），说明切换成功；
帮我在当前工作区新建一个 demo 文件夹，并写一个用 Python 实现的贪吃蛇小游戏。
首次执行时 Codex 会申请电脑权限（如完全访问/自动审查），允许后它会自动建目录、写文件、运行命令——能看到它在工作区里创建文件、速度很快，就说明整条链路通了；
说明：验证时确认"路由总开关"已打开且"路由启用"里勾选了 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 各自的服务条款与当地法律法规。
十二、安全提醒与总结
安全提醒（再强调一遍）
总结（视频流程复盘）
① 下载安装 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
免责声明：本文为个人学习笔记整理，第三方工具请以各自官方文档为准；配置界面可能随版本迭代略有变化，思路不变即可。
