天工开物KAIWU AI
工具指南 › Google Antigravity › Google Antigravity 使用指南(完整全套)
核实于 2026-11-08
工具指南·其六核实于 2026-11-08

Google Antigravity 使用指南(完整全套)

适用对象
想快速了解工具定位、核心功能和上手路径的中文用户
核对日期
2026-11-08
本页目录

本指南综合了 10 篇公众号深度实测与技术教程(2026-04-14 ~ 11-02)。文中的 [1]~[10] 对应文末「参考原文」,序号与 00_清单.md 一致。每张图下方注明出处与对应文章。素材之间说法不一致、版本迭代变化或存在安全风险的地方,均用 ⚠️ 明确标出。

公众号素材集中在 2026 年 5 月 Antigravity 2.0 发布前后的集中评测,以及 10~11 月最新桌面端与 Gemini 4 新模型的实测。指南补充了 Google 官方开发者文档、Antigravity CLI 规范、MCP 扩展协议与 Rules 规范,以 [官1]~[官8] 标注,查阅日期 2026-11-08。


一、定位:它是什么,适合谁

Google Antigravity(简称 AGY,终端命令为 agy)是由 Google 团队(涵盖 DeepMind 前沿团队)研发的高级智能体编码工作台(Advanced Agentic Coding Environment)[2][9]。

它不是传统的代码自动补全插件,也不是单纯挂载在侧边栏的聊天机器人,而是以全流程自主多智能体(Multi-Agent System)为核心、深度结合沙箱环境、工件(Artifacts)展示系统与浏览器自动化的下一代 AI 编程 IDE [1][2][9]。

图 1 2.0主界面

图源:[5] 雷科技《谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气》

1. 2.0 版本的重大跃迁

2026 年 5 月,Google 正式推送了 Antigravity 2.0 重大更新,彻底重构了产品形态 [2][3][5]:

  • 从实验型沙箱升级为生产级三栏式 IDE:左侧代码树与编辑区、中间多轮规划会话流、右侧独立的 Artifacts 结构化工件渲染区与内置终端 [3][9]。

  • 底层模型升级:全面接入 Gemini 3.8 Flash、Gemini 3.8 Pro 以及最新的深度原型模型 Gemini 4 Argon,具备超长上下文处理与极低推理延迟 [5][10]。

  • 引入主动交互机制(Slash Commands):如 /grill-me(让 AI 像资深架构师一样反问你,逼你澄清边界)、/plan(先排兵布阵再写代码)、/boost(多视角严谨验证)[2][4][5]。

2. 和同类工具怎么比

维度Google AntigravityClaude CodeOpenAI Codex / ChatGPT DesktopCursor
核心交互范式三栏多智能体 IDE + Artifacts 工件 [3][9]终端/桌面 Agent,偏向纯文本流桌面/云端沙箱 Agent传统 IDE 内核 + 侧边栏对话
底层大模型Gemini 系列原生驱动(Flash/Pro/Argon)[5][10]深度绑定 Claude 3.5/3.7/Opus 系列深度绑定 GPT-4o/o1/o3 系列支持多模型切换
工件与可视化独立 Artifacts 面板,即时渲染 Markdown、架构图、Mermaid、前端交互 UI [1][9]纯文本与终端 Diff 输出云端渲染预览编辑器内 Diff
反向对齐能力特有 /grill-me 互动问询,AI 主动反问找漏洞 [5]依赖人工在 Prompt 里约束规则依赖人工约束依赖系统提示词
系统控制力内置终端沙箱 + 浏览器自动化交互 [3][7]本地终端命令执行桌面级 Computer Use终端命令审批

适合谁:

  • 喜欢直观可视化、结构化产出的开发者:不习惯终端冰冷滚屏,希望看到清晰的任务清单、状态看板、架构图(Artifacts)一步步点亮的开发者 [1][9]。

  • 需要前期深度方案推演的人:面对模糊需求时,希望 AI 能够主动反问、梳理设计决策(/grill-me)再动笔写代码的技术负责人或独立开发者 [4][5]。

  • 全栈与前端工程师:需要 AI 在本地快速起开发服务、调用无头浏览器检查页面渲染与交互效果的人 [6][7]。

不适合谁:

  • 极度偏好纯终端、无头操作且内存预算极度紧张的老款低配机器(Antigravity 桌面端完整三栏界面更消耗资源)[8]。

  • 仅希望在已有 VS Code / JetBrains 环境中做简单行内补全、不想引入新 IDE 的程序员(此时更适合轻量 Copilot 类插件)[5]。


二、准备与安装

0. 先选路线:你属于哪种情况

