返回指南
编码代理·2026年9月21日·阅读约 9 分钟

Gemini CLI 配额:如今从何而来,以及达到上限后该怎么办

Gemini CLI 的配额问题在 2026 年 6 月 18 日发生了变化,而 Google 自己的四个页面仍在回答旧问题——本文说明您实际使用的是哪条路径,以及每种选择的成本。

最后审核于 。

Gemini CLI 现在的配额来自付费关系:Gemini Code Assist 许可证,Google 将 Standard 限制为每位用户每天 1,500 次请求,将 Enterprise 限制为 2,000 次;或者使用按量计费的密钥——Gemini API 密钥或 Gemini Enterprise Agent Platform 密钥——Google 的速率限制页面完全没有公布每日请求数,只有需要在 AI Studio 中查看的每模型限制。大多数答案仍在引用的来源——在免费层使用个人 Google 账户登录、Google AI Pro 或 Google AI Ultra——已于 2026 年 6 月 18 日停止向 Gemini CLI 提供服务。

正是那个日期,让这个问题比看起来更难。2026 年 9 月 21 日从 main 分支获取的 Google 自己的仓库 README 仍然宣传 “免费层:使用个人 Google 账户时,每分钟 60 次请求、每天 1,000 次请求”。这一错误尚未被任何人纠正,而这正是大多数第三方文章正在照搬的数字。

今天你的 Gemini CLI 配额来自哪里

身份验证路径每日额度2026 年 9 月 21 日的状态
使用 Google 登录——Code Assist for individuals、Google AI Pro、Google AI Ultra原先为 1,000 / 1,500 / 2,000 次请求已于 2026 年 6 月 18 日停止提供服务
使用 Google 登录——Code Assist Standard 许可证每位用户每天 1,500 次请求在线
使用 Google 登录——Code Assist Enterprise 许可证每位用户每天 2,000 次请求在线
Gemini API 密钥按量计费;Google 的速率限制页面未公布每日请求数,只能在 AI Studio 中查看每模型限制付费密钥可用;未付费密钥尚未确定(见下文)
Gemini Enterprise Agent Platform 密钥(原 Vertex AI)Express mode 为 Gemini 3.x 预览模型公布每分钟“Dynamic”请求数可用;express mode 对新 Google Cloud 用户免费 90 天

两个第一方来源确定了截止时间。Google 于 2026 年 5 月 19 日发布的公告称:“2026 年 6 月 18 日,Gemini CLI 和 Gemini Code Assist IDE 扩展将停止为 Google AI Pro 和 Ultra 用户提供请求服务,也将停止为使用 Gemini Code Assist for individuals 免费使用它的用户提供请求服务。”而弃用页面的页脚注明最后更新于 2026-09-02:“这同样适用于 Gemini CLI 的使用。作为弃用的一部分,你将不再能使用 Login with Google 选项访问 IDE 扩展或 Gemini CLI。”其常见问题直接回答了 Standard/Enterprise 的问题——这些订阅不受影响。

实时数据来自 Google 的 Code Assist 配额页面(最后更新于 2026-09-18),而页面上的机制比数字本身更重要。代理模式和 Gemini CLI 的配额是合并计算的;一次提示可能产生多个模型请求;每日限制“汇总计算与任何模型版本或系列的所有交互”;达到上限后,“在配额重置前,无法通过这些界面向任何模型发出更多请求”。因此,在这条路径上切换到较小模型并不会增加剩余空间,而且 1,500 这个数字并不等于 1,500 次提示。Google 没有说明重置发生在何时——你可能读到的太平洋时间午夜规则是 Gemini API 的文档内容,并非许可证路径;将其移植过来只是猜测。

同一页面还有一个陷阱:“每秒 2 次请求”、每天 6,000 次和每天 960 次这些行,属于用于代码补全和 Cloud Assist 面板聊天的 Gemini for Google Cloud 配额。它们不是 CLI 代理模式的预算;即使两个数字都真实存在,将其中一个数字直接套用过来仍然是错误的。

四个会给出错误数字的 Google 官方页面

页面它仍然写着什么为什么会误导
仓库 README“免费层:使用个人 Google 账户时,每分钟 60 次请求、每天 1,000 次请求”描述的是已于 2026-06-18 关闭的登录路径;它链接到 Code Assist 配额页面,而该页面已不再支持这一说法
geminicli.com 配额文档一个表格列出 Code Assist (Individual) 1,000、Google AI Pro 1,500、Google AI Ultra 2,000、Gemini API key 免费层 250其页脚写着“最后更新:2026 年 6 月 18 日”——在切换当天冻结
geminicli.com 方案页面将 Free、Google AI Pro 和 Google AI Ultra 包装为运行 Gemini CLI 的方式它正好位于一条全站横幅下方,而横幅称这些用户已被迁出 CLI
codeassist.google“免费使用”、Gemini 2.5“Gemini 3 即将推出”、每天 6,000 次代码请求早于 Gemini 3 系列和弃用公告;6,000 这一数字属于另一套配额系统

