- 适用对象
- 想快速了解工具定位、核心功能和上手路径的中文用户
- 核对日期
- 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]。
图源:[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 Antigravity | Claude Code | OpenAI Codex / ChatGPT Desktop | Cursor |
|---|---|---|---|---|
| 核心交互范式 | 三栏多智能体 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]。
配额查看与预警: 在设置中可实时查看当前账号各模型的配额余量与重置倒计时:
图源:[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,首次打开会进入新建或打开项目向导:
图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》
选择你本地已有的代码仓库文件夹,或者点击「New Project」让它从零初始化一个空项目 [4]。
第三步:项目个性化设置
在项目初始化弹窗中,可以设置项目名称、默认 Git 追踪分支以及语言环境规范:
图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》
3. 命令行 CLI (agy) 安装与使用
Antigravity 提供了极强的独立命令行生态 agy,支持开发者在无桌面界面的环境中使用 [2][8]:
安装命令
# 全局安装 agy
npm install -g @google/antigravity
# 验证安装
agy --version首次启动与授权
在终端中输入:
agy程序会自动弹出授权链接并在终端显示设备码:
图源:[2] 薪火传《Antigravity 2.0 官方真实说明手册(全站深度翻译与重构版)》
在浏览器中确认授权后,CLI 即可在当前终端激活使用。
4. 终端沙箱与安全策略配置
Antigravity 2.0 在安全策略上做出了重大升级:
早期 1.0 的旧版安全预设:早期的安全控制较为粗放,要么全开要么全关:
图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》
2.0 的终端沙箱与操作审查机制:2.0 引入了独立的终端沙箱开关,细化到「命令级风险确认」与「文件读写范围限制」[3][4]:
图源:[3] Data接化发《Google Antigravity 2.0 新版--中文使用手册整理》
开启沙箱后,危险的系统级写入命令会被严格阻断或强制二次弹窗,确保开发安全 [3]。
三、上手流程:从零到第一个完整项目
下面以使用 Antigravity 2.0 开发一个具备响应式界面的待办与番茄钟工具为例,带你走完从规划到交付的标准流程。
第一步:打开工作空间并添加上下文
在中间底部的对话框中,可以灵活引用本地文件作为上下文 [4][5]:
输入
@可快速唤醒本地文件选择器,将已有的需求文档、API 接口定义或原型图挂载到当前任务中。
图源:[5] 雷科技《谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气》
第二步:使用 /grill-me 深度对齐需求
不要直接让 AI 闭着眼睛写代码!在输入框键入:
/grill-me 我想基于 React + Tailwind 开发一个带音效的番茄钟应用。请审查我的需求,向我提问关键决策点。
此时 AI 会化身为严格的技术专家,主动向你追问:
"计时结束时的音效需要本地音频还是使用 Web Audio API 合成?"
"数据需要持久化在 LocalStorage 还是未来对接云端接口?"
"当用户离开页面或最小化窗口时,是否需要调用浏览器 Notification API 发送桌面通知?"
图源:[5] 雷科技《谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气》
通过 2~3 轮互动,架构边界彻底敲定,大幅减少返工![4][5]
第三步:生成架构设计工件(Artifacts)
确认完需求后,AI 会自动在右侧工件区生成详细的技术设计方案与任务看板 [1][9]:
图源:[1] 懂懂的AI工作流《Antigravity 新手上手教程》
工件区会实时呈现状态:
待办清单卡片(每完成一步自动打勾)
模块依赖架构图(基于 Mermaid 渲染)
关键接口定义文档
第四步:代码编写与内置终端运行
AI 开始自动编写组件文件,并在内置终端中执行 npm run dev:
图源:[9] AI编程瓜哥《Antigravity App:一个被低估的桌面智能体》
终端输出的本地运行端口会被 AI 自动捕获。你可以点击右侧的预览选项卡,直接在 IDE 内部查验网页成品的交互效果![9]
四、核心功能与进阶
1. 三栏式工作区布局设计
Antigravity 2.0 的三栏设计是其标志性特征 [9]:
图源:[9] AI编程瓜哥《Antigravity App:一个被低估的桌面智能体》
实际运行时的界面划分非常自然:
图源:[9] AI编程瓜哥《Antigravity App:一个被低估的桌面智能体》
左侧栏(Code Space):项目文件目录树、当前激活代码编辑窗口、Git 提交记录与 Diff 比较区 [9]。
中间栏(Agent Chat & Execution):主智能体与子智能体的思维链流转、工具调用轨迹、用户交互指令区 [3][9]。
右侧栏(Artifacts & Tools):Markdown 报告、交互式 UI 预览、内置终端会话与多智能体任务监控板 [1][9]。
2. 模型体系切换与调度
在界面顶部点击模型选择器,可以自由切换 Google 当前提供的模型家族 [5]:
图源:[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]:
配置第三方 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]。
本地 Sidecar 代理转接: 通过第三方开源代理工具将第三方接口伪装为本地兼容协议,再注入项目上下文。但需注意,非 Gemini 模型无法享受 Antigravity 底层特有的长思维链优化与特殊 Tool 调用格式 [5]。
4. 后台长流程任务(Background Tasks)与多智能体协同
在处理大工程时,很多任务(如依赖安装、跑全套测试、打包构建)需要耗时数分钟甚至数小时。Antigravity 支持将任务推入后台并行执行:
图源:[4] 草莓派《Antigravity 2.0的8个使用技巧,告别摸索期》
主界面不会被阻塞,你可以继续开新会话做其他功能 [4]。
当后台任务执行完毕或抛出错误时,系统会自动唤醒主会话并呈递执行报告,实现了真正的异步多智能体协同 [4][官4]。
5. 定制化规则与内置生态(Rules & Browser)
(1)项目与全局规则配置(Rules)
在项目根目录下创建 .gemini/rules.md 或在 IDE 设置中配置 Rules:
图源:[7] 小可乐论AI《用了3个月 Google Antigravity,我整理出这份「高阶玩法」指南(建议收藏)》
你可以硬性规定团队代码风格(如"所有组件必须使用 TypeScript 并强制导出 Props 接口,样式一律使用 Tailwind"),AI 在后续每一次生成时都会强制遵守 [6][7]。
(2)内置浏览器自动化(Browser Automation)
Antigravity 内置了专用的浏览器控制协议,支持 AI 自主启动受控 Chrome 实例并截获网络请求与页面截图:
图源:[7] 小可乐论AI《用了3个月 Google Antigravity,我整理出这份「高阶玩法」指南(建议收藏)》
适合用于前后端联调、页面视觉回归测试以及抓取动态文档 [7]。
(3)内置文档与快捷键系统
点击顶部菜单的「Help → Documentation」,可以随时打开本地或云端的 Antigravity 指南与快捷键映射表:
图源:[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-04 | 13 | 1.9 万字入门长文,系统介绍核心交互与 Artifacts 机制(引用图 17) |
| 2 | [Antigravity 2.0 官方真实说明手册(全站深度翻译与重构版)] | 薪火传 | 2026-05-20 | 3 | 官方 2.0 手册权威翻译整理,梳理 CLI 首次启动与系统文档体系(引用图 14、18) |
| 3 | [Google Antigravity 2.0 新版--中文使用手册整理] | Data接化发 | 2026-05-28 | 3 | 中文手册精粹,重点解析终端沙箱开关与多窗口布局(引用图 08) |
| 4 | [Antigravity 2.0的8个使用技巧,告别摸索期] | 草莓派 | 2026-05-24 | 6 | 8 个高频实操技巧:新建项目、配额查看、旧版安全预设与后台任务(引用图 02、03、06、07、10) |
| 5 | [谷歌Antigravity 2.0上手:干活能力强,但离Claude/Codex还差口气] | 雷科技 | 2026-05-20 | 17 | 资深数码媒体实测,评测 2.0 主界面、输入框上下文添加、模型菜单与 /grill-me 互动(引用图 01、04、05、09) |
| 6 | [用了两周 Antigravity 2.0,我整理了这份「避坑+提效」全指南] | 小可乐论AI | 2026-05-28 | 4 | 两周深度避坑总结,包括 Skills 体系、UI 工作流与配额管理 |
| 7 | [用了3个月 Google Antigravity,我整理出这份「高阶玩法」指南(建议收藏)] | 小可乐论AI | 2026-04-14 | 7 | 高阶玩法手册,系统讲解 Rules 规范配置与内置浏览器自动化设置(引用图 15、16) |
| 8 | [第二篇:5 分钟上手 Antigravity CLI,安装、配置与第一个任务] | FutureCraft AI | 2026-07-12 | 3 | 命令行 CLI 极速指南,讲解 headless 无头任务运行与 CI 流程 |
| 9 | [Antigravity App:一个被低估的桌面智能体] | AI编程瓜哥 | 2026-11-02 | 14 | 桌面客户端深度剖析,完整解析三栏布局示意、实际界面与内置终端(引用图 11、12、13) |
| 10 | [Google Antigravity里的Gemini 4 Argon:原型工作流可以怎么跑] | AI出海实战 | 2026-11-01 | 2 | 11 月新模型前瞻,实测在 Antigravity 中使用 Gemini 4 Argon 跑快速原型 |
2. 官方技术文档与生态规范列表
| 编号 | 来源与页面名称 | 查阅日期 | 补充与核实用到的核心内容 |
|---|---|---|---|
| [官1] | Google DeepMind Antigravity 官方技术白皮书 | 2026-11-08 | 多智能体 Harness 架构、系统安全性设计与沙箱边界规范 |
| [官2] | Google AI Studio / Vertex AI 模型定价与配额规范 | 2026-11-08 | Gemini 3.8 Flash / Pro / Argon 模型上下文参数与调用配额策略 |
| [官3] | Antigravity MCP (Model Context Protocol) 集成规范 | 2026-11-08 | 外部第三方工具与外部模型服务通过 MCP 桥接的技术标准 |
| [官4] | Antigravity CLI Reference & Headless Mode Docs | 2026-11-08 | agy 命令行参数规范、后台任务生命周期与无头 CI/CD 集成指南 |
3. 本文使用图片清单核对表
| 图片文件名 | 图片内容说明 | 引用章节 | 对应素材来源 |
|---|---|---|---|
01-2.0主界面.png | Antigravity 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-终端沙箱开关.png | 2.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-内置终端.jpg | IDE 内部无缝集成的多标签终端操作区 | 第三节 上手流程 | [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] 薪火传 |