注册
ChatGPT

Codex 接入第三方模型：DeepSeek、Gemini、Grok 能不能接，怎么配置自定义模型提供方（官方配置总览）

Codex 能接 DeepSeek、Gemini、Grok 吗？按 Codex 官方配置文档，自定义提供方在 config.toml 里配置，协议只支持 Responses。本文对照三家官方 API 文档，说明哪家协议对得上、哪家文档没写，并给出配置步骤和示例。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-10-25 · 依据官方文档与公开资料整理 Plus 账号
本文根据 OpenAI Codex 的配置文档（Advanced Configuration、Configuration Reference、Sample Configuration）和 xAI、DeepSeek、Google 的官方 API 文档整理，资料核对于 2026-10-25。本文不讲转接、中转或绕过，只讲 Codex 官方支持的「自定义模型提供方」配置，以及三家官方文档里写了什么。Codex 本身的入门见 /guides/codex-getting-started。

适用于谁

  • 在用 Codex，想知道能不能换成 DeepSeek、Gemini 或 Grok 的人；
  • 搜「Codex 接入第三方模型」「codex 怎么接 deepseek」的人；
  • 想弄懂 model_providers、wire_api 这些配置项的人。

结论先说

  1. Codex 官方支持自定义模型提供方：在 ~/.codex/config.toml 里写 [model_providers.<id>]，再用 model_provider 指向它。官方示例里有 Mistral、本地 Ollama、LLM 代理、Azure 等。
  2. 关键限制：协议。 官方参考文档写得很明确：wire_api 只支持 responses（省略时默认也是它）。也就是说，对方必须提供 OpenAI 的 Responses API 接口。
  3. 三家对照（2026-10 查询）：
  • Grok（xAI）：官方文档把 Responses API 列为推荐方式，Chat Completions 标为旧接口，协议上对得上；
  • DeepSeek：官方文档写的是 OpenAI 格式的 chat/completions 和 Anthropic 格式，没有提到 Responses；官方的「Agent 工具集成」指南列的是 Claude Code、GitHub Copilot、OpenCode，没有 Codex；
  • Gemini：官方 OpenAI 兼容页只写了 chat/completions，没有提到 Responses。
  1. 「文档没写」不等于「一定不行」，但也不能当成「能用」。本站只写官方写了的。
  2. 用 Codex 最稳妥的方式仍然是官方模型：Plus 在价格页上有 Codex 扩展用量，可以看 /chongzhi/chatgpt-plus；用量说明见 /guides/codex-usage-limits。

Codex 接第三方模型：Codex 要求 responses 协议，xAI、DeepSeek、Gemini 官方文档写的接口对照

图：本站根据 Codex 配置参考 与 xAI、DeepSeek、Google 官方 API 文档整理的示意图

一、Codex 官方怎么配置自定义提供方

Codex 添加自定义模型提供方的 4 步：打开 config.toml、新增 model_providers、指向 model_provider、环境变量放 Key

图：本站根据 Codex Advanced Configuration 整理的示意图

官方说明：一个模型提供方定义了 Codex 怎么连接模型，包括 base URL、协议、认证和可选的 HTTP 头。自定义提供方不能使用保留的内置 ID：openai、ollama、lmstudio。

官方示例（节选自 Advanced Configuration）：

toml
model = "gpt-6.1-sol"
model_provider = "proxy"

[model_providers.mistral]
name = "Mistral"
base_url = "https://api.mistral.ai/v1"
env_key = "MISTRAL_API_KEY"

几个常用配置项（来自官方 Configuration Reference）：

配置项含义
name提供方的显示名
base_url提供方的 API 基础地址
env_key存放 API Key 的环境变量名
wire_api协议，只支持 responses
http_headers / env_http_headers额外的请求头
query_params追加到请求里的查询参数
request_max_retriesHTTP 请求重试次数，默认 4

官方还提醒：直接把密钥写进配置文件（experimental_bearer_token）不推荐，请用 env_key；项目目录下的 .codex/config.toml 不能覆盖提供方、认证这类机器本地的设置，只有被信任的项目才会加载项目配置。

二、Grok：协议对得上，官方没有 Codex 教程

xAI 官方文本生成文档写：Responses API 是与模型交互的首选方式，OpenAI SDK 的用法是 base_url="https://api.x.ai/v1"，调用 client.responses.create(...)，示例模型名是 grok-4.7；Chat Completions 被标为旧接口（Legacy）。文档还特别说明：Responses API 默认会把对话保存在 xAI 服务器上 30 天，可以按文档说明关闭。

