Antigravity 报错 #3501 无法登录：先查地区和账号，别删 .gemini

在 Antigravity App、Antigravity CLI（agy）、Antigravity IDE，或者 VS Code、JetBrains 里的 Gemini Code Assist 扩展登录后，看到 "You do not have a valid license of this product… (#3501)"，字面意思是"你没有这个产品的有效许可"。这里的 license 指 Gemini Code Assist 企业版的付费席位，不是软件激活码，也没有可以买来填进去的 key。麻烦在于，账号国家不在可用名单上、联网走了代理、登录被当成企业账号、用的是已经停止服务的 Code Assist 个人版，都会返回同一句话和同一个编号，报错本身不告诉你是哪一种。

所以先对号入座再动手。用个人 Gmail 登录 Antigravity 的，先更新到最新版（截至 2026 年 10 月 23 日是 App v2.25.0、CLI v1.4.0），确认没有设置环境变量 AGY_ADC_AUTH，再在 App 或 IDE 里运行命令「Antigravity: Reset Onboarding」，CLI 里先 /logout 再 /login，登录时选个人账号。用的是 VS Code 的 Gemini Code Assist 扩展或 Gemini CLI，个人账号和 Google AI Pro 从 2026 年 6 月 18 日起就不再被服务，报 #3501 是预期结果，该换成 Antigravity。账号国家（policies.google.com/terms 页面上显示的国家）是中国大陆、香港或澳门的，Antigravity 目前不对你开放，客户端里没有能修好的设置，开代理只会让验证更容易失败。

实际跑过的检查只有两项，都在 2026 年 10 月 23 日、一台 macOS 26.1 的 Mac 上完成：看 ~/.gemini 里到底放着什么，以及查会把登录导向企业版的环境变量。这台机器没有复现 #3501，Windows 上的命令也没有执行；涉及 Windows 的步骤来自 Google AI 开发者论坛里版主的回复，原因判断来自 Google 员工和版主在论坛里的回复，下文逐条标明。论坛里流传的"删掉 ~/.gemini"会把 Antigravity 的对话历史一起删掉，删之前先看实测那一节。

报错 #3501 是什么意思：企业许可检查没通过，地区被拒也报这一句

#3501 是 Google 服务端返回的拒绝，不是本机软件坏了。在 CLI 或扩展的日志里，它对应 HTTP 403，"status": "PERMISSION_DENIED"，原因字段是 "reason": "SUBSCRIPTION_REQUIRED"，域名是 cloudaicompanion.googleapis.com，按论坛版主的说法，这属于 Gemini Code Assist 的企业许可检查（gemini-cli issue #28912 里贴出的完整日志）。Antigravity App、CLI、IDE、Code Assist 扩展和 Gemini CLI 弹出的英文原文完全一样：

