先跟大家坦白一件事：阿正老師之所以會一路用 Antigravity IDE 寫程式，其實理由沒有多高尚——因為我有訂閱 Google AI Pro，每個月錢都繳了，額度放著不用實在太浪費。可是問題來了，我原本的工作環境是 VS Code，一堆佈景主題、快捷鍵、Git 外掛、專案設定全都在裡面，官方那套搭配 Gemini CLI 的「Gemini CLI Companion」延伸套件我怎麼用都不順手，感覺就像是把終端機硬塞進編輯器的側邊欄，看程式碼還是得切來切去。
於是我只好走上另一條路：再裝一套 Antigravity IDE。功能是真的強，但代價就是電腦裡同時擺著兩套幾乎長一樣的編輯器，套件要裝兩次、設定要調兩次，而且 Antigravity IDE 是 VS Code 的分支版本，有些我慣用的擴充套件根本裝不回去。每次開機看到工作列上兩隻長得很像的圖示，心裡都有點微妙。
結果 2026 年 8 月 20 日，Google 官方部落格丟出了一篇「Introducing IDE Extensions」——他們把 Antigravity 做成正式的 VS Code 延伸模組了，而且順便支援 Visual Studio、JetBrains、Zed 跟 Xcode。也就是說，不用換編輯器、不用裝第二套 IDE，在你原本的 VS Code 裡就能用 Gemini 與 Claude 的 AI 代理。這對我來說簡直是等了半年的消息，這篇就來完整介紹它怎麼裝、能做什麼，以及最多人會問的：那我還需要 Antigravity IDE 嗎？
文章目錄
一、Antigravity 延伸模組是什麼？先搞懂 Google 的四種 Antigravity
在講安裝之前，得先幫大家把名詞理清楚，不然真的很容易買錯票上錯車。Google 現在同一個「Antigravity」品牌底下，其實有四種不同的產品，彼此的定位差很多：
| 產品名稱 | 是什麼 | 適合誰 |
|---|---|---|
| Antigravity 2.0 | 旗艦級的獨立應用程式，主打多個 AI 代理人同時協作、遠端遙控 | 想把整包工作丟給 AI 跑的重度使用者 |
| Antigravity IDE | 以 VS Code 為基礎改造的獨立編輯器，需另外下載安裝 | 願意整套換掉編輯器的人 |
| Antigravity CLI（agy） | 終端機指令列版本 | 習慣在命令列工作的人 |
| Antigravity 延伸模組 （本文主角） |
裝在你「原本」的 VS Code 上的官方外掛 | 不想換編輯器、想保留現有工作環境的人 |
簡單講，前面三個都是要你「搬家」，只有延伸模組是「把 AI 請到你家來」。這次 Google 一口氣推出的延伸模組不只 VS Code，還包含 Visual Studio（Preview 預覽階段）、JetBrains 系列（IntelliJ IDEA、PyCharm、WebStorm、GoLand、CLion、Rider 等，需 2026.2.1 以上版本）、Zed，以及 Xcode（需 Xcode 27 beta 6 以上）。以完整度來說，目前 VS Code 版是最成熟的一個。
| 官方網站 | https://antigravity.google/docs/ide/extensions/vscode/ |
| 最新版本 | 2.5.5（延伸模組上架日期 2026-08-20） |
| 系統需求 | Visual Studio Code 1.90 以上；Windows / macOS / Linux 皆可 |
| 費用 | 免費（個人方案 $0／月即可使用，訂閱 Google AI Pro / Ultra 可獲得更寬鬆的額度） |
| 繁體中文介面 | ❌ 目前側邊欄介面為英文（可用中文對話，正式中文化與否待確認） |
| 開發者 | Google（Marketplace 上有官方驗證標記，發行者為 google.com） |
| 軟體下載 | [Visual Studio Marketplace 官方下載頁] [Antigravity IDE本站下載點] |
二、安裝與登入：三個步驟就搞定
安裝過程比想像中簡單，不需要先裝 Antigravity IDE，也不需要先手動裝 CLI，照著做就行：
步驟一：開啟擴充套件面板
在 VS Code 中按下 Ctrl+Shift+X（macOS 為 Cmd+Shift+X），或直接點左側活動列的積木圖示。
步驟二：搜尋並安裝
輸入「Google Antigravity」，注意要找發行者為 Google（有藍色驗證標記）的那一筆。市集上同名的第三方套件不少（像是各種額度監控面板、CLI 橋接工具），別裝錯了。確認後按下「安裝」。
步驟三：登入 Google 帳號
安裝完成後，左側活動列會多出一個 Antigravity 圖示，點下去就會出現登入畫面。點擊 Sign In 後會跳到瀏覽器完成 Google 帳號授權，授權完自動導回 VS Code。首次啟動時，延伸模組會自動在你的電腦上安裝 agy 後端服務，這一步官方文件有明講，所以看到它在背景裝東西不用緊張。
三、介面導覽：側邊欄、模型選單與斜線指令
裝好之後，整個使用體驗大概就是「VS Code 右邊多了一個很能幹的側邊欄」。以下是幾個實際打開來會看到的東西：
1. 側邊欄對話與快捷鍵
按 Ctrl+L（macOS 為 Cmd+L）可以開關對話面板，Ctrl+Shift+L 則是開一個全新的對話。延伸模組還會自動同步你目前的 VS Code 佈景主題，所以視覺上不會有那種「外掛硬插進來」的違和感。
2. 斜線指令（Slash Command）
在輸入框打一個「/」，就會跳出可用的指令清單。官方內建的包含：
goal：設定一個目標，讓 AI 一路跑到完成為止schedule：把指令排程，定期執行或指定時間執行一次browser：呼叫瀏覽器代理人去處理網頁相關任務grill-me：讓 AI 反過來「拷問」你，把需求問清楚再動手teamwork-preview：召喚一整組代理人團隊分頭處理任務（預覽功能）learn：讓 AI 回顧剛才做對或做錯的地方，累積成可重複使用的經驗
阿正老師個人覺得 grill-me 是最被低估的一個。很多時候 AI 寫歪不是它笨，是我們自己需求講得太含糊，讓它先反問幾輪再開工，成功率明顯不一樣。
3. 模型選單
輸入框下方可以直接切換模型。實際打開來會看到 Gemini 3.7 Flash（預設）、Gemini 3.6 Flash、Gemini 3.5 Flash、Gemini 3.1 Pro，以及 Claude Sonnet 4.6（Thinking）、Claude Opus 4.6（Thinking）、GPT-OSS 120B。沒錯，Google 自家的工具裡可以直接叫 Anthropic 的 Claude 出來幫你寫程式，這在現在的 AI 生態裡算是相當務實的做法。
4. 行內 diff 與逐段接受
AI 改的每一處程式碼都會以行內比對（inline diff）呈現，你可以按 Alt+Enter 一段一段接受，也可以整個檔案 Accept All / Reject All。這比某些工具直接改完再叫你自己去 Git 裡找差異，友善太多。
5. 子代理人（Subagent）與沙箱
遇到大工程時，主代理人會自己開分身出來幫忙，官方內建三種：research 負責爬過整包專案、建立索引與架構圖；browser 會開一個無頭 Chrome 去跑網頁整合測試、驗證畫面有沒有改壞；self 則是複製自己來平行處理。這些分身還可以選擇工作模式：直接在同一個資料夾動工（inherit）、開一個獨立的 Git worktree（branch），或多個分身共用一個同步目錄（share）。
6. MCP 外部工具連接
延伸模組支援 MCP（Model Context Protocol，讓 AI 連接外部工具與資料庫的開放協定），可以接 GitHub、Postgres、Slack、Jira 等常見服務。設定檔位置是全域的 ~/.gemini/config/mcp_config.json 或專案層級的 .agents/mcp_config.json。官方也強調資料庫密碼只留在你本機的設定檔裡，模型只會拿到結構與查詢語句。
四、免費額度怎麼看？Gemini 和 Claude 是兩個獨立水桶
這大概是最多人關心、卻也最少人講清楚的一段。點開模型選單最下方的「View Usage」，就能看到目前的額度狀態，而它的分法很有意思：
| 額度分組 | 週額度（Weekly Limit） | 5 小時額度（Five Hour Limit） |
|---|---|---|
| Gemini 模型 | 獨立計算 | 獨立計算 |
| Claude 與 GPT 模型 | 獨立計算 | 獨立計算 |
重點來了：Gemini 系列與 Claude／GPT 系列是「兩個完全分開的水桶」。這代表當你的 Gemini 週額度快見底時，還可以切到 Claude Sonnet 4.6 繼續工作，兩邊互不影響。這個設計對免費使用者特別友善，等於變相多了一組備援額度。
另外每一組又細分成「週額度」與「5 小時額度」兩層——短時間內狂用會先撞到 5 小時的牆，整週累積用量則由週額度控管。這個雙層結構跟 Claude Code 的額度機制概念相當接近，用過的朋友應該不陌生。
五、延伸模組 vs Antigravity IDE：我該裝哪一個？
這應該是本文最多人想看的一段。既然延伸模組這麼方便，那原本的 Antigravity IDE 是不是可以直接刪了？答案是「看你怎麼用」，而且有幾個關鍵差異值得先知道。
首先要理解 Google 自己的定位。官方在部落格裡講得很直白：他們認為未來的主戰場是 Antigravity 2.0 或 CLI 這類「以代理人為核心」的環境，而編輯器的角色，是當你需要深入看某段實作、檢查編譯器錯誤、或用互動式除錯器一步步追邏輯時才回來用的工具。所以他們刻意把延伸模組做成「輕量、高效能的整合」，而不是把 VS Code 硬改造成一個笨重的多代理人中心。
白話翻譯：延伸模組是輕量版，不是 Antigravity IDE 的完整替代品。以下是兩者的具體比較：
| 比較項目 | Antigravity VS Code 延伸模組 | Antigravity IDE（獨立編輯器） |
|---|---|---|
| 安裝方式 | 在原本的 VS Code 裝一個外掛 | 下載整套編輯器另外安裝 |
| 原有擴充套件 | ✅ 完整保留，不受影響 | ⚠️ 需重裝，且部分套件受限 |
| 套件市集 | 微軟官方 VS Code Marketplace | 走 OpenVSX，微軟部分授權套件（如 C# Dev Kit）無法使用 |
| 設定與快捷鍵 | ✅ 沿用原本的 | ❌ 需重新設定一次 |
| AI 代理與子代理人 | ✅ 支援 | ✅ 支援 |
| 瀏覽器代理／錄影成果 | ✅ 支援 | ✅ 支援（原生整合更完整） |
| Tab 智慧補完（Supercomplete 等） | 待確認（官方功能清單未特別列出） | ✅ 完整支援 |
| 企業版支援 | ✅ 支援 Gemini Enterprise、Google Cloud IAM 與 VPC-SC | ❌ 官方文件明載不支援企業客戶 |
| 佔用空間 | 一個外掛 +agy 後端服務 |
整套編輯器（等於第二個 VS Code） |
接著是實際用起來的優缺點整理：
✅ 優點
- 不用換編輯器，原有套件、設定、快捷鍵全部保留
- Google 官方出品、有驗證標記，不是第三方套件
- 免費方案就能用，有訂閱 Pro／Ultra 額度更多
- 同時提供 Gemini 與 Claude 模型，且額度分開計算
- 支援 MCP，可接資料庫與外部工具
- 行內 diff 逐段接受，改動看得見、擋得住
- 自動同步佈景主題，視覺上不突兀
- 企業版可走 Google Cloud 治理架構
⚠️ 缺點
- 介面目前是英文，沒有繁體中文化
- 官方定位為「輕量版」，多代理人協作仍以 2.0 為主
- Tab 智慧補完是否完整提供，官方未明確說明
- 會在本機安裝
agy背景服務，介意的人要留意 - 免費額度數值未公開，且曾多次調整
- 在 VPN／代理伺服器環境下有登入失敗的災情回報
- 市集上同名第三方套件多，容易裝錯
六、常見問題與注意事項
最後整理幾個安裝前後可能會遇到的狀況，先看過可以少走冤枉路：
Q1：側邊欄一片黑、登入一直失敗怎麼辦？
Google AI 開發者論壇上有使用者回報，在使用系統代理伺服器、多網卡或 TUN 虛擬網卡（常見於某些 VPN 工具）的環境下，agy 後端的 Google OAuth 驗證流量可能沒有正確走代理，導致登入卡住、側邊欄空白。台灣有在掛 VPN 的朋友如果遇到這狀況，可以試著先暫時關閉代理／VPN 再登入一次。這是目前已知的問題，後續是否修正待確認。
Q2：畫面上出現「⚠️ MCP Error」是怎麼回事？
這通常代表你設定的某一個 MCP 伺服器沒有正常啟動或連線失敗（例如指令路徑錯誤、相依套件沒裝、或該服務本身掛了）。它不會影響一般對話功能，只是那個外部工具暫時用不了。檢查 mcp_config.json 裡的設定即可，如果你完全沒設定過 MCP，可以直接忽略。
Q3：可以用中文跟它對話嗎？
可以，直接用繁體中文下指令沒問題。但要注意介面選單本身是英文，這跟 VS Code 有沒有裝中文語言包無關。
Q4：AI 會不會亂執行終端機指令？
不會，這部分可以自己控管。在 Agent Settings 裡有兩種模式：「Request Review」代表除了你允許清單裡的指令外，一律要先問過你；「Always Proceed」則是除了拒絕清單以外都自動執行。另外預設情況下，代理人只能存取你的專案資料夾，要動到工作區以外的檔案必須另外開權限。剛開始使用建議先維持 Request Review，用熟了再放寬。
Q5：裝了延伸模組後，Antigravity IDE 要不要刪掉？
兩者可以並存，帳號與額度是共用的（登入同一組 Google 帳號即可）。阿正老師的建議是先兩邊都留著用一陣子，觀察自己實際比較常開哪一個，再決定要不要清掉。
七、阿正老師的總結
已經在 VS Code 住很久，不想換編輯器的人
→ 直接裝 Antigravity 延伸模組。設定、套件、快捷鍵全部留著，AI 只是多開一個窗口進來幫忙，這是目前門檻最低的入門方式。
習慣「丟一個任務讓 AI 自己跑很久」的重度使用者
→ 還是以 Antigravity 2.0 為主。多代理人協作與長時間任務是它的主場，延伸模組定位在輕量整合，兩者搭配使用效果最好。
公司團隊要導入、在意程式碼外洩與合規的人
→ 選延伸模組或 Antigravity CLI。可用 Gemini Enterprise 帳號登入，走 Google Cloud 服務條款、IAM 與 VPC-SC，程式碼不會被用來訓練模型；Antigravity IDE 反而不支援企業客戶。
只是想免費試試看 AI 寫程式的新手
→ 免費方案就能玩。不用訂閱、不用信用卡，先用 grill-me 讓它問清楚你的需求，再讓它動手，是最不容易翻車的起手式。
終於不用養兩套編輯器了
回頭看，Google 這一步走得算晚但走對了。過去要用 Antigravity 就得整套搬家，光是「重裝三十個擴充套件」這件事，就足以把很多人擋在門外。現在它願意乖乖當一個外掛，住進大家原本的 VS Code 裡，等於把門檻降到幾乎為零。當然，這也代表 AI 編輯器的戰場又更擁擠了一點——Cursor、Copilot、Claude Code、Antigravity，每一家都想住進你的側邊欄。你目前最順手的是哪一套呢？
歡迎在下面留言跟阿正老師分享！
