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 版本的完整升级，包含了所有的错误修复和验证。请使用 latest 标签。

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

Nightly（每日构建版）

• 新版本将于每天 UTC 00:00 发布。它包含发布时 main 分支的所有变更。请注意，这些版本可能包含未决验证或问题。请使用 nightly 标签。

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

📋 核心功能

代码理解与生成

• 查询并编辑大型代码库
• 利用多模态能力，从 PDF、图片或草图生成新应用程序
• 使用自然语言进行调试和故障排查

自动化与集成

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

高级功能

• 通过内置 Google 搜索 为您的查询提供实时信息支持
• 支持对话检查点（Checkpointing），方便保存和恢复复杂的会话
• 自定义上下文文件 (GEMINI.md)，针对特定项目定制行为

GitHub 集成

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

• Pull Request 审查：提供带有上下文反馈和建议的自动代码审查
• Issue 分类：基于内容分析，自动为 GitHub Issue 添加标签并进行优先级排序
• 按需协助：在 Issue 和 Pull Request 中提及 @gemini-cli，以获取调试、解释或任务分配方面的帮助
• 自定义工作流：构建自动化工作流