geminicli.com 不是域名抢注者搭建的网站——它是仓库自己声明的主页,这正是它危险的原因。应因其内容过时而弃用它,而不是因为它是非官方网站。其横幅目前与正文自相矛盾:“未付费层和 Google One 用户:Gemini CLI 已于 2026 年 6 月 18 日被 Antigravity CLI 替代。”当横幅和表格不一致时,应以横幅和带日期的弃用页面所提供的较新信息为准。

没有任何第一方页面回答的一个问题。在 API 密钥路径上,Google 5 月 19 日的博客称 CLI 仍可通过付费 API 密钥访问。维护者的6 月 18 日关闭公告只补充说“拥有 Gemini Code Assist 许可证并使用 API 密钥身份验证的企业用户完全不受影响”——这句话的主语是企业用户,因此并未说明未付费密钥仍然可用。6 月 18 日之后没有任何带日期的内容讨论未付费密钥,而每天 250 次请求的未付费额度仅存在于冻结的配额文档中。应将未付费密钥视为未经验证,而不是纳入预算。

我使用的是哪条路径,限制是什么样的?

在更改任何内容之前,先确认计费关系。Gemini CLI 将 /auth 记录为“可让你更改身份验证方法的对话框”,并将 /stats model 记录为显示“特定模型的使用统计信息,包括 token 数量和配额信息”;配额文档还补充说,会话结束退出时也会显示使用情况摘要。这两项都是截至 2026 年 9 月 21 日阅读到的文档行为,并非本页测试过的行为。

两种不同的失败会产生相似的中断,但补救方法不同。配额触发时,文档说明会提供一个明确命名的选择:“遇到该限制时,你将可以选择切换到 Gemini 2.5 Pro、升级以获得更高限制,或停止。系统还会告知你使用限制何时重置”;当 2.5 Pro 达到限制时,还会进一步提示回退到 Gemini 2.5 Flash。容量错误则是模型过载:文档说明 CLI 会询问你是否要继续尝试 Gemini 3 Pro,或回退到 Gemini 2.5 Pro,并且“继续尝试”会使用指数退避。等待可以解决第二种情况;第一种情况只有重置、许可证或不同的计费路径才能解决。

还有一种无需询问就会发生的回退。文档说明,当 CLI 检测到默认“pro”模型受到速率限制时,会“自动切换到当前会话的‘flash’模型”;使用 gemini-2.5-flash-lite 的内部工具调用在配额耗尽时会“静默回退”到其他模型,但不会更改已配置的模型。对于按量计费的密钥,这不仅影响输出,也影响账单:实际回答的模型不一定是你选择的模型。

达到限制时的四种选择及其各自成本

项目公布价格来源,核查日期:2026 年 9 月 21 日
Code Assist Standard,月度承诺每个许可证每月 $22.80Google Cloud 定价(也列为每小时 $0.031232877)
Code Assist Standard,12 个月承诺每个许可证每月 $19.00同一张表;所有订阅按月计费
Code Assist Enterprise,月度承诺每个许可证每月 $54.00其功能说明明确列出提高 Gemini CLI 每日限制的版本
Code Assist Enterprise,12 个月承诺每个许可证每月 $45.00同一张表
Gemini API,gemini-3.1-pro-preview每 1M 输入 $2.00 / 输出 $12.00(提示 ≤200k);免费层“不可用”Gemini API 定价,页面最后更新于 2026-09-16
Gemini API,gemini-3.8-flash截至 2026 年 12 月 31 日输入 $0.75 / 输出 $3.75;自 2027 年 1 月 1 日起为 $1.50 / $7.50同一页面;相同的日期阶梯也适用于 3.7 和 3.6 Flash
Gemini API,gemini-3.5-flash每 1M 输入 $1.50 / 输出 $9.00,统一价格同一页面——此模型没有入门折扣
Gemini API,gemini-2.5-pro / gemini-2.5-flash(提示 ≤200k)$1.25 / $10.00,以及每 1M $0.30 / $2.50同一页面;这些是 CLI 文档中列出的回退模型

