註冊
CodexGemini

Gemini 怎麼接入 Codex：官方支持的是文檔 MCP 和技能，直接調用 Gemini 模型官方沒有這條路

Gemini 能接入 Codex 嗎？分兩種意思：讓 Codex 查 Gemini 官方文檔、用 Gemini 技能，官方明確支持（codex mcp add 即可）；讓 Codex 直接調用 Gemini 模型，官方文檔沒有這條路，原因是 Codex 只認 responses 協議。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-10-25 · 依據官方文檔與公開資料整理 其他 帳號
本文根據 Gemini API 官方「Coding agent setup」頁、Gemini OpenAI 兼容頁和 Codex 官方配置文檔整理，資料核對於 2026-10-25。官方沒有寫「Gemini 模型接入 Codex」的專門頁面，下文把能核對的和不能核對的分開寫。

適用於誰

  • 搜「gemini怎麼接入codex」的人；
  • 想讓 Codex 幫忙寫 Gemini API 代碼的開發者；
  • 想在 Codex 裏直接選 Gemini 模型的人。

結論先說

  1. 這個問題有兩種意思，答案不同。
  2. 讓 Codex 用上 Gemini 的資料：官方明確支持。Gemini API 官方「Coding agent setup」頁說，Gemini 文檔 MCP 伺服器在 Claude Code、Cursor、OpenAI Codex、VS Code 裏都可用，Codex 的加法是 codex mcp add geminiDocs --url <官方頁給出的地址>，或在 ~/.codex/config.toml 裏寫 [mcp_servers.geminiDocs]。
  3. 讓 Codex 直接調用 Gemini 模型：官方文檔裏沒有這條路。Codex 官方配置參考裏，自定義提供方的 wire_api 只有 responses 一種取值；而 Gemini 官方 OpenAI 兼容頁只寫了 chat/completions 等接口，沒有 responses。兩邊對不上，所以本文不提供「填什麼 base_url」的寫法。
  4. 想在終端裏用 Gemini 模型寫代碼：官方的產品是 Antigravity CLI，見 /guides/gemini-cli-how-to-use-antigravity-cli。
  5. 想用 Codex 官方模型：需要 ChatGPT 套餐，見 /chongzhi/chatgpt-plus。

「Gemini 接入 Codex」的幾種意思和官方做法

圖：本站根據 Gemini API Coding agent setup 與 Codex 配置文檔 整理的示意圖

一、官方支持的：給 Codex 加上 Gemini 文檔 MCP

官方 Coding agent setup 頁列出了幾種資源：

資源提供什麼可用環境（官方寫法）
Gemini Agent Skills針對具體功能的規則、SDK 寫法和輔助腳本，包括 gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api預裝在 AI Studio Build；可用 skills.sh、Context7 或託管智能體安裝
Gemini Docs MCP Server在線搜尋文檔（gemini_search_docs）和讀取整頁文檔（gemini_get_doc）Claude Code、Cursor、OpenAI Codex、VS Code
Gemini API Plugin官方技能、文檔 MCP 和 API Key 工具的合集Antigravity
機器可讀文檔乾淨的 Markdown 頁面和 llms.txt 索引ai.google.dev/gemini-api/docs 下的所有頁面

給 Codex 加文檔 MCP，官方給了兩種寫法：

給 Codex 加 Gemini 文檔 MCP 的步驟

圖：本站根據 Gemini API Coding agent setup 整理的示意圖

  1. 命令行：codex mcp add geminiDocs --url <官方頁給出的 MCP 地址>；
  2. 或編輯用戶級 ~/.codex/config.toml，新增 [mcp_servers.geminiDocs]，寫入 url = "<同一地址>"。

這樣做之後，Codex 寫 Gemini API 代碼時可以查官方最新文檔，核對請求格式、模型限制和新功能。注意這不是讓 Codex 的模型換成 Gemini，只是給它多了一個文檔查詢工具。

官方技能的安裝命令（技能倉庫為 google-gemini/gemini-skills）：npx skills add google-gemini/gemini-skills --list 列出所有技能，npx skills add google-gemini/gemini-skills --skill <技能名> --global 全局安裝某個技能。其中 gemini-api-dev 教的是用 Interactions API 和官方 SDK 寫 Gemini API 應用，也包含遷移舊版 generateContent 代碼的內容。

二、為什麼「直接調 Gemini 模型」官方沒有說通

Codex 官方的自定義模型提供方寫法（config.toml）有 base_url、env_key、wire_api 等字段，參考頁裏 wire_api 的取值只有 responses。這意味着 Codex 期望對端提供 Responses 接口。以 xAI 為例，官方 API 就明確支持 Responses，所以能對上，見 /guides/grok-codex-cursor-setup；DeepSeek 官方也寫明支持 Responses API，見 /guides/deepseek-codex-setup。

Gemini 這邊：

  • 官方 OpenAI 兼容頁給的 base_url 是 https://generativelanguage.googleapis.com/v1beta/openai/；
  • 頁面裏的示例涉及聊天補全（chat/completions）、圖片生成、嵌入、批量等，沒有 responses；
  • Gemini 官方原生的新接口是 Interactions API。

