Gemini CLI 完整方案分析：業界最慷慨免費額度的終端 Agent

⚠️ 停用公告（2026/05/19） Google 宣布 Gemini CLI 將於 2026 年 6 月 18 日停止服務所有免費、Pro 及 Ultra 用戶。接替方案為 Antigravity CLI，Agent Skills、Hooks、Subagents 均可延續，Extensions 改名為 Antigravity plugins 並提供自動遷移工具。企業用戶（Gemini Code Assist Standard/Enterprise 授權或 Google Cloud API key）暫不受影響。遷移文件：antigravity.google/docs/gcli-migration。

Gemini CLI 是 Google 推出的開源終端機 AI coding agent，原始碼在 github.com/google-gemini/gemini-cli。它把 Gemini 模型直接帶進你的 terminal，而且核心賣點非常直接：大多數開發者完全不需要付費。

這篇拆解 Gemini CLI 的免費額度設計、三種認證方式、付費方案、核心功能，以及 2026 年的重要更新。

產品定位

Gemini CLI 是 Google 對「終端 Agent」賽道的回應。和 Claude Code、GitHub Copilot CLI 不同，它從第一天就是開源專案，任何人都可以 fork、修改、貢獻。背後是 Google 的 Gemini 模型家族，原生整合 Google Search 和 Vertex AI 生態系。

定位上，它瞄準的是希望在終端裡用 AI 完成開發任務、但不想為此付月費的開發者。Google 的策略很明確：用極度慷慨的免費額度把人拉進來，讓 Gemini 生態成為預設選擇。

免費額度：核心賣點

Gemini CLI 的免費額度設計是業界最激進的。只需要一個 Google 帳號，你就能獲得：

Google 怎麼定出這個數字？他們分析了內部開發者的實際使用數據，找出使用量最高的開發者的消耗量，然後把免費上限設定在那個數字的 2 倍。換句話說，即使是 Google 內部最重度的開發者，免費額度也綽綽有餘。

這個策略的意思很清楚：絕大多數開發者永遠不會碰到付費牆。你拿到的不是閹割版，而是包含最強模型（2.5 Pro）、最大 context window（1M tokens）、所有核心功能的完整版本。

三種認證方式

Gemini CLI 支援三種認證路線，對應不同的使用情境和計費方式：

三條路線的關鍵差異：

• Google Account 是最推薦的路線。登入 Google 帳號即可，自動獲得上面列的完整免費額度，模型家族由系統自動選擇（預設導向 2.5 Pro）。
• Gemini API Key（免費層） 只能用 Flash 模型，不包含 Pro。適合需要程式化存取但不想走 Google 帳號認證的場景。
• Vertex AI Express Mode 不需要設定 Google Cloud 帳單，適合已經在 GCP 生態裡的團隊做快速測試。

付費方案

當免費額度不夠用時（雖然大多數人不會碰到這個情況），Gemini CLI 有以下付費選項：

注意：Google AI Plus（消費者訂閱方案）目前不適用於 CLI 的 API 用量。如果你已經訂閱了 Google AI Plus，那個額度不會帶到 Gemini CLI 上。這是一個常見的混淆點。

Pay-as-you-go 路線適合需要在 CI/CD 或自動化流程中大量呼叫 Gemini 的場景。沒有每日上限，純粹按 token 計費。

核心功能

Gemini CLI 的功能集涵蓋了終端 Agent 的主要需求：

• 1M Token Context Window——這是目前所有 Agent CLI 中最大的上下文視窗。對大型 monorepo 來說特別有價值，可以一次載入整個模組的程式碼進行分析。
• 多模態能力——支援圖片輸入，可以截圖丟給它分析 UI、閱讀圖表、理解設計稿。
• Google Search Grounding——內建 Google Search，agent 可以即時搜尋網路資訊來輔助回答。不需要額外設定或付費。
• 檔案操作——讀取、建立、修改檔案，執行 shell 指令。標準的 Agent 工具組。
• 程式碼分析——理解程式碼結構、追蹤 call graph、識別 pattern。
• 專案管理工具——任務追蹤、進度管理等內建工具。
• Session 管理——對話歷史持久化，可以在不同 session 之間切換。

