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 確認用量。