Gemini CLI 简介与安装指南

Gemini CLI 是一个由谷歌开发的创新开源命令行界面（CLI）工具，旨在将 Gemini AI 模型的强大功能直接带入您的终端。

对于开发者、DevOps 专业人士或喜爱命令行操作的用户来说，这款工具是一个颠覆性的存在。无论是编写代码、自动化任务还是生成内容。

Gemini CLI 都能无缝融入您的工作流程。本教程将介绍 Gemini CLI 是什么、其主要功能，并提供分步安装教程，帮助您快速上手。

Gemini CLI 是什么？

Gemini CLI 是一个免费的开源 AI 工具，允许用户通过终端直接与谷歌的 Gemini 2.5 Pro 模型交互。它专为喜欢命令行效率的开发者设计，拥有高达 100 万 token 的上下文窗口，能够处理复杂任务，如代码分析、调试、自动化和创意内容生成。

它还集成了 Google 搜索和模型上下文协议（MCP），使其在多种应用场景中表现出色。

Gemini CLI 的主要功能

• 代码理解与生成：分析大型代码库、编写代码并调试问题，使用自然语言提示。
• 多模态功能：利用谷歌的 Imagen 和 Veo 模型生成图像或视频，或处理 PDF 等文档。
• 自动化与工作流整合：直接从终端自动化重复性任务，如 Git 操作或 DevOps 工作流。
• Google 搜索整合：通过实时网络数据支持查询，提供准确且最新的响应。
• 开源且免费：采用 Apache 2.0 许可证，完全透明，免费提供每分钟 60 次请求和每天 1000 次请求的配额。
• 跨平台支持：支持 Windows、macOS 和 Linux，适合所有开发者使用。

为什么使用 Gemini CLI？

对于开发者来说，终端是生产力的核心。Gemini CLI 通过提供 AI 驱动的协助功能增强了这一环境，无需离开命令行。

无论是排查错误、生成测试用例还是创建项目文档，Gemini CLI 就像一位资深开发者在您身边，提供上下文相关的解决方案。其开源特性允许社区贡献，确保持续改进和透明度。

如何安装 Gemini CLI

安装 Gemini CLI 简单快捷，只需几分钟即可完成。以下是在 Windows、macOS 或 Linux 上的安装步骤。

前提条件

在安装 Gemini CLI 之前，请确保您已准备好：

• Node.js（18 或更高版本）：从 nodejs.org 下载并安装。
• 谷歌账户：需要用于身份验证以访问免费的 Gemini Code Assist 许可。
• 终端访问：使用命令行界面，如 Bash、PowerShell 或终端。
• 可选的 API 密钥：如需更高使用限制，可从 Google AI Studio 生成密钥。

安装教程

安装 Node.js：

• 访问 nodejs.org，下载适合您操作系统的安装程序。
• 按照提示完成 Node.js 安装。
• 通过以下命令验证安装：

node -v

命令将显示安装的版本（例如，v22.17.0）。

安装 Gemini CLI：

• 打开终端或 PowerShell（在 Windows  如需必要以管理员身份运行）。
• 使用 npm 全局安装 Gemini CLI，运行以下命令：

npm install -g @google/gemini-cli

或者，您可以无需全局安装直接尝试：

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

谷歌身份验证：

• 运行以下命令启动 Gemini CLI：

gemini

• 首次运行时，系统会提示您选择主题并进行身份验证。
• 选择“使用谷歌登录”以获取免费配额（每分钟 60 次请求，每天 1000 次请求），并使用您的谷歌账户登录。
• 或者，设置 API 密钥以获得更高限制：

export GEMINI_API_KEY="您的 API 密钥"

将 您的 API 密钥 替换为从 Google AI Studio 获取的密钥。在 Windows ，使用：

setx GEMINI_API_KEY "您的 API 密钥"

验证设置：

• 身份验证完成后，在终端中输入 gemini 启动交互式 CLI。
• 测试一个简单的命令：

gemini "你好，Gemini！"

如果收到响应，说明您的设置已完成！

安装问题排查

• 未找到 Node.js：确保已安装 Node.js 并添加到系统 PATH 中。运行 node -v 确认。
• 身份验证错误：如果谷歌登录失败，尝试使用 API 密钥或检查网络连接。如果网络不稳定，Gemini CLI 可能回退到 gemini-2.5-flash 模型。
• 权限问题：在 Windows 上，以管理员身份运行 PowerShell；在 Linux/macOS 上，如有提示使用 sudo。
• 代理问题：如果您使用代理，配置 npm：

npm config set proxy http://您的代理:端口
npm config set https-proxy http://您的代理:端口

开始使用 Gemini CLI

安装完成后，您可以使用 Gemini CLI 执行各种任务。以下是一些示例：

代码生成：

gemini "使用 HTML、CSS 和 JavaScript 创建一个简单的待办事项应用"

这将生成一个完整的待办事项应用并附带说明。

调试：

gemini "解释此文件中的错误" @src/main.js

附加文件以分析和修复错误。

自动化：

gemini "总结过去 7 天的 Git 历史"

生成最近项目变更的报告。

内容生成：

gemini --preset summary --web "https://news-site.com/article"

使用内置预设总结网页内容。

使用 Gemini CLI 的最佳实践

保护您的 API 密钥：将其存储在安全的配置文件中（例如，~/.local/etc/.env），并设置限制性权限：

mkdir -p ~/.local/etc
echo 'GEMINI_API_KEY="您的 API 密钥"' > ~/.local/etc/.env
chmod 600 ~/.local/etc/.env

使用清晰的提示：为获得最佳结果，清晰且具体地表述您的查询。

利用预设：使用内置预设，如 summary、sentiment 或 table，处理特定任务。

为社区贡献：Gemini CLI 是开源的，可在 GitHub 上报告问题或提出功能建议。

结论

Gemini CLI 是一个强大、免费且开源的工具，将您的终端转变为 AI 驱动的助手。凭借其在编码、自动化和内容生成方面的能力，它是提升开发者生产力的必备工具。

按照上述安装步骤，您可以在几分钟内开始使用 Gemini CLI。探索其功能，尝试自然语言提示，并加入开源社区，让它变得更强大！