用 DeepSeek 的高性价比模型替换 Codex 默认的 OpenAI 模型,开发成本直降,杜绝漫天要价,也不怕随意卡限。

引言

2026 年 7 月 31 日,DeepSeek 官方宣布 V4-Flash 正式支持 OpenAI 的 Responses API 格式,并针对性适配了 Codex,不需要第三方转接,就可以直接在ChatGPT里调用DeepSeek V4 Flash API。

对于开发者来说,这无疑是一个令人振奋的消息——你可以继续享受 Codex 强大的 AI 编程体验,同时使用 DeepSeek 更具性价比的模型,不必再为高昂的 API 费用发愁。

在这里插入图片描述
本文将引导你完成 Codex 的安装与 DeepSeek V4 Flash 的配置。

一、什么是 Codex?

Codex 是 OpenAI 推出的 AI 编程助手,2026 年初 OpenAI 将 Codex 拆分为四个入口:网页版、桌面 App、CLI(命令行工具)、IDE 扩展。无论你使用哪个客户端形态,它们都共用同一份配置文件。

Codex 通过 Responses API 与模型交互,这是 OpenAI 为智能体工作负载设计的统一接口,支持推理项、内置工具和语义流式事件。

二、前置准备

开始之前,请确保你已准备好以下条件:

1. 安装 Codex 客户端

根据你的使用场景,选择以下任一方式安装 Codex:

Codex CLI(命令行版)

macOS / Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

ChatGPT 桌面端:直接从 OpenAI 官网下载安装包。访问 ChatGPT

在这里插入图片描述

VS Code 插件:在 VS Code 扩展市场中搜索 “Codex” 安装。

重要提示:安装完成后,请至少运行一次 Codex 客户端(完成初始化),确保 ~/.codex 配置目录已生成。

2. 获取 DeepSeek API Key

访问 DeepSeek Platform,注册或登录后创建一个 API Key(以 sk- 开头)并复制保存。

3. 了解模型支持情况

目前仅 deepseek-v4-flash 支持接入 Codex,deepseek-v4-pro 预计 2026 年 8 月初 支持。

三、配置 DeepSeek 为 Codex 模型提供方

DeepSeek 官方提供了两种配置方式,推荐使用一键脚本,全程自动化完成。

方式一:一键配置脚本(强烈推荐)

官方提供的一键配置脚本会自动完成全部配置。

macOS / Linux 用户:

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

Windows 用户(PowerShell):

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

运行后,脚本会:

  1. 提示你输入 DeepSeek API Key
  2. 提供菜单让你选择要使用的模型
  3. 自动完成以下工作:
步骤 说明
备份配置 ~/.codex/config.toml 备份到 ~/.codex/backup-deepseek/,随时可还原
写入模型目录 创建 ~/.codex/models.json,向 Codex 声明 DeepSeek 模型的元数据(上下文窗口、推理强度档位、工具调用格式等)
修改主配置 修改 ~/.codex/config.toml,新增 [model_providers.deepseek] 配置段,原有 MCP 服务器、项目信任级别等配置全部保留
校验 写入前校验配置文件语法合法性,校验失败则中止,不修改任何文件

再次运行脚本,可以在菜单中切换模型,或恢复到安装前的默认配置(菜单第 3 项)。

方式二:手动编辑配置文件

如果你偏好手动控制,也可以自行编辑配置文件。

第一步:创建 ~/.codex/models.json

向 Codex 声明 DeepSeek 模型的元数据。完整内容可参考 DeepSeek 官方文档,其中包含了 deepseek-v4-flashdeepseek-v4-pro 两个模型的完整定义。

关键参数包括:

  • context_window: 1048576(1M 上下文)
  • supports_parallel_tool_calls: true
  • input_modalities: [“text”]

第二步:修改 ~/.codex/config.toml

新增 [model_providers.deepseek] 配置段,将模型指向 DeepSeek API。

