Gemini CLI 免费额度被砍：6 个真正管用的修复方案（2026）

太长不看。 2026 年 6 月 18 日，Gemini CLI 停止为免费的『用 Google 账号登录』通道处理请求，AI Pro 和 Ultra 登录也一并停掉。这个二进制没死：它仍是 Apache-2.0，仍在维护（v0.49.0），配上 API key 照样能跑。如果你正盯着『This client is no longer supported for Gemini Code Assist for individuals』发愁，那是认证问题，不是装坏了。修法就是别再用 Google 账号登录，改用一个开通了计费的 API key。2026 年 9 月还有第二堵墙等着你，届时不受限的 Standard key 会被停用，所以一次就把 key 配对，别配两遍。下面 6 个修复方案，从免费额度的临时补丁排到生产级路由。

6 月 18 日 Google 没杀掉 Gemini CLI，杀掉的是免费登录。工具还能跑，只是它现在要一个 key，而不是你的 Google 账号。

你的 Gemini CLI 真坏了吗？30 秒诊断

按顺序做三步检查。大多数以为 CLI 坏了的人，其实离能用只差一个环境变量。

如果第 1 步显示『no longer supported』消息，直接跳到修复 1。如果显示 429 或 limit: 0，说明你有 key 但没额度，去看修复 3。本指南其余内容都是为了让你把迁移一次做对，免得撞上 9 月的密钥截止点还得重来。

什么时候原地修，什么时候干脆换工具

这个判断能帮你省下一下午在错误的层面上瞎折腾的时间。

原地修 Gemini CLI（修复 1 到 5），如果

• 你已有调用 gemini 的脚本、别名或 CI，不想重写它们。
• 你不介意按 token 付费，就想用你已经熟悉的那个工具。
• 你需要 Vertex AI 或 Code Assist 许可通道，这两者都没被 6 月 18 日的改动碰到。

换成 Antigravity CLI，如果

• 你一直只用免费的个人登录，不想开通计费，又想走 Google 正在积极引导个人用户去的那条路。
• 你想要更新的异步后台 agent 工作流，也不介意它是一个独立的闭源二进制。

走网关中转（修复 6），如果

• 你想一个 key 打通 Gemini、GPT、Claude 等等，而不用管 Google Cloud 项目、计费档位和 9 月的密钥迁移。
• 你在做面向用户的东西，不希望某一家厂商的政策改动再次把你搞挂。

收手规则。 如果你已经重跑了三遍 Google 登录、清空了 ~/.gemini、重装了 CLI，还是看到『no longer supported』，就别弄了。重装修不了服务端的认证策略。换取 token 的动作是被故意拒绝的。换成 API key，这个死循环就结束了。

6 月 18 日到底改了什么

Google 在 5 月 19 日的 I/O 2026 上宣布了这件事，并在 Developers Blog 上以《An important update: Transitioning Gemini CLI to Antigravity CLI》为题发布。关键那句是：

“On June 18, 2026, Gemini CLI and Gemini Code Assist IDE extensions will stop serving requests for Google AI Pro and Ultra, as well as those using it free of charge using Gemini Code Assist for individuals.”

这句得仔细读，因为流行的『Gemini CLI 死了』的说法理解错了。三条独立的认证通道，三种不同的结局：

Google 的公告对幸存者说得很直白：『Gemini CLI will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys』，企业许可和 Google Cloud 访问『remains unchanged』。仓库里后续的一条通知，Discussion #28017，确认了个人账号的截止如期生效。

二进制本身没问题。仓库没被归档，许可仍是 Apache-2.0，v0.49.0 在停服一周后的 6 月 25 日发布。Google 讲得很明白：这个项目『remains available to the community as an Apache 2.0 licensed repository with no changes』。所以当有人劝你放弃你的 Gemini CLI 配置时，他们是把『免费登录结束了』和『工具结束了』混为一谈。只有前者是真的。

