Gemini CLI 配置教程

在 Gemini CLI 中配置 Crazyrouter API，并使用已经过真实请求验证的模型与认证方式

更新日期：2026-06-06

概述

Gemini CLI 是 Google 的命令行 AI 助手。通过配置 Crazyrouter 的 Gemini 原生入口，你可以在命令行中直接使用已经在本站生产环境完成真实请求验证的 Gemini 模型。

配置方法

环境变量

Gemini CLI 当前版本在 API Key 模式下，至少需要显式提供 GEMINI_API_KEY。如果你要接入 Crazyrouter 的 Gemini 原生入口，建议同时配置这 3 个环境变量：

Windows PowerShell:

$env:GEMINI_API_KEY="sk-xxx"
$env:GEMINI_MODEL="gemini-3.1-pro"
$env:GOOGLE_GEMINI_BASE_URL="https://api.crazyrouter.com"

如果你希望每次打开终端自动生效，可以写入 ~/.gemini/.env 或 PowerShell profile。

配置文件

编辑 ~/.gemini/settings.json：

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  },
  "apiKey": "sk-xxx",
  "baseUrl": "https://api.crazyrouter.com",
  "model": {
    "name": "gemini-3.1-pro"
  }
}

注意：

不要把认证方式保留为 oauth-personal，否则 CLI 会继续走 Google 登录。

不要把 model 写成字符串，当前版本应使用 model.name。

仅写 settings.json 在部分场景下还不够，命令行模式仍可能要求 GEMINI_API_KEY 环境变量。

`.gemini/.env` 示例

你也可以直接写入 ~/.gemini/.env：

启动

推荐模型

模型	说明
`gemini-3.1-pro`	2026 年 4 月 8 日已在 Crazyrouter 生产环境通过 Gemini CLI 真实请求实测成功，适合作为当前主基线

Note: Crazyrouter 同时支持 Gemini 原生 API 格式和 OpenAI 兼容格式。Gemini CLI 使用 Gemini 原生格式。本文档中的 gemini-3.1-pro、gemini-api-key 认证方式，以及 GOOGLE_GEMINI_BASE_URL=https://api.crazyrouter.com 已基于真实 CLI 请求验证通过。

最后校验/修改：2026-09-28（API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com，共 5 处；账号/控制台仍为 https://crazyrouter.com）

Gemini CLI 配置使用教程

Gemini CLI 配置教程#

概述#

配置方法#

环境变量#

配置文件#

.gemini/.env 示例#

启动#

推荐模型#