安裝與初始設定
Antigravity 入門安裝、個人 Gmail 登入、setup flow、安全策略選擇和第一次只讀驗證。
Antigravity 的入門目標不是“儘快讓它改程式碼”，而是先把安裝、登入、工作區、許可權策略和第一次只讀任務跑通。它能訪問 editor、terminal 和 browser，第一天就給過高許可權會讓後續排障變難。
推薦路徑：安裝 Antigravity → 用 Google 賬號登入（個人 Gmail 或團隊 Workspace 賬號均可，團隊仍處 preview 階段）→ 選擇 Review-driven development → 開啟一個測試 workspace → 先讓 agent 解釋專案結構，不讓它改檔案。
1. 準備條件
Google Codelab 給出的入門條件很直接：
| 專案 | 建議 |
|---|---|
| 賬號 | Google 賬號（個人 Gmail 或團隊 Workspace 賬號；團隊當前處 preview 階段） |
| 瀏覽器 | Chrome |
| 本地安裝 | 從 Antigravity 下載頁安裝本機應用 |
| 系統 | Mac、Windows、部分 Linux 發行版 |
| 第一次任務 | 使用測試目錄，不要直接開啟生產倉 |
Antigravity 處於產品快速迭代階段。系統支援、額度、模型列表、定價都以官方下載頁和 pricing 頁為準，不要把某次截圖當長期事實。
2. 安裝流程
標準安裝路徑：
- 開啟 Antigravity 下載頁。
- 選擇當前作業系統對應的安裝包。
- 安裝並啟動 Antigravity。
- setup flow 中選擇是否匯入 VS Code / Cursor 設定。
- 選擇主題、快捷鍵、擴充套件和 command line tool。
- 登入 Google 賬號。
- 完成 Terms of Use 與 telemetry 相關選擇。
如果你已經有 VS Code 或 Cursor 配置，先不要急著匯入全部設定。第一次最好 fresh start，避免把舊擴充套件、舊鍵位、舊許可權一起帶進來，後續再按需遷移。
3. 初始許可權策略
Antigravity setup flow 會讓你選擇 agent 自治程度。核心其實是三類策略：
| 策略 | 控制什麼 | 第一推薦 |
|---|---|---|
| Terminal Execution policy | agent 能否自動跑 terminal 命令 | Request Review |
| Artifact Review policy | task list、implementation plan、walkthrough 是否需要審閱 | Asks for Review |
| JavaScript Execution policy | browser agent 是否能自動執行網頁 JavaScript | Request Review 或 Disabled |
Google Codelab 推薦 Review-driven development，因為它在速度和控制之間更平衡。對於真實專案，這也是更穩的起點。
flowchart TD
Start["第一次設定"] --> Review["Review-driven development"]
Review --> ReadOnly["只讀解釋專案"]
ReadOnly --> OneFile["單檔案小改"]
OneFile --> Browser["瀏覽器截圖驗收"]
Browser --> Allow["再逐步加入 allowlist"]
Start --> AgentDriven["Agent-driven development"]
AgentDriven --> Risk["不建議第一天用於真實專案"]
style Review fill:#dcfce7,stroke:#22c55e
style Risk fill:#fee2e2,stroke:#ef4444,stroke-width:2px4. 第一個 workspace
啟動後通常會看到 Open Folder、Open Agent Manager、Clone Repository 這類入口。第一次建議：
- 新建一個空測試目錄。
- 透過
Open Folder開啟這個目錄。 - 不連線生產賬號、不放金鑰、不放真實客戶資料。
- 先建立一個最小 demo 專案，觀察 agent 的計劃、diff、artifact 和許可權請求。
不要把 ~/.ssh、~/.config、iCloud 同步目錄、包含 .env 的大儲存庫當作第一天測試 workspace。Antigravity 預設限制在 workspace 內是好事，不要過早開啟非 workspace file access。
5. 第一次只讀任務
可以用這樣的 prompt：
请只读分析这个 workspace。不要创建、修改或删除任何文件。输出：
1. 当前目录结构
2. 你判断这是什么项目
3. 如果后续要修改，风险最高的 3 个位置
4. 建议第一步最小验证任务驗收標準：
| 檢查點 | 透過標準 |
|---|---|
| 沒有改檔案 | Git diff 為空或目錄無新增檔案 |
| 有結構判斷 | 不只是複述檔名 |
| 有風險提示 | 能指出金鑰、構建、資料庫、部署等風險層 |
| 有下一步建議 | 給出單檔案、小範圍、可回退任務 |
6. 安裝命令列入口
setup flow 中可以安裝 command line tool，用於從終端開啟 Antigravity。官方 Codelab 展示的命令名是 agy。
命令列入口適合“從當前專案目錄開啟 Antigravity”，不是讓你繞過許可權審閱。終端裡啟動以後，workspace 仍然要按同樣的許可權策略治理。