Gemini CLI 接入 CodeGateway 兼容性说明

(Unofficial)

Dieser Leitfaden wird unabhängig von der Community gepflegt. Er steht in keiner Verbindung zum Anbieter des hier behandelten Drittanbieter-Tools und wird von ihm weder unterstützt noch gesponsert. Alle Marken Dritter sind Eigentum ihrer jeweiligen Inhaber.

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(配合 GEMINI_API_KEY),官方要求该地址必须"以 Gemini API 协议托管"(见 官方配置文档)。

  • CodeGateway 的兼容面:Anthropic 消息协议(/v1/messages)、OpenAI 补全协议(/v1/chat/completions)、OpenAI Responses(/v1/responses);未提供 :generateContent 类 Gemini 原生端点(实测返回 404)。

  • 注意区分:CodeGateway 模型目录中的 Gemini 系模型(如 gemini-3.8-flash)可以用,但要用在"讲 Anthropic 消息协议"的工具上(见下)。

替代方案一:仍想用 Gemini 模型

用 Claude Code 接入 CodeGateway,再把模型换成 Gemini 系(Anthropic 消息协议下实测可用 gemini-3.8-flash):

bash
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 系模型:

未来可能的变化

如果 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 兼容吗? 官方当前没有对应声明。保持关注本文档更新即可。

相关资料

参考资料

Machen Sie aus dieser Doku einen echten API-Aufruf

Kein offizieller Key oder Probleme mit Kartenzahlungen aus dem Ausland? Erstellen Sie nach der Registrierung einen sk-cg- Key, richten Sie Ihre Base URL auf CodeGateway und behalten Sie Ihr bestehendes SDK oder CLI unverändert. Abrechnung pro Token; nach dem Verknüpfen einer Karte erhalten Sie kostenloses Guthaben.

Kostenlos registrieren
Author:CodeGateway Team