Google Antigravity 上手技巧：从安装到用好 AI Agent
Antigravity 是 Google 推出的 AI Agent 开发工具。和普通的「代码补全」不同，它更像一个能自己读代码、写计划、改文件、跑命令、甚至打开浏览器验证效果的助手。现在 Antigravity 已经扩展成好几种形态：桌面 Antigravity App、命令行 Antigravity CLI（agy）、独立的 Antigravity IDE，以及 VS Code / JetBrains 等编辑器插件。
这篇文章整理了我自己上手时觉得最实用的技巧，内容以 2026 年 10 月的官方文档为准。如果你还卡在登录这一步，先看上一篇：Antigravity 无法登录解决教程。
一、选对形态并安装
| 形态 | 适合谁 | 安装方式 |
|---|---|---|
| Antigravity App | 主力使用，功能最全 | antigravity.google/download 下载安装包 |
| Antigravity CLI | 习惯终端、远程服务器 | 一行脚本安装（见下） |
| Antigravity IDE | 喜欢 VS Code 式编辑器 | 同样在下载页获取 |
| IDE 插件 | 不想换编辑器 | VS Code 扩展市场搜索 Google Antigravity |
系统要求：macOS 12+、Windows 10 64 位+，Linux 需要 glibc >= 2.28（Ubuntu 20+、Debian 10+ 等）。Linux 版下载后解压运行即可：
tar -xzf Antigravity.tar.gz
./Antigravity
CLI 安装（macOS / Linux）：
curl -fsSL https://antigravity.google/cli/install.sh | bash
agy --version
Windows 用 PowerShell：
irm https://antigravity.google/cli/install.ps1 | iex
💡 登录说明：各个形态共用一套登录，在一个地方登录后本机其他形态也能用。在 SSH 远程服务器上运行
agy时，它会打印一个授权链接，你在本地浏览器打开、登录后把授权码粘回终端即可。
二、第一个任务：先建项目再提需求
在 Antigravity App 里，Agent 是在「项目」里工作的：
- 点左侧边栏的 New Project（带加号的文件夹图标）。
- 点 Add Folder 选择本地代码目录，再点 Create。
- 在输入框写需求，比如
给登录接口补充单元测试，回车。 - 选择运行模式：Local mode 直接改当前目录；New worktree mode 在独立的 Git worktree 里改，不会弄乱你手头的分支，推荐新手用这个。
只是随便问点东西的话，可以直接开一个不属于任何项目的对话，它会在一个独立的临时目录里运行。
如果用的是 Antigravity IDE，按 Cmd+E（Windows/Linux 为 Ctrl+E）就能在编辑器和 Agent Manager 之间来回切换。
三、复杂任务先让它「写计划」
Antigravity 最值得用的功能是 Artifacts（产物）：Agent 会把实施计划、代码 diff、架构图、浏览器录屏等整理成可审阅的产物，你在关键节点看一眼就行，不用盯着每一步。
- 简单改动（改变量名、跑一条命令、小重构）：直接说就行。
- 复杂改动（多文件重构、需求不清、数据库迁移）：在需求前加上
/plan。
/plan 把用户模块从 Flask 迁移到 FastAPI，保持接口路径不变
/plan 会先分析代码，必要时反过来问你问题，然后生成一份 Implementation Plan。你可以在计划上直接写评论（比如「不要动数据库层」），再点 Review 把意见发回去，或者点 Proceed 让它开工。
建议在设置的 Agent 标签页里，把产物审阅策略保持为 Request review（推荐），这样它每次出计划都会停下来等你确认。如果改成 Always proceed，就会全自动执行。
四、管好权限：别一上来就开 Turbo
App 里有四档权限预设（Settings > General > Global Permissions > Permission Preset，也能在输入框旁边的权限选择器里改）：
| 预设 | 行为 |
|---|---|
| Request Review | 每条终端命令都要你批准 |
| Default | 沙盒内的命令直接跑，沙盒外的要批准 |
| Auto (Preview) | 自动判断，安全可逆的直接跑，危险操作仍会暂停 |
| Turbo | 不加任何限制，可读写整台机器 |
我的建议：日常用 Default，自己信得过的项目可以单独设成 Auto，Turbo 慎用。每个项目可以单独覆盖全局设置。
CLI 里对应的是执行模式，用 Shift+Tab 循环切换，也可以启动时指定：
agy --mode=plan # 先出计划再动手
agy --mode=accept-edits # 自动接受文件修改，跑命令仍会询问
注意：旧版的 /planning、/fast 命令在 CLI 1.1.0 已经移除，现在要用 Shift+Tab 或 /plan。
五、让它打开浏览器帮你验证
前端改完想看效果？用 /browser。它会调起一个专门的浏览器子 Agent，通过 Chrome DevTools 控制 Google Chrome：点击、填表、看控制台和网络请求、截图，并且整段操作会录成 WebM 视频放进产物里。
/browser 打开 http://localhost:3000，把宽度调到 390px，检查导航抽屉能否正常展开收起，并分别截图
技巧：一定要写清楚「什么时候算完成」，比如「报告 X 是否渲染」「截一张 Y 的图」。第一次使用时 Chrome 会询问是否允许远程调试，点允许即可。注意 /browser 只在 App 和 CLI 里有，Antigravity IDE 里没有。
六、选模型：快和强之间取舍
模型在输入框下方的选择器里切换，还能选择思考深度 Low / Medium / High。可用模型取决于你的订阅：免费用户能用 Gemini 3.8 Flash 等模型，Google AI Pro / Ultra 可以用 Gemini 4 Argon 和 Claude 5.5 系列。
经验是：日常小改动用 Flash 搭配低思考深度，速度快；架构设计、疑难 Bug 再切到强模型和 High。注意 Gemini 4 Argon 在 Antigravity IDE 里用不了，要用 App、CLI 或插件。另外 Claude 4.6 系列和 GPT-OSS-120b 会在 2026 年 11 月 2 日下线，常用这几个的话要提前换。
七、用 Rules 和 Skills 让它「记住规矩」
每次都重复「用 TypeScript、注释写中文」很累，写成规则就行：
- 项目根目录放一个
AGENTS.md或GEMINI.md，不需要额外配置，一直生效； - 全局规则放在
~/.gemini/GEMINI.md； - 更细的规则放到
.agents/rules/*.md，必须带 YAML 头：
---
trigger: glob
description: "前端代码规范"
globs: "*.ts, *.tsx"
---
- 表单校验统一使用 zod
- 组件注释使用中文
trigger 只能是 always_on、model_decision、glob、manual 之一。写成 alwaysOn 这种驼峰格式，规则会被直接忽略且不报错，这个坑很常见。
多步骤的固定流程（比如「发版前跑测试 → 改版本号 → 打 tag」）适合写成 Skill：在 .agents/skills/<名字>/SKILL.md 里写清楚步骤和 description，Agent 会在合适的时候自动调用。⚠️ 旧的 Workflows 功能官方已宣布在 2026 年 10 月 19 日停用，还在用的话可以在对话里执行 /migrate-workflows 迁移成 Skill。
八、几个顺手的快捷键（App）
| 操作 | macOS | Windows / Linux |
|---|---|---|
| 切换对话 | ⌘K | Ctrl + K |
| 搜索文件 | ⌘P | Ctrl + P |
| 聚焦输入框 | ⌘L | Ctrl + L |
| 新建对话 | ⌘N | Ctrl + N |
| 语音输入 开始/结束 | Ctrl + M | Ctrl + M |
CLI 里常用的是：Ctrl+R 打开产物审阅、Ctrl+C 中断生成、/usage 查看额度、Ctrl+D 退出。
另外几个好用的斜杠命令：/goal（一口气跑完不中途打扰）、/grill-me（开工前先反问你需求细节）、/schedule（定时执行任务）。
总结
用好 Antigravity 的核心就三点：复杂任务先 /plan 再审阅，权限从 Default 起步，把常用约定写进 Rules / Skills。剩下的就是多给它清晰的目标和验收标准。
遇到登录或地区限制问题，可以回看 Antigravity 无法登录解决教程。更多细节可以看官方文档：antigravity.google/docs。
评论区