Gemini CLI 替代方案：依工作流程與 API 控制選擇

Gemini CLI 並未退役，但它的免費入口已關閉——因此「替代方案」會分成兩個不同的決策。 該儲存庫仍在運作：google-gemini/gemini-cli 未被封存，採用 Apache-2.0 授權，最近一次推送為 2026 年 9 月 21 日；npm 穩定版 @google/gemini-cli 為 0.60.0，發布於 2026 年 9 月 15 日，每日仍持續建置 nightly 版本，且沒有棄用標記（GitHub 與 npm API，於 2026 年 9 月 21 日查詢）。結束的是存取權。如果你離開是因為登入失效，需要新的存取權。如果你離開是因為想在代理程式後方使用自己的端點，需要新的用戶端——而第二個問題取決於協定障礙，而非個人偏好。

先釐清一點，再談任何數字。另一家名為 Gemini 的加密貨幣交易所發布自己的「Gemini API」文件與費率表，MacPaw 銷售名為 Gemini 2 的 macOS 重複檔案尋找工具，而 gemini:// 協定也有自己的終端瀏覽器。它們的價格都不屬於本頁內容。Google 自己的名稱也分成六種——Gemini CLI、Antigravity CLI、Gemini Code Assist、Gemini 應用程式訂閱、Gemini API，以及 Gemini Enterprise Agent Platform——因此下方每個數字都會說明其來源。

為什麼人們現在離開 Gemini CLI

Google 於 2026 年 5 月 19 日宣布將 Gemini CLI 轉換為 Antigravity CLI，並表示：「2026 年 6 月 18 日起，Gemini CLI 與 Gemini Code Assist IDE 擴充功能將停止為 Google AI Pro 和 Ultra，以及免費使用者提供服務」。Google 的消費者棄用頁面最後更新於 2026 年 9 月 2 日，補充指出：「你不再能使用『使用 Google 登入』選項來存取 IDE 擴充功能或 Gemini CLI」，Standard 與 Enterprise 訂閱「維持不變」，受影響的使用者可以遷移至 Antigravity 系列。

預期會有一個過時來源與上述內容矛盾。 main 上的 README 仍宣稱「使用個人 Google 帳戶時，每分鐘 60 個請求、每天 1,000 個請求」，又重複提到免費方案兩次，且完全未提及 Antigravity 或 6 月 18 日（於 2026 年 9 月 21 日擷取）。Google 的日期明確的棄用頁面才是較新的說法；README 就是陷阱。

第二個陷阱是訂閱價格錨點。Google AI 列出免費方案 $0、Plus 每月 $4.99，以及 Pro 每月 $19.99；Google 的2026 年 5 月 19 日公告則列出 Ultra 每月 $100 與 $200——但這些是 Gemini 應用程式訂閱，而 Pro 正是轉換公告所指稱已停止提供服務的方案，Ultra 與個人免費 Code Assist 亦然。該訂閱頁面沒有任何方案被記載為可購買 Gemini CLI 配額。Ultra 數字是否仍有效，未在目前的價格頁面上驗證；訂閱頁面完全沒有列出 Ultra。

留下：免費入口關閉後 Gemini CLI 的成本

仍有兩條按量計費的路徑。授權路徑是按席位購買，而 Gemini Code Assist 配額（頁尾日期為 2026 年 9 月 18 日）按請求數量限制，並指出每日限制「會彙總與 Gemini CLI 或代理模式搭配使用的任何模型版本或系列（例如 Pro、Flash）的所有互動」——因此一個提示可能消耗數個請求，切換至較便宜的模型也不會增加餘裕。

價格取自 Google 的Gemini 價格頁面（2026 年 9 月 21 日）；該頁面也顯示每小時等值價格，並註明訂閱按月計費。使用 API 金鑰的途徑則按 token 計費。Gemini API 定價最後更新於 2026 年 9 月 16 日，列出這兩者及其他模型——而 Flash 數字是有日期限制的優惠起始價格，之後會調高，這正是部落格文章中的數字容易過時的例子。

同一頁列出 Batch API，成本降低 50%，並以標準費率的一半列出這些模型的批次欄位。請注意 Pro 依上下文長度分級的費率：代理式迴圈每一步都會重新傳送其上下文，因此只引用低於 200k 的數字會低估成本。這裡未擷取快取、以外部資料為依據（grounding）與工具使用的費用項目，因此請將這些視為基礎 token 費率，而非總成本。Gemini CLI 配額會更詳細說明請求計數部分。