Google Cloud 定价表本身的表头是“Gemini 许可证类型 / 许可证费用(月度承诺)/ 许可证费用(12 个月承诺)”,并未在数字旁印出“每位用户”字样——配额明确是每位用户每天,因此在确认你自己的订单中的席位条款之前,应将费用理解为每个许可证的费用。

第一种选择,等待。当中断由容量错误而非达到配额上限引起时,等待是免费且正确的做法。第二种选择,购买许可证。这是唯一能提高登录路径每日请求额度的方式,也是 Google 为 Gemini CLI 记录的方式。第三种选择,改用按量计费的密钥。这会移除每日请求上限,改为按 token 计费并设置支出上限:Google 的速率限制页面公布了基于支出的限制,即第 1 至第 3 层级在每个滚动十分钟窗口内分别为 $10、$50 和 $200;超出时返回 429 RESOURCE_EXHAUSTED,并指出限制“不作保证”,各模型的具体数值仅在 AI Studio 中可见。计费页面(最后更新于 2026-09-20)还记录了 Gemini API 用量计费从后付费转为预付费,最低需购买 $5 的额度。同样的改用方式在 Agent Platform 上另有免费试用期:快捷模式(最后更新于 2026-09-18)允许新的 Google Cloud 用户在无需提供账单信息的情况下试用最多 90 天,并说明现有 Cloud 用户无法享受这 90 天免费层,启用计费后该免费层也会被移除。

换四个,换客户端。Google 自己推荐的是 Antigravity CLI,在采用它之前,有必要了解这会在灵活性方面付出什么代价:Antigravity 的计划文档说明,“目前不支持:自带密钥或自带端点以获得额外速率限制”;不使用 AI Pro 或 Ultra 的用户只被承诺“有意义的配额,每周刷新”和“每周速率限制”,该页面没有列出具体数字;付费配额则“每五小时刷新一次”——在 Pro 上是“直到达到每周限制”——Google 表示这些限制与“代理完成的工作量相关”,而不是与提示词数量相关。本页面未安装 Antigravity CLI 二进制文件,也未声称进行速度或兼容性比较。

什么不会提高 Gemini CLI 配额:每月 $4.99 的 Google AI Plus 订阅或每月 $19.99 的 Google AI Pro 订阅(gemini.google/subscriptions,检查于 2026 年 9 月 21 日)。自 2026 年 6 月 18 日起,这些订阅购买的是 Gemini 应用和 Antigravity 的使用额度。$100 和 $200 的 AI Ultra 档位来自 Google 的2026 年 5 月 19 日公告,而不是订阅页面,并且同样不能提高 Gemini CLI 配额。

自定义端点能做什么、不能做什么

Gemini CLI 确实记录了基础 URL 覆盖功能,但它比表面看起来更受限。GOOGLE_GEMINI_BASE_URL会在“使用 gemini-api-key 身份验证时”覆盖 Gemini API 请求的基础 URL;除非指向 localhost,否则必须使用 HTTPS;它还有一个单独的同级变量GOOGLE_VERTEX_BASE_URL用于 Vertex 路径——Google 后来已将其重命名为 Gemini Enterprise Agent Platform,而 CLI 仍保留旧变量名。在已发布的 v0.60.0 源代码中,仅设置该变量就会选择一种任何已发布文档都未提及的身份验证类型(GATEWAY = 'gateway'),其密钥会回退为空字符串。应将其视为代码行为,而不是受支持的功能;它可能在没有变更日志条目的情况下发生变化。

由此可见有三个边界,而它们决定了这是否根本算得上配额答案。基础 URL 作为httpOptions.baseUrl传入 GoogleGenAI SDK,因此每个请求仍然使用 Google 的原生协议,默认通过x-goog-api-key标头进行身份验证;身份验证枚举中没有兼容 OpenAI 或 Anthropic 的提供商。Kunavo 的 API 仅兼容 OpenAI 和 Anthropic Messages——本次提交中的路由清单包含/v1/chat/completions、/v1/responses和/v1/messages,没有 Gemini 原生的generateContent路径——因此它不是该变量的即插即用目标,本页面不应作出相反的表述。这是根据协议形态和路由清单得出的推断,而非运行时测试结果。此外,该覆盖功能仅存在于 API 密钥路径,因此指向任何网关都不会提高、延长或重置 Google 侧的每日限额;它会将你切换到另一种计费关系,之后的配额取决于该账户拥有的配额。

因此,关于 Kunavo 选项,诚实的说法是:换客户端,而不是换端点。Gemini CLI 与 Claude Code比较这两个代理,Gemini API 密钥文档则介绍如何通过兼容 OpenAI 的路径访问 Gemini 模型。Kunavo 尚未对这些客户端中的任何一个与其端点进行运行时测试;已发布的设置指南是配置参考,而不是兼容性测试。

