Gemini CLI - Google Gemini AI 编程助手命令行工具

简介

Gemini CLI 是 Google 推出的开源 AI 命令行工具，将 Gemini 的强大能力直接集成到你的终端中。这是一个专为开发者打造的终端优先的 AI 助手，提供轻量级的访问方式，让你能够直接在命令行中使用 Gemini 进行编程辅助。

主要特性

免费额度：使用个人 Google 账号可享受每分钟 60 次请求、每天 1000 次请求的免费额度
强大的模型：访问 Gemini 3 系列，支持 100 万 token 的上下文窗口
内置工具：集成 Google 搜索、文件操作、Shell 命令、Web 获取等工具
可扩展：支持 MCP（Model Context Protocol）协议，可自定义集成
终端优先：专为命令行开发者设计，提供流畅的终端体验
开源：Apache 2.0 许可证，完全开源

核心功能

1. 代码理解与生成

查询和编辑大型代码库
利用多模态能力从 PDF、图像或草稿生成新应用
使用自然语言调试问题

2. 自动化与集成

自动化操作任务，如查询 Pull Request 或处理复杂的代码库操作
使用 MCP 服务器连接新功能
以非交互方式在脚本中运行，实现工作流自动化

3. 高级能力

内置 Google 搜索支持，获取实时信息
对话检查点功能，保存和恢复复杂会话
自定义上下文文件（GEMINI.md）来定制项目行为

4. GitHub 集成

Pull Request 评审：自动化代码审查，提供上下文反馈和建议
问题分类：基于内容分析自动标记和优先级排序 GitHub 问题
按需协助：在问题和 Pull Request 中提及 @gemini-cli 获取帮助
自定义工作流：构建自动化的、定时的和按需的工作流

安装方法

方式一：使用 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

版本选择

预览版（Preview）

每周二 UTC 23:59 发布，包含最新功能但可能有未验证的问题：

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

稳定版（Stable）

每周二 UTC 20:00 发布，是上周预览版的完整推广版本：

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

每日版（Nightly）

每天 UTC 00:00 发布，包含 main 分支的所有更改：

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

认证方式

方式一：Google 账号登录（推荐个人用户）

最适合个人开发者，免费额度：60 请求/分钟，1000 请求/天

gemini

启动后会提示使用 Google 账号登录，按照浏览器认证流程操作即可。

如果使用组织的付费 Code Assist License，记得设置 Google Cloud Project：

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

方式二：Gemini API Key

最适合需要特定模型控制的开发者，从 https://aistudio.google.com/apikey 获取密钥：

export GEMINI_API_KEY="YOUR_API_KEY"
gemini

方式三：Vertex AI（企业级）

最适合企业团队和生产工作负载：

export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

使用示例

基本使用

在当前目录启动：

gemini

包含多个目录：

gemini --include-directories ../lib,../docs

使用特定模型：

gemini -m gemini-2.5-flash

非交互模式

简单文本响应：

gemini -p "Explain the architecture of this codebase"

JSON 格式输出：

gemini -p "Explain the architecture of this codebase" --output-format 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

MCP 服务器集成

在 ~/.gemini/settings.json 中配置 MCP 服务器来扩展 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

系统要求

Node.js 版本 20 或更高
macOS、Linux 或 Windows

下载链接

GitHub 仓库：https://github.com/google-gemini/gemini-cli
NPM 包：https://www.npmjs.com/package/@google/gemini-cli
官方文档：https://geminicli.com/docs/
Google Cloud 文档：https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli

总结

Gemini CLI 是一个强大而灵活的命令行 AI 助手，为开发者提供了在终端中使用 Gemini 的最直接方式。无论是代码审查、bug 修复、新功能开发，还是自动化工作流，Gemini CLI 都能显著提升开发效率。加上丰富的 MCP 生态系统和 GitHub 集成，使其成为开发者工具箱中不可或缺的利器。

Gemini CLI – Google Gemini AI 编程助手 命令行工具

简介