Gemini CLI 設定指南

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

開始前請準備一把 LLMoxy 權杖。建議使用 auto 分組權杖。

安裝

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

接入 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=gemini-4-argon
EOF
BASH
# 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"
POWERSHELL

可選:指定以 API Key 登入:

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

將上述內容保存為 ~/.gemini/settings.json(Windows 為 %USERPROFILE%\.gemini\settings.json)。

TIP Gemini CLI 的位址 不帶 /v1。把 您的LLMoxy API Key 替換成控制檯中的真實權杖。

啟動

gemini
BASH

常見問題

gemini: command not found 確認 node -v 正常,然後重新開啟終端機。套件名稱是 @google/gemini-cli。

呼叫失敗 檢查 .env 沒有多餘空格、權杖分組是 auto、帳戶有餘額。

Linux 連不上 執行 curl -I https://llmoxy.com;需要代理時在 .env 加入 HTTPS_PROXY=http://your-proxy:port。