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

# Gemini CLI

> 了解如何将 Gemini CLI 的 base URL 指向 siflow endpoint（Gemini-compatible），并使用兼容 Gemini 协议的算秩模型。

[Gemini CLI](https://github.com/google-gemini/gemini-cli) 是 Google 开源的终端 AI 智能体。它使用 Gemini API 协议；将 Gemini CLI 的 base URL 指向 siflow Gemini-compatible endpoint 后，即可使用该协议下的模型。

该协议下可用模型包括：`gemini-3.5-flash`、`gemini-3.1-pro-preview` 和 `gemini-3-flash-preview`。价格请查看 [模型广场](https://console.siflow.cn/model-inference/models)。

## 配置

在 [API 密钥](https://console.siflow.cn/model-inference/api_keys) 页面创建 API Key，并在启动 Gemini CLI 前设置两个环境变量：

```bash theme={null}
export GEMINI_API_KEY="<Your API Key>"
export GOOGLE_GEMINI_BASE_URL="https://api.siflow.cn/model-api"
```

| 变量                       | 说明                                                                                                                                                    |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GEMINI_API_KEY`         | API Key。用于让 Gemini CLI 走 API key 认证路径                                                                                                                 |
| `GOOGLE_GEMINI_BASE_URL` | siflow Gemini-compatible endpoint base：`https://api.siflow.cn/model-api`。Gemini CLI 会自行追加 `/v1beta/models/<model>:generateContent`，因此这里不要包含 `/v1beta` |

`export` 只在当前 shell 中有效；如需持久化，请添加到 `~/.bashrc` / `~/.zshrc`。

## 验证

启动 Gemini CLI，并选择模型：

```bash theme={null}
gemini -m gemini-3.5-flash
```

发送一条 prompt；也可以用 `gemini -m gemini-3.5-flash -p "introduce this repo in one sentence"` 运行单次请求。如果返回正常回复，即表示连接成功。请求会发送到 `https://api.siflow.cn/model-api/v1beta/models/gemini-3.5-flash:streamGenerateContent`。

这里仅可使用 Gemini protocol 模型：`gemini-3.5-flash`、`gemini-3.1-pro-preview` 和 `gemini-3-flash-preview`。Gemini CLI 使用 Gemini API，因此无法访问 OpenAI-compatible models。