DeepSeek V4正式版发布，教你在Codex中配置Flash

DeepSeek V4 Flash 发布后，Codex 可以直接接入了

DeepSeek 在 2026 年 7 月 31 日更新日志中写明，deepseek-v4-flash 正式版 API 上线公测，原生支持 Responses API，并针对 Codex 做了适配。模型名保持 deepseek-v4-flash，已有 API 调用方式无需换名。

官方还公布了一组 Agent 基准成绩，例如 Terminal Bench 2.1 为 82.7、Toolathlon verified 为 70.3。这些数字属于厂商口径，可以用来确认产品定位，不能直接当成本地开发体验。本文把重点放在接入流程和配置验证上。

开始前准备三样东西

| 准备项 | 检查方式 | 用途 | | --- | --- | --- | | Codex CLI 或 Codex 客户端 | codex --version | 运行模型与 Agent | | 已运行过一次 Codex | 确认 ~/.codex 已存在 | 让脚本找到配置目录 | | DeepSeek API Key | 从 DeepSeek Platform 创建 | 调用 API |

Windows 一条命令完成配置

打开 PowerShell，执行 DeepSeek 官方脚本：

bash 复制代码

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

脚本出现菜单后输入 1，再按提示提供 API Key。它会备份原来的 config.toml，写入 models.json，把默认模型改成 deepseek-v4-flash，同时将 provider 指向 DeepSeek 的 Responses API。

我在 Windows 上用 Codex CLI 0.137.0 跑了一遍。下图来自本机实际执行日志，为了遮掉本地路径与演示密钥，按终端样式重新排版。个人 ~/.codex 没有被修改，测试使用独立 CODEX_HOME。

macOS / Linux 命令

bash 复制代码

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

配置文件由不同 Codex 客户端共用。CLI、ChatGPT 桌面端和 VS Code Codex 插件通常都会读这份配置。改完后重新启动正在运行的客户端，避免继续使用旧缓存。

Codex 桌面端怎么看是否生效

Windows 端配置第三方 provider 后，左下角可能显示 custom。下图是用户本机 Codex 桌面端原始截图，展示了自定义 provider 已被客户端载入。这个画面本身不能证明 API 已连通，连通结果仍要配合后面的 Codex Doctor 和一次真实任务确认。

Codex 0.137.0 可能遇到一个兼容问题

本机第一次校验没有直接通过。官方脚本生成的 models.json 里包含推理档位 max，Codex CLI 0.137.0 的解析器接受 none / minimal / low / medium / high / xhigh，随后报出 unknown variant max。

这个问题和 API Key 无关，模型请求还没发出去，配置加载阶段已经停了。下图是本机实际报错，路径做了省略，错误文本和版本信息保持原样。

遇到同样报错，再执行这个修复

bash 复制代码

$path = "$HOME\.codex\models.json"
$json = [IO.File]::ReadAllText($path)
$json = $json.Replace('"effort": "max"', '"effort": "xhigh"')
[IO.File]::WriteAllText($path, $json, [Text.UTF8Encoding]::new($false))

这条修复针对 Codex CLI 0.137.0 的实跑结果。如果 Codex 没报 unknown variant max，保持官方文件即可。更新 Codex 后也建议先重新校验，避免把临时兼容处理当成长期固定配置。

用 Codex Doctor 验证配置

修复后执行：

bash 复制代码

codex doctor --json

重点看四项：config.load 为 OK，模型为 deepseek-v4-flash，provider 为 deepseek，wire API 为 responses。本机复测已经通过这四项，说明 Codex 能读懂模型目录与 provider 配置。

这里需要把边界说清楚：本次用了故意无效的演示 Key，没有发起模型请求，也没有产生计费。截图能证明"配置被 Codex 正确识别"，不能证明线路延迟、模型输出质量或 Token 消耗。拿到自己的有效 Key 后，再用一个小任务完成最终连通测试。

密钥和回滚，别漏掉这两件事

官方 Windows 脚本会把 API Key 写入本机 Codex 配置。不要把 config.toml、终端历史或完整截图提交到 Git，也不要发到公开问答。团队环境更适合给每个人单独的 Key，泄露后可以单独停用，不影响其他成员。

想切回原配置，重新运行官方脚本并选择 3。脚本会使用 ~/.codex/backup-deepseek 中的备份恢复。手动改过配置的人，回滚前先确认备份时间，避免覆盖后来新增的设置。

跑完记得看价格

配置完成后，我还会再看一遍实际调用成本。Codex 跑 Agent 时上下文长、工具调用多，单看 API 标价不太够。可以对比deepseek V4 的不同渠道的价格、延迟和可用性，再用同一个任务核对 Token 消耗。这样选线路更直观，也能避免标价便宜，整轮任务账单却偏高