← Agents

Gemini CLI

Google

编程终端本地开源 partial lifecycle: active 核验 2026-09-29

Google 官方的开源终端 agent，npx 免安装 + 明确 MCP 支持 + 非交互脚本模式，是三者里工程化最完整的。

适合与不适合

需要 npx 免安装快速试用、需要 MCP 扩展、需要脚本化非交互运行（CI）的场景。尤其适合想把 Gemini 多模态生成（Imagen / Veo / Lyria）接进工作流的用户。需要大上下文窗口的人（1M token，本赛道明确写出上限的少数）。需要「改动可回退」保证的人（shadow Git 检查点 + /restore）。需要项目级长期指令文件的人（GEMINI.md）。

不适合需要明确额度边界的场景—— 额度政策本次未核验，记为未知。

固定坐标系

8 个维度，与同赛道其他对象逐项可比。

模型与开放条件: Google 自家 Gemini 系列模型，README 标注 1M token context window （1M 上下文窗口），是本赛道少数明确写出上下文上限的。 2026-10-01 官方产品页补充：当前 IDE 侧主力是 Gemini 2.5， Gemini 3 标注「coming soon」，走 Preview release channel。另有代码库感知窗口 1M token、代码自定义库上限 20,000 个仓库 （Gemini Code Assist 官方quota 数值）。 未核验：CLI 侧具体可切换的模型清单与版本映射（官方 README 未列全，站点未取到正文），此处保持未知，不做推断。
运行位置: 本地进程，在终端运行。 README 强调「Using npx (no installation required)」—— npx 免安装形态降低了上手门槛。
本地文件: 内置文件操作工具（README 标注「🔧 Built-in tools: Google Search grounding, file operations, shell」）。 检查点机制明确且实现方式值得记录（docs/cli/checkpointing.md）：每当你批准一个会修改文件系统的工具（write_file、replace 等）， CLI 自动在 home 目录下的一个专用 shadow Git 仓库（~/.gemini/history/<project_hash>）里做一次提交，快照项目的完整状态； 关键点：这个 shadow 仓库不干扰你自己的项目 Git 仓库。 同时保存完整对话历史与即将执行的工具调用，可用 /restore 回退。 索引算法与大仓库表现本次未核验。
关机后的任务: 不支持终端形态的后台长任务。 是否有其他运行形态本次未核验。
工具与扩展: 明确支持 MCP（README 标注「🔌 Extensible: MCP support for custom」），并给出独立文档页 /docs/tools/mcp-server。 README 举例说明可用 MCP 接入图像生成能力（Imagen / Veo / Lyria）。内置工具还包括 Google Search grounding（搜索接地）与 shell。 另明确支持非交互模式用于脚本自动化 （README 有独立的「Non-interactive mode for scripts」章节）。
上下文与记忆: 1M token 上下文窗口（README：Gemini 3 models with 1M token context window），是本赛道明确写出上限的少数。 自定义上下文文件 GEMINI.md 用于定制项目行为（README 标注「Custom context files (GEMINI.md) to tailor behavior for your projects」，文档路径 /docs/cli/gemini-md）—— 相当于项目级的长期指令。 上下文压缩策略本次未核验。
权限与限制: 两个明确的官方机制（README 均有独立文档入口）：一是 Sandboxing & Security（文档路径 /docs/cli/sandbox），提供安全的执行环境；二是 Trusted Folders（文档路径 /docs/cli/trusted-folders），按文件夹控制执行策略。另有面向企业的部署与管理文档（/docs/cli/enterprise）。仓库 docs/ 下有独立的 hooks/ 目录，说明支持钩子机制。 具体的沙箱档位、默认信任范围与审批粒度本次未核验，记为未知。 但「按文件夹控制执行策略」这个设计本身值得注意—— 它把权限边界绑定到目录而非全局开关。 检查点的 shadow Git 机制也算一层安全网：修改文件系统前自动快照，可 /restore 回退。
适合什么任务: 需要无安装快速试用、需要 MCP 扩展、需要脚本化非交互运行的场景。尤其适合想把 Gemini 的多模态生成能力接进 Agent 工作流的场景。

头号误解

以为开源就无限用，额度政策未核验
以为 npx 形态会污染本地环境，实际是免安装的临时运行
忽略 MCP 能力，README 明确把它列为可扩展特性

价格

月度入口	个人层免费（无需信用卡），Code Assist 个人版 6,000 代码请求/日 + 240 对话/日
月度数值	$0
年付	个人层无年付（免费）；Google Developer Program Premium 为 $299/年
额度说明	Apache-2.0 开源，支持 npx 直接运行无需安装。 2026-10-01 按官方 quotas 文档核实额度（此前记为未知）：免费层「Gemini Code Assist for individuals」无需信用卡，额度为每天 6,000 次代码相关请求（代码生成与补全）+ 每天 240 次对话请求；每用户每秒 2 次请求。最关键的一条机制（直接影响选型）：CLI 与代理模式额度合并计算—— 官方原文「Quotas for requests from Gemini Code Assist agent mode and Gemini CLI are combined」，且「一个提示可能产生多个模型请求」，额度按与任意模型版本或系列（Pro、Flash）的全部互动次数累计，跨模型不分开计算。达到上限后须等配额重置才能继续。付费层：Gemini Code Assist Standard 1,500 请求/用户/日、Enterprise 2,000；云端版另给 960 次/日的 Cloud Assist 面板请求。个体开发者可订阅 Google AI Pro / AI Ultra / Developer Program premium 以提高上限。 Gemini CLI on GitHub 的用量不计入常规额度（独立配额，PR 审查每天至少 100 次）。

不同币种不做折算。优惠、地区、税费与登录后报价可能变化，购买前请到官方页面确认。

未知项清单

模型额度政策与免费额度边界
具体可用模型清单
索引策略与大仓库表现
上下文压缩策略
沙箱档位与默认信任范围
Trusted Folders 的默认行为

证据来源

判断可回到以下一手源复核。本站核验日 2026-09-29，内容更新日 2026-09-29。

类型	名称	链接
repo	Google · Gemini CLI 仓库 README	https://github.com/google-gemini/gemini-cli
changelog	Google · Gemini CLI Releases	https://github.com/google-gemini/gemini-cli/releases
docs	Google · Gemini CLI 官方文档	https://google-gemini.github.io/gemini-cli/
docs	Google · Gemini CLI MCP Server 文档	https://www.geminicli.com/docs/tools/mcp-server

实测记录

本站尚未完成实测。测试协议见 tasks/_protocol.md。 实测建议：这个工具的实测重点应放在三处（README 或官方文档明确宣传但需要验证的）： 1. npx 免安装的实际启动速度 2. 非交互模式在 CI（无 TTY）环境下是否真的可用 3. shadow Git 检查点在 Windows 上的行为 （文档说路径是 ~/.gemini/history/，Windows 上是否有兼容问题待验）