Gemini CLI

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

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

🚀 为什么选择 Gemini CLI？

• 🎯 免费额度：使用个人 Google 账号即可享受每分钟 60 次请求和每天 1,000 次请求的免费额度。
• 🧠 强大的 Gemini 3 模型：支持更强的推理能力和 100 万 token 的上下文窗口。
• 🔧 内置工具：支持 Google Search 溯源（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 发布。该版本包含发布时主分支（main branch）的所有变更。请注意，该版本可能存在尚未验证的问题。请使用 nightly 标签：

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

📋 核心功能

代码理解与生成

• 查询并编辑大型代码库。
• 利用多模态能力，从 PDF、图像或草图生成新的应用程序。
• 通过自然语言调试问题并排查故障。

自动化与集成

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

高级功能

• 结合内置的 Google Search 为你的查询提供实时溯源支持。
• 对话检查点（Checkpointing），可保存并恢复复杂的会话。
• 支持自定义上下文文件 (GEMINI.md)，针对特定项目定制行为。

GitHub 集成

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

• Pull Request 审查：提供带上下文反馈和建议的自动化代码审查。
• Issue 分类：基于内容分析自动标记和排列 GitHub Issue 的优先级。
• 按需辅助：在 Issue 和 Pull Request 中通过 @gemini-cli 提及机器人，以获取调试、解释或任务委派方面的帮助。
• 自定义工作流：构建自动化、定时触发和按需执行的工作流。