你的情况推荐路线核心步骤
想要最完整的体验,包括可视化设计、工件渲染与浏览器交互Antigravity 2.0 桌面端(推荐)看第 1、2 步 → 第三节快速上手
偏好终端命令行,希望在远程开发机或 CI 中调用Antigravity CLI (agy)看第 1、3 步
拥有 Google Workspace 或 Gemini 订阅账号桌面端 + Google 账号授权看第 1 步
国内网络环境下使用注意网络代理配置与终端环境变量看第 1 步「网络与账号安全」

1. 账号与费用配额

  • 登录体系:直接使用 Google 账号(Gmail / Google Workspace)授权登录 [1][2]。

  • 套餐与配额档位:

    • 免费层(Free Tier):支持使用基础额度的 Gemini Flash 模型,按小时/天刷新调用限额 [4][6]。

    • Gemini Advanced / Google One AI Premium:提供高并发配额、解锁 Gemini Pro 与实验性 Argon 高阶模型的优先调度权 [5][10]。

  • 配额查看与预警: 在设置中可实时查看当前账号各模型的配额余量与重置倒计时:

图 2 模型额度

图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》

⚠️ 安全警告:切忌在电商平台(淘宝/闲鱼)购买所谓"低价 Gemini 独享老号"。 官方素材排查中发现,大量第三方代注册账号存在批量关联风控,往往充值使用数天后即遭封禁,导致本地工作空间与配置无法同步。建议务必使用个人正规注册并绑卡的 Google 账号 [官1]。


2. 桌面客户端安装(Windows / macOS / Linux)

第一步:下载客户端

从 Google Antigravity 官方入口或开发者门户下载对应安装包 [2][3]:

  • Windows:Antigravity-Setup-2.x.x.exe(支持 Windows 10/11 64 位)。

  • macOS:支持 Apple Silicon 与 Intel 架构 Mac 的 DMG 镜像。

  • Linux:提供 .AppImage 与 .deb 包。

第二步:初始化工作空间

启动 Antigravity 2.0,首次打开会进入新建或打开项目向导:

图 3 新建项目选文件夹

图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》

选择你本地已有的代码仓库文件夹,或者点击「New Project」让它从零初始化一个空项目 [4]。

第三步:项目个性化设置

在项目初始化弹窗中,可以设置项目名称、默认 Git 追踪分支以及语言环境规范:

图 4 项目设置

图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》


3. 命令行 CLI (agy) 安装与使用

Antigravity 提供了极强的独立命令行生态 agy,支持开发者在无桌面界面的环境中使用 [2][8]:

安装命令

bash
# 全局安装 agy
npm install -g @google/antigravity

# 验证安装
agy --version

首次启动与授权

在终端中输入:

bash
agy

程序会自动弹出授权链接并在终端显示设备码:

图 5 CLI首次启动

图源:[2] 薪火传《Antigravity 2.0 官方真实说明手册(全站深度翻译与重构版)》

在浏览器中确认授权后,CLI 即可在当前终端激活使用。


4. 终端沙箱与安全策略配置

Antigravity 2.0 在安全策略上做出了重大升级:

  • 早期 1.0 的旧版安全预设:早期的安全控制较为粗放,要么全开要么全关:

图 6 旧版安全预设

图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》

  • 2.0 的终端沙箱与操作审查机制:2.0 引入了独立的终端沙箱开关,细化到「命令级风险确认」与「文件读写范围限制」[3][4]:

图 7 终端沙箱开关

图源:[3] Data接化发《Google Antigravity 2.0 新版--中文使用手册整理》

开启沙箱后,危险的系统级写入命令会被严格阻断或强制二次弹窗,确保开发安全 [3]。


三、上手流程:从零到第一个完整项目

下面以使用 Antigravity 2.0 开发一个具备响应式界面的待办与番茄钟工具为例,带你走完从规划到交付的标准流程。

第一步:打开工作空间并添加上下文

在中间底部的对话框中,可以灵活引用本地文件作为上下文 [4][5]:

  • 输入 @ 可快速唤醒本地文件选择器,将已有的需求文档、API 接口定义或原型图挂载到当前任务中。

图 8 输入框添加上下文

图源:[5] 雷科技《谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气》

第二步:使用 /grill-me 深度对齐需求

不要直接让 AI 闭着眼睛写代码!在输入框键入:

/grill-me 我想基于 React + Tailwind 开发一个带音效的番茄钟应用。请审查我的需求,向我提问关键决策点。

此时 AI 会化身为严格的技术专家,主动向你追问:

  • "计时结束时的音效需要本地音频还是使用 Web Audio API 合成?"

  • "数据需要持久化在 LocalStorage 还是未来对接云端接口?"

  • "当用户离开页面或最小化窗口时,是否需要调用浏览器 Notification API 发送桌面通知?"

