Skip to content

Gemini CLI ​

Gemini CLI 是 Google 的命令行 AI 助手,使用 Gemini 接口。

准备 ​

  1. 安装 Gemini CLI:npm install -g @google/gemini-cli
  2. 在控制台创建一个分组为 gemini 的令牌。

配置 ​

设置两个环境变量:

bash
export GOOGLE_GEMINI_BASE_URL="https://api.codingrouter.ai"
export GEMINI_API_KEY="sk-你的令牌"
gemini
powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingrouter.ai"
$env:GEMINI_API_KEY = "sk-你的令牌"
gemini

首次启动选择认证方式时,选 Use Gemini API Key。

也可以直接写进配置文件 ~/.gemini/settings.json,跳过这一步:

json
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

非交互运行(gemini -p、脚本、CI)必须有这项配置,否则会报 Invalid auth method selected。

选择模型 ​

bash
gemini -m gemini-3.7-flash

验证 ​

bash
gemini -m gemini-3.5-flash -p "Reply with exactly: CODINGROUTER OK"

在没有信任过的目录里非交互运行时,Gemini CLI 会要求先信任目录,加 --skip-trust 或设置 GEMINI_CLI_TRUST_WORKSPACE=true。

常见问题 ​

现象处理
Invalid auth method selected按上文在 settings.json 里设置 selectedType
not running in a trusted directory交互模式下信任该目录,或非交互时加 --skip-trust
返回 403 或 503令牌分组不是 gemini,或模型名写错