You do not have a valid license of this product. Please contact your administrator to request a license. If you are not an enterprise user and believe you are receiving this message as an error, please try using the latest version and logging in again. (#3501)

Google 员工在论坛里给过两种解释。2026 年 9 月 24 日的回复说，这个错误出现在"登录被当作需要企业或商业许可，但账号上找不到有效许可"的时候（Google AI 开发者论坛里 Google 员工关于企业登录缓存的回复）。更早的 9 月 9 日，另一条员工回复承认：地区不受支持的用户被拒绝开通时，系统抛出的也是这个"许可无效"错误，而不是直说地区不支持，并为造成的困惑道歉（Google 员工承认 #3501 在地区被拒时是误导性提示的回复）。之后几位论坛版主又补充了代理、年龄验证和付款资料等情况。报错末尾那句"不是企业用户就更新、重新登录"，只对其中一种原因有用。

我属于哪一种：按客户端、账号和国家对照 #3501 的原因

多数人能从客户端、账号国家和联网方式三点判断出自己是哪一类。下表从上往下看，命中多行时先处理地区那两行，因为账号国家不在名单上时，其他步骤做得再对也不会生效。

最后一行的依据是 Antigravity 官方 FAQ：用第三方软件接入 Antigravity 登录违反服务条款，可能导致账号被暂停或终止，用第三方编码代理时应改用 Gemini Enterprise 或 Google AI Studio 的 API key；把 agy 的无界面模式包进第三方代理、自动轮换账号，在个人套餐下也不受支持。论坛里有人申诉"误封"时看到的也是 403 #3501，但这只是用户报告。

企业登录缓存卡住：按这个顺序重置 Antigravity 登录

如果你属于上表第一行，按下面的顺序做，前一步解决了就不用往下走。步骤来自 Google 员工 9 月 24 日和 9 月 28 日的两条回复，Windows 凭据那一步来自论坛版主；App 和 IDE 只在第 3 步与 CLI 不同。

1. 更新到最新版。截至 2026 年 10 月 23 日，Antigravity 更新日志上的最新版是 App v2.25.0（10 月 20 日）和 CLI v1.4.0（10 月 16 日），CLI 可以运行 agy update。9 月的 App v2.16.0、v2.18.1 和 CLI v1.2.5、v1.2.9 都修过"企业凭据被缓存、登录中途关掉后卡住"一类问题；更新日志也写明新版本分批推送，可能要几天才轮到你。
2. 查环境变量 AGY_ADC_AUTH。它是 Google Cloud 凭据的开关，设了就会强制走企业许可检查；先取消再重启 App 或 CLI，各系统的查法见下面"AGY_ADC_AUTH 在哪里查"一节。
3. 重置登录。App 和 IDE 里按 Cmd+Shift+P（Windows、Linux 按 Ctrl+Shift+P）打开命令面板，运行「Antigravity: Reset Onboarding」，它会退出账号并重新开始登录流程；CLI 里输入 /logout，再输入 /login。
4. 浏览器弹出登录页时选个人 @gmail.com 账号，不要选 Enterprise、Workspace SSO 或 Google Cloud 选项。
5. 同时装了 App 2.x 和 IDE 的，先打开独立的 Antigravity App 登录，按提示完成账号验证或扫码，再回到 IDE 重新登录。帖子里没有人回报这一步的结果。
6. 在 Windows 上，按版主的说法，删掉 .gemini 或 %APPDATA%\Antigravity 并不会清掉系统里保存的令牌：打开"凭据管理器 → Windows 凭据"，删除 LegacyGeneric:target=gemini:antigravity 这一项，或在 agy 里运行 /logout，然后重新登录。

做完仍然报错，就不要再重复这几步，直接看"什么时候该停下"一节。

要不要删 ~/.gemini：一台 Mac 上 689 MB 的对话记录都在里面

不要整个删。论坛里常见的建议是删除 ~/.gemini 和 ~/Library/Application Support/Antigravity 来"清缓存"，但 ~/.gemini 里放的主要不是登录状态。2026 年 10 月 23 日在一台 macOS 26.1 的 Mac 上查看（这台机器 2025 年 12 月到 2026 年 1 月用过 Antigravity IDE，应用已卸载，数据目录还在），~/.gemini/antigravity 有 689 MB，里面是 conversations（对话）、brain（83 个文件）、browser_recordings（4,302 个浏览器录制文件），以及 mcp_config.json、user_settings.pb 等配置。同一个 ~/.gemini 里还有 Gemini CLI 的 google_accounts.json、settings.json 和 mcp-oauth-tokens-v2.json，整个删掉等于把 Gemini CLI 的登录和 MCP 授权令牌也一起删了。

用下面两条命令就能看到自己机器上的情况：

du -sh ~/.gemini/antigravity ~/.antigravity "$HOME/Library/Application Support/Antigravity"
ls ~/.gemini/antigravity

另外两个目录在这台 Mac 上分别是 71 MB（~/.antigravity）和 142 MB（Application Support/Antigravity）。和登录有关的浏览器状态（Cookies、Local Storage、Session Storage）在 ~/Library/Application Support/Antigravity 里。所以如果重置登录之后你还想清一次本地状态，先完全退出 Antigravity，再把这个目录改名备份，而不是删除：

mv "$HOME/Library/Application Support/Antigravity" "$HOME/Library/Application Support/Antigravity-backup"

~/.gemini/antigravity 保持不动；真要动它，也用 mv ~/.gemini/antigravity ~/.gemini/antigravity-backup 改名，事后想要回对话历史，把名字改回来即可。这次检查有三点限制：只看了一台机器、一个账号；没有验证改名能否消除 #3501；目录结构来自较早的 IDE 版本，当前 App v2.25.0 可能不同。Windows 上对应的目录是 %USERPROFILE%\.gemini 和 %APPDATA%\Antigravity，同样改名而不是删除。

AGY_ADC_AUTH 在哪里查：macOS、Linux 和 Windows 的命令

只在终端里查一遍不够。macOS 上从程序坞或启动台打开的 App 不读 ~/.zshrc，却能读到用 launchctl setenv 设的变量，所以 Mac 要查两处。2026 年 10 月 23 日在上面那台 Mac 上运行了下面两条命令，都没有输出，~/.config/gcloud/application_default_credentials.json 也不存在，这台机器不属于环境变量这一类。

在 macOS 或 Linux 的终端里：

env | grep -E '^(AGY_|GOOGLE_CLOUD_PROJECT|GOOGLE_APPLICATION_CREDENTIALS|GOOGLE_GENAI_USE_VERTEXAI|CLOUDSDK_)'

macOS 再加一条：

launchctl getenv AGY_ADC_AUTH

有输出就取消：终端里先 unset AGY_ADC_AUTH，再把 ~/.zshrc 或 ~/.bashrc 里对应的 export 行删掉；launchctl getenv 有值的，运行 launchctl unsetenv AGY_ADC_AUTH。然后完全退出 App、重开终端，再回到上一节的第 3 步。

Windows 的命令没有实际执行过，来自论坛版主的回复。在 PowerShell 里分别查用户级和系统级：

[Environment]::GetEnvironmentVariable('AGY_ADC_AUTH','User')
[Environment]::GetEnvironmentVariable('AGY_ADC_AUTH','Machine')

有值就到"设置 → 系统 → 系统信息 → 高级系统设置 → 环境变量"里删掉。版主也提到 Remove-Item Env:\AGY_ADC_AUTH，但它只清当前这个 PowerShell 窗口，重装和删文件夹都不会动到写在系统里的变量。

Google 员工点名的只有 AGY_ADC_AUTH。上面那条 grep 里的 GOOGLE_CLOUD_PROJECT、GOOGLE_APPLICATION_CREDENTIALS 顺带检查即可，它们会不会让 Antigravity 走企业检查没有官方说法；它们影响的是 Gemini CLI 用"Google 账号 + 项目 ID"登录的情况，gemini-cli issue #28912 里就是这样报出 #3501 的。

Gemini Code Assist 和 Gemini CLI 报 #3501：个人版已停服

这种情况报 #3501 是预期行为，重置和重装都没有用。Gemini Code Assist 停用说明页（2026 年 10 月 9 日更新）写明：2026 年 6 月 18 日之后，Gemini Code Assist 的 IDE 扩展和 Gemini CLI 不再为 Google AI Pro、Ultra 以及 Gemini Code Assist 个人版提供服务。按论坛版主的说法，扩展现在只认付费的 Gemini Code Assist Standard 或 Enterprise 许可；而同一页面写明，这两种企业订阅 2026 年 10 月 9 日起已不再接受新购。

所以个人账号、哪怕付了 AI Pro，在 VS Code 或 JetBrains 的 Code Assist 扩展里都会看到 #3501。论坛版主 10 月 1 日的回复给的出路是改用 Antigravity；10 月 16 日的另一条回复补充，想留在 VS Code 里的，可以装官方的 "Antigravity for Visual Studio Code" 扩展。AI Pro 的额度是在 Antigravity 里生效的，不在旧扩展里。

是地区还是代理：账号国家不在名单上，客户端修不好

先看账号国家，再看网络。Antigravity 认的是 Google 服务条款页上显示的账号关联国家，它不等于你当前的 IP 所在地，也不等于手机号归属地。截至 2026 年 10 月 23 日，Antigravity 官方 FAQ 的可用地区名单按美洲 51、欧洲 47、非洲 56、亚洲 43、大洋洲和南极洲 27 列出共 224 个国家和地区，亚洲部分有日本、韩国、新加坡、马来西亚、印度等，中国大陆、香港、澳门都不在名单上。

如果你的账号国家是中国大陆、香港或澳门，结论很直接：Antigravity 目前不对这个账号开放，#3501 只是地区拒绝的另一种写法，Google 员工 9 月 9 日已经承认这一点。重置、重装、换版本都改变不了结果，等到名单变化之前，不必再花时间在客户端上。FAQ 里的国家修改表单是给"账号国家登记错了"的人用的，比如你长期住在名单内的国家，而条款页显示的仍是旧国家；按版主的说法，改完要等 24 到 48 小时以上才会在各个服务里生效。

账号国家在名单上、仍报 #3501 的，下一个要查的是网络。论坛版主在 9 月底到 10 月中旬的多条回复里说，Antigravity 登录时会验证所在地，走 VPN、代理、TUN 模式或分流（IPv6 流量可能单独出去）都可能让验证失败，这时服务端开不出免费的个人额度，就返回 #3501。所以代理是触发原因之一，不是解决办法：关掉代理，用本地网络直连，再按重置步骤登录一次。版主还提到要看 Google 付款资料里有没有登记在不受支持地区的旧资料。另一条提示内容不同的报错 "Your current account is not eligible for Antigravity, because it is not currently available in your location" 是同一类问题的直白版本，处理方法相同。

买了 Google AI Pro 还报 #3501：试用和合作方赠送的套餐

付了 Pro 不等于 Antigravity 一定认。论坛版主 10 月 8 日回复过一个个案：用户的 AI Pro 由印度的 Jio 赠送，账号国家却是德国。版主的解释是，Antigravity 的套餐权益是从 Google 订阅里读取的，套餐发放国和账号国家不一致时可能不生效，Antigravity 这边也无法手动同步；能做的是联系 Google One 支持或 Jio，或者在自己的国家直接订阅 AI Pro，在此之前 Antigravity 仍可用免费的 Starter 额度。同一条回复还指出，这位用户看到的 #3501 来自直接调用内部接口，而不是 App 本身。

试用的限制有官方依据。Antigravity FAQ 写明，Gemini 4 Argon、Claude Opus 5.5 和 Claude Sonnet 5.5 需要付费的 Google AI Pro 或 Ultra，不包含在免费试用里；试用用户可以申请取消试用、改订付费 Pro，通过合作方、Pixel Pass 或 Google Fi 获得的会员要按 Google One 第三方订阅管理说明处理。至于赠送的 Pro 是否会直接报 #3501，目前只有用户报告：X 用户 @StatsWire 在 10 月 17 日发帖称，Pixel、Jio、学生等捆绑的 AI Pro 在后台被标成"试用/推广"，会收到 HTTP 403 #3501，用不了 Argon 和 Claude 5.5，有中文博主转述了同样的说法，Google 没有确认。各套餐在 Antigravity 里能用哪些模型，见 Gemini 4 Argon、Opus 5.5、GPT-6.1 Sol 对比：已开放，12 月起涨价；已经能登录、只是回复慢的，看 Gemini 3.8 Flash 在 Antigravity 中很慢？先分清四种卡顿再处理。

什么时候该停下：几个个人账号都报 #3501 就别再重装

同一台电脑上换两三个个人账号都报 #3501，没开代理，也没有设 AGY_ADC_AUTH，问题就在账号或地区一侧，再重装多少次都一样。这是根据上面几条员工和版主回复得出的推断：本机能清的只有登录缓存，其余几种检查都在服务端。版主 10 月的一条回复说法相同，多个个人账号在同一台机器上报 #3501、又排除了代理和环境变量，"通常意味着服务端的地区或账号资格拒绝"。

论坛上的情况也说明有一部分要等 Google。截至 2026 年 10 月 23 日，Google AI 开发者论坛里涉及 3501 的帖子约有 45 个，2026 年 9 月 24 日到 29 日六天里冒出约 25 个，多数是"个人账号被当成企业账号"。有用户试遍办法、等了几天无果，10 月 3 日没做任何操作就恢复了，10 月 13 日误用 VPN 打开账号后又出现；也有人说几个老的个人账号卡住，新注册的账号正常。这些都是个例，不能当成规律，但能说明：做完重置步骤后，剩下的事情要交给 Google。

提交问题时，按版主和员工在论坛里要求的内容一次附齐：

• 报错旁边显示的 Error ID，界面上有 Trajectory ID 的一起附上
• 用的是 IDE、App 2.x 还是 CLI，版本号和操作系统
• 你实际所在的国家或地区，以及 policies.google.com/terms 上显示的账号国家
• 账号是免费、Google AI Pro 还是 Ultra，Pro 是自己订阅、试用还是合作方赠送
• 诊断日志的 .txt 文件，从 Help > Toggle Developer Tools > Console 或 View > Output > Antigravity Language Server 导出，或者一张报错截图
• 已经做过的步骤，例如 Reset Onboarding、查过 AGY_ADC_AUTH、关掉代理

渠道有两个。登录和报错问题，从 Antigravity 支持页进入社区，也就是 Google AI 开发者论坛；套餐权益问题（试用、合作方赠送、付款国家）找 Google One 支持，论坛版主明确说过 Antigravity 这边没法手动同步。在论坛公开贴日志前，先把邮箱地址遮掉。