按 Codex 官方示例的格式，把 xAI 官方文档里的地址套进去，大致是这样（这是按两边官方格式拼出来的示例，不是官方原文，也没有逐项验证）：

toml
model = "grok-4.7"
model_provider = "xai"

[model_providers.xai]
name = "xAI"
base_url = "https://api.x.ai/v1"
env_key = "XAI_API_KEY"
wire_api = "responses"

Grok 本身的订阅和使用见本站相关文章；需要 Grok 订阅可看 /chongzhi/grok-super。注意：xAI 的 API 和 Grok 订阅是两回事，API 单独计费。

三、DeepSeek：文档里没有 Responses

DeepSeek 官方首页文档的「第一次调用」写：API 兼容 OpenAI 和 Anthropic 格式，OpenAI 格式的地址是 https://api.deepseek.com，模型名有 deepseek-flash、deepseek-v4-pro，示例调用的是 chat/completions。「Integrate with Agent Tools」一节写，DeepSeek 可作为 Claude Code、GitHub Copilot、OpenCode 等工具的后端。页面没有提到 Responses API，也没有 Codex。

所以，按 Codex「只支持 responses」的要求，官方文档并没有给出 DeepSeek 直接接 Codex 的方式。要在 Codex 里用 DeepSeek，需要先看 DeepSeek 官方有没有新增 Responses 接口；没有的话，不建议用来路不明的转换工具，密钥会经过第三方。

四、Gemini：OpenAI 兼容页只写了 chat/completions

Google 官方「OpenAI compatibility」页面给出的 base_url 是 https://generativelanguage.googleapis.com/v1beta/openai/，示例调用的都是 chat/completions，没有提到 Responses。和 DeepSeek 同理：官方文档没写，就不能说 Codex 能直接接 Gemini。 Gemini 自己的命令行工具见本站 Gemini 相关教程。

五、更稳妥的几种做法

常见问题

Q：为什么 Codex 只认 Responses？

官方文档没有解释原因，只写明 wire_api 唯一支持的值是 responses。

Q：配置写好了，Codex 里没出现我的模型？

官方有 model_catalog_url 配置项（指向 Codex 原生的模型目录），不设置则沿用提供方默认的模型发现方式；具体行为以官方文档为准。

Q：API Key 要放在哪里？

用 env_key 指向环境变量，把密钥放在环境变量里，不要写进配置文件，更不要提交到代码仓库。

Q：用第三方模型，Codex 的 ChatGPT 额度还会消耗吗？

本文查到的 Codex 配置文档没有写这一点。第三方提供方按它自己的 API 规则计费，Codex 额度的计算以官方 Codex 用量文章为准。

参考资料

  • OpenAI Codex 文档：Advanced Configuration — https://developers.openai.com/codex/config-advanced
  • OpenAI Codex 文档：Configuration Reference — https://developers.openai.com/codex/config-reference
  • OpenAI Codex 文档：Sample Configuration — https://developers.openai.com/codex/config-sample
  • xAI 文档：Generate Text — https://docs.x.ai/docs/guides/chat
  • DeepSeek API 文档：Your First API Call — https://api-docs.deepseek.com/
  • Google AI 文档：OpenAI compatibility — https://ai.google.dev/gemini-api/docs/openai
需要开通或续费？ChatGPT Plus 充值 →

