Codex CLI 官方支持自定义模型提供商,可接入 DeepSeek。最省事的做法是用 DeepSeek 官方一键脚本,也可手动改 config.toml;接入后按 DeepSeek API 计费,不再消耗 ChatGPT 订阅额度,也无需开通 Plus/Pro。 Codex能接DeepSeek吗:官方已支持第三方模型
可以。据 OpenAI 官方 Codex 配置文档,CLI 的 config.toml 提供 model_providers 机制,允许把请求指向任何兼容 OpenAI Responses API 的端点。官方示例明确写到,只要模型服务兼容对应线协议,"就能用 Codex CLI 跑非 OpenAI 模型",并举例 Ollama、Mistral 等第三方提供商。
- DeepSeek 官方也提供了接入方案:在其 CDN 上发布了面向 Codex 的一键配置脚本,会自动写好提供商与模型目录。
- 接入范围:配置写在用户级 ~/.codex/config.toml,Codex 的 CLI、桌面 App、IDE 扩展共用同一份配置,通常一次配置多处生效。
- 不消耗订阅额度:走 DeepSeek API Key 计费,与 ChatGPT/Codex 的 5 小时窗口、周上限无关,也不会触发上一篇文章讲的"用量达到上限"。
Codex接DeepSeek一键配置:官方脚本怎么跑
这是最推荐的方式,脚本会备份原配置、写入提供商块与模型目录、并在写入前做 TOML 校验(失败不修改原文件)。运行前请确保已安装 Codex CLI 或 ChatGPT 桌面端,并至少启动过一次(即 ~/.codex 目录已存在)。
- 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;
- 按菜单选择要使用的模型(如输入对应序号),首次运行会提示粘贴以 sk- 开头的 DeepSeek API Key;
- 脚本会自动完成:备份 config.toml、写入 ~/.codex/models.json 模型元数据、追加 [model_providers.deepseek] 配置段,并保留你原有的 MCP、项目信任等设置;
- 重新启动 Codex,进入会话后输入 /status 确认模型与 base_url 已指向 DeepSeek。
Codex接DeepSeek支持哪些模型
DeepSeek 官方脚本当前提供的模型随平台更新,运行脚本时菜单会列出可选项。以下为脚本中出现的模型标识示例,具体以 DeepSeek 平台与脚本菜单当前可用项为准:
模型的具体上下文窗口、支持的推理强度档位与工具调用格式,由脚本写入的 models.json 向 Codex 声明,使 DeepSeek 模型能像内置模型一样被调用。
Codex手动接DeepSeek:config.toml怎么写
若不想跑脚本,可手动编辑 ~/.codex/config.toml。以下为官方脚本写入的等效配置(已核实):
- 在文件顶部设置 model、model_provider = "deepseek"、model_catalog_json = "~/.codex/models.json";
- 追加提供商块:[model_providers.deepseek],其中 name = "deepseek"、base_url = "https://api.deepseek.com/"、wire_api = "responses"、experimental_bearer_token = "你的DeepSeek API Key";
- 必须同时准备 models.json:仅改 config.toml 不够,还需一份声明 DeepSeek 模型元数据(上下文长度、推理档位、工具格式)的模型目录,否则 Codex 不认识该模型;脚本正是自动生成这一文件。
注意:2026 年新版 Codex 已改用 Responses API,第三方提供商必须写 wire_api = "responses";旧博客里的 wire_api = "chat" 与带 /v1 的 base_url 写法均已失效,会导致无法启动或 404。
Codex接DeepSeek注意事项
- 先审阅再执行:一键脚本来自 DeepSeek 官方 CDN(cdn.deepseek.com),会备份并校验配置;习惯上建议先 curl 下来审阅再执行,不要把 API Key 泄露给任何人。
- API Key 安全:脚本将 Key 写入 config.toml 的 experimental_bearer_token,属明文存储,注意文件权限,避免提交到代码仓库。
- 不消耗 OpenAI 额度:接 DeepSeek 后按 DeepSeek 官方 API 费率以 token 计费,与 ChatGPT 订阅额度无关;价格因模型与用量而异,以 DeepSeek 平台为准。
- web_search 可能被禁用:官方脚本会将 web_search 设为 disabled,因为该能力依赖 OpenAI 侧工具,第三方模型下通常不可用。
Codex接DeepSeek报错与排查
| | |
|---|
报 wire_api = "chat" is no longer supported | 新版 Codex 仅支持 Responses API | 把 chat 改为 responses,并确认 base_url 正确 |
unexpected status 401 Unauthorized | | 确认 experimental_bearer_token 已正确写入,重跑脚本粘贴完整 Key |
unexpected status 404 Not Found | | base_url 用 https://api.deepseek.com/,wire_api 用 responses |
| 本地残留 ChatGPT 登录态覆盖了 provider | 执行 codex logout,再确认 model_provider 指向 deepseek |
最权威的验证方式是在 Codex 会话中输入 /status,确认 model 显示为 DeepSeek 模型、base_url 指向 api.deepseek.com;能正常对话即说明路由成功。
Codex接DeepSeek常见问题
Q:Codex 接 DeepSeek 要开 ChatGPT 订阅吗? A:不需要。用 DeepSeek provider 走 API Key 计费,不消耗 ChatGPT/Codex 订阅额度,也没必要开通 Plus/Pro。
Q:Codex 能接 DeepSeek 吗,官方支持吗? A:支持。Codex CLI 官方的 model_providers 机制可指向任意兼容 OpenAI Responses API 的端点,DeepSeek 也发布了官方一键接入脚本。
Q:一键脚本在哪里跑? A: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。运行前先装好 Codex CLI 并至少启动过一次。
Q:支持哪些 DeepSeek 模型? A:脚本当前提供 deepseek-flash 与 deepseek-v4-pro 等(含 V4 系列),运行脚本时按菜单选择,具体以 DeepSeek 平台当前可用模型为准。
Q:配置后怎么验证接成功了? A:启动 Codex 进入会话,输入 /status,确认 model 显示为 DeepSeek 模型、base_url 指向 api.deepseek.com 即可。
Q:报错 wire_api = "chat" is no longer supported 怎么办? A:新版 Codex 已改用 Responses API,第三方 provider 必须写 wire_api = "responses";把 chat 改成 responses 即可,旧博客的 chat 写法已失效。
Q:配置后 Codex 还是跳回 ChatGPT 登录怎么办? A:清掉本地 ChatGPT 登录态再试:执行 codex logout,并确保 config.toml 里 model_provider 指向 deepseek、API Key 已正确写入。
Q:一键脚本安全吗? A:脚本来自 DeepSeek 官方 CDN,会先备份 config.toml、写入前做 TOML 校验、失败不修改原文件;建议先 curl 下来审阅再执行,不要把 API Key 泄露给他人。
Q:接 DeepSeek 后费用怎么算? A:不再走 OpenAI 订阅额度,按 DeepSeek 官方 API 费率以 token 计费,价格因模型与用量而异,以 DeepSeek 平台价格页为准。
以上内容参考 OpenAI 官方 Codex 配置文档与 DeepSeek 官方 Codex 接入脚本整理。命令、URL、模型标识与配置字段可能随官方更新而变动,请以 OpenAI 与 DeepSeek 官方文档最新公布为准。