这篇带你把 Codex 连接到 DeepSeek，但会先把两条路线分开：OpenAI 官方登录属于官方路线；Codex++ 属于第三方协议转换工具，不是 OpenAI 或 DeepSeek 官方组件。
> 开始前先看：Responses API 和 Chat Completions 的区别。Codex 自定义 provider 当前只支持 Responses API；DeepSeek 的 OpenAI 兼容文档不能仅凭“兼容”二字判断为 Codex 原生兼容。
完成后你会得到：
- 一条与你账号和网络条件匹配的配置路线。
- 一次第三方工具来源与权限检查。
- 一次最小对话和项目只读验证。
- 明确的失败停止条件和回滚方法。
- Windows 电脑和一个低风险练习项目。
- DeepSeek 开放平台账号、可用余额和新建的专用 API Key。
- 能访问 OpenAI 官方 Codex 页面或第三方工具的原始发布页。
- 不要使用生产项目密钥，不要在截图、聊天或 Git 仓库中公开 API Key。
| 你的情况 | 推荐路线 |
| ----------------------------- | ------------------------------ |
| 可以使用 ChatGPT 登录 | 优先使用官方 Codex App 或 CLI，不安装转换工具 |
| 必须调用 DeepSeek | 先确认当前是否有 Responses 兼容端点 |
| DeepSeek 只提供 Chat Completions | 等待原生支持，或审查后使用协议转换层 |
官方入口：Codex。
!Codex 官方下载与使用入口
如果官方路线能满足需要，直接完成 Codex 桌面版安装与登录，不要为了“少一步”额外引入能接触密钥和配置文件的第三方程序。
::: danger 核心警示：协议不兼容风险
Codex 的原生自定义 Provider 仅支持 Responses API。严禁直接将只支持 Chat Completions 的 Base URL 写入配置，否则会导致工具调用（Tool Calling）失效，表现为“无法读取项目”、“无法执行命令”或“404 错误”。
:::
第 1 步：判断 API 协议类型
在接入 DeepSeek 之前，请务必确认您获得的是哪种协议：
- Responses API：支持复杂的工程任务与工具调用，是接入 Codex 的理想协议。
- 来源检查：是否仅从官方开源代码仓库（如 GitHub Releases）下载？严禁使用网盘、群文件分发的安装包。
- 权限审查：工具是否要求了不必要的“管理员权限”？协议转换通常不需要高权限。
- 密钥管理：是否使用了专用、低额度、可随时撤销的 API Key？严禁使用主账号的高额度 Key。
- 回滚方案：在修改
config.toml前，是否已手动备份原始配置文件？ - 只从项目原始发布页下载：CodexPlusPlus Releases。
- 发布者和文件名是否与发布页一致。
- 是否要求不相关的管理员权限。
- 是否捆绑其他软件。
- 安装目录和卸载入口在哪里。
- 供应商名称：
DeepSeek - Base URL：以 DeepSeek API 官方文档 当前说明为准
- API Key：使用本篇专门创建的低额度 Key
- 模型名：通过官方模型列表或工具的“从上游获取”功能确认，不要照抄过期截图
- 当前目录和项目类型。
- 退出 Codex 和 Codex++。
- 你能分清官方 Codex、DeepSeek 服务和第三方协议转换工具的责任边界。
2. Chat Completions API：目前国内主流大模型默认提供的协议，通常需要通过“协议转换层”（如 Codex++）才能被 Codex 识别。
验证方法：查阅服务商文档中的请求路径。如果是 /v1/chat/completions，则必须使用转换工具。
第 2 步：第三方工具安全审计
如果您决定使用第三方转换工具（如 Codex++），在安装前必须执行以下安全自查，这是确保您的项目代码与密钥安全的第一红线：
> 详情请参阅：使用第三方 Codex 工具前的安全检查
第 3 步：理解 Codex++ 的风险边界
Section titled “第 2 步：理解 Codex++ 的风险边界”
Codex++ 的作用是管理供应商配置，并可能在 Chat Completions 和 Responses 之间转换协议。它不是本站、OpenAI 或 DeepSeek 官方软件。
使用前先完成 第三方 Codex 工具安全检查，至少确认：
2. 阅读当前版本说明，不锁死教程写作时的旧版本号。
3. 对照发布页提供的哈希；如果没有可核对哈希，就明确记录这一风险。
4. 检查程序会修改哪些 config.toml、认证文件和环境变量。
5. 使用专用、可撤销、低额度 API Key。
6. 修改配置前先备份，退出工具后确认是否仍有后台进程。
不要从网盘、群文件、公众号附件等无法验证来源的位置获取安装包。
!CodexPlusPlus 发布页中的不同系统安装包
下载与你系统架构匹配的 Windows 安装包。安装过程中逐页检查：
安装后从 Windows 搜索中确认打开的是 Codex++ 管理工具，不要打开同名的陌生程序。
!Windows 搜索中的 Codex 与 CodexPlusPlus 管理工具
预期结果：你能说出安装包来源、版本、校验结果、安装目录和卸载方法。
第 4 步：创建 DeepSeek 专用配置
Section titled “第 4 步：创建 DeepSeek 专用配置”
在供应商配置中新增一项，建议填写：
如果工具提供“Chat Completions 转 Responses”模式，必须明确启用的是协议转换，而不是 DeepSeek 原生 Responses 支持。
!CodexPlusPlus 的供应商配置页面
保存前截图时遮住完整 API Key。保存后先不要打开生产项目。
第 5 步：启动 Codex 并完成认证
Section titled “第 5 步：启动 Codex 并完成认证”
按 Codex++ 当前界面提供的方式启动 Codex。如果出现登录选择，确认你正在走的是第三方 API Key 路线，而不是误以为已经完成 OpenAI 官方登录。
!Codex 登录方式选择页面
!API Key 输入页面，截图中的密钥已隐藏
如果界面、字段或登录流程与截图不同，停止操作并重新查看当前版本说明，不要猜测按钮用途。
确认界面显示的是刚配置的模型后，在空白会话发送：
``
请只用一句中文回复：DeepSeek 配置验证开始。
`
!Codex 中显示的第三方模型选择结果
预期结果：正常返回一句中文，且没有 401、404、协议字段或流式输出错误。
这只能证明最小对话链路可用，不能证明工具调用和项目操作都正常。
打开低风险练习项目，复制：
`
请只读分析当前项目，不要修改、创建或删除任何文件，也不要提交 Git。
请输出：
2. 你实际查看的文件或目录。
3. 你是否调用了本地工具，调用结果是什么。
4. 如果能够确认，说明当前模型和 provider；不能确认就明确写“不能确认”。
5. 最后运行 git status，证明没有产生文件改动。
`
预期结果：Codex 能读取项目并返回证据，git status` 没有新增改动。
如果普通对话成功但读项目失败，说明协议转换或工具调用兼容性仍有问题，不要继续让它修改代码。
检查 Key 是否复制完整、是否有余额、是否被撤销，以及工具实际读取的是哪个凭据。不要把 Key 发到聊天里排查。
优先检查 Responses 与 Chat Completions 是否混用、Base URL 是否被重复拼接，以及转换模式是否真的启用。
停止写操作，保存报错和工具日志中的非敏感部分，再检查工具调用、流式响应 and Responses 转换是否完整。
2. 恢复安装前备份的 Codex 配置文件。
3. 删除或禁用本篇新增的供应商配置。
4. 在 DeepSeek 平台撤销本篇专用 API Key。
5. 如不再使用，从系统卸载 Codex++ 并确认没有残留后台进程。
你做到这里，如果看到下面 3 个结果，就说明本篇完成：
2. 最小对话和项目只读验证都通过，且没有文件改动。
3. 你已经保存配置备份，并知道如何撤销 Key 和卸载工具。
下一篇看：第一次让 Codex 阅读项目。