大家好，我是程序员东哥。
OpenAI 开源 Codex CLI 有段时间了，网上铺天盖地的测评——"终端里聊天就能写代码"、"自带沙箱不怕跑崩系统"、"完全免费开源"。
听起来很香对吧？
但你自己上手的时候，大概率会卡在下面三道坎上：
坎一：安装就一头雾水。 Codex 有桌面端、命令行、VS Code 插件三种形态。官网全英文，该下哪个？装完桌面端还要不要装命令行？光搞清楚这些就花了半小时。
坎二：必须登录 OpenAI 账号。 好不容易装上了，一打开就要登录——海外账号你哪有？没有账号，Codex 就是个摆设。
坎三：国产模型用不了。 就算想办法登进去了，想把默认模型换成 DeepSeek，地址一填 —— 404、400、一片空白。
一个工具，三道坎全搞定
CC Switch 把所有问题一次性解决了：
- ✅ 安装不用愁 —— 官网下桌面端，傻瓜式安装；接管后配置文件自动改写，不用手动改
- ✅ 登录不用管 —— 接管后跳过 OpenAI 登录，Codex 直接工作，根本不需要账号
- ✅ 模型随便换 —— DeepSeek、Kimi、MiniMax 预设一键添加，后台自动处理好接口兼容
简单说：Codex 负责写代码，CC Switch 负责让 Codex 能跑起来。
装前准备
先确认三样东西：
① Node.js
打开终端，输入 node --version，有版本号就行。没有的话去 nodejs.org 下载 LTS 版，一路下一步。
② CC Switch ≥ 3.16.0
Codex 路由功能是这个版本才加的，老版本没有。打开 CC Switch 看一眼左下角版本号，不够就去 GitHub Releases 下最新的。
③ DeepSeek API Key
去 platform.deepseek.com 注册，新用户有免费额度。注册完进"API Keys"页面创建一个 Key，复制保存好。
第一步：安装 Codex（推荐桌面端）
桌面端自带 CLI，装完终端里 codex 命令自动就有了，一步到位。
| 系统 | 安装方式 |
|------|----------|
| Windows | openai.com/zh-Hans-CN/codex 下载安装包，或 Microsoft Store 搜 "Codex" |
| macOS | 官网下载 dmg 拖进 Applications，或 brew install --cask codex |
| Linux | 无官方桌面端，用命令行：sudo npm install -g @openai/codex |
装完后打开终端，验证：
CB0
看到版本号就 OK。
⚠️ 关键一步：装完必须启动一次 Codex！
CB1
到这一步你会看到登录界面——别点登录，也别慌。 随便选几个初始选项，等交互界面出来，按 Ctrl+C 退出。
这一步是为了让 Codex 生成配置文件 ~/.codex/config.toml。没有这个文件，CC Switch 接管不了。登录的事后面 CC Switch 会解决。
💡 Linux 用户 npm 下载慢，先换国内镜像：
npm config set registry https://registry.npmmirror.com
第二步：CC Switch 添加 DeepSeek
打开 CC Switch，顶部有 Claude、Gemini、Codex 三个标签，点「Codex」。
① 新建供应商
点右上角加号，在预设列表里直接选 「DeepSeek」。别自己拼 API 地址，预设都帮你写好了。
② 填两个地方
- API Key：粘贴 DeepSeek 后台的 Key
- 点保存
接口地址、模型列表、各种参数，预设已全部填好，看一眼不用改。
③ 确认一个开关
保存前注意看「需要本地路由映射」，预设默认打开。必须保持打开，关了 Codex 跟 DeepSeek 就互不认识了。
第三步：打开本地路由
这是最关键的一步。
CC Switch 左侧菜单 →「设置」→ 展开「本地路由」区域。
按顺序打开两个开关：
开关 ① —— 路由总开关
打开后状态变绿，地址显示 127.0.0.1:15721。绿灯 = 本地路由跑起来了。
开关 ② —— Codex 路由启用
在「路由启用」区域找到 Codex，打开它。其他开关（Claude、Gemini）保持关闭就行。
两个开关都开之后，CC Switch 会自动改写 Codex 配置。你的 DeepSeek Key 安全保存在 CC Switch 里，不会泄露出去。
第四步：启用模型并重启
回到 Codex 标签页，点 DeepSeek 供应商卡片上的「启用」。
⚠️ 启用后必须重启 Codex！ 这一步很多人忘。
把终端里的 Codex 关掉（Ctrl+C），重新 codex 启动。
重启后输入：
CB2
看到 DeepSeek V4 就说明接入成功。
目前 Codex 不支持运行时切换模型，会默认用第一个。想换模型回 CC Switch 调排序就行。
第五步：实战 —— 俄罗斯方块网页版
环境配好了，来写个真正的游戏。
终端里进入工作目录，输入 codex，把下面这段话粘贴进去：
CB3
Codex 会自动分析需求、沙箱写代码、展示完整代码，回复 yes 确认。1-2 分钟搞定。
双击 tetris.html 打开浏览器——黑色背景，彩色方块掉落，←→↑↓ 操作，消行计分。能玩的俄罗斯方块就有了。
再加点功能：
CB4
Codex 自动读代码、找位置、插代码。刷新浏览器就有暂停和最高分记录了。
五分钟前空文件夹，五分钟后一个能玩能计分带最高分记录的俄罗斯方块。
常见问题速查
Q1：装完 codex 命令找不到？
→ 关终端重开，还不行检查 PATH。
Q2：/model 里看不到 DeepSeek？
→ 九成是没重启 Codex。关掉重新 codex 再看。
Q3：Codex 报 404？
→ 两个路由开关没全开。去设置 → 本地路由确认都是绿的。
Q4：发消息没反应？
→ 检查 Codex 标签页当前供应商是不是 DeepSeek、状态是不是"启用"。
Q5：怎么确认真的在用 DeepSeek？
→ 去 CC Switch 的「使用统计」页面看，每次请求和 token 消耗明明白白。
总结
| 步骤 | 做了什么 | 怎么确认 OK |
|------|----------|-------------|
| 准备 | Node.js + CC Switch 3.16+ + DeepSeek Key | 三样到手 |
| 安装 | 官网下载桌面端 | codex --version 有输出 |
| 配置 | Codex 标签 → 加号 → DeepSeek 预设 → 填 Key | 供应商卡片显示 DeepSeek |
| 路由 | 设置 → 本地路由 → 总开关 → Codex 开关 | 两个绿灯 |
| 启用 | 启用供应商 → 重启 → /model | 看到 DeepSeek V4 |
| 实战 | 粘贴需求 → yes → 浏览器打开 | 能玩俄罗斯方块 |
装 Codex → 配 CC Switch → 开路由 → 启用 → 重启 → 开工。
上次做 Claude Code 教程时我说过一句话——工具不会取代你，工具只是在等你会用。
今天再加一句：别让安装、登录、配置这三道坎拦住你。 不是 Codex 难用，是你差一个 CC Switch 没装。
把环境搭好，专心做你真正该做的事——想需求、定方向、验收结果。写代码的活，交给 AI。
装好了评论区扣 1，卡在哪一步直接留言。
我是程序员东哥，下期见。 👋
推荐阅读：