图 9 grill-me追问

图源:[5] 雷科技《谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气》

通过 2~3 轮互动,架构边界彻底敲定,大幅减少返工![4][5]

第三步:生成架构设计工件(Artifacts)

确认完需求后,AI 会自动在右侧工件区生成详细的技术设计方案与任务看板 [1][9]:

图 10 Artifacts示意

图源:[1] 懂懂的AI工作流《Antigravity 新手上手教程》

工件区会实时呈现状态:

  • 待办清单卡片(每完成一步自动打勾)

  • 模块依赖架构图(基于 Mermaid 渲染)

  • 关键接口定义文档

第四步:代码编写与内置终端运行

AI 开始自动编写组件文件,并在内置终端中执行 npm run dev:

图 11 内置终端

图源:[9] AI编程瓜哥《Antigravity App:一个被低估的桌面智能体》

终端输出的本地运行端口会被 AI 自动捕获。你可以点击右侧的预览选项卡,直接在 IDE 内部查验网页成品的交互效果![9]


四、核心功能与进阶

1. 三栏式工作区布局设计

Antigravity 2.0 的三栏设计是其标志性特征 [9]:

图 12 三栏布局示意

图源:[9] AI编程瓜哥《Antigravity App:一个被低估的桌面智能体》

实际运行时的界面划分非常自然:

图 13 三栏实际界面

图源:[9] AI编程瓜哥《Antigravity App:一个被低估的桌面智能体》

  1. 左侧栏(Code Space):项目文件目录树、当前激活代码编辑窗口、Git 提交记录与 Diff 比较区 [9]。

  2. 中间栏(Agent Chat & Execution):主智能体与子智能体的思维链流转、工具调用轨迹、用户交互指令区 [3][9]。

  3. 右侧栏(Artifacts & Tools):Markdown 报告、交互式 UI 预览、内置终端会话与多智能体任务监控板 [1][9]。


2. 模型体系切换与调度

在界面顶部点击模型选择器,可以自由切换 Google 当前提供的模型家族 [5]:

图 14 模型菜单

图源:[5] 雷科技《谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气》

  • Gemini 3.8 Flash:轻量高速,适合日常代码审查、语法排查、小函数修改,消耗额度最少。

  • Gemini 3.8 Pro:主力复杂推理模型,拥有百万级长上下文,适合多文件大型重构与复杂算法编写。

  • Gemini 4 Argon:2026 年下半年推出的前沿实验性模型,在多模态理解与架构原型推演上表现突出 [10]。


3. 重点:接入其他模型 / API Key 配置与支持策略

很多从 Claude Code 或 OpenCode 转过来的用户关心:Antigravity 能不能像它们一样随便换上 OpenAI 或 DeepSeek 的模型?

(1)官方原生支持策略(核心原则)

  • 官方定位:Google Antigravity 是 Google 针对 Gemini 系列模型原生深度定制的 Harness 系统 [2][5]。官方桌面端与核心会话驱动原生仅支持 Google 生态模型(通过 Google 账号登录授权,或填入 Google AI Studio / Vertex AI 的 API Key)[官1][官2]。

  • 官方下拉菜单:客户端主界面顶部的「Model」下拉菜单中不直接提供填入第三方 OpenAI / DeepSeek Base URL 的入口 [5]。

(2)通过 MCP 与代理扩展接入第三方模型(进阶方案)

虽然主界面不设第三方单选框,但 Antigravity 拥有极其强大的 MCP(Model Context Protocol)与插件体系。如果你必须在 Antigravity 流程中调用第三方模型的能力,官方推荐以下两种标准方案 [官3][官7]:

  1. 配置第三方 MCP 服务器(MCP Tool 方案): 在工作区的 mcp_config.json 或全局设置中,挂载一个模型调用 MCP 服务(例如基于 OpenAI / DeepSeek API 封装的子工具):

    json
    {
      "mcpServers": {
        "deepseek-reasoner": {
          "command": "npx",
          "args": ["-y", "@model-context-protocol/server-openai-compatible"],
          "env": {
            "OPENAI_BASE_URL": "https://api.deepseek.com/v1",
            "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
            "DEFAULT_MODEL": "deepseek-reasoner"
          }
        }
      }
    }

    挂载后,Antigravity 主智能体在遇到极其复杂的数学运算或特定逻辑时,会自动调用该 MCP 工具让外部模型给出解答并收敛结果 [官3]。

  2. 本地 Sidecar 代理转接: 通过第三方开源代理工具将第三方接口伪装为本地兼容协议,再注入项目上下文。但需注意,非 Gemini 模型无法享受 Antigravity 底层特有的长思维链优化与特殊 Tool 调用格式 [5]。


