Gemini CLI 免费额度没了？403 / no longer supported 报错原因与解决方法（2026）

直接答案：Gemini CLI 的“免费登录”已经没了。Google 官方确认，从 2026 年 6 月 18 日 起，Gemini CLI 不再处理 Gemini Code Assist 个人免费版、Google AI Pro 和 Google AI Ultra 账号的请求，“Login with Google”登录方式也不能用了。现在用个人账号登录，会报 This client is no longer supported for Gemini Code Assist for individuals，或者 403。想继续用，有两条路：一是改用 Gemini API Key 认证，二是迁移到官方的 Antigravity CLI。

官方到底改了什么？

• Google 开发者博客宣布：2026 年 6 月 18 日起，Gemini CLI 和 Gemini Code Assist IDE 扩展停止为 Google AI Pro、Ultra 以及免费使用的个人版用户提供服务。（来源：Google Developers Blog）
• 官方弃用页面说明：不能再用“Login with Google”登录 IDE 扩展或 Gemini CLI，个人用户可以迁移到 Antigravity 系列产品。（来源：Gemini Code Assist consumer accounts）
• 不受影响的情况：企业的 Gemini Code Assist Standard / Enterprise 授权，以及 付费的 Gemini API Key 和 Gemini Enterprise Agent Platform API Key。（来源同上，以及 GitHub Discussion #28017）

所以网上那些写着“Gemini CLI 每天 1000 次免费调用”的老教程，对个人账号已经不适用了。

常见报错及含义

1. This client is no longer supported…

完整提示类似：

IneligibleTierError: This client is no longer supported for Gemini Code Assist for individuals. To continue using Gemini, please migrate to the Antigravity suite of products

这就是 6/18 政策生效后的表现（见 gemini-cli issue #28229）。重新登录、重装、换一个个人 Google 账号都没用。

2. 403 PERMISSION_DENIED

如果改用 API Key 后报 403 PERMISSION_DENIED（Your project has been denied access），或者 AI Studio 里显示项目状态是“Free tier unavailable”，说明这个 Google Cloud 项目 不能用免费层。Gemini API 官方排错文档说明：资格是按项目判断的，在同一个项目里新建 Key 解决不了，要关联结算账号、升级到付费层才行。（来源：Gemini API Troubleshooting）

解决方法一：改用 Gemini API Key（继续用 Gemini CLI）

1. 打开 Google AI Studio，创建 API Key。官方公告里写的是“付费 API Key 可以继续使用”，免费层 Key 有没有额度、额度多少，以 AI Studio 里显示的为准。
2. 设置环境变量。macOS / Linux：

   export GEMINI_API_KEY="你的 Key"

   Windows PowerShell：

   $env:GEMINI_API_KEY = "你的 Key"

3. 切换认证方式。只设置 Key 不够，CLI 还会沿用之前保存的 Google 登录。在 Gemini CLI 里输入 /auth，选择“Use Gemini API Key”；或者在 ~/.gemini/settings.json 里写：

   {"security": { "auth": { "selectedType": "gemini-api-key"} } }

4. 重新运行 gemini，测试一条简单的指令。如果提示 API key not valid，说明已经切到 API Key 认证了，检查一下 Key 有没有填错。

API Key 按 Gemini API 的价格计费，和以前的个人免费额度是两回事。用之前建议先在 Google Cloud 设置预算提醒。

解决方法二：迁移到 Antigravity CLI

Google 推荐个人用户迁移到 Antigravity CLI。官方说明，安装时会自动导入本地 Gemini CLI 的 Skills、MCP 服务器、Agent 配置，并且兼容 gemini.md。官方安装命令（来源：Discussion #28017）：

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex

Antigravity 的额度和订阅信息，以官方的 Antigravity 价格页面为准。

不想用 Google？其他选择

还可以考虑 Claude Code、OpenCode 等终端 AI 编程工具，接入自己的模型 API。站内教程：OpenCode 教程、Claude Code 教程。

FAQ

Gemini CLI 现在还有免费额度吗？

个人 Google 账号登录的免费额度已经在 2026-06-18 停了。Gemini API 免费层是另一套规则，而且不是所有项目都能用，以 AI Studio 显示为准。

我是 Google AI Pro 会员，也不能用吗？

不能。官方公告明确包括 Pro 和 Ultra，建议改用 Antigravity CLI。

公司账号受影响吗？

Gemini Code Assist Standard / Enterprise 授权用户目前不受影响，不过官方说它们另有弃用时间表。

换一个新项目能解决 403 吗？

官方说资格按项目判断，同一个项目里新建 Key 没用。换别的项目能不能用免费层，以官方为准。

参考来源：Google Developers Blog、Gemini Code Assist 弃用说明、gemini-cli GitHub Discussion #28017 / Issue #28229、Gemini API Troubleshooting。核实时间：2026-10-28。