---
title: Gemini CLI
description: 使用 VC 的 Gemini 原生接口为 Gemini CLI 配置地址、密钥和模型。
---

选择支持 Gemini 原生协议的分组，并从[API 密钥](https://sub.vcnovb.cn/keys)的使用说明中获取 Gemini 配置。

## 安装

安装 Node.js 后执行：

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

## 配置并启动

将 `YOUR_MODEL_ID` 替换为当前 Key 可用的 Gemini 模型 ID，在同一终端启动客户端。

<CodeGroup>
```bash macOS / Linux
export GOOGLE_GEMINI_BASE_URL="https://sub.vcnovb.cn"
export GEMINI_API_KEY="YOUR_VC_API_KEY"
export GEMINI_MODEL="YOUR_MODEL_ID"
gemini -m "$GEMINI_MODEL"
```
```powershell Windows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="https://sub.vcnovb.cn"
$env:GEMINI_API_KEY="YOUR_VC_API_KEY"
$env:GEMINI_MODEL="YOUR_MODEL_ID"
gemini -m $env:GEMINI_MODEL
```
</CodeGroup>

如果出现认证方式选择，选择 **Use Gemini API Key**。使用 VC 时，密钥填写 VC API Key。密钥使用说明给出专用路径时，将上面的基础地址替换为说明中的地址。

## 开始使用

进入项目目录后启动，发送一句问候，再尝试读取 README。调用消耗可在 VC [用量记录](/guides/usage)中查看。

## 常见问题

- **返回 404**：不要将 OpenAI 风格的 `/v1` 地址用于 Gemini CLI，也不要在基础地址后追加完整的 `generateContent` 路径。
- **要求 Google 账户登录**：使用 `/auth` 切换到 API Key 认证，并确认进程能读取 `GEMINI_API_KEY`。
- **模型不存在**：使用当前分组模型目录中的完整 ID，重新执行带 `-m` 的启动命令。

更多客户端设置见 [Gemini CLI 官方认证说明](https://geminicli.com/docs/get-started/authentication/)。