Agentsflare Gemini CLI 配置方案
Gemini CLI 是 Google 官方开源的终端 coding agent。
安装配置 Gemini CLI
安装 Gemini CLI
使用 npx 直接运行（无需安装）：
bash
npx @google/gemini-cli使用 npm 全局安装：
bash
npm install -g @google/gemini-cli使用 Homebrew 安装（macOS/Linux）：
bash
brew install gemini-cli其他安装方式参考官方文档 Gemini CLI 安装文档
配置 Gemini CLI
Gemini CLI 支持通过环境变量覆盖 API 地址，可经由 Google Generative AI 接口 接入 Agentsflare 网关。
在 shell 配置文件（~/.bashrc、~/.zshrc 等）中添加：
bash
export GEMINI_API_KEY="你的 Agentsflare API Key"
export GOOGLE_GEMINI_BASE_URL="https://api.agentsflare.com/google"
export GOOGLE_GENAI_API_VERSION="v1"Windows PowerShell：
powershell
$env:GEMINI_API_KEY="你的 Agentsflare API Key"
$env:GOOGLE_GEMINI_BASE_URL="https://api.agentsflare.com/google"
$env:GOOGLE_GENAI_API_VERSION="v1"配置说明：
| 环境变量 | 说明 |
|---|---|
GEMINI_API_KEY | Agentsflare 平台 API Key（在 Agentsflare 控制台获取） |
GOOGLE_GEMINI_BASE_URL | 覆盖默认的 Gemini API 地址，指向 Agentsflare Google 接口 |
GOOGLE_GENAI_API_VERSION | 强制使用 v1 API 版本，与 Agentsflare 端点路径 /google/v1/models/ 匹配 |
可选：指定默认模型（不设置则使用 CLI 内置默认模型）：
bash
export GEMINI_MODEL="gemini-3-flash-preview"重启终端（或 source 配置文件）使配置生效，然后运行：
bash
gemini常见问题
连接失败或请求仍发往 Google 官方服务器
确认 GOOGLE_GEMINI_BASE_URL 已设置且终端已重启。Gemini CLI 要求自定义 Base URL 必须使用 HTTPS（localhost 除外）。可用以下命令检查当前环境变量：
bash
echo $GOOGLE_GEMINI_BASE_URL404 Not Found 或路径错误
Agentsflare Google 接口路径为 /google/v1/models/，而 Gemini CLI 默认使用 v1beta API 版本，必须设置 GOOGLE_GENAI_API_VERSION="v1"，否则 CLI 会请求网关未提供的 v1beta 路径。
如何切换模型
通过启动参数或环境变量指定模型：
bash
gemini --model gemini-3.5-flash可用 Gemini 模型见 模型支持列表。