Google Gemini CLI 免费安装配置指南：支持Gemini 2.5 Pro (2025最新)

Google Gemini CLI 免费安装与配置指南

Google推出的Gemini CLI是一款强大的命令行工具，它允许开发者直接在终端中与Gemini模型进行交互。本文将为你提供一份清晰的安装与配置指南，帮助你快速上手，免费使用强大的Gemini 2.5 Pro模型。

Gemini CLI 核心能力

步骤一：环境准备

在安装之前，请确保你的电脑已经安装了 Node.js (版本 20 或更高)。

你可以在终端中输入以下命令来检查当前版本：

node --version

如果未安装或版本过低，请访问 Node.js 官网 下载并安装最新版本。为了获得最佳的命令行体验，推荐使用Windows的WSL、原生Linux或macOS环境。

步骤二：安装 Gemini CLI

Google 提供了多种安装方式，你可以根据自己的偏好选择其一。

方式一：使用 npx (推荐，无需全局安装)

这是最简单快捷的方式，可以直接运行而无需在你的系统中全局安装。

# 直接运行 Gemini CLI
npx https://github.com/google-gemini/gemini-cli

方式二：使用 npm (全局安装)

如果你希望在任何路径下都能直接使用 gemini 命令，可以选择全局安装。

npm install -g @google/gemini-cli

方式三：使用 Homebrew (适用于 macOS 或 Linux)

如果你的系统安装了 Homebrew，也可以使用它来安装。

brew install gemini-cli

步骤三：配置 Gemini CLI

安装完成后，你需要进行配置，将工具与你的Google账户或API密钥关联起来。

直接在命令行输入 gemini 即可启动配置向导和开始对话。

gemini

强烈建议：首次运行时，花几分钟时间创建一个 GEMINI.md 配置文件。这个文件可以用来设定长期有效的上下文或“记忆”，避免每次对话都重复提供背景信息。

你有以下几种配置方式：

1. 使用 Google 账户登录 (最简单)

运行 gemini 命令后，会引导你通过浏览器登录自己的Google账户。按照提示操作即可，这是最简单的方式。

2. 使用 API 密钥 (推荐，更灵活)

这种方式更适合开发者和自动化脚本。

首先，你需要免费获取API密钥：

1. 访问 Google AI Studio。
2. 登录后，点击 "Get API key" -> "Create API key"。
3. 复制生成好的密钥。

然后，在终端中设置环境变量。

临时配置 (仅当前终端窗口有效):

# 将 YOUR_API_KEY 替换成你自己的密钥
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

永久配置 (推荐): 将密钥信息写入你终端的配置文件中（如 ~/.bashrc, ~/.zshrc 等）。

# 这会将密钥写入 .bashrc 文件，新开终端时会自动生效
echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
# 如果你使用 Zsh，请将 .bashrc 替换为 .zshrc

3. 使用 Vertex AI (企业级，收费)

这是面向企业用户的付费方式，需要通过 Google Cloud Console 获取密钥。

export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

关于第三方API：市面上有一些提供转发服务的第三方API，虽然可能在特定情况下能解决网络问题，但稳定性和安全性无法保证，请谨慎甄别。

完成以上步骤后，你的Gemini CLI就配置好了。现在，你可以在终端里尽情探索Google AI的强大能力了。