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

# Gemini CLI 接入 APIONE

> 使用 Gemini 兼容接口，在命令行中调用 APIONE 模型。

## 准备环境

安装 [Gemini CLI](https://geminicli.com/docs/get-started/installation/)，并在 [APIONE 控制台](https://apione.ai/zh/app/api-keys) 创建 API Key。选择支持 Gemini 协议的模型，复制其实际模型 ID。

## Windows 安装

在 PowerShell 中安装并检查版本。

```powershell theme={null}
npm install -g @google/gemini-cli
gemini --version
```

![PowerShell 安装 Gemini CLI 后显示 added 12 packages](https://mintcdn.com/apione/-Fh541-B7_4U7vxR/images/integrations/screenshots/gemini-cli-install-powershell.png?fit=max\&auto=format\&n=-Fh541-B7_4U7vxR\&q=85\&s=a8f855efad12dd0c20ca619ebeffe130)

Windows PowerShell 安装 Gemini CLI 的输出示例。

图中已显示 `added 12 packages`。安装后运行 `gemini --version`，确认命令可用，再继续配置。

## 配置认证和地址

在 `~/.gemini/.env` 中加入以下内容（路径中的 \~ 表示用户目录）：

```dotenv theme={null}
GEMINI_API_KEY=YOUR_APIONE_KEY
GEMINI_MODEL=YOUR_APIONE_MODEL_ID
GOOGLE_GEMINI_BASE_URL=https://api.apione.ai
GOOGLE_GENAI_API_VERSION=v1beta
```

将两个占位符替换为自己的密钥和模型 ID。这里填写站点根地址，由客户端拼接 API 版本和模型路径。

启动 `gemini`，选择 API Key 认证。若已有 settings.json，可在保留其他设置的基础上合并：

```json theme={null}
{"security":{"auth":{"selectedType":"gemini-api-key"}}}
```

## 验证请求

```bash theme={null}
gemini -p "Reply with OK only." --output-format json
```

收到回复后，再测试读取一个测试项目的文件。普通对话成功不代表工具调用已经验证，应分别检查。

## 常见问题

* 仍弹出 Google 登录：检查当前认证模式是否为 API Key。
* 404：确认最终路径没有重复的 /v1beta，并确认模型支持 Gemini 协议。
* 工具调用报错：检查模型能力和 CLI 版本，保留错误信息排查；不要直接套用其他服务商的本地补丁。
* 环境变量未生效：关闭旧进程，从加载配置的新终端启动。

配置字段以 [Gemini CLI 官方说明](https://geminicli.com/docs/reference/configuration/) 为准。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.