开篇先说清楚：这篇是怎么写的
截至 2026 年 10 月 16 日的信息，以官网与官方仓库为准。
先交代材料来源：本文所有功能、额度、版本信息都整理自 Gemini CLI 的官方 GitHub 仓库（google-gemini/gemini-cli 的 README 与发布记录）和官方文档站 geminicli.com，星数来自 GitHub API 截至今日。
要坦白的是：我没有做跑分实测，也没有长期使用数据，所以这篇不是「亲测报告」，而是「上手前必读的功课」。文里凡是引用数字的地方，都说明了出处，你可以自己核对。
Gemini CLI 是什么
一句话：谷歌官方开源的命令行 AI 编程代理，把 Gemini 模型直接放进终端。协议是 Apache 2.0，代码在 GitHub 上有 10.7 万星（GitHub API 截至今日），仓库最近一次代码推送就在 10 月 15 日，更新很勤。
版本节奏是固定的，README 写得很明白：预览版（preview）每周二发布，稳定版（stable）每周二发布——内容是上周预览版经过验证后的转正，另有每天构建一次的夜间版（nightly）。最新稳定版是 v0.64.0，10 月 13 日发布。
安装有三种方式：用 npx @google/gemini-cli 不安装直接跑；用 npm install -g @google/gemini-cli 全局安装；macOS 和 Linux 用户还可以 brew install gemini-cli。
重点：免费额度怎么拿
这是 Gemini CLI 最值得说的地方。官方 README 列了三种认证方式，对应三种人群。
方式一：个人 Google 账号直接登录（推荐个人用户）。首次运行 gemini 命令会引导你在浏览器里完成授权，不需要申请任何 API 密钥。免费额度是每分钟 60 次请求、每天 1000 次请求，用的是 Gemini 3 系列模型，上下文窗口 100 万 token。这个额度的具体限制条款，官方指向 cloud.google.com/gemini/docs/quotas 页面，重度使用前建议自己读一遍。
方式二：填 Gemini API 密钥。密钥在 aistudio.google.com/apikey 免费申请。README 写明 API key 方式的免费档同样是每天 1000 次请求（Gemini 3 的 flash 和 pro 混用），好处是可以自己指定模型，额度不够用可以升级成按量付费。
方式三：Vertex AI，面向企业团队，配额更高、带企业级安全合规，适合公司采购场景，个人用不到。
算一笔账：一天 1000 次，一个月按 30 天算就是 3 万次请求，不花一分钱。对比本站之前整理过的几个工具——GitHub Copilot 免费档每月 2000 次代码补全（见 Copilot 深评），Cursor 和 Claude Code 的完整功能都要每月 20 美元订阅（见 Cursor 深评、Claude Code 深评）——Gemini CLI 的免费档在「白嫖」这个维度确实慷慨。
但要提醒一句：这几种「次数」口径不一样。Copilot 的 2000 次是代码补全次数，Gemini CLI 的 1000 次/天是代理请求次数，一次代理请求可能会自己连续干很多步。所以「3 万次对 2000 次」不能直接得出「Gemini 强 15 倍」的结论，只能说明免费额度的量级不在一个水平上。
它内置了哪些能力
按官方 README 的功能清单整理：
- 读代码改代码：查询和修改大型代码库，调试排错用自然语言对话就行；
- 多模态输入：README 说可以丢 PDF、图片、草图进去生成应用；
- 联网查资料：内置 Google 搜索接地（grounding），问实时信息不是瞎编；
- 干活工具：文件操作、执行 shell 命令、抓取网页，都是内置的；
- 扩展性：支持 MCP 协议接自定义工具，官方还提供了接 Imagen、Veo 做图片和视频生成的示例服务；
- 记忆与存档：项目根目录放 GEMINI.md 文件给代理长期记忆，会话有检查点功能，可以保存和恢复复杂任务；
- 脚本化：gemini -p "问题" 单次执行，加 --output-format json 输出结构化结果，能写进自动化脚本里跑。
这些能力全部来自官方文档，属于「纸面功能」。实际好不好用，建议你拿自己的项目试半天再下结论。
还有个容易被忽略的玩法：接进 GitHub
谷歌官方出了 Gemini CLI 的 GitHub Action（仓库 google-github-actions/run-gemini-cli），README 列了四个用途：
- 自动审查拉取请求，给出带上下文的修改建议；
- 按内容给 issue 自动打标签、分优先级；
- 在 issue 或 PR 里 @gemini-cli，让它来帮忙调试和解释；
- 搭建定制的自动化工作流，定时或按需触发。
对维护开源项目或者管团队仓库的人来说，这个用法可能比在终端里敲命令更省事——审查和分诊这种重复劳动，交给机器正合适。
适合谁，不适合谁
适合这三类人：
- 想零成本试 AI 编程代理的新手：有 Google 账号就能免费用，额度给得大方，试错没有钱包压力；
- 要跑批量任务的人：一天 1000 次的免费额度加上脚本化输出，做自动化流水线很顺手；
- 已经在用终端工具的人：它和 Claude Code 属于同类产品，可以并行装着对比，切换成本就是一条 npm 命令。
不适合这三类情况：
- 网络访问不到 Google 服务的环境用不了，这是硬前提，国内用户需要自行解决网络问题；
- 依赖图形界面的用户：它就是命令行工具，没有官方桌面版，怕敲命令的人上手有门槛；
- 对数据私有化有硬要求的企业：模型在谷歌云上跑，数据如何处理需要自己读条款评估。
另外，免费额度有速率限制和公平使用条款，重度使用超了就得等第二天，或者升级按量付费。
写在最后
终端里的 AI 编程代理，本站已经整理过 Claude Code、Cursor、GitHub Copilot 三家，加上这篇的 Gemini CLI，四款工具刚好覆盖了「订阅制」和「免费额度制」两种路子。免费的午餐代价是什么？大概率是你的代码和数据会经过谷歌的服务器——这一点官方文档里有条款，介意的话自己读一遍再用。
想看其他工具的对比，可以从免费 AI 编程助手怎么选这篇看起，更多文章在文章列表，收录的工具在工具目录。
本文信息截至 2026 年 10 月 16 日，产品迭代快，安装和使用前请以 Gemini CLI 官方仓库与官方文档为准。本文仅供选型参考，不构成任何消费建议。