Gemini CLI
Gemini CLI 是 Google 的命令行 AI 助手,使用 Gemini 接口。
准备
- 安装 Gemini CLI:
npm install -g @google/gemini-cli - 在控制台创建一个分组为
gemini的令牌。
配置
设置两个环境变量:
bash
export GOOGLE_GEMINI_BASE_URL="https://api.codingrouter.ai"
export GEMINI_API_KEY="sk-你的令牌"
geminipowershell
$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,或模型名写错 |
