目录
-
- 前言
- 前置条件
- 一、为什么选择 DeepSeek？
- 二、获取 DeepSeek API 信息
-
- 2.1 创建 API Key
- 2.2 获取 API URL
- 三、配置 DeepSeek API
-
- 3.1 添加供应商
- 3.2 填写配置信息
- 3.3 配置预览
- 3.4 启用配置
- 3.5 启动 Codex++
- 3.6 成功进入
- 3.7 验证配置是否生效
- 四、设置中文
-
- 4.1 进入设置
- 4.2 切换语言
- 4.3 汉化成功
- 五、遇到的问题及解决方案
-
- 5.1 启动后按钮是灰色的无法进入
- 5.2 汉化失败（语言包未下载）
- 5.3 DeepSeek 对话 404 报错
- 总结
前言
Codex 是 OpenAI 推出的编程助手，支持接入第三方大模型 API。本文记录了如何在 Codex 中配置 DeepSeek API，实现使用国产大模型进行编程辅助，以及配置过程中常见问题的解决方法。
前置条件
在开始之前，请确认你已具备以下条件：
| 操作系统 | Windows 10/11 |
| Codex 已安装 | 已从 Microsoft Store 下载并安装 Codex，且可正常登录 |
| DeepSeek API Key | 前往 platform.deepseek.com/api_keys 申请 |
一、为什么选择 DeepSeek？
DeepSeek 是国内领先的大模型服务商，其 API 具有以下优势：
| 国内直连 | API 域名国内可直接访问，无需额外网络配置 |
| 性价比高 | 价格远低于 GPT-5 等国际模型 |
| 兼容性好 | 兼容 Chat Completions 协议，可直接对接各类工具 |
二、获取 DeepSeek API 信息
2.1 创建 API Key
前往 DeepSeek 官网，创建并获取 API Key。参考：https://platform.deepseek.com/api_keys
2.2 获取 API URL
在 DeepSeek 控制台中获取 API 的 URL。参考：https://api-docs.deepseek.com/zh-cn/
三、配置 DeepSeek API
3.1 添加供应商
在 Codex++ 管理工具中，点击添加供应商按钮。
在配置窗口中需要填写 API Key 和 Base URL，接下来说明如何获取。
3.2 填写配置信息
将获取到的 API Key 和 URL 填写到管理工具中，完成后保存。
重要说明：上游协议选择 Chat Completions
在配置时，需要将"上游协议"选项设置为 Chat Completions，而不是 Responses API。这是因为 DeepSeek API 兼容 Chat Completions 协议。如果选择了 Responses API，在后续使用时会出现 404 报错，导致对话失败。
3.3 配置预览
保存后可以查看配置预览，确认信息无误。
以下是可用的配置信息模板（从上图中整理）：
model = "deepseek-v4-flash"
model_provider = "custom"
model_context_window = 1047576
model_auto_compact_token_limit = 900000
[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.deepseek.com"
[features]
模型选择说明： 这里使用 deepseek-v4-flash 是因为其响应速度快、成本低，适合日常编程辅助场景。具体可选模型请参考 DeepSeek 官方文档。
配置项说明：
| model | 使用的模型名称，这里使用 deepseek-v4-flash，也可根据需求更换为其他模型 |
| model_provider | 模型提供方标识，设置为 custom 表示使用自定义的第三方 API |
| model_context_window | 上下文窗口大小（单位：token）。决定模型能够"记住"多少之前的对话内容。数值越大，模型能参考的历史对话越多，但会消耗更多的 token 费用。当前设置为 1047576（约100万 token） |
| model_auto_compact_token_limit | 自动压缩阈值（单位：token）。当对话历史超过这个数值时，系统会自动压缩较早的对话内容，以节省 token 开销。一般设置为 model_context_window 的 50%-90%。当前设置为 900000 |
| wire_api | Codex 层（下游）协议类型，默认为responses。 |
| requires_openai_auth | 是否需要 OpenAI 认证。由于我们使用的是 DeepSeek API，可以设置为 true |
| base_url | API 的基础 URL。DeepSeek 的默认地址为 https://api.deepseek.com |
工作原理说明：Codex++ 采用两层协议配置架构：
因此，必须从 Codex++ 管理工具启动 Codex，才能确保本地代理服务正常工作。如果直接启动原生 Codex，将无法连接到本地代理，也就无法使用配置的 DeepSeek API。
3.4 启用配置
点击"使用"按钮，启用刚刚配置的 DeepSeek API。
3.5 启动 Codex++
配置完成后，我们需要启动 Codex++。注意：首先需要将所有 Codex 相关程序退出，然后从管理工具中启动 Codex++。
从管理工具中点击启动按钮：
3.6 成功进入
等待程序加载完成后，成功进入 Codex++ 界面。 
3.7 验证配置是否生效
进入 Codex++ 后，在对话框中输入一句简单的测试消息（如"你是什么模型？"），确认能正常收到回复。
- 成功：收到模型的正常回复，说明配置已生效
- 失败：返回 404 或超时错误，请检查上游协议是否已设置为 Chat Completions（参考 4.3 节）
四、设置中文
进入 Codex++ 后，英文看着不太舒服？我们需要将界面语言设置为中文。
4.1 进入设置
点击设置按钮，进入设置页面。
4.2 切换语言
在设置中找到语言选项，切换为中文。 
4.3 汉化成功
切换语言后，需要重启 Codex++。如果重启后仍然是英文，大概率是语言包未拉取成功，需要使用网络加速工具才能正常下载语言包。
五、遇到的问题及解决方案
在配置过程中，可能会遇到以下问题。
5.1 启动后按钮是灰色的无法进入
问题描述：点击启动 Codex++ 后，界面上的 Continue 按钮显示为灰色，无法点击进入主界面。 
解决方案：
5.2 汉化失败（语言包未下载）
问题描述：切换语言为中文后重启 Codex++，界面仍然是英文。
解决方案：切换科学网络环境后，重新启动 Codex++ 即可
5.3 DeepSeek 对话 404 报错
问题描述：配置完成后，尝试使用 DeepSeek 进行对话时，出现 404 报错。
排查过程： 遇到 404 后，我按以下顺序逐步排查：
解决方案： 将上游协议从 Responses API 改为 Chat Completions。
为什么 DeepSeek 只支持 Chat Completions？
简单来说，Chat Completions 是目前业界通用的对话接口标准，DeepSeek、智谱、通义千问等国内模型都兼容这一协议。而 Responses API 是 OpenAI 自己推出的新接口，虽然功能更强，但第三方模型还没来得及适配。所以在对接 DeepSeek 时，必须选择 Chat Completions，否则请求格式对不上就会报 404。
修改协议后，对话功能就能正常工作了。 
总结
通过以上步骤，我们成功完成了：
- ✅ 获取了 DeepSeek API Key 和 URL
- ✅ 在 Codex++ 中配置了 DeepSeek API
- ✅ 解决了常见的 404 配置问题
- ✅ 实现了界面的中文汉化
整个过程虽然遇到了一些问题，但最终都顺利解决了。希望这篇博客能帮助到有相同需求的小伙伴，少走一些弯路。
如果在配置过程中遇到其他问题，欢迎在评论区留言交流。
声明：本文所有截图均为作者实操截图，技术说明为个人理解。转载请注明出处。本文最后验证于 2026 年 6 月，如后续版本有变化，请以官方文档为准。
