Codex DeepSeek 配置教程
Codex DeepSeek 配置教程
Section titled “Codex DeepSeek 配置教程”这一篇带你把 Codex 连接到 DeepSeek。
它不是让你复制一段来历不明的配置，而是按喂饭级流程走完整闭环：
确认官方文档-> 创建或准备 DeepSeek API Key-> 设置本机环境变量-> 让 Codex 生成配置草稿-> 确认后写入配置-> 用只读项目分析验收-> 失败时按清单排查前置教程：国内大模型配置方案
如果你还没有理解国内模型接入 Codex 的通用流程，先完成前置教程，再回到本篇。
依据来源：OpenAI Codex 官方手册中的 Custom model providers、
config.toml、环境变量认证说明；DeepSeek API 官方文档中的 OpenAI 兼容接口、Base URL、模型名和 API Key 说明。
跟着本篇做完后，你应该能做到：
- 从 DeepSeek 官方文档确认 Base URL。
- 从 DeepSeek 官方文档确认当前模型名。
- 创建或准备 DeepSeek API Key。
- 把 API Key 放到 Windows 环境变量里。
- 让 Codex 生成配置草稿，而不是直接盲改文件。
- 让 Codex 写入配置并解释 diff。
- 用只读任务确认配置可用。
- 配置失败时知道先查哪里。
本篇不做什么
Section titled “本篇不做什么”本篇不做这些事情：
- 不把真实 API Key 写进教程。
- 不让你把真实 API Key 发给 Codex。
- 不承诺旧模型名长期可用。
- 不在配置没验收前让 Codex 修改业务代码。
- 不把 DeepSeek 的所有高级参数一次讲完。
本篇只解决一个目标：
让 Codex 可以安全、可排查地连接 DeepSeek，并完成一次只读验证。第 1 步：确认 DeepSeek 官方参数
Section titled “第 1 步：确认 DeepSeek 官方参数”先打开 DeepSeek 官方 API 文档：
https://api-docs.deepseek.com/在文档里确认 3 件事：
| 要确认的信息 | 当前官方文档示例 | 你要记下什么 |
|---|---|---|
| OpenAI 兼容 Base URL | https://api.deepseek.com | 复制这个地址 |
| API Key 入口 | DeepSeek Platform | 确认你能创建 Key |
| 模型名 | deepseek-v4-pro、deepseek-v4-flash | 选择一个本篇使用的模型 |
本篇先用：
deepseek-v4-pro如果你看到 DeepSeek 官方文档里的模型名已经变化，以官方文档为准，不要死记本篇截图。
第 2 步：确认旧模型名风险
Section titled “第 2 步：确认旧模型名风险”DeepSeek 官方文档里提到旧模型名会有废弃时间。
你可能在旧教程或旧文章里看到：
deepseek-chatdeepseek-reasoner不要直接照抄旧文章。
本篇写作时，DeepSeek 官方文档示例已经把 deepseek-v4-pro 和 deepseek-v4-flash 放在模型列表里，并标注旧模型名的废弃说明。
你要养成一个习惯：
配置模型前，先看官方模型列表。第 3 步：准备 DeepSeek API Key
Section titled “第 3 步：准备 DeepSeek API Key”进入 DeepSeek Platform：
https://platform.deepseek.com/你要做：
- 登录账号。
- 找到 API Key 管理页面。
- 创建一个新的 API Key。
- 复制 API Key。
- 保存到安全位置。
注意：API Key 只在创建时完整显示的服务商很多。如果你创建完没保存，后面可能只能删掉重建。
不要把 API Key 放到这些地方：
- 不要发给 Codex。
- 不要写进 Markdown。
- 不要发到微信。
- 不要截图露出完整 Key。
- 不要提交到 Git。
第 4 步：设置 Windows 环境变量
Section titled “第 4 步：设置 Windows 环境变量”本篇建议环境变量名：
DEEPSEEK_API_KEY方法 A：用 Windows 图形界面设置
Section titled “方法 A：用 Windows 图形界面设置”适合完全新手。
操作步骤：
- 按
Win键。 - 搜索
环境变量。 - 打开“编辑系统环境变量”。
- 点击“环境变量”。
- 在“用户变量”区域点击“新建”。
- 变量名填写：
DEEPSEEK_API_KEY- 变量值填写你的真实 DeepSeek API Key。
- 点击确定。
- 把所有设置窗口都点确定关闭。
- 关闭当前 PowerShell。
- 重新打开一个新的 PowerShell。
方法 B：用 PowerShell 设置
Section titled “方法 B：用 PowerShell 设置”适合已经熟悉 PowerShell 的用户。
打开 PowerShell，运行：
setx DEEPSEEK_API_KEY "你的真实 DeepSeek API Key"注意：
- 引号里面替换成你自己的真实 Key。
- 运行完成后，必须关闭当前 PowerShell，再重新打开。
setx写入的是新环境，当前窗口通常不会立刻生效。
第 5 步：验证环境变量能读取
Section titled “第 5 步：验证环境变量能读取”重新打开 PowerShell 后，运行：
$env:DEEPSEEK_API_KEY如果能看到一串 Key，说明环境变量可读。
截图时一定要遮住输出。
如果什么都没有输出，先不要继续配置 Codex。
按顺序检查：
- 变量名是不是
DEEPSEEK_API_KEY。 - 你设置的是“用户变量”还是“系统变量”。
- 设置后有没有重新打开 PowerShell。
- Key 有没有复制完整。
第 6 步：让 Codex 先生成配置草稿
Section titled “第 6 步：让 Codex 先生成配置草稿”现在打开 Codex。
注意：先不要让 Codex 直接改文件。
把下面这段复制给 Codex：
我准备把 Codex 连接到 DeepSeek 的 OpenAI 兼容接口。
我已经从 DeepSeek 官方文档确认：- base_url：https://api.deepseek.com- model：deepseek-v4-pro- API Key 环境变量名：DEEPSEEK_API_KEY
要求：1. 先不要修改任何文件。2. 不要让我把真实 API Key 发给你。3. 请根据当前 Codex 官方配置方式，给出 config.toml 配置草稿。4. provider_id 使用 deepseek。5. 配置里只能写环境变量名，不能写真实 API Key。6. 请解释每一行配置是什么意思。7. 请特别说明是否需要 wire_api 字段；如果你不确定，请写“不确定”，不要编。你希望 Codex 给出的草稿大概像这样：
model = "deepseek-v4-pro"model_provider = "deepseek"
[model_providers.deepseek]name = "DeepSeek"base_url = "https://api.deepseek.com"env_key = "DEEPSEEK_API_KEY"重点检查：
model是你从官方文档确认的模型名。model_provider是deepseek。[model_providers.deepseek]和model_provider对得上。base_url是https://api.deepseek.com。env_key是DEEPSEEK_API_KEY，不是你的真实 Key。- 没有乱加你看不懂的字段。
关于 wire_api 的说明
Section titled “关于 wire_api 的说明”这一点要单独说清楚。
OpenAI Codex 官方手册说明自定义 provider 会涉及 Base URL、wire API、认证和可选请求头。同时，当前手册示例里 wire_api 注释为 responses，并标注这是支持值。
DeepSeek 官方文档确认的是 OpenAI 兼容 Chat API，示例接口是 Chat Completions。
所以本篇采用保守做法：
先不要自己乱填 wire_api。先让 Codex 根据当前版本解释是否需要。最终以只读任务能否跑通来验收。如果 Codex 要加 wire_api = "chat"，你要追问：
请说明你添加 wire_api = "chat" 的依据来自哪里。当前 Codex 官方手册是否支持这个值？如果没有明确依据，请不要添加。第 7 步：让 Codex 写入配置
Section titled “第 7 步：让 Codex 写入配置”当你确认草稿没问题后，再发这段：
我确认配置草稿可以继续。
请把 DeepSeek provider 写入 Codex 用户级配置文件。
要求：1. 修改前先告诉我目标配置文件路径。2. 只修改 Codex 配置文件。3. 不要写入真实 API Key。4. 只写入 env_key = "DEEPSEEK_API_KEY"。5. 如果配置文件不存在，请先说明将创建哪个文件。6. 修改后展示 diff。7. 用中文解释每一处变化。8. 不要修改业务项目文件。在 Windows 上，Codex 用户级配置一般位于：
C:\Users\你的用户名\.codex\config.toml也可以理解成：
~\.codex\config.toml如果你设置过 CODEX_HOME，路径可能不同。这时让 Codex 先解释它看到的 CODEX_HOME。
第 8 步：重启 Codex
Section titled “第 8 步：重启 Codex”配置文件和环境变量改完后，不要继续用旧会话赌运气。
建议：
- 退出当前 Codex。
- 关闭当前 PowerShell。
- 重新打开 PowerShell。
- 进入练习项目目录。
- 重新启动 Codex。
这样做可以避免两个问题：
- Codex 还没读取新配置。
- PowerShell 还没读取新环境变量。
第 9 步：做最小对话验证
Section titled “第 9 步：做最小对话验证”进入 Codex 后，先发一句最小问题：
请只用一句中文回复：DeepSeek 配置验证开始。如果能正常回复，说明至少模型调用链路有机会是通的。
如果这里就失败，先看错误信息，不要继续项目操作。
第 10 步：做只读项目验证
Section titled “第 10 步：做只读项目验证”最小对话能回复后，再做项目只读验证。
复制这段给 Codex：
请只读分析当前项目，不要修改任何文件，不要创建文件，不要删除文件。
请按下面格式输出：
## 1. 响应状态- 你是否能正常响应：- 如果你能判断，本次使用的模型/provider 是什么：- 如果不能判断，请写“不能判断”：
## 2. 当前项目- 当前目录：- 是否像项目根目录：- 判断依据：
## 3. 只读检查- 你查看了哪些文件或目录：- 有没有运行只读命令：- 有没有修改文件：
## 4. 下一步建议- 如果配置正常，下一篇应该做什么：- 如果配置异常，先查哪 3 件事：你希望看到：
- Codex 能正常输出。
- 它能读到当前项目路径。
- 它没有修改文件。
- 它能说明不确定的地方。
第 11 步：确认没有改业务文件
Section titled “第 11 步：确认没有改业务文件”继续让 Codex 检查：
请检查当前 Git 状态，确认这次 DeepSeek 配置验证有没有修改业务项目文件。
要求：1. 只运行只读检查。2. 不要修改任何文件。3. 如果工作区噪音较多，请列出变化文件，并说明这些变化是否和本次配置有关。如果工作区是干净的，本篇验收更稳。
如果有变化，先不要提交，也先不要回滚。先截图，再让 Codex 解释 diff。
问题 1：Codex 说找不到 API Key
Section titled “问题 1：Codex 说找不到 API Key”优先检查：
- 环境变量名是不是
DEEPSEEK_API_KEY。 - Codex 配置里是不是
env_key = "DEEPSEEK_API_KEY"。 - 你设置环境变量后有没有重开 PowerShell。
- 你是不是在另一个 Windows 用户里启动了 Codex。
可以让 Codex 只解释，不要改文件：
Codex 提示找不到 DEEPSEEK_API_KEY。请只读检查当前环境是否能读取这个环境变量。不要显示完整 Key，只告诉我是否存在，以及长度是否大于 0。问题 2：提示模型不存在
Section titled “问题 2：提示模型不存在”优先检查：
- 模型名有没有拼错。
- DeepSeek 官方文档当前是否还列出这个模型。
- 你的账号是否有权限调用这个模型。
- 是否复制了旧教程里的过期模型名。
追问 Codex：
DeepSeek 返回模型不存在。请不要修改配置，先列出我应该去 DeepSeek 官方文档确认的 3 个位置。问题 3：提示 401 或 API Key 无效
Section titled “问题 3：提示 401 或 API Key 无效”通常和 Key 有关。
检查：
- API Key 是否复制完整。
- Key 有没有多复制空格。
- Key 是否已经被删除。
- Key 是否属于当前账号或项目。
- 服务商控制台是否要求先充值或开通权限。
问题 4：提示超时或网络错误
Section titled “问题 4：提示超时或网络错误”先不要重装 Codex。
按顺序检查：
- 浏览器能不能打开 DeepSeek 官方文档。
- 当前网络是否能访问 DeepSeek API。
- 是否使用代理。
- 公司网络是否限制外部 API。
- DeepSeek 服务状态是否异常。
问题 5：Codex 回答能出来，但做项目任务很不稳定
Section titled “问题 5：Codex 回答能出来，但做项目任务很不稳定”这不一定是配置错误。
可能原因：
- 当前模型不适合复杂代码代理任务。
- 上下文太长。
- 提示词太模糊。
- 项目太大。
- 权限限制导致 Codex 读不到必要文件。
先用小任务验证，不要直接上大型重构。
本篇验收结果
Section titled “本篇验收结果”做到这里，如果满足下面 8 条，就说明 DeepSeek 配置教程完成：
- 你从 DeepSeek 官方文档确认了 Base URL。
- 你从 DeepSeek 官方文档确认了模型名。
- 你创建或准备好了 API Key。
- 你把 API Key 放进了
DEEPSEEK_API_KEY环境变量。 - Codex 配置文件没有出现真实 API Key。
- Codex 能正常回复一句中文验证消息。
- Codex 能完成一次只读项目分析。
- Git 状态确认没有意外业务文件变化。
下一篇学什么
Section titled “下一篇学什么”下一篇看：第一次让 Codex 阅读项目。
如果你想继续补齐国内模型系列，下一篇服务商教程可以写：Codex + 通义千问/Qwen 配置。
- OpenAI Codex 官方手册：
https://developers.openai.com/codex/codex-manual.md - DeepSeek API 文档：
https://api-docs.deepseek.com/ - DeepSeek Platform：
https://platform.deepseek.com/