Nathaniel 的更多内容

  1. 01

    Claude 登录报错对照（账号被停用以外）：There was an error logging you in、收不到登录邮件、验证码、Google 登录的处理

    Claude 登录不上，除了账号被停用，还有登录出错、收不到登录邮件、在另一台设备点链接、想设密码、Google 登录异常等情况。本文按官方登录帮助整理各提示的原文和处理，账号被停用另见专门文章。

    Claude0
  2. 02

    Claude 提示「Something went wrong」怎么办：限额、消息过长、容量紧张、登录出错的官方报错对照

    Claude 报 Something went wrong 或别的错误？官方《Troubleshoot Claude error messages》把常见错误分成限额、消息过长、登录出错、容量紧张四类，并给了各自的原文和处理。本文逐项整理，并说明官方没有单独解释笼统的出错提示。

    Claude0
  3. 03

    DeepSeek 除了「服务器繁忙」还有哪些报错：网页版提示对照和 API 错误码 400、401、402、422、429、500、503

    DeepSeek 报错不只有服务器繁忙。本文把官方常见问题里的网页版提示（上传失败、运行环境异常、账号停用、邮箱域名不支持）和 API 错误码汇成对照表，给出官方的原因和处理，并链到各篇详细文章。

    其他 AI 工具0
  4. 04

    Gemini 提示「此账号无法使用」（Can't access this service）怎么办：账号类型、年龄、Family Link 与工作学校账号的官方条件

    Gemini 提示 Can't access this service，意思是这个账号目前不符合使用条件。官方写明了可用的账号类型、年龄要求和 Family Link 账号不能用。本文按账号类型对照，并给出 Something went wrong 的处理。

    Gemini0
  5. 05

    Gemini Pro 免费试用、学生优惠到期后怎么办：自动转付费、重新验证 SheerID、取消后会失去什么

    Google AI Pro 学生优惠或试用到期后会怎样？官方说会自动转为正常付费的 Plus 或 Pro，会提前通知；没有按时重新验证 SheerID 会失去优惠。本文按官方帮助中心整理到期规则、取消后失去的内容和第三方订阅的处理。

    Gemini0
  6. 06

    Gemini 怎么切换模型：Flash-Lite、Flash、Pro、Argon 的选择步骤、思考等级和自动选择

    Gemini 网页版怎么手动切换模型？官方步骤是点聊天框底部当前模型再选，需要有 Google AI 方案，带锁图标的要升级。本文按官方说明整理各方案可选模型、思考等级默认值和自动模型选择。

    Gemini0

同产品的其他教程

  1. 01

    Codex 常见报错总表：429、401、登录失败、连接中断、缺少环境变量、沙箱、Computer Use、远程控制，看到哪条读哪篇

    把 Codex 最常见的报错和问题汇成一张对照表：429、401、Token exchange failed、stream disconnected、missing environment variable、Windows 沙箱失败、Computer Use 找不到、远程控制连不上，各给一句处理方向并链到详细文章。

    ChatGPTCodex0
  2. 02

    Codex 插件在哪装：桌面 App 的 Plugins 标签、CLI 的 /plugins、IDE 为什么没有，以及插件和技能、MCP 的区别

    Codex 的插件在 ChatGPT 桌面 App 的 Plugins 标签里装，命令行输入 /plugins，IDE 插件不支持。本文按官方文档讲各入口怎么装、装完怎么用、用 API 密钥登录时有什么限制，以及插件、技能、MCP 服务器的区别。

    ChatGPTCodex0
  3. 03

    Codex Windows 版怎么下载安装：ChatGPT 桌面 App 官方入口、winget 命令、开发工具与 WSL 设置

    Windows 上的 Codex 现在是 ChatGPT 桌面 App 里的一个入口。官方给了微软商店下载地址和 winget 安装命令，原生用 PowerShell 加 Windows 沙箱，也可切到 WSL2。本文按官方文档讲安装、登录、建议装的开发工具、管理员运行和常见小问题。

    ChatGPTCodex0
  4. 04

    Codex 远程控制授权失败怎么办、远程 SSH 怎么用：手机配对电脑、Remote Control、连接 SSH 主机的官方步骤

    用手机远程控制电脑上的 Codex，配对不成功或授权失败？官方 Remote connections 文档写了配对步骤和五类常见问题，也讲了怎么把桌面 App 连到 SSH 主机、怎么在主机之间交接对话。本文按官方文档整理，并给出一张排查对照图。

    ChatGPTCodex0
  5. 05

    Codex 沙箱初始化失败怎么办（Windows）：沙箱设置失败、错误 1385、Everyone 可写警告与 MXC、elevated、unelevated 怎么选

    Windows 上 Codex 沙箱设置失败、命令跑不起来、提示错误 1385 或 Everyone 可写？官方文档列了常见原因和处理，本文逐项整理，并说明 mxc、elevated、unelevated 三种实现的区别。

    ChatGPTCodex0
  6. 06

    Codex 找不到 Computer Use 怎么办：插件在哪装、地区限制、macOS 权限与 Windows 前台运行说明

    ChatGPT 桌面 App 的 Computer Use 能让 Codex 看屏幕、点鼠标、操作桌面应用，但官方写明它只在支持的地区可用，需要装 Computer Use 插件并开启开关。本文按官方文档讲插件在哪装、macOS 要给哪两个权限、Windows 为什么会占用前台，以及找不到时的排查。

    ChatGPTCodex0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～