← 返回教程目录
Google Antigravity
一句话简介: Google(Windsurf 核心团队加入 DeepMind 后打造)。
主流功能:多 Agent 并行仪表盘、浏览器自动化、异步编程(Jules)
可用性:需特殊网络环境。
适用人群:开发者
前置条件:
- Google 账号(个人 Gmail 即可),用于登录 Antigravity
- 网络:可稳定访问 Google 服务的网络环境(下载页、登录、模型调用)
- 设备:macOS / Windows / Linux 均可
- 费用:个人版免费(含一定额度的 Agent 使用量,具体配额以客户端实时显示为准,未验证)
分步骤教程
第一步:下载安装
- 在可访问 Google 的网络环境下,打开 Antigravity 官方下载页(antigravity.google),下载对应系统的安装包:
- macOS:
/Applications/Antigravity.app - Windows:安装程序
- Linux:对应发行版包
- macOS:
- 运行安装程序完成安装。
- 首次启动:用 Google 账号登录 → 阅读"安全性与资料使用"政策点"下一步" → 选择主题 → 按需安装 Google 开发者工具插件包(会附带一组 Skills)→ 点"完成"进入主界面。
版本说明:Antigravity 2.0 是独立桌面 App(Agent 中央指挥台);Antigravity IDE 是基于 VS Code 分支的完整代理 IDE(带 Agent Manager 与代码库洞察),两者都可装;另有 CLI 与 SDK,本教程不展开。
第二步:首次启动的安全检查(建议)
- 先打开一个不含生产密钥的测试项目,不要直接上生产仓库。
- 检查工作区信任设置与终端权限。
- 查看 Agent 的命令审批设置(哪些命令执行前需要你批准)。
- 确认当前选择的模型(主力为 Gemini 系列,可按任务切换)。
第三步:第一个只读任务(验证它听话)
- 在 Agent Manager 新建任务,输入:
请先只读检查这个项目,说明它目前包含什么。不要修改文件,也不要执行安装命令。 - 验收三处:是否只读了没乱改、终端有没有执行未授权命令、它的总结是否与实际相符。
- 通过后再下真正的修改任务,例如:
请在 README.md 中增加"本地开发"章节,只写一条启动说明。修改前先展示计划,修改后运行 git diff。
第四步:多 Agent 并行(核心用法)
- Antigravity 的两类界面要分清:
- Editor:看代码、改文件、开终端,做具体事;
- Agent Manager:创建、分派、观察多个 Agent 任务的大盘。
- 并行工作流示例(一个需求拆三路):
- Agent A:负责实现后端接口;
- Agent B:负责写前端页面;
- Agent C:负责补单元测试。 三个任务同时跑,你在大盘看各自的进度、diff 与终端输出。
- 铁律:不要让两个会改同一文件的任务同时跑。稳妥顺序:先只读分析 → 审改动计划 → 批准小范围修改 → 看 diff → 跑测试 → 再扩大范围。
- 每个 Agent 的行为都会生成可核查的产物(任务列表、实施方案、截图、浏览器录制),先审产物再合代码。
第五步:浏览器自动化(让 Agent 自己开浏览器验证)
- 先用原生 Browser:Antigravity IDE 自带浏览器子 Agent,能操作浏览器并产出截图/录屏。先给小任务验证:
能返回真实工具执行结果和证据,再扩大范围。打开本项目启动说明里的访问地址,检查登录页能否打开、输入框能否输入。不登录生产账号,不修改源码。 - 需要统一用 Playwright 时,配置 Playwright MCP:
- 入口:Agent 侧栏右上角
…→ MCP Servers → Manage MCP Servers → View raw config; - 项目级配置写入
.agents/mcp_config.json(全局:~/.gemini/config/mcp_config.json;以你 IDE 实际打开的配置文件为准,不要多处重复写); - 合并以下节点(已有其他服务时只增量添加):
{ "mcpServers": { "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@latest", "--isolated"] } } } - 保存后在 MCP 管理界面重新加载,确认服务状态与工具列表正常。
- 入口:Agent 侧栏右上角
- 第一次调用只做只读检查(如打开 example.com 读标题+截图),确认工具真实可用后再让它填表单、做 E2E 验证。
第六步:配合 Jules(异步云端编码)
- 安装 Jules CLI:
npm install -g @google/jules && jules login - 把适合异步的任务(如"给这个仓库加深色模式")交给 Jules,它在云端独立执行,你睡觉时它也在跑;完成后你审查它的改动再合并。
- 典型分工:Antigravity 本地 Agent 做需要即时交互的开发,Jules 接手耗时长的独立任务,配额互不挤占。
第七步:中文界面(可选)
- 官方界面为英文;GitHub 有社区繁体中文本地化项目
antigravity2-tw(一键脚本注入翻译,需先完全关闭 Antigravity 再执行),简体中文覆盖情况未验证。动手前请自行评估第三方脚本风险。
常见问题
个人版免费版有什么限制? 个人版免费,但 Agent 调用有额度/配额限制,具体数字以客户端实时显示为准(未验证)。重度使用前先看清配额页。
模型可以切换吗? 可以。主力是 Gemini 系列,客户端提供模型选择器,可按任务切换;但没有官方支持的"任意填 OpenAI-compatible Base URL"的主模型配置方式,不要照搬其他编辑器的环境变量配置。
MCP 配置写哪个文件? 以 IDE 实际打开的为准:项目级
.agents/mcp_config.json,全局~/.gemini/config/mcp_config.json。旧版路径可能不同,认准 Manage MCP Servers → View raw config 打开的那个。Agent 把代码改坏了怎么办? 所有改动都有 diff 产物,先审后合;配合 Git 使用,改坏直接回滚。并行任务务必避开同时改同一文件。
国内用户能用吗? 目前没有官方渠道:下载、登录、模型调用都依赖 Google 服务可达。网络不稳定会导致登录失败或 Agent 中断,建议在网络稳定的环境下使用。