AB
AB
AiBoss

All Categories

Tutorials

Google Antigravity

Tutorials

安装并启动 Google Antigravity：桌面端、CLI、IDE 插件与 Python SDK

Google Antigravity 提供桌面应用、终端 CLI、多家 IDE 插件和 Python SDK 四种使用方式。本文按平台给出安装命令与前置条件，说明首次登录、工作区角色选择、CLI 交互式配置、编辑器扩展安装路径，并用一个 Python 最小示例串起从安装到跑通的全过程。

Google Antigravity 是一套面向智能体（agent）开发的工具集合，它把「让 agent 读写代码、执行命令、产出可审阅的改动」这件事拆成几种不同的使用入口：桌面应用、终端里的 CLI、主流编辑器插件，以及可以用代码调用的 Python SDK。它适合已经习惯在编辑器或终端里工作、希望把重复性任务交给 agent 执行的开发者，也适合想把 agent 能力嵌进自己程序里的工程团队。本文按平台与入口逐项说明安装、登录与首次启动的步骤，最后用一个最小 Python 示例把整条链路跑通。如果你更想先了解这类工具的整体定位，可以先看站内的 Google Antigravity 条目，再回到本文动手。

需要先说明一点：Antigravity 的版本号、支持的编辑器版本下限、可用模型、配额与计费方式都在持续变化，本文出现的具体版本要求只反映某一时点的状态，实际安装前请以官网当前信息为准。

准备工作

在动手之前，先确认下面几件事，可以避免大部分「装完了却启动不了」的情况。

  • 账号：需要一个个人 Google 账号，或者 Gemini Enterprise / Google Cloud 的企业账号。企业账号在登录时要选择 Business account，并指定被分配的许可证与 Google Cloud 项目。
  • 操作系统版本：桌面应用在 macOS 上要求 macOS 13（Ventura）或更高，且支持 Apple Silicon 与 64 位 Intel；Windows 上要求 Windows 10（64 位）或 Windows 11；Linux 上要求 glibc >= 2.28、glibcxx >= 3.4.25，对应 Ubuntu 20+、Debian 10+、Fedora 36+、RHEL 8+ 这一档发行版。
  • 独立 IDE 的系统要求：如果打算装独立的 Antigravity IDE 而不是插件，macOS 下限放宽到 macOS 12（Monterey），Windows 为 Windows 10（64 位）及以上，Linux 与 Googlebook 同样是 glibc >= 2.28、glibcxx >= 3.4.25。
  • Python 环境：使用 SDK 需要 Python 3.10 或更高版本，并建议放在虚拟环境里。
  • 编辑器版本：各编辑器插件对宿主版本有下限要求，例如 VS Code 需要 1.90 或更高，JetBrains 系 IDE 需要 2026.2.1 或更高，Zed 需要 0.140.0 或更高，Visual Studio 需要 2026（17.8 或更高），Xcode 需要 27 beta 6 或更高，Eclipse 需要 2026-06 或更高。这些下限会随插件更新而变化，安装前请核对官网当前信息。

另外，Googlebook 设备上 Antigravity 是预装的，不需要单独下载安装包，通过 Google Play 更新或重装即可。

操作步骤

第一步：安装桌面应用

从官网下载页获取对应操作系统的安装包，然后按平台完成安装。

macOS：下载 Antigravity.dmg，打开磁盘映像，把 Antigravity 拖进 Applications 文件夹。如果机器上已有旧版本，系统提示时选择 Replace 而不是 Keep Both，否则会留下两份应用。

Windows：下载 .exe 安装程序，运行后按向导完成安装。x64 与 ARM64 分别有对应的安装包，按机器架构选择。

Linux：下载压缩包后解压并启动：

tar -xzf Antigravity.tar.gz
./Antigravity

第二步：首次登录与工作区角色选择

从应用启动器打开 Antigravity，通过浏览器完成登录。使用个人 Google 账号登录后，应用会询问你的工作类型，可选项包括 Software Engineering、Knowledge Work、Data & Analytics、Science、Design 和 Other；也可以直接点 Skip，以默认的 Software Engineering 配置开始。

