Gemini CLI

Gemini CLI 是一款开源 AI 智能体，可将 Gemini 的强大功能直接引入你的终端。它提供了一种轻量级的 Gemini 访问方式，让你能以最直接的路径从提示词（Prompt）获取模型响应。

请在我们的官方文档中了解有关 Gemini CLI 的所有信息。

🚀 为什么选择 Gemini CLI？

• 🎯 免费层级：使用个人 Google 账号即可享受每分钟 60 次请求和每天 1,000 次请求的配额。
• 🧠 强大的 Gemini 3 模型：支持增强的推理能力和 100 万 token 的上下文窗口。
• 🔧 内置工具：支持 Google 搜索 Grounding、文件操作、Shell 命令执行及网页抓取。
• 🔌 可扩展：支持 MCP (Model Context Protocol)，方便自定义集成。
• 💻 终端优先：专为习惯命令行操作的开发者设计。
• 🛡️ 开源：采用 Apache 2.0 许可证。

📦 安装指南

有关推荐的系统规格和详细的安装指南，请参阅 Gemini CLI 安装、执行与发布说明。

快速安装

通过 npx 立即运行

# 使用 npx（无需安装）
npx @google/gemini-cli

通过 npm 全局安装

npm install -g @google/gemini-cli

通过 Homebrew 全局安装 (macOS/Linux)

brew install gemini-cli

通过 MacPorts 全局安装 (macOS)

sudo port install gemini-cli

通过 Anaconda 安装（适用于受限环境）

# 创建并激活一个新环境
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# 通过 npm 在环境内全局安装 Gemini CLI
npm install -g @google/gemini-cli

发布渠道

详细信息请查看发布记录。

预览版 (Preview)

每周二 UTC 时间 23:59 发布新的预览版本。这些版本尚未经过全面验证，可能包含回归问题或其他待处理事项。欢迎使用 preview 标签安装并协助我们测试。

npm install -g @google/gemini-cli@preview

稳定版 (Stable)

• 每周二 UTC 时间 20:00 发布新的稳定版本。这是对上周 preview 版本的完全推广，并包含了所有的 Bug 修复和验证。请使用 latest 标签。

npm install -g @google/gemini-cli@latest

夜间版 (Nightly)

• 每天 UTC 时间 00:00 发布。此版本包含发布时主分支的所有变更。请注意，该版本可能存在待处理的验证和问题。请使用 nightly 标签。

npm install -g @google/gemini-cli@nightly

📋 核心功能

代码理解与生成

• 查询并编辑大型代码库
• 利用多模态功能，通过 PDF、图像或草图生成新应用
• 使用自然语言调试问题并进行排查

自动化与集成

• 自动化执行操作任务，例如查询 Pull Request 或处理复杂的 Rebase
• 使用 MCP 服务器连接新功能，包括 使用 Imagen、Veo 或 Lyria 生成媒体内容
• 在脚本中非交互式运行，以实现工作流自动化

高级能力

• 结合内置 Google 搜索 进行实时信息检索
• 支持对话检查点（Checkpointing），以便保存并恢复复杂的会话
• 支持自定义上下文文件 (GEMINI.md)，针对你的项目定制 AI 行为

GitHub 集成

通过 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到你的 GitHub 工作流中：

• Pull Request 评审：通过上下文反馈和建议进行自动化代码评审
• Issue 分类：基于内容分析，自动对 GitHub Issue 进行标签分类和优先级排序
• 按需辅助：在 Issue 和 Pull Request 中 @gemini-cli，获取调试、解释或任务委派方面的帮助
• 自定义工作流：构建自动化工作流