Source: https://wiki.niceai.dev/guide/clients/gemini-cli

# Gemini CLI 接入自定义 API

Gemini CLI 通过环境变量 `GOOGLE_GEMINI_BASE_URL` 指定接口地址、`GEMINI_API_KEY` 指定密钥。把前者设为 `https://api.niceai.dev`、后者设为 NiceAI 密钥即可。

| 环境变量 | 填写内容 |
| --- | --- |
| `GOOGLE_GEMINI_BASE_URL` | `https://api.niceai.dev`（不加 `/v1beta`，SDK 会自动拼接） |
| `GEMINI_API_KEY` | 你的 NiceAI 密钥（Gemini 分组） |

已经安装 CC Switch 的话，也可以用 [CC Switch 一键导入](https://wiki.niceai.dev/guide/cc-switch)。

## 准备工作

1. 安装 Gemini CLI（参考其官方仓库说明）。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组选择 **Gemini**。

## 配置环境变量

### macOS / Linux

```bash
export GOOGLE_GEMINI_BASE_URL="https://api.niceai.dev"
export GEMINI_API_KEY="你的密钥"
gemini
```

长期生效：把两行 `export` 追加到 `~/.zshrc` 或 `~/.bashrc`。

### Windows PowerShell

```powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://api.niceai.dev"
$env:GEMINI_API_KEY = "你的密钥"
gemini
```

长期生效：

```powershell
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.niceai.dev", "User")
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的密钥", "User")
```

**没设 Base URL 时请求会发往 Google**
如果启动 Gemini CLI 的终端里没有 `GOOGLE_GEMINI_BASE_URL`，请求会直接发到 Google 官方接口。改完环境变量后记得重新打开终端。


## 在 Gemini SDK 中使用

直接调用 Gemini 接口时，地址是 `https://api.niceai.dev/v1beta`。使用 Google 的 `google-genai` Python SDK 时，把 base_url 设为根地址即可：

```python
from google import genai

client = genai.Client(
    api_key="你的密钥",
    http_options={"base_url": "https://api.niceai.dev"},
)
resp = client.models.generate_content(model="<模型名，见模型广场>", contents="你好")
print(resp.text)
```

## 常见问题

### 报 401 或 403？

确认密钥分组是 Gemini，且 `GEMINI_API_KEY` 在当前终端已生效。

### 404？

`GOOGLE_GEMINI_BASE_URL` 不要加 `/v1beta`。直接用 curl 请求时才需要带 `/v1beta`。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

## 下一步

- [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)
- [Codex CLI 接入](https://wiki.niceai.dev/guide/codex)
