---
title: "安装与初始设置"
description: "Antigravity 入门安装、个人 Gmail 登录、setup flow、安全策略选择和第一次只读验证。"
verifiedAt: "2026-05-05"
---

Antigravity 的入门目标不是“尽快让它改代码”，而是先把安装、登录、工作区、权限策略和第一次只读任务跑通。它能访问 editor、terminal 和 browser，第一天就给过高权限会让后续排障变难。

> [!NOTE]
> **推荐路径**：安装 Antigravity → 用 Google 账号登录（个人 Gmail 或团队 Workspace 账号均可，团队仍处 preview 阶段）→ 选择 Review-driven development → 打开一个测试 workspace → 先让 agent 解释项目结构，不让它改文件。

## 1. 准备条件

Google Codelab 给出的入门条件很直接：

| 项目 | 建议 |
| --- | --- |
| 账号 | Google 账号（个人 Gmail 或团队 Workspace 账号；团队当前处 preview 阶段） |
| 浏览器 | Chrome |
| 本地安装 | 从 Antigravity 下载页安装本机应用 |
| 系统 | Mac、Windows、部分 Linux 发行版 |
| 第一次任务 | 使用测试目录，不要直接打开生产仓 |

> [!IMPORTANT]
> Antigravity 处于产品快速迭代阶段。系统支持、额度、模型列表、定价都以官方下载页和 pricing 页为准，不要把某次截图当长期事实。

## 2. 安装流程

标准安装路径：

1. 打开 [Antigravity 下载页](https://antigravity.google/download)。
2. 选择当前操作系统对应的安装包。
3. 安装并启动 Antigravity。
4. setup flow 中选择是否导入 VS Code / Cursor 设置。
5. 选择主题、快捷键、扩展和 command line tool。
6. 登录 Google 账号。
7. 完成 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，因为它在速度和控制之间更平衡。对于真实项目，这也是更稳的起点。

```mermaid
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:2px
```

## 4. 第一个 workspace

启动后通常会看到 `Open Folder`、`Open Agent Manager`、`Clone Repository` 这类入口。第一次建议：

1. 新建一个空测试目录。
2. 通过 `Open Folder` 打开这个目录。
3. 不连接生产账号、不放密钥、不放真实客户数据。
4. 先建立一个最小 demo 项目，观察 agent 的计划、diff、artifact 和权限请求。

> [!WARNING]
> 不要把 `~/.ssh`、`~/.config`、iCloud 同步目录、包含 `.env` 的大仓库当作第一天测试 workspace。Antigravity 默认限制在 workspace 内是好事，不要过早开启非 workspace file access。

## 5. 第一次只读任务

可以用这样的 prompt：

```text
请只读分析这个 workspace。不要创建、修改或删除任何文件。输出：
1. 当前目录结构
2. 你判断这是什么项目
3. 如果后续要修改，风险最高的 3 个位置
4. 建议第一步最小验证任务
```

验收标准：

| 检查点 | 通过标准 |
| --- | --- |
| 没有改文件 | Git diff 为空或目录无新增文件 |
| 有结构判断 | 不只是复述文件名 |
| 有风险提示 | 能指出密钥、构建、数据库、部署等风险层 |
| 有下一步建议 | 给出单文件、小范围、可回退任务 |

## 6. 安装命令行入口

setup flow 中可以安装 command line tool，用于从终端打开 Antigravity。官方 Codelab 展示的命令名是 `agy`。

> [!TIP]
> 命令行入口适合“从当前项目目录打开 Antigravity”，不是让你绕过权限审阅。终端里启动以后，workspace 仍然要按同样的权限策略治理。

## 官方来源

- [Google Antigravity](https://antigravity.google/)
- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
- [Google Antigravity Pricing](https://antigravity.google/pricing)

## 接下来去哪

<Cards>
  <Card title="理解 Agent Manager" description="下一步看 Antigravity 如何把 agent 从侧边栏变成任务管理对象。" href="/docs/antigravity/official/01-agent-manager" />
  <Card title="第一天安全实战" description="如果你想按操作顺序跑一遍，读理解路径的第一天教程。" href="/docs/antigravity/understanding" />
</Cards>
