Gemini CLI 配置指南

Gemini CLI 是 Google 的终端 Agent。配置写在 ~/.gemini/，不用改 Shell 环境变量。

开始前准备一把 LLMoxy 令牌。建议用 auto 分组令牌。

安装

npm install -g @google/gemini-cli
gemini --version

接入 LLMoxy

创建配置目录并写入 .env：

# macOS / Linux
mkdir -p ~/.gemini
cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=你的LLMoxy API Key
GEMINI_MODEL=gpt-5.6-sol
EOF

# Windows PowerShell
mkdir -Force "$env:USERPROFILE\.gemini"
@"
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=你的LLMoxy API Key
GEMINI_MODEL=gpt-5.6-sol
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

可选，指定用 API Key 登录：

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

把上面内容保存为 ~/.gemini/settings.json（Windows 为 %USERPROFILE%\.gemini\settings.json）。

TIP Gemini CLI 的地址 不带 /v1。把 你的LLMoxy API Key 换成控制台里的真实令牌。

启动

gemini

常见问题

gemini: command not found 确认 node -v 正常，重开终端。包名是 @google/gemini-cli。

调用失败 检查 .env 没有多余空格、令牌分组是 auto、账户有余额。

Linux 连不上 curl -I https://llmoxy.com；需要代理时在 .env 加 HTTPS_PROXY=http://your-proxy:port。