### [Gemini CLI：105k Stars！Google官方终端AI Agent，让命令行拥有Gemini的超能力](https://www.willai.cc/article/1302)

**Published:** 2026-06-07T05:38:21

**Author:** hiyoho

**Excerpt:** Gemini CLI 是 Google 官方开源的终端 AI Agent 工具，105k+ Stars。免费额度慷慨（60次/分钟），100万token上下文，支持代码理解、生成、自动化工作流。

![Gemini CLI Screenshot](https://github.com/google-gemini/gemini-cli/raw/main/docs/assets/gemini-screenshot.png)

## 项目简介

**Gemini CLI** 是 Google 官方开源的终端 AI Agent 工具，将 Gemini 的强大能力直接集成到你的命令行终端中。它是目前从提示词到模型调用最直接的路径，为开发者提供了轻量级的 Gemini 访问入口。

**⭐ GitHub Stars:** 105k+  
**🔗 项目地址:** [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)  
**📄 开源协议:** Apache 2.0  
**🌐 官方网站:** [geminicli.com](https://geminicli.com)

## 安装要求和过程

### 环境要求

-   **Node.js** >= 18 (推荐 20+)
-   **npm** 或 **Homebrew** (macOS)
-   **Google 账号** (免费使用 Gemini API)

### 快速安装步骤

**方式一：npx 即时运行（推荐试用）**

```
npx @google/gemini-cli
```

**方式二：npm 全局安装**

```
npm install -g @google/gemini-cli
gemini --version
```

**方式三：Homebrew 安装（macOS/Linux）**

```
brew install gemini-cli
gemini
```

**首次启动认证：**

```
# 启动后会自动打开浏览器进行 Google 账号 OAuth 认证
gemini
```

## 核心功能

| 功能  | 说明  |
| --- | --- |
| **🧠 代码理解与生成** | 支持查询、编辑大型代码库；可基于 PDF、图片、草图等多模态内容生成新应用；支持自然语言调试问题、排查故障 |
| **🤖 自动化与集成** | 支持自动化操作任务，比如查询拉取请求、处理复杂变基；可通过 MCP 服务器扩展能力，包括对接 Imagen、Veo、Lyria 等媒体生成工具 |
| **🔍 高级能力** | 内置 Google Search 搜索能力，支持实时信息检索；支持对话检查点，可保存、恢复复杂会话；支持自定义上下文文件 GEMINI.md |
| **🚀 免费额度友好** | 个人 Google 账号即可享受免费 tier，支持 60 次请求/分钟、1000 次请求/天 |
| **🔧 内置工具丰富** | 自带 Google Search 搜索、文件操作、Shell 命令执行、网页抓取等能力；支持 MCP（模型上下文协议），可自定义集成第三方能力 |

## 典型使用场景

### 场景一：快速启动新项目

进入项目目录启动 `gemini` 后，直接用自然语言描述需求即可生成对应代码：

```
# 启动 Gemini CLI
cd my-new-project
gemini

# 在交互界面中输入：
> Write me a Discord bot that answers questions using a FAQ.md file I will provide
```

### 场景二：分析现有代码变更

克隆代码库后启动 `gemini`，可以快速获取代码变更总结：

```
# 克隆代码库
git clone https://github.com/some/repo.git
cd repo
gemini

# 在交互界面中输入：
> Give me a summary of all of the changes that went in yesterday
```

### 场景三：非交互式脚本自动化

使用 `-p` 参数可以在脚本中调用 Gemini CLI，实现工作流自动化：

```
# 获取简单文本响应
gemini -p "Explain the architecture of this codebase"

# 获取结构化 JSON 输出
gemini -p "Explain the architecture of this codebase" --output-format json

# 实时流式输出
gemini -p "Run tests and deploy" --output-format stream-json
```

## 推荐理由

作为一款终端原生的 AI Agent 工具，**Gemini CLI** 给我留下了深刻印象：

-   **官方背书，值得信赖：**Google 官方开源项目，持续维护，质量有保障
-   **免费额度慷慨：**个人开发者使用免费 Google 账号即可享受 60 次/分钟、1000 次/天的 API 调用额度，足够个人使用和小型项目开发
-   **100 万 token 上下文窗口：**支持 Gemini 2.5 Pro/Flash 等顶级模型，能够理解超大型代码库，一次性分析整个项目
-   **终端原生体验：**专为习惯命令行的开发者打造，操作流畅，无需离开终端即可完成代码理解、生成、调试全流程
-   **MCP 扩展性强：**支持模型上下文协议（MCP），可以对接 Imagen、Veo、Lyria 等媒体生成工具，未来潜力巨大

如果你是一名开发者，正在寻找一款轻量级、功能强大、免费额度慷慨的终端 AI 助手，**Gemini CLI** 绝对值得一试！

## 下载地址

-   📦 **GitHub 仓库：**[github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)
-   🌐 **官方网站：**[geminicli.com](https://geminicli.com)
-   📚 **官方文档：**[geminicli.com/docs](https://geminicli.com/docs/)
-   📦 **npm 包：**[@google/gemini-cli](https://www.npmjs.com/package/@google/gemini-cli)
-   💬 **Discord 社区：**[discord.gg/gemini-cli](https://discord.gg/gemini-cli)

**Tags:** AI, AI Agent, CLI, Gemini, GitHub, Google, 人工智能, 命令行工具, 开源, 终端

**Categories:** 开源项目

---