DeepSeek-V4-Flash：Codex Responses API 接入工作流

一句话结论

官方提供的 Responses API 配置可以让 Codex CLI、ChatGPT 桌面端和 VS Code Codex 扩展共用一套 DeepSeek-V4-Flash 配置，适合把同一个代码 Agent 工作流迁移到 DeepSeek。

适用场景

• 适合的任务：已有 Codex 工作流的代码库修改、测试执行、工具调用和长程 Agent 任务。

• 不适合的任务：不希望把 API key 直接放入本地 Codex 配置，或依赖 ChatGPT 账号登录态的团队；应先评估密钥管理方案。

• 适用的模型版本：deepseek-v4-flash。

• 适用的客户端、Agent 或 API：Codex CLI、ChatGPT desktop app、VS Code Codex IDE extension；三者读取同一配置。

• 推荐的推理档位和参数：官方手动配置示例使用 model_reasoning_effort = "high"；简单任务可按思考模式文档改用 low，复杂任务改用 max。

可直接使用的内容

官方推荐的一键安装入口

先确保 Codex CLI 或 ChatGPT 桌面端至少启动过一次，再按操作系统执行官方脚本。脚本会备份现有 config.toml、写入 models.json、保留 MCP 与项目可信设置，并在写回前校验 TOML/JSON：

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

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

手动 ~/.codex/config.toml 最小片段

model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<your DeepSeek API Key>"

上面的 models.json 不是本文重建的内容，应直接让官方脚本生成，或从官方文档展开完整内容后保存；不要凭这段片段猜测模型目录元数据。

测试/工作流步骤

1. 备份现有 ~/.codex/config.toml 和 MCP 配置；官方脚本会放入 ~/.codex/backup-deepseek/，手动配置时也应先复制备份。

2. 运行一键脚本并在菜单中选择 deepseek-v4-flash，或手动写入上面的 provider 配置。

3. 用官方脚本生成 ~/.codex/models.json，不要删除已有项目可信设置和 MCP servers。

4. 在项目目录运行 codex；启动 banner 应显示 model: deepseek-v4-flash。

5. 用一个只读任务和一个可回滚的小修改验证 Responses API、工具调用、测试执行与结果回传，再迁移到生产代码库。

6. 如果切换后找不到历史会话，重启客户端；官方说明 ChatGPT 登录会话与第三方 API 会话按认证方式分组保存，并非被删除。

原始证据与数据

• 官方文档说明 DeepSeek 原生支持 OpenAI Responses API，且 Codex CLI、ChatGPT desktop app、VS Code extension 共用同一配置文件。

• 官方示例字段包括 model="deepseek-v4-flash"、model_provider="deepseek"、wire_api="responses"、base_url="https://api.deepseek.com/" 和 model_reasoning_effort="high"。

• 官方一键脚本的可核查行为：备份现有配置；写入 models.json；仅重写必要的 config.toml 字段；保留 MCP servers 与项目 trust levels；写入前验证 TOML/JSON；菜单可切换模型或恢复原配置。

• 官方更新页称 0731 V4-Flash 原生支持 Responses API，并“specifically adapted for Codex”。

适用边界

• 这是配置和接入说明，不是独立 benchmark；启动 banner 能证明配置生效，不能证明任务质量。

• experimental_bearer_token 会把 API key 放入配置文件；生产环境应限制文件权限，或改用团队批准的密钥注入方式。

• 官方文档要求先启动过 Codex CLI/桌面端以创建 ~/.codex；没有该目录时一键脚本前置条件不满足。

• 本文不重建官方 models.json 全量内容；上下文窗口、工具格式等元数据应以脚本/官方展开内容为准。

来源摘录或观察（仅做合规短引）

官方文档把三类客户端概括为共用 “the same configuration file”，并把 wire_api = "responses" 作为 DeepSeek provider 的协议字段。