跳轉到主要內容
用 Aihubmix 為 Gemini CLI 提供強勁動力,享受穩定高效的 Gemini 模型服務。
Gemini CLI 官方說明:免費層級及 Google One 使用者自 2026 年 6 月 18 日起改用 Antigravity CLI。使用 API Key 並自訂 Base URL 的方式不受影響。

快速配置指引:

1️⃣ 全域安裝 npm 套件

終端機執行:
確保你的 Node.js 版本 >= 20 更多詳細說明可以參考:
  1. 官方倉庫
  2. 詳細配置

2️⃣ 環境變數配置

在系統環境變數中填入 Aihubmix 密鑰和轉發位址,密鑰可以在 Aihubmix 「Keys」頁面 生成。 比如在 ~/.zshrc 中新增:
對於 Mac 使用者,你可以在使用者名稱目錄透過快捷鍵 ⌘ + ⇧ + . 顯示隱藏的 .zshrc 檔案,用系統的「文字編輯」APP 開啟並新增上述內容。
Windows PowerShell 使用者可以執行以下指令(僅對目前視窗生效):

3️⃣ 使配置生效

新增配置之後,終端機執行 source ~/.zshrc,按下 Enter 即可。

4️⃣ 終端機啟動

終端機輸入

初始化配置

選擇接入方式

Gemini CLI 認證介面中選擇 Use Gemini API Key 首次啟動時,Gemini CLI 會先詢問是否信任目前資料夾,選擇 Trust folder 後會自動重新啟動。重新啟動後顯示 Get started 認證介面,已設定 GEMINI_API_KEY 時預設選中 Use Gemini API Key,按下 Enter 確認:
隨後會彈出 Enter Gemini API Key 輸入框,框中已預先填入 GEMINI_API_KEY 的值,確認無誤後按下 Enter 提交。
之後需要切換認證方式時,可以輸入 /auth 重新開啟認證介面。

跳過互動選擇(可選)

在 ~/.gemini/settings.json 中加入以下配置,即可跳過啟動時的互動選擇:

啟動成功

完成以上初始化即可正常使用。 Gemini CLI 配置完成後正常對話

祝你使用愉快!

最後更新:2026-10-19