Google Antigravity 安裝與設定完整指南：2.0 改版後，它已經不是那個 IDE 了

上週一位客戶的後端工程師傳了張截圖來問我們，說他照著搜尋到的教學一步一步裝 Google Antigravity，程式打開之後畫面卻跟教學裡的截圖完全對不上：沒有左邊的檔案總管，沒有編輯器分頁，只有一個要他「選擇專案」的空白視窗。他懷疑自己在哪個奇怪的站台下載到山寨版。

他沒有下載錯，是那份教學過期了。Antigravity 在 2026 年 5 月 19 日的 Google I/O 上被整個重寫過一輪，2.0 之後它不再以 VS Code 分支的形式存在，改成一個獨立的代理程式桌面應用，程式碼編輯器在新架構裡反倒降格成選配。照著 2025 年底那批「Agentic IDE 安裝指南」操作，會在第一步就對不上畫面。

現在要跑起 Antigravity，實際上會碰到兩個安裝品：桌面應用負責派工與監看代理程式，agy 命令列工具負責在終端機裡跑同一套核心。兩個都能單獨使用，也能搭配既有的 VS Code 或 JetBrains。安裝本身十分鐘內會結束，真正吃時間的是搞懂它的專案權限模型，那也是最容易踩雷的地方。下面的步驟我們都在 macOS 與 Ubuntu 上實際跑過一次。

Antigravity 到底是什麼？跟一般 IDE 差在哪？

先把定位講清楚，不然後面的安裝步驟會看得很困惑。傳統 IDE（包含掛了 AI 外掛的 VS Code）的心智模型是：你是駕駛，AI 是副駕。你打開一個檔案，游標停在某一行，AI 幫你補完這一段。主導權在你手上，AI 的視野大致就是當前這個檔案加上一點上下文。

Antigravity 2.0 的心智模型換成了派工。你開的不再是檔案，是一個「專案」，然後告訴代理程式要達成什麼目標，它自己決定要讀哪些檔案、改哪幾支程式、跑什麼指令來驗證。主畫面因此長得比較像工作看板：左邊是專案清單，中間是跟代理程式的對話，旁邊的輔助面板（Auxiliary Pane）用來檢視它產出的東西。那位工程師看到的「空白視窗」，就是還沒建立任何專案時的正常畫面。

改版還帶來三件對工程師有感的事：可以同時派好幾個代理程式平行做事、可以設排程讓它在背景跑、以及原生語音指令。整個 2.0 生態拆成四塊：桌面應用、agy 命令列工具、自訂代理程式用的 SDK，以及企業版的代管代理程式服務，四者共用同一套核心，所以在桌面應用裡調好的行為，搬到 CLI 或 CI 裡跑會是一致的。

如果你想知道這套跟 Claude Code、Codex 這些同類工具擺在一起實際差在哪，我們另外寫過一篇三大代理程式工具的實測比較，那篇比較適合拿來做選型決策。至於它跟 GitHub Copilot、Cursor 這種還留在編輯器內的工具怎麼取捨，可以看Copilot、Cursor 與 Antigravity 的定位比較。想先了解 2.0 換上 Gemini 3.5 Flash 之後實際跑起來的感受，我們在Antigravity 2.0 與 Gemini 3.5 Flash 的評測裡有比較完整的紀錄。

動手裝之前，要先確認哪些事？

機器撐不撐得住

系統需求這塊卡掉的人比想像中多，尤其是 Mac 用戶。以下是查證當下官方與各方資料整理出來的狀況：

Linux 那組數字看起來很抽象，實際確認只要兩行指令。在終端機裡跑 ldd --version 看 glibc，再跑 strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX | tail -1 看 glibcxx。手上如果是 CentOS 7 那種老骨頭，glibc 停在 2.17，就不用試了，桌面應用裝不起來，這種情況直接跳到後面的 agy 命令列工具比較實際。

帳號與費用

Antigravity 一定要 Google 帳號才能動，它靠帳號對應速率限制與同步專案設定。企業如果用 Google Workspace 帳號，要留意管理員有沒有擋掉第三方應用授權，這在台灣的公司很常見，卡住的話得先找 IT 開權限。

費用要講得精確一點，因為這裡是謠言最多的地方。目前確實有免費層，不用綁信用卡。往上是 Google AI Pro 每月二十美元，Google AI Ultra 每月一百美元（額度是 Pro 的五倍），最頂的方案在 I/O 時從兩百五十美元降到兩百美元（額度是 Pro 的二十倍）。

