⚠️ 停用公告（2026/05/19） Google 宣布 Gemini CLI 將於 2026 年 6 月 18 日停止服務所有免費、Pro 及 Ultra 用戶。官方接替方案為 Antigravity CLI。企業用戶（Gemini Code Assist Standard/Enterprise 或 Google Cloud API key）不受此次截止日影響。詳情請見官方遷移公告。
Gemini CLI 是 Google 推出的開源 AI agent，把 Gemini 的能力直接帶進終端機。採用 ReAct（Reason and Act）迴圈，結合內建工具和 MCP server 來完成複雜任務。
安裝
# 不安裝直接用
npx @google/gemini-cli
# 全域安裝
npm install -g @google/gemini-cli開源授權：Apache 2.0。
免費方案
這是 Gemini CLI 最吸引人的地方之一：
| 項目 | 額度 |
|---|---|
| 每分鐘請求 | 60 次 |
| 每日請求 | 1,000 次 |
| 需要 | 個人 Google 帳號 |
不需要信用卡，不需要 API key（免費方案），直接用 Google 帳號登入即可。
核心功能
| 功能 | 說明 |
|---|---|
| Google Search grounding | 內建搜尋能力，讓回答有即時資料支撐 |
| 檔案操作 | 讀取、寫入、編輯本地檔案 |
| Shell 指令 | 在終端機中執行任意指令 |
| Web fetching | 抓取網頁內容 |
| MCP 支援 | 透過 Model Context Protocol 連接自訂工具 |
| 1M token context | Gemini 模型原生支援超長 context window |
Gemini 3 Pro 整合
Gemini CLI 已整合 Gemini 3 Pro——Google 最強的推理模型：
- 更好的指令執行：推理能力提升，指令判斷更精準
- Agentic coding：支援複雜工程任務的自主編碼
- 進階工具使用：更聰明的工作流程組合
Gemini 3 Pro 在 Gemini CLI 中可供 Google AI Ultra 訂閱者使用，或透過付費 API key 存取。
與 Gemini Code Assist 的關係
| Gemini CLI | Gemini Code Assist | |
|---|---|---|
| 介面 | 終端機 | VS Code 擴充套件 |
| 底層 | 獨立 CLI | 由 Gemini CLI 驅動 |
| 方案 | 免費 / API key | Free / Standard / Enterprise |
VS Code 中的 Gemini Code Assist agent mode 實際上是 Gemini CLI 功能的子集。兩者共享核心能力。
不只是寫程式
Gemini CLI 的用途不限於 coding：
- 內容生成：產生文件、翻譯、摘要
- 問題解決：分析日誌、debug、資料處理
- 深度研究：利用 Google Search grounding 做即時調研
- 任務管理：組織工作流程、自動化日常作業
典型使用場景
- 修 bug + 跑測試：描述問題，Gemini 定位、修正、執行測試驗證
- 新功能開發：給規格，逐步產生程式碼
- 程式碼理解：利用 1M token context 一次讀入整個專案來回答問題
- 跨語言翻譯：把一段 Python 改寫成 TypeScript
與其他工具的定位差異
Gemini CLI 的核心優勢：免費額度慷慨、1M token 超長 context、Google Search grounding 即時搜尋、完全開源（Apache 2.0）。適合預算有限但想體驗 AI coding agent 的開發者，或需要處理超大型 codebase 的場景。
參考資源
遷移至 Antigravity CLI
Google 在 Google I/O 2026（2026/05/19）宣布，Gemini CLI 的功能將由 Antigravity CLI 全面接替。Antigravity CLI 是 Google Antigravity 2.0 平台的終端機介面，以 Go 語言重寫、執行速度更快，並支援非同步 agent 工作流程。
保留功能
以下功能完整延續：
| 功能 | 說明 |
|---|---|
| Agent Skills | 遷移後自動可用，/skills 指令操作方式相同 |
| Hooks | 行為完全一致，無需重新設定 |
| Subagents | 並行 agent 能力保留，且效能提升 |
| Extensions → Plugins | Extensions 改名為 Antigravity plugins，可自動遷移 |
| MCP Servers | 支援相同的 /mcp 指令，設定檔路徑有所調整 |
快速遷移
# 安裝 Antigravity CLI
# macOS / Linux
curl -fsSL https://antigravity.google/install.sh | sh
# 遷移現有 Extensions → Antigravity plugins
agy plugin import geminiMCP 設定差異：Gemini CLI 的 mcpServers 寫在 settings.json，Antigravity CLI 改為獨立的 mcp_config.json（全域路徑：~/.gemini/antigravity-cli/mcp_config.json；workspace：.agents/mcp_config.json）。遠端 MCP server 的欄位名稱由 url 改為 serverUrl。
截止日
- 2026/06/18：個人免費、Pro、Ultra 用戶的 Gemini CLI 停止服務
- 企業用戶（Gemini Code Assist Standard/Enterprise 或 Google Cloud API key）：暫不受影響，另行通知
完整遷移說明：antigravity.google/docs/gcli-migration
參考資料
- Gemini CLI GitHub：google-gemini/gemini-cli 開源終端機 AI agent
- Google Gemini 開發者文件：Gemini CLI 功能與 MCP 設定說明
- Gemini CLI Hands-on Codelab：終端機 AI agent 實作教學
- Google 官方公告：Gemini CLI 開源終端機 AI agent 發布
- Google Developers Blog：Transitioning Gemini CLI to Antigravity CLI（官方停用公告）
- Antigravity CLI 遷移文件：Migrating from Gemini CLI
- Google I/O 2026 開發者亮點：Antigravity 2.0 與 Antigravity CLI 發布
更新紀錄
- 2026-05-21：補充 Gemini CLI 停用公告（2026/06/18）與 Antigravity CLI 遷移指引；更新 tldr、tags、參考資料
Loading...