♊ Gemini CLI 接入指南

Gemini CLI 是 Google 官方提供的终端大语言模型调用工具。通过本指南，您可以将其接口指向 Old Dog AI，从而在终端直接调用 gemini-3.2-pro 等拥有超大上下文的顶级模型。

📥 第一步：前置条件与安装

在使用前，请确保您的系统已安装 Node.js（建议 v20 或更高版本）。

执行安装：在终端运行以下命令进行全局安装：
bash
```
npm install -g @google/gemini-cli
```
验证版本：安装完成后，运行以下命令验证是否成功：
bash
```
gemini --version
```
如需升级：如果您之前安装过，可以使用以下命令更新到最新版：
bash
```
npm upgrade -g @google/gemini-cli
```

如果您只是想临时测试连接，可以直接在当前窗口设置环境变量（请将 sk-xxxx 替换为您在控制台生成的 API Key）。

macOS / Linux:

bash

export GOOGLE_GEMINI_BASE_URL="[https://api.olddog.shop](https://api.olddog.shop)"
export GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"

Windows PowerShell:

powershell

$env:GOOGLE_GEMINI_BASE_URL="[https://api.olddog.shop](https://api.olddog.shop)"
$env:GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"

Windows CMD:

cmd

set GOOGLE_GEMINI_BASE_URL=[https://api.olddog.shop](https://api.olddog.shop)
set GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxx

⚠️ 注意：GOOGLE_GEMINI_BASE_URL 的值请务必填写 https://api.olddog.shop，末尾不要多加 / 。

创建配置文件：在您的用户主目录下创建 .gemini 文件夹（如果不存在），并在其中新建一个名为 .env 的文件。
- Windows 路径: C:\Users\您的用户名\.gemini\.env
- macOS / Linux 路径: ~/.gemini/.env
填入配置内容：使用文本编辑器打开该文件，粘贴以下内容（请将 sk-xxxx 替换为您的 Old Dog AI 密钥）：
toml
```
GOOGLE_GEMINI_BASE_URL="[https://api.olddog.shop](https://api.olddog.shop)"
GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"
```

💡 说明：Gemini CLI 会按顺序查找 .env 文件：当前目录 -> 用户主目录 .gemini/.env -> 用户主目录 .env 。找到第一个后就会停止，因此建议固定放在 .gemini 文件夹中。

为了确保您调用的是最新发布的 gemini-3.2-pro 或 gemini-2.5-pro，您可以通过环境变量预设默认模型。

方法 1 (推荐)：直接在上述 .env 文件中添加一行：

toml

GEMINI_MODEL="gemini-3.2-pro"

方法 2：在启动时通过参数临时指定：

bash

gemini --model gemini-3.2-pro

bash

gemini

提示 GEMINI_API_KEY 未设置：请确认 .env 文件路径是否准确，特别是 Windows 用户需确认文件名为 .env 而非 .env.txt 。