Gemini CLI 术语表

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

读法：先看“最容易混淆的三组”，再按需查术语。不要把术语表当学习顺序，真正的顺序仍然是定位、安装、认证、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. 权限相关术语怎么连起来

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 负责接外部能力，但也会放大权限和凭据问题。