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

> #3501 不只是缺企业许可：地区被拒、开代理、Code Assist 个人版停用都会报。先查 AGY_ADC_AUTH 再重置登录；中国大陆和港澳不在可用名单。

- URL: https://blog.laozhang.ai/zh/posts/antigravity-error-3501
- Published: 2026-10-23
- Updated: 2026-10-23
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: 开发工具与智能体
- Tags: Antigravity, 3501 错误, 无法登录, Gemini Code Assist, AGY_ADC_AUTH, 地区限制, 报错排查

---
在 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 里贴出的完整日志](https://github.com/google-gemini/gemini-cli/issues/28912)）。Antigravity App、CLI、IDE、Code Assist 扩展和 Gemini CLI 弹出的英文原文完全一样：

```text
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 员工关于企业登录缓存的回复](https://discuss.ai.google.dev/t/184724)）。更早的 9 月 9 日，另一条员工回复承认：地区不受支持的用户被拒绝开通时，系统抛出的也是这个"许可无效"错误，而不是直说地区不支持，并为造成的困惑道歉（[Google 员工承认 #3501 在地区被拒时是误导性提示的回复](https://discuss.ai.google.dev/t/182209)）。之后几位论坛版主又补充了代理、年龄验证和付款资料等情况。报错末尾那句"不是企业用户就更新、重新登录"，只对其中一种原因有用。

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

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

![#3501 原因判断图：依次看账号国家是否在可用名单、是否用 Code Assist 扩展或 Gemini CLI、是否开着代理、AI Pro 是否为试用或赠送，都不是时多半是企业登录缓存，可在本机重置登录](https://blog.laozhang.ai/posts/zh/antigravity-error-3501/img/error-3501-cause-routing.webp)

| 你的情况 | 可能原因（出处） | 下一步 | 自己能修好吗 |
|---|---|---|---|
| Antigravity App、IDE 或 CLI，个人 Gmail，以前登过公司 Workspace 或 Google Cloud 项目，或者设过 `AGY_ADC_AUTH` | 登录被缓存成企业版（Google 员工回复） | 按下一节的顺序重置登录 | 能，这是唯一靠本机重置就能解决的一类 |
| VS Code、JetBrains 里的 Gemini Code Assist 扩展，或 Gemini CLI，用个人账号或 Google AI Pro | 个人版已于 2026 年 6 月 18 日停止服务（Google 文档） | 改用 Antigravity | 扩展本身修不好 |
| policies.google.com/terms 显示的账号国家不在可用名单上，例如中国大陆、香港、澳门 | 地区拒绝被显示成许可错误（Google 员工回复） | 没有客户端办法，见"地区还是代理"一节 | 不能 |
| 账号国家在名单上，但开着 VPN、代理、TUN 模式或分流 | 所在地验证失败（论坛版主回复） | 关掉代理，直连后重新登录 | 能 |
| 未满 18 岁，或账号没完成年龄验证 | Antigravity 只对 18 岁以上开放（官方 FAQ；与 #3501 的关联来自版主回复） | 满 18 岁的在 [Google 账号年龄验证页](https://myaccount.google.com/age-verification) 完成验证 | 满 18 岁可以 |
| AI Pro 是试用，或来自 Jio、Pixel、学生优惠等合作方，或付款资料在别的国家 | 套餐权益没有落到 Antigravity（版主个案回复；X 上的用户报告） | 找 Google One 或合作方，见 AI Pro 一节 | 客户端修不好 |
| 把 Antigravity 的登录用在 Claude Code、OpenCode 等第三方工具里，或直接调用内部接口 | 违反服务条款，可能被停用（官方 FAQ） | 停止这样用；第三方工具改用 Google AI Studio 或 Gemini Enterprise 的 API key | 本机设置解决不了 |

最后一行的依据是 [Antigravity 官方 FAQ](https://antigravity.google/docs/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 更新日志](https://antigravity.google/changelog)上的最新版是 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 授权令牌也一起删了。

![一台 Mac 上三处目录的内容：~/.gemini/antigravity 有 689 MB 对话历史应保持不动，~/.gemini 根目录里是 Gemini CLI 的登录和 MCP 令牌，Application Support/Antigravity 有 142 MB 登录状态，退出后改名备份](https://blog.laozhang.ai/posts/zh/antigravity-error-3501/img/gemini-folder-contents.webp)

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

```bash
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，再把这个目录改名备份，而不是删除：

```bash
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 的终端里：

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

macOS 再加一条：

```bash
launchctl getenv AGY_ADC_AUTH
```

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

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

```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 停用说明页](https://developers.google.com/gemini-code-assist/docs/deprecations)（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 服务条款页](https://policies.google.com/terms)上显示的账号关联国家，它不等于你当前的 IP 所在地，也不等于手机号归属地。截至 2026 年 10 月 23 日，[Antigravity 官方 FAQ 的可用地区名单](https://antigravity.google/docs/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 第三方订阅管理说明](https://support.google.com/googleone/answer/15801606)处理。至于赠送的 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 月起涨价](https://blog.laozhang.ai/zh/posts/gemini-4-argon-vs-claude-opus-5-5-vs-gpt-6-1-sol)；已经能登录、只是回复慢的，看 [Gemini 3.8 Flash 在 Antigravity 中很慢？先分清四种卡顿再处理](https://blog.laozhang.ai/zh/posts/gemini-3-8-flash-antigravity-slow)。

## 什么时候该停下：几个个人账号都报 #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 支持页](https://antigravity.google/support)进入社区，也就是 Google AI 开发者论坛；套餐权益问题（试用、合作方赠送、付款国家）找 Google One 支持，论坛版主明确说过 Antigravity 这边没法手动同步。在论坛公开贴日志前，先把邮箱地址遮掉。

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-23。

- [gemini-cli issue #28912 里贴出的完整日志](https://github.com/google-gemini/gemini-cli/issues/28912) (github.com)
- [Google AI 开发者论坛里 Google 员工关于企业登录缓存的回复](https://discuss.ai.google.dev/t/184724) (discuss.ai.google.dev)
- [Google 员工承认 #3501 在地区被拒时是误导性提示的回复](https://discuss.ai.google.dev/t/182209) (discuss.ai.google.dev)
- [Google 账号年龄验证页](https://myaccount.google.com/age-verification) (myaccount.google.com)
- [Antigravity 官方 FAQ](https://antigravity.google/docs/faq) (antigravity.google)
- [Antigravity 更新日志](https://antigravity.google/changelog) (antigravity.google)
- [Gemini Code Assist 停用说明页](https://developers.google.com/gemini-code-assist/docs/deprecations) (developers.google.com)
- [Google 服务条款页](https://policies.google.com/terms) (policies.google.com)
- [Google One 第三方订阅管理说明](https://support.google.com/googleone/answer/15801606) (support.google.com)
- [Antigravity 支持页](https://antigravity.google/support) (antigravity.google)