本教程仅介绍 Windows 环境下的配置流程、验证方法，以及出现问题后应该优先检查的位置。
模型名称、客户端版本、官方脚本内容可能随时间更新，实际操作时请以 DeepSeek 官方页面当前显示的信息为准。

参考：

• DeepSeek 官方 Codex 接入指南
• DeepSeek 官方配置脚本

---

一、准备工作：申请 DeepSeek API Key

首先前往 DeepSeek 控制台创建 API Key：

https://platform.deepseek.com/top_up

API Key 安全注意事项

如果旧 Key 曾经出现在以下位置：

• 截图
• 聊天记录
• 文章教程
• 代码仓库
• 社交平台

请立即在 DeepSeek 控制台撤销，不要继续使用。

新的 API Key：

• 只在自己的电脑中输入
• 不要发送给任何人
• 不要截图展示
• 不要提交到代码仓库

另外需要注意：

DeepSeek 官方配置脚本并不是只在 PowerShell 当前窗口临时使用 Key，它可能会把认证信息写入 Codex 用户配置目录。

因此以下目录也需要作为敏感目录保护：

C:\Users\你的用户名\.codex\

不要上传整个 .codex 文件夹，也不要分享其中的配置文件。

教程截图中的 API Key 页面建议：

• 必须打码
• 使用相对路径保存图片资源，避免换电脑或发布后失效

示例：

![DeepSeek API key 页面，密钥已打码](./assets/deepseek-api-key-redacted.png)

---

二、运行 DeepSeek 官方配置脚本

打开 Windows PowerShell，执行：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

该命令会：

1. 从 DeepSeek 官方地址下载 PowerShell 脚本
2. 立即执行配置流程

虽然地址来自官方，但需要注意：

远程脚本直接执行本身仍然存在风险。

不要从陌生教程复制类似命令。

如果不放心，可以：

1. 先打开脚本内容
2. 确认来源
3. 再执行

---

配置步骤

脚本出现菜单后：

1. 输入：

1

2. 选择：

deepseek-v4-flash

3. 按提示输入新创建的 DeepSeek API Key
4. 等待脚本完成配置

---

关于 deepseek-v4-pro 的提醒

脚本菜单中出现某些模型名称，并不代表当前客户端版本和官方接入状态已经完整支持。

不要仅因为菜单里看到某个模型名称，就直接选择。

正确方式：

• 以 DeepSeek 官方当前文档为准
• 确认模型名称
• 确认客户端版本要求
• 确认推荐接入方式

不要：

• 把 Key 拼接到命令里
• 把 Key 写入公开脚本
• 在文章中展示真实 Key

---

三、重启 Codex，并进行三阶段验证

配置完成后：

1. 完全退出 Codex 桌面端
2. 重新打开 Codex

然后不要直接开始修改项目。

建议按照下面顺序验证。

---

第一步：基础模型请求测试

输入：

只回复 OK

如果返回：

OK

说明：

• API 请求基本成功
• Provider 配置可能正常

如果出现：

• 401
• 模型不存在
• Provider 错误

先不要让 Codex 操作项目。

优先检查：

• API Key
• 模型名称
• Provider 配置
• 客户端版本

---

第二步：只读文件测试

输入：

只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件

用于确认：

• Codex 是否可以访问工作区
• 文件读取功能是否正常

---

第三步：简单工具调用测试

输入：

只列出当前工作区中的文件名，不要创建、删除或修改任何文件

用于确认：

• 工具调用是否正常
• 工作区权限是否正常

---

为什么要拆成三步？

因为：

• 基础请求失败 → 多半是 Key、模型、Provider 问题
• 文件读取失败 → 可能是工作区权限或客户端问题
• 工具调用失败 → 可能是 Codex 工具链问题

分开测试才能快速定位原因。

---

四、原配置备份位置

官方脚本通常会创建备份目录：

C:\Users\Administrator\.codex\backup-deepseek\

如果 Windows 用户名不是 Administrator：

查看：

C:\Users\你的用户名\.codex\backup-deepseek\

该目录可能包含：

• Provider 配置
• API 地址
• 认证信息

不要：

• 上传到网盘
• 发给别人排查
• 放入公开仓库

---

五、终端版 Codex：先确认版本

桌面版 Codex 和终端版 Codex 不要混在一起判断。

如果使用终端版：

先执行：

codex --version

例如某些环境检测到：

0.117.0

但 DeepSeek 官方配置脚本可能要求更高版本，例如：

0.144.0+

版本要求可能变化，因此必须以官方当前说明为准。

需要升级时：

npm install -g @openai/codex

升级后重新确认：

codex --version

注意：

如果你只使用桌面端：

不要拿终端版版本号证明桌面端已经接入成功。

最终判断标准应该是：

• 桌面端是否出现对应 Provider
• 模型请求是否成功
• 文件读取和工具调用是否正常

---

六、常见错误排查

1. 401 或鉴权失败

优先检查：

是否使用了泄露过的旧 Key

如果 Key 曾经公开：

立即撤销并重新创建。

是否复制错误

检查：

• 前后空格
• 换行字符
• 输入是否完整

不要把 Key 发给别人检查。

正确方式：

重新创建 Key，只在本机配置时输入。

---

2. 模型不存在或版本不支持

先确认：

codex --version

然后确认：

• 当前使用的是桌面版还是终端版
• DeepSeek 官方当前要求的模型名称
• 官方要求的最低客户端版本

如果版本过低：

1. 升级客户端
2. 重新运行配置脚本
3. 再进行验证

---

3. 不要把 DeepSeek Key 用在 OpenAI 登录流程

不要使用：

codex login --with-api-key

原因：

DeepSeek API Key 不是 OpenAI 登录凭据。

DeepSeek 应通过：

• 自定义 Provider
• API 地址配置
• 对应通信协议

进行接入。

---

最后记住三点

1. 旧 Key 暴露过，第一时间撤销。
2. DeepSeek API Key 不是 OpenAI 登录凭据。
3. 界面里出现模型，不代表模型请求、文件读取和工具调用已经完全正常。

配置成功的标准不是“看到模型名称”，而是：

• 请求成功
• 文件读取正常
• 工具调用正常