自從五月底交完 Hahow 的 SDD 課程作業後就一直沒有使用 Gemini CLI, 今天想要用它來重構我的市圖爬蟲時, 發現以 Google 帳戶登入後出現 "Failed to sign in" 訊息 :
搜尋谷歌才知道原來 6/18 起 Google 在產品策略上做了一些改變, 正式停用了針對個人用戶, Google AI Pro, 以及 Google AI Ultra 方案的舊版 Gemini CLI 服務, 舊版的 Gemini CLI 目前只保留給購買 Google Cloud 企業方案, 或是使用付費企業級 API 密鑰的用戶使用.
一般個人訂閱戶 (免費/Pro/ Ultra) 現在全面由 Antigravity 家族接管, 個人端的開發工具全面整合遷移至全新的智慧 Agent 開發平台 Google Antigravity, 若想繼續在終端機 (Terminal) 中使用 Google 的 AI 服務, 須改為安裝 Antigravity CLI, 新版的工具改用 Go 語言重寫, 執行速度更快, 且支援多 Agent 非同步協同作業, 參考 :
舊的 Gemini CLI 本質上屬於工具型的 API 呼叫包裝, 運作模式為單次提示與回應的對話; 新版的 Antigravity CLI 則升級為 "終端型 AI 工程助手", 本質上是一個 Agent 系統, 支援如下功能 :
- 多 Agent 協作
- 工具呼叫 (Tool use)
- MCP (Model Context Protocol)
- 持續任務執行
開發者面對此轉變, 須進行開發模式轉換 : 從 Prompt 工具的 Gemini CLI 轉換到任務執行系統 (Agent Runtime) 的 agy. 這兩個開發工具的核心差異如下表 :
| 面向 | Gemini CLI | Antigravity CLI (agy) |
|---|---|---|
| 狀態 | ❌ 已退役（個人不能用） | ✅ 官方主力 |
| 核心定位 | API wrapper | Agent 平台 CLI |
| 互動模式 | 單次 Prompt → 回答 | 持續任務 + 多 Agent |
| 任務執行 | ❌ 基本無 | ✅ 可執行命令 / 改檔案 |
| 上下文 | 需手動提供 | ✅ 自動理解專案 |
| Agent 能力 | ❌ 無 | ✅ 多 Agent 協作 |
| 工具呼叫 | 限制很大 | ✅ Tool use（Shell / Git / Browser） |
| MCP 支援 | 有但偏初級 | ✅ 深度整合 |
| 工作流 | 線性 | 非同步 / 多步驟 |
| 架構定位 | CLI 工具 | Agent Orchestration Layer |
| 模型支援 | Gemini only | ✅ 多模型（Gemini / Claude / GPT 等） |
| 安全性 | 主機直接操作 | ✅ Sandbox 執行 |
其中最關鍵的差異在於互動模式, Gemini CLI 是一次問一次答, 不記得上下文 (要靠 GEMINI.md), 也不會自動做事情 (例如開啟瀏覽器進行測試), 同樣一個提示詞, agy 會用不同的 Agent 分別進行結構分析, 撰寫修改程式, 跑測試與修正錯誤等任務.
其次, Gemini CLI 的回應只能告訴你怎麼做而不會幫你真的做; 而 agy 則會直接做 (改檔案, 執行 shell, 跑測試, 查 Git history ...), 因為它是 Agent + tool system, 擁有 Gemini CLI 所沒有的工作流 (workflow) 能力.
另外 agy 還有一些值得一提的亮點, 例如它支援多模型 (Gemini CLI 只能使用 Gemini 模型), MCP (所有工具都走 MCP), 企業資安在意的沙箱執行等. 總之, Google 這次進行的是一個架構性的轉變, 舊世界的 Gemin CLI 是一個一問一答的單線對話結構 :
User → Prompt → LLM → Response
而 agy 則是多 agent, 多工具整合的任務循環結構 :
User → Agent Planner → Sub Agents → Tools (MCP) → Execution + Feedback Loop
開發者思維必須從 "我用 AI 幫我寫 code" 轉變為 "我用 AI 幫我做工程工作", 這是從 Prompt → Agent Workflow 的心態轉換. 總之, agy 是 task-driven (任務驅動), 不是 command-driven (指令驅動) 的工具.
1. 安裝 Antigravity CLI :
irm https://antigravity.google/cli/install.ps1 | iex
PS C:\Users\tony1> irm https://antigravity.google/cli/install.ps1 | iex
I0627 01:45:51.731347 21576 installer.go:27] Running Antigravity CLI setup...
I0627 01:45:51.811905 21576 installer_windows.go:45] Configuring Windows user PATH registry environment...
I0627 01:45:51.812422 21576 installer_windows.go:117] Successfully added %LOCALAPPDATA%\agy\bin to User PATH registry variable.
I0627 01:45:51.812422 21576 installer_windows.go:148] Broadcasting environment update system-wide...
I0627 01:45:53.794218 21576 installer_windows.go:167] Environment update broadcast completed.
Warning: C:\Users\tony1\AppData\Local\agy\bin is not present in your active Environment PATH.
Please restart your active terminal session, or add it manually if needed.
✅ Antigravity CLI binary placed successfully at C:\Users\tony1\AppData\Local\agy\bin\agy.exe
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
安裝完畢須關閉 PS 與所有 CMD 視窗, 重新開啟一個新的 PS 視窗 (這樣環境變數才會生效), 輸入 agy --version 檢視版本 :
PS C:\Users\tony1> agy --version
1.0.12
出現版本號表示 agy 已安裝成功.
2. 啟動 Antigravity CLI :
在 PS 視窗輸入 agy 會出現全新的終端機使用者介面 :
選擇預設的 Google OAuth, 這會開啟瀏覽器選擇要登入哪一個谷歌帳戶 :
按 "登入" :
出現一組驗證碼, 此為一次性動態密碼 (類似信用卡付款之 OTP, 無須保存), 壽命只有 5 到 10 分鐘而已, 請務必在有效期限內用它來完成驗證, 逾時自動失效必須重來. 按 Copy to Clpboard 複製到剪貼簿 :
貼到 PS 視窗按 Enter 進行帳戶驗證 :
通過驗證後選擇主題背景 (Theme), 用預設的 Terminal 即可按 Enter :
出現服務條款與詢問是否願意將與 agy 互動資料 (Interactions data) 提供給 Google, 用來幫助改進此 Coding 代理工具 (例如優化模型與功能), 基於隱私保護考量, 建議取消勾選, 用上下方向鍵移動光標到 > [x] Yes, I agree... 這行, 按 SPACE 或 Enter 鍵改成 [ ] :
接著將光標移動到下方的 [Done] 上, 按 Enter 即可完成設定並進入下一步 :
出現詢問是否授權 agy 對此資料夾進行讀寫與執行, 按 Enter 同意 :
進入 agy 提示號 > 表示完成全部設定, 可以進行對話了 :
以上設定是在使用者家目錄下進行, 但通常開發專案通常會建立一個專案資料夾, 然後切換到該專案資料夾下後再啟動 agy, 如果是 Python 專案, 建議用 uv 工具先建立好專案結構後再啟動 agy. 關於 uv 工具用法參考 :
3. 常用指令 :
Antigravity CLI 常用指令如下表 (付 Gemini CLI 對照) :
| Gemini CLI | Antigravity CLI (agy) | 功能說明 |
|---|---|---|
| gemini | agy | 啟動指令。新版會直接進入互動式圖形介面 (TUI)。 |
| gemini "prompt" | agy "task" 或 agy -p "task" | 單次任務執行 (不進入 TUI，直接在當前終端機交付任務並輸出結果。 |
| gemini --login | agy auth login | 帳號登入與驗證。引導至瀏覽器綁定你的 Google AI Pro 帳號。 |
| （無對應） | /init 或 agy init | 初始化當前專案，建立代理人設定檔與必要的本地環境。 |
| （無對應） | /grill-me | 【核心新功能】 重大重構前讓 AI 質詢你的邏輯，確保雙方對齊。 |
| （無對應） | /agents | 開啟專案面板，監控背景正在非同步協同作業的所有子代理人狀態。 |
| gemini --config | /config | 調整設定。可在介面中直接開關 Shell 執行、自動核准等權限。 |
| gemini --model [name] | /model | 即時查詢或切換當前專案使用的 AI 模型（如 Flash 或 Pro）。 |
| （無對應） | /skills | 列出目前專案載入的所有自訂 Skills（技能藍圖）與自訂指令。 |
| gemini --version | agy --version | 檢查當前本地端 Antigravity CLI 的版本號。 |
| （無對應） | agy plugin import gemini | 【老用戶專屬】 一鍵將舊版 Gemini CLI 的擴充套件遷移至新版。 |
| ~/.gemini/plugins/ | ~/.config/antigravity/skills/ | 全域 Skills 與自訂擴充功能的存放路徑。 |
在提示符號 > 下輸入斜線 / 就會顯示所有斜線指令.