这事也不是凭空冒出来的。早在 2026 年 3 月 18 日，Google 就发过一条服务更新（Discussion #22970），限制于 3 月 25 日生效，已经把免费 OAuth 用户限制到 Flash 档模型，并加了『more robust detection for policy-violating use cases』，同时建议大家『use Gemini CLI with your own paid API key from AI Studio or Vertex AI』。6 月 18 日就是那次 3 月更新所预告的硬截止。

看懂报错：每一条各是什么意思

四种报错特征覆盖了几乎所有反馈。把你的报错对到对应那一行，就知道该用哪个修复。

值得记住的规律：登录错误指向的是认证方式，limit: 0 错误指向的是计费。它们在终端里看着很像，但需要完全不同的修法。别用开通计费去解决登录错误，也别用重新登录去解决额度错误。

怎么让 Gemini CLI 继续跑起来（各档位的修复）

按『免费、五分钟搞定』到『生产级路由』排序。挑对上你情况的那一档。

免费 / 个人档

修复 1：从 Google 登录换成 AI Studio API key

这是核心动作，能直接解决『no longer supported』消息。在 aistudio.google.com/apikey 建一个 key，然后：

export GEMINI_API_KEY="your_ai_studio_key"
gemini "say hi"

能收到正常回复，就说明你恢复营业了。如果你想确认 CLI 真的在用这个 key、而不是悄悄回退到缓存的登录，就在启动时看那行认证信息，或先把变量打印出来：

echo "${GEMINI_API_KEY:0:6}..."   # should show the first chars of your key, not empty

如果你更愿意从菜单选，在 CLI 里运行 /auth，选 Gemini API key 那一项而不是『Login with Google』。这个设置会存进 ~/.gemini/settings.json，所以只做一次就行。关于优先级有个提醒：客户端库同时接受 GEMINI_API_KEY 和 GOOGLE_API_KEY，如果两个都设了，GOOGLE_API_KEY 胜出。如果你的 key 看着没错却表现古怪，检查一下 shell 配置里有没有旧 Vertex 实验残留下来的、多余的 GOOGLE_API_KEY。

Flash 和 Flash-Lite 系列仍有免费 key，所以光靠修复 1 就能让不少人重新跑起来。不过它只能尽力而为，这就引出下一个修复。

修复 2：在怪 key 之前先重置坏掉的认证状态

如果你换了 key，CLI 却还想用 Google 登录，那是旧的 selectedAuthType 被缓存了。清掉它：

# Back up first, then reset the CLI's saved auth choice
mv ~/.gemini/settings.json ~/.gemini/settings.json.bak
gemini   # will prompt /auth again; pick the API key option

这同样是『Please set an Auth method』的解法，也是 issue #2111 那种情况的解法——那里 CLI 在已设 API key 的情况下拒绝切换认证类型。一个陈旧的 settings 文件引发的『还是不行』反馈，比任何真正的 key 问题都多。

付费 / 团队档

修复 3：开通计费，跳出 429 limit: 0 的坑

这是所有『我加了 key 还是报 429』反馈的解法。裸的 AI Studio key 待在 Free Tier 上，而 Google One AI Pro 订阅不会把付费额度推给它。指标返回 limit: 0，看着像 bug，其实只是一个没配额度的 key。

做这一次就行：

1. 打开 AI Studio 计费，把一个 Google Cloud Billing 账户关联到你 key 背后的项目。
2. 设一个真实的花费上限。$0 的上限会把你留在 Free Tier 并重现那个 429；设一个你觉得可以接受的数（哪怕 $10 也足以进付费 Tier 1）。
3. 刷新 CLI 认证：按修复 2 清缓存，或重新 export 一遍 key，然后重试。

Google 的档位随花费递增：Free，然后 Tier 1（开通计费），再到更高付费门槛的 Tier 2 和 Tier 3，每一档都拉高你的速率限制。单是 Tier 1 就带一个按时间窗计的花费额度（大约每 10 分钟 $10 的量级），对个人使用绰绰有余。

修复 4：给模型选对尺寸，让付费账单保持轻

你现在是按 token 付费了，所以选模型要有讲究。Gemini API 上当前的标准定价，每 100 万 token（在官方定价页核实，2026-07-07）：

