Antigravity 无法登录：卡在 "Awaiting Authentication"、登录不跳转与 "unexpected issue" 的修复方法

2026年10月30日更新。已对照 Antigravity FAQ、更新日志、Google AI Developers Forum 工作人员回复以及 Gemini CLI issue 重新核实。

Antigravity 登录失败有好几种不同的表现，修复方法取决于你看到的是哪条提示。如果提示说你的账号 "ineligible" 或 "not eligible"（包括 "Further action is required" 和 "Eligibility check failed" 界面），那是账号层面的判定，而不是登录故障：请看账号不符合条件 / 无权使用指南。其余情况见下文。

对照你看到的报错

快速修复（先做这个）

桌面应用上的大多数登录问题可以按以下顺序处理。这些步骤都不保证有效，如果没有帮助，请转到你那条具体报错对应的部分。

1. 更新到最新版 Antigravity（Help，然后 Check for Updates，或从 antigravity.google/download 重新安装）。Google 工作人员回复过多个登录问题时都是请用户先更新，而且更新日志显示版本发布很频繁（核查时最新条目为 2026年10月22日的 App v2.26.0）。
2. 完全退出 Antigravity（Mac 上按 Cmd+Q，Windows 上选 File 再选 Exit）后重新启动。仅关闭窗口是不够的。
3. 在默认浏览器中退出其他所有 Google 账号，只保留你要用的那个账号处于登录状态。
4. 再次点击 Sign in，并在弹出的浏览器中完成流程。

"Antigravity awaiting authentication"（卡住、不跳转）

含义：点击 Continue with Google 之后，应用会显示这个状态，等待浏览器登录把结果交回来。如果一直没有动静，要么没有打开浏览器，要么浏览器已完成登录但结果没有传到应用。这也就是常见的“登录没反应”“一直卡在完成身份认证”。

论坛上报告的原因：旧版本存在登录缺陷（在一个关于 macOS 上 2.8.1 版本的帖子里，Google 工作人员回复说最新版本可以正常打开浏览器并完成登录，并请用户更新）；更新后 onboarding 或缓存状态损坏；默认浏览器未设置或不是常见浏览器；安全软件或代理拦截了本地回调。另一个 Windows 帖子报告了同样的卡死，该用户通过运行 Antigravity: Reset Onboarding 并重命名缓存文件夹摆脱了卡死（见第 4 步）。

修复步骤：

1. 更新到最新版本，完全退出并重新启动（见快速修复）。
2. 确保系统默认浏览器是常见浏览器（Chrome、Edge、Firefox 或 Safari）。macOS 用户报告界面一直转圈、没有浏览器标签页打开，其中一位的默认浏览器就是 Firefox（帖子 144283），所以请用主流浏览器作为默认浏览器测试。
3. 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），运行 Antigravity: Reset Onboarding，然后再次尝试 Continue with Google。
4. 如果仍然卡住，退出应用，重命名（不要删除）Antigravity 的数据文件夹，让应用重新创建。一位 Windows 用户报告这样清除了卡死：%APPDATA%\Antigravity、%USERPROFILE%\.gemini\antigravity、%USERPROFILE%\.gemini\antigravity-ide 和 %USERPROFILE%\.gemini\antigravity-browser-profile。Google 没有公布官方文件夹列表，而且该用户随后遇到了 "unexpected issue"（见下一节），因此请把它当作用户报告的应对办法。
5. 登录期间暂时关闭 VPN、代理或会检查 HTTPS 的安全工具，登录成功后再打开。在公司网络中，请看代理与防火墙指南（英文）。
6. 改用 CLI 试试：在终端运行 agy。它会打印一个登录链接，你可以在任意浏览器中打开，然后输入验证码，这样可以完全绕开桌面应用的跳转。见CLI 登录步骤。

来源：论坛帖子 178878（含工作人员回复）、172137 和 144283。

浏览器显示 "You Have Successfully Authenticated"，应用仍未登录

含义：Google 接受了登录，但跳转到应用本地回调的步骤没有完成。一位 macOS 用户看到 localhost 页面显示 "Bad Request: Missing code or state parameters"，日志中出现 "state syncing error"，也就是应用无法把回调与自己发起的登录请求对应起来。

