Gemini CLI（安装与接入 SuperToken）

Gemini CLI 是 Google 推出的终端 AI 工具，可以作为 CLI 助手阅读仓库、进行长上下文分析、通过脚本调用。

你需要准备

• 已安装 Node.js（推荐 22+ 版本）
• 一个 SuperToken 的 API Key（注册并创建）
• 已创建 Gemini 分组（详见 分组与计价）

TIP

Gemini CLI 的网关地址通常不带 /v1 后缀。

1. 安装 Gemini CLI

打开终端（按 Command + Space，输入 Terminal，回车），运行：

npm install -g @google/generative-ai-cli

验证安装：

gemini --version

如果提示找不到 gemini 命令，尝试替代包名：

npm install -g @google/gemini-cli

打开 PowerShell，运行：

npm install -g @google/generative-ai-cli

验证安装：

gemini --version

如果提示找不到 gemini 命令，尝试替代包名：

npm install -g @google/gemini-cli

打开终端，运行：

npm install -g @google/generative-ai-cli

验证安装：

gemini --version

如果提示找不到 gemini 命令，尝试替代包名：

npm install -g @google/gemini-cli

2. 配置 Gemini CLI（接入 SuperToken）

Gemini CLI 使用自己的配置目录，不需要编辑 Shell 配置文件。

创建配置目录

mkdir -p ~/.gemini

写入环境变量配置文件

创建 .env 文件（请替换 API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.supertoken.cc
GEMINI_API_KEY=你的SuperToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

可选：写入认证配置

cat > ~/.gemini/settings.json <<'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

配置目录位于 ~/.gemini/（即 /Users/你的用户名/.gemini/）。

创建配置目录

mkdir -Force "$env:USERPROFILE\.gemini"

写入环境变量配置文件

创建 .env 文件（请替换 API Key）：

@"
GOOGLE_GEMINI_BASE_URL=https://api.supertoken.cc
GEMINI_API_KEY=你的SuperToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

可选：写入认证配置

@"
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\settings.json"

配置目录位于 %USERPROFILE%\.gemini\（通常是 C:\Users\你的用户名\.gemini\）。

创建配置目录

mkdir -p ~/.gemini

写入环境变量配置文件

创建 .env 文件（请替换 API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.supertoken.cc
GEMINI_API_KEY=你的SuperToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

可选：写入认证配置

cat > ~/.gemini/settings.json <<'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

你必须将 你的SuperToken API Key 替换为从 SuperToken 控制台 复制的真实 Key。

配置项说明：

• GOOGLE_GEMINI_BASE_URL — SuperToken 网关地址
• GEMINI_API_KEY — 你的 API Key
• GEMINI_MODEL — 默认模型（gemini-3.1-flash-image-preview-1 为最新旗舰）

3. 启动并验证

gemini --version

发送一条测试消息：

gemini "你好"

收到回复只证明当前进程可用。关闭并重新打开终端，再启动 Gemini CLI；确认配置文件仍生效，并在 SuperToken 控制台核对同一时间和模型的请求记录。遇到认证、模型、地址或限流问题时查看 统一错误决策表。