gemini-cli 免费额度

很多人在终端里敲命令写代码，想用 gemini-cli 省点 API 开销，结果卡在「免费额度到底算谁的」上：是命令行工具的、还是 Google 账号的、还是那个 API Key 的？这篇不讲虚的，给你一条排查顺序，先把额度来源搞清楚，再决定要不要拿它跑正事。

很多人在终端里敲命令写代码，想用 gemini-cli 省点 API 开销，结果卡在「免费额度到底算谁的」上：是命令行工具自带的，还是 Google 账号给的，还是那个 API Key 自己的？这三者经常被混着说，一混就判断错。这篇不讲虚的，给你一条排查顺序，先把额度来源搞清楚，再决定要不要拿它跑正事。

先记住一句话：命令行工具本身通常不带额度，它只是个调用入口。就像浏览器不送流量，流量是你的宽带套餐给的。所以问「gemini-cli 免费额度有多少」之前，得先问「这条请求最终打到哪个通道上」，答案不同，规则完全不同。

先分清：这份免费额度是谁给的

最容易搞混的是把三种来源当成一回事。命令行工具只是把你输入的内容打包发给某个接口，真正决定「免费不免费、限速多少」的是那个接口背后的账号体系。所以拿到一个 Key 之后，第一件事不是跑任务，是搞清楚它属于哪一类。

官方 API 免费层

由模型方直接提供，绑定在你的账号或项目上，限速和配额按账号口径走

AI Studio 类网页控制台

在网页里试用，额度口径和 API 免费层不一定打通，别互相套用

第三方聚合或中转渠道

由渠道方自己定体验额度，规则看渠道说明，和官方数量没有可比性

无论哪种来源，都别背数字。官方按量口径可以到 /official-api/providers/google 核对当时的数字，模型清单和能力边界看 /models。如果你走的是中转站，额度规则看 /sites 目录里每个站点的说明，别拿官方免费层的数量去套第三方，两边根本不是一个池子。

三步自查：你还剩多少、能用多久

搞清楚来源之后，接下来是估。命令行工具的特点是「一轮任务反复读写上下文」，同样一句话，它比网页版更费额度，因为工具会在后台多次调用。所以不能凭网页版的体感去推命令行。

1. 第一步 看身份登账号后台看用量面板，确认当前用的是免费层还是已经升到付费结算。两者混用时账单归属最容易看错，先把这个状态确定下来。
2. 第二步 看绑定确认 API Key 绑的是哪个项目。同一账号下多个 Key 可能共享计数，也可能各算各的，这点必须先发一次小请求，看用量面板有没有同步跳动来验证。
3. 第三步 估消耗命令行一轮任务会反复读文件、写中间结果，量比单次问答大。把典型任务丢进 /tools/token-price-calculator 过一遍，换算成实际用量再判断够不够。

这三步的顺序别反。先看身份，再看绑定，最后估量。反过来做，很容易在「我还剩很多」的错觉里把额度跑光，然后发现一开始就绑错了 Key。

什么情况下这份免费额度根本用不上

免费额度不是万能通行证。有些场景不是「额度少一点」的问题，而是它压根不适合用免费档跑，硬上只会浪费时间。下面这几类要提前判断。

还有一个容易被忽略的点：需要稳定延迟和并发的时候，免费层的排队和限速是你控制不了的。这类场景应该直接按付费口径算预算，而不是先试免费档再抱怨慢。换句话说，免费额度适合「轻量、偶发、不急」的活。

额度快见底时，命令行开发者能做什么

额度不够是常态，关键是怎么切。命令行调用是突发式的——平时闲着，一跑任务就连续消耗。这种节奏和按月的订阅套餐未必贴合，所以切换策略要按使用形态来定，不能只看哪个便宜。

• 把高频小任务和低频重任务分开：小任务留给免费档，重任务切到按量付费，避免整条流程被限速一起拖住
• 命令行场景优先评估按量 API，因为终端调用是突发式的，订阅的额度结构未必匹配你的节奏
• 做一次两周用量记录再决定要不要升级，记录字段的口径参考 /usage，别凭感觉判断
• 只是想试模型能力时，先用网页控制台确认够不够用，不必一上来就配 Key 跑命令行

如果你在多个渠道之间犹豫，先去 /price-watch 看当期数字，再到 /rankings 对比一下稳定性口碑。价格和可用性要一起看，只看一边容易踩坑。编程类套餐的对照可以看 /coding-plans，判断哪套额度结构贴合你的调用节奏。