# Gemini CLI 設定指南

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

Gemini CLI 是 Google 的終端機 Agent。設定寫在 `~/.gemini/` 中，不需要修改 Shell 環境變數。

開始前請準備一把 [LLMoxy 權杖](https://tw.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://tw.llmoxy.com/docs/code-tutorials/gemini-cli 的 markdown 版本。