所以按兩家官方文檔，沒有一條受支持的路能把 Codex 的模型直接指向 Gemini。網上有人用第三方轉換層或中轉，那不屬於官方方案，本文不涉及，也不建議把 Google 帳號或 API Key 交給不明服務。

三、想用 Gemini 寫代碼，官方的路

需求官方做法
在終端裏用 Gemini 模型Antigravity CLI，見 /guides/gemini-cli-how-to-use-antigravity-cli
在 API 裏調用 Gemini用 Gemini API Key，見 /guides/gemini-api-key 與 /guides/gemini-api-python-quickstart
讓 AI 編程助手寫對 Gemini 代碼Gemini 文檔 MCP 加官方技能（Codex 可用）
在網頁裏快速試模型Google AI Studio，見 /guides/google-ai-studio-how-to

Gemini 訂閱相關見 /guides/gemini-ultra-vs-pro-difference，需要谷歌帳號相關服務可看 /chongzhi/google-zhanghao。

常見問題

Q：Gemini API 的 OpenAI 兼容接口能當通用 OpenAI 接口用嗎？

官方說明是用 OpenAI 庫把 base_url 指向 Gemini 的兼容地址，再按 chat/completions 等調用，見 /guides/gemini-api-base-url-openai-compatible。是否支持 Codex 需要的 Responses 接口，官方頁面沒有寫。

Q：有沒有讓 Codex 用 Gemini 的免費辦法？

沒有官方說明。官方 API 免費層的額度見 /guides/gemini-api-free-tier-rate-limits。

Q：Codex 接別的模型怎麼配？

DeepSeek 和 Grok 的寫法見開頭連結的兩篇，字段相同，地址和密鑰不同。

參考資料

  • Gemini API：Coding agent setup — https://ai.google.dev/gemini-api/docs/coding-agents
  • Gemini API：OpenAI 兼容 — https://ai.google.dev/gemini-api/docs/openai
  • OpenAI：Codex 高級配置 — https://developers.openai.com/codex/config-advanced
  • OpenAI：Codex 配置參考 — https://developers.openai.com/codex/config-reference
  • Gemini CLI 文檔：認證 — https://geminicli.com/docs/get-started/authentication
需要開通或續費？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

    Gemini App 閃退、打不開怎麼辦：安卓、Mac、Windows 的官方裝置要求、更新方法和工作資料限制

    Gemini App 閃退或打不開，先對照官方裝置要求：安卓需要 Android 9 以上和 2 GB 內存，Mac 需要 macOS 15 和 Apple 芯片，Windows 需要 Windows 10 以上。本文整理各端要求、更新方法和不能用的情形。

    Gemini0
  2. 02

    Gemini 語音對話（Live）用不了怎麼辦：網頁版為什麼沒有、攝像頭和螢幕共享自動關閉、鎖屏與權限的官方說明

    Gemini Live 找不到入口、攝像頭自己關了、共享螢幕失敗？官方幫助中心寫明 Live 目前不在網頁版提供，需要個人帳號或有權限的工作帳號，共享螢幕要開通知權限，鎖屏時不能啟動。本文逐項整理。

    Gemini0
  3. 03

    Gemini 無法上載文件、圖片怎麼辦：Delete data to upload file、文件數量與大小限制、雲端硬碟上載的官方說明

    Gemini 上載不了文件或圖片？官方幫助中心寫明瞭上載限制、三條常見提示的含義，以及工作或學校帳號從雲端硬碟上載需要管理員開啟。本文整理限制表、報錯對照和清理存儲的步驟。

    Gemini0
  4. 04

    Gemini 回答到一半停了、「此回覆已停止」怎麼辦：用量上限、上下文窗口和高峰期限制的官方說明

    Gemini 回答寫到一半停住或中斷？官方沒有解釋「此回覆已停止」這句話，但幫助中心寫明瞭用量上限、上下文窗口按方案不同、高峰期限制三類會影響回答的情況。本文逐項整理，並給出對照圖。

    Gemini0
  5. 05

    Gemini 一直轉圈、沒反應怎麼辦：狀態頁、長對話、額度、瀏覽器和帳號的排查順序

    Gemini 一直轉圈、發出去沒有反應？官方沒有專門解釋轉圈，但幫助中心寫明瞭支持的瀏覽器、用量限制和長對話更耗資源。本文按官方說明給出排查順序：狀態頁、瀏覽器、新對話、額度、反饋。

    Gemini0
  6. 06

    Gemini 常見報錯原文對照表：Can't access this service、Something went wrong、Delete data to upload file 等一次看清

    Gemini 報錯的原文各不相同，處理方向也不同。本文把官方幫助中心寫明的提示原文匯成對照表：帳號訪問、上載文件、限額，各說明含義並鏈到詳細文章。官方沒有逐條解釋的地方也會寫明。

    Gemini0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～