
Antigravity Mac 安装教程:架构选择与登录排查
Mac 装 Antigravity 一共 5 步,10 分钟左右:确认 macOS 版本够 12、按芯片选对 dmg、拖进 Applications、登录授权、跑通第一条 Agent 任务。真正会卡住人的不是安装,是第三步登录:浏览器显示授权成功、App 却停在等待状态,这在中文教程里几乎没人讲清排查顺序。
下面这份按 Mac 的实际操作路径写,和 Windows 那份的区别先说在前面:Mac 没有 WSL2、没有 Hyper-V 那一堆前置,但多了芯片架构这道坑,也多了「App 走不走系统代理」这个变量。

先确认你的 Mac 能不能装
官方下载页给 macOS 的最低要求写得很明确:macOS 12 (Monterey) 或更新版本,Apple Silicon 或 Intel 都可以(antigravity.google/download)。
对照检查两项就够:
- 点左上角苹果菜单,选「关于本机」,第一行「芯片」显示 Apple M 开头的是 Apple Silicon,显示 Intel Core 的是 Intel 机型。
- 同一窗口里看「macOS」后面的版本号,低于 12 就得先升级系统。
芯片这一行决定了你要下哪个包,也是 Mac 用户最常见的第一个错误:下了 Intel 版装到 M 系列机器上,能装但跑起来要么 Rosetta 转译变慢,要么直接报错。
| 芯片类型 | 下载哪个包 | 官方文件名 |
|---|---|---|
| Apple Silicon(M1/M2/M3/M4 及后续) | Download for Apple Silicon | Antigravity.dmg(darwin-arm 目录) |
| Intel(Core i5/i7/i9) | Download for Intel | Antigravity.dmg(darwin-x64 目录) |
两个按钮在页面上都叫 Antigravity.dmg,文件名一模一样,只能靠按钮文字区分下载的是哪个架构,别凭文件名判断。截至本文更新时,官方页面标注的 App 版本是 v2.28.2,版本号会滚动,下面这套流程不受版本号影响。
如果你的机器是黑苹果或者 x86 上跑的特殊环境,官方没有为这类场景做支持声明,本文不涉及。
下载和安装:dmg 拖进去就算装完
- 打开 antigravity.google/download,页面顶部切到 macOS 标签。
- 按上表点对应的 Download 按钮,等 dmg 下载完。安装包体积不小,建议留出足够磁盘空间。
- 双击 dmg 挂载,把 Antigravity 图标拖到旁边「应用程序」文件夹的快捷方式上。
- 从启动台或应用程序文件夹打开 Antigravity,第一次打开 macOS 会弹「从互联网下载的 App」确认框,点「打开」。
- 等待首屏加载,出现登录界面就算安装这一步结束了。
Mac 上没有安装向导,也不让你选安装路径,拖进去就等于装完。卸载同理,直接拖到废纸篓。

整套判断只有两个分叉点:装的时候选错架构、登录时候代理没覆盖。把下面的顺序记住,就不用反复翻教程。