大多数终端活儿，Flash-Lite 是合适的默认选择，重度使用一天也能压在一美元以内。真要写代码就升到 Flash，只有碰上真正难的 prompt 才动用 Pro。想看更深入的定价和性能拆解，见 Gemini 3.1 Pro API 定价指南。Google 那边的模型名变得很快，把它们硬编码进脚本前，先去定价页复核确切的 ID。

企业 / 生产档

修复 5：用 Vertex AI 或 Code Assist 许可

这两条通道都没被 6 月 18 日碰到，所以如果你已有 Google Cloud 底盘，它们是最干净的选择。走 Vertex AI：

export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT="your-project-id"
export GOOGLE_CLOUD_LOCATION="us-central1"
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
gemini

Vertex 用的是你 Cloud 项目的计费和 IAM，所以额度和访问由项目管，而不是由一个 Google 随时能重新归类的个人 Google 账号管。如果你的组织持有 Gemini Code Assist Standard 或 Enterprise 许可，CLI 和 IDE 扩展会完全无改动地继续工作；这一点在 Google 公告里直接写着。对团队来说，这通常是最不脆弱的答案。

修复 6：走一个网关中转，从此不用管 Google 的档位

如果你宁可不去打理 Cloud 项目、计费档位和 9 月的密钥迁移，就把 Gemini CLI 指向一个说 Gemini 协议的网关。通过 ofox.ai，同一个 CLI 用一个 key，不需要 Google Cloud 账号，还额外拿到故障转移和路由：

{
  "apiKey": "<your OFOX_API_KEY>",
  "baseUrl": "https://api.ofox.ai/gemini"
}

或者用环境变量，形状跟前面一样：

export GEMINI_API_KEY="<your OFOX_API_KEY>"

这一个 key 通过同一个账号还能触达 GPT、Claude、Qwen、DeepSeek，以及模型广场里的其余模型，所以下次某一家厂商改动个人政策时，你的 CLI 不会跟着一起挂。这跟多模型路由器详解里讲的是同一个路由思路，只是具体套用到了 Gemini CLI 上。

第二堵墙：你还没撞上的 API key 截止日

修好登录不是故事的结尾，而这部分是大多数『加个 key 就行』的指南略过的。Google 正在按另一套单独的时间表淘汰旧式 API key：

现实后果是：如果你今天翻出一个 2025 年的旧的不受限 key 来修登录，9 月你可能又撞墙。现在就建一个新 key，因为新 key 默认按 auth key 发放；或者给你在用的 key 加上明确的 API 限制。把迁移一次做对，是『糟一个下午』和『糟两个下午』的区别。

时间线：Gemini CLI 免费额度是怎么一步步收紧的

停服是渐进的，看清这个次序就明白你的配置为什么是在那个时点坏的。

如果你的 CLI 是在 6 月中旬前后坏的，原因就在这。而如果它还在靠一个旧 key 运转，那要盯着的就是 September 那一行。

Google 为什么结束免费登录

修终端不需要这段背景，但它能解释为什么这不是一次你能干等它过去的临时中断。三股力量对齐了。

第一，成本。免费 OAuth 登录把真实的模型推理交给了任何有 Google 账号的人，而编码 agent 极耗 token：一次很长的会话烧掉的 token 可能比一个月的聊天还多。3 月 18 日的服务更新在加上『more robust detection for policy-violating use cases (e.g. using Gemini CLI OAuth with third-party software)』时，把没明说的那部分说破了。人们把免费登录接进了它从没打算供能的脚本和封装里，而免费额度在拿 Google 的钱补贴这件事。

第二，产品收拢。在 I/O 2026 上，Google 把它的开发者工具收进了 Antigravity 品牌之下。Antigravity CLI、桌面应用和 IDE 那条线如今共享一套架构。开源的 Gemini CLI 塞不进这条漏斗，于是个人登录被引流到 Google 真正想做大的那个产品，而 CLI 被留回它起初的定位——一个面向 API key 和企业的工具。

第三，滥用的经济学。挂在个人账号上的免费凭证是世上最容易被薅的东西。把个人用户迁到带计费的 key 上（或迁到 Antigravity 的托管登录上），就给了 Google 每个请求的一个调用方身份，这也正是那项单独的 9 月 Standard key 淘汰存在的同一个理由。

