# Gemini CLI 配置指南

> 用 ~/.gemini/.env 把 Gemini CLI 接到 LLMoxy，使用 `gemini-4-argon`。

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

开始前准备一把 [LLMoxy 令牌](https://llmoxy.com/docs/get-started/get-token)。建议用 **auto** 分组令牌。

## 安装

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

## 接入 LLMoxy

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

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

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

可选，指定用 API Key 登录：

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

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

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

## 启动

```bash
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`。

本文是 https://llmoxy.com/docs/code-tutorials/gemini-cli 的 markdown 版本。
