目录前言前置条件一、为什么选择 DeepSeek二、获取 DeepSeek API 信息2.1 创建 API Key2.2 获取 API URL三、配置 DeepSeek API3.1 添加供应商3.2 填写配置信息3.3 配置预览3.4 启用配置3.5 启动 Codex3.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/11Codex 已安装已从 Microsoft Store 下载并安装 Codex且可正常登录DeepSeek API Key前往 platform.deepseek.com/api_keys 申请一、为什么选择 DeepSeekDeepSeek 是国内领先的大模型服务商其 API 具有以下优势优势说明国内直连API 域名国内可直接访问无需额外网络配置性价比高价格远低于 GPT-5 等国际模型兼容性好兼容 Chat Completions 协议可直接对接各类工具二、获取 DeepSeek API 信息2.1 创建 API Key前往 DeepSeek 官网创建并获取 API Key。参考https://platform.deepseek.com/api_keys2.2 获取 API URL在 DeepSeek 控制台中获取 API 的 URL。参考https://api-docs.deepseek.com/zh-cn/三、配置 DeepSeek API3.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表示使用自定义的第三方 APImodel_context_window上下文窗口大小单位token。决定模型能够记住多少之前的对话内容。数值越大模型能参考的历史对话越多但会消耗更多的 token 费用。当前设置为 1047576约100万 tokenmodel_auto_compact_token_limit自动压缩阈值单位token。当对话历史超过这个数值时系统会自动压缩较早的对话内容以节省 token 开销。一般设置为model_context_window的 50%-90%。当前设置为 900000wire_apiCodex 层下游协议类型默认为responses。requires_openai_auth是否需要 OpenAI 认证。由于我们使用的是 DeepSeek API可以设置为truebase_urlAPI 的基础 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 月如后续版本有变化请以官方文档为准。
初次安装 Codex 记录：从下载到配置 DeepSeek API
发布时间：2026/6/6 23:51:56
目录前言前置条件一、为什么选择 DeepSeek二、获取 DeepSeek API 信息2.1 创建 API Key2.2 获取 API URL三、配置 DeepSeek API3.1 添加供应商3.2 填写配置信息3.3 配置预览3.4 启用配置3.5 启动 Codex3.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/11Codex 已安装已从 Microsoft Store 下载并安装 Codex且可正常登录DeepSeek API Key前往 platform.deepseek.com/api_keys 申请一、为什么选择 DeepSeekDeepSeek 是国内领先的大模型服务商其 API 具有以下优势优势说明国内直连API 域名国内可直接访问无需额外网络配置性价比高价格远低于 GPT-5 等国际模型兼容性好兼容 Chat Completions 协议可直接对接各类工具二、获取 DeepSeek API 信息2.1 创建 API Key前往 DeepSeek 官网创建并获取 API Key。参考https://platform.deepseek.com/api_keys2.2 获取 API URL在 DeepSeek 控制台中获取 API 的 URL。参考https://api-docs.deepseek.com/zh-cn/三、配置 DeepSeek API3.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表示使用自定义的第三方 APImodel_context_window上下文窗口大小单位token。决定模型能够记住多少之前的对话内容。数值越大模型能参考的历史对话越多但会消耗更多的 token 费用。当前设置为 1047576约100万 tokenmodel_auto_compact_token_limit自动压缩阈值单位token。当对话历史超过这个数值时系统会自动压缩较早的对话内容以节省 token 开销。一般设置为model_context_window的 50%-90%。当前设置为 900000wire_apiCodex 层下游协议类型默认为responses。requires_openai_auth是否需要 OpenAI 认证。由于我们使用的是 DeepSeek API可以设置为truebase_urlAPI 的基础 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 月如后续版本有变化请以官方文档为准。
