Gemini CLI API Gateway

Gemini CLI 接入 gw-link：GOOGLE_GEMINI_BASE_URL 配置

Gemini CLI 使用 Gemini 原生 API（/v1beta）。gw-link 提供兼容的 /v1beta 接口：设置 GOOGLE_GEMINI_BASE_URL 指向网关根地址、GEMINI_API_KEY 填入控制台签发的 Key，即可在终端里使用 Gemini 模型，并与 Claude Code、Codex 共用一个账户。

立即体验 · 查看定价

Gemini 原生协议

gw-link 直接提供 /v1beta 接口并兼容 x-goog-api-key 鉴权，Gemini CLI 无需任何格式转换。

跨工具统一账户

Claude Code、Codex、Gemini CLI 使用同一个 gw-link 账户，不同工具用不同 Key，余额统一管理。

配置只有两项

GOOGLE_GEMINI_BASE_URL 与 GEMINI_API_KEY，可写入 shell 配置文件长期生效。

Gemini CLI 接入步骤

  1. 在 gw-link 控制台创建 Key（选择 Gemini 分组），点击「使用密钥」查看 Gemini CLI 配置。
  2. 设置 GOOGLE_GEMINI_BASE_URL=https://gw-link.com（不要带 /v1beta）与 GEMINI_API_KEY。
  3. 运行 gemini；如提示选择认证方式，选择「Use Gemini API Key」。
  4. 发送一条消息确认模型正常返回。

配置示例

macOS / Linux 终端

可选：export GEMINI_MODEL=<模型名> 指定默认模型，模型名以控制台为准。

export GOOGLE_GEMINI_BASE_URL="https://gw-link.com"
export GEMINI_API_KEY="sk-你的gw-link密钥"
gemini

常见问题

GOOGLE_GEMINI_BASE_URL 要不要带 /v1beta？

不要。Gemini CLI 会自动拼接 /v1beta/models/...，填 https://gw-link.com 即可。

需要 Google 账号登录吗？

不需要。设置 GEMINI_API_KEY 后 Gemini CLI 以 API Key 方式鉴权，使用的是 gw-link 签发的 Key。

Gemini CLI 是否适合接入 API 网关？

适合，尤其是团队需要统一管理 Key、额度和多种 AI 编程工具的成本时。

English

最后更新: