Google Antigravity 使用教學：App、CLI、編輯器擴充怎麼選，11 月 2 日模型異動前台灣開發者要先知道的事

Google Antigravity 去年 11 月剛推出時，大家把它當成 Google 版的 AI IDE。一年後再看，它已經拆成五個入口：桌面 App、終端機的 Antigravity CLI（指令是 agy）、獨立的 Antigravity IDE、給 VS Code 等編輯器的擴充套件，以及 Python SDK。入口一多，第一次用的人最常卡在「我到底該裝哪一個」。

這篇依 2026 年 10 月 antigravity.google 的官方文件、定價頁與 Google 開發者文件整理。付費方案與企業版我沒有實際訂閱測試，功能和數字以官方頁面為準。

Antigravity 是什麼

一句話講：Google 做的「代理優先」開發環境。你交代任務，代理自己讀程式、改檔案、跑終端機指令、開 Chrome 測畫面，過程中產出實作計畫、程式差異、截圖或瀏覽器錄影這類 Artifacts 給你審，你可以直接在上面留言把方向拉回來。

五個入口的分工大致如下：

• Antigravity App：桌面指揮中心，本身沒有編輯器，適合同時跑好幾個代理、跨多個資料夾工作。
• Antigravity CLI：在終端機裡用，跟原本 Gemini CLI 的使用者最接近。
• IDE 擴充套件：VS Code（1.90 以上）、JetBrains（2026.2.1 以上）、Visual Studio 2026、Zed、Xcode 27 beta 6 以上，Eclipse 目前是 Public Preview。不想換編輯器的人走這條。
• Antigravity IDE：獨立編輯器，有 Tab 補全；要注意企業帳號不能登入這一個。
• SDK：pip install google-antigravity，把代理寫進自己的程式或 CI。

2.0 改版的來龍去脈可以看我們先前的Antigravity 2.0 新聞，這裡只談怎麼用。

能做什麼

Projects。 一個 Project 可以同時掛前端、後端兩個 repo，每個 Project 有自己的權限設定，不必所有專案共用同一套規則。

Artifacts 與 Planning mode。 代理先寫實作計畫，你在計畫上逐段留言，它才動檔案。接手別人的舊專案時，這一步能擋掉不少「它自己腦補需求」的情況。

指令。 官方列為核心的有四個：/goal 讓代理一路做到它能拿出證據證明完成（測試結果、建置紀錄）才停，沒有次數上限；/grill-me 反過來，動手前一次問你一題、每題附建議答案；/schedule 可以用「10 分鐘後」或 cron 語法排定時任務；/browser 叫它開 Chrome 除錯。

Remote Control。 在 App 的 Settings > Application 打開 Enable Remote Control，就能用手機瀏覽器到 antigravity.google.com 看桌機上的代理跑到哪、核准計畫。跑長任務時蠻實用，代理在執行時 Antigravity 也會阻止電腦進入休眠。

怎麼用：從安裝到第一個任務

用 App（多數人的起點）

1. 到 antigravity.google/download 下載。macOS 需 12 以上（Apple Silicon 與 Intel 都有），Windows 10 64 位元以上，Linux 需 glibc 2.28 以上。
2. 用個人 Google 帳號登入。公司的 Google Workspace 帳號要管理員先開通，否則會登入失敗。
3. 點左側的 New Project 圖示，Add Folder 選一個或多個 Git repo，按 Create。
4. 在輸入框交代任務，例如「幫登入流程補單元測試」。
5. 跳出的模式選擇裡，我建議第一次選 New worktree mode，代理會在獨立的 Git worktree 裡改，搞砸了直接丟掉；Local mode 則是直接動你目前的資料夾。
6. 看 Artifacts 裡的計畫與 diff，留言或核准。

用 CLI（原 Gemini CLI 使用者）

1. macOS／Linux 執行 curl -fsSL https://antigravity.google/cli/install.sh | bash，Windows 用 PowerShell 的 install.ps1。
2. agy --version 確認安裝，第一次啟動會問配色、顯示模式，以及是否信任這個資料夾。
3. 在專案目錄輸入 agy，打字交代任務。
4. 狀態列出現通知時按 Ctrl+R 開 Artifact Review，Y 核准、Esc 離開。

如果你機器上有 Gemini CLI 的舊設定，第一次跑 agy 會自動偵測並列出可轉移項目；舊的 extensions 可以用 agy plugin import gemini 轉成 Antigravity 外掛，GEMINI.md 不用改。

用 VS Code 擴充

在 Extensions 搜尋 Google Antigravity 安裝，點活動列的 Antigravity 圖示登入即可。擴充跟 App、CLI 共用 Skills 與 Rules 設定。

進階技巧

先挑權限預設。 Settings > General > Global Permissions 有四種：Request Review（每個指令都問）、Default（指令在沙箱裡跑、沙箱外才問）、Auto（Preview，安全且可逆的指令自動放行）、Turbo（完全不問、整台電腦都能碰）。Default 的沙箱預設沒有網路，而且擋掉 ~/.ssh 和 .env，我覺得對多數人是最好的平衡點。Turbo 請只在拋棄式的環境開。規則衝突時順序是 Deny 大於 Ask 大於 Allow。Windows 的沙箱要 Windows 11 24H2 加上 2026 年 8 月之後的更新才有。

Rules 寫在 AGENTS.md。 專案根目錄或任何子資料夾放 AGENTS.md 或 GEMINI.md，代理改到該資料夾的檔案時會一路往上讀。台灣團隊可以把「回覆與註解用繁體中文」「UI 文案用台灣用語」「金額欄位一律用整數新台幣」寫進去。想拆細一點就放 .agents/rules/*.md，但每個檔案開頭一定要有 trigger:（always_on、model_decision、glob、manual 擇一），寫錯成 camelCase 會被靜默忽略，不會報錯，這個坑很容易踩。另外 rules 資料夾只掃第一層，放進子資料夾的不會被讀到。

Skills 放流程。 官方的分法是：限制條件寫 Rule，多步驟流程（例如怎麼跑資料庫遷移）寫成 Skill，放在 .agents/skills/<名稱>/SKILL.md，description 寫清楚何時該用，代理才會挑對。

用量設定。 Pro 與 Ultra 超過基本配額後，可以在 AI Credit Overages 選 Never（等配額恢復）或 Always（自動扣 AI 點數）。怕月底帳單嚇人就先設 Never，用 CLI 的 /usage 隨時看剩多少。

注意事項

11 月 2 日模型異動。 官方模型頁寫明，Claude Sonnet 4.6、Claude Opus 4.6 與 GPT-OSS-120b 將在 2026 年 11 月 2 日移除。對照表上，免費與 Google AI Plus 能選的就是這三個加 Gemini 3.8 Flash，也就是 11 月 2 日之後免費版只剩 Gemini 3.8 Flash。Gemini 4 Argon 要付費的 Pro 或 Ultra，Claude Sonnet 5.5 與 Opus 5.5 要 Ultra 或「非試用」的 Pro，用試用期的人要先向 Google One 申請轉成付費方案才有。

配額沒有公開數字。 免費版每週重置，Pro 每 5 小時重置直到撞到每週上限，Ultra 最寬。官方說限制看系統容量與代理實際做了多少事，所以同樣一則提示，簡單任務省、複雜任務耗。也不支援自帶 API 金鑰。

付款與帳號地區。 台灣在官方 FAQ 的可用地區清單裡，個人 Gmail 帳號就能用免費版；未滿 18 歲不能用。地區是看 Google 服務條款頁顯示的帳號國家，不對的話可以填表申請更正。升級是在 Google One 訂閱 Google AI Pro 或 Ultra，台灣價格以 Google One 頁面顯示為準。公司要統一採購則走 Google Cloud，Gemini Enterprise Standard／Plus 每席每月 30 美元起，或零席位費依用量計價。

中文支援。 官網有繁體中文（台灣）語系，代理本身用中文交代任務沒問題。不過 App 介面語言官方文件沒有說明，我的做法是把「一律用繁體中文回覆」寫進全域的 ~/.gemini/AGENTS.md，最省事。

資料隱私要自己關。 條款寫得很直白：個人版的互動資料會被拿來改進 Google 產品與機器學習，Google 員工與承包商可能看到，請勿送出機密。要退出到 Settings 調整；要刪除已收集的資料得寄信到 [email protected]。接客戶案子前先把這個設定處理好。選用 Claude 模型時，你另外受 Anthropic 商業條款約束。

別拿 Antigravity 登入去接別的工具。 FAQ 點名用 Claude Code、OpenClaw、OpenCode 等第三方軟體透過 Antigravity 登入，屬於違反條款，可能被停權。想在第三方代理裡用 Gemini，官方建議改用 Google AI Studio 或 Gemini Enterprise 的 API 金鑰。

Gemini Code Assist 使用者。 Google 開發者文件寫明，Gemini Code Assist 個人版，以及 Google AI Pro／Ultra 透過 IDE 擴充與 Gemini CLI 的用法，2026 年 6 月 18 日起已停止服務，導向 Antigravity。公司買的 Standard／Enterprise 另有時程：10 月 9 日起不再販售新訂閱，年約最晚可續到 2027 年 1 月 31 日、月約到 2027 年 12 月 31 日。

TheAI學院 總結與評語

Antigravity 最適合已經在 Google 生態系、又想讓代理一次處理好幾件事的人：App 開多個 Project 平行跑，配上 worktree 和沙箱，安全感比直接放代理在本機亂跑好很多。它跟 Kiro 教學裡介紹的「先寫規格再動手」路線不同，比較像先放手讓代理做、你審 Artifacts。缺點也很明確：配額不透明、模型清單一直在變、入口太多，第一個月會花不少時間搞懂設定。

評語：免費就能用到完整功能的代理開發平台，App 加 worktree 加沙箱的組合很穩；但 11 月 2 日後免費版只剩 Gemini 3.8 Flash，資料收集預設開啟，正式案子前先調好設定。

資料來源

• Google Antigravity 官網
• Antigravity 定價
• Antigravity 方案與速率限制
• Antigravity 模型選擇
• Antigravity 入門指南
• Antigravity FAQ（可用地區、帳號、第三方軟體）
• Antigravity 代理權限
• Antigravity 終端機沙箱
• Antigravity Rules
• Antigravity Agent Skills
• Antigravity Remote Control
• 從 Gemini CLI 轉移
• Google Antigravity 服務條款
• Gemini Code Assist 個人帳號停止服務說明
• Gemini Code Assist Standard／Enterprise 終止時程

本文依 2026 年 10 月 30 日查閱的官方頁面整理，模型、配額與支援地區可能隨時調整，請以官網為準。