AiDuo123 Logo
充值登录注册
★ 105,502· 14,152 forks· TypeScript· Apache-2.0开发工具

Gemini CLI - 终端里的 Google AI 助手

google-gemini/gemini-cli

Google 官方开源的命令行 AI 工具,将 Gemini 3 模型能力直接接入终端,支持代码理解、文件操作、MCP 扩展和 Google 搜索联网

成熟度：维护极活跃,最近提交0天前,周发布节奏,open issues 1355 个显示用户基数大

GitHub 仓库 →对标：GitHub Copilot CLI

项目体检

部署 · 基于 Docker 多阶段构建,Node.js 20 环境,需传入 GIT_COMMIT 参数,构建后生成 npm 包,无默认端口(CLI 工具)

成本 · 需 GEMINI_API_KEY 或 Google OAuth 认证,可选 GOOGLE_CLOUD_PROJECT(企业版)、GOOGLE_GENAI_USE_VERTEXAI(Vertex AI),开箱支持 npx 免安装运行

技术 · TypeScript + Node.js,基于 esbuild 构建,包含 CLI/Core/SDK/VSCode 扩展等多包架构

许可 · Apache-2.0 协议,可自由商用、修改和分发,需保留版权声明

活跃 · 极活跃维护,最新版本 v0.47.0 发布于 5 天前,685 名贡献者,每周二发布 preview/stable 版本

解决什么

开发者在终端工作时需要频繁切换到浏览器查询 AI、复制粘贴代码,打断思维流。Gemini CLI 将 Google 最新的 Gemini 3 模型直接嵌入命令行,让你无需离开终端即可完成代码审查、文件操作、Shell 命令执行、联网搜索等任务。支持 100 万 token 的超大上下文窗口,能一次性处理整个代码仓库级别的查询。

为何火

作为 Google 官方推出的开源项目,上线两个月即获得 10.5 万 stars,核心原因是三点:1) 免费额度慷慨,个人 Google 账号每天 1000 次请求,每分钟 60 次,远超竞品;2) 终端原生体验,无需浏览器插件或 IDE 扩展,npx 即可运行;3) 生态整合深度,内置 Google 搜索联网、支持 MCP 协议扩展第三方工具,还提供 GitHub Action 实现 PR 自动审查。

核心功能

  • 多模态代码理解:上传 PDF、图片或手绘草图生成完整应用,支持自然语言调试和大规模代码库查询
  • 内置工具链:文件读写、Shell 命令执行、网页抓取、Google 搜索实时联网(需梯子)
  • 会话管理:支持 checkpoint 保存复杂对话上下文,可通过 GEMINI.md 文件定制项目专属行为
  • MCP 扩展:兼容 Model Context Protocol,可接入 Vertex AI 的 Imagen/Veo 媒体生成等外部服务
  • 非交互模式:可嵌入 Shell 脚本实现自动化工作流,例如批量处理 PR 或定时任务

安装

快速体验(无需安装):

npx @google/gemini-cli

全局安装:

# npm 方式
npm install -g @google/gemini-cli

# macOS Homebrew
brew install gemini-cli

# 受限环境用 Anaconda
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

认证配置(三选一):

  1. OAuth 登录(推荐个人用户):运行 gemini 后选择浏览器登录
  2. API Key:访问 https://aistudio.google.com/apikey 获取后 export GEMINI_API_KEY="YOUR_KEY"
  3. Vertex AI(企业):设置 GOOGLE_API_KEY 和 GOOGLE_GENAI_USE_VERTEXAI=true

适合谁

  • 终端重度用户:习惯用 Vim/Tmux 工作,不想切换到 IDE 或浏览器
  • 脚本自动化需求:需要在 CI/CD 或 Cron 任务中调用 AI 能力
  • 开源项目维护者:通过 GitHub Action 实现 PR 自动审查和 Issue 分类
  • 企业开发团队:已有 Google Cloud 基础设施,需要 Vertex AI 的企业级安全和合规特性

社区评价

暂无足量社区公开讨论,以下为基于项目本身的中立评估:

从 GitHub 数据看,该项目在短时间内积累了超 10 万 stars 和 685 名贡献者,显示出极高的关注度。每周二固定发布 preview/stable 版本的节奏表明团队工程化成熟。1355 个 open issues 中大部分是功能请求而非 bug 报告,说明核心功能稳定。官方文档站 geminicli.com 和 GitHub Action 集成显示 Google 在认真运营该项目,而非实验性质。

选型对比

vs GitHub Copilot CLI:

  • Gemini CLI 免费额度更高(1000次/天 vs Copilot 需订阅),上下文窗口更大(100万 vs 约10万 token)
  • Copilot CLI 与 GitHub 生态集成更紧密,Gemini CLI 通过 MCP 扩展性更强
  • Gemini CLI 支持 Google 搜索联网和多模态输入,Copilot 专注代码补全

vs 自建 LLM API 调用:

  • Gemini CLI 提供开箱即用的工具链(文件操作/Shell执行),自建需手动封装
  • 官方维护保证模型更新同步,自建需跟踪 API 变更
  • 企业用户可选 Vertex AI 获得 SLA 保障

已知坑

  1. 网络依赖:OAuth 登录和 Google 搜索功能在中国大陆需要特殊网络环境,建议直接用 API Key 认证
  2. 免费额度限制:个人账号每天 1000 次请求看似充足,但大型代码库分析或频繁调试可能超限,需监控用量
  3. MCP 服务端配置:扩展第三方工具需手动配置 MCP 服务器,文档中示例较少,需参考社区案例
  4. Docker 镜像体积:多阶段构建后镜像约 500MB,包含完整 Node.js 环境,不适合资源受限的边缘设备
  5. Windows 支持:README 未明确说明 Windows 兼容性,从 Dockerfile 看主要针对 Linux/macOS,Windows 用户建议用 WSL2

来源: GitHub 仓库 google-gemini/gemini-cli + 官方文档 geminicli.com

安装方式：npm/npx/homebrew

← 浏览全部项目