修复步骤：

1. 在浏览器中退出所有 Google 账号，清除 accounts.google.com 的 Cookie，只用一个账号再试一次。
2. 在 myaccount.google.com/connections 撤销 Antigravity，然后重新登录。
3. 只在弹出的第一个浏览器标签页中完成一次登录。第一个标签页还开着时再发起第二次登录，会导致回调状态不匹配。
4. 在公司代理之后，请设置好代理变量再启动应用（下面是 macOS 示例），让 OAuth 请求能够离开你的网络。
5. 如果你把安装放到了自定义磁盘或路径，导致应用没有被注册为处理程序，请重新安装到默认位置。这是用户报告的应对办法，并非官方要求。

"There was an unexpected issue setting up your account"

含义：登录本身成功了，但随后的设置调用失败。这是一条通用提示，下面的子信息很关键。论坛报告中出现过这些变体：

• "context deadline exceeded"（超时）：在 Windows 上重置应用缓存后出现（帖子 172137）。
• "Failed to fetch"：在 macOS 上长时间停留在 "Awaiting Authentication" 后出现（帖子 178878），该用户通过更新解决。
• 没有子信息，且只发生在某一个账号上：可能是该账号被打了服务条款标记（见服务条款标记）。

修复步骤：

1. 更新到最新版本，完全退出，重新启动并再次登录。
2. 在命令面板运行 Antigravity: Reset Onboarding 并再次登录。
3. 在 myaccount.google.com/connections 撤销 Antigravity，并在浏览器中只用一个账号重新登录。
4. 尝试期间关闭代理和 VPN 软件，并确保你的网络可以访问 Google 登录。"context deadline exceeded" 或 "Failed to fetch" 子信息提示的是应用与 Google 服务器之间的超时，而不是你的账号有问题，不过 Google 并未对此做过文档说明。
5. 在 agy（CLI）中测试同一个账号。如果它返回了具体的资格提示，请按账号不符合条件指南处理。如果 CLI 能正常登录，问题出在桌面应用而不是账号。
6. 如果只有这个账号在所有地方都失败，并且你曾把它与第三方工具搭配使用，请看服务条款标记。

"Failed to sign in. Message: This client is no longer supported for Gemini Code Assist for individuals"

含义：你在用 Gemini CLI（或 Gemini Code Assist 扩展）搭配个人 Google 登录，而这条路径已被关闭。Gemini CLI 仓库中的报告（issue 28229）显示，即使在干净重装之后，Google AI Pro 账号也会出现这个错误，维护者的回复指向 Antigravity CLI。Google 的 Gemini Code Assist for individuals 弃用页面是官方来源，请在那里查看当前日期。2026年10月的第三方测试报告称，个人账号的截止日期是 2026年6月18日，涵盖免费、Google AI Pro 和 Google AI Ultra 个人登录，而付费的 Gemini API 密钥和已有的 Gemini Code Assist Standard 或 Enterprise 许可不在该次截止范围内。

原因：这是服务器端策略，不是你机器上的缺陷。在 Gemini CLI 的 issue 中，同样的文本还会伴随代码 UNSUPPORTED_CLIENT。重装 Gemini CLI、删除 ~/.gemini 或换另一个个人账号都不会改变结果。

修复步骤（任选其一）：

1. 迁移到 Antigravity CLI：从 antigravity.google/download 安装。第三方测试中报告的安装命令，macOS 和 Linux 是 curl -fsSL https://antigravity.google/cli/install.sh | bash，Windows PowerShell 是 irm https://antigravity.google/cli/install.ps1 | iex；运行管道到 shell 的安装脚本之前，请先在下载页面核对当前命令。
2. 运行 agy，打开它打印的登录链接，选择你的个人账号，复制浏览器显示的授权码并粘贴回终端。一位测试者报告验证码输入提示约 60 秒后超时，所以请提前准备好浏览器；如果超时，重新开始并使用新的链接。
3. 用 agy -p "Reply with the single word OK" 检查是否正常。
4. 如果你只把旧 CLI 用于个人登录，可以移除它：npm uninstall -g @google/gemini-cli。不要删除整个 ~/.gemini 文件夹，因为 Antigravity CLI 也在该目录下存放数据。
5. 或者继续使用 Gemini CLI 并配置付费的 Gemini API 密钥：在 Gemini CLI 中运行 /auth 并选择 API 密钥选项，同时在环境变量中设置 GEMINI_API_KEY。在切换认证类型之前，之前保存的 Google 登录可能仍会被继续使用。

