Antigravity 从入门到实战：安装、配置与工作流完整指南

认识 Antigravity 与工作方式

Antigravity 是围绕 Agent 协作设计的开发与工作环境，可从桌面应用、命令行或 IDE 扩展进入。它可以协助理解项目、拆解任务、调用工具、修改文件并检查结果。使用时要先明确项目目录、权限范围和验收标准，再逐步交给 Agent 执行。

除了编程，它也能处理本地资料整理、写作草稿、浏览器页面检查和连接器同步等任务。任务越复杂、工具调用越多，就越要明确目标、限制和交付形式，并在关键步骤检查实际变化。

选择入口并完成安装

桌面应用集成了项目管理、对话、插件和内置浏览器等能力，适合初次使用或需要并行管理多个任务的人。命令行适合终端工作流，IDE 扩展适合在编辑器内协作；这些入口可以使用同一 Google 账号的本地凭证。

命令行安装方式因操作系统而异：macOS 或 Linux 使用对应的终端安装脚本，Windows 使用 PowerShell 安装脚本。运行前确认脚本来源可信，并阅读将执行的内容。

安装后打开桌面应用登录账号，再创建或打开项目。首次使用可先熟悉左侧的 Projects、Automations 和 Customizations；输入框中可用 @ 引用文件、用 / 查看命令。模型选择与额度信息可从 View Usage 查看。

创建项目与管理工作目录

选择 New Project 后，将真实的本地项目文件夹加入工作区。一个项目可以关联多个文件夹，适合需要同时查看多个代码仓库的工作。开始任务前，检查项目名称和当前目录，确认 Agent 操作的文件范围与预期一致。

如果界面显示当前 Git 分支，可以从分支菜单选择 Work in a New Worktree，让任务在独立工作树中运行。完成后先检查差异、测试结果和文件位置，再决定是否合并；这样能把探索性修改与主工作区隔开。

设置命令权限与浏览器 Agent

命令执行模式决定 Agent 能否直接运行终端命令。Request Review 会在执行命令前请求确认，适合刚开始使用或涉及不熟悉操作时逐条检查。Turbo 会放宽命令执行限制，不应把它当作单纯的速度选项；启用前先理解文件、终端与网络权限可能带来的影响。

在 Settings 的 General 设置中可找到 Browser Subagent。安装并连接 Chrome 后，可以按任务需要开放浏览器子 Agent 的脚本执行与页面操作权限，并决定任务是否保持在底部面板运行。权限应与实际任务相称，完成后检查它访问和操作了哪些页面。

项目的 Tool Permissions、网络规则与 Plan Review Policy 也应在开始工作前查看。提示词可以说明目标和边界，但不能替代权限设置或执行前的审阅。

处理登录与地区可用性

登录或使用时若出现地区不可用提示，先确认服务在当前地区的开放情况、账号状态和网络连接是否正常。教程中的网络体验提到，美国节点较稳定，日本节点也可作为备选；网络出口的质量和共享情况会影响连接体验，这些观察不代表所有账号或网络都适用。

出现登录异常时，可先确认网络稳定，退出账号并清理浏览器缓存后重新登录。不要反复提交登录或授权请求；若限制仍然存在，应以账号页面显示的可用范围和服务提示为准。

理解订阅与额度范围

Antigravity 的可用模型与额度会因账号、订阅方案和时间而变化。原教程举例提到低价年付、学生优惠续期及低价地区订阅等做法，并记录了约 19 元一年的个人使用案例、8.99 美元的优惠案例和月付约 30 元的地区方案。这些是教程中的价格与经历示例，不代表当前报价、资格或可获得的服务。

办理订阅前，应核对账号资格、计费周期、续费价格、付款方式和服务条款。不要只凭他人的截图或价格描述做决定，也不要假设某个优惠会对所有账号开放。

用 Obsidian 整理本地资料

如果日常写作与资料都保存在 Obsidian 知识库，可以把知识库文件夹作为项目目录，让 Agent 在同一工作区中查找笔记、整理提纲和修改草稿。需要处理某篇笔记时，可引用对应文件；要它汇总多个主题时，明确资料范围和输出结构。

Claudian 插件可通过本机的 Antigravity CLI 与笔记库配合使用。先安装并登录命令行工具，在终端确认命令可正常运行，再安装并启用 Claudian。在插件设置中选择 Antigravity 并启用相应提供商，之后从侧栏或命令面板打开插件。

处理当前笔记时，可以先选中需要修改的段落，再说明改写目标；查找资料时则明确要检索的笔记或文件夹。提交修改前检查原文和生成内容，避免把未经核对的资料直接并入知识库。

连接 Notion 并确认授权

在 Customizations 的 Marketplace 中找到 Notion 插件并开始连接。按登录与授权页面的步骤选择要开放的工作区或页面，完成确认后回到 Antigravity 输入授权流程要求的内容。

连接完成后，在插件详情的 Accounts 中确认账号状态为 CONNECTED。随后可以让 Agent 列出授权范围内的页面，检查返回结果是否符合预期。账户已连接并不表示整个工作区都开放；能读取或修改哪些内容，取决于 Notion 中授予的权限。

