# Gemini CLI 設定ガイド

> ~/.gemini/.env を使って Gemini CLI を LLMoxy に接続し、`gemini-4-argon` を利用します。

Gemini CLI は Google のターミナル Agent です。設定は `~/.gemini/` に書き込むため、シェルの環境変数を変更する必要はありません。

始める前に [LLMoxy トークン](https://jp.llmoxy.com/docs/get-started/get-token) を 1 つ用意してください。**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://jp.llmoxy.com/docs/code-tutorials/gemini-cli の markdown 版です。
