修复：无法登录 Antigravity / 认证循环

您点击“登录”，在浏览器中成功认证，看到“您已成功认证”页面 — 却没有任何反应。IDE 仍然停留在登录界面。这种认证循环是 Antigravity 最常报告的 bug 之一，仅在 Google AI 开发者论坛上就有 1

Identify Your Login Issue

There are four distinct login problems, each with a different fix. Identify yours:

• Authentication Loop: Browser says "Successfully Authenticated" but the IDE never receives the redirect. You're stuck in a sign-in cycle. → Jump to fix
• "Authentication Required" while signed in: You were already working, and the agent panel suddenly shows "Authentication Required" with no login button. → Jump to fix
• "Account not eligible": You can sign in, but get told your account isn't eligible for Antigravity. → Jump to fix
• Account banned / suspended: You can't sign in at all and see "There was an unexpected issue" or your account is "on hold." → Jump to fix

Quick Fix (90 Seconds)

Before trying anything else, this resolves the majority of login issues:

1. Fully quit Antigravity — Cmd+Q (Mac) 或 文件 → 退出 (Windows)。不要仅仅关闭窗口。
2. 切换您的默认浏览器 — 如果您正在使用 Chrome，请切换到 Edge 或 Firefox（反之亦然）。这可以解决约 70% 由浏览器缓存、Cookie 或会话冲突引起的认证循环问题。
3. 重新打开 Antigravity 并再次登录。

如果这不起作用，请继续查看下方针对您问题的具体修复方案。

修复认证循环问题

症状： 浏览器显示“您已成功认证。您应该被重定向回产品”，但桌面应用停留在登录界面。

这是最常见的变体，已在 Google AI 论坛上得到 5 位以上用户的确认。从浏览器重定向回桌面应用的 OAuth 过程静默失败。

修复方案 1：安装到 C: 盘并将 Chrome 设为默认浏览器 (Windows)

这种特定组合可以解决 Windows 上约 70% 的登录循环问题：

1. 完全卸载 Antigravity。
2. 在 Windows 设置中将 Chrome 设为您的默认浏览器。
3. 重新安装 Antigravity，并指定安装到 C:\Program Files\Google Antigravity （而非自定义路径）。
4. 再次登录。

修复方案 2：设置代理变量 (macOS / 企业网络)

如果您位于企业防火墙或 VPN 之后，OAuth 重定向可能会被阻止。请从终端使用代理变量启动 Antigravity：

这在 Google AI 论坛上被确认为一个有效的修复方案，适用于位于企业防火墙后的用户。

修复方案 3：清除所有认证数据

1. 退出浏览器中所有 Google 账户。
2. 清除以下网站的 Cookie： accounts.google.com 和 antigravity.google。
3. 在以下网址撤销 Antigravity 对您 Google 账户的访问权限： myaccount.google.com/connections。
4. 重启 Antigravity 并使用单个 Google 账户重新登录。

修复方案 4：暂时禁用 VPN

禁用您的 VPN，登录后再重新启用。某些 VPN 会阻止 Antigravity 用于 OAuth 回调的特定 WebSocket 协议。一旦认证成功，VPN 通常不会干扰正在进行的会话。

修复已登录时出现“需要认证”的问题

症状： 您正在积极编码时，代理面板突然显示“需要认证：请登录” — 即使您已经登录。有时甚至没有登录按钮。

解决方案

1. 前往 文件 → 首选项 → Antigravity 设置 → 账户。
2. 点击 退出登录。
3. 完全关闭 Antigravity（Cmd+Q 或 文件 → 退出）。
4. 重新打开并再次登录。

如果缺少退出登录选项，请从任务管理器 (Windows) 或活动监视器 (Mac) 强制关闭 Antigravity，删除认证缓存，然后重新安装：

解决“账户不符合条件”

症状： “您当前的账户不符合 Antigravity 的使用条件。请尝试使用另一个个人 Google 账户登录。”

这通常由以下三种情况之一引起：

• 使用 Google Workspace 账户 而非个人 @gmail.com 账户。Antigravity 需要个人账户。
• 区域限制 — 您的 Google 账户所属国家/地区不在支持列表中。
• 需要年龄验证 — Google 可能会在授予访问权限前，要求进行基于身份的年龄验证。

针对此错误，我们提供了一份完整且专门的指南： 修复：账户不符合 Antigravity 使用条件。

账户被封禁/暂停

症状： 登录时出现“出现了一个意外问题”，或者您的账户处于“暂停”状态且没有其他选项。

以下开发者报告了账户封禁的情况：

• 使用了 OpenClaw 或类似的第三方 OAuth 工具 — Google 的自动化系统会将这些标记为服务条款 (ToS) 违规。即使通过 OpenClaw 使用 Gemini OAuth 也可能触发封禁。
• 从多个设备登录 — 一位开发者报告称，因连续（非同时）使用 3 台 PC 而被封禁，这表明 Google 的机器人错误地将正常的跨设备使用标记为异常。
• 使用了第三方配额扩展 这些扩展使用 Google OAuth 进行身份验证 — 其中一些扩展已被标记为安全风险。

应对措施

1. 撤销所有第三方访问权限 立即前往 myaccount.google.com/connections。移除任何与 Antigravity、OpenClaw 或配额监控器相关的内容。
2. 联系 Google 支持 通过 AI Pro/Ultra 订阅支持渠道。提及您的订阅并解释情况。
3. 等待 24-72 小时 — 一些封禁是暂时的，一旦被标记的活动停止，便会自动解除。

Linux 特有的登录问题

由于 OAuth 回调的处理方式，Linux 用户面临额外的认证问题：

• 密钥环问题： 如果您正在使用无头或最小桌面环境，系统密钥环可能不可用。请安装 gnome-keyring 或 libsecret 以存储 OAuth 令牌。
• Agent 面板卡住，没有登录按钮： 在 Ubuntu 20.04 上报告 — 出现“Authentication Required”消息，但无法触发登录流程。通过清除会话存储并重启来解决：

如果您还看到“此版本不再受支持”，请参阅我们的 版本更新修复指南 — 登录错误可能是由于版本过旧引起的。

预防未来的登录问题

• 使用单个个人 @gmail.com 账户 — 不要切换账户或使用 Workspace 账户。
• 避免使用第三方 OAuth 扩展 — 尤其是配额监控器和 OpenClaw 等使用您的 Google 凭据进行认证的工具。这些是导致账户被封禁的首要原因。
• 不要同时使用 Gemini Code Assist 和 Antigravity — 这两项服务在同一个 Google 账户上会发生冲突。请在 Antigravity 内部禁用 Gemini 扩展。
• 保持 Antigravity 更新 —— 旧版本可能存在已修复的认证错误。请参阅我们的 更新指南。
• 收藏 myaccount.google.com/connections —— 如果您被锁定，撤销并重新授予 Antigravity 访问权限是最快的恢复方法。