額度怎麼算才是重點。Google 在 2025 年 12 月調整過規則：Pro 與 Ultra 訂閱戶享有優先存取，額度每五小時刷新一次；免費層改成以週為單位的較大額度，官方說法是避免使用者在專案做到一半就撞上限。這裡有個很多文章不敢講的事實：Google 從頭到尾沒有公布免費層的精確次數，額度是按代理程式「實際做了多少工」在扣，不是算你送出幾則訊息。所以別的站台寫的「每天 20 次」「每天 250 次」，都不是官方說法。

實務體感是：免費層拿來回答「這套工具適不適合我」綽綽有餘，但一旦開始把任務丟給代理程式然後走開，額度消耗會非常快，撐不起每天的主力開發。若打算靠平行派工壓縮時程，可以先看我們在多模型平行作業的實測裡記錄的消耗速度，再決定要不要付費。

各平台實際怎麼裝？

官方唯一的下載來源是 antigravity.google/download。搜尋 Antigravity 會跑出一堆網域長得很像官方的站，內容多半是農場文，有些還提供來路不明的安裝檔。一個要你登入 Google 帳號、待會還會拿到本機檔案讀寫權限的軟體，請務必從官方網域下載。

macOS

1. 到 antigravity.google/download，選 Apple Silicon 版本，檔案大約 150 到 200 MB。
2. 開啟下載回來的 .dmg，把 Antigravity 圖示拖進「應用程式」資料夾。
3. 第一次開啟時 macOS 的 Gatekeeper 可能會擋，到「系統設定」的「隱私權與安全性」裡按「仍要開啟」。
4. 程式會跳出登入畫面，用 Google 帳號完成驗證後按「Open Antigravity」。

Windows

1. 到下載頁抓 Windows 安裝檔，注意分辨 x64 與 ARM64（Surface 那類機器要選後者）。
2. 執行安裝檔，跑完會直接開啟登入畫面。
3. 用 Google 帳號登入。

Windows 有個已知狀況：某些防毒軟體會讓 Antigravity 開起來變成一片黑畫面。這在 2.3.0 版（2026 年 7 月 13 日）已經修掉，版本較舊又遇到黑畫面的話，先更新再說，不要急著重裝或砍防毒。

Linux

Linux 提供 .tar.gz 壓縮檔，解開後直接執行裡面的執行檔即可，但多半會想把它註冊成正常的應用程式，不然每次都要進解壓縮目錄執行。把執行檔路徑加進 PATH，或補一個 .desktop 檔案丟到 ~/.local/share/applications/，桌面環境就抓得到了。

agy 命令列工具

命令列工具跟桌面應用是分開安裝的，這是很多人漏掉的一步。查證當下的版本是 1.1.3（2026 年 7 月 16 日釋出），更新頻率相當高。安裝指令依平台分成三種：

macOS 與 Linux：

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows PowerShell：

irm https://antigravity.google/cli/install.ps1 | iex

Windows 命令提示字元：

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

macOS 如果偏好套件管理員，也可以用 brew install --cask antigravity-cli。如果貴公司的資安政策不允許 curl 接 bash 這種安裝方式（這是很合理的政策），Homebrew 這條路會比較好過審。

安裝完成後，binary 會落在 macOS 與 Linux 的 ~/.local/bin/agy，Windows 則是 C:\Users\<使用者名稱>\AppData\Local\agy\bin。確認這個路徑在 PATH 裡面，然後驗證：

agy --version

有回版本號就成功了。直接輸入 agy 會進入它的終端機介面。第一次執行會走 Google 登入，它預設會把憑證存進系統的 keyring。如果你是在遠端主機上透過 SSH 操作，它會偵測到環境，改成印一段授權網址讓你在本機瀏覽器完成登入，這個設計在跳板機環境裡很實用。要清掉憑證的話在介面裡打 /logout。

第一個專案該怎麼配置？

裝完打開，看到的就是那個「空白視窗」。專案的建立流程是這樣：