四、验证配置是否成功

配置完成后,可以通过以下方式验证:

  1. 启动 Codex CLI

    codex
    

    在对话中提问,观察模型响应是否正常。

  2. 检查 ChatGPT 桌面端
    完全退出(⌘Q)并重新打开 ChatGPT 桌面端,新建任务后查看模型下拉菜单是否出现 deepseek-v4-flash 选项。

在这里插入图片描述
跑了差不多一下午,花了大约 3180 万 Tokens,才¥1.59,命中缓存比例很高,性价比确实杠杠的!

在这里插入图片描述

  1. 检查 VS Code 插件
    在 Codex 插件中切换模型,选择 DeepSeek V4 Flash 进行测试。

五、兼容性说明

DeepSeek 对 Responses API 的实现非常完整:

✅ 支持的功能:

  • inputinstructions(字符串或 item-list 形式)
  • 流式响应(完整语义事件序列)
  • temperaturetop_pmax_output_tokenstop_logprobs
  • 工具调用(function 和 web_search 类型)
  • tool_choice(包括强制指定特定函数)
  • reasoning.effort(思考深度控制)

⚠️ 接受但不生效的参数:

  • reasoning.summary(接受但不会生成摘要)
  • text.verbosity
  • parallel_tool_calls(因为并行工具调用始终开启)

❌ 不支持(设计如此):

  • previous_response_idconversation(API 是无状态的,需自行管理对话历史)
  • store(始终返回 store: false
  • backgroundmetadataincludeservice_tier

好消息是:不支持的参数会被静默忽略而不是报错,所以现有的 Responses API 客户端可以直接使用。

六、常见问题与替代方案

Q1:一键脚本运行失败怎么办?

检查是否已安装 Codex 并至少运行过一次(~/.codex 目录是否存在)。如果问题依旧,可以尝试手动配置方式。

Q2:我是 Windows 用户,有没有更详细的教程?

社区有专门的 Windows 环境教程 codex-deepseek-guide,采用本地代理实现协议兼容,无需降级 Codex 版本。

Q3:我不想修改配置文件,有更简单的工具吗?

社区提供了多种工具:

  • DSCodex:约 40KB、零依赖的 Node 本地路由,把 DeepSeek V4 Flash 加进原版 ChatGPT 桌面端/Codex 的原生模型菜单,不改 App、不 fork Codex。GPT 模型照常走你的 OAuth 订阅。
  • CodexSwitch:本地透明代理,让 Codex 以为自己在和 OpenAI 通信,实际上请求被转发到 DeepSeek。打开开关用 DeepSeek,关闭开关恢复 OpenAI,全程不碰任何配置文件。
  • DeepCodex:轻量 Bridge,自动转换协议,填入 DeepSeek API Key 后基本开箱即用。

Q4:deepseek-v4-pro 什么时候支持?

根据官方公告,deepseek-v4-pro 预计 2026 年 8 月初 支持接入 Codex。

让我们拭目以待!

七、总结

将 DeepSeek V4 Flash 接入 Codex 的流程已经非常成熟,官方提供的一键配置脚本让整个过程变得异常简单——几分钟内即可完成配置

对于开发者而言,这意味着:

  • ✅ 继续使用 Codex 强大的 AI 编程体验
  • ✅ 享受 DeepSeek 的高性价比模型
  • ✅ 无需 fork 或修改 Codex 本体
  • ✅ GPT 模型与 DeepSeek 模型可以共存使用

还在犹豫什么?赶快去 DeepSeek Platform 获取 API Key,体验 Codex + DeepSeek V4 Flash 的高效编程之旅吧!


本文参考了 DeepSeek 官方 API 文档及社区相关教程。配置过程中如遇问题,可查阅 DeepSeek 官方文档 获取最新信息。

老徐,2026/8/1
Logo

AtomGit AI 社区提供模型库、数据集、Agent、Token等资源

更多推荐