Gemini CLI

概覽Copy Anchor Link

Gemini CLI 0.60.0 已正式記錄 API Key 認證下的 GOOGLE_GEMINI_BASE_URL。使用 TokenLab 的 Gemini 原生端點，並選擇支援 gemini_generate_content 的目前模型。請參閱官方設定參考和認證指南。此設定不會將 Google 訂閱轉接至 TokenLab。

安裝Copy Anchor Link

npm install -g @google/gemini-cli@0.60.0
gemini --version

設定Copy Anchor Link

依快速開始的 macOS、Linux、WSL 或 Windows PowerShell 步驟設定 TOKENLAB_API_KEY，避免把金鑰寫入命令歷史，再從同一終端機啟動 Gemini CLI。長期使用請透過本地秘密管理工具提供金鑰，不要把明文金鑰附加至 shell 設定檔。

保留原 Google 登入與設定。為 TokenLab 選擇尚未使用的設定根目錄，例如 ~/.gemini-tokenlab（PowerShell 中使用 $HOME），並在其中建立 .gemini。將既有 .gemini/settings.json 及所需政策檔複製到對應位置，保留權限、沙箱和無關設定；只在副本中合併以下認證欄位，沒有設定檔時才新增。不要複製 OAuth 快取或清除原憑證；遵守既有管理認證政策。

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

使用方式Copy Anchor Link

下列啟動指令使用 ~/.gemini-tokenlab/.gemini/settings.json；選擇其他根目錄時請同步調整。透過 Gemini 正常的信任提示確認工作目錄，保留原工具核准政策。本工作階段明確指定模型。

GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.5-flash

這些變數只用於本次啟動，保留已儲存的帳戶、預設模型與權限。正常啟動時不加這些變數，即可繼續使用原設定；不要將它們寫入 shell 設定檔。

驗證Copy Anchor Link

儲存設定或列出模型不能證明金鑰有效或請求完成。傳送提示詞會使用 TokenLab 餘額；先核對回覆及對應請求記錄，再嘗試工具，輔助請求也可能計費。

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.