# Gemini CLI

Canonical: https://cqbase.net/zh/entry/gemini-cli
Chinese: https://cqbase.net/zh/entry/gemini-cli
English: https://cqbase.net/en/entry/gemini-cli

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

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

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

注意（2026-11-15 核实）：根据 Google [官方公告](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)（2026-05-19 发布），自 2026-06-18 起，Gemini CLI 不再为 Google AI Pro / Ultra 用户，以及通过 Gemini Code Assist 个人版免费使用的用户提供服务，个人用户请改用 [Antigravity CLI](https://antigravity.google/product/antigravity-cli)。使用 Gemini Code Assist Standard / Enterprise 许可证的组织，或使用付费 Gemini API key 的用户，仍可继续使用 Gemini CLI。

## 解决什么问题

Gemini CLI（命令是 `gemini`）是 Google 维护的开源终端编码代理，仓库为 [google-gemini/gemini-cli](https://github.com/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](https://antigravity.google/product/antigravity-cli)（命令为 `agy`），详见[官方过渡说明](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)。不要再把旧教程里的「个人免费每天 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 和 [安装文档](https://geminicli.com/docs/get-started/installation/)。常见装法：

```bash
npm install -g @google/gemini-cli
```

也可以直接运行，不必先全局安装：

```bash
npx @google/gemini-cli
```

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

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

```bash
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](https://github.com/google-gemini/gemini-cli/issues/24517) 曾报告 Google One 订阅者出现 403（已关闭，背景可能已变化）。
- 把过期的配额页数字当成当前保证。请以仓库 README 为准。
- 密钥或 MCP 一次接得太多。先用只读问题熟悉它会碰哪些文件；MCP 要逐个查看权限。
- 容量或限流。[issue #24937](https://github.com/google-gemini/gemini-cli/issues/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](https://github.com/google-gemini/gemini-cli) 使用 Apache-2.0 许可。本文依据 2026-11-15 查阅的 README、[安装文档](https://geminicli.com/docs/get-started/installation/)、[认证文档](https://geminicli.com/docs/get-started/authentication) 和[过渡公告](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)，用自己的话写成，供 CQBase 上下文库使用。若产品归属或安装命令有变，以仓库和官网为准。

## 收录信息

- 作者: google-gemini
- 许可证: Apache-2.0
- 来源: https://github.com/google-gemini/gemini-cli
- 收录: 2026-11-15
- GitHub 星标: 108841（采集 2026-11-15）