这个选择会影响两件事：一是初始界面布局，Knowledge Work、Science、Design、Other 会采用偏知识工作的布局，Software Engineering 与 Data & Analytics 采用偏工程开发的布局；二是在确认 Terms & Data Use 提示后，Home 消息框上方会显示最多三条可关闭的起步提示。

需要注意，选择角色本身并不会安装任何插件。点击某条起步提示时，如果它关联的 Marketplace 插件尚未安装，应用会在后台装上，并把 @<Plugin> 与提示词预填进输入框但不发送，同时选中第一个 <...> 占位符方便你先修改。像 Google Calendar、Drive、Slides、Figma 这类需要连接的服务，会在你真正运行提示时才要求登录。

如果选择的是 Software Engineering，界面里还会出现「Bring over my setup from other Agentic Developer Tools」选项，用于从 Claude Code、Codex、Cursor、Gemini CLI 导入 MCP 服务器、skills、rules 和 instructions。布局之后随时可以在 Settings > General > Interface Layout 里切换。

使用 Gemini Enterprise 或 Google Cloud 账号时，登录环节选择 Business account，再选择被分配的许可证与 Google Cloud 项目。

第三步：安装并初始化 CLI

CLI 的可执行文件名为 agy，用对应平台的自动安装脚本安装。

macOS / Linux / Googlebook：

curl -fsSL https://antigravity.google/cli/install.sh | bash

默认安装位置是 ~/.local/bin/agy。

Windows PowerShell：

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD：

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows 上两种方式的默认安装位置都是 C:\Users\<username>\AppData\Local\agy\bin。

安装完成后打开终端验证：

agy --version

首次启动会进入交互式配置，需要依次完成三项选择：

  1. 配色方案：Dark、Solarized Dark、Solarized Light 或跟随终端默认。
  2. 渲染模式：Alt-Screen 模式使用全屏缓冲区，Inline 模式则把输出顺序写进终端历史，便于回滚查看。
  3. 工作区信任：确认你信任当前仓库目录，agent 才会开始建立文件索引。

认证方式与企业配置不在这个交互流程里，需要参考专门的认证与企业配置说明。

第四步：安装编辑器插件或独立 IDE

如果不想离开现有编辑器，可以安装官方插件；也可以直接下载独立的 Antigravity IDE。

VS Code：打开扩展侧边栏（macOS 为 Cmd + Shift + X，Windows/Linux 为 Ctrl + Shift + X），搜索 Google Antigravity 并点击安装。

JetBrains 系 IDE：打开 JetBrains AI > Settings > Agents，搜索 Antigravity 并安装。适用于 IntelliJ IDEA、PyCharm、WebStorm、GoLand、CLion、Rider 等基于 IntelliJ 平台的 IDE。

Visual Studio：进入 Extensions > Manage Extensions，搜索 Google Antigravity，点击 Download，然后重启 Visual Studio 完成 VSIX 安装。

Zed：打开命令面板（Cmd + Shift + P 或 Ctrl + Shift + P），运行 agent: open settings，进入 External Agents > Add > Install from Registry 安装 Antigravity。

Xcode：打开 Xcode > Settings（Cmd + ,），进入 Intelligence 面板，在 Antigravity 旁点击 Get。

Eclipse：进入 Help > Eclipse Marketplace…，搜索 Google Antigravity，点击 Install，按提示重启 Eclipse。该插件目前处于 Public Preview 阶段。

独立 Antigravity IDE：从下载页获取对应平台的安装包。macOS 与 Windows 上有新版本时会在后台下载并提示点击 Restart to Update（系统级 Windows 安装显示为 Install Update）；Linux 上标题栏会出现 Update Available 按钮，账号图标上出现角标。如果 IDE 是通过 apt 这类包管理器安装的，走系统更新流程升级；如果是用 tarball 安装的，需要自行下载新的 tarball。

第五步：在编辑器里打开 Agent 面板

