Gemini CLI

TL;DR

它是什么

Gemini CLI 是一个 Apache-2.0 开源的终端 Agent。使用方式和 Claude Code / Codex CLI 类似：进入项目目录，运行 gemini，然后用自然语言让它读文件、解释架构、修改代码、跑命令、调试错误。

它的特点不是「最强代码生成」，而是三件事：

1. 上下文大：官方文档强调可访问 Gemini 2.5 Pro 的 1M token context window。
2. 免费额度大：个人 Google 账号入口标注 60 requests/min、1,000 requests/day。
3. 搜索原生：Google Search grounding 是内置能力，查新资料、查报错、查 API 文档时很顺手。

安装与启动

# 免安装试用
npx https://github.com/google-gemini/gemini-cli

# 全局安装
npm install -g @google/gemini-cli

# 启动当前目录会话
gemini

要求 Node.js 20+，支持 Windows / macOS / Linux。

常用命令：

# 非交互问答
gemini -p "Explain the architecture of this codebase"

# 指定模型
gemini -m gemini-2.5-flash

# 额外包含目录
gemini --include-directories ../docs,../packages

# JSON 输出，方便脚本串联
gemini -p "Summarize open issues" --output-format json

三种认证路径

个人使用优先 OAuth；生产和团队内使用优先 Vertex AI。

MCP 与项目记忆

Gemini CLI 支持两类扩展：

• MCP server：把 GitHub、数据库、内部 API 暴露给 Agent。
• GEMINI.md：类似 Claude Code 的 CLAUDE.md / Copilot 的 AGENTS.md，用于写项目约定、测试命令、编码风格。

这让 Gemini CLI 可以进入 2026 年主流终端 Agent 的标准形态：项目记忆 + 工具协议 + headless 自动化。

真实适用场景

1. 大仓库先读懂

先读 package.json、README、src 入口文件，输出这个项目的架构图和关键风险点。

1M 上下文让它在「读文档 + 读代码」阶段很有优势，尤其适合 monorepo 的初始摸底。

2. 查新资料后改代码

查一下 Nuxt 4 最新 route rules 写法，然后检查本项目 nuxt.config.ts 是否需要调整。

Google Search grounding 的价值在这里体现：它不是只靠训练数据，而是能把搜索结果纳入推理。

3. 低成本 issue triage

gh issue list --json title,body \
  | gemini -p "按修复难度给这些 issue 排序，输出 JSON"

和 Jules Tools / GitHub CLI 组合时，可以把 Gemini CLI 当「任务分拣器」。

与同类怎么选

AIHO 建议：

• 预算敏感 / 想免费试：Gemini CLI
• 最稳长任务：Claude Code
• 已有 ChatGPT Plus/Pro：Codex CLI
• 想接国内模型 / 自定义 base_url：Aider

避坑清单

1. 不要把免费额度当生产 SLA：个人额度适合探索，生产任务走 API Key / Vertex AI。
2. 长任务先拆小：即使上下文大，Agent 执行链路也可能漂移；30 分钟以上任务建议拆成 issue。
3. MCP server 要审计：给 Agent 接工具等于扩权，第三方 server 先看源码和权限。
4. GEMINI.md 别写太散：只放稳定约定、测试命令、目录说明，别塞临时需求。
5. 国内网络先验证 OAuth：登录流程不稳定会影响体验，必要时用 API key 路径。

适合 / 不适合

✅ 适合：个人开发者、学生、开源项目维护者、大仓库阅读、联网查新、低成本脚本化分析。
❌ 不适合：强合规生产环境、纯内网开发、预算不敏感但追求最高长任务稳定性的团队。

来源

• Gemini CLI 官方文档：https://google-gemini.github.io/gemini-cli/
• Gemini CLI GitHub：https://github.com/google-gemini/gemini-cli

本卡片由 AIHO 编辑部根据公开资料整理，非厂商付费内容；功能和额度以官网为准。