1. 先在本機建好一個資料夾，例如 mkdir -p ~/agy-projects/my-first-project。這步不要跳過，Antigravity 不會幫你憑空生一個乾淨的目錄，先有資料夾再有專案。
2. 在應用裡點「Select Project」，選「New Project」。
3. 點「Add Folder」，指到剛剛建立的資料夾。這裡可以加不只一個資料夾，這正是 2.0 以專案為中心的設計：一個專案可以同時涵蓋前端儲存庫、後端儲存庫、甚至一份放規格的文件目錄。
4. 按「Next」進到安全性設定。
5. 初次上手選「Default」即可。
6. 幫專案命名，按「Create」。

第五步是整個安裝流程裡唯一值得停下來想一下的地方。這個對話框決定代理程式能碰到什麼：哪些檔案能改、哪些指令能不經同意就執行、能不能連外網。預設值相對保守，會在動作前問你。很多人嫌煩，第一天就全開成自動同意，然後某天代理程式為了「清理環境」把一個沒被追蹤的目錄砍了。

我們的建議是反過來：先維持預設，摸清楚代理程式在這個專案裡的行為模式，再逐項放寬。真要跑高自主度的任務，正確做法是開沙箱，不要拿正式環境去賭。這塊我們整理過一篇安全模式與沙箱設定指南，放寬權限前值得先看過。

專案建好後，主畫面幾個區塊先認一下：左側是專案清單，中間是對話區（模型選單就在這裡），輔助面板（Auxiliary Pane）可以開起來看代理程式產出的檔案、截圖或報告，齒輪圖示是這個專案專屬的設定，權限要改也是回到這裡。

怎麼讓代理程式真的動起來？

裝完之後最常見的失敗不是技術問題，是指令下得太籠統。很多人開場就打「幫我做一個網站」，然後看著代理程式跑了十分鐘，產出一個跟預期毫無關係的東西，就下結論說這工具不好用。

比較會成功的下法是給它一個有明確驗收條件的任務。舉個實際的例子，假設專案裡是一支 Laravel 應用，與其說「優化效能」，不如說：「讀 app/Http/Controllers 底下的程式，找出有 N+1 查詢問題的地方，用 eager loading 修掉，改完跑 php artisan test 確認測試都過，最後把你改了哪些檔案、每個檔案改了什麼、為什麼這樣改列成一份清單。」

這段話裡有五個元素：範圍（哪個目錄）、要找什麼（N+1）、怎麼修（eager loading）、怎麼驗證（跑測試）、交付什麼（清單）。給了驗證方式，代理程式才有辦法自己判斷做完了沒有，這是它跟補完外掛最大的差別，也是值得花時間學的原因。更多下指令的模式，我們在Antigravity 實戰教學裡有完整範例。

跑起來之後，對話區會顯示它的思考過程與執行的指令，輔助面板則累積它的產出。這時候你比較像審查者：盯著它跑，不對勁就中斷。2.3.0 之後新增了訊息佇列，可以趁它還在忙先把下一個指示排進去，也可以按「Send Now」插隊。

習慣這種節奏之後，下一步通常是同時開好幾個代理程式：一個修 bug、一個寫測試、一個整理文件。這是 2.0 真正的價值所在，也是它跟編輯器內建 AI 拉開差距的地方，不過調度多個代理程式有自己的一套方法論，我們把它獨立寫成了多代理工作流教學。若代理程式之間還需要互相溝通協作，那會進到 A2A 協定的範疇。

另外兩件事會讓體驗差很多：一是讓代理程式能呼叫外部工具（讀資料庫、打公司內部 API），這牽涉到 MCP，概念可以看MCP、API 與 CLI 的差別；二是把重複的流程包成可重用的能力，這在 Agent Skills 的整理裡有跨工具比較。兩者都不是第一天要碰的，但遲早會需要。

裝不起來或跑不動時，先查哪裡？

把我們自己與客戶實際遇過的狀況整理成一份清單，照順序查通常很快能定位：

