Antigravity CLI 是 Google 推出的終端機 AI 代理工具，指令是 agy。終端機就是輸入文字指令的視窗，你在裡面用一般句子交代工作，它會讀專案、改程式、執行指令。
如果你原本用 Gemini CLI 的免費版，或是 Google AI Pro、Ultra 訂閱，現在要改用它。Google 從 2026 年 6 月 18 日起，已經停止這些帳號使用 Gemini CLI。
個人版每月 0 美元，有每週用量上限，但 Google 沒有公布具體次數。想用 Gemini 4 Argon，至少要訂閱 Google AI Pro，台灣每月 NT$650。
Antigravity CLI 是什麼？
2026 年 5 月 19 日，Google 發表 Antigravity CLI，當天開放所有人使用。CLI 是「命令列介面」的意思，也就是不用滑鼠點按鈕，全程用打字操作。
AI 代理和聊天機器人的差別，在於它會自己動手。你說「幫這個函式加上測試」，它會找到檔案、寫好程式、跑測試，再把修改結果給你確認。
Antigravity 是一整組產品，CLI 只是其中之一：
- Antigravity App：桌面應用程式，可以管理多個代理，用畫面檢視修改內容和計畫。
- Antigravity CLI：終端機版本，也能在遠端主機和 SSH 連線中使用。SSH 是從自己的電腦遠端操作另一台主機的方式。
- IDE 擴充功能：裝在 VS Code、JetBrains、Xcode 等程式編輯器裡。
- Antigravity SDK：Python 開發套件，讓開發者把代理放進自己的程式。
CLI 和桌面版用同一套代理核心，設定也共用。對話預設不會互通，需要時可以把 CLI 的對話匯入桌面版。
目前最新版本是 2026 年 11 月 5 日推出的 1.5.1。GitHub 專案頁主要放說明文件、更新紀錄和範例，沒有標示開源授權，這點和開源的 Gemini CLI 不同。
Antigravity CLI 主要功能
- 四種執行模式：預設模式改檔案、跑指令前都會問你；
accept-edits自動接受專案內的檔案修改；auto連判斷為安全的指令也自動執行；plan先列計畫再動手。按 Shift + Tab 切換。 - 子代理：把工作分給在背景同時執行的代理，輸入
/agents查看進度。 - 指定檔案：輸入
@選擇檔案或資料夾，不用整份貼上。 - 接續對話：
/resume回到以前的對話，/rewind把對話倒回前面的步驟。 - 非互動模式：
agy -p "你的指令"跑一次就結束，適合寫進腳本或自動化流程。 - 外掛：可以一次打包技能、MCP 伺服器和規則。MCP 是讓 AI 連接其他工具與服務的通用規格，用
/plugin管理。 - 專案規則：會讀取專案裡的
GEMINI.md和AGENTS.md，你可以在裡面寫技術規範和不能動的地方。
Antigravity CLI 免費嗎？方案與額度
免費。用個人 Google 帳號登入就能使用，每月 0 美元。
但次數沒有明確數字。官方只說額度主要依可用容量決定，任務越複雜用得越快，所以同樣的額度能下幾次指令並不固定，上限之後也可能調整。
各方案差異如下，月費依序是台灣和美國的價格：
| 方案 | 月費 | 額度更新 | 主要模型 |
|---|---|---|---|
| 個人版（免費） | 0 元 | 每週更新，有每週上限 | Gemini 3.8 Flash |
| Google AI Plus | NT$165／4.99 美元 | 每週更新，有每週上限 | Gemini 3.8 Flash |
| Google AI Pro | NT$650／19.99 美元 | 每 5 小時更新，直到達到每週上限 | 再加 Gemini 4 Argon、Claude Sonnet 5.5、Claude Opus 5.5 |
| Google AI Ultra | NT$3,300／99.99 美元，或 NT$6,500／199.99 美元 | 每 5 小時更新，每週上限最高；用量是 Pro 的 5 倍或 20 倍 | 和 Pro 相同 |
| 商業版（Google Cloud） | 每座位每月 30 美元起，或 0 座位費、按用量計費 | 依方案而定 | 再加 Gemini 3.7 Flash、3.6 Flash、3.1 Pro |
Google AI Pro 試用期不能用 Claude Sonnet 5.5、Claude Opus 5.5。Gemini 4 Argon 也要付費的 Pro 才有，只有符合條件的高階裝置試用例外。
免費版和 Plus 目前還能用 Claude Sonnet 4.6、Claude Opus 4.6 和 GPT-OSS-120b，不過官方標明這些模型 2026 年 11 月 18 日會移除。
Pro 和 Ultra 額度用完後，可以用購買的 AI 點數繼續使用。在 /config 裡把「Use AI Credits」打開，就會自動扣點；關掉則要等額度更新。
怎麼看還剩多少額度？
在 CLI 輸入 /usage 或 /quota，就會開啟額度面板。Gemini 模型和 Claude、GPT 模型分開計算，同一組模型共用上限。
Antigravity CLI 怎麼安裝？
Mac 如果有裝 Homebrew（常用的軟體安裝工具），輸入這行就好，需要 macOS 12 以上：
brew install --cask antigravity-cliWindows 打開 PowerShell，輸入官方提供的這行：
irm https://antigravity.google/cli/install.ps1 | iexLinux，或是沒有 Homebrew 的 Mac，請到官方下載頁複製安裝指令。Windows 想用命令提示字元（CMD）安裝，指令也在同一頁。
官方沒有提供 npm 安裝方式。npm 上雖然有一個叫 antigravity-cli 的套件，但版本只有 0.0.1，說明寫的是 placeholder（佔位用），不要裝錯。
裝好之後輸入這行確認：
agy --version有顯示版本號就成功了。如果出現 agy: command not found，代表系統找不到程式，請照官方疑難排解頁設定 PATH，再開一個新的終端機視窗。
要開始用時，先進到專案資料夾，再輸入 agy。第一次會請你選配色、畫面顯示方式，以及是否信任這個資料夾，要離開時輸入 /exit。
Antigravity CLI 怎麼登入？
個人帳號最簡單。第一次執行 agy 會自動開啟瀏覽器，用 Google 帳號登入就好。
登入資訊會存在系統的金鑰儲存區，例如 Mac 的鑰匙圈，之後不用每次登入。其他情況的做法如下：
- SSH 遠端主機：CLI 會顯示一個授權網址，貼到自己電腦的瀏覽器登入，再把授權碼貼回終端機。
- 公司帳號：登入時選 Business account。Google Workspace 帳號要先由管理員開通，否則會登入失敗。
- Gemini API 金鑰：把設定檔裡的
modelProvider設成gemini，再設定環境變數GEMINI_API_KEY，兩個都要做。這適合沒有瀏覽器的自動化環境。 - 登出：輸入
/logout。
如果個人帳號登入失敗，先檢查兩件事。帳號所屬地區要在開放名單內，台灣和日本都有；使用者也要年滿 18 歲。
Antigravity CLI 和 Gemini CLI 差在哪？
兩者都是 Google 的終端機 AI 代理，Antigravity CLI 也參考了 Gemini CLI 的設計。最大的差別是誰能用：個人免費帳號和 Google AI 訂閱者，現在都要用 Antigravity CLI。
| 項目 | Antigravity CLI | Gemini CLI |
|---|---|---|
| 指令 | agy | gemini |
| 誰能用 | 個人免費帳號、Google AI Pro 與 Ultra、Google Cloud | Code Assist Standard 與 Enterprise、Google Cloud 上的 Code Assist for GitHub、付費 API 金鑰與 Vertex 金鑰 |
| Gemini 4 Argon | 支援，要 Pro 以上 | 官方說明沒有針對它最佳化 |
| 開源 | 沒有標示開源授權 | 開源 |
| 擴充方式 | 外掛（plugin） | 擴充功能（extension） |
| 專案技能資料夾 | .agents/skills/ | .gemini/skills/ |
| MCP 設定 | 獨立的 mcp_config.json | 寫在 settings.json 裡 |
| 安裝方式 | 官方安裝指令、Homebrew | npm、Homebrew |
舊工具的現況和付費使用方式，可以看另一篇 Gemini CLI 介紹。
怎麼從 Gemini CLI 換到 Antigravity CLI？
官方提供了遷移指南，大部分設定都能帶過來，步驟如下：
- 安裝後在專案裡執行
agy。它偵測到舊設定時，會協助轉換擴充功能和全域設定，登入資訊也會移到系統的金鑰儲存區。 - 專案裡的
GEMINI.md、AGENTS.md不用改，新工具會繼續讀取。 - 執行這行，把舊的擴充功能轉成外掛：
agy plugin import gemini - 專案裡的技能要自己搬家，把
.gemini/skills/資料夾移到.agents/skills/。 - MCP 設定從
settings.json拆到mcp_config.json，遠端伺服器的url或httpUrl欄位要改成serverUrl。 - 如果有自動化腳本，把裡面的
gemini指令換成agy -p，再實際跑一次確認結果。
官方也提醒，部分自訂終端機主題和實驗性介面可能不能用，平常有改外觀的人要留意。
Antigravity CLI 適合誰？
- 原本用 Gemini CLI 免費版或 Google AI 訂閱的人：這是官方指定的替代工具，
GEMINI.md也能繼續用。 - 常在遠端主機工作的開發者：它不用圖形介面，可以直接在 SSH 連線裡操作。
- 已經訂閱 Google AI Pro 的人：不用多付費，就能在終端機用 Gemini 4 Argon 和 Claude 模型。
有兩種人不用急著換。公司有 Code Assist Standard 或 Enterprise 授權的話，官方說明存取權限不變，可以繼續用 Gemini CLI。
如果你不熟悉命令列，桌面版 Antigravity App 或 Cursor 這類有圖形介面的工具會比較好上手。也可以比較同類型的 Claude Code，或看 Vibe Coding 工具比較。
Antigravity CLI 缺點
- 額度不透明：免費版和各付費方案都沒有公布具體次數，也可能依容量調整，很難事先估算夠不夠用。
- 免費版模型有限：不能用 Gemini 4 Argon，2026 年 11 月 18 日之後，主要模型只剩 Gemini 3.8 Flash。
- 要自己注意安全：官方警告 AI 程式代理可能有自動執行程式、資料外洩、提示注入和供應鏈風險。重要專案建議維持預設模式，不要用跳過權限確認的參數。
- 預設會收集互動資料：使用時視同同意 Google 收集互動資料，不想提供要到設定裡關閉。
- 個人登入不能接第三方工具：用其他程式透過 Antigravity 登入存取，違反服務條款，可能被停權。把
agy包進第三方應用程式，或自動切換帳號，個人方案也不支援。 - 要會用命令列：不熟終端機的人，需要時間適應。
常見問題
Antigravity CLI 免費嗎？
免費。用個人 Google 帳號登入就能使用，有每週用量上限，但官方沒有公布具體次數。想要更高額度或 Gemini 4 Argon，可以訂閱 Google AI Pro，台灣每月 NT$650。
指令是 antigravity 還是 agy？
是 agy。安裝後在專案資料夾輸入 agy 就會開始。
可以用 npm 安裝嗎？
官方下載頁沒有提供 npm 安裝方式。Mac 可以用 Homebrew，Windows 可以用 PowerShell，其他系統請到官方下載頁複製指令。
台灣可以用嗎？
可以。台灣在官方開放名單內，但使用者要年滿 18 歲。
舊的 GEMINI.md 還有用嗎？
有用。專案裡的 GEMINI.md 和 AGENTS.md 不用修改，新工具會繼續讀取。
Gemini CLI 還能用嗎？
可以，但只剩 Code Assist Standard、Enterprise 授權、Google Cloud 上的 Code Assist for GitHub，以及付費 API 金鑰與 Vertex 金鑰。個人免費帳號和 Google AI Pro、Ultra 都要改用 Antigravity CLI。
