乐于分享
好东西不私藏

谷歌Antigravity安装指南,绕开不必要的坑

谷歌Antigravity安装指南,绕开不必要的坑

在国内电脑上成功安装 Google Antigravity,最大的挑战通常不在于安装过程本身,而在于成功登录和保持稳定连接。根据尝试的情况,整理了详细的安装步骤与避坑指南。

核心要点可以概括为:“账号是根本,网络是关键”。只要准备好一个“符合资格”的谷歌账号,并配置好支持“TUN模式”的网络环境,后续的安装和使用就会顺利很多。

第一步:准备工作(最关键!)

这是决定成败的一步,请务必在下载安装包前完成以下检查。

1. 检查你的谷歌账号

Antigravity 对账号的归属地有严格的限制。如果账号地区不支持,即使网络再好也无法登录。

  • 查询当前地区:访问 Google 服务条款页面 。页面底部或条款第三行会显示你账号当前的国家/地区 。如果显示为“中国”或“香港”,则需要修改。

  • 修改账号地区(如需要)

    • 访问 Google 地区关联表单 提交修改申请 。

    • 避坑1:请选择一个明确支持 Antigravity 的国家(如美国、日本、新加坡等),我选择的是日本,如果当时选择的地区是国内,可以申请变更,申请理由可以参考“因工作需要使用特定服务” 。

    • 避坑2:账号地区每年只能修改一次,操作前请务必确认 。修改申请提交后,可能需要一些时间生效,请耐心等待官方邮件通知 。

    • 避坑3:尽量用老号,当时注册的新号没法登录成功。我用一个2个月的号申请更换到日本后登录成功。

2. 检查你的电脑配置

确保你的电脑满足最低要求,以避免运行时出现莫名其妙的问题。

  • 操作系统

    • Windows: Windows 10 (64位) 及以上 。

    • macOS: macOS 12 (Monterey) 及以上,仅支持 Apple Silicon (M1/M2/M3芯片) 。

    • Linux: 要求 glibc ≥ 2.28glibcxx ≥ 3.4.25 (如 Ubuntu 20+、Debian 10+) 。

  • 硬件

    • 内存:至少 8GB,推荐 16GB 。

    • 磁盘:至少 2GB 可用空间 。

3. 配置网络环境

这是国内用户遇到问题最多的环节。Antigravity 的流量无法被普通的浏览器代理插件捕获,需要系统级的代理。

  • 代理工具:确保你使用的代理工具支持 TUN 模式(或称为“虚拟网卡模式”、“增强模式”),我用的这个就是虚拟网卡模式

  • 开启 TUN 模式:在启动 Antigravity 之前,请以管理员身份运行你的代理工具,并开启 TUN 模式,同时建议将代理模式设置为“全局” 。

    • 避坑4:不要只依赖系统代理或浏览器扩展,必须开启 TUN 模式,以确保包括 Antigravity 在内的所有应用流量都通过代理 。

    • 避坑5:如果开启了 TUN 模式后,登录时仍然无法跳转或卡住,可以尝试在代理工具中开启 “服务模式 (Service Mode)”,这能更好地接管系统DNS和路由 。

  • 验证网络:打开命令行(CMD),输入命令 curl ip-api.com,检查返回结果中的 country 字段。如果显示的是你代理的国家(如 US),则代表网络配置正确 。

第二步:下载与安装

  1. 获取安装包:访问 Antigravity 官方下载页面 https://antigravity.google/download 。根据你的系统下载对应的版本(Windows 下载 .exe,macOS 下载 .dmg)。

    • 避坑6:请务必从官方渠道下载,不要使用第三方下载站的安装包,以确保安全 。

  2. 运行安装程序

    • Windows:双击下载的 .exe 文件,按照提示进行安装。建议:如果遇到登录循环的问题,可以尝试将软件安装到 C:\Program Files\Antigravity 这个默认路径下 。

    • macOS/Linux:像安装其他软件一样,将应用拖入应用程序文件夹或使用包管理器安装。

第三步:登录与初始化

  1. 启动软件:安装完成后,启动 Antigravity。

  2. 登录账号:点击左下角的 "Sign In",软件会调起浏览器进入 Google 登录页面 。使用你准备好的谷歌账号登录并完成授权。

    • 避坑6:如果浏览器能打开但登录后客户端没反应,或一直卡在“Setting up your account”,大概率是网络问题。请返回第一步,重新检查你的 TUN 模式是否正常开启,并尝试更换代理节点 。

  3. 迁移配置(可选):如果你之前使用 VS Code,首次启动时 Antigravity 可能会询问是否导入配置。点击 "Yes",它可以自动同步你的主题、快捷键和插件,让你立刻获得熟悉的操作体验 。

第四步:常见“坑”与故障排查

即使成功登录,使用过程中也可能遇到问题。这里整理了一些高频问题的快速解决方案:

问题现象
可能原因
快速解决方案
Agent卡在"Thinking" 状态
网络不稳定或模型服务过载 。
1. 检查代理连接速度和稳定性。
2. 在模型选择器(通常在界面右下角)中,将模型从“Gemini 3 Pro High”切换到“Standard”或“Low”,以降低负载 。
提示 "Model loading failed"
模型加载失败,常因网络、版本或权限问题 。
1. 网络检查:尝试切换网络(如用手机热点)或DNS (如 1.1.1.1),排除网络问题 。
2. 版本对齐:确保 Antigravity 主程序和所有插件都是最新版本 。
3. 权限(macOS):在系统设置中,授予 Antigravity“完全磁盘访问权限” 。
Windows 上点击登录无反应或一直转圈
DNS 或路由未被正确接管。
在代理工具中开启 “服务模式”,或者尝试用管理员身份重启代理工具 。
Agent 无法操作终端或浏览器
权限未开启或配置错误。
1. 检查项目根目录下的 .antigravity 文件,确保 agent_permissions 中的 terminal 和 browser 为 true 。
2. 对于浏览器,需要使用 Antigravity 启动的专用 Chrome 实例,并确保已安装“Antigravity Browser Control”扩展 。