• 畫面跟教學對不上：先確認你看的教學是 2026 年 5 月之後寫的。這是目前最高頻的「問題」，而它根本不是問題。
• Windows 開起來一片黑：某些防毒軟體造成的，2.3.0 已修正，先更新到最新版。
• Linux 裝不起來或執行時噴 GLIBC 相關錯誤：用 ldd --version 確認 glibc 有沒有到 2.28。老舊發行版沒救，改用 agy。
• agy: command not found：安裝成功但 PATH 沒設。確認 ~/.local/bin 在 PATH 裡，或先用絕對路徑 ~/.local/bin/agy --version 驗證。
• 登入卡住或轉圈：Google Workspace 帳號常見，多半是管理員擋了第三方應用授權。換個人 Gmail 帳號測一下就能分辨是不是這個原因。
• SSH 遠端登入不了：agy 會印一段授權網址，要在本機瀏覽器開那段網址完成，不是在遠端主機上開。
• 代理程式跑到一半停住：多半是額度用完了，訂閱戶每五小時刷新，免費層以週計。這也最容易被誤判成「當機」。
• 代理程式一直在問可不可以：專案權限設定太保守，到齒輪圖示裡逐項放寬，別一次全開。
• 產出品質忽好忽壞：先確認模型選單選的是哪顆。預設是 Gemini 3.5 Flash，需要長鏈推理的任務可以換更強的模型再試。

什麼情況下不該用 Antigravity？

寫安裝教學的人通常不會講這段，但這對評估工具的人比安裝步驟更有價值。以下情況我們會直接建議客戶先別導入：

程式碼不能離開公司的環境。這是台灣金融、醫療、以及接政府案子的團隊會直接卡死的第一關。代理程式要把程式碼送到 Google 的模型推理，沒有妥協空間。合規紅線在前面，後面的功能再好都沒有意義。

專案本身沒有任何測試。代理程式的價值高度依賴「它能自己驗證做完了沒有」。一個沒有測試、沒有型別、沒有 lint 的老專案，代理程式改完根本無從判斷對錯，審查改動的時間會比自己寫還久。正確順序是先補上驗證機制，再談自動化。

團隊還沒有程式碼審查的習慣。代理程式產出程式碼的速度比人快好幾倍，原本就沒人在審的話，Antigravity 只會讓技術債長得更快。導入前該想清楚的風險，我們整理在開發者風險管理指南裡。

需求只是補完，不到派工。如果日常就是寫程式時有人幫忙補下一行，留在 VS Code 加個外掛會更順手，Antigravity 這套派工模型會是多餘的認知負擔。

機器太舊。Intel Mac 與老 Linux 發行版的狀況前面提過，與其花一個下午跟安裝檔搏鬥，不如直接評估 agy 或別的工具。

資料來源

本文查證於 2026 年 7 月 17 日。Antigravity 改版速度非常快（桌面應用在 7 月 13 日才更新到 2.3.0，agy 在 7 月 16 日更新到 1.1.3），實際操作時請以官方文件的當下版本為準：

• Google Antigravity 官方網站與官方下載頁（系統需求與安裝檔以此為準）
• Getting Started with Google Antigravity（Google Codelabs 官方教學），專案建立流程與 UI 名稱依此核對
• google-antigravity/antigravity-cli（官方 CLI 儲存庫），安裝指令與登入機制依此核對
• I/O 2026 developer highlights: Antigravity, Gemini API, AI Studio（Google 官方部落格）
• Google AI Pro and Ultra subscribers now have higher rate limits for Google Antigravity（Google 官方公告），額度刷新規則依此核對
• Google launches Antigravity 2.0 with an updated desktop app and CLI tool at IO 2026（TechCrunch），方案價格依此核對

延伸閱讀

• Antigravity、Claude Code 與 Codex 實測比較：選型階段最該先看的一篇
• 多代理工作流教學：裝完之後，怎麼同時調度好幾個代理程式
• 安全模式與沙箱設定指南：放寬權限之前的必修課
• Antigravity 2.0 與 Gemini 3.5 Flash 評測：新版實際跑起來的完整紀錄

裝起來之後，才是真正的問題

把 Antigravity 裝好、跑通第一個專案，一個下午就能搞定，這篇也就講到這裡。真正難的是下一步：把這套東西放進一間公司的開發流程裡。誰有權限讓代理程式碰正式環境的資料庫？它產出的程式碼要不要走跟人一樣的審查？公司內部那些沒有公開文件的 ERP、客服系統與舊 API，怎麼包成代理程式能安全呼叫的工具？十個人共用額度怎麼分才不會互相卡住？

我們幫客戶導入這類代理程式工作流時，八成以上的時間都花在這些問題上，跟安裝完全無關，費用也依整合深度落在幾萬到幾十萬不等。如果已經在公司內部試出成效，正在想怎麼從個人工具變成團隊的標準流程，或要接上既有系統，AI 自動化開發是我們實際在做的事，歡迎直接找我們聊聊目前卡在哪個環節。