Gemini CLI
产品概述
Gemini CLI 是 Google 推出的 开源终端 AI 编程助手（Apache 2.0），2025 年 6 月 25 日发布。它把 Gemini 模型直接带进 shell：具备文件系统与执行环境访问权，能读代码、跑命令、写文件、联网检索。与 Claude Code、Codex CLI 的「付费订阅 + API 计费」不同，Gemini CLI 的招牌是业内最慷慨的免费额度——用个人 Google 账号登录即可每日免费调用旗舰 Gemini 模型（含 1M token 上下文），无需绑卡。
它同时是 Gemini Code Assist 的终端形态：Code Assist 是 VS Code 插件，Gemini CLI 则面向偏好命令行的开发者。作为 Google 全家桶的一部分，它原生内置 Google Search 接地、多模态输入（图片/PDF/草图）、MCP 支持，是「预算有限、想在终端体验前沿模型」的开发者的首选。
发展历程
| 时间 | 事件 |
|---|---|
| 2025-06-25 | Google 发布 Gemini CLI，开源（Apache 2.0） |
| 2025 中 | 加入 PTY shell 支持，可运行 vim/htop 等交互命令 |
| 2026-04 | v0.38.2 发布，默认搭载 Gemini 3.1 Pro，紧凑输出模式上线 |
| 2026-06 | 个人免费额度调整，Google 转向 Antigravity CLI 布局 |
核心功能详解
1. 终端原生 Agent
npm install -g @google/gemini-cli 即可安装。Agent 能读文件、执行命令、跨文件编辑，并在后台 PTY 虚拟终端运行交互式命令（vim、htop、带提示的安装器），不打断会话。
2. Google Search 接地（Grounding）
Gemini CLI 的独有功能：在提示里加 @search，模型会先检索 Google 获取最新文档、包版本、API 变更，再生成代码。对「依赖快速变化的 API」「近期 CVE」类任务价值显著——多数竞品默认只基于训练数据作答。
3. 1M Token 上下文
依托 Gemini 的超长上下文，可一次性加载大型代码库、长日志、整份文档集，减少大项目里反复解释上下文的损耗。
4. 多模态输入
可处理图片、PDF、手绘线框图：粘贴一张损坏 UI 的截图或草图，直接生成对应代码——纯文本编程工具做不到。
5. MCP 支持
原生支持 Model Context Protocol，可接入数据库、浏览器、设计工具、内部 API 等 MCP server，扩展性对标 Claude Code。
6. 多种鉴权路径
支持个人 Google 账号、Gemini API key、Vertex AI、Workspace/Code Assist 组织账号四种接入方式，从免费实验到企业级治理均可伸缩。
适用场景
最合适
- 预算有限的个人/学生/开源贡献者：免费额度 + 1M 上下文，性价比最高。
- 需要联网接地的任务（查最新 API 文档、版本、CVE）。
- 多模态编码：截图/PDF/线框图直接生成代码。
- CI/脚本化：CLI 可非交互式运行，接入流水线。
不太合适
- 复杂多文件重构对执行精度要求极高（Claude Code 仍更稳）。
- 对数据隐私敏感、不愿代码被用于改进 Google 产品的团队（免费版有此条款，需用 API key/企业模式）。
- 非 Google 云生态、想避免企业鉴权配置摩擦的团队。
定价详情
计费逻辑
Gemini CLI 的定价取决于鉴权方式，核心是「请求次数额度」而非 token：不同账号类型对应不同每日请求上限。
档位表
| 接入路径 | 价格 | 每日限额 |
|---|---|---|
| 个人 Google 账号（Code Assist Individual） | 免费 | 1,000 请求/天，60 请求/分钟 |
| Gemini API key 免费层 | 免费 | 250 请求/天，仅 Flash 模型 |
| Google AI Pro | $19.99/月 | 1,500 请求/天 |
| Google AI Ultra | $249.99/月 | 2,000 请求/天 |
| Code Assist Standard（12 个月承诺） | 约 $19/用户/月 | 1,500 请求/天 |
| Code Assist Enterprise（12 个月承诺） | 约 $45/用户/月 | 2,000 请求/天 |
| API / Vertex AI 按量 | 按 token 计费 | 无硬性上限 |
实际成本测算
- 个人轻中度使用：免费额度几乎够用（约 100–125 次/天实际对话，因一次多步任务消耗多个请求）。
- 需要稳定旗舰模型、避免峰值降级：$19.99 Google AI Pro 是「单人固定价」的最干净路径。
- 团队已在 Google Cloud：Code Assist Standard（约 $19/用户）比按 token 计费更易预算。
定价核验日期：2026-08-13。来源：Google Gemini CLI 官方 quota 文档。免费额度政策变动频繁，以官方为准。
技术架构与模型
- Gemini 3.1 Pro（2026-04 起默认）：旗舰，1M 上下文。
- Gemini 3 Pro / 3 Flash / 3.5 Flash：Agent 内部按任务自动在模型家族间路由（免费版混用 Flash 与 Pro）。
- CLI 基于 TypeScript，代码开源，可审计、可 fork、可自托管扩展。
优势领域
与 Claude Code / Codex CLI 对比
| 维度 | Gemini CLI | Claude Code | Codex CLI |
|---|---|---|---|
| 开源 | Apache 2.0 全开源 | 闭源 | CLI 开源、模型闭源 |
| 免费额度 | 慷慨（1000 请求/天） | 无 | 无 |
| 上下文 | 1M token | 200K | 模型相关 |
| 搜索接地 | 内置 Google Search | 靠 MCP/工具 | 靠工具 |
| 多模态 | 图片/PDF | 图片/PDF | 有限 |
核心优势
免费额度 + 开源 + 1M 上下文 + Google Search 接地，是「终端 AI 编程性价比之王」。执行精度上 Claude Code 在复杂多文件重构仍略胜。
短板与限制
- 复杂重构精度：多文件重构与复杂指令遵循不如 Claude Code 稳定。
- 免费版峰值限流：高峰时段可能被限流或将请求路由到较轻模型。
- 隐私条款：免费个人账号数据可能用于改进 Google 产品（可 opt-out 或改用 API/付费模式）。
- 企业鉴权繁琐：Google Cloud/Vertex/Workspace 鉴权配置比单一 API key 复杂，报错信息不够清晰。
- 国内可访问性：需代理。
使用建议
- 适合：预算有限的个人开发者、学生、开源贡献者；需要联网接地与多模态输入的终端用户；Google 云生态团队。
- 不适合：对复杂重构执行精度要求极高的生产任务（配 Claude Code）；敏感代码且不愿处理数据条款的团队。
- 最佳实践：先用个人 Google 账号白嫖免费额度；
/stats model查看当前模型与额度档位；敏感项目用 API key 或企业模式；与 Claude Code/Codex CLI 搭配——日常杂活用 Gemini CLI 免费档，复杂设计用 Claude Code。