---
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="/zh-Hant/docs/antigravity/official/01-agent-manager" />
  <Card title="第一天安全實戰" description="如果你想按操作順序跑一遍，讀理解路徑的第一天教程。" href="/zh-Hant/docs/antigravity/understanding" />
</Cards>
