星标数：108813★ Fork数：14946 gemini-cli：把 Gemini 能力直接带进终端的开源智能体
Gemini CLI（命令为 gemini）是一个开源的终端智能体，面向 Google Cloud 上的企业级 Gemini Code Assist 工作流进行维护，适用于拥有 Gemini Code Assist Standard / Enterprise 授权或 Google Cloud 上 Code Assist for GitHub 的组织（同时支持遗留的付费 API / Vertex 密钥）。更多详情可参见 Gemini CLI 官方文档。
需要注意的是，Gemini CLI 仅面向企业 Code Assist 授权使用，不再提供免费个人访问或 Google AI Pro / Ultra 计划（这些已迁移至 Antigravity CLI）；它也未针对 Gemini 4 系列模型进行调优，不建议用它对 Gemini 模型做基准测试。
安装方式灵活多样，可通过 npx 免安装直接运行，也可通过 npm、Homebrew、MacPorts 或 Anaconda 全局安装；项目还提供 Preview（每周二 UTC 23:59）、Stable（每周二 UTC 20:00）和 Nightly（每日 UTC 00:00）三种发布渠道。
主要特点
- 查询与编辑大型代码库
- 利用多模态能力，从 PDF、图片或草图生成全新应用
- 用自然语言调试问题并进行故障排查
- 自动化运维任务，例如查询 pull request 或处理复杂的 rebase
- 通过 MCP 服务器扩展新能力，包括借助 Imagen、Veo 或 Lyria 进行媒体生成
- 支持在脚本中非交互运行，实现工作流自动化
安装
# 使用 npx（无需安装）
npx @google/gemini-cli
# 使用 npm 全局安装
npm install -g @google/gemini-cli
# macOS/Linux 使用 Homebrew 全局安装
brew install gemini-cli
# macOS 使用 MacPorts 全局安装
sudo port install gemini-cli快速开始
# 在当前目录启动
gemini
# 包含多个目录
gemini --include-directories ../lib,../docs
# 使用指定模型
gemini -m gemini-2.5-flash
# 脚本中的非交互模式，获取简单文本响应
gemini -p "Explain the architecture of this codebase"
# 获取结构化 JSON 输出
gemini -p "Explain the architecture of this codebase" --output-format json
# 实时事件流（换行分隔 JSON 事件）
gemini -p "Run tests and deploy" --output-format stream-json认证方式
- 使用 Google 账号登录（OAuth）：使用组织付费 Code Assist 授权时需设置 Google Cloud 项目，例如
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID" - Gemini API Key：适合需要指定模型与按量计费的开发者，设置
export GEMINI_API_KEY="YOUR_API_KEY" - Vertex AI：适合企业团队与生产负载，具备高级安全合规、更高的速率限制及与现有 Google Cloud 基础设施的集成，设置
export GOOGLE_API_KEY="YOUR_API_KEY"和export GOOGLE_GENAI_USE_VERTEXAI=true
📊 本项目 GitHub 星标数：108813。最后更新：2026-11-12，发布：2026-11-10。项目地址：https://github.com/google-gemini/gemini-cli
