注册
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 条评论

登录 后参与评论

还没有评论，来抢沙发～