初次安装 Codex 记录：从下载到配置 DeepSeek API

Quz

1503人浏览 · 2026-06-05 06:30:00

Quz · 2026-06-05 06:30:00 发布

前言

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。

修改协议后，对话功能就能正常工作了。
在这里插入图片描述