用 Google Antigravity 创建项目并管理多个智能体会话

Google Antigravity 是一个面向智能体（agent）的开发平台。它把智能体当作主要工作单元：你给它一个项目范围，它在这个范围内读写文件、调用工具、产出结果，而你在一个统一的界面里启动、观察和调度这些智能体。适合的人群包括想用智能体辅助日常编码的开发者、需要同时推进多条任务线的工程师，以及希望把智能体能力接入现有编辑器工作流的人。本文围绕 Antigravity 桌面应用展开，讲清安装登录、项目（Project）的建立方式、项目内多条对话线程的管理，以及按项目覆盖权限设置这几件事。站内也整理了该工具的条目，可参考 Google Antigravity。

需要先说明产品形态。Antigravity 目前由几个部分组成：一个是独立的桌面应用（支持 macOS、Linux、Windows），作为管理多个本地智能体、运行计划任务的控制中心，它不依赖 IDE 单独运行；一个是功能完整的 Antigravity IDE，内置智能体管理器与产物（artifacts），对代码库有较深的理解；此外还有命令行形态的 Antigravity CLI、供开发者把能力集成进自有系统的 Antigravity SDK，以及面向 Visual Studio Code、JetBrains、Zed 等编辑器的官方扩展。本文重点讲独立桌面应用，并简要涉及 IDE 的安装；CLI 与 SDK 不在本文范围内。

准备工作

在动手之前，先把前置条件确认清楚，可以避免装到一半卡住。

操作系统：Antigravity 需要安装在本地机器上，提供 macOS、Windows 以及特定 Linux 发行版的版本。Linux 用户如果使用 .tar.gz 二进制包部署，安装启动器会自动配置并原生启动完整的 IDE 环境，应用菜单里只会出现一个整合图标，同时承担代码工作区与后台智能体管理。
浏览器：需要一个 Chrome 浏览器用于登录授权流程。
账号：需要一个个人 Gmail 账号。使用个人 Google 账号登录时，Antigravity 提供入门额度；如果你的 Google 账号已经购买了 Google AI Pro 或 Ultra 套餐，则会按套餐应用相应的 Antigravity 配额限制。具体额度与套餐对应关系属于易变信息，请以官网当前说明为准。
企业场景：如果你在组织内使用，且组织已购买许可，可以选择企业账号方式，配合 Google Cloud 项目使用；也可以按用量付费的方式使用 Google Cloud 项目与相应平台。本文的示例走个人账号路径。

另外建议提前规划一个存放项目的目录。Antigravity 以项目为中心组织工作，项目指向本地文件夹，所以先想好代码放在哪里，后面建项目会顺畅很多。

操作步骤

第一步：下载并安装 Antigravity 桌面应用

打开 Google Antigravity 的下载页面，按你的操作系统选择对应安装包（macOS、Linux 或 Windows），下载完成后运行安装程序。安装器启动后会给出两种登录方式：

Continue with Google：使用个人 Google 账号登录，支持个人 Gmail 的入门额度；若账号已购买 Google AI Pro / Ultra，则套用对应配额。
Use business account：适用于企业项目场景，需要 Google Cloud 项目与组织已购买的许可，或按用量付费使用。

选择 Continue with Google，用 Google 账号完成登录与授权。授权结束后界面会出现 Open Antigravity 按钮，点击后继续后续流程。接下来会让你选择主题、勾选一个或多个 Google 插件来扩展 Antigravity 的能力（初次使用可以全部跳过），然后展示条款页面。接受条款并点击 Finish，就能看到 Antigravity 的主界面。

第二步：安装 Antigravity IDE（可选）

如果你希望同时拥有完整的 IDE 体验，可以在主界面右上角找到 Install Antigravity IDE 按钮，它会跳转到 IDE 的下载页面；也可以直接访问该下载页。页面提供两条路径：下载你常用编辑器的 Antigravity 扩展（Visual Studio Code、Zed、JetBrains 等），或者下载独立的 Antigravity IDE 安装包。

选择独立安装包时，下载对应平台的安装程序并运行，用同一个 Google 账号登录，后续步骤（IDE 配置、默认动作、插件等）全部采用默认值即可。安装完成后，程序坞里会出现两个图标：白底的 Antigravity 2.0 与黑色网格底的 Antigravity IDE。如果你已经装好了独立 IDE，主界面右上角的按钮会变成 Open Antigravity IDE，而不是 Install IDE。

第三步：理解「项目」这个概念

启动 Antigravity 后，右侧面板会提示 Select Project。这不是可有可无的装饰，而是整个产品的工作模型：Antigravity 采用以项目为中心的方式，确保智能体拿到正确的文件、工具与权限。

一个项目是若干文件夹的组合，这些文件夹共同定义智能体的运行环境与作用范围。它不要求智能体只能在一个文件夹里工作——一个项目可以包含一个或多个文件夹，例如把前端仓库和后端仓库放进同一个项目，让智能体获得完整的代码库上下文。每个项目还拥有各自独立的智能体设置，因此你可以针对不同项目分别调整安全策略。

第四步：创建第一个项目

先在本地准备一个目录。以类 Unix 系统为例，在用户主目录下创建：

mkdir -p $HOME/agy2-projects/my-first-project
cd $HOME/agy2-projects/my-first-project