对你配置的结论是：这是结构性的，不是一次小抖动。把 API key 认证当成永久状态来规划，而不是等免费额度回来之前的权宜之计。它不会回来了。

免费登录没了之后：现在就管用的替代方案

如果换到付费 Google key 不是你想要的，这里是现实可选的方案，按需要的持续维护量从少到多排。

1. ofox.ai。 一个 key 说 Gemini 协议（https://api.ofox.ai/gemini），并通过一个 OpenAI 兼容端点同时触达 GPT、Claude、Qwen、DeepSeek 以及 100 多个模型。不用 Google Cloud 项目，不用钻计费档位的迷宫，不用管 9 月的密钥迁移，某家厂商降级时还能跨厂商故障转移。最适合你想要 Gemini CLI 工作流、又不想被绑在某一家厂商的个人政策上。配置就是你给 Google 自家 key 用的那份 JSON 文件或环境变量，切换成本只是一行。
2. Antigravity CLI。 Google 官方给个人和 Pro/Ultra 登录定的归宿。它是一个闭源 Go 二进制，带异步后台 agent，和 Antigravity 2.0 桌面应用共享架构。最适合你明确就想要 Google 现在力挺的免费或 Pro 个人通道、又不介意换工具。要注意它是另一个产品，不是无缝替换：你现有的 gemini 脚本和别名不会原样迁过去。
3. Vertex AI（Gemini）。 同样的模型，由你 Cloud 项目的计费和 IAM 管，而不是一个 Google 随时能重新归类的个人账号。最适合你已经跑在 Google Cloud 上、又想要企业级管控。配置成本更高（项目、服务账号、角色），但在这几个里最持久，因为它没有任何一处依赖个人登录档位。
4. OpenRouter 或类似网关。 另一个多厂商选项。单请求比专用网关慢，加价也一层层叠上来，但作为对比点值得知道。想知道隐藏成本落在哪，见 OpenRouter 老实评测。

要看在不给每个工具单独理计费的前提下跑多个助手的全景，多 CLI 配置指南讲了怎么把 Gemini CLI 和 Codex、Claude Code 一起管，而降本手册讲了脱离免费额度后怎么把付费账单压下来。

怎么盯住你的 Gemini CLI 认证和额度

盯住三样东西，好让下一次改动别再打你个措手不及。

你的实时速率限制。 Google 不再在文档里印出确切的免费额度每分钟、每天请求数了，它把这些搬到了实时的 AI Studio 速率限制面板。去那里看你的 key 今天到底允许多少，别看某篇博客的表格。

你的花费上限。 如果你开通了计费，盯住这个上限。上限设得太低会悄悄把你打回 limit: 0 的境地，看起来跟最初那个 bug 一模一样。

你的 key 类型。 9 月之前，确认你的 key 是 auth key 或受限的 Standard key。一个不受限的 Standard key 就是一次已排期的中断，只等一个日期到来。

如果你想要完整的配置参考而不只是恢复路径，完整的 Gemini CLI 配置指南更深入地讲了 settings 文件和端点选项。

登录错误指向你的认证方式。limit: 0 错误指向你的计费。它们在终端里看着一样，需要的却是相反的修法。

FAQ

2026 年 6 月 18 日之后 Gemini CLI 是不是废了？ 没有。开源二进制仍是 Apache-2.0，仍在发版（v0.49.0 于 6 月 25 日发布），也照样能跑。结束的是免费个人登录：面向个人的 Code Assist 那条『用 Google 账号登录』通道，加上 AI Pro 和 Ultra 登录。Google 的原话是 CLI『will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys』。配一个 key，同一个工具照常工作。

为什么它报『This client is no longer supported for Gemini Code Assist for individuals』？ 你在用已停用的免费个人账号流程登录。浏览器那步报告成功，但换取 token 在服务端被拒，所以重装永远没用。把认证从 Google 登录换成 API key。

