Gemini CLI 接入 CodeGateway 兼容性说明

(Unofficial)

本ガイドはコミュニティが独自に維持・運営しているものであり、取り上げている第三者ツールのベンダーとの提携・承認・スポンサー関係はありません。第三者に帰属する商標は、すべて各権利者に帰属します。

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

相关资料

参考资料

このドキュメントを実際のAPI呼び出しにする

公式キーがない、海外発行カードでの支払いが難しい場合でも、登録後にsk-cg-キーを作成し、ベースURLをCodeGatewayに向けるだけで、既存のSDKやCLIをそのまま使えます。トークン単位の従量課金。カードを登録すると無料クレジットが付与されます。

無料で登録
Author:CodeGateway Team