这个目录不必是空的，已有代码也可以直接放进去。然后在 Antigravity 左侧导航栏找到 Projects 区域，点击 Create New Project 按钮，在弹出选项中选择 New Project。此时会打开系统的文件夹选择器，选中刚才创建的 $HOME/agy2-projects/my-first-project。至此，项目 my-first-project 就与这个文件夹建立了对应关系。

如果项目需要多个文件夹，点击左侧导航栏中该项目旁的设置齿轮图标，进入 Project Settings 对话框，使用 Add Folder 选项继续添加。确认无误后点击 Create 完成创建，然后可以关闭设置页。

第五步：开启第一段对话

项目创建完成后，点击 Start first conversation。界面会切换到对话视图，左侧项目列表里能看到 my-first-project，右侧聊天区则明确当前智能体在这个项目内工作。在输入框附近可以切换模型，也可以通过 +、@、/ 等操作附加额外上下文。

先发一条简单的问候，确认链路通畅；再发一条实际请求，例如让它获取新闻，观察它如何响应。这些消息会构成一段对话线程，线程以单条记录的形式出现在左侧，归组在对应项目之下。

第六步：给对话命名并新建线程

对话多了以后，默认名称很难辨认。把鼠标移到对话旁的三个竖点图标上，会展开三个选项，选择 Rename，把这段对话改名为 conv-introduction 或任何你能一眼看懂的名字。

如果要在同一个项目里开一段全新对话，点击项目旁的 +（New Conversation in Project）图标。此时你进入的是一段独立的新线程，但项目上下文仍然是 my-first-project。例如在新线程里问「给我一些世界各地的体育新闻」，它会在同一项目范围内作答。把这段线程重命名为 conv-sportsnews，左侧就会出现两条并列的线程。

想查看迄今为止的所有对话，可以打开左上角的 Conversation History。任何时候都可以通过顶部的 New Conversation 在当前项目内新建对话，或在新项目中新建对话。

第七步：按项目覆盖权限设置

新建项目时会继承一套默认权限，你可以针对具体项目单独覆盖。进入方式是点击左侧导航栏中该项目旁的设置齿轮图标，选择 Project Settings。

权限的继承关系可以这样理解：每个项目从主界面 Settings 中的全局配置继承关于产物审阅、允许使用的工具、MCP 服务器配置等方面的权限；在此之上，你可以按项目单独设定这些权限。这样做的好处是让每个项目的上下文与工具集保持精简、贴合实际需要，而不是把所有能力一股脑开放给所有项目。

一个完整示例

下面把前面的步骤串成一条从零到跑通的路径，假设你使用 macOS 或 Linux，并且已经完成安装与登录。

准备目录：在终端执行 mkdir -p $HOME/agy2-projects/my-first-project，把已有的示例代码放进该目录（没有代码也可以，空目录同样可用）。
创建项目：打开 Antigravity，在左侧 Projects 区域点击 Create New Project，选择 New Project，在文件选择器中定位到 $HOME/agy2-projects/my-first-project 并确认。
补充文件夹（可选）：如果这个项目还需要另一个代码仓库，点击项目旁的齿轮图标进入 Project Settings，用 Add Folder 添加第二个目录，然后点击 Create 保存。
发起对话：点击 Start first conversation，在聊天框输入一句问候，确认智能体有响应。
提出实际请求：在同一线程里继续输入一个具体任务，例如让它读取项目中的某个文件并解释其作用，观察它是否在项目范围内取用文件。
命名线程：点击对话旁的三个竖点，选择 Rename，命名为 conv-introduction。
开第二段线程：点击项目旁的 +，在新线程里提出另一个不相关的请求，验证两段线程互不干扰，然后重命名为 conv-sportsnews。
收紧权限：进入 Project Settings，按需调整该项目的工具允许列表与产物审阅策略，使其只覆盖这个项目真正需要的能力。

走完这八步，你已经具备了一个可复用的工作单元：一个指向明确文件夹的项目、若干条按主题命名的对话线程，以及一套只对该项目生效的权限配置。后续新增任务时，复制这套结构即可——新任务开新线程，跨仓库的任务开新项目并挂多个文件夹。

注意事项

项目与文件夹是多对多关系：一个项目可以挂多个文件夹，但每个项目的作用范围由这些文件夹共同界定。把不相关的仓库塞进同一个项目，会让智能体拿到过多上下文，反而降低判断质量。
权限继承方向不要搞反：全局 Settings 提供默认值，项目设置在其上覆盖。修改项目设置不会影响其他项目，但修改全局设置会影响所有未单独覆盖的项目。
对话线程归属固定：线程创建在哪个项目下，就一直在该项目下。跨项目的任务需要新建项目或切换项目，而不是在旧线程里继续。
账号类型决定配额：个人 Gmail 走入门额度，已购买 Google AI Pro / Ultra 的账号按套餐应用配额，企业账号则依赖组织许可或按用量付费。额度数值与套餐细节会变动，使用前请以官网当前信息为准。
Linux 打包方式的差异：使用 .tar.gz 二进制包时，应用菜单里只有一个整合图标，同时管理代码工作区与后台智能体，不要误以为安装不完整。
反馈渠道：遇到产品问题或想提功能需求，可以在 Antigravity 左下角的 Settings 中选择 Provide Feedback 提交。

把项目当作权限与上下文的边界，把对话线程当作任务的边界，是使用 Antigravity 时最值得先建立的两个习惯。前者决定智能体能看见什么、能做什么，后者决定你日后能否快速找回某次工作的来龙去脉。