Gemini CLI 接入 CodeGateway 兼容性说明

(não oficial)

Este guia é mantido de forma independente pela comunidade. Ele não é afiliado, endossado ou patrocinado pelo fornecedor da ferramenta de terceiros abordada. Todas as marcas de terceiros pertencem aos seus respectivos proprietários.

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

相关资料

参考资料

Transforme esta página em uma chamada de API real

Sem chave oficial ou com dificuldade de pagar com cartão internacional? Crie uma chave sk-cg- após o cadastro, aponte sua base URL para o CodeGateway e mantenha seu SDK ou CLI atual. Pagamento por token; ao adicionar um cartão você ganha créditos grátis.

Criar conta grátis
Author:CodeGateway Team