Gemini CLI

让 Gemini CLI 使用网关 API 密钥认证与原生 v1beta API。

安装与准备

  1. 安装 Node.js 20 或更高版本，再安装下方官方 Gemini CLI npm 包。运行 gemini --version 检查。
  2. 在 routerra.ai API 密钥创建密钥，并从模型选择支持 Gemini 原生协议的模型。此连接使用 Gemini generateContent/streamGenerateContent，不是 OpenAI Chat Completions。
npm install -g @google/gemini-cli
gemini --version

配置 Gemini 原生路由

  1. 在启动 Gemini CLI 的终端设置下方三个变量。SDK 会添加 /v1beta/models/...，因此 GOOGLE_GEMINI_BASE_URL 必须是 https://routerra.ai，不能添加 /v1 或 /v1beta。替换密钥和模型占位符。
  2. 出现提示时选择 Use Gemini API key；新版可能自动识别网关认证。已有 Google 登录或 Vertex 会话可能绕过此路由，请用 /auth 切换。需持久化时，将变量以 NAME=value 格式写入 ~/.gemini/.env，再重启 Gemini CLI。不要提交此文件。
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

适用于 Windows PowerShell：

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

检查连接

使用明确的 --model ID 测试简短提示。出现 Google 登录页面说明认证模式错误。请求落到 /v1/v1beta 或 /v1beta/v1beta，表示基础地址多了路径。模型被拒绝时检查是否支持原生 Gemini，不要替换成 OpenAI 模型 ID。清除冲突的 GOOGLE_GENAI_USE_VERTEXAI 或 GOOGLE_GENAI_USE_GCA，重启后在 routerra.ai 确认用量。