登录这一步:卡住的全在这
打开 App 后点登录,会跳浏览器做 Google 账号授权。授权页显示成功后,正常情况下浏览器应该把控制权交回 App,App 继续走进度条。卡住的表现通常是三种:
- 浏览器显示账号已选好,App 界面毫无反应。
- App 转圈不停,进不去编辑界面。
- 弹出一句账号设置异常(英文多为
There was an unexpected issue setting up your account)。
这三种的共同根因是 App 自己的网络请求没走通,而浏览器能走通,所以你看到「浏览器成功了但 App 没成功」。排查顺序按下面三步走,成功率最高。
第一步:给终端环境补代理变量
社区里被验证最多的做法是先把 HTTP_PROXY 和 HTTPS_PROXY 两个环境变量配上,让 App 拉起的后台进程也走代理(做法见 CSDN 那份图文安装教程)。
先在你的代理软件里找到本地 HTTP 端口,常见的是 7890、1080、10809 这几个。这条做法能生效的前提是客户端确实提供 HTTP 代理端口,只有纯 SOCKS 端口的话得先换成对应的本地 HTTP 监听地址,否则设了也没用。开终端执行,把端口换成你实际的:
launchctl setenv HTTP_PROXY http://127.0.0.1:7890
launchctl setenv HTTPS_PROXY http://127.0.0.1:7890
设完完全退出 Antigravity(Command + Q,不是点红叉关窗口),再重新打开试登录。
launchctl setenv 设的变量在重启后失效,属于临时手段;想长期生效,可以写进 shell 配置文件,再补一个 LaunchAgent 让 GUI 应用能读到。这一步对命令行工具一定生效,对 GUI 应用不保证。
第二步:开 TUN 模式(增强模式)
如果第一步无效,打开代理软件的 TUN 模式(有的客户端叫「增强模式」或「虚拟网卡」)。它和普通系统代理的区别是接管整机流量,不管某个进程认不认系统代理设置。
开启 TUN 后需要授予网络扩展权限,macOS 会让你去「系统设置 → 隐私与安全性」确认。授权完重启 Antigravity 再登录。
这一步是中文社区里出现频率最高的解法,基本能覆盖「浏览器成功、App 没反应」的大多数情况。
第三步:把 Antigravity 相关进程单独加进转发规则
还有一类情况是 TUN 也开了、App 还是不联网。这时可以借助进程级的流量转发工具,把 Antigravity 的联网进程单独指向代理端口。同类工具里被中文教程提到较多的是开源的 ProxyBridge(GitHub releases),思路是在工具里添加 Antigravity 主进程和它拉起的后台进程,协议选 TCP + UDP,再保存规则。
这里要说明:中文教程里给出的进程名单是从 Windows 环境抄出来的,Mac 上进程名的实际形态我没有在公开来源里找到可靠记录,具体进程名官方没公布,也不建议照抄。Mac 用户的处理顺序应该是:先做完第一步和第二步,只有前两步都无效才需要研究进程级转发。
怎么确认真的装好了
装好的判断标准不是「App 能打开」,而是能跑完一个 Agent 任务。用一个空项目做最小验证:
- 新建一个空文件夹,在 App 里选「打开文件夹」指向它。
- 在对话框里让它创建一个
index.html,随便写点内容。 - 观察它是否生成文件、是否弹出 diff 让你确认。
- 打开文件确认内容落地。
如果文件生成了、diff 面板能正常渲染,说明安装、登录、模型调用三段链路都通了。这一步跑不通但界面正常,问题通常在账号权限或额度,不在安装。
顺手把 CLI 装上(可选)
Mac 用户还有一个官方 CLI 可选,比 IDE 轻,适合在已有项目里直接用。官方下载页给出的 macOS 命令是:
curl -fsSL https://antigravity.google/cli/install.sh | bash
Linux 和 Googlebook 用的是同一条命令,Windows 是 PowerShell 的 irm ... | iex。装完在项目目录里直接调起就行。CLI 和 IDE 共用同一个 Google 账号登录态。
如果只是想试一下 Antigravity 是什么,或者不确定自己 Mac 能不能跑,建议先看Antigravity 是什么把定位搞清楚,再决定装 IDE 还是只装 CLI。
常见报错速查
| 现象 | 原因 | 处理顺序 |
|---|---|---|
| 打开提示 App 不支持或卡在启动图标 | 下错 dmg 架构 | 回官网按「关于本机」的芯片行重下 |
| 安装时提示需要 macOS 12 或更高 | 系统版本不够 | 升级到 Monterey 或更新,官方没给旧系统替代方案 |
| 浏览器授权成功、App 没反应 | App 进程没走代理 | 环境变量 → TUN 模式 → 进程级转发,按序排查 |
| 提示账号设置异常 | 网络没覆盖到授权回调域名 | 同上一行,优先开 TUN 模式 |
| 一直在 Loading,消息无响应 | 同上,另有可能是账号地区问题 | 代理排查完再确认账号归属地区 |
| 装完能开但 Agent 不产出结果 | 账号权限或额度问题,非安装问题 | 登录后用 /status 类功能查额度,看官方文档说明 |
表格里最后两行是我特意分开写的:很多教程把「界面卡 Loading」和「Agent 不干活」混成一件事,其实是两套系统,前者是网络,后者是账号与额度。
Mac 和 Windows 的差别到底在哪
把两份教程放一起对比,你在 Mac 上真正需要额外注意的只有四条:
- 架构要选对。Windows 那边有 x64 和 ARM64 两个 exe,Mac 这边是 Apple Silicon 和 Intel 两个 dmg,逻辑一样但文件扩展名不同,很多人以为 Mac 只有一种包。
- 没有 WSL2/Hyper-V 前置。Windows 教程里反复强调的虚拟化开关在 Mac 上不存在,省掉了一半折腾。
- 代理必须覆盖 GUI 进程。Mac 的系统代理设置对部分 Electron 类应用的子进程不一定生效,TUN 模式是更稳的路。
- 卸载方式不同。Mac 拖到废纸篓即可,不用找卸载入口。
顺序反过来也一样:Windows 用户不需要在 Mac 教程里找答案,两套环境的前置条件不通用。
装完之后的下一步
装好只是起点,接下来通常会撞到两个问题:账号登录和模型配额。
国内网络环境下能不能稳定用,可以对照Antigravity 国内可用性实测看当前状态。
如果已经在用,遇到 429 报错就看Antigravity 429 限流排查。想改用 API Key 方式接入,参考Antigravity API Key 配置
Windows 机器的朋友直接看 Windows 11 安装教程。
常见问题
Antigravity Mac 版支持 Intel 芯片吗?
支持。官方下载页 macOS 一栏给了两个按钮,Intel 机型点 Download for Intel(darwin-x64 目录的 dmg),最低系统要求同样是 macOS 12 或更新版本。Apple Silicon 机型点 Download for Apple Silicon。
Antigravity 在 Mac 上安装需要先装 VS Code 吗?
不需要。Antigravity 是独立应用,官方下载页把它和 Antigravity IDE 分开列,装完直接能用。它的操作习惯和 VS Code 接近,但不依赖 VS Code 必须先装。
Antigravity Mac 安装后登录一直卡在加载界面怎么办?
按环境变量补代理、开 TUN 模式、进程级转发三步依次试。核心判断是浏览器授权能成功但 App 不动,说明是 App 进程没走代理,不是账号问题。具体命令见文中「登录这一步」小节。
Mac 上 Antigravity 能装在移动硬盘或者别的目录吗?
dmg 安装方式是拖进「应用程序」文件夹,官方只给了这一种安装路径,没有自定义安装目录的选项。放在其他位置可能触发 macOS 的权限或签名校验问题,官方文档没有对此做支持说明,建议按默认路径装。
Antigravity Mac 版要不要单独装 CLI?
看使用场景。只想在现有项目里用 Agent、不想开 IDE,装 CLI 更轻,官方给的是 `curl -fsSL https://antigravity.google/cli/install.sh | bash`。想要完整可视化界面、diff 面板和产物管理,装桌面版 App。两个共用同一套账号。
Antigravity Mac 安装报错提示 App 已损坏或无法验证怎么办?
先确认是从官方 antigravity.google/download 下载的,第三方镜像站的分发包可能被改动。确认是官方包还报这个错,去「系统设置 → 隐私与安全性」,看页面下方是否有被拦下的应用,点「仍要打开」。官方没公布针对这个报错的专项说明,以上是 macOS 通用处理方式。

京ICP备2024094994号-29