---
title: "02 · 第一次安全运行"
description: "Antigravity 第一天使用路径：安装、登录、Review-driven 设置、只读分析、单文件小改、浏览器验收和回退检查。"
verifiedAt: "2026-05-07"
---

第一次打开 Antigravity，最重要的不是马上让它写功能，而是验证“它在你的机器上能被安全地控制”。先核对安装来源和系统要求，再跑只读、单文件小改、浏览器验收和回退检查。这个顺序比一上来打开真实生产仓靠谱得多。

> [!NOTE]
> **第一天目标**：确认 Antigravity 能启动、能登录、能在 workspace 内读项目、能按权限请求命令、能生成 diff、能用浏览器留下验收证据，并且能撤销小改动。

## 1. 第一天路线

```mermaid
flowchart LR
    Download["官方下载"] --> Check["系统要求检查"]
    Check --> Install["安装登录"]
    Install --> Policy["Review-first 设置"]
    Policy --> Workspace["测试 workspace"]
    Workspace --> ReadOnly["只读分析"]
    ReadOnly --> OneFile["单文件小改"]
    OneFile --> Browser["浏览器验收"]
    Browser --> Review["看 diff / artifacts"]
    Review --> Undo["验证回退"]
```

不要跳过只读分析。只读是你观察 agent 行为的最低风险方式。

## 2. 安装和登录

