Codex 怎么接 DeepSeek V4.1 Flash?模型和 Responses 配置教程

通过 DeepSeek Responses API 在 Codex 使用 deepseek-flash。核对官方配置脚本、完整模型目录与认证,再验证编程任务。

柔和背景与浅色卡纸上的打字机黑色墨线图,标题为 DeepSeek V4.1 Flash。

在 Codex 中使用 DeepSeek V4.1 Flash,需要选择 deepseek-flash、把 DeepSeek 配成 Responses API 供应商,并安装完整模型目录。 DeepSeek 的官方 Codex 接入指南同时提供配置脚本和手动配置。

核查日期为 2026 年 9 月 10 日。本文使用 DeepSeek 直连服务,没有执行付费推理或确认完整 Codex 编程会话成功。模型发布信息见发布总览,直接发 API 请求见 API 教程

已装好 Codex,用官方脚本配置

先安装并至少启动一次 Codex,因为 DeepSeek 脚本要求 ~/.codex 目录已存在。用 codex --version 查看版本;当前官方目录声明的最低客户端版本为 0.144.0,不表示必须恰好安装这一版。

macOS 或 Linux 用户可先下载官方脚本,阅读后再运行:

curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh \
  -o /tmp/codex-deepseek-setup-en.sh
less /tmp/codex-deepseek-setup-en.sh
bash /tmp/codex-deepseek-setup-en.sh

选择菜单选项 1,即 deepseek-flash,并提供 DeepSeek 平台的 API Key。文档中的脚本会把 config.toml 备份到 ~/.codex/backup-deepseek/,写入模型目录并调整必要的供应商设置。开始工作前,核对脚本报告的修改。官方指南也提供 Windows PowerShell 脚本。

此前已经装过 DeepSeek 配置时,重新运行当前脚本可更新旧 Flash 条目。选项 2 对应 V4 Pro,它另有 9 月 14 日切换安排;新配 V4.1 应明确选择 Flash。

手动配置必须保留完整目录

模型目录不只是名称列表,还声明上下文、推理档位、输入模态和工具行为。打开官方指南的手动配置部分,把完整 models.json 内容复制到 ~/.codex/models.json,不要用自行拼写的小段 JSON 替代。

然后把官方供应商配置合并到 ~/.codex/config.toml,保留无关设置。以下表格列出需要核对的关键值,不能替代完整配置文件:

字段文档中的值
modeldeepseek-flash
model_providerdeepseek
model_catalog_json~/.codex/models.json
model_reasoning_efforthigh
供应商 base_urlhttps://api.deepseek.com/
供应商 wire_apiresponses

完整示例还设置 API 认证、关闭内置网页搜索,并把 Key 放在 experimental_bearer_token 中。配置文件及其备份都包含凭据,不要提交到共享仓库。换成 Chat Completions 端点,或只写模型名称的 JSON,都不能复现这套官方配置。

核对模型,再验证实际任务

在小型测试项目中运行 codex。DeepSeek 指南将 CLI 启动信息中的 model: deepseek-flash 作为配置检查项。发任务前先处理配置错误;JSON 语法、目录位置和供应商选择是不同的故障点。

接着选一个范围明确、结果可验收的编程任务:先解释一个文件,再做小修改并运行相关测试。检查 diff 和测试结果。如果需要图片输入,加入一张代表性截图。模型选中成功,不代表你当前环境的工具和图片输入兼容性已全部验证。

当前 Flash 价格规划这次测试预算。Anthropic 协议接入另见 Claude Code 教程

考虑使用 Ofox 时,先查模型目录、准确 ID 和 Responses 支持情况。这份直连配置不能证明 Ofox 路由、价格或可用性。

常见问题

Codex 调用 DeepSeek V4.1 Flash 用什么协议?
DeepSeek 的 Codex 接入使用 Responses API,wire_api 设为 responses。官方供应商 Base URL 为 https://api.deepseek.com/,模型 ID 为 deepseek-flash。
只改 Codex 模型名称就够了吗?
不够。官方配置还包括供应商、认证和完整 models.json 目录。应使用官方脚本或完整手动配置,不要自行缩减目录。
本文确认过付费 Codex 会话能成功吗?
没有。本文核对的是 2026 年 9 月 10 日官方文档配置;仍需在自己的环境验证认证、模型选择和代表性编程任务。