大家好啊，我是 jianpeng。今天和大家聊一下 Codex 接入 DeepSeek：配置要准备什么，API 费用又该怎么算。
先回答两个常见问题：DeepSeek 官方提供了通过 Responses API 接入 Codex 的方案，需要自己的 API 密钥和对应模型目录；当前 Flash 推荐使用的模型名是 deepseek-flash，对应 V4.1 Flash。按官方低谷单价，100 万未缓存输入加 20 万输出约为 0.27 美元。这只是用量算例，任务重试和上下文增长都会改变实际费用。
原来的 DeepSeek V4 Flash 模型名还能用吗？
这篇文章最初讨论的是 V4 Flash。按照 DeepSeek 当前价格页，旧的 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 名称仍接受请求，但已转由 V4.1 Flash 提供服务并按其计费。新配置直接使用 deepseek-flash，更容易和现在的文档、账单对应。
我把接入步骤和费用分开核对：配置依据官方集成文档，金额按公开单价计算。接入自己的环境后，还要用一个小任务检查实际模型、工具调用和账单，才能判断是否适合替换原有方案。
Codex 接入 DeepSeek：先准备模型目录，再配置 provider
先安装并启动一次 Codex，记录 codex --version。用户配置目录通常是 ~/.codex/；Windows 对应用户目录下的 .codex。修改前备份已有的 config.toml 和 models.json。
- 打开 DeepSeek 官方 Codex 集成页，按手动配置部分保存完整的
models.json到用户配置目录。页面提供了完整模型能力和提示设置，只复制下面的 TOML 不能代替这一步。 - 在本机设置
DEEPSEEK_API_KEY环境变量，让启动 Codex 的进程可以读取；不要把密钥写入项目、聊天内容或共享截图。 - 编辑用户配置文件，把下面的顶层字段合并到已有配置，再添加或更新
[model_providers.deepseek]。已有同名字段或表时应替换，不能重复追加。 - 重新启动 Codex，检查显示的模型是否为
deepseek-flash，再进行下一节的最小验证。
model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
web_search = "disabled"
model_catalog_json = "~/.codex/models.json"
[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
env_key = "DEEPSEEK_API_KEY"以上沿用 DeepSeek 的集成参数，将密钥改为通过 OpenAI 配置文档支持的 env_key 读取。官方页面也提供 Windows、macOS/Linux 设置脚本，可自动写入模型目录和配置；使用前先查看脚本内容和备份位置。已有自定义配置时，手动合并更容易确认改动范围。
顶层字段要放在 TOML 表头之前；如果粘贴在某个 [...] 表后，它们会被解释成那个表的内容。模型目录路径错误、重复的 provider 表、进程读不到环境变量，都是开始请求前就值得检查的地方。
怎样确认接入成功，出错后怎样恢复？
启动界面显示正确模型，只能说明客户端读到了选择。我的验证顺序会是：在一个允许发送内容的公开小项目中做只读任务，再做一次有明确验收的小修改。
第一步，只读验证：
读取 package.json，说明测试入口；找到一个纯函数与调用方。
列出所依据的文件位置。不要写文件，不要安装依赖。
第二步，单独授权修改：
只修复指定函数；增加一个能复现原问题的用例；运行相关测试。
报告实际执行的命令、结果和未验证事项。检查时看四项：请求是否真正返回；工具读取的文件是否正确；测试命令是否实际执行；DeepSeek 用量记录是否出现对应消耗。费用由 DeepSeek API 用量决定，不能从 Codex 界面显示的模型名称推导出来。
如果报认证错误，先确认启动进程能读到密钥且账户可调用 API；如果是模型目录或协议错误，核对完整 models.json、客户端版本和 wire_api，一次只改一个变量。需要回退时，恢复备份的配置与模型目录并重启 Codex。使用官方脚本的读者可按其菜单选择恢复原配置，文档给出的备份目录是 ~/.codex/backup-deepseek/。
DeepSeek Flash API 多少钱？先分清三种 Token
费用由未命中缓存的输入、命中缓存的输入和输出三部分组成。下面是 DeepSeek 官方价格页列出的 Flash 单价，单位是每 100 万 Token、美元：
| 计费项目 | 低谷 | 高峰 |
|---|---|---|
| 输入：缓存未命中 | $0.15 | $0.30 |
| 输入：缓存命中 | $0.003 | $0.006 |
| 输出 | $0.60 | $1.20 |
当前高峰为周一至周五的北京时间 09:00–12:00、14:00–18:00，中国法定节假日除外，其余为低谷。跨时段请求应按实际用量分段计算，时段与最终计费以官方页面及账单为准。
费用 = 未命中输入 / 1,000,000 × 未命中单价
+ 命中输入 / 1,000,000 × 命中单价
+ 输出 / 1,000,000 × 输出单价
小任务算例：100 万输入 + 20 万输出，没有输入缓存。
低谷：1 × 0.15 + 0.2 × 0.60 = $0.27
高峰：1 × 0.30 + 0.2 × 1.20 = $0.54
批量算例：1 亿输入 + 2000 万输出，全部落在同一时段。
无缓存，低谷：100 × 0.15 + 20 × 0.60 = $27.00
无缓存，高峰：100 × 0.30 + 20 × 1.20 = $54.00
假设其中 80% 的输入命中缓存，输出不变：
低谷：20 × 0.15 + 80 × 0.003 + 20 × 0.60 = $15.24
高峰：20 × 0.30 + 80 × 0.006 + 20 × 1.20 = $30.4880% 是计算假设，不能预先当作自己的缓存命中率。实际做预算时，用 API 用量记录里的命中与未命中数量替换它；同时计入重试、工具返回带来的追加上下文，以及计费输出。上述金额不含第三方网关加价、税费或运维开销。
单价低，是否就适合自己的 Codex 工作流？
我更关心完成一项任务的总成本。两个模型使用相同仓库版本、提示、权限和验收条件，再比较成功完成的任务数、人工修正、失败原因与总费用。如果便宜的单次请求需要反复重试，最终可能花得更多。
你可以先用Codex 缺陷复现与回归测试案例界定一个小任务，再用任务检查工具记录模型端点、输入范围和恢复条件。先验证这个小任务能否稳定完成，再决定是否扩大使用范围。