Gemini CLI

Gemini CLI 是 Google 推出的 开源 AI 终端助手（AI Agent），可在命令行中直接调用 Gemini 3 系列模型，实现代码理解、项目生成、自动化脚本、文件操作、联网搜索、MCP 扩展等强大能力。它为开发者提供了从终端直接使用 Gemini 的最轻量、最快速的方式，支持跨平台安装、免费额度、自动化工作流与企业级扩展。

核心亮点（最新官方信息）

• 完全开源（Apache 2.0）：由 Google 与社区共同维护，GitHub Star 超 10 万。
• 免费额度充足
• Google 登录：60 次/分钟 + 1000 次/天
• API Key：1000 次/天
• 支持 Gemini 3 系列模型：包括 1M token 超长上下文、强推理能力。
• 终端原生体验：无需 IDE，直接在命令行完成代码分析、生成、调试、自动化。
• 内置工具（Tools）：文件系统操作、Shell 命令、Google Search grounding、Web Fetch。
• MCP（Model Context Protocol）扩展：可连接 GitHub、Slack、数据库等外部能力。
• 自动化脚本支持：可在 CI/CD、Shell 脚本中无交互运行。
• 跨平台安装：npm、Homebrew、MacPorts、Anaconda 等多种方式。

主要功能能力

1. 代码理解与生成

• 分析大型代码库
• 自动生成应用（支持从 PDF、图片、草图生成项目）
• 解释架构、定位 bug、生成补丁

2. 自动化与工作流

• 自动处理 PR、Issue、Rebase 等开发任务
• 在脚本中无交互运行（headless mode）
• 支持 JSON/stream-json 输出，适合自动化管线

3. 内置工具（Tools）

• 文件操作：读写文件、目录分析
• Shell 命令执行
• 联网搜索：Google Search grounding
• Web Fetch：抓取网页内容

4. MCP 扩展能力

可连接外部服务，例如：
- GitHub：自动代码审查、Issue 分析、PR 总结
- Slack：发送消息、生成日报
- 数据库：执行 SQL 查询

5. 项目级上下文（GEMINI.md）

在项目根目录放置 GEMINI.md，可为整个项目提供持久上下文，提升回答质量。

安装方式

支持多种安装方式：

• npm（推荐）
  npm install -g @google/gemini-cli

• npx（无需安装）
  npx @google/gemini-cli

• Homebrew（macOS/Linux）
  brew install gemini-cli

• MacPorts（macOS）
  sudo port install gemini-cli

• Anaconda（受限环境）
  创建环境后再 npm 安装

认证方式（3 种官方支持）

1. Google 登录（OAuth）

• 最简单
• 自动使用最新 Gemini 模型
• 免费额度：60 req/min + 1000 req/day

2. Gemini API Key

• 适合需要模型选择或付费额度的开发者
• 免费：1000 req/day

3. Vertex AI（企业级）

• 更高配额
• 企业安全、合规
• 与 Google Cloud 集成

常用命令示例

• 启动交互模式
  gemini

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

• 单次 Prompt
  gemini -p "解释这个项目的架构"

• JSON 输出（适合脚本）
  gemini -p "分析代码" --output-format json

• 流式事件输出
  gemini -p "运行测试" --output-format stream-json

典型使用场景

• 快速理解陌生代码库
• 生成完整应用或脚手架
• 自动化开发任务（PR 审查、Issue 分类）
• 构建 AI 驱动的 CI/CD 流程
• 在终端中进行自然语言编程
• 与 GitHub、Slack、数据库等系统联动

适用人群

• 开发者、工程师
• DevOps、SRE
• AI 自动化工作流构建者
• 需要在终端中高效工作的技术人员