适合人群:想用独立桌面应用体验 Google Antigravity、让代理在本地文件夹里完成第一个小任务的同学。本文主讲官方入门路径中的 App 安装与首个项目,CLI 与各 IDE 扩展仅作简要提及。
本文用一个场景贯穿:小唐想在本机新建一个小脚本项目,让代理按说明生成一份可读的示例脚本,自己审阅改动后再接受,而不是一上来就改正式仓库。
一、Antigravity 有哪些入口
官方入门文档列出多种使用面:独立的 Antigravity App、命令行工具 agy、面向多种编辑器的扩展(如 VS Code、JetBrains、Visual Studio、Zed、Xcode、Eclipse),以及 Python SDK。对新手,优先从 App 开始最省事:装好、登录、建项目、发一条指令即可看到完整流程。
对话能力属于 Gemini 系列模型家族。本文不展开具体型号与计费细节,以免与日后文档更新不一致;以你登录后界面显示为准。
二、安装 App 并登录
- 按官方入门页下载对应系统的安装包:macOS 需 12 及以上,Windows 需 10 及以上,亦提供 Linux 安装方式;
- 安装完成后启动应用;
- 使用 Google 账号登录。
首次进入后,先熟悉主界面中的项目区与代理对话区即可,不必急着改系统级权限。
三、创建第一个项目
推荐步骤:
- 选择 New Project;
- 通过 Add Folder 加入本地目录(可以是已有 Git 仓库,也可以是普通文件夹);
- 确认 Create;
- 在输入区写下任务说明;
- 选择运行模式:Local 会在当前活动文件夹内直接编辑;New worktree 则在隔离的 Git worktree 中工作,更适合怕误改主分支的练习。
小唐第一次练习建议选一个空文件夹或练习仓库,并用 New worktree,降低误伤正式代码的风险。
四、发一条简单指令并审阅
任务说明尽量具体。例如:「在当前项目里新建一个打印 Hello 的小脚本,并附简短使用说明」。发送后观察代理提出的文件改动,先逐条审阅,再决定接受或回退。官方入门强调:从偏审阅驱动的权限习惯起步,不要默认自动接受全部写入。
常用快捷方式包括:用 Cmd+E 或 Ctrl+E 打开 Agent Manager;对话里可用斜杠命令,例如 /goal、/grill-me、/schedule、/browser、/plugin。具体可用性以当前版本界面为准。
五、CLI 与 IDE 扩展怎么理解
当你熟悉 App 流程后,可按需安装命令行 agy,或在常用编辑器里启用官方扩展,把同一套代理能力嵌进日常写码环境。Python SDK 面向要把能力编进自己脚本的开发者。初学阶段不必一次装全,先把「建项目 → 发任务 → 审阅 → 接受」跑通即可。
整次练习的目标是熟悉审阅节奏,而不是追求一次生成很长的项目骨架。
常见问题
问:必须先有 Git 仓库吗?
答:Add Folder 可以加入普通本地目录。若选择 New worktree,则更依赖 Git 工作区;练习时可用新建仓库或空目录按界面提示处理。
问:Local 和 New worktree 怎么选?
答:直接改当前文件夹用 Local;希望改动隔离、便于丢弃试用结果时用 New worktree。
问:代理改完能不能不看就全盘接受?
答:不建议。入门文档强调先审阅再接受,尤其是涉及删除或大范围重写时。
问:只有 App 能用吗?
答:不是。还有 CLI、多种 IDE 扩展与 Python SDK。本文只把 App 当作最短上手路径。
小贴士
- 第一次用空练习目录,确认流程后再指向正式项目。
- 任务说明写清语言、文件名与验收标准,比空泛的「帮我写点代码」更稳。
- 养成打开 Agent Manager 查看进行中任务的习惯。
- 斜杠命令先试用 /goal 把目标写清楚,再让代理拆步骤。
参考资料
- Google Antigravity Docs:Getting started https://antigravity.google/docs/getting-started