---
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="/zh-Hant/docs/antigravity/understanding/03-editor-vs-agent-manager" />
  <Card title="安裝與初始設定" description="查官方安裝、setup flow 和策略選項。" href="/zh-Hant/docs/antigravity/official/00-getting-started" />
</Cards>
