Gemini CLI
  ](https://www.npmjs.com/package/@google/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服务器连接新功能,包括
- 在脚本中非交互式运行以实现工作流自动化
高性能
- 使用内置功能将您的查询固定下来
谷歌搜索 实时 信息
- 会话检查点,用于保存和恢复复杂会话
- 自定义上下文文件(GEMINI.md),为您的项目量身定制行为
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的上下文。
- 检查点 -保存并恢复
对话。
- 令牌缓存 -优化代币使用。
工具和扩展
- 文件系统操作 - Shell 命令 - Web提取和搜索
- MCP服务器集成 -自定义扩展
工具。
- 自定义扩展 -构建并分享你自己的
命令。
高级主题
- 无头模式(脚本) -在中使用Gemini CLI
自动化工作流程。
环境。
- 受信任的文件夹 -控制执行
按文件夹的策略。
- 企业指南 -在
企业环境。
工具。
故障排除和支持
- 故障排除指南 -常见问题和
解决。
- 常见问题解答 -常见问题。
- 使用
/bug命令直接从CLI报告问题。
使用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
