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

# Gemini CLI

> 将 AIOHub 配置为 Gemini CLI 的模型服务商。

[Gemini CLI](https://github.com/google-gemini/gemini-cli) 是 Google 官方的 AI 编程工具。配置环境变量后，Gemini CLI 可以通过 AIOHub 调用模型。

## 前置条件

* 已安装 Gemini CLI（建议 Node.js 20+）
* 已 [创建 AIOHub API 令牌](/cn/account/create-token)
* 账户有充足余额
* API 令牌的分组包含 `gemini`

可以先检查本地版本：

```bash theme={"system"}
node -v
npm -v
gemini --version
```

## 配置方法

设置环境变量后启动 Gemini CLI：

```bash theme={"system"}
export GEMINI_API_KEY="sk-你的API令牌"
export GOOGLE_GEMINI_BASE_URL="https://api.aiohub.org"
gemini
```

### 写入 Shell 配置文件

<Tabs>
  <Tab title="macOS / Linux (zsh)">
    ```bash theme={"system"}
    echo 'export GEMINI_API_KEY="sk-你的API令牌"' >> ~/.zshrc
    echo 'export GOOGLE_GEMINI_BASE_URL="https://api.aiohub.org"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={"system"}
    [System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-你的API令牌", "User")
    [System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.aiohub.org", "User")
    ```
  </Tab>
</Tabs>

<Note>Gemini CLI 会在 Base URL 后拼接 API 版本路径。不要把 `GOOGLE_GEMINI_BASE_URL` 设置成带 `/v1beta` 的地址，否则可能请求到重复路径。</Note>

## 验证配置

```bash theme={"system"}
gemini
```

建议显式指定当前 API 令牌的分组可用的模型：

```bash theme={"system"}
gemini -m gemini-2.5-flash
```

正常回复即表示配置成功。

## 常见问题

<AccordionGroup>
  <Accordion title="Gemini CLI 卡住或停止响应">
    重新启动会话，并确认 API 令牌的分组包含 `gemini`。
  </Accordion>

  <Accordion title="400 错误">
    清空或重开会话后重试，确认模型名称存在于 `/v1beta/models` 返回结果中。
  </Accordion>

  <Accordion title="环境变量被项目配置覆盖">
    检查当前目录是否有 `.env` 或 Gemini CLI 配置文件覆盖了 API Key、模型或 Base URL。删除冲突配置后重新打开终端。
  </Accordion>
</AccordionGroup>