cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

工作流

Gemini CLI

Google 的终端智能体,把 Gemini 放进命令行,也能当 MCP 客户端。

google-gemini/gemini-cli 是 Apache-2.0 的开源终端代理,站点在 geminicli.com。它把 Gemini 放进命令行,仓库主题里也包括 MCP 客户端和服务器。适合已经在用 Gemini、希望在仓库里而不是网页里工作的人。

先用只读的问题熟悉它会碰哪些文件,再打开编辑。如果同时接了 MCP,逐个看每个服务器的权限,不要一次接上一长串。

本页是导读,不是原文。

注意(2026-11-15 核实):根据 Google 官方公告(2026-05-19 发布),自 2026-06-18 起,Gemini CLI 不再为 Google AI Pro / Ultra 用户,以及通过 Gemini Code Assist 个人版免费使用的用户提供服务,个人用户请改用 Antigravity CLI。使用 Gemini Code Assist Standard / Enterprise 许可证的组织,或使用付费 Gemini API key 的用户,仍可继续使用 Gemini CLI。

解决什么问题

Gemini CLI(命令是 gemini)是 Google 维护的开源终端编码代理,仓库为 google-gemini/gemini-cli,Apache-2.0 许可。它可以在项目目录里读代码、改文件、跑命令,并可作为 MCP 客户端接入外部工具。还可以用 GEMINI.md 写下项目约定。

需要先读仓库开头的状态说明。官方 README 写明:自 2026-11-15 核验时,Gemini CLI 主要面向持有 Gemini Code Assist Standard / Enterprise 许可,或在 Google Cloud 上使用 Code Assist for GitHub 的组织;也可配合既有的付费 Gemini / Vertex API key。个人免费通道以及 Google AI Pro / Ultra(Google One)已在 2026-06-18 迁到 Antigravity CLI(命令为 agy),详见官方过渡说明。不要再把旧教程里的「个人免费每天 1000 次」当成当前 Gemini CLI 的默认情况。

适合谁

适合所在组织已购买 Code Assist Standard / Enterprise,或已有可用的付费 API / Vertex 密钥、希望在终端里使用 Gemini 的人。如果你用的是个人免费账号或 Google AI Pro / Ultra,官方指引是改用 Antigravity CLI,而不是继续把 Gemini CLI 当作个人主力。

安装文档还要求:Node.js 20.0.0 或更新,以及所在地属于 Gemini Code Assist 支持地区。具体名单以 Google 官方页面为准。本文不把中国大陆是否可用来写成未经核验的结论,也不讨论绕过方法。

怎么装

核验日期为 2026-11-15(Asia/Shanghai),命令来自当前 README 和 安装文档。常见装法:

npm install -g @google/gemini-cli

也可以直接运行,不必先全局安装:

npx @google/gemini-cli

macOS/Linux 还可用 brew install gemini-cli。装完后在项目目录运行 gemini。

组织用户按官方说明用 Google 账号登录,并在需要时设置 Google Cloud 项目。若使用 Gemini API key:

export GEMINI_API_KEY="YOUR_API_KEY"

然后启动 gemini,选择使用 API key。密钥从 Google AI Studio 获取,不要写入仓库或对话。Vertex AI 则按官方认证文档设置。MCP 可用 gemini mcp add 添加,或编辑 ~/.gemini/settings.json。项目约定可写在 GEMINI.md。

关于额度:geminicli.com 的配额页仍列有个人免费和 Google AI Pro / Ultra 的数字,但该页与仓库 README、过渡公告(2026-05-19 发布)已经不一致。请以 README 和过渡公告为准,需要个人或 Pro / Ultra 配额时改看 Antigravity CLI 的官方说明。

一个实际例子

仓库 README 的入门示例之一是让它总结仓库近期变更。本次没有在本机实跑,因此不编造摘要内容。

  1. 确认你的账号属于官方仍支持 Gemini CLI 的类型(组织 Code Assist 或可用的付费 API / Vertex 密钥)。若是个人免费或 Pro / Ultra,请改走 Antigravity CLI。
  2. 在仓库目录运行 gemini 并完成登录。
  3. 发送 README 中的示例:Give me a summary of all of the changes that went in yesterday。按官方说明,它应查看本地变更并给出摘要。
  4. 请自己对照 git log 或 diff,不要把一次回答当成已经核实的变更记录。需要改文件时,再给一个范围很小的任务,并自己审查 diff。

常见坑

  • 仍按旧教程用个人免费或 Google AI Pro / Ultra 登录 Gemini CLI。官方已宣布这些通道在 2026-06-18 停止在 Gemini CLI 和 Code Assist IDE 扩展中提供服务,应改用 Antigravity CLI。若看到 403 或「账号不符合资格」,先对照过渡公告,而不是反复重装。issue #24517 曾报告 Google One 订阅者出现 403(已关闭,背景可能已变化)。
  • 把过期的配额页数字当成当前保证。请以仓库 README 为准。
  • 密钥或 MCP 一次接得太多。先用只读问题熟悉它会碰哪些文件;MCP 要逐个查看权限。
  • 容量或限流。issue #24937 在跟踪 429 / 容量问题。可用官方的 /stats model 查看当次用量,但不要假设个人免费额度仍然有效。

FAQ

现在还能用个人 Google 账号免费用 Gemini CLI 吗?

按官方过渡说明(2026-05-19 发布,2026-06-18 生效)和当前 README:个人免费以及 Google AI Pro / Ultra 已迁到 Antigravity CLI。Gemini CLI 留给组织的 Code Assist Standard / Enterprise、Code Assist for GitHub,以及既有的付费 API / Vertex 密钥。

个人用户该装哪个命令?

官方对照表写明:个人免费或 Google AI Pro / Ultra、以及 Gemini 4 系列,应使用 Antigravity CLI(agy)。本仓库的 gemini 面向组织 Code Assist 工作流。

需要 Node.js 哪个版本?

官方安装文档要求 Node.js 20.0.0 或更新。

怎么接 MCP?

可用 gemini mcp add,或编辑 ~/.gemini/settings.json。加完后用 gemini mcp list 检查。先只加你需要的服务器。

GEMINI.md 是什么?

它是 Gemini CLI 的项目约定文件,作用接近其他代理里的说明文件。官方有专门的 GEMINI.md 文档,适合写构建命令和「始终要遵守」的规则。

来源与许可

仓库 google-gemini/gemini-cli 使用 Apache-2.0 许可。本文依据 2026-11-15 查阅的 README、安装文档、认证文档 和过渡公告,用自己的话写成,供 CQBase 上下文库使用。若产品归属或安装命令有变,以仓库和官网为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。