安装与初始设置
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 仍然要按同样的权限策略治理。