# Руководство по настройке Gemini CLI

> Подключите Gemini CLI к LLMoxy через ~/.gemini/.env и используйте `gemini-4-argon`.

Gemini CLI — терминальный агент от Google. Конфигурация хранится в `~/.gemini/`, менять переменные окружения оболочки не нужно.

Прежде чем начать, подготовьте [токен LLMoxy](https://ru.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`.

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/gemini-cli.
