DeepSeek API 接入 Codex 指南:手把手把 DeepSeek V4 装进 Codex

最近 Codex 的可玩性越来越高了。
很多人第一次使用 Codex,默认会直接登录 ChatGPT 账号,然后使用 OpenAI 提供的模型。
但实际上,Codex 并不只能调用 OpenAI 模型。
只要模型服务支持 Codex 所需要的 API 协议,我们完全可以把第三方模型接进 Codex。
比如:
DeepSeek。
而且现在这个方案已经不是以前那种“套一层代理”“自己做协议转换”的玩法了。
截至 2026 年 8 月,DeepSeek API 已经原生支持 OpenAI Responses API,并针对 Codex 做了适配。DeepSeek V4 Pro 在 2026 年 8 月 13 日更新后,也正式加入了 Responses API 支持。
也就是说,现在我们可以直接实现:
Codex
↓
Responses API
↓
DeepSeek API
↓
DeepSeek V4
整个过程不需要自己写转发程序。
这篇文章,我们就从零开始配置。
一、为什么要把 DeepSeek 接入 Codex?
首先需要明确一件事情:
Codex 和模型其实是两层东西。
你可以简单理解成:
Codex = AI 编程 Agent
模型 = Codex 背后的大脑
Codex 负责:
- 读取项目
- 搜索代码
- 修改文件
- 执行 Shell 命令
- 调用工具
- 分析 Git
- 自动 Debug
- 完成多步骤开发任务
而真正负责理解代码、推理和生成内容的,是后面的模型。
默认情况下,大部分人使用的是:
Codex
↓
OpenAI
↓
GPT 系列模型
但如果把模型供应商换掉,就可以变成:
Codex
↓
DeepSeek
↓
DeepSeek V4
这样最大的好处就是:
保留 Codex 这套 Agent 工作流,同时使用 DeepSeek 的模型能力。
二、目前 DeepSeek 有哪些模型可以用?
目前 DeepSeek API 主要提供两个 V4 模型:
| 模型 | 定位 |
|---|---|
deepseek-v4-flash |
速度快、价格低,适合日常 Coding |
deepseek-v4-pro |
能力更强,适合复杂 Agent 和代码任务 |
根据 DeepSeek 当前官方文档,两款模型都已经支持 Tool Calls 和 Responses API。
它们的上下文长度目前都达到了:
1M Context
最大输出可以达到:
384K Tokens
对于大型代码仓库、长上下文 Agent 和复杂项目分析来说,这个规格已经比较夸张了。
如果你只是平时写代码,我更建议:
deepseek-v4-flash
如果是:
- 大型项目
- 复杂 Bug
- 项目重构
- Agent 自动开发
- 多步骤任务
- 大规模代码分析
则可以尝试:
deepseek-v4-pro
三、第一步:安装 Codex
如果你还没有 Codex,可以先安装。
Codex 官方目前支持多种安装方式,包括独立安装脚本、npm 和 Homebrew。
我个人更推荐 npm:
npm install -g @openai/codex
安装完成以后执行:
codex --version
如果能够正常显示版本号,说明安装成功。
然后测试:
codex
如果能够进入 Codex 界面,就说明 Codex 本身没有问题。
四、第二步:获取 DeepSeek API Key
接下来需要准备 DeepSeek API Key。
这里需要注意:
DeepSeek 网页版账号和 DeepSeek API 是两套计费体系。
我们这里使用的是:
DeepSeek API
而不是直接使用网页版会员。
进入 DeepSeek 开放平台后创建一个 API Key。
一般格式类似:
sk-xxxxxxxxxxxxxxxx
拿到以后先保存好。
千万不要:
上传到 GitHub
提交到公开仓库
写进前端代码
发到公开截图里
因为别人拿到这个 Key 以后,就可以直接消耗你的 API 余额。
五、第三步:找到 Codex 配置文件
Codex 的核心配置文件叫:
config.toml
默认目录位于:
~/.codex/config.toml
在 macOS / Linux 中可以执行:
cd ~/.codex
然后:
ls
通常可以看到:
config.toml
auth.json
sessions
...
如果没有 config.toml,自己创建一个即可:
touch ~/.codex/config.toml
使用 VS Code 打开:
code ~/.codex/config.toml
或者直接:
vim ~/.codex/config.toml
六、第四步:配置 DeepSeek Provider
接下来就是最关键的一步。
打开:
~/.codex/config.toml
加入 DeepSeek Provider。
例如使用 DeepSeek V4 Pro:
model = "deepseek-v4-pro"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "sk-你的DeepSeekAPIKey"
例如:
model = "deepseek-v4-pro"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "sk-xxxxxxxxxxxxxxxx"
这里最重要的其实只有几个参数。
model
model = "deepseek-v4-pro"
指定 Codex 使用哪个模型。
如果想使用 Flash:
model = "deepseek-v4-flash"
model_provider
model_provider = "deepseek"
告诉 Codex:
不要使用默认 OpenAI Provider。
而是使用下面定义的:
[model_providers.deepseek]
base_url
base_url = "https://api.deepseek.com/"
这是 DeepSeek API 地址。
DeepSeek 官方 OpenAI 兼容 API 当前就是这个地址。
wire_api
这一行非常关键:
wire_api = "responses"
Codex 现在大量 Agent 能力建立在:
Responses API
上。
以前很多第三方模型接不了 Codex,一个非常重要的原因就是:
只支持 /chat/completions
而 Codex 需要:
/responses
于是以前经常需要:
Codex
↓
Responses Proxy
↓
Chat Completions
↓
第三方模型
现在 DeepSeek 已经原生支持 Responses API,所以不需要再加这一层转换。DeepSeek 官方也明确表示 Responses API 是为包括 Codex 在内的 Agent 场景增加的。
因此直接:
wire_api = "responses"
即可。
七、使用 Flash 还是 Pro?
如果你的主要需求是日常开发,我建议先这样:
model = "deepseek-v4-flash"
完整配置:
model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "sk-xxxxxxxxxxxxxxxx"
如果发现任务比较复杂,再切换:
model = "deepseek-v4-pro"
我一般会把它们理解成:
Flash
↓
日常 Coding
写接口
写页面
改 Bug
写脚本
简单项目
而 Pro 更适合:
Pro
↓
复杂 Debug
大型项目
架构分析
项目重构
长时间 Agent
复杂工具调用
八、第五步:启动 Codex
配置完成以后,进入一个代码项目。
例如:
cd my-project
执行:
codex
如果配置生效,Codex 启动以后应该可以看到当前模型已经变成类似:
deepseek-v4-pro
或者:
deepseek-v4-flash
这意味着:
Codex Agent
+
DeepSeek V4
已经跑起来了。
九、接下来可以做什么?
这时候就不只是简单聊天了。
比如进入一个项目:
cd my-next-project
codex
然后直接告诉它:
分析一下这个项目的目录结构,并告诉我这个项目是干什么的。
Codex 会开始读取整个项目。
你也可以继续:
找到这个项目的登录逻辑。
或者:
分析为什么用户登录以后 Token 没有正确刷新。
再进一步:
找到问题并直接修改代码。
甚至:
运行项目,检查报错,修复问题并重新测试。
这才是 Codex 真正有意思的地方。
模型并不是单纯给你回答代码。
而是进入:
读取代码
↓
分析项目
↓
修改文件
↓
执行命令
↓
查看结果
↓
继续修改
↓
完成任务
这样的 Agent Loop。
十、测试一个真实项目
比如我们创建一个简单项目:
mkdir codex-deepseek-demo
cd codex-deepseek-demo
初始化:
npm init -y
然后启动:
codex
直接告诉 Codex:
使用 Node.js 给我创建一个简单的 Todo API。
要求:
1. 使用 Express
2. 提供新增 Todo 接口
3. 提供删除 Todo 接口
4. 提供查询 Todo 接口
5. 自动安装需要的依赖
6. 创建完成后运行项目
接下来你会看到 DeepSeek 通过 Codex 开始:
分析任务
↓
创建文件
↓
编写代码
↓
安装 npm 依赖
↓
启动项目
↓
检查运行结果
这就已经不是我们以前那种:
复制代码
↓
粘贴代码
↓
发现报错
↓
复制报错
↓
再问 AI
的工作流了。
而是:
你提出目标
↓
Codex + DeepSeek 自己执行
十一、如何确认请求真的走的是 DeepSeek?
最简单的办法就是看 Codex 当前模型。
启动:
codex
确认显示:
deepseek-v4-flash
或者:
deepseek-v4-pro
另外还可以进入 DeepSeek API 控制台查看:
API 请求量
Token 消耗
账户余额
如果运行 Codex 之后出现新的 Token 消耗,基本就可以确定:
Codex → DeepSeek API
已经正常工作。
十二、常见问题一:401 Unauthorized
如果出现:
401 Unauthorized
首先检查:
experimental_bearer_token
是否填写正确。
例如:
experimental_bearer_token = "sk-xxxxxxxx"
同时检查:
API Key 是否失效
API Key 是否复制完整
DeepSeek API 账户是否正常
尤其不要把:
sk-xxxx
前后多复制空格。
十三、常见问题二:404
如果出现:
404 Not Found
重点检查:
base_url
当前 DeepSeek 官方地址为:
base_url = "https://api.deepseek.com/"
另外还要检查:
wire_api = "responses"
不要随便把 Codex 的请求协议改成:
wire_api = "chat"
否则 Codex 与上游模型之间的请求方式可能发生变化。
十四、常见问题三:Model Not Found
例如出现:
model not found
检查模型名称。
现在应该使用:
deepseek-v4-flash
或者:
deepseek-v4-pro
而以前常见的:
deepseek-chat
deepseek-reasoner
已经属于旧模型命名。
DeepSeek 在 2026 年 4 月发布 V4 后就已经宣布逐步停止这两个旧模型名称,并转向 V4 Flash / V4 Pro。
所以现在写教程,不建议再继续使用:
deepseek-chat
这种老配置。
十五、常见问题四:为什么网上有教程说只有 Flash 能接 Codex?
这个问题特别值得说一下。
因为 DeepSeek 早期刚接入 Codex 时:
Responses API
确实只有:
deepseek-v4-flash
支持。
所以网上不少早期教程都会告诉你:
Codex 只能使用 deepseek-v4-flash
但这个信息已经发生变化。
2026 年 8 月 13 日,DeepSeek V4 Pro 正式更新,并增加了原生 Responses API 支持和针对 Codex 的适配。
目前最新模型文档也已经把:
deepseek-v4-flash
deepseek-v4-pro
两款模型的 Responses API 都标记为支持。
所以现在:
Flash → 可以
Pro → 也可以
如果你看到旧文章说 Pro 不支持,注意看一下教程发布时间。
十六、ChatGPT Codex 和 DeepSeek Codex 有什么区别?
这里还需要注意一个概念。
我们没有“安装一个 DeepSeek 版 Codex”。
Codex 本身还是:
OpenAI Codex
只是把底层模型 Provider 换成了:
DeepSeek
所以整个架构其实是:
┌── OpenAI GPT
│
Codex Agent ─────┼── DeepSeek V4
│
├── 本地模型
│
└── 其他 Responses API
这也是我觉得 Codex 接下来非常有意思的一点。
Agent Harness 和模型正在逐渐分离。
以前我们会说:
我在用 GPT。
以后更可能变成:
我在使用 Codex,但是底层跑的是 DeepSeek。
甚至针对不同任务使用不同模型。
十七、最终配置总结
如果你不想看前面的内容,只想直接配置,可以参考下面这一份。
DeepSeek V4 Flash
model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "sk-你的APIKey"
然后:
codex
即可。
DeepSeek V4 Pro
只需要把:
model = "deepseek-v4-flash"
修改成:
model = "deepseek-v4-pro"
完整配置:
model = "deepseek-v4-pro"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "sk-你的APIKey"
重新启动:
codex
即可。
十八、最后
我觉得 DeepSeek 接入 Codex 这件事情,真正值得关注的,并不是:
“Codex 又多了一个模型。”
而是另外一个趋势:
Agent 和模型正在解耦。
Codex 可以负责:
代码理解
文件操作
Shell
Git
工具调用
任务规划
Agent Loop
而模型只需要负责最核心的:
理解
推理
决策
生成
这意味着以后我们使用 AI 编程工具,很可能不会再纠结:
到底用哪个 AI IDE?
而会变成:
我喜欢哪套 Agent Harness?
+
我想给它接哪个模型?
Codex + GPT 是一种组合。
Codex + DeepSeek 同样也是一种组合。
甚至以后还会出现:
Codex + 本地模型
Codex + 国产模型
Codex + 自研模型
Codex + 企业内部模型
当模型能够通过统一协议接入 Agent Harness 后,整个 AI Coding 的玩法就完全不一样了。
而现在 DeepSeek 原生支持 Responses API,其实就是在向这个方向继续推进。
如果你本身已经在使用 Codex,又想测试一下 DeepSeek V4 的 Coding 和 Agent 能力,那么现在已经可以直接把它接进去跑了。

更多推荐



所有评论(0)