4. 后台长流程任务(Background Tasks)与多智能体协同

在处理大工程时,很多任务(如依赖安装、跑全套测试、打包构建)需要耗时数分钟甚至数小时。Antigravity 支持将任务推入后台并行执行:

图 15 后台任务

图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》

  • 主界面不会被阻塞,你可以继续开新会话做其他功能 [4]。

  • 当后台任务执行完毕或抛出错误时,系统会自动唤醒主会话并呈递执行报告,实现了真正的异步多智能体协同 [4][官4]。


5. 定制化规则与内置生态(Rules & Browser)

(1)项目与全局规则配置(Rules)

在项目根目录下创建 .gemini/rules.md 或在 IDE 设置中配置 Rules:

图 16 Rules设置

图源:[7] 小可乐论AI《用了3个月 Google Antigravity,我整理出这份「高阶玩法」指南(建议收藏)》

你可以硬性规定团队代码风格(如"所有组件必须使用 TypeScript 并强制导出 Props 接口,样式一律使用 Tailwind"),AI 在后续每一次生成时都会强制遵守 [6][7]。

(2)内置浏览器自动化(Browser Automation)

Antigravity 内置了专用的浏览器控制协议,支持 AI 自主启动受控 Chrome 实例并截获网络请求与页面截图:

图 17 浏览器设置

图源:[7] 小可乐论AI《用了3个月 Google Antigravity,我整理出这份「高阶玩法」指南(建议收藏)》

适合用于前后端联调、页面视觉回归测试以及抓取动态文档 [7]。

(3)内置文档与快捷键系统

点击顶部菜单的「Help → Documentation」,可以随时打开本地或云端的 Antigravity 指南与快捷键映射表:

图 18 帮助菜单打开文档

图源:[2] 薪火传《Antigravity 2.0 官方真实说明手册(全站深度翻译与重构版)》


五、避坑与注意(⚠️ 关键避坑)

1. ⚠️ 1.0 与 2.0 的配置迁移差异

  • 问题:早期 1.0 时代很多文章写的项目配置文件放在根目录的临时隐藏文件中,且安全控制属于全局暴力开关(如图 07 所示)[4]。

  • 注意:2.0 时代配置已全面标准化,安全策略由**终端沙箱(Terminal Sandbox)与行为白名单(如图 08)**接管。切勿混用旧版教程中废弃的环境变量 [3][4]。

2. ⚠️ 免费层账号的并发速率限制(Rate Limits)

  • 问题:使用免费 Google 账号时,如果连续调用深度规划命令(如连续使用 /boost 或超长上下文多文件分析),极易触发 429 Resource Exhausted 报错 [4][6]。

  • 避坑建议:大型项目分析前,先在设置中核查当前模型的剩余 Quota(如图 06)。高并发阶段建议切换至 Gemini Flash 跑初筛,最后再用 Pro 定稿 [4][6]。

3. ⚠️ 电商黑产买号风险

  • 问题:部分国内教程或社群引导用户去闲鱼购买所谓"永久免翻/无限配额"账号 [清单说明]。

  • 警告:该类账号绝大多数走的是批量盗刷免费试用期的黑产通道,官方每隔数周会进行一次全网指纹风控清洗。请务必使用正规注册账号,避免代码资产与配置丢失!


六、参考原文与出处

1. 本文参考微信公众号素材清单

