Gemini CLI

Gemini CLI：终端中的开源 AI 代理

Gemini CLI 是一款开源 AI 代理，旨在将 Gemini 的强大功能直接带入您的终端。它为 Google 的 Gemini 模型提供了一个轻量级的命令行界面，为开发者提供了一条从提示到 AI 的直接路径。该工具采用 Apache 2.0 许可，可以免费使用和修改。

什么是 Gemini CLI？

Gemini CLI 是一个命令行工具，允许开发者直接从终端与 Google 的 Gemini AI 模型进行交互。它支持各种功能，包括代码理解和生成、调试、自动化以及与其他工具和服务的集成。主要目标是为开发者提供一种无缝且高效的方式，在他们的开发工作流程中利用 AI。

Gemini CLI 如何工作？

Gemini CLI 的工作原理是提供一个命令行界面，用于与 Google 的 Gemini AI 模型进行交互。它支持以下几个关键特性：

• 访问 Gemini 模型：提供对 Gemini 2.5 Pro 的访问，具有 100 万个 token 的上下文窗口。
• 内置工具：集成 Google 搜索以进行 grounding、文件操作、shell 命令和网络获取。
• 可扩展性：支持 MCP（模型上下文协议）以进行自定义集成。

Gemini CLI 的主要特性

Gemini CLI 具有一系列旨在增强您的开发工作流程的功能：

• 代码理解与生成：
  • 查询和编辑大型代码库。
  • 使用多模态功能从 PDF、图像或草图生成新应用。
  • 使用自然语言调试问题和进行故障排除。
• 自动化与集成：
  • 自动化操作任务，例如查询拉取请求或处理复杂的 rebase。
  • 使用 MCP 服务器连接新功能，包括使用 Imagen、Veo 或 Lyria 生成媒体。
  • 在脚本中以非交互方式运行以实现工作流程自动化。
• 高级功能：
  • 使用内置的 Google 搜索来 grounding 您的查询，以获取实时信息。
  • 会话检查点，用于保存和恢复复杂的会话。
  • 自定义上下文文件 (GEMINI.md)，用于为您的项目定制行为。

如何使用 Gemini CLI？

1. 安装：您可以使用 npm、npx 或 Homebrew 安装 Gemini CLI：

   # 使用 npx（无需安装）
   

npx https://github.com/google-gemini/gemini-cli

# 使用 npm 全局安装

npm install -g @google/gemini-cli

# 使用 Homebrew 全局安装 (macOS/Linux)

brew install gemini-cli ```

2. 身份验证：选择一种身份验证方法：

   • 使用 Google 登录 (OAuth)：适用于个人开发者和 Google AI Pro/AI Ultra 订阅者。

gemini ```

*   **Gemini API 密钥**：适用于需要特定模型控制或付费层级访问权限的开发者。

    ```bash

export GEMINI_API_KEY="YOUR_API_KEY" gemini ```

*   **Vertex AI**：适用于企业团队和生产工作负载。

    ```bash

export GOOGLE_API_KEY="YOUR_API_KEY" export GOOGLE_GENAI_USE_VERTEXAI=true gemini ```

3. 基本用法：

   # 在当前目录中启动
   

gemini

# 包含多个目录

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

# 使用特定模型

gemini -m gemini-2.5-flash

# 获取简单的文本响应

gemini -p "Explain the architecture of this codebase" ```

为什么选择 Gemini CLI？

• 免费层级：使用个人 Google 帐户享受 60 个请求/分钟和 1,000 个请求/天。
• 强大的 Gemini 2.5 Pro：访问具有 100 万个 token 上下文窗口的先进 Gemini 2.5 Pro 模型。
• 终端优先设计：针对喜欢在命令行中工作的开发者进行了优化。
• 开源：受益于 Apache 2.0 许可项目的透明度和社区支持。

Gemini CLI 适合哪些人？

Gemini CLI 非常适合：

• 希望将 AI 集成到其工作流程中的开发者。
• 希望自动化代码相关任务的团队。
• 喜欢使用命令行界面与 AI 模型交互的工程师。
• 需要可扩展且安全的 AI 解决方案的企业。

GitHub 集成

Gemini CLI 提供与 GitHub 的无缝集成：

• 拉取请求审查：通过上下文反馈进行自动化代码审查。
• 问题分类：自动标记 GitHub 问题并确定其优先级。
• 按需帮助：在问题和拉取请求中提及 @gemini-cli 以获得帮助。
• 自定义工作流程：构建根据您的团队需求量身定制的自动化工作流程。

使用 Gemini CLI 的最佳方式？

要充分利用 Gemini CLI，请考虑以下事项：

• 利用内置工具（如 Google 搜索）来 grounding 您的查询，以获取实时信息。
• 利用会话检查点来保存和恢复复杂的会话。
• 使用 GEMINI.md 上下文文件自定义行为，以根据您的项目定制 Gemini CLI。

通过遵循这些指南，您可以有效地利用 Gemini CLI 来增强您的开发工作流程并自动化与编码和项目管理相关的各种任务。

总而言之，Gemini CLI 提供了一种强大而灵活的方式，将 AI 集成到您的开发环境中。它的开源特性，加上其广泛的功能集，使其成为希望直接从终端利用 Gemini 模型强大功能的开发者不可或缺的工具。