完整流程请看 Gemini CLI 迁移到 Antigravity CLI。如果 agy 随后显示 "Eligibility check failed"，那是另一个问题：请看Eligibility check failed。

已登录却提示 "Authentication Required"

含义：工作中途缓存的会话失效。智能体面板要求你登录，有时没有按钮。由于 Antigravity 的 App、IDE 和 agy CLI 共用同一个后端，某一端的过期会话可能让其他端也处于异常状态。

修复步骤：

1. 打开 Settings，再打开 Account，点击 Sign Out。如果没有按钮，在命令面板运行 Antigravity: Reset Onboarding。
2. 在 agy 中运行 /logout，断开账号并清除已保存的配置。
3. 完全退出并重新启动，然后用一个账号登录。
4. 如果应用完全没有响应，结束 Antigravity 进程（Windows 用任务管理器，macOS 用活动监视器，Linux 用 pkill -f antigravity），再重新启动。

如果同一界面报告的是资格问题而不是登录问题，清除令牌没有帮助，请看账号不符合条件指南。如果出现此缺陷之后配额显示异常，请看配额指南。

资格类提示（在单独的指南中处理）

这些提示表示你的账号被检查后遭到拒绝，或者需要验证。每一条在账号不符合条件指南中都有各自的原因和步骤：

• "Sorry, this account is ineligible to use Antigravity" / "Your current account is not eligible for Antigravity, because it is not currently available in your location"：国家关联、年龄或账号类型。
• "Eligibility check failed: your current account is not eligible for Antigravity. Verify your account to continue."（CLI）。
• "Further action is required to use Antigravity" / "Please verify your account to continue using Antigravity"。
• "This account isn't eligible for Google Antigravity benefits included with Google AI plans"。

服务条款标记（第三方工具）

如果一个原本可用的账号突然无法完成设置，而你曾把 Antigravity 登录连接到第三方工具，原因可能是服务条款处理。Antigravity 附加条款禁止将本服务与非 Google 提供的产品搭配使用，并以 OpenClaw 搭配 Antigravity OAuth 为例，说明可能导致 Antigravity 和/或 Gemini CLI 账号被暂停或终止。FAQ 建议第三方编码代理使用 Gemini Enterprise 或 API 密钥。

Google 在 gemini-cli discussion 20632（2026年2月27日）中的帖子描述了恢复路径：被标记的账号会收到邮件和一条指向 Google 表单的错误信息，你需要在表单中重新确认会遵守条款；第二次违规将导致永久封禁。步骤：

1. 停止使用该第三方工具，并在 myaccount.google.com/connections 移除它的访问权限。
2. 查找 Google 发来的邮件或应用内提示，并使用其中链接的表单。不要重新连接该工具。
3. 如果没有收到任何消息，请到 Antigravity 论坛提问。已报告的封禁案例处理结果不一致，Google 也没有公布时间表。

完整内容见账号不符合条件指南。本页不涉及绕过条款或地区可用性限制的方法。

避免再次出现登录问题

• 只用一个个人 Google 账号登录，登录期间让浏览器中的其他账号保持退出状态。
• 不要把 Antigravity 登录连接到第三方工具。FAQ 和条款都说明这可能导致账号被暂停。
• 保持 Antigravity 为最新版本。多个登录问题的答复就是更新。
• 收藏 myaccount.google.com/connections：当登录状态损坏时，撤销并重新授权是最快的重置方式。
• 如果你曾用个人登录使用 Gemini CLI，请迁移到 Antigravity CLI，不要再重试旧的登录方式。

早期指南（2026 年 3 月）

本节保留了本页早期版本中的内容，以免信息丢失。凡是已过时或未经证实的条目，都附有带日期的说明。当前步骤请以上方各节为准。

