# Gemini CLI 接入 OfoxAI 配置指南

Source: https://ofox.io/zh/docs/integrations/gemini-cli

[Gemini CLI](https://github.com/google-gemini/gemini-cli?utm=ofox_ai) 是 Google 推出的 Gemini 模型命令行工具。通过 OfoxAI，你可以使用 Gemini 协议的同时获得更丰富的模型选择。

> **使用 Ofox Desktop 更快完成配置。** 在 Apple 芯片 Mac 上，Desktop 可以检测此工具、备份现有配置，并应用 Ofox API Key 和兼容模型。[打开 Ofox Desktop](https://ofox.io/zh/desktop)。

## 配置步骤

### 1. 安装 Gemini CLI

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

![安装 Gemini CLI](https://ofox.io/screenshots/gemini-cli/01-install.png)

### 2. 配置 OfoxAI

Gemini CLI 使用 Gemini 原生协议。通过设置配置文件指向 OfoxAI：

```json filename="~/.gemini/settings.json"
{
  "apiKey": "<你的 OFOXAI_API_KEY>",
  "baseUrl": "https://api.ofox.io/gemini"
}
```

或使用环境变量：

```bash filename="~/.zshrc"
export GEMINI_API_KEY=<你的 OFOXAI_API_KEY>
```

Gemini CLI 的 base URL 配置方式可能随版本变化。如果上述方式不生效，请参考 Gemini CLI 最新文档。

### 3. 验证

```bash
gemini "你好，介绍一下自己"
```

![验证 Gemini CLI](https://ofox.io/screenshots/gemini-cli/03-verify.png)

## 可用模型

推荐模型请参考 [OfoxAI 模型广场](https://ofox.io/zh/models)。

## 使用场景

- **代码生成和审查** — Gemini 模型擅长代码理解
- **长文件分析** — 利用 1M token 上下文窗口
- **多模态任务** — 分析图片、PDF 等文件

通过 OfoxAI 使用 Gemini CLI，你还可以获得故障回退和路由优化的好处。详见[高级功能](https://ofox.io/zh/docs/develop/advanced/fallback)。