---
title: "Gemini CLI 术语表"
description: "Gemini CLI 常见术语：ReAct、MCP、GEMINI.md、checkpoint、headless、Code Assist、Vertex AI、Cloud Shell、policy engine。"
verifiedAt: "2026-05-09"
---

这一页只解释 Gemini CLI 入门阶段最容易混淆的词。术语表不是 API 字典，作用是让你在安装、认证、权限、MCP、模型和费用页面里知道自己正在读什么。

> [!NOTE]
> **读法**：先看“最容易混淆的三组”，再按需查术语。不要把术语表当学习顺序，真正的顺序仍然是定位、安装、认证、Quickstart。

## 1. 核心术语

| 术语 | 解释 |
| --- | --- |
| Gemini CLI | Google 开源的终端 AI agent，把 Gemini 模型接到本地项目、工具和命令行里 |
| Gemini Code Assist | Google 的 AI 编程助手产品线，Gemini CLI 与其个人版、Standard、Enterprise 配额相关 |
| ReAct loop | Reason + Act 的任务循环：推理、行动、观察结果，再继续 |
| MCP | Model Context Protocol，用来把外部工具、服务或资源接给模型 |
| GEMINI.md | Gemini CLI 的项目上下文文件，用于提供长期说明和项目规则 |
| settings.json | Gemini CLI 的配置文件，控制模型、工具、MCP、权限等行为 |
| checkpoint | 会话或修改前后的状态保存机制，用于恢复、回看或降低改坏风险 |
| rewind | 回退和重放会话状态的能力 |
| plan mode | 更偏只读和规划的工作模式，适合大改前先看方案 |
| headless mode | 非交互式运行方式，适合脚本、自动化和 CI |
| sandbox | 隔离工具执行环境，降低副作用风险 |
| policy engine | 更细粒度地控制工具执行和权限策略 |
| token caching | 通过缓存降低重复上下文成本或提升性能的机制 |
| Cloud Shell | Google Cloud 提供的在线 shell，Gemini CLI 在其中可用且无需额外设置 |
| Vertex AI | Google Cloud 的企业级 AI 平台，可作为 Gemini CLI 的认证和模型访问路径 |
| Gemini API Key | Google AI Studio 获取的 API key，可用于 Gemini CLI 认证 |
| Extension | Gemini CLI 扩展能力的打包方式 |
| Agent Skill | 专门能力包，让 Gemini CLI 在特定任务上加载更具体的流程和知识 |
| Subagent | 专门 agent，用于分工处理任务 |
| Remote agent | 远程 agent，适合跨进程或远端能力接入 |
| Hook | 在特定生命周期事件上运行脚本或逻辑的机制 |

## 2. 最容易混淆的三组

### Gemini CLI vs Gemini Code Assist

Gemini CLI 是终端 agent；Gemini Code Assist 是产品线。两者在配额、IDE agent mode 和 Google Cloud 文档里有交叉关系。

### MCP vs Extension

MCP 更像连接外部工具和服务的协议；Extension 更像 Gemini CLI 侧的能力打包和分发机制。两者都能扩展能力，但边界不同。

### GEMINI.md vs prompt

prompt 是当前任务的一次性指令；`GEMINI.md` 是项目级长期上下文。反复说的项目规则应该沉淀到 `GEMINI.md`，不是每次复制粘贴。

## 3. 权限相关术语怎么连起来

```mermaid
flowchart LR
    Prompt["当前 prompt"] --> CLI["Gemini CLI"]
    CLI --> Context["GEMINI.md / settings.json"]
    CLI --> Tools["Tools"]
    Tools --> Sandbox["sandbox"]
    Tools --> Policy["policy engine"]
    CLI --> MCP["MCP servers"]
    CLI --> Checkpoint["checkpoint / rewind"]

    style Tools fill:#fef3c7,stroke:#f59e0b
    style MCP fill:#fee2e2,stroke:#ef4444
    style Checkpoint fill:#dcfce7,stroke:#22c55e
```

这张图的重点是：`GEMINI.md` 和 prompt 负责告诉 agent “怎么做”；settings、policy、sandbox 负责限制“能不能做”；checkpoint 和 rewind 负责降低修改风险；MCP 负责接外部能力，但也会放大权限和凭据问题。

## 4. 接下来去哪

<Cards>
  <Card title="CLI 工作流" description="术语清楚后，继续学 commands、快捷键、文件、shell、history、plan 和 checkpoint。" href="/docs/gemini-cli/official/01-cli-workflow" />
  <Card title="上下文与配置" description="继续区分 GEMINI.md、settings.json、ignore、memory、custom commands 和 trusted folders。" href="/docs/gemini-cli/official/02-context-config" />
  <Card title="工具与 MCP" description="继续看内置工具、shell、web、MCP servers、resources 和 extensions 的边界。" href="/docs/gemini-cli/official/03-tools-mcp" />
</Cards>

## 官方来源

- [Gemini CLI Documentation](https://google-gemini.github.io/gemini-cli/docs/)
- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