插件装好后，agent 运行在编辑器右侧的 Agent 侧边面板中。常用操作如下：

  • Cmd + L（Windows/Linux 为 Ctrl + L）跳到面板；在编辑器里按这个组合键还会把选中行或当前行作为上下文加入提示词。
  • Cmd + Shift + L（Ctrl + Shift + L）开启新对话。
  • 点击标题栏的 Toggle Agent 可以显示或隐藏面板。

首次使用时，面板或设置里会提示登录，用个人 Google 账号或 Gemini Enterprise 凭据登录即可。企业账号支持情况在各编辑器上并不一致：VS Code 与 Visual Studio 已正式可用，JetBrains、Zed、Xcode、Eclipse 仍处于 Preview 阶段。

第六步：安装 Python SDK

在 Python 3.10+ 的虚拟环境中安装官方包：

pip install google-antigravity

如果使用 Poetry 或 uv 管理依赖：

# Poetry
poetry add google-antigravity

# uv
uv add google-antigravity

初始化 agent harness 之前，先把 API 凭据写进环境变量：

export GEMINI_API_KEY="your_api_key_here"

如果走 Gemini Enterprise 或 Vertex AI 认证，则改为配置项目信息，并完成应用默认凭据登录：

export GOOGLE_GENAI_USE_VERTEXAI=True
export GOOGLE_CLOUD_PROJECT="your-gcp-project"
export GOOGLE_CLOUD_LOCATION="us-central1"
gcloud auth application-default login

一个完整示例

下面这条路径从零开始，把 SDK 装好并完成一次最小初始化，适合用来验证环境是否配置正确。

1. 创建并激活虚拟环境

python3 -m venv .venv
source .venv/bin/activate

Windows 上激活命令为 .venv\Scripts\activate。

2. 安装 SDK

pip install google-antigravity

3. 配置凭据

export GEMINI_API_KEY="your_api_key_here"

如果使用 Vertex AI，则改用前面给出的 GOOGLE_GENAI_USE_VERTEXAI、GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_LOCATION 三个变量，并先执行 gcloud auth application-default login。

4. 验证 CLI 是否可用

agy --version

能打印出版本号，说明 CLI 已正确安装并进入 PATH。如果提示找不到命令，检查 ~/.local/bin（Windows 为 %LOCALAPPDATA%\agy\bin）是否在 PATH 中。

5. 在编辑器里做一次端到端验证

打开一个受版本控制的仓库，在 VS Code 中按 Cmd + L 或 Ctrl + L 唤出 Agent 面板，登录后输入一个只读类问题，例如让 agent 说明当前文件的作用。这一步同时验证了三件事：插件已加载、账号认证通过、agent 能读取工作区文件。确认无误后再让它执行写文件或运行命令的操作。

整个流程的关键在于顺序：先确认运行时（应用、CLI 或 SDK）能启动，再确认认证通过，最后才让 agent 接触真实仓库。任何一步失败，都先停在这一步排查，不要继续往下走。

注意事项

  • 升级时不要保留两份应用：macOS 上覆盖安装时选 Replace；选 Keep Both 会导致启动的是旧版本，行为与预期不符。
  • Linux 的升级方式取决于安装来源：包管理器安装的走系统更新，tarball 安装的需要手动下载新包，两者不能混用。
  • 角色选择不等于装插件：选择工作类型只改变界面布局和起步提示，插件是在点击具体提示时才按需安装的。
  • 连接类服务在运行时才要求登录：Calendar、Drive、Slides、Figma 等服务的授权发生在执行提示词时，而不是安装插件时，提前准备好对应账号可以少一次中断。
  • 工作区信任是硬门槛：CLI 首次启动必须确认信任仓库目录，否则 agent 不会开始文件索引。
  • 企业账号支持程度因编辑器而异：VS Code 与 Visual Studio 已正式可用，其余编辑器仍为 Preview，生产环境使用前请评估。
  • 版本下限会变：本文列出的编辑器版本、操作系统版本、Python 版本要求都可能随发布更新，安装前请以官网当前信息为准；价格、配额与可用模型同样以官网为准。
  • 凭据不要写进代码：API key 与项目配置通过环境变量注入，避免提交到仓库。
Back