版本、账号与地区限制
本文按 2026-04-29 的官方入口和教程截图整理。Google Antigravity、Gemini 模型入口和 Agent 面板名称可能会随产品更新变化，实际界面以你当前账号看到的版本为准。
按 Google 官方帮助说明，Antigravity 目前面向 18 岁以上的 Google AI Pro 和 Google AI Ultra 用户；提示和指令支持英文，桌面端覆盖 Windows、macOS 和 Linux，但容量不保证。
能否使用 Antigravity 还会受到账号、Google AI Pro / Ultra 订阅、地区、组织策略和产品开放状态影响。即使安装成功，不符合账号或地区条件时也可能看不到 Gemini / Agent 功能。
如果你所在地区暂不支持 Google AI Pro、Gemini Advanced 或相关 AI 功能，优先查看 Google 官方可用地区说明，不要使用镜像站、破解包或来源不明的安装包。
什么是 Google Antigravity？它能做什么？
你可以把 Antigravity 理解成一个面向 AI Agent 的开发环境：它不是普通聊天窗口，而是把 Gemini 的推理能力、项目上下文、文件操作、计划执行和结果验证放在同一个工作流里。
一句话理解
Google Antigravity 是 Google 推出的 Agent-first 开发工具，目标是让 Gemini Agent 帮你理解项目、规划任务、修改文件、生成结果说明，并把过程尽量变成可审查、可回滚、可验证的开发流程。
它主要能做什么
- 阅读项目目录和关键文件
- 解释代码、需求和错误信息
- 先生成执行计划再修改代码
- 创建或调整页面、组件和配置
- 生成 Artifacts、diff 摘要和验证步骤
- 辅助写产品计划、技术方案和测试清单
这篇教程适合谁
准备工作
How To
操作步骤
按顺序完成下面 5 个步骤，先确认入口和账号，再进行第一次安全可控的操作。
Step 01
从官方入口安装 Antigravity
先打开 antigravity.google，下载适合你系统的 Antigravity。不要从陌生镜像站、搜索广告或第三方下载站安装，尤其是需要输入 Google 账号的开发工具。
- 确认地址是 antigravity.google
- 选择 Windows、macOS 或 Linux 安装包
- 安装前阅读系统权限提示
- 安装完成后启动 Antigravity
Step 02
登录 Google 账号
启动后按提示登录 Google 账号。个人学习可以使用自己的账号；团队项目要先确认组织策略，避免把未授权的代码、资料或客户数据接入 AI Agent。
- 使用自己的 Google 账号登录
- 阅读登录和隐私提示
- 企业项目先确认管理员策略
- 登录后回到 Antigravity 主界面
Step 03
确认使用 Gemini 模型能力
Antigravity 的核心体验是让 Agent 使用 Gemini 的推理、工具调用和代码能力来完成任务。进入 Agent 面板后，先确认当前模型或默认 AI 能力已可用，再开始提问。
- 打开 Agent 或聊天面板
- 确认 Gemini 能力可用
- 优先从 Ask 或 Plan 开始
- 不要第一步就授权大范围执行
Step 04
打开一个 demo 项目
第一次使用建议先创建一个空 demo 项目，而不是直接打开生产仓库。打开后先告诉 Agent 这是新建项目，让它规划最小文件结构、页面模块和实现步骤，再决定是否执行。
- 创建一个空 demo 文件夹
- 用 Antigravity 打开该文件夹
- 说明这是刚创建的新项目
- 先让 Agent 输出计划，不要立刻生成大量代码
第一次提问模板
这是一个刚创建的空 demo 项目。我想做一个 AI 教程页面，请先帮我规划最小文件结构、页面模块和实现步骤，不要立刻修改代码。
请基于上面的计划，先列出你准备创建或修改的文件，以及每个文件的用途。
如果要开始执行，请先从最小可运行页面开始，并告诉我完成后应该如何在浏览器里验证。
Step 05
先审查计划，再允许执行
Antigravity 的价值不只是生成代码，而是让 Agent 规划、执行并产出可验证结果。你要重点看计划、影响文件、Artifacts、diff 和验证方式，再决定是否继续。
- 先看计划和影响文件
- 检查 Artifacts 或执行说明
- 审查 diff 是否超范围
- 运行测试或手动验证结果
完成后你应该看到什么
如果下面几项都能完成，说明 Google Antigravity 接入 Gemini 的第一轮使用流程已经跑通，可以再逐步迁移到真实项目。
- Antigravity 能正常打开目标工作区。
- Google 账号已经登录，并能回到 Antigravity 主界面。
- Agent 或聊天面板可以提问，Gemini 能力处于可用状态。
- Agent 能先输出计划、影响文件和验证方式，而不是直接大范围修改。
- 执行后能看到 diff、Artifacts 或结果说明，并能手动验证。
安全边界
Antigravity 适合让 Agent 处理“可以审查、可以回滚、可以验证”的任务。涉及密钥、支付、用户隐私、生产数据库和权限策略时，先做脱敏和人工审批。
如果你的应用需要调用 Gemini API，单独去 Google AI Studio 配置 API Key，并放在服务端环境变量里；不要把 Key 写进前端代码、截图、公开仓库或聊天记录。
下一步可以看什么
常见问题与排错
Antigravity 和 Gemini 是什么关系？
Antigravity 是 Google 面向 Agent 工作流的开发环境，核心体验是让 Agent 使用 Gemini 的推理、代码和工具调用能力来规划、执行和验证任务。
Google Antigravity 需要 Gemini API Key 吗？
在 Antigravity 内使用 Agent 通常先按产品登录流程走；只有你的应用代码要直接调用 Gemini API 时，才需要单独创建和配置 API Key。
登录后看不到 Gemini 或 Agent 面板怎么办？
先确认登录账号、产品入口和版本是否正确，再检查账号地区、组织权限或产品开放状态。企业账号还要确认管理员是否允许使用相关 AI 功能。
Google Antigravity 支持哪些国家和地区？
以 Google 官方 Google One / Google AI Pro 可用地区说明为准。Antigravity 受账号年龄、Google AI Pro / Ultra 订阅、地区、组织策略和容量影响；如果入口不可用或登录后看不到 Agent，先检查官方可用地区列表。
所在地区不支持 Google Antigravity 怎么办？
优先以 Google 官方可用地区和账号资格说明为准。如果你的账号或地区暂不支持，不建议使用镜像站、破解包或来源不明的安装包，可以先使用 VS Code 中的 Gemini Code Assist 或其他已在本地区开放的 AI 编程工具。
第一次使用要直接打开生产项目吗？
不建议。更稳妥的方式是先打开 demo 项目，让 Agent 熟悉目录、入口文件和验证方式，再逐步迁移到真实项目。
Antigravity 和 Gemini Code Assist 有什么区别？
Gemini Code Assist 更偏向在 VS Code 等编辑器中提供补全、问答和代码辅助；Antigravity 更强调 Agent 规划、执行、生成 Artifacts 和验证结果的工作流。
可以把公司代码直接交给 Agent 吗？
不建议直接授权大范围操作。先确认公司策略、代码权限和数据边界，必要时用脱敏 demo、最小目录或只读提问开始。
相关教程
如何使用 Antigravity 做 PPT（Slidev 演示文稿）
从准备大纲、让 Antigravity Agent 生成 Slidev 演示文稿、实时预览，到迭代优化排版动画和导出 PDF 的完整流程。
如何在 VS Code 中接入谷歌 AI
用 Gemini Code Assist 扩展把 Google AI 接入 VS Code，并说明什么时候需要再配置 Gemini API Key。
如何打开 Google Antigravity 并用它写产品计划
从官方入口打开 Google Antigravity、登录账号，到第一次用 Agent 写一份可评审的产品计划。
VS Code 接入 Codex 教程
从安装 Codex 扩展、登录 OpenAI 或 ChatGPT 账号、打开 demo 项目，到第一次让 Codex Agent 规划、执行和验证任务。