Gemini 使用量上限详解：免费档、AI Pro，以及为什么上限不是一个数字

"你已达到 Gemini 用量上限"这句话至少有三种不同的含义，取决于你在哪看到它。Gemini CLI、Gemini API 和 Google 的 AI 订阅用不同的货币计量用量——这边是请求次数、那边是速率限制、别处是"用量倍数"——而且它们之间哪个都无法干净地换算成另一个。如果你在拿它跟 Claude Code 的滚动五小时窗口或 Codex 的配额做比较，首先要理解的是：Google 不是计量一样东西；它在几个不同的钟上计量好几样东西。

免费的 Gemini CLI 档位

CLI 的免费路径是用个人 Google 账号登录。按 Google 官方的 CLI 配额文档（"Quota and pricing"，2026-09-17 查证），这条路径挂在 Gemini Code Assist（个人版）的计量表上：每用户每日最多 1,000 次模型请求，且请求跨 Gemini 模型家族按 CLI 的调度分配。付费订阅在这块表上是 Google AI Pro（每日 1,500 次）与 AI Ultra（每日 2,000 次）。用 API key 登录则是另一套：免费档每日 250 次、仅 Flash 模型。这里的数字是本文写作时文档公布的口径——这个类目的限额各家都常动，以你当前会话里 CLI 自己显示的为准。

结构上值得记住的是：这些请求限额并不属于你单独独享的一块表。 Google 的配额文档明确说明，agent 模式与 Gemini CLI 的请求配额是合并的，而且"一条 prompt 可能产生多次模型请求"（Google Cloud，"Quotas and limits"，2026-09-17 查证）。跑一整天 Agent 会话的人反映在重度时段撞到顶，与这个结构一致：计量单位是模型请求，不是你输入的 prompt 条数。

Google AI Pro 和 Ultra

付费订阅不会消除上限——它们在同一块表上抬高上限。按上面的官方数字，Pro 与 Ultra 把每日请求上限从免费的 1,000 提到 1,500 / 2,000。实际结论：升级买到的是同一套时钟上更高的天花板，而不是一个无限套餐。另外注意边界：消费者版 Gemini 订阅（网页/应用的 Workspace 类套餐）不适用于驱动 CLI 的 API 用量——Google 文档明确将两者分开。给网页版充了订阅，不等于给 CLI/API 充了值。

API 是完全不同的另一块表

如果你通过 API key 调用 Gemini——包括许多底层使用它的工具——你就在订阅池之外，面对按 token 的定价加上 API 速率限制。而且这里也不止一道闸门：Google 的 API 文档把每分钟请求数（RPM）、每分钟 token 数（TPM）、每日请求数（RPD）列为常设维度，超出其中任何一项都会触发限流错误；付费档还有基于支出的滚动窗口限制（Google AI，"Rate limits"，2026-09-17 查证）。API 返回的 "429" 可能是每分钟吞吐触顶——解法是重试/退避或升级档位——也可能是每日请求数耗尽，那就得等每日配额重置（文档注明在太平洋时间午夜）。两条不同的报错、多套不同的机制，先分辨是哪一道闸门，再决定是等待还是换路。

撞上其中任何一个时该做什么

**查工具自己的状态输出，而不是凭记忆里的数字。**这个类目的配额在每家厂商都变动频繁，六个月前某篇博客引用的数字更可能是误导而不是帮助。

**区分等待和路由。**如果拦你的是每分钟闸门，一杯咖啡的功夫就解决了。如果是每日池见底，等待就不是策略——而为了避免等待样板任务去买一个更大的订阅，是 AI 编程里最贵的习惯。那些机械的、日常的工作——脚手架、小修改、文档——本来就不该消耗最稀缺的请求配额。

**别再依赖任何单一的共享上限。**每一个免费池和付费上限，都是一份由别人掌控重置时钟的预算。

meshcode 的角度

meshcode 是一款 Mac、Windows 上的原生桌面应用，围绕在并行窗格里跑多个 Agent 而建。你可以把自己的 Gemini CLI 接进一个独立窗格——同样的免费档、同样的上限，meshcode 不额外收费。在它旁边，meshcode 自己的计量模型跑在预付余额上：没有月费、没有共享窗口、没有倍数——只有一份你自行决定何时充值的余额。重点不是取代 Gemini；而是在它说"晚点再来"的那一刻，你有个别处可去，而不是真的晚点再来。

想知道"没怎么用却触顶"的排查步骤，见Gemini CLI 与 Code Assist 共享配额排查。

其他厂商的同类拆解，见Claude Code 的用量上限提示是什么意思。

按请求次数计数的变体，见Grok 的上限有何不同。

👉 下载 meshcode — Mac、Windows