项目简介
Gemini CLI 是 Google 官方开源的终端 AI Agent 工具，将 Gemini 的强大能力直接集成到你的命令行终端中。它是目前从提示词到模型调用最直接的路径，为开发者提供了轻量级的 Gemini 访问入口。
⭐ GitHub Stars: 105k+
🔗 项目地址: github.com/google-gemini/gemini-cli
📄 开源协议: Apache 2.0
🌐 官方网站: geminicli.com
安装要求和过程
环境要求
- Node.js >= 18 (推荐 20+)
- npm 或 Homebrew (macOS)
- Google 账号 (免费使用 Gemini API)
快速安装步骤
方式一：npx 即时运行（推荐试用）
npx @google/gemini-cli方式二：npm 全局安装
npm install -g @google/gemini-cli
gemini --version方式三：Homebrew 安装（macOS/Linux）
brew install gemini-cli
gemini首次启动认证：
# 启动后会自动打开浏览器进行 Google 账号 OAuth 认证
gemini核心功能
| 功能 | 说明 |
|---|---|
| 🧠 代码理解与生成 | 支持查询、编辑大型代码库；可基于 PDF、图片、草图等多模态内容生成新应用；支持自然语言调试问题、排查故障 |
| 🤖 自动化与集成 | 支持自动化操作任务，比如查询拉取请求、处理复杂变基；可通过 MCP 服务器扩展能力，包括对接 Imagen、Veo、Lyria 等媒体生成工具 |
| 🔍 高级能力 | 内置 Google Search 搜索能力，支持实时信息检索；支持对话检查点，可保存、恢复复杂会话；支持自定义上下文文件 GEMINI.md |
| 🚀 免费额度友好 | 个人 Google 账号即可享受免费 tier，支持 60 次请求/分钟、1000 次请求/天 |
| 🔧 内置工具丰富 | 自带 Google Search 搜索、文件操作、Shell 命令执行、网页抓取等能力；支持 MCP（模型上下文协议），可自定义集成第三方能力 |
典型使用场景
场景一：快速启动新项目
进入项目目录启动 gemini 后，直接用自然语言描述需求即可生成对应代码：
# 启动 Gemini CLI
cd my-new-project
gemini
# 在交互界面中输入：
> Write me a Discord bot that answers questions using a FAQ.md file I will provide场景二：分析现有代码变更
克隆代码库后启动 gemini，可以快速获取代码变更总结：
# 克隆代码库
git clone https://github.com/some/repo.git
cd repo
gemini
# 在交互界面中输入：
> Give me a summary of all of the changes that went in yesterday场景三：非交互式脚本自动化
使用 -p 参数可以在脚本中调用 Gemini CLI，实现工作流自动化：
# 获取简单文本响应
gemini -p "Explain the architecture of this codebase"
# 获取结构化 JSON 输出
gemini -p "Explain the architecture of this codebase" --output-format json
# 实时流式输出
gemini -p "Run tests and deploy" --output-format stream-json推荐理由
作为一款终端原生的 AI Agent 工具，Gemini CLI 给我留下了深刻印象：
- 官方背书，值得信赖：Google 官方开源项目，持续维护，质量有保障
- 免费额度慷慨：个人开发者使用免费 Google 账号即可享受 60 次/分钟、1000 次/天的 API 调用额度，足够个人使用和小型项目开发
- 100 万 token 上下文窗口：支持 Gemini 2.5 Pro/Flash 等顶级模型，能够理解超大型代码库，一次性分析整个项目
- 终端原生体验：专为习惯命令行的开发者打造，操作流畅，无需离开终端即可完成代码理解、生成、调试全流程
- MCP 扩展性强：支持模型上下文协议（MCP），可以对接 Imagen、Veo、Lyria 等媒体生成工具，未来潜力巨大
如果你是一名开发者，正在寻找一款轻量级、功能强大、免费额度慷慨的终端 AI 助手，Gemini CLI 绝对值得一试！
下载地址
- 📦 GitHub 仓库：github.com/google-gemini/gemini-cli
- 🌐 官方网站：geminicli.com
- 📚 官方文档：geminicli.com/docs
- 📦 npm 包：@google/gemini-cli
- 💬 Discord 社区：discord.gg/gemini-cli