K20微控制器时钟与ADC电气特性解析：从参数到高精度嵌入式设计
2026/6/9 14:46:05
目录
- 前言
- 前置条件
- 一、为什么选择 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++ 采用两层协议配置架构：
- 管理工具层（上游）：配置上游协议为
chat_completions，用于与 DeepSeek API 通信 - 本地代理层（转换）：管理工具通过本地代理
127.0.0.1:57321，将 Chat Completions 协议请求自动转换为 Responses API 格式 - Codex 层（下游）：Codex 接收转换后的 Responses API 格式配置，即配置模板中的
wire_api = "responses"
因此，必须从 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 按钮显示为灰色，无法点击进入主界面。
解决方案：
- 关闭当前运行的所有 Codex++ 进程
- 从任务管理器中确保没有残留进程
- 重新从管理工具中启动 Codex++
- 等待程序完全加载完成后再操作
5.2 汉化失败（语言包未下载）
问题描述：切换语言为中文后重启 Codex++，界面仍然是英文。
解决方案：切换科学网络环境后，重新启动 Codex++ 即可
5.3 DeepSeek 对话 404 报错
问题描述：配置完成后，尝试使用 DeepSeek 进行对话时，出现 404 报错。
排查过程：
遇到 404 后，我按以下顺序逐步排查：
- 检查 API Key：确认 Key 没有拼写错误，且余额充足 → 排除
- 检查 Base URL：在浏览器中直接访问
https://api.deepseek.com，确认可正常响应 → 排除 - 检查上游协议：在管理工具中发现"上游协议"被设置为 Responses API，而 DeepSeek 不支持该协议 →定位到问题根因
解决方案：
将上游协议从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 月，如后续版本有变化，请以官方文档为准。