使用说明
Gemini CLI
Gemini CLI是一个开源的AI代理，直接带来Gemini的强大功能 进入您的终端。它提供了对Gemini的轻量级访问，为您提供 从您的提示到我们的模型的最直接路径。
在我们的网站上了解有关Gemini CLI的所有信息 文档.
🚀 为什么选择Gemini CLI？
- 🎯 免费套餐：使用个人谷歌，每分钟60个请求，每天1000个请求 账户
- 🧠 强大的Gemini 3型号：获得改进的推理和1M令牌 上下文窗口。
- 🔧 内置工具：谷歌搜索基础、文件操作、shell 命令、网络抓取。
- 🔌 可扩展：MCP（模型上下文协议）支持自定义 整合。
- 💻 终端优先：专为使用命令行的开发人员设计。
- 🛡️ 开源：Apache 2.0已获得许可。
📦 安装
安装前的先决条件
- Node.js版本20或更高
- macOS、Linux或Windows
快速安装
使用npx立即运行
# Using npx (no installation required)
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安装（适用于受限环境）
# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli
释放节奏和标签
看 发布 了解更多详情。
预览
新的预览版将于每周二UTC 2359发布。这些
发布版本尚未经过全面审查，可能包含回归或其他
悬而未决的问题。请帮助我们测试和安装 preview 标签。
npm install -g @google/gemini-cli@preview
稳定
- 新的稳定版本将于每周二UTC 2000发布
将是上周的全面推广
preview发布+任何bug修复 以及验证。使用latest标签。
npm install -g @google/gemini-cli@latest
每夜
- 新版本将于每天UTC 0000发布。这将是所有的变化
来自发布时所代表的主分支。应该假设
还有待验证和问题。使用
nightly标签。
npm install -g @google/gemini-cli@nightly
📋 主要特点
代码理解和生成
- 查询和编辑大型代码库
- 使用多模式功能从PDF、图像或草图生成新应用程序
- 使用自然语言调试问题和排除故障
自动化与集成
- 自动化操作任务，如查询拉取请求或处理复杂的 低于
- 使用MCP服务器连接新功能，包括 使用Imagen、Veo或Lyria进行媒体生成
- 在脚本中非交互式运行以实现工作流自动化
高性能
- 使用内置功能将您的查询固定下来 谷歌搜索 实时 信息
- 会话检查点，用于保存和恢复复杂会话
- 自定义上下文文件（GEMINI.md），为您的项目量身定制行为
GitHub 集成
通过以下方式将Gemini CLI直接集成到您的GitHub工作流中 Gemini CLI GitHub操作:
- 拉取请求评论：带有上下文反馈的自动代码审查 建议
- 问题分类：基于GitHub问题的自动标记和优先级排序 论内容分析
- 按需援助：提及
@gemini-cli在issues和pull请求中 有关调试、解释或任务委派的帮助 - 自定义工作流：构建自动化、定时和按需的工作流程 根据您团队的需求量身定制
🔐 身份验证选项
选择最适合您需求的身份验证方法：
选项1：使用Google登录（使用您的Google帐户进行OAuth登录）
✨ 最适合： 个人开发人员以及任何拥有Gemini代码的人 协助许可证。（参见 配额限制和服务条款 详情）
优点：
- 免费套餐：60个请求/分钟，1000个请求/天
- Gemini 3型号 具有1M令牌上下文窗口
- 没有API密钥管理 -只需使用您的Google帐户登录
- 自动更新 至最新型号
启动Gemini CLI，然后选择 使用谷歌登录 并在提示时遵循浏览器身份验证流程
gemini
如果您使用的是贵组织的付费代码辅助许可证，请记住设置谷歌云项目
# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini
方案2：Gemini API密钥
✨ 最适合： 需要特定模型控制或付费层访问权限的开发人员
优点：
- 免费套餐：Gemini 3（flash和pro混合）每天1000个请求
- 模型选择：选择特定的Gemini型号
- 基于使用量的计费：需要时升级以获得更高的限制
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini
选项3：顶点AI
✨ 最适合： 企业团队和生产工作量
优点：
- 企业特性：先进的安全性和合规性
- 可扩展的：账单账户的费率限制更高
- 整合：与现有的谷歌云基础设施兼容
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini
有关Google Workspace帐户和其他身份验证方法，请参阅 身份验证指南.
🚀 入门指南
基本用法
从当前目录开始
gemini
包含多个目录
gemini --include-directories ../lib,../docs
使用特定型号
gemini -m gemini-2.5-flash
脚本的非交互模式
获取简单的文本响应：
gemini -p "Explain the architecture of this codebase"
对于更高级的脚本编写，包括如何解析JSON和处理错误，请使用
这 --output-format json 获取结构化输出的标志：
gemini -p "Explain the architecture of this codebase" --output-format json
对于实时事件流（可用于监视长时间运行的操作），
使用 --output-format stream-json 要获取换行符分隔的JSON事件：
gemini -p "Run tests and deploy" --output-format stream-json
快速示例
启动一个新项目
cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide
分析现有代码
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday
📚 文档
入门指南
核心功能
- 命令参考 -所有斜线命令
(
/help,/chat等等）。 - 自定义命令 -创建自己的 可重复使用的命令。
- 上下文文件（GEMINI.md） -提供持久 Gemini CLI的上下文。
- 检查点 -保存并恢复 对话。
- 令牌缓存 -优化代币使用。
工具和扩展
高级主题
- 无头模式（脚本） -在中使用Gemini CLI 自动化工作流程。
- 架构概述 -Gemini CLI的工作原理。
- IDE集成 -VS代码伴侣。
- 沙盒和安全 -安全执行 环境。
- 受信任的文件夹 -控制执行 按文件夹的策略。
- 企业指南 -在 企业环境。
- 遥测与监测 -使用情况跟踪。
- 工具API开发 -创建自定义工具。
- 本地开发 -地方发展 工具。
故障排除和支持
使用MCP服务器
在中配置MCP服务器 ~/.gemini/settings.json 使用以下命令扩展Gemini CLI
自定义工具：
> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users
看 MCP服务器集成指南 用于设置 说明。
🤝 贡献
我们欢迎捐款！Gemini CLI是完全开源的（Apache 2.0），我们 鼓励社区：
- 报告错误并建议功能。
- 改进文档。
- 提交代码改进。
- 共享您的MCP服务器和扩展。
查看我们的 贡献指南 用于开发设置、编码 标准以及如何提交pull请求。
查看我们的 官方路线图 对于计划的功能和优先级。
📖 资源
卸载
看 卸载指南 有关拆卸说明。
📄 法律
- 许可证: Apache许可证2.0
- 服务条款: 条款和隐私
- 安全: 安全策略
Built with ❤️ by Google and the open source community
