2026 年 6 月 18 日，Google 并没有杀死 Gemini CLI——杀死的只是那扇“用 Google 账号登录”的免费大门。工具本身还活着：二进制依旧是 Apache-2.0 许可证，维护也没停（v0.49.0 就在 6 月 25 日发布的），配上一个 API key 就能照常跑。 如果你正对着终端的报错 “This client is no longer supported for Gemini Code Assist for individuals” 头疼，先别急着卸载重装。这不是安装包坏了，是认证方式变了——Google 不再接受个人账号的免费登录。解决方案也很直接：别再点那个“用 Google 账号登录”的按钮，换成一个开通了计费的 API key 就行。不过要留个心眼：2026 年 9 月还有第二道坎等着你，到时候不受限的 Standard key 也会被停用。所以最好一次就把 key 配好，别配两遍。下面六个修复方案，从能蹭免费额度的临时补丁，一路排到生产级的路由方案，总有一个能对上你的情况。 ## 你的 Gemini CLI 真坏了吗？30 秒诊断 先别急着折腾。按以下三步走，大多数报错“CLI 坏了”的人，其实离解决问题只差一个环境变量。 | 步骤 | 检查什么 | 说明 | | --- | --- | --- | | 1 | 报错文字 | “This client is no longer supported for Gemini Code Assist for individuals”——免费 OAuth 登录没了。“Quota exceeded … limit: 0” 或 `429 RESOURCE_EXHAUSTED`——说明你的 key 没有付费额度。 | | 2 | 你用的是哪种认证 | 运行 `gemini` 观察启动情况。如果它打开浏览器让你用 Google 登录，那你用的就是那条已停用的个人通道。如果它读的是环境变量，那就是 API key 认证。 | | 3 | `echo $GEMINI_API_KEY` | 如果输出为空、并且又弹出了浏览器登录窗口，那说明你从来没脱离过免费额度。问题就出在这儿。 | 如果第 1 步显示 “no longer supported” 消息，直接跳到修复 1。如果显示 429 或 `limit: 0`，说明你有 key 但没额度，去看修复 3。本指南剩余的内容，都是为了让你这次迁移一次做对，免得撞上 9 月的密钥截止点还得重来。 ## 什么时候原地修，什么时候干脆换工具 这个判断能帮你省下不少在错误层面上瞎折腾的时间。 ### 原地修 Gemini CLI（修复 1 到 5），如果： - 你已经有调用 `gemini` 的脚本、别名或 CI 流程，不想重写它们。 - 你不介意按 token 付费，就想用你已经熟悉的那个工具。 - 你需要 Vertex AI 或 Code Assist 许可通道——这两者都没被 6 月 18 日的改动波及。 ### 换成 Antigra vity CLI，如果： - 你一直只用免费的个人登录，不想开通计费，又希望走 Google 正在积极引导个人用户去的那条路。 - 你想要更新的异步后台 agent 工作流，并且不介意它是一个独立的闭源二进制。 ### 走网关中转（修复 6），如果： - 你想用一个 key 打通 Gemini、GPT、Claude 等等，而不用操心 Google Cloud 项目、计费档位和 9 月的密钥迁移。 - 你在做面向用户的东西，不希望某一家厂商的政策改动再次把你搞挂。 **收手规则。** 如果你已经重跑了三遍 Google 登录、清空了 `~/.gemini`、重装了 CLI，结果还是看到 “no longer supported”，那就别再折腾了。重装修不了服务端的认证策略。换取 token 的动作是被 Google 故意拒绝的。换成 API key，这个死循环就结束了。 ## 6 月 18 日到底改了什么 Google 在 5 月 19 日的 I/O 2026 上宣布了这件事，并在 Developers Blog 上发表了题为《An important update: Transitioning Gemini CLI to Antigra vity 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 死了”的说法，其实理解错了。三条独立的认证通道，对应三种不同的结局： | 认证通道 | 2026 年 6 月 18 日后的状态 | 该怎么办 | | --- | --- | --- | | OAuth “用 Google 账号登录”免费额度（面向个人的 Code Assist、AI Pro、Ultra） | 已停服。请求不再受理。 | 换成 API key，或换成 Antigra vity CLI。 | | 来自 AI Studio 的 Gemini API key | 能用。Flash 模型仍有免费额度，付费档完整支持。 | 设 `GEMINI_API_KEY`，并开通计费获取稳定额度。 | | 付费 Gemini / Vertex “Gemini Enterprise Agent Platform” key，或 Code Assist Standard/Enterprise 许可 | 明确不受影响。 | 继续用，啥都不用做。 | 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 a vailable to the community as an Apache 2.0 licensed repository with no changes”。所以，当有人劝你放弃 Gemini CLI 配置时，他们其实把“免费登录结束了”和“工具结束了”混为一谈了。只有前者是真的。 这件事也不是凭空冒出来的。早在 2026 年 3 月 18 日，Google 就发过一条服务更新（Discussion #22970），限制了免费 OAuth 用户只能使用 Flash 档模型，并增加了滥用检测功能。同时建议大家“use Gemini CLI with your own paid API key from AI Studio or Vertex AI”。6 月 18 日就是那次 3 月更新所预告的硬截止日期。 ## 看懂报错：每一条各是什么意思 四种报错特征覆盖了几乎所有反馈。把你的报错对到对应那一行，就知道该用哪个修复。 | 你看到的报错 | 真正原因 | 修复 | | --- | --- | --- | | `This client is no longer supported for Gemini Code Assist for individuals. To continue using Gemini, please migrate to the Antigra vity suite of products.` | 你还在用已停用的免费 OAuth 登录。浏览器那步成功了，但换取 token 被拒。 | 修复 1（换成 API key） | | `You must be a named user on your organization's Gemini Code Assist Standard edition subscription ...`（403） | 个人账号撞上了仅限组织的授权门槛。 | 修复 1 或修复 5（许可/Vertex） | | `Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 0` 以及 `TerminalQuotaError: You ha ve exhausted your daily quota on this model.` | key 在 Free Tier 上、额度被清零，背后没有付费配额。 | 修复 3（开通计费） | | 付费订阅用户遇到 `429: rate limit exceeded` 且 `limit: 0` | Google One AI Pro 订阅不会自动给你的 key 配上付费 API 额度。 | 修复 3（开通计费，设一个真实上限） | 值得记住的规律：登录错误指向的是认证方式，`limit: 0` 错误指向的是计费。它们在终端里看着很像，但需要完全不同的修法。别用开通计费去解决登录错误，也别用重新登录去解决额度错误。 ## 怎么让 Gemini CLI 继续跑起来（各档位的修复） 按“免费、五分钟搞定”到“生产级路由”排序，挑对上你情况的那一档。 ### 免费 / 个人档 #### 修复 1：从 Google 登录换成 AI Studio API key 这是核心动作，能直接解决“no longer supported”消息。在 aistudio.google.com/apikey 建一个 key，然后： ```bash export GEMINI_API_KEY="your_ai_studio_key" gemini "say hi" ``` 能收到正常回复，就说明你恢复营业了。如果你想确认 CLI 真的在用这个 key、而不是悄悄回退到缓存的登录，可以在启动时看那行认证信息，或先把变量打印出来： ```bash 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` 被缓存了。清掉它： ```bash # 先备份，然后重置 CLI 保存的认证选择 mv ~/.gemini/settings.json ~/.gemini/settings.json.bak gemini # 会再次提示 /auth；选择 API key 选项 ``` 这也是“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（具体价格请以官方定价页为准）： | 模型 | 输入 / 1M | 输出 / 1M | 备注 | | --- | --- | --- | --- | | Gemini 3.1 Flash-Lite | $0.25 | $1.50 | 最便宜；日常改动和 shell 任务足够用 | | Gemini 3.5 Flash | $1.50 | $9.00 | 写代码的均衡默认选择 | | Gemini 3.1 Pro Preview | $2.00（prompt 不超过 200k） | $12.00 | 留给硬推理；超过 200k 价格上台阶 | 大多数终端活儿，Flash-Lite 是合适的默认选择，重度使用一天也能压在一美元以内。真要写代码就升到 Flash，只有碰上真正难的 prompt 才动用 Pro。需要提醒的是，Google 那边的模型名变得很快，把它们硬编码进脚本前，最好先去定价页核实确切的 ID。 ### 企业 / 生产档 #### 修复 5：用 Vertex AI 或 Code Assist 许可 这两条通道都没被 6 月 18 日的改动波及，所以如果你已有 Google Cloud 底盘，它们是最干净的选择。走 Vertex AI： ```bash 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 随时能重新归类的个人账号管。如果你的组织持有 Gemini Code Assist Standard 或 Enterprise 许可，CLI 和 IDE 扩展会完全无改动地继续工作——这一点在 Google 公告里直接写着。对团队来说，这通常是最不容易出问题的方案。 #### 修复 6：走一个网关中转，从此不用管 Google 的档位 如果你宁可不去打理 Cloud 项目、计费档位和 9 月的密钥迁移，就把 Gemini CLI 指向一个兼容 Gemini 协议的网关。同一个 CLI 用一个 key，不需要 Google Cloud 账号，还额外拿到故障转移和路由能力： ```json { "apiKey": "", "baseUrl": "" } ``` 或者用环境变量： ```bash export GEMINI_API_KEY="" ``` 这一个 key 同一个账号还能触达 GPT、Claude、Qwen、DeepSeek，以及模型广场里的其余模型。所以下次某一家厂商改动个人政策时，你的 CLI 不会跟着一起挂。 ## 第二堵墙：你还没撞上的 API key 截止日 修好登录不是故事的结尾，而这部分正是大多数“加个 key 就行”的指南所忽略的。Google 正在按另一套单独的时间表淘汰旧式 API key： | 日期 | 会发生什么 | | --- | --- | | June 19, 2026 | Gemini API 开始拒绝不受限的 Standard key。带明确 API 限制的 Standard key 仍可用。 | | September 2026 | Gemini API 拒绝所有 Standard key。你必须换成绑定 Cloud 服务账号的 auth key。 | 现实后果是：如果你今天翻出一个 2025 年的旧的不受限 key 来修登录，9 月你可能又得撞一次墙。现在就建一个新 key——因为新 key 默认按 auth key 发放；或者给你在用的 key 加上明确的 API 限制。把迁移一次做对，是“糟一个下午”和“糟两个下午”的区别。 ## 时间线：Gemini CLI 免费额度是怎么一步步收紧的 停服是渐进的，看清这个次序，就明白你的配置为什么是在那个时点坏的。 | 日期 | 事件 | | --- | --- | | March 18, 2026 | 发布服务更新（限制 3 月 25 日生效）：把免费 OAuth 用户限制到 Flash 档模型，增加滥用检测，建议使用付费 API key（Discussion #22970）。 | | May 19, 2026 | I/O 2026 公告：Gemini CLI 的个人/Pro/Ultra 登录转向 Antigra vity CLI（Developers Blog / Discussion #27274）。 | | June 18, 2026 | 免费、AI Pro、Ultra 登录停止受理请求。“No longer supported” 报错开始出现。 | | June 19, 2026 | 不受限的 Standard API key 开始被拒（另一项密钥安全改动）。 | | June 25, 2026 | Gemini CLI v0.49.0 发布，证实二进制仍在维护。 | | September 2026 | 计划中的所有 Standard key 截止点；需换 auth key。 | 如果你的 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 把它的开发者工具收进了 Antigra vity 品牌之下。Antigra vity CLI、桌面应用和 IDE 那条线如今共享一套架构。开源的 Gemini CLI 塞不进这条漏斗，于是个人登录被引流到 Google 真正想做大的那个产品，而 CLI 被留回它起初的定位——一个面向 API key 和企业的工具。 第三，滥用的经济学。挂在个人账号上的免费凭证是世上最容易被薅的东西。把个人用户迁到带计费的 key 上（或迁到 Antigra vity 的托管登录上），就给了 Google 每个请求的一个调用方身份——这也正是那项单独的 9 月 Standard key 淘汰存在的同一个理由。 对你配置的结论是：这是结构性的，不是一次小抖动。把 API key 认证当成永久状态来规划，而不是等免费额度回来之前的权宜之计。它不会回来了。 ## 免费登录没了之后：现在就管用的替代方案 如果换到付费 Google key 不是你想要的，这里有几个现实可选的方案，按需要的持续维护量从少到多排列。 - **网关（如修复 6）**。一个 key 说 Gemini 协议，同时用 OpenAI 兼容端点触达 GPT、Claude、Qwen、DeepSeek 以及 100 多个模型。不用 Google Cloud 项目，不用钻计费档位的迷宫，不用管 9 月的密钥迁移，某家厂商降级时还能跨厂商故障转移。最适合你想要 Gemini CLI 工作流、又不想被绑在某一家厂商的个人政策上。 - **Antigra vity CLI**。Google 官方给个人和 Pro/Ultra 登录定的归宿。它是一个闭源的 Go 二进制，带异步后台 agent，和 Antigra vity 2.0 桌面应用共享架构。最适合你明确就想要 Google 现在力挺的免费或 Pro 个人通道、又不介意换工具。但它不是无缝替换：你现有的 `gemini` 脚本和别名不会原样迁过去。 - **Vertex AI（Gemini）**。同样的模型，由你 Cloud 项目的计费和 IAM 管，而不是一个 Google 随时能重新归类的个人账号。最适合你已经跑在 Google Cloud 上、又想要企业级管控。配置成本更高（项目、服务账号、角色），但在这几个里最持久，因为它没有任何一处依赖个人登录档位。 - **OpenRouter 或类似网关**。另一个多厂商选项。单请求比专用网关慢，加价也一层层叠上来，但作为对比点值得知道。 ## 怎么盯住你的 Gemini CLI 认证和额度 盯住三样东西，好让下一次改动别再打你个措手不及。 **你的实时速率限制。** Google 不再在文档里印出确切的免费额度每分钟、每天请求数了，它把这些搬到了实时的 AI Studio 速率限制面板。去那里看你的 key 今天到底允许多少，别看某篇博客的表格。 **你的花费上限。** 如果你开通了计费，盯住这个上限。上限设得太低会悄悄把你打回 `limit: 0` 的境地，看起来跟最初那个 bug 一模一样。 **你的 key 类型。** 9 月之前，确认你的 key 是 auth key 或受限的 Standard key。一个不受限的 Standard key 就是一次已排期的中断，只等一个日期到来。 还是那句话：登录错误指向你的认证方式。`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 和 Antigra vity CLI 有什么区别？** Gemini CLI 是你用 npm 安装、用 API key 驱动的现成开源 Node 工具。Antigra vity CLI 是 Google 定为个人和 Pro/Ultra 登录归宿的新的闭源 Go 二进制。想保留现有脚本和配置就留在 Gemini CLI；如果你一直只用免费登录、又想要 Google 托管的个人通道，就转 Antigra vity。 **企业访问还能用吗？** 能。持有 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 Antigra vity CLI》：https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigra vity-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 面板的说明。 - Gemini CLI 集成文档：https://ai.google.dev/gemini-api/docs/cli（2026-07-07 核实）。`GEMINI_API_KEY` 环境变量和 settings.json 字段。