加载中…
Gemini CLI 仅支持 Gemini 原生协议，无法直连 CodeGateway；本文说明原因与两种替代方案。
Gemini CLI 目前无法直接接入 CodeGateway。
Gemini CLI（Google 官方开源终端代理，实测版本 0.58.0）支持自定义上游地址，但只接受 Gemini 原生 API 协议（generateContent 一类端点）；CodeGateway 对外提供的是 Anthropic 消息协议与 OpenAI 兼容协议，没有暴露 Gemini 原生协议面，因此直连不可行。
Gemini CLI 的认证与端点配置入口是环境变量 GOOGLE_GEMINI_BASE_URL（配合
CodeGateway 的兼容面：Anthropic 消息协议（/v1/messages）、OpenAI 补全协议（/v1/chat/completions）、OpenAI Responses（/v1/responses）；未提供 :generateContent 类 Gemini 原生端点（实测返回 404）。
注意区分：CodeGateway 模型目录中的 Gemini 系模型（如 gemini-3.8-flash）可以用，但要用在"讲 Anthropic 消息协议"的工具上（见下）。
用 Claude Code 接入 CodeGateway，再把模型换成 Gemini 系（Anthropic 消息协议下实测可用 gemini-3.8-flash）：
export ANTHROPIC_BASE_URL="https://api.codegateway.dev"
export ANTHROPIC_AUTH_TOKEN="sk-cg-你的密钥"
# ~/.claude/settings.json 中把 model 设为 gemini-3.8-flash完整步骤见 Claude Code 一键脚本。
选一个支持 OpenAI 兼容协议的主流工具，用 CodeGateway 的 DeepSeek / Kimi / GLM / Qwen 系模型：
Qwen Code 接入教程：配置一次 ~/.qwen/settings.json 即用。
或 opencode / Aider / Crush / Codex CLI，入口见 Agent CLI 接入总览。
如果 CodeGateway 后续开放 Gemini 原生协议面（或 Gemini CLI 增加 OpenAI/Anthropic 兼容的供应商模式），本页会立即更新接入步骤。
Q：我能在 CodeGateway 中使用 Gemini 模型吗？ 可以。Gemini 系模型在 Anthropic 消息协议 下可用（推荐 gemini-3.8-flash），只是不能通过 Gemini CLI 直连。
Q：把 GOOGLE_GEMINI_BASE_URL 指向 api.codegateway.dev 会怎样？ 请求会命中不存在的 Gemini 原生端点，返回 404（或协议不匹配的报错）。请不要这样配置。
Q：有没有社区中转方式？ 社区一般用兼容 Gemini 协议的反向代理实现中转；但正确、受支持的方式是上面两种替代方案——它们走 CodeGateway 官方兼容面，计费与排错都在可控范围内。
Q：Gemini CLI 以后会支持 OpenAI 兼容吗？ 官方当前没有对应声明。保持关注本文档更新即可。