建立 2026-09-19 更新 2026-09-19

安裝與登入

裝擴充套件只要幾個步驟，但 Marketplace 上有不少名稱相近的第三方工具，所以要先認清哪一個才是官方的。

需求

• Visual Studio Code 1.90 或更新版本（macOS、Linux、Windows 皆可）。
• 有 Antigravity 使用資格的 Google 帳號：任何 Antigravity 方案（含免費）都行；企業帳號需啟用 Gemini Enterprise。

安裝步驟

1. 開啟 VS Code，按 Ctrl+Shift+X（macOS 為 Cmd+Shift+X）開啟擴充功能（Extensions）檢視。
2. 搜尋 Google Antigravity，確認發布者是 Google，按下 Install。
3. 點左側活動列（Activity Bar）的 Antigravity 圖示，依畫面指示用 Google 帳號登入。
4. 首次啟動時，擴充套件會自動安裝本機的 agy 後端服務，等它完成即可開始使用。

也可以用 VS Code 的命令列安裝：

code --install-extension Google.google-antigravity

安裝後打開專案資料夾，右側就會出現 Antigravity 面板。

分辨官方與非官方

在 Marketplace 搜尋 antigravity，會看到其他開發者做的工具，例如只是在側邊開啟 agy 終端機的啟動器，或自製聊天介面。它們不是 Google 官方產品，功能與安全性各自負責。安裝前確認三件事：

登入與帳號

Antigravity 在所有入口使用統一登入：登入一次，方案資格、權限設定與對話紀錄就會在擴充套件、CLI 與 2.0 之間同步。企業與團隊的驗證方式（Gemini Enterprise 與 Google Cloud 憑證）請見官方驗證文件裡的連結。

常見狀況

• 看不到面板：確認 VS Code 版本至少 1.90；點活動列的 Antigravity 圖示，或重新載入視窗。
• 出現 “Pre-Tool Execution Hook Issue detected”：這是官方文件列出的已知狀況：代理無法直接寫檔，會把程式碼印在任務面板，需要你手動複製貼上到檔案。
• 想用終端機版：擴充套件不影響 CLI，兩者可以並存，見 CLI 安裝。

完成後繼續看 日常工作流程。