> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI 配置教程

> 在 Gemini CLI 中配置 Crazyrouter API，并使用已经过真实请求验证的模型与认证方式

> 更新日期：2026-06-06

## 概述

Gemini CLI 是 Google 的命令行 AI 助手。通过配置 Crazyrouter 的 Gemini 原生入口，你可以在命令行中直接使用已经在本站生产环境完成真实请求验证的 Gemini 模型。

## 配置方法

### 环境变量

Gemini CLI 当前版本在 API Key 模式下，至少需要显式提供 `GEMINI_API_KEY`。如果你要接入 Crazyrouter 的 Gemini 原生入口，建议同时配置这 3 个环境变量：

```bash theme={null}
export GEMINI_API_KEY=sk-xxx
export GEMINI_MODEL=gemini-3.1-pro
export GOOGLE_GEMINI_BASE_URL=https://api.crazyrouter.com
```

Windows PowerShell:

```powershell theme={null}
$env:GEMINI_API_KEY="sk-xxx"
$env:GEMINI_MODEL="gemini-3.1-pro"
$env:GOOGLE_GEMINI_BASE_URL="https://api.crazyrouter.com"
```

如果你希望每次打开终端自动生效，可以写入 `~/.gemini/.env` 或 PowerShell profile。

### 配置文件

编辑 `~/.gemini/settings.json`：

```json theme={null}
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  },
  "apiKey": "sk-xxx",
  "baseUrl": "https://api.crazyrouter.com",
  "model": {
    "name": "gemini-3.1-pro"
  }
}
```

注意：

* 不要把认证方式保留为 `oauth-personal`，否则 CLI 会继续走 Google 登录。
* 不要把 `model` 写成字符串，当前版本应使用 `model.name`。
* 仅写 `settings.json` 在部分场景下还不够，命令行模式仍可能要求 `GEMINI_API_KEY` 环境变量。

### `.gemini/.env` 示例

你也可以直接写入 `~/.gemini/.env`：

```bash theme={null}
GEMINI_API_KEY=sk-xxx
GEMINI_MODEL=gemini-3.1-pro
GOOGLE_GEMINI_BASE_URL=https://api.crazyrouter.com
```

### 启动

```bash theme={null}
gemini
```

## 推荐模型

| 模型               | 说明                                                                |
| ---------------- | ----------------------------------------------------------------- |
| `gemini-3.1-pro` | 2026 年 4 月 8 日已在 Crazyrouter 生产环境通过 Gemini CLI 真实请求实测成功，适合作为当前主基线 |

<Note>
  Crazyrouter 同时支持 Gemini 原生 API 格式和 OpenAI 兼容格式。Gemini CLI 使用 Gemini 原生格式。本文档中的 `gemini-3.1-pro`、`gemini-api-key` 认证方式，以及 `GOOGLE_GEMINI_BASE_URL=https://api.crazyrouter.com` 已基于真实 CLI 请求验证通过。
</Note>