Google开源Gemini CLI：终端中的AI智能体

Gemini CLI 是一款开源 AI 智能体，可将 Gemini 的能力直接带入您的终端。它提供对 Gemini 的轻量级访问，为您提供从提示到模型的最直接路径。请在我们的文档中了解有关 Gemini CLI 的所有信息。

- 🎯 免费层级：使用个人 Google 帐户，每分钟 60 次请求，每天 1,000 次请求。- 🧠 强大的 Gemini 3 模型：可访问改进的推理能力和 1M token 上下文窗口。

- 🔧 内置工具：Google 搜索接地、文件操作、Shell 命令、网页抓取。- 🔌 可扩展：支持 MCP（模型上下文协议）以实现自定义集成。- 💻 终端优先：专为命令行开发者设计。- 🛡️ 开源：Apache 2.0 许可。

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

# 使用 npx（无需安装）npx @google/gemini-clinpm install -g @google/gemini-clibrew install gemini-clisudo port install gemini-cli# 创建并激活新环境conda

create -y -n gemini_env -c conda-forge nodejsconda activate gemini_env# 通过 npm（在环境内）全局安装 Gemini CLInpm install -g @google/gemini-cli更多详情

请参阅版本发布。新的预览版将于每周二 UTC 23:59 发布。这些版本尚未经过全面审查，可能包含回归或其他未解决的问题。请帮助我们测试，并使用 preview 标签安装。

npm install -g @google/gemini-cli@preview- 新的稳定版将于每周二 UTC 20:00 发布，这将是上周预览版的完整升级，加上任何错误修复和验证。使用 latest 标签。

npm install -g @google/gemini-cli@latest- 新版本将于每天 UTC 00:00 发布。这将包含发布时主分支上的所有更改。应假定存在待定的验证和问题。使用 nightly 标签。

npm install -g @google/gemini-cli@nightly- 查询和编辑大型代码库- 使用多模态功能从 PDF、图像或草图生成新应用- 用自然语言调试和排查问题- 自动化操作任务，如查询拉取请求或处理复杂的变基- 使用 MCP 服务器连接新功能，

包括使用 Imagen、Veo 或 Lyria 生成媒体- 在脚本中非交互式运行以实现工作流自动化- 通过内置的 Google 搜索获取实时信息来支持查询- 对话检查点，用于保存和恢复复杂会话- 自定义上下文文件（GEMINI.md）

md）为您的项目定制行为通过 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到您的 GitHub 工作流中：- 拉取请求审查：自动化代码审查，提供上下文反馈和建议- 问题分类：

基于内容分析自动标记和优先处理 GitHub 问题- 按需协助：

在问题和拉取请求中提及 @gemini-cli 以获取调试、解释或任务委派方面的帮助- 自定义工作流：构建适合您团队需求的自动化、定时和按需工作流选择最适合您的身份验证方法：✨ 最适合：个人开发者以及任何拥有 Gemini Code Assist 许可证的用户。

（详情请参阅配额限制和服务条款）优势：- 免费层级：每分钟 60 次请求，每天 1,000 次请求- Gemini 3 模型，

具有 1M token 上下文窗口- 无需管理 API 密钥——只需使用您的 Google 帐户登录- 自动更新到最新模型启动 Gemini CLI，

然后选择“使用 Google 登录”并在提示时遵循浏览器身份验证流程gemini如果您使用的是组织的付费 Code Assist 许可证，

请记得设置 Google Cloud 项目# 设置您的 Google Cloud 项目export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"gemini✨ 最适合：

需要特定模型控制或付费层级访问的开发者优势：- 免费层级：每天 1,000 次请求，使用 Gemini 3（flash 和 pro 混合）- 模型选择：选择特定的 Gemini 模型- 基于使用量的计费：需要时升级以获得更高限额# 从 https:

//aistudio.google.com/apikey 获取您的密钥export GEMINI_API_KEY="YOUR_API_KEY"gemini✨ 最适合：

企业团队和生产工作负载优势：- 企业功能：高级安全性和合规性- 可扩展：使用计费账户获得更高速率限制- 集成：

与现有 Google Cloud 基础设施配合使用# 从 Google Cloud 控制台获取您的密钥export GOOGLE_API_KEY="YOUR_API_KEY"export GOOGLE_GENAI_USE_VERTEXAI=truegemini对于 Goo

gle Workspace 帐户和其他身份验证方法，请参阅身份验证指南。geminigemini --include-directories ../lib,../docsgemini -m gemini-2.5-flash

获取简单的文本响应：gemini -p "解释这个代码库的架构"对于更高级的脚本，包括如何解析 JSON 和处理错误，请使用 --output-format json 标志获取结构化输出：

gemini -p "解释这个代码库的架构" --output-format json对于实时事件流（用于监控长时间运行的操作），请使用 --output-format stream-json 获取换行符分隔的 JSON 事件：

gemini -p "运行测试并部署" --output-format stream-jsoncd new-project/gemini> 给我写一个 Discord 机器人，

使用我将提供的 FAQ.md 文件回答问题git clone https://github.com/google-gemini/gemini-clicd gemini-cligemini> 给我一个昨天所有变更的摘要- 快速入门指南 - 快速启动并运行。

- 身份验证设置 - 详细的身份验证配置。- 配置指南 - 设置和自定义。- 键盘快捷键 - 提高效率的技巧。- 命令参考 - 所有斜杠命令（/help、/chat 等）。- 自定义命令 - 创建您自己的可重用命令。

- 上下文文件 (GEMINI.md) - 为 Gemini CLI 提供持久上下文。- 检查点 - 保存和恢复对话。- 令牌缓存 - 优化令牌使用。- 内置工具概述- MCP 服务器集成 - 使用自定义工具扩展。

- 自定义扩展 - 构建和共享您自己的命令。- 无头模式（脚本） - 在自动化工作流中使用 Gemini CLI。- IDE 集成 - VS Code 伴侣。

- 沙箱与安全 - 安全的执行环境。- 受信任文件夹 - 按文件夹控制执行策略。- 企业指南 - 在企业环境中部署和管理。- 遥测与监控 - 使用情况跟踪。- 工具参考 - 内置工具概述。- 本地开发 - 本地开发工具。

- 故障排除指南 - 常见问题和解决方案。- 常见问题解答 - 常见问题。- 使用 /bug 命令直接从 CLI 报告问题。在 ~/.gemini/settings.json 中配置 MCP 服务器，以使用自定义工具扩展 Gemini CLI：

> @github 列出我打开的拉取请求> @slack 将今天提交的摘要发送到 #dev 频道> @database 运行查询以查找非活跃用户有关设置说明，请参阅 MCP 服务器集成指南。我们欢迎贡献！

Gemini CLI 完全开源（Apache 2.0），我们鼓励社区：- 报告错误和提出功能建议。- 改进文档。- 提交代码改进。- 分享您的 MCP 服务器和扩展。请参阅我们的贡献指南，了解开发设置、编码标准以及如何提交拉取请求。

查看我们的官方路线图，了解计划的功能和优先级。- 免费课程 - 学习基础知识。- 官方路线图 - 了解下一步计划。- 更新日志 - 查看近期重要更新。- NPM 包 - 包注册表。- GitHub Issues - 报告错误或请求功能。

- 安全公告 - 安全更新。有关卸载说明，请参阅卸载指南。- 许可证：Apache License 2.0

- 服务条款：条款与隐私- 安全：安全政策由 Google 和开源社区用 ❤️ 构建