決定候選清單的障礙

Gemini CLI 確實支援自訂端點。其儲存庫內設定參考文件指出，GOOGLE_GEMINI_BASE_URL會覆寫「Gemini API 請求的預設基底 URL（使用 gemini-api-key 驗證時）」，除非目標是 localhost，否則必須使用 HTTPS；另有獨立的 GOOGLE_VERTEX_BASE_URL 用於 Google 後來重新命名為 Gemini Enterprise Agent Platform 的路徑。Google 的呈現式文件網站完全沒有列出基底 URL 覆寫，因此該變數有記載於儲存庫，但未出現在發布網站上——確實存在，只是很容易錯過。

關鍵在於線路格式。在main上的已發布原始碼中，該 URL 會以 httpOptions.baseUrl 傳給 @google/genai SDK，並將 vertexai 設為 false，因此每個請求都會以 Google 原生 Gemini 協定送出，而驗證列舉沒有 OpenAI 相容或 Anthropic 選項。金鑰預設會放在 x-goog-api-key 標頭中；同一檔案讀取 GEMINI_API_KEY_AUTH_MECHANISM，將其設為 bearer 後，會在 gemini-api-key 與 vertex-ai 路徑上把金鑰移至 Authorization 標頭——這只會改變標頭，不會改變線路格式，因此也不是出口。該原始碼還包含未記錄的 GATEWAY 驗證類型，只要設定 GOOGLE_GEMINI_BASE_URL 就會從環境中選取——優先於 GEMINI_API_KEY，僅低於明確的 Google 登入與 Vertex 切換——其金鑰回退為空字串。設定文件中完全沒有出現「gateway」一詞；它是從程式碼而非 API 合約讀出的，而且仍使用原生協定，因此什麼也救不了。

Kunavo 提供 /v1/chat/completions、/v1/messages 與 /v1/responses。於 2026 年 9 月 21 日重新探測：api.kunavo.com/v1/models 回應 401，而 /v1beta/models 與 /v1beta/models/<model>:generateContent 都回應 404。Kunavo 不是 GOOGLE_GEMINI_BASE_URL 的有效目標，假裝相反只會浪費你一個下午。請更換用戶端，而不是端點。

Kunavo 也不提供 embedding、文字轉語音或語音轉文字模型，因此需要其中任何一項的工作流程，仍須為該步驟保留現有供應商。

Antigravity CLI 也受到同樣的障礙限制。其安裝與驗證文件表示，你可以「使用自己的 Gemini API 金鑰，而非已登入的 Google 帳戶」執行，並設定 GOOGLE_GEMINI_BASE_URL 以連線至「不同的 Gemini 相容端點」——是 Gemini 相容，而非 OpenAI 相容。另一方面，其方案頁面指出，目前不支援「自帶金鑰或自帶端點以取得額外速率限制」。兩者並不矛盾，而限定語很重要：你可以使用自己的金鑰執行，但這樣不會取得任何訂閱配額。其個人方案列為每月 $0（於 2026 年 9 月 21 日查詢），且任何方案都沒有列出數值速率限制。請狹義解讀該方案的內容：其下方清單列出模型存取、無限 Tab 補全、無限指令請求，以及「基本每週速率限制」，並未提到 CLI——該頁面只在透過 Google Cloud 提供的組織方案下列出 CLI。該頁面也沒有說明免費方案是否涵蓋 agy。

哪個替代方案適合哪種離開原因

狀態資訊取自 2026 年 9 月 21 日的 GitHub REST API 與 npm 套件登錄庫。關於 OpenCode，有一點需要注意：另一個 opencode-ai/opencode 儲存庫自 2025 年 9 月起已封存，並以 Crush 的名稱延續開發，因此在該儲存庫中找到的設定或價格，反映的是 Crush 的發展脈絡，而非 OpenCode 的。請參閱 Crush 與 OpenCode 比較，比較兩者的差異；另請參閱 Qwen Code 定價，了解其各條路由的費用。

哪些內容會遷移，哪些會留下

