← 返回教程目录

Google Antigravity

一句话简介: Google(Windsurf 核心团队加入 DeepMind 后打造)。

主流功能:多 Agent 并行仪表盘、浏览器自动化、异步编程(Jules)

可用性:需特殊网络环境。

适用人群:开发者

前置条件:

  • Google 账号(个人 Gmail 即可),用于登录 Antigravity
  • 网络:可稳定访问 Google 服务的网络环境(下载页、登录、模型调用)
  • 设备:macOS / Windows / Linux 均可
  • 费用:个人版免费(含一定额度的 Agent 使用量,具体配额以客户端实时显示为准,未验证)

分步骤教程

第一步:下载安装

  1. 在可访问 Google 的网络环境下,打开 Antigravity 官方下载页(antigravity.google),下载对应系统的安装包:
    • macOS:/Applications/Antigravity.app
    • Windows:安装程序
    • Linux:对应发行版包
  2. 运行安装程序完成安装。
  3. 首次启动:用 Google 账号登录 → 阅读"安全性与资料使用"政策点"下一步" → 选择主题 → 按需安装 Google 开发者工具插件包(会附带一组 Skills)→ 点"完成"进入主界面。

版本说明:Antigravity 2.0 是独立桌面 App(Agent 中央指挥台);Antigravity IDE 是基于 VS Code 分支的完整代理 IDE(带 Agent Manager 与代码库洞察),两者都可装;另有 CLI 与 SDK,本教程不展开。

第二步:首次启动的安全检查(建议)

  1. 先打开一个不含生产密钥的测试项目,不要直接上生产仓库。
  2. 检查工作区信任设置与终端权限。
  3. 查看 Agent 的命令审批设置(哪些命令执行前需要你批准)。
  4. 确认当前选择的模型(主力为 Gemini 系列,可按任务切换)。

第三步:第一个只读任务(验证它听话)

  1. 在 Agent Manager 新建任务,输入:
    请先只读检查这个项目,说明它目前包含什么。不要修改文件,也不要执行安装命令。
    
  2. 验收三处:是否只读了没乱改、终端有没有执行未授权命令、它的总结是否与实际相符。
  3. 通过后再下真正的修改任务,例如:
    请在 README.md 中增加"本地开发"章节,只写一条启动说明。修改前先展示计划,修改后运行 git diff。
    

第四步:多 Agent 并行(核心用法)

  1. Antigravity 的两类界面要分清:
    • Editor:看代码、改文件、开终端,做具体事;
    • Agent Manager:创建、分派、观察多个 Agent 任务的大盘。
  2. 并行工作流示例(一个需求拆三路):
    • Agent A:负责实现后端接口;
    • Agent B:负责写前端页面;
    • Agent C:负责补单元测试。 三个任务同时跑,你在大盘看各自的进度、diff 与终端输出。
  3. 铁律:不要让两个会改同一文件的任务同时跑。稳妥顺序:先只读分析 → 审改动计划 → 批准小范围修改 → 看 diff → 跑测试 → 再扩大范围。
  4. 每个 Agent 的行为都会生成可核查的产物(任务列表、实施方案、截图、浏览器录制),先审产物再合代码。

第五步:浏览器自动化(让 Agent 自己开浏览器验证)

  1. 先用原生 Browser:Antigravity IDE 自带浏览器子 Agent,能操作浏览器并产出截图/录屏。先给小任务验证:
    打开本项目启动说明里的访问地址,检查登录页能否打开、输入框能否输入。不登录生产账号,不修改源码。
    
    能返回真实工具执行结果和证据,再扩大范围。
  2. 需要统一用 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 管理界面重新加载,确认服务状态与工具列表正常。
  3. 第一次调用只做只读检查(如打开 example.com 读标题+截图),确认工具真实可用后再让它填表单、做 E2E 验证。

第六步:配合 Jules(异步云端编码)

  1. 安装 Jules CLI:
    npm install -g @google/jules && jules login
    
  2. 把适合异步的任务(如"给这个仓库加深色模式")交给 Jules,它在云端独立执行,你睡觉时它也在跑;完成后你审查它的改动再合并。
  3. 典型分工:Antigravity 本地 Agent 做需要即时交互的开发,Jules 接手耗时长的独立任务,配额互不挤占。

第七步:中文界面(可选)

  • 官方界面为英文;GitHub 有社区繁体中文本地化项目 antigravity2-tw(一键脚本注入翻译,需先完全关闭 Antigravity 再执行),简体中文覆盖情况未验证。动手前请自行评估第三方脚本风险。

常见问题

  1. 个人版免费版有什么限制? 个人版免费,但 Agent 调用有额度/配额限制,具体数字以客户端实时显示为准(未验证)。重度使用前先看清配额页。

  2. 模型可以切换吗? 可以。主力是 Gemini 系列,客户端提供模型选择器,可按任务切换;但没有官方支持的"任意填 OpenAI-compatible Base URL"的主模型配置方式,不要照搬其他编辑器的环境变量配置。

  3. MCP 配置写哪个文件? 以 IDE 实际打开的为准:项目级 .agents/mcp_config.json,全局 ~/.gemini/config/mcp_config.json。旧版路径可能不同,认准 Manage MCP Servers → View raw config 打开的那个。

  4. Agent 把代码改坏了怎么办? 所有改动都有 diff 产物,先审后合;配合 Git 使用,改坏直接回滚。并行任务务必避开同时改同一文件。

  5. 国内用户能用吗? 目前没有官方渠道:下载、登录、模型调用都依赖 Google 服务可达。网络不稳定会导致登录失败或 Agent 中断,建议在网络稳定的环境下使用。