更换客户端后的示例估算

这些是用于说明的令牌算术,不是实测任务成本,也不是账单上限。假设一次代理会话发送300,000 个未缓存输入令牌并接收20,000 个输出令牌。费率是实时的Kunavo 目录每百万令牌价格;请将其与上表中的 Google 列表价格进行比较。

模型每 1M 个令牌的输入 / 输出估算:一次会话估算:十次会话
Gemini 3.1 Pro$0.70 / $4.20$0.294$2.94
Gemini 3.8 Flash$0.525 / $2.625$0.210$2.10
Gemini 2.5 Flash$0.09 / $0.75$0.042$0.42

不要试图在这两个世界之间进行换算。Code Assist 许可证按每位用户每天的请求数计量,令牌密钥按令牌计量,而 Google 自己表示一次提示可能产生多个模型请求——因此每月 $22.80 与每次会话数值之间不存在换算率。唯一诚实的比较方式,是在两者上运行相同的限定任务,并读取各自账户的记录。Kunavo 目录金额是计费下限而不是上限:上游报告其费用后,账单取目录成本与上游成本乘以适用加价两者中的较大值。缓存费用和外部工具不包含在本示例中,最低充值额为预付余额中的$10——这是资金最低要求,不是任务费用或订阅费。请参阅计费详情。

哪种路由胜出时

方式适用场景你放弃的内容
Code Assist 许可证,直接来自 Google你使用的是 Workspace 或 Cloud 账户,希望采用登录路径、Google 自己的后端功能以及可预测的按席位费用代理模式和 CLI 共享的严格每日请求上限,且该路径不提供基础 URL 覆盖功能
Gemini API 密钥,直接来自 Google你希望使用某一家供应商的模型及其自有的上下文缓存和批量定价,并采用按量计费而非每日上限滚动十分钟窗口内的消费上限、只能在 AI Studio 中查看的逐模型限制,以及多个 Flash ID 将于 2027 年 1 月 1 日进行价格调整
OpenAI 兼容网关你会在不同供应商之间切换模型,并希望使用一个密钥和一个余额无法从 Gemini CLI 本身访问——这就是上面的协议边界——因此意味着运行其他客户端
消费者订阅你适合按固定费率使用 Gemini 应用或 Antigravity自 2026 年 6 月 18 日起,它完全不会购买 Gemini CLI 配额;Antigravity 的计划页面没有列出数值限制,也没有记录自带密钥或自带端点以获得额外速率限制
本地模型小规模或私密工作,无按请求收费与托管前沿模型相比存在能力差距,需要运行模型的硬件,并且没有进入 Gemini CLI 自身配额系统的路径

如果你是要将工作转移到其他代理,而不是转移到其他 Google 计划,请从OpenCode 集成或Cline 设置开始,在模型目录中比较费率,准备为密钥充值时创建 Kunavo 账户。如需了解更全面的 Gemini 价格信息,请参阅Gemini API 定价;如需了解另一个代理中同样的免费层级消失问题,请参阅Codex 使用限制。

常见问题

2026 年 Gemini CLI 的配额是多少?

Google 的 Gemini CLI 实时配额表列出两个数值:Gemini Code Assist Standard 许可证每位用户每天最多 1,500 次请求,Enterprise 为 2,000 次。该页面已不再有个人用户一行,其中也没有出现“individual”一词(docs.cloud.google.com/gemini/docs/quotas,页面最后更新于 2026-09-18,核查于 2026 年 9 月 21 日)。其他实时路径是 Gemini API 密钥或 Gemini Enterprise Agent Platform 密钥,按 token 和项目计量,而不是按 CLI 的已公布每日请求数计量。任何声称个人 Google 账户每天可请求 1,000 次的人,引用的都是仓库 README;该 README 仍为一种登录路径宣传这一额度,但该路径已于 2026 年 6 月 18 日停止向消费者账户提供服务。

Gemini CLI 现在还有免费层吗?

个人 Google 账户没有。Google 的弃用通知说明,自 2026 年 6 月 18 日起,Gemini Code Assist for individuals、Google AI Pro 和 Google AI Ultra 层级停止提供服务;这同样适用于 Gemini CLI,并且“你不再能使用 Login with Google 选项访问 IDE 扩展或 Gemini CLI”(developers.google.com,页面最后更新于 2026-09-02)。未付费的 Gemini API 密钥是否仍能在 CLI 中使用,没有任何第一方页面给出答案:Google 于 2026 年 5 月 19 日的公告称,CLI“仍可通过付费 Gemini 和 Gemini Enterprise Agent Platform API 密钥访问”;维护者于 6 月 18 日发布的关闭公告(github.com/google-gemini/gemini-cli discussion 28017)只说“拥有 Gemini Code Assist 许可证并使用 API 密钥身份验证的企业用户完全不受影响”——这句话的主语是企业用户,并不是在说明未付费密钥的情况。本页没有进行能够解决这一问题的测试,因此不要按未付费密钥可以正常工作来编制预算。

