Gemini CLI 快速入门

本指南将详细介绍如何在您的计算机上安装和配置 Gemini 命令行界面 (CLI)，并特别关注在科学网络环境中的注意事项。Gemini CLI 允许您通过命令行与 Gemini API 交互，从而更灵活地开发和测试您的应用程序。

1. 安装 Gemini CLI

我们将使用 Homebrew 来安装 Gemini CLI。Homebrew 是一款 macOS 和 Linux 上的包管理器，它能简化软件的安装过程。

1.1 前提条件

在安装 Gemini CLI 之前，请确保您的系统已安装 Homebrew。如果您尚未安装，可以通过以下命令进行安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

1.2 安装 CLI

当 Homebrew 准备就绪后，打开您的终端并执行以下命令来安装 Gemini CLI：

brew install gemini-cli

安装完成后，您可以在任何路径下通过以下命令启动 Gemini CLI：

gemini

2. 获取和配置 Gemini API 密钥

Gemini API 密钥是您访问 Gemini 模型和功能的关键。Google AI Studio 提供了一个免费层级，允许每天 100 次使用 Gemini 2.5 Pro 模型，并可控制所使用的模型。付费计划则提供更高的请求速率限制。

2.1 生成 API 密钥

访问 Google AI Studio 并登录您的 Google 账户。在控制台中，点击生成密钥按钮。如果您遇到无法创建 API 密钥的提示，您需要手动前往 Google Cloud Console 创建一个新项目，然后返回 Google AI Studio 选择您已有的项目，例如“gemini cli (xxxx-123456-xx)”。

API 密钥生成成功后，您会看到 API key generated 的提示。重要提示：请妥善保管您的 API 密钥。切勿共享它，也不要将其嵌入到公开可见的代码中，以防未经授权的访问和滥用。

2.2 设置环境变量

为了让 Gemini CLI 能够识别并使用您的 API 密钥，您需要将其设置为一个环境变量。打开您的终端配置文件。对于大多数 macOS 用户，这是 ~/.zprofile 文件。您可以使用文本编辑器（如 nano 或 vim）打开它：

open ~/.zprofile

在文件末尾添加以下行，将 YOUR_API_KEY 替换为您刚刚生成的 API 密钥：

export GEMINI_API_KEY="您的API密钥"

保存并关闭文件。重新打开一个新的会话。

3. 科学网络环境下的注意事项

在一些科学网络环境或受限网络中，直接访问 Google 服务可能会受到限制。如果您在安装或配置过程中遇到网络连接问题（例如 Homebrew 下载缓慢或 API 密钥无法生成），请考虑以下几点：

• 配置代理服务器
• 防火墙规则
• VPN/加速器