教程 · 2026年6月4日
Codex 接入 DeepSeek 小白入门（Codex Helper）
用 Codex Helper 托盘工具给官方 Codex 接入 DeepSeek：安装 Codex → 安装并启动 Helper → 配置 API Key 测通 → 可选中文汉化即可使用。
- Codex
- DeepSeek
- codex-helper
- AI工具
安装包、工具与相关资源见文末 相关资源下载合集。
一、下载并安装 Codex
官网下载：https://chatgpt.com/zh-Hans-CN/codex
若官网下载较慢，可在 **相关资源下载合集**获取 Codex 安装包。
按安装向导完成安装即可。
二、下载并安装 Codex Helper
官方下载：https://github.com/xqnode/codex-helper/releases
若 GitHub 访问不便，可在 **相关资源下载合集**获取 Codex Helper 安装包。
安装后启动 Codex Helper，默认在系统托盘显示，闪电图标 即为其入口：
1. 打开设置
右键托盘图标，点击 设置：
2. 配置 DeepSeek API Key
在设置页选择 DeepSeek 厂商，填入你的 API Key。请确保 DeepSeek 账户有余额，否则请求会失败。
3. 测试连接并保存
点击 测试连接，看到「DeepSeek 连接成功」后点击 保存：
4. 打开 Codex 开始使用
若 Codex 已在运行，建议 完全退出后重新打开，让 Helper 写入的配置生效。打开 Codex 正常对话即表示接入成功。
三、中文汉化（可选）
需要中文界面时，可安装汉化包：
官方下载：https://github.com/xqnode/codex-zh-CN
若下载不便，可在 **相关资源下载合集**获取。按仓库说明覆盖或安装即可。
常见问题
Q1：接入后 Codex 里模型显示「自定义」，正常吗？
正常。通过 Helper 使用 DeepSeek 等非官方登录时，Codex 界面会显示为自定义模型。若希望显示官方模型名，需切回 OpenAI 官方登录；实际请求的模型与 token 消耗可在 Helper 的 请求日志 中查看。
Q2：为什么插件无法使用？
需要先 官网登录 Codex 后才能正常使用插件。可先登录并下载所需插件，再切换 DeepSeek 等模型；切换后部分插件入口可能不可见，但已安装的插件调用仍可能可用（以实际表现为准）。
Q3：中转站可以使用吗？
可以。Codex Helper 设置里提供 中转站 等厂商选项，只要你有对应中转服务的 Base URL 与 API Key，按页面提示填写并 测试连接 通过后保存即可。
Q4：怎么切回 OpenAI 官方模型？
在托盘菜单中选择 切换回 OPENAI 官方（或类似文案），即可恢复走官方通道。
Q5：Codex 出现 502 错误怎么办？
502 表示 Codex 已连上本机 Codex Helper，但 Helper 没从大模型服务商拿到正常回复（不是 Codex 本身坏了）。
按顺序做 3 步：
- 看任务栏有没有 Codex Helper 图标；没有就启动
codex-helper.exe（或开始菜单里的 Codex Helper）。 - 托盘 → 设置 → 测试连接。失败则检查 API Key、账户余额；成功继续下一步。
- 托盘 → 重新同步配置，然后 完全退出 Codex Desktop 再打开（不要只关窗口）。
仍报 502 再查：
| 可能原因 | 处理 |
|---|---|
| Key 错误或过期 | 设置里重填 Key，保存后再测连接 |
| 网络访问不了模型 API | 换网络；公司网 / 防火墙可能拦截 |
| 用了中转站 | Base URL 须带 /v1，如 http://你的地址:8080/v1 |
| 刚升级过 Helper | 确认代理为 http://127.0.0.1:25543/v1 |
和「连不上」的区别： 502 多半是 Key / 网络 / 中转站问题；若提示 error sending request，多半是 Helper 未启动或端口不对——先启动 Helper，浏览器打开 http://127.0.0.1:25543/health 检查。
一键诊断： PowerShell 执行 codex-helper doctor，按提示逐项修复。
一句话：502 = Helper 连上了，上游 API 没通。先测连接，再重新同步并重启 Codex；仍不行查 Key、网络与 Base URL。