Qwen Code 是最短的跳轉路徑，因此值得精確計算成本。雙方資料都取自各自的文件（2026 年 9 月 21 日）：Gemini CLI 的設定參考與擴充功能參考，以及 Qwen Code 的設定與驗證頁面。下方的脈絡主張來自 Qwen Code 自己的README，其中指出該專案最初基於 Gemini CLI v0.8.2，並在 Qwen Code v0.1 起停止與上游同步。

Antigravity 路徑有自己的遷移說明，而且比初讀時更受限：其CLI 概覽表示導入「支援一次性匯入，以自動遷移現有的 Gemini CLI 擴充功能、技能與設定」。它點名這三項內容，對聊天歷史、檢查點與 Shell 歷史記錄則保持沉默——這既不是承諾，也不是否認。

至於 Qwen Code 路徑，完整變更就是一個合併的設定區塊。在環境中設定金鑰，將基底 URL 指向 API 的 /v1 根路徑，而非完整的 chat-completions 路徑，並將 GEMINI.md 保留在內容清單中，讓現有專案指示仍能載入：

{
  "context": { "fileName": ["QWEN.md", "GEMINI.md"] },
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-4-6",
        "name": "Claude Sonnet 4.6 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": { "KUNAVO_API_KEY": "sk-kn-..." },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "claude-sonnet-4-6" }
}

還原成本很低，而且值得在開始前先安排好。 這些操作都不會碰到你的 Gemini CLI 安裝：Qwen Code 設定不會改動 ~/.gemini/，如果你仍持有 Code Assist Standard 或 Enterprise 授權，或持有付費 Gemini 金鑰，gemini 也會完全照常運作。請持續為該路徑提供資金，直到新用戶端完整執行一項真實工作。即使如此，也請先將 ~/.gemini/settings.json 複製到安全位置——這是最可能被手動編輯兩次的檔案。

新用戶端的實際估算

這是示意性的 token 算術，不是測量所得的工作成本，也不是帳單上限。假設一個代理式工作階段包含 10 個步驟，每一步傳送 60,000 個未快取的輸入 token——迴圈會在每一步重新傳送其內容——並接收 1,500 個輸出 token：總計 600,000 個輸入與 15,000 個輸出。未建模快取、工具呼叫額外開銷與重試，而實際工作階段的差異可能大於下方的差距。費率是每百萬 token 的即時Kunavo 目錄價格。

離開用戶端不代表離開模型系列：Kunavo 的目錄同時提供 Gemini、Claude 與 GPT 模型，因此 Qwen Code 或 OpenCode 設定仍可呼叫 Gemini 3.8 Flash。請查看即時目錄，確認你閱讀當天列出的內容。Kunavo 目錄金額是計費下限，而非上限——上游回報費用時，帳單會取目錄成本與上游成本乘以適用加成兩者中較高者。預付額度的最低儲值為 $10，這是資金下限，而非工作費用或訂閱費；請參閱帳務詳細資料。

請注意該表格回答的是哪個問題。列出的最低費率與完成工作所需的最低成本是不同的主張：以低費率嘗試三次的模型，成本可能高於一次就完成的模型。先依費率建立候選清單，再在自己的儲存庫上測量一項有界定範圍的工作，並查看你的帳戶實際記錄的成本。

設定並檢查第一項工作

Kunavo 為最接近的轉換途徑提供了設定參考。這是已發布的設定頁面，並非相容性測試——我們尚未在此針對 Kunavo 的端點對 Qwen Code 進行執行階段測試，本頁的其他用戶端也都未經此類測試。請從 Qwen Code 整合指南開始；如果 OpenCode、Crush、Cline 或 Aider 中的某個選項更符合您離開原工具的原因，也可以參閱相應頁面。當您準備好為金鑰儲值時，請建立 Kunavo 帳號。

仍在考慮是否要切換用戶端？Gemini CLI 與 Claude Code會直接比較工作流程，而OpenCode 供應商比較則從另一端涵蓋相同的路由問題。

常見問題

儲存庫與 npm 狀態、Google 的棄用與價格頁面、Antigravity 的安裝與方案文件，以及 Qwen Code 自己的設定文件，均於 2026 年 9 月 21 日查核；Kunavo 端點探測也在同日重新執行。本頁內容沒有經過執行階段測試：未安裝任何 CLI，也未針對任何端點執行工作階段。Kunavo token 費率來自即時目錄，美元範例是示意性的 token 算術。