Identify Your Login Issue

早期版本把登录问题分为四种，每种的修复方法不同。请先判断你属于哪一种：

• 认证循环（Authentication Loop）：浏览器显示 "Successfully Authenticated"，但 IDE 始终收不到重定向，你卡在登录循环里。参见当前修复方法。
• 已登录却提示 "Authentication Required"：你本来在正常工作，agent 面板突然显示 "Authentication Required"，而且没有登录按钮。参见当前修复方法。
• "Account not eligible"：你可以登录，但被告知账号不符合 Antigravity 的使用条件。参见资格类提示。
• 账号被封禁/暂停：你完全无法登录，看到 "There was an unexpected issue"，或账号处于 "on hold" 状态。参见服务条款标记。

Quick Fix (90 Seconds)

早期版本称，在尝试其他方法之前，先做下面几步可以解决大多数登录问题：

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

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

修复认证循环问题

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

早期版本称这是最常见的变体，已在 Google AI 论坛上得到 5 位以上用户的确认。从浏览器重定向回桌面应用的 OAuth 过程静默失败。当前步骤见上方对应章节，以下是早期的四个修复方案。

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

早期版本称，这种特定组合可以解决 Windows 上约 70% 的登录循环问题（社区报告，2026 年 3 月）：

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

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

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

解决方案

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

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

解决“账户不符合条件”

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

早期版本称，这通常由以下三种情况之一引起：

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

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

账户被封禁/暂停

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

早期版本称，以下开发者报告了账户封禁的情况：

• 使用了 OpenClaw 或类似的第三方 OAuth 工具。Google 的条款禁止将本服务与非 Google 提供的产品搭配使用。早期版本称，即使通过 OpenClaw 使用 Gemini OAuth 也可能触发封禁（社区报告，2026 年 3 月，Google 未就具体范围作出证实）。参见服务条款标记。
• 从多个设备登录：一位开发者报告称，因连续（非同时）使用 3 台 PC 而被封禁，这表明 Google 的机器人可能把正常的跨设备使用误判为异常。这只是单个社区报告（2026 年 3 月），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”消息，但无法触发登录流程。早期的解决办法是清除会话存储并重启：

这些路径来自社区报告，Google 没有在文档中说明。请先确认目录确实存在，并优先考虑重命名而不是删除。

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

考虑替代方案？

如果登录问题反复出现，可以考虑不需要 Google 认证的其他选项：2026 年最佳替代方案和 Cursor 与 Antigravity。

预防未来的登录问题

• 使用单个个人 @gmail.com 账户：不要切换账户。早期版本还建议不要使用 Workspace 账户；该说法已过时，见上方 FAQ 更新说明。
• 避免使用第三方 OAuth 扩展：尤其是配额监控器和 OpenClaw 等使用您的 Google 凭据进行认证的工具。早期版本称这些是导致账户被封禁的首要原因（社区报告，2026 年 3 月，Google 未证实）；但 Antigravity 附加条款确实禁止与非 Google 产品搭配使用本服务。
• 不要同时使用 Gemini Code Assist 和 Antigravity：早期版本称这两项服务在同一个 Google 账户上会发生冲突（社区报告）。请在 Antigravity 内部禁用 Gemini 扩展。
• 保持 Antigravity 更新：旧版本可能存在已修复的认证错误。请参阅我们的更新指南。
• 收藏 myaccount.google.com/connections：如果您被锁定，撤销并重新授予 Antigravity 访问权限是最快的恢复方法。

已登录？接下来解决这些问题

认证成功后，您可能会遇到配额或性能问题。请查看我们的167 小时配额锁定解决方案、agent 加载速度指南，或访问故障排除中心。

来源（2026年10月30日核查）

• Antigravity FAQ：个人账号与 Workspace 账号、可用地区、第三方软件。
• Antigravity 附加条款和更新日志。
• Gemini Code Assist for individuals 弃用页面；gemini-cli issue 28229；issue 28846。
• Google AI Developers Forum 帖子 172137、144283 和 178878（链接见上文），以及 discussion 20632。
• 第三方迁移测试：jwatte.com 和 getdmn.com（安装命令、6月18日日期、API 密钥路径）。