项目设置中的 Folders 显示当前关联的文件夹，Add Folder 可添加新的工作目录。Customizations 还可查看 Rules、Skills 和 MCP Tools 的内容与上下文占用；若配置内容很多，可检查是否超出项目预算，并按实际需要精简。

用 /boost 调查复杂问题

/boost 适合需要跨文件调查、分析调用关系或并行检查的复杂任务。它会把工作拆分给负责调查或实现的子 Agent，并汇总结果。执行前应写清任务目标、是否允许改动文件，以及需要提交哪些证据。

先调查而不修改代码时，可以使用这样的指令：

/boost 调查 [具体问题或报错]
先阅读相关代码，梳理完整调用路径和可能原因
不要修改代码
给出支持结论的文件位置、尚未排除的疑点和验证方式

拿到调查结果后先审阅依据和疑点，再决定是否让 Agent 实施修复。任务结束后检查子 Agent 的修改范围和测试结果；不要因为使用了并行流程就跳过人工验收。

评估 /teamwork 的适用场景

/teamwork 会组织更长周期、更大规模的协作任务。原教程的实测反馈认为，它在部分任务中收敛较慢，可能需要更多验证轮次和额度；遇到一般的跨文件问题，/boost 通常更容易控制范围。

只有当工作确实需要较大团队并行处理时，才考虑 /teamwork。开始前先限制任务规模、说明分工和完成标准，并留意额度消耗。若任务不需要大规模协作，拆成可审阅的小步骤更容易掌握进度。

使用浏览器 Agent 验收页面

编写或修改网页后，可以使用 /browser 让浏览器子 Agent 打开本地页面、点击交互控件，并在桌面和窄屏尺寸下检查布局。第一次验收时，先让它报告页面现状与问题；需要调整时，再依据可复现的界面问题修改。

如果有参考设计，可以让 Agent 逐项比较间距、颜色、文字和状态，不要只凭“看起来不对”下结论。Antigravity 桌面应用的侧边栏浏览器也可用于边开发边查看本地效果。Chrome Modern Web Guidance 等插件可提供 Web 开发提示，但生成结果仍需在实际页面中检查。

远程控制本地运行实例

Remote Control 用于远程查看和控制自己仍在运行的电脑或服务器。设备需要保持开机并联网；在手机浏览器进入远程控制界面后，可以在已连接的实例间切换，查看项目和会话，并继续发送任务。

出门前确认主机在线、实例连接正常，并使用安全的账号访问方式。远程界面能看到的内容与可执行操作取决于本地实例及其权限设置；离开设备前应检查正在运行的任务和工作目录。

了解云端 Remote Agents

Remote Agents 将任务运行在云端环境中。任务启动后，即使关闭浏览器或让本地电脑休眠，云端任务仍可继续运行，之后可以重新查看进度。

远程项目可以关联代码仓库，也可按创建流程添加云端文件或云盘资源。开始任务前确认项目资源、访问权限和需要交付的文件；完成后检查改动并按自己的工作流同步结果。

选择模型并管理额度

原教程以 Gemini 3.8 Flash 作为日常主力，并建议将额度较紧张的 Gemini 4 Argon 留给更难的任务。这是教程发布时的模型与额度体验；可用模型、速度和配额可能随账号或产品调整，应以自己的 View Usage 页面为准。

View Usage 可分别查看 Gemini、Claude、GPT 等模型组的额度与刷新周期。涉及多 Agent 或频繁工具调用时，先确认会使用哪个模型及对应额度。不同模型组的额度分开显示，不要把某一组的剩余额度理解为全部共享。

运行 /boost 或 /teamwork 前，尤其要留意多个子 Agent 并发调用模型可能加快额度消耗。可先用小任务估算用量，再决定是否扩大任务范围。

按任务选择常用命令

/plan：目标尚未明确时，先梳理边界、步骤与验收标准；可配合 /grill-me 补充问题。
/goal：目标和交付标准清楚时，写明预期结果与需要执行的检查。
/boost：调查难以定位的错误或跨文件问题；可先要求只调查、不修改。
/browser：检查网页交互、桌面布局和窄屏表现。
/btw：在主任务运行时提出旁支问题，避免打断当前工作。
/learn：把反复出现的纠正经验整理为后续可复用的规则或 Skill。
/schedule：安排周期性整理或巡检任务。
/effort：在命令行中调整思考档位；先按任务难度选择，再观察速度与结果。

组合一套稳妥的日常工作流

确认项目和工作目录，必要时建立独立 Worktree。
先用 Plan 写清目标、边界、文件范围和验收方式。
按任务选择模型与命令；复杂问题先调查，再决定是否实施。
涉及外部工具时检查连接状态、授权范围和可访问内容。
让 Agent 完成任务后，检查文件差异、运行结果和浏览器表现。
整理有效做法，并为定期重复的任务设置合适的自动化。

始终让任务规模与权限相称。特别是需要删除、覆盖、上传或执行命令时，先查看将要发生的具体操作，再决定是否继续。

使用声明

本文整理 Antigravity 的使用流程与工作方法，仅供学习参考。功能、模型、地区可用性、订阅资格和额度可能调整，请以当前账号及应用界面显示为准。涉及文件修改、命令执行和外部连接时，应先确认操作范围与授权内容。

本文不构成购买、订阅或账号资格建议。请在作出决定前核对适用条款、实际费用和自身资格。