---
url: /tutorial/integrations/gemini-cli.md
---

# 使用 CloseAI 驱动 Gemini CLI

Gemini CLI 是 Google 官方出品的命令行工具，让您可以直接在终端中与强大的 Gemini 系列模型进行交互。

由于国内无法直接登录谷歌账号使用，且谷歌账号方式有限制，可以使用CloseAI 平台对 Gemini CLI 进行了无缝适配。通过本教程的简单配置，您就可以使用 CloseAI 统一的 API Key来访问 Gemini 模型，享受每日不限量的使用。

## 准备工作

在开始之前，请确保您已经拥有：

1. 一个 [CloseAI 账户](https://www.closeai.com/)。
2. 一个 CloseAI API Key。您可以在您的账户仪表板中生成和管理。
3. 已安装 [Node.js](https://nodejs.org/en/download/) (版本需 >= 18) 和 npm。

## 第一步：安装 Gemini CLI

首先，使用 npm (Node Package Manager) 在您的系统上全局安装 Gemini CLI。请打开终端并运行以下命令：

```bash
npm install -g @google/gemini-cli
```

安装成功后，您就可以在终端的任何位置使用 `gemini` 命令了。

## 第二步：配置环境变量

配置环境变量是让 Gemini CLI 通过 CloseAI 运行的关键一步。我们需要设置两个变量：一个用于指定 API 的接入点，另一个用于存放您的 API Key。

:::tabs
\== macOS / Linux

将以下两行命令添加到您的 shell 配置文件中 (例如 `~/.zshrc` 或 `~/.bashrc`)。

**请将 `sk-xxxxxxxx` 替换为您自己的 CloseAI API Key。**

```bash
export GOOGLE_GEMINI_BASE_URL="https://api.openai-proxy.org/google"
export GEMINI_API_KEY="sk-xxxxxxxx"
export GOOGLE_GENAI_USE_VERTEXAI=true # 这一步是可选的，但是加上最好，Vertex的版本面向企业应用，稳定性更高
```

添加完成后，执行 `source ~/.zshrc` (或您对应的配置文件) 或重启终端，以使配置生效。

\== Windows

Windows 请在 **PowerShell** 中使用 `setx` 命令设置**用户级持久化环境变量**，依次执行（不要用 macOS/Linux 的 `export` 语法，PowerShell 不认）。请将 `sk-xxxxxxxx` 替换为您自己的 CloseAI API Key：

```powershell
setx GOOGLE_GEMINI_BASE_URL "https://api.openai-proxy.org/google"
setx GEMINI_API_KEY "sk-xxxxxxxx"
setx GOOGLE_GENAI_USE_VERTEXAI "true"
```

> 第三条 `GOOGLE_GENAI_USE_VERTEXAI` 是可选的，但加上更好：Vertex 版本面向企业应用，稳定性更高。

设置完成后，**关闭当前 PowerShell 窗口并重新打开一个**，运行以下命令验证是否生效：

```powershell
echo $env:GEMINI_API_KEY
```

能正确打印出您的 Key 即表示配置成功。

**⚠️ Windows 环境变量三大坑（90% 的报错都来自这里）**

1. **不要用 `export`**：那是 macOS/Linux 的写法，PowerShell 不认，敲了不会生效。
2. **不要用 `$env:GEMINI_API_KEY="..."` 这种临时写法**：它只对当前窗口生效，窗口一关就没了。
3. **`setx` 设置后必须关闭并重新打开终端**：`setx` 不会影响已经打开的窗口，新值只在之后新开的终端里才生效。

> 如果您习惯使用 Git Bash，也可以像 macOS/Linux 一样把上面三条 `export` 写入 `~/.bashrc`，再执行 `source ~/.bashrc` 生效。

:::

## 第三步：开始使用

所有配置都已就绪！现在，您可以直接在终端中启动 Gemini CLI 了。

```bash
gemini
```

程序启动后，您可以直接开始提问。由于我们已经配置了环境变量，Gemini CLI 会自动使用您的 CloseAI API Key 并通过我们的服务进行连接，无需任何额外的手动认证步骤。

```
You: >> 编写一个python函数，计算斐波那契数列
```

祝您使用愉快！

## 故障排查

### npm 全局安装权限问题

在执行 `npm install -g` 命令时，您可能会遇到 `EACCES` 权限错误。这是因为 npm 的全局安装目录在默认情况下需要管理员权限。

为了解决这个问题，您可以将相关目录的所有权变更为您当前的用户，这样就可以免去每次全局安装都需要输入 `sudo` 的麻烦。

在终端中运行以下命令：

```bash
sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin
```

执行完毕后，再次尝试运行 `npm install -g` 命令即可。

### Windows 环境变量不生效

如果在 Windows 上配置后报认证失败或提示找不到 API Key，多半是环境变量没真正生效：

1. 确认用的是 `setx`，而不是 `export`（PowerShell 不认 `export`）或 `$env:GEMINI_API_KEY="..."`（只对当前窗口生效）。
2. `setx` 设置后**必须关闭并重新打开终端**，老窗口读不到新值。
3. 在新终端里执行 `echo $env:GEMINI_API_KEY`，确认能正确打印出您的 Key。