在 Windows 和 Linux 上安装 Gemini CLI 的终极指南

blog.postMeta

开始使用一个强大的新命令行工具有时会让人望而生畏，尤其是在环境设置方面。本指南提供了清晰、易于遵循的说明，以确保官方 Gemini CLI 在您的 Windows 或 Linux 机器上顺利运行。

前提条件：Node.js 和 npm

Gemini CLI 是作为 Node.js 包分发的，这意味着您首先需要在您的系统上安装 Node.js 及其包管理器 npm。

检查您是否已安装它们： 打开您的终端（命令提示符、PowerShell 或您的 Linux 终端）并运行 node -v 和 npm -v。如果您看到版本号，那么您就准备好了！
如何安装它们： 如果您没有安装它们，我们强烈建议您访问 Node.js 官网并为您的操作系统下载 LTS (长期支持) 版本。安装程序将为您处理一切。

准备好 Node.js 和 npm 后，安装 Gemini CLI 只需一个命令。-g 标志很重要，因为它会在您的系统上"全局"安装该包，使得 gemini 命令可以从任何目录访问。

打开您的终端并运行以下命令：

npm install -g @google/generative-ai

此命令从 npm 注册表下载该包并在您的系统上进行设置。

如果您不想全局安装该包或只是想快速试用，您可以使用 npx。这个与 npm 捆绑在一起的命令会临时下载并运行该包，而不会在您的系统上永久安装它。

只需在您的 gemini 命令前加上 npx @google/generative-ai：

npx @google/generative-ai "迄今为止发现的最遥远的星系是什么，它有多远？"

这是一个立即开始的绝佳方式。在本指南的其余部分，我们将假设您已经执行了全局安装。

要使用 CLI，您需要使用 Google AI API 密钥进行身份验证。此密钥告诉 Google 是谁在发出请求。如果您还没有密钥，我们有一个完整的教程，"如何通过3个简单步骤获取您的Google Gemini API密钥（2025年指南）"，它将引导您完成整个过程。

一旦您有了密钥，请将其复制到剪贴板并进行下一步。

您需要让 gemini 命令能够访问您的 API 密钥。最安全和推荐的方法是设置一个环境变量。

打开您的 shell 配置文件。这通常是 ~/.bashrc、~/.zshrc（对于大多数现代系统，包括 macOS）或 ~/.profile。
将以下行添加到文件末尾。请确保将 YOUR_API_KEY 替换为您复制的实际密钥。
```
export GOOGLE_API_KEY="YOUR_API_KEY"
```
保存文件并重新启动您的终端，或运行 source ~/.zshrc（或您对应的文件）以立即应用更改。

有关视觉指南，这些简短的视频涵盖了该过程的关键步骤。

1. 如何全局安装 NPM 包：

Video Tutorial: 全局安装 npm 包

2. 如何在 Windows 上设置环境变量：

Video Tutorial: 如何在 Windows 11 中设置环境变量

一切就绪！要确认一切正常，请在您的终端中运行一个简单的测试命令：

gemini "迄今为止发现的最遥远的星系是什么，它有多远？"

如果安装成功，您应该会从 Gemini 模型收到详细的回答。恭喜，您已成功安装和配置 Gemini CLI！

command not found: gemini：这通常意味着全局 npm 安装目录不在您系统的 PATH 中。Node.js 安装程序应该会处理这个问题，但如果没有，您可能需要手动添加它。
身份验证错误：如果您收到关于身份验证的错误，请仔细检查您是否已正确设置 GOOGLE_API_KEY 环境变量，并且没有拼写错误。确保在设置后已重新启动终端。