# Gemini CLI

来源: https://docs.aicentos.com/clients/gemini-cli

Language: zh-CN

> 在 Gemini CLI 中使用 aicentos —— 通过环境变量配置自定义网关

Gemini CLI 是 Google 官方推出的命令行工具，支持通过环境变量配置自定义网关来接入 Codex Proxy 服务，实现在终端中与 Gemini 模型进行交互对话。

## 准备工作

Gemini CLI 通过 npm 全局安装，需要先准备好 Node.js 18+ 和 npm 环境。

### 安装 Node.js

* 访问 Node.js 官网下载页面：[https://nodejs.org/en/download](https://nodejs.org/en/download)
* macOS/Windows：下载并安装 LTS 版本
* Linux：按页面提供的发行版方式安装
* macOS（Homebrew 用户）：执行 `brew install node`

### 验证安装

```bash
node -v
npm -v
```

## 安装 Gemini CLI

使用 npm 全局安装 Gemini CLI：

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

验证安装：

```bash
gemini --version
```

## 配置环境变量

Gemini CLI 支持通过以下三个环境变量接入自定义网关：

| 环境变量                     | 说明                     |
| ------------------------ | ---------------------- |
| `GOOGLE_GEMINI_BASE_URL` | 网关服务根地址，替换 Google 默认端点 |
| `GEMINI_API_KEY`         | 你的 API Key             |
| `GEMINI_MODEL`           | 默认使用的模型                |

### 配置示例

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"
```

### 注意事项

* `GOOGLE_GEMINI_BASE_URL` 填写服务根地址，不需要带具体接口路径
* 临时测试：直接在当前 shell 会话中执行上述 export 命令
* 永久生效：将 export 语句加入 `~/.zshrc` 或 `~/.bashrc`，然后执行 `source ~/.zshrc` 使其生效

## 启动 Gemini CLI

配置完成后，直接运行以下命令启动：

```bash
gemini
```

启动后即可在终端中与 Gemini 模型进行交互对话。

## 验证接入

在 Gemini CLI 中发起一次对话，如果能正常收到回复，说明接入成功。

### 常见问题排查

* 如果遇到鉴权错误，请确认 `GEMINI_API_KEY` 是否正确
* 检查 `GOOGLE_GEMINI_BASE_URL` 是否指向正确的服务地址

## 注意事项

* 当前服务已支持 Gemini 兼容接口，可直接用于 Gemini CLI
* 环境变量配置建议加入 shell 配置文件以实现永久生效
* Gemini CLI 会自动拼接 API 路径，无需在 BASE\_URL 中添加具体接口路径

## 相关链接

* 官方文档：[https://docs.aicentos.com/clients/gemini-cli.html](https://docs.aicentos.com/clients/gemini-cli.html)