怎么从 Google 登录切到 API key？ 在 aistudio.google.com/apikey 建一个 key 并开通计费，然后 export GEMINI_API_KEY=your_key 并运行 gemini。想要菜单，就在 CLI 里运行 /auth 选 API key 那一项。如果 GEMINI_API_KEY 和 GOOGLE_API_KEY 都设了，GOOGLE_API_KEY 胜出。

加了 key 后为什么还是报 429『limit: 0』？ 你的 key 在 Free Tier 上、背后没有付费额度，而 Google One AI Pro 订阅不会自动配上那份额度。在 AI Studio 开通计费，关联一个 Cloud Billing 账户，并设一个真实的花费上限（不是 $0）。这样 key 就进入付费 Tier 1。

我的 key 会在 2026 年 9 月失效吗？ 有可能，如果它是一个不受限的 Standard key。Google 从 2026 年 6 月 19 日起开始拒绝不受限的 Standard key，并计划在 9 月拒绝所有 Standard key，改用绑定 Cloud 服务账号的 auth key。现在建一个新 key，或给现有的加上明确限制。

我能给 Gemini CLI 保留任何免费额度吗？ AI Studio key 上针对 Flash 和 Flash-Lite 系列仍有免费额度，这跟被砍掉的登录是分开的。每个模型精确的速率限制已不在文档里公布，它们在 AI Studio 面板里。把免费 key 的额度当作尽力而为，需要稳定就开通计费。

Gemini CLI 和 Antigravity CLI 有什么区别？ Gemini CLI 是你用 npm 安装、用 API key 驱动的现成开源 Node 工具。Antigravity CLI 是 Google 定为个人和 Pro/Ultra 登录归宿的新的闭源 Go 二进制。想保留现有脚本和配置就留在 Gemini CLI；如果你一直只用免费登录、又想要 Google 托管的个人通道，就转 Antigravity。

企业访问还能用吗？ 能。持有 Gemini Code Assist Standard 或 Enterprise 许可、或使用 Google Cloud 的组织，访问不受影响，用 GOOGLE_GENAI_USE_VERTEXAI 的 Vertex AI 也照常工作。6 月 18 日只针对个人登录。

参考信息来源

• Google Developers Blog，《An important update: Transitioning Gemini CLI to Antigravity CLI》：https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ （2026-07-07 核实）。确认了免费、AI Pro、Ultra 登录的 2026 年 6 月 18 日截止，以及付费 Gemini、Vertex key 和 Code Assist 许可不受影响。
• Gemini CLI 仓库 Discussion #27274（官方转向通知）和 #28017（个人账号截止确认）：https://github.com/google-gemini/gemini-cli/discussions/27274
• Gemini CLI 仓库 Discussion #22970，发布于 2026 年 3 月 18 日、限制 3 月 25 日生效（免费 OAuth 限制到 Flash，建议付费 key）：https://github.com/google-gemini/gemini-cli/discussions/22970
• GitHub issue #28229，《OAuth login fails for Google AI Pro users》（v0.49.0，确切的『no longer supported』字符串）：https://github.com/google-gemini/gemini-cli/issues/28229
• GitHub issue #22486 和 #24396，limit: 0 与 429 额度坑及计费修复：https://github.com/google-gemini/gemini-cli/issues/24396
• Google AI for Developers，《Using Gemini API keys》：https://ai.google.dev/gemini-api/docs/api-key （2026-07-07 核实）。记录了 GEMINI_API_KEY 和 GOOGLE_API_KEY 的优先级以及 aistudio.google.com/apikey 的创建流程。
• Google Gemini API 定价：https://ai.google.dev/pricing （2026-07-07 核实）。模型表里每 100 万 token 价格的来源。
• Google Gemini API 速率限制：https://ai.google.dev/gemini-api/docs/rate-limits （2026-07-07 核实）。档位结构、429 RESOURCE_EXHAUSTED，以及限制现已搬到 AI Studio 面板的说明。
• ofox.ai Gemini CLI 集成文档：https://ofox.io/docs/integrations/gemini-cli （2026-07-07 核实）。https://api.ofox.ai/gemini 端点、GEMINI_API_KEY 环境变量和 settings.json 字段。