DeepSeek 在 V4-Pro 正式版更新（8 月 13 日）中原生支持了 OpenAI Responses API 格式，并针对 Codex 做了适配，官方提供一键配置脚本——不用再自己写兼容层。这篇把配置路径、脚本动了什么、能力边界在哪讲清，细节以官方 Responses API 指南为准。
配置前先确认三件事
一是版本：Responses API 支持随 V4-Pro 正式版上线，先把 API 用在正式版（模型名 deepseek-v4-pro）；二是账号：平台已有 API key 且余额充足，报错对照见API 报错对照一篇；三是工具：确认你用的 Codex 客户端形态（CLI、桌面应用或编辑器扩展），官方脚本的同一份配置对三种形态都生效。
一键脚本做了什么
按官方文档路径运行配置脚本后，它主要做两件事：一是注册模型提供方——在 Codex 的配置文件里加入 DeepSeek 的接入块，指定协议类型为 Responses API，这样 Codex 发出的请求会按 DeepSeek 认识的格式走；二是登记模型信息——把模型的上下文窗口与思考档位声明给 Codex，让它像对待内置模型一样展示和调用 DeepSeek。脚本会先备份你现有的配置文件再写入，写入前会校验格式，配置坏了可以回滚备份。
动手前两个小提醒：跑脚本前关掉正在运行的 Codex 客户端，避免配置文件被回写覆盖；跑完后用一条最简指令验证通路，通了再迁真实任务。
提示词起手式（配置后验证）：「请用一句话回答：你的模型名和上下文长度是多少。不确定的字段直接说不知道，不要编造。」——能正确回出模型与上下文信息，说明链路已通。
能力边界：先读再接
官方在 Responses API 指南中明确了适配的范围，社区对细节也有整理（以下两条来源不同，均以官方指南当前版本为准）：一是协议实现是有意的子集，不是全量照搬——部分会话状态类的参数不生效，多轮对话要由调用方自己维护上下文；二是内置工具的支持有取舍，函数调用类能力可用，个别工具类目会被忽略，图片与文件输入的支持范围也在随版本演进变化。这些边界的共同后果是：超长请求可能直接报 400 而不是被自动截断，接入前按自己的任务长度做好预算，报错对照见错误码对照。
实际落地建议分两步：先在非关键任务上并行跑一段时间，把「结果质量、耗时、消耗」三项与原方案对齐记录；确认稳定后再切主力任务。三档思考强度在 Codex 场景的选法，见三档思考强度怎么选一篇。
与 Claude Code 的接入是两回事
DeepSeek 文档里另有一条面向 Claude Code 的集成路径，走的是不同的接口端点与配置方式，两套不要混用：Codex 系工具走 Responses API 配置，Claude Code 按官方的独立指南配置。选定一个先跑通，比两边同时折腾省时间。
常见问题
- 配置脚本会动我的原有配置吗？会先备份再写入，出问题可回滚；仍建议自己先手动备份一份。
- 为什么不建议自己手写兼容层？协议细节随版本演进，官方脚本与指南同步更新；自己写的东西在下次协议调整时维护成本更高。
- 接入后成本怎么算？按 DeepSeek API 正常计费（峰谷定价生效中），模型间选档的成本账见flash 与 pro 选档一篇。
信息来源
- DeepSeek 官方更新日志与 Responses API 指南（api-docs.deepseek.com，核对时间 2026-11-02）：正式版原生支持、Codex 适配与一键脚本；
- 社区对实现细节的整理（AI Wiki 等，核对时间 2026-11-02）：协议子集与工具支持范围——这部分以官方指南当前版本为准；
- 站内条目：DeepSeek接口（工具页）、API 报错对照、三档思考强度。