其中 1M context window 是最大的差異化優勢。Claude Code 的 Opus 雖然推理更深，但 context window 小得多。在需要同時理解大量檔案的場景中，Gemini CLI 的大上下文是不可取代的。

2026 年重要更新

幾個需要注意的 2026 年變動：

• 2026 年 3 月：預付帳單制變更——Google Cloud 的帳單機制調整為預付制，影響 Vertex AI 路線的付費用戶。如果你走 Google Account 免費額度，不受影響。
• 2026 年 6 月 1 日：Gemini 2.0 Flash-Lite 停用——如果你的工作流程依賴 Flash-Lite 模型，需要在這之前遷移。建議改用 Flash 或 2.5 Pro。
• 免費額度綁定 Google Cloud Project——免費上限目前是綁在 Google Cloud project 層級，不是個人 API key 層級。這表示同一個 project 下的所有 key 共享額度。

適用場景

Gemini CLI 特別適合以下開發者：

• 想要免費高品質 CLI Agent 的人——免費額度涵蓋 2.5 Pro 和完整功能，對大多數個人開發者來說足夠。不需要信用卡，不需要訂閱，登入 Google 帳號就能用。
• 大型 Monorepo 開發者——1M token context window 讓你可以一次載入大量程式碼。如果你的專案動輒數十萬行，這個 context 大小是真正的生產力差異。
• Google / GCP 生態系用戶——已經在 Google Cloud 上的團隊可以無縫整合 Vertex AI，權限管理和計費都走既有的 GCP 架構。
• 重視開源的開發者——完整開源、可以 fork 和客製化。相比 Claude Code 或 Copilot CLI 的閉源模式，這對某些團隊是決定性的因素。

如果你需要的是最深的推理能力（複雜架構設計、多步驟 debug），Claude Code 的 Opus 仍然是更好的選擇。但如果你的主要需求是「免費、夠好、context 夠大」，Gemini CLI 目前無人能出其右。

遷移至 Antigravity CLI

Gemini CLI 停服後，官方建議用戶遷移至 Antigravity CLI——Google Antigravity 2.0 平台的終端機介面。以 Go 重寫、執行速度更快，並支援非同步背景 agent。

遷移重點

• Agent Skills：全域 skills（~/.gemini/skills/）自動讀取，無需任何操作
• Extensions → Plugins：執行 agy plugin import gemini 自動轉換
• MCP Servers：設定檔從 settings.json 移至 mcp_config.json；遠端 server 欄位名稱由 url 改為 serverUrl
• 額度方案：遷移至 Antigravity 對應方案，詳情見官方遷移文件

# 安裝 Antigravity CLI（macOS / Linux）
curl -fsSL https://antigravity.google/install.sh | sh

# 遷移現有 Extensions
agy plugin import gemini

完整遷移說明：antigravity.google/docs/gcli-migration

系列文章

這篇是 Agent CLI 系列的一部分。關於多模型路由和訂閱方案的跨工具比較，請參考：

→ Agent CLI 訂閱方案與多模型路由策略

參考資料

• Gemini CLI | GitHub
• Gemini CLI: Quotas and Pricing
• Gemini Developer API Pricing | Google AI for Developers
• Set up your coding assistant with Gemini MCP and Skills | Google AI
• Gemini Pricing in 2026 for Individuals, Orgs & Developers | Finout
• Google Developers Blog：Transitioning Gemini CLI to Antigravity CLI（官方停用公告）
• Antigravity CLI 遷移文件：Migrating from Gemini CLI

更新紀錄

• 2026-05-21：補充 Gemini CLI 停用公告（2026/06/18）與 Antigravity CLI 遷移段落；更新 tldr、tags、參考資料