按官方路径从 [Antigravity 下载页](https://antigravity.google/download) 安装，不要用网盘包、镜像站或别人转发的安装器。Antigravity 会接触本地代码、终端和浏览器，安装包来源必须干净。

官方 Getting Started 文档当前列出的平台要求：

| 平台 | 官方要求 | 第一次判断 |
| --- | --- | --- |
| macOS | Apple 仍提供安全更新的 macOS 版本；通常是当前和前两个版本；最低 macOS 12 Monterey；不支持 x86 | Apple Silicon 优先；Intel Mac 不要默认假设可用 |
| Windows | Windows 10 64-bit | 确认系统是 64 位 |
| Linux | glibc >= 2.28，glibcxx >= 3.4.25，例如 Ubuntu 20、Debian 10、Fedora 36、RHEL 8 | 先查运行库版本，再装 |

Linux 可以先查：

```bash
ldd --version
strings /usr/lib*/libstdc++.so.6 2>/dev/null | rg 'GLIBCXX_3\\.4'
```

首次 setup 建议：

| 设置 | 第一天建议 |
| --- | --- |
| 导入 VS Code / Cursor 设置 | fresh start |
| Agent 使用方式 | Review-driven development |
| Terminal execution | Request Review |
| Artifact review | Asks for Review |
| JavaScript execution | Request Review 或 Disabled |
| File access | Workspace only |

> [!WARNING]
> 不要在第一天导入一堆旧扩展和旧配置。你还不知道问题来自 Antigravity、扩展、项目依赖，还是旧设置。

## 3. 理解第一天导航

官方 Getting Started 文档明确了基础切换方式：

- 从 Editor 顶部按钮打开 Agent Manager。
- 从 Editor 用 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）打开 Agent Manager。
- 在 Agent Manager 中，从 workspace 下拉菜单的 **Focus Editor** 回到对应 Editor。
- 当聚焦某个 workspace 时，也可以用 **Open Editor** 按钮或 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）回到 Editor。

Windows / Linux 用户以当前应用菜单和快捷键设置为准。第一天要记的是逻辑：Editor 负责单 workspace 的代码现场，Agent Manager 负责跨 workspace 的任务和 artifacts。

```mermaid
flowchart LR
    Editor["Editor<br/>单 workspace 代码现场"] -->|Top bar / Cmd+E (Mac) · Ctrl+E (Win)| Manager["Agent Manager<br/>任务与 artifacts"]
    Manager -->|Focus Editor / Open Editor| Editor

    style Editor fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Manager fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
```

## 4. 建测试 workspace

第一次试用其实有两种起手方式，新手优先用前者：

| 方式 | 适合 | 怎么进 |
| --- | --- | --- |
| **Playground**（推荐第一天用） | 只想试一个想法、对比两个 prompt、做一次只读分析；不想 setup 项目 | Start Conversation 页点 **Use Playground**；做出有用产出再点 **Move** 搬到正式 workspace |
| 测试 workspace（指定本地目录） | 想跑完整安装→只读→改文件→浏览器验证全链路 | 新建一个干净目录，从 Editor `Open Folder` 或 Agent Manager 左侧 + 按钮打开 |

如果选测试 workspace，创建一个干净目录：

```text
~/antigravity-lab/
```

里面放一个最小项目。可以是普通 HTML，也可以是小型 Python/Next.js demo。不要放：

- `.env`
- SSH key
- 浏览器 cookie
- 公司客户数据
- 真实生产仓库

## 5. 只读分析 prompt

第一条 prompt：

```text
请只读分析当前 workspace，不要创建、修改或删除任何文件。
输出：
1. 目录结构
2. 项目类型判断
3. 如果后续要改，最小安全任务是什么
4. 你需要哪些权限才能继续
```

你要检查：

| 检查项 | 通过标准 |
| --- | --- |
| 没改文件 | 没有新增、删除、修改 |
| 有边界感 | 明确说需要权限才能继续 |
| 有下一步 | 给单文件或局部任务 |
| 没越权 | 没要求读 workspace 外路径 |

## 6. 单文件小改

第二条 prompt 可以这样写：

```text
只修改首页标题文案，不要调整布局和样式。
修改后给出 diff，并说明如何手动验证。
```

这一步验证三件事：

1. 它是否真的只改一个文件。
2. 它是否生成可读 diff。
3. 它是否乱动格式化、配置或依赖。

## 7. 浏览器验收

第三步再要求浏览器：

```text
启动本地服务，打开首页，验证标题文案已变化。
请交付 screenshot 和 walkthrough。
执行任何 terminal 命令前先请求确认。
```

浏览器验收通过标准：

- 你看到了启动命令。
- 你批准了必要命令。
- 它打开的是本地页面或明确 allow 的 URL。
- 它留下 screenshot 或 walkthrough。
- walkthrough 说明了如何复现验证。

第一天浏览器只允许 `localhost` 或你明确指定的官方文档页。不要让它登录真实后台、支付系统、广告后台、云控制台或生产 CMS。

## 8. 回退检查

Antigravity 支持任务级 undo，但真实项目仍然要看 Git diff。第一天至少做一次：

1. 查看 diff。
2. 尝试撤销本次修改。
3. 确认文件回到原状态。
4. 记录哪些动作需要人工确认。

> [!IMPORTANT]
> 能回退，才敢前进。不要把第一次成功改代码当成验收，把第一次成功撤销也当成验收。

## 9. 第一天不要做什么

| 不要做 | 原因 |
| --- | --- |
| 一上来打开生产仓 | 风险范围太大 |
| 打开非 workspace file access | 可能读到私人和凭据文件 |
| 允许 `rm`、`ssh`、`git push` | 副作用过大 |
| 登录真实后台让它点击 | 账号和业务风险高 |
| 同时派多个 agent | 你还没建立验收习惯 |

## 10. 安装完成清单

安装不以“图标能打开”为结束。至少确认：

1. 下载来自 `antigravity.google/download`。
2. 系统满足官方平台要求。
3. 应用能启动，并用 Google 账号完成 preview 阶段登录（或进入官方当前可用状态）。
4. 能打开测试 workspace。
5. 能从 Editor 切到 Agent Manager。
6. 能从 Agent Manager 回到对应 Editor。
7. 能完成只读 prompt 且没有修改文件。
8. 单文件小改能产生 diff。
9. 浏览器验收能留下 screenshot 或 walkthrough。
10. 修改能撤销或通过 Git diff 回退。

## 官方来源

- [Google Antigravity Getting Started](https://antigravity.google/docs/get-started)：官方下载入口、系统要求、更新和基础导航说明。
- [Google Antigravity Download](https://antigravity.google/download)：官方下载入口。
- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)：Google Codelab，补充安装、登录、Editor 配置、Command Line `agy` 和浏览器扩展流程。

## 接下来去哪

<Cards>
  <Card title="Editor 与 Agent Manager" description="下一步理解什么时候留在编辑器，什么时候派发异步 agent。" href="/docs/antigravity/understanding/03-editor-vs-agent-manager" />
  <Card title="安装与初始设置" description="查官方安装、setup flow 和策略选项。" href="/docs/antigravity/official/00-getting-started" />
</Cards>