如何查看我的 Gemini CLI 配额?

Gemini CLI 为此记录了两个斜杠命令。'/stats model' 会显示特定模型的使用统计信息,包括 token 数量和配额信息;配额文档还补充说明,会话结束退出时也会显示模型使用情况摘要。'/auth' 会打开一个对话框,让你更改身份验证方法;你可以借此确认自己实际使用的是哪种计费关系——许可证、API 密钥,还是一种已不再为你的账户提供服务的登录方式。这两项都是 geminicli.com 上记录的行为(截至 2026 年 9 月 21 日阅读),并非本页经过运行时测试的行为。

如何提高我的 Gemini CLI 配额?

有三种付费方式,它们购买的是不同的内容。Gemini Code Assist Standard 许可证在月度承诺下的标价为每个许可证每月 $22.80,在 12 个月承诺下为每个许可证每月 $19.00,并对应每位用户每天 1,500 次请求的额度。Enterprise 在相同条款下的标价分别为 $54.00 和 $45.00;Google 自己对其功能的说明是“增加智能体使用量:提高每日使用上限,让你使用 Gemini Code Assist 智能体模式和 Gemini CLI 完成更多工作”(cloud.google.com/products/gemini/pricing,核查于 2026 年 9 月 21 日)。按量计费的 Gemini API 密钥会将每日请求上限替换为按 token 计费和基于支出的上限。Google AI Plus 或 Google AI Pro 消费者订阅无法提高 Gemini CLI 配额:自 2026 年 6 月 18 日起,这些订阅适用于 Gemini 应用和 Antigravity,而不是 Gemini CLI。

为什么我用 Google 登录后 Gemini CLI 停止工作?

因为资格由 Google 端决定,而不是由你的客户端版本决定。已发布的 v0.60.0 源代码注释说明,对于免费层,“资格由 Code Assist 服务器响应决定”,并且 CLI“会显示服务器针对 FREE 层返回的无资格原因”。因此,即使账户会被服务器拒绝,最新二进制文件仍会在其身份验证对话框中提供“Sign in with Google”,这就是为什么失败看起来像客户端错误,而不是政策变更。本页没有记录消费者账户今天实际看到的确切拒绝文本。

我可以让 Gemini CLI 指向其他 API 端点或网关吗?

只能指向 Gemini 原生端点,而且仅限 API 密钥路径。Gemini CLI 文档说明,使用 gemini-api-key 身份验证时,GOOGLE_GEMINI_BASE_URL 会覆盖 Gemini API 请求的基本 URL;除非指向 localhost,否则仅支持 HTTPS;Vertex(现称 Gemini Enterprise Agent Platform)则有单独的 GOOGLE_VERTEX_BASE_URL。在已发布的 v0.60.0 源代码中,该 URL 作为 httpOptions.baseUrl 传入 GoogleGenAI SDK,因此每个请求仍使用 Google 原生协议,默认通过 x-goog-api-key 标头进行身份验证,身份验证枚举中也没有 OpenAI 兼容或 Anthropic 提供商。Kunavo 的 API 兼容 OpenAI,并支持 Anthropic Messages,但没有 Gemini 原生的 generateContent 路由,因此它不是该变量可以直接替换的目标——诚实的做法是更换客户端,而不是端点。还要注意,该覆盖项仅存在于 API 密钥路径,因此它永远不会提高、延长或重置 Google 端的每日额度。

检查于 2026 年 9 月 21 日:Google 的弃用通知、Code Assist 配额页面、Google Cloud 定价表、Gemini API 定价、计费和速率限制页面、geminicli.com 文档库及其配额页面、Antigravity 计划页面、代码仓库 README、GitHub 仓库 API 以及 npm 注册表(稳定版 0.60.0,发布于 2026 年 9 月 15 日)。未检查:未安装 Gemini CLI 或 Antigravity CLI 二进制文件,未登录 Google 账户,也未将代理指向 CLI——协议边界依据已发布的 v0.60.0 源代码和 Kunavo 自有的路由清单读取。Kunavo 令牌费率来自实时目录,本页的每个美元数字都是用于说明的令牌算术。