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