Gemini CLI 还免费吗?2026 免费额度与费用详解封面图
AI 编程约 5 分钟

Gemini CLI 还免费吗?2026 免费额度与费用详解

AI 指南··◉ 0 浏览

结论先说:Gemini CLI 现在还免费,但入口已经变了。2026-06-18 起,Google 停止了对个人账号的免费登录通道,现在要改用 API key 认证;免费档每天 1000 次请求仍然存在,想用 Pro 系旗舰模型才需要按量付费。

免费额度沿革:60 次/分钟、1000 次/天的时代

Gemini CLI 是 Google 于 2025 年 6 月发布的开源 AI 代理命令行工具,Apache 2.0 协议,代码托管在 GitHub,通过 npm install -g @google/gemini-cli 安装。发布初期,个人用户用 Google 账号 OAuth 登录即可免费使用,官方给出的免费额度是每分钟 60 次请求、每天 1000 次请求,底层模型为 Gemini 2.5 Pro,支持 100 万 token 上下文。当时官方博文的说法是“确保你在预览期间几乎不会、甚至永远不会达到上限”。

这个额度放在 2025 年的同类工具里属于最慷慨的一档,也让“Gemini CLI 免费”成为大量教程和新闻的主角。但注意,那是 2025 年 6 月到 2026 年 6 月的事。

Gemini CLI 官方 GitHub 仓库免费额度说明截图 AI345

2026-06-18 起:免费登录通道停止,改 API key

2026 年 6 月 18 日,Google 官方文档确认:Gemini Code Assist IDE 扩展停止为“面向个人(individuals)、Google AI Pro、Google AI Ultra”档位服务请求,这一变更同样适用于 Gemini CLI;作为弃用流程的一部分,不能再使用“Login with Google”方式访问 CLI。

如果你还看到这样的报错,这是认证问题,不是装坏了:

This client is no longer supported for Gemini Code Assist for individuals

受影响范围内的用户,解决方案是改用 API key 认证。唯一不受影响的是持有 Gemini Code Assist Standard 或 Enterprise 订阅的组织用户,他们可以继续用 Google 账号登录;官方同时建议消费端用户可以迁往 Antigravity 产品线。官方说明见 Gemini Code Assist consumer accounts。

现在怎么认证:API key 两步配好

当前个人的认证方式是 API key,配置只有两步:

  1. 打开 Google AI Studio 的 API key 页面 创建密钥。
  2. 设置环境变量后启动:
export GEMINI_API_KEY="你的密钥"
gemini

gemini 启动后会读取 GEMINI_API_KEY 完成认证。模型、密钥等更多配置项写在 ~/.gemini/settings.json 里,字段说明见《Gemini CLI settings.json 怎么改:字段与层级》。

Gemini CLI API key 环境变量配置示意图 AI345

需要留意的是,社区在 2026 年 9 月整理的应对方案指出:未开通计费的 Standard 类型 key 也会被陆续停用,建议一次把 key 配到“已关联 Cloud Billing 账号”的状态。免费档本身不扣费,但要求项目关联计费账号,这与 Gemini API 免费层的官方要求一致。

当前免费档:每天 1000 次还能拿

官方 GitHub README 目前仍标注:API key 方式的免费档为每天 1000 次请求(Gemini 3 模型混合)。也就是说“免费 1000 次/天”这个数字还在,只是拿它的方式从“登录即送”变成了“API key 认证”。

有两个边界要说清楚:

  • 2026 年 4 月 1 日起,Gemini 2.5 Pro、3.1 Pro 等旗舰模型已从 API 免费层移除,仅限付费使用(据媒体对官方价格页的整理);Flash 系列保留免费额度,但配额比早期明显缩减。
  • 免费层的实际可用模型与 RPM/RPD 数值以 Google Cloud 控制台当前显示为准,同一项目下多个 key 共享配额,不能叠加。