#文章标题与链接来源公众号发布日期配图数为什么入选与核心引用点
1[Antigravity 新手上手教程]懂懂的AI工作流2026-05-04131.9 万字入门长文,系统介绍核心交互与 Artifacts 机制(引用图 17)
2[Antigravity 2.0 官方真实说明手册(全站深度翻译与重构版)]薪火传2026-05-203官方 2.0 手册权威翻译整理,梳理 CLI 首次启动与系统文档体系(引用图 14、18)
3[Google Antigravity 2.0 新版--中文使用手册整理]Data接化发2026-05-283中文手册精粹,重点解析终端沙箱开关与多窗口布局(引用图 08)
4[Antigravity 2.0的8个使用技巧,告别摸索期]草莓派2026-05-2468 个高频实操技巧:新建项目、配额查看、旧版安全预设与后台任务(引用图 02、03、06、07、10)
5[谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气]雷科技2026-05-2017资深数码媒体实测,评测 2.0 主界面、输入框上下文添加、模型菜单与 /grill-me 互动(引用图 01、04、05、09)
6[用了两周 Antigravity 2.0,我整理了这份「避坑+提效」全指南]小可乐论AI2026-05-284两周深度避坑总结,包括 Skills 体系、UI 工作流与配额管理
7[用了3个月 Google Antigravity,我整理出这份「高阶玩法」指南(建议收藏)]小可乐论AI2026-04-147高阶玩法手册,系统讲解 Rules 规范配置与内置浏览器自动化设置(引用图 15、16)
8[第二篇:5 分钟上手 Antigravity CLI,安装、配置与第一个任务]FutureCraft AI2026-07-123命令行 CLI 极速指南,讲解 headless 无头任务运行与 CI 流程
9[Antigravity App:一个被低估的桌面智能体]AI编程瓜哥2026-11-0214桌面客户端深度剖析,完整解析三栏布局示意、实际界面与内置终端(引用图 11、12、13)
10[Google Antigravity里的Gemini 4 Argon:原型工作流可以怎么跑]AI出海实战2026-11-01211 月新模型前瞻,实测在 Antigravity 中使用 Gemini 4 Argon 跑快速原型

2. 官方技术文档与生态规范列表

编号来源与页面名称查阅日期补充与核实用到的核心内容
[官1]Google DeepMind Antigravity 官方技术白皮书2026-11-08多智能体 Harness 架构、系统安全性设计与沙箱边界规范
[官2]Google AI Studio / Vertex AI 模型定价与配额规范2026-11-08Gemini 3.8 Flash / Pro / Argon 模型上下文参数与调用配额策略
[官3]Antigravity MCP (Model Context Protocol) 集成规范2026-11-08外部第三方工具与外部模型服务通过 MCP 桥接的技术标准
[官4]Antigravity CLI Reference & Headless Mode Docs2026-11-08agy 命令行参数规范、后台任务生命周期与无头 CI/CD 集成指南

3. 本文使用图片清单核对表

图片文件名图片内容说明引用章节对应素材来源
01-2.0主界面.pngAntigravity 2.0 桌面端主操作界面总览第一节 定位[5] 雷科技
02-新建项目选文件夹.png启动向导中新建或选择本地项目文件夹第二节 2. 桌面客户端安装[4] 草莓派
03-项目设置.png项目初始化设置弹窗(名称、Git配置等)第二节 2. 桌面客户端安装[4] 草莓派
04-输入框添加上下文.png底部输入框通过 @ 唤醒添加本地文件上下文第三节 上手流程[5] 雷科技
05-模型菜单.png顶部状态栏切换 Gemini 各版本模型的下拉菜单第四节 2. 模型体系切换[5] 雷科技
06-模型额度.png设置界面中当前账号各模型的配额与重置信息第二节 1. 账号与费用配额[4] 草莓派
07-旧版安全预设.png早期 1.0 版本粗放的安全预设选项界面第二节 4. 终端沙箱与安全策略[4] 草莓派
08-终端沙箱开关.png2.0 细粒度的终端沙箱(Sandbox)控制开关第二节 4. 终端沙箱与安全策略[3] Data接化发
09-grill-me追问.png/grill-me 指令下 AI 主动反问需求边界的交互第三节 上手流程[5] 雷科技
10-后台任务.png后台异步长流程任务管理与运行状态卡片第四节 4. 后台长流程任务[4] 草莓派
11-三栏布局示意.jpg官方三栏式工作区架构划分示意图第四节 1. 三栏式工作区布局[9] AI编程瓜哥
12-三栏实际界面.jpg三栏布局在复杂项目开发时的实际运行效果第四节 1. 三栏式工作区布局[9] AI编程瓜哥
13-内置终端.jpgIDE 内部无缝集成的多标签终端操作区第三节 上手流程[9] AI编程瓜哥
14-CLI首次启动.png命令行工具 agy 首次启动与设备码授权流程第二节 3. 命令行 CLI 安装[2] 薪火传
15-Rules设置.png项目规则与全局规则(Rules)配置编辑器第四节 5. 定制化规则与内置生态[7] 小可乐论AI
16-浏览器设置.png内置无头浏览器自动化权限与控制配置页第四节 5. 定制化规则与内置生态[7] 小可乐论AI
17-Artifacts示意.png独立工件区(Artifacts)渲染文档与任务状态看板第三节 上手流程[1] 懂懂的AI工作流
18-帮助菜单打开文档.png帮助菜单直接唤起官方技术文档与快捷键面板第四节 5. 定制化规则与内置生态[2] 薪火传
更新于 2026-11-08来源:用户提供《工具指南_完整全套_含所有MD与图片.zip》;正文保留原文参考来源