註冊
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 條評論

登入 後參與評論

還沒有評論，來搶沙發～