免费档适合日常问答、写脚本、看代码这些轻量场景;批量任务和并发稍高的场景容易触发限流,触发后报 429,排查步骤见《Gemini CLI 429 报错怎么解决:5 步排查到恢复》。

付费费用:按量价格表

超出免费额度后按 token 计费,输入和输出价格不同。以下是当前主要模型的官方口径价格(每百万 token,美元,据官方价格页与多来源媒体整理,以 ai.google.dev 价格页 为准):

模型 输入(每百万 token) 输出(每百万 token)
Gemini 3.1 Flash-Lite $0.25 $1.50
Gemini 3.1 Flash $0.50 $3.00
Gemini 3.5 Flash $1.50 $9.00
Gemini 3.1 Pro $2.00 $12.00

Gemini API 各模型输入输出价格对比图 AI345

另外,2026 年 5 月起 Google 为 API 新增了 Standard(标准)、Flex(弹性)、Priority(优先)、Batch(批量)、Caching(缓存)五类推理档位。其中 Flex 与 Batch 是标准价的五折,适合非实时任务和离线处理;缓存档把重复的上下文存下来,输入成本最高可省 90%。对个人开发者来说,日常用免费档,批量任务开 Flex 或 Batch,是最便宜的组合。

省钱路径:300 美元赠金能不能抵

“新用户有 300 美元赠金,是不是等于免费?”这是常见误区。Google Cloud 的官方说明写得很清楚:新用户的 300 美元赠金不能用于 Gemini Developer API 费用,但可以用于 Agent Platform Gemini API(即 Vertex AI)以及大多数其他 Google Cloud 服务。换句话说,这笔赠金抵不了你用 AI Studio 那个 key 的账单。

Gemini CLI 免费额度与费用变化示意图 AI345

真正能省钱的是这三条:

  1. 免费档优先:轻量使用完全够,不产生账单。
  2. 非实时任务走 Flex/Batch 五折档。
  3. 长上下文开缓存,输入成本省到十分之一量级。

国内用户注意:网络与安全

Gemini CLI 本体是开源 npm 包,安装本身不受地区限制;但认证和请求都走 Google 服务,Gemini API 不在中国大陆开放,国内直连通常无法完成认证与调用,需要海外网络环境。想先跑通安装流程的,可以参考《Gemini CLI 使用教程:从安装到跑通第一个项目》。

另外提醒一点:2026 年 6 月出现过伪造 Gemini CLI 官网、通过搜索广告投毒的钓鱼事件。请只从官方 GitHub 仓库或 npm 官方包安装,不要复制来路不明的安装命令。

常见问题

Gemini CLI 现在还免费吗?

仍然有免费档:通过 API key 认证后,免费档为每天 1000 次请求(Gemini 3 模型混合,官方 README 口径)。免费的入口从“Google 账号登录”变成了“API key”,但 0 元档一直存在。

2026-06-18 之后 Google 账号还能登录 Gemini CLI 吗?

个人免费登录通道已停用,不能再使用“Login with Google”。例外是持有 Gemini Code Assist Standard 或 Enterprise 订阅的组织用户,他们不受影响。

免费档每天 1000 次够用吗?

个人开发日常问答、改脚本、看代码够用;但如果跑批量任务或多 Agent 并发,很容易触发限流报 429,这时考虑付费档或 Flex/Batch 五折档。

300 美元赠金能用来付 Gemini API 费用吗?

不能。赠金可用于 Agent Platform Gemini API(Vertex AI)等 Google Cloud 服务,但不能用于 Gemini Developer API 的按量账单。

Gemini CLI 报 “This client is no longer supported” 怎么办?

这是认证方式过期的提示,不是安装坏了。改用 API key 认证:在 AI Studio 创建 key,设置 GEMINI_API_KEY 环境变量后重新启动。

想接 MCP 扩展 Gemini CLI,有配置参考吗?

有,官方支持 MCP,配置写在 ~/.gemini/settings.json。步骤见《[Gemini CLI MCP 配置:一条命令 5 步接好](/ai-guide/gemini-cli-mcp-config-guide)》。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策