# Настройка Gemini CLI

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (Gemini CLI v0.60.0 (2026-09-15; тарифы Pro/free не обслуживаются с 2026-06-18, корпоративные платные ключи продолжают))

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Gemini ✅ · Claude ❌ · GPT ❌ · китайские модели ❌ |
| Протокол и Base URL | Gemini: `https://api.qcode.cc/gemini` (CLI сам дописывает `/v1beta/...` — руками не добавлять) |
| Где настраивается | `~/.gemini/settings.json` либо переменные `GOOGLE_GEMINI_BASE_URL` + `GEMINI_API_KEY` |
| Официальная документация | [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |

> **⚠️ Важное изменение: путь для личных аккаунтов заменён на Google Antigravity CLI**. В официальном посте от 2026-05-19 дословно сказано, что с **2026-06-18** Gemini CLI и расширения Gemini Code Assist для IDE «will stop serving requests» — для **Google AI Pro и Ultra**, а также для тех, кто бесплатно пользуется им с личного аккаунта. Именно в тот день вышли **Antigravity CLI и Antigravity 2.0** (сама IDE Antigravity появилась раньше, 2025-11-18). Для компаний всё иначе: организации с лицензией Gemini Code Assist Standard или Enterprise продолжают работу, и в том же посте указано «Gemini CLI will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys». **Поэтому эта страница по-прежнему актуальна для корпоративных платных ключей**; пользователям Pro / Ultra / бесплатного тарифа стоит перейти на [Google Antigravity CLI](/docs/ide/antigravity).
>
> Репозиторий не заброшен: на день проверки (2026-09-18) там выходил nightly-билд, а последний стабильный релиз — v0.60.0 (2026-09-15). Корректная формулировка — «**прекращено обслуживание личных аккаунтов**», а не «сопровождение прекращено».

> **🚧 Ограниченная доступность**: Ресурсы Gemini сейчас доступны в ограниченном режиме и пока не предоставляются массово. Если у вас значительные потребности в использовании, свяжитесь с нами через [онлайн-чат](javascript:void(Tawk_API.toggle())) или по email **hi@qcode.cc** — мы организуем для вас выделенные ресурсы Gemini.

QCode.cc поддерживает Claude Code, OpenAI Codex и Google Gemini CLI. После покупки тарифного плана все три инструмента **используют общую квоту**, что позволяет гибко выбирать инструмент.

## Что такое Gemini CLI

[Gemini CLI](https://geminicli.com/) — это AI-ассистент для программирования от Google, работающий в командной строке. Аналогичен Claude Code и помогает писать код, отлаживать и работать с файлами прямо в терминале.

## Доступные модели

**Источником истины считайте живой запрос** — не копируйте фиксированный список из какого-либо
документа, включая этот:

```bash
curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: cr_ваш_ключ_QCode"
```

Возвращённые идентификаторы — это модели Gemini, которые можно вызывать; подставьте один из них
в `GEMINI_MODEL`. Полный каталог и актуальные цены — на [qcode.cc/models](https://qcode.cc/models).

## Обзор конфигурации

Для Gemini CLI необходимо настроить следующие переменные окружения:

- `GOOGLE_GEMINI_BASE_URL` — адрес сервиса

- `GEMINI_API_KEY` — API-ключ (тот же, что и для Claude Code)

- `GEMINI_MODEL` — выбор модели
Файл настроек — второй поддерживаемый путь: пользовательский `~/.gemini/settings.json` и проектный `.gemini/settings.json` (проект перекрывает пользователя). Модель задаётся в `model.name`, тип авторизации — в `security.auth.selectedType`; строковые значения могут ссылаться на переменные через `$VAR`, `${VAR}` или `${VAR:-значение по умолчанию}`. В документации сказано, что `GOOGLE_GEMINI_BASE_URL` относится к авторизации gemini-api-key, поэтому задавайте обе переменные, как показано ниже.


<div data-os="macos" markdown="1">

## Настройка macOS

### Шаг 1: Установка Node.js

Для работы Gemini CLI требуется среда Node.js.

#### Способ 1: Через Homebrew (рекомендуется)

Если Homebrew уже установлен, установка Node.js будет проще:

```bash
# Обновить Homebrew
brew update

# Установить Node.js
brew install node
```

#### Способ 2: Загрузка с официального сайта

1. Перейдите на [https://nodejs.org/](https://nodejs.org/)

2. Скачайте LTS-версию для macOS

3. Откройте загруженный файл `.pkg`

4. Следуйте инструкциям мастера установки

#### Примечания для macOS

- При проблемах с правами доступа может потребоваться `sudo`

- При первом запуске может потребоваться разрешение в системных настройках

- Рекомендуется использовать Terminal или iTerm2

#### Проверка установки Node.js

После установки откройте Terminal и выполните:

```bash
node --version
npm --version
```

Если отображаются номера версий — установка прошла успешно!

### Шаг 2: Установка Gemini CLI

Установите Gemini CLI глобально через npm:

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

Проверьте установку:

```bash
gemini --version
```

### Шаг 3: Настройка переменных окружения Gemini CLI

Установите переменные окружения для подключения к сервису:

#### Временная установка (текущая сессия)

Выполните в терминале:

```bash
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

> Замените `cr_xxxxxxxxxx` на ваш [API-ключ QCode.cc](https://qcode.cc/dashboard). Используйте тот же API-ключ, что и для Claude Code.

#### Постоянная установка (конфигурация оболочки)

Добавьте следующее в конфигурационный файл оболочки (`~/.zshrc`):

```bash
# Конфигурация Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

Затем выполните:

```bash
source ~/.zshrc
```

### Проверка переменных окружения Gemini CLI

Проверьте в терминале:

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="linux" markdown="1">

## Настройка Linux / WSL2

### Шаг 1: Установка Node.js

Для работы Gemini CLI требуется среда Node.js.

#### Способ 1: Через nvm (рекомендуется)

nvm позволяет удобно управлять несколькими версиями Node.js:

```bash
# Установить nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Перезагрузить конфигурацию оболочки
source ~/.bashrc

# Установить последнюю LTS-версию
nvm install --lts
```

#### Способ 2: Через пакетный менеджер

```bash
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm
```

#### Примечания для Linux / WSL2

- Пользователям WSL2 рекомендуется устанавливать в Linux-подсистеме, а не в Windows

- Использование nvm позволяет избежать проблем с правами доступа

- Убедитесь, что конфигурация оболочки корректно загружает nvm

#### Проверка установки Node.js

После установки откройте терминал и выполните:

```bash
node --version
npm --version
```

Если отображаются номера версий — установка прошла успешно!

### Шаг 2: Установка Gemini CLI

Установите Gemini CLI глобально через npm:

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

Проверьте установку:

```bash
gemini --version
```

### Шаг 3: Настройка переменных окружения Gemini CLI

Установите переменные окружения для подключения к сервису:

#### Временная установка (текущая сессия)

Выполните в терминале:

```bash
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

> Замените `cr_xxxxxxxxxx` на ваш [API-ключ QCode.cc](https://qcode.cc/dashboard). Используйте тот же API-ключ, что и для Claude Code.

#### Постоянная установка (конфигурация оболочки)

Добавьте следующее в конфигурационный файл оболочки (`~/.bashrc`):

```bash
# Конфигурация Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

Затем выполните:

```bash
source ~/.bashrc
```

Если вы используете Zsh, добавьте в `~/.zshrc` и выполните `source ~/.zshrc`.

### Проверка переменных окружения Gemini CLI

Проверьте в терминале:

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="windows" markdown="1">

## Настройка Windows

### Шаг 1: Установка Node.js

Для работы Gemini CLI требуется среда Node.js.

#### Способ 1: Загрузка с официального сайта (рекомендуется)

1. Откройте браузер и перейдите на [https://nodejs.org/](https://nodejs.org/)

2. Нажмите на версию "LTS" для загрузки (рекомендуется версия с долгосрочной поддержкой)

3. По завершении загрузки дважды кликните на файл `.msi`

4. Следуйте мастеру установки, оставив настройки по умолчанию

#### Способ 2: Через пакетный менеджер

Если у вас установлен Chocolatey или Scoop:

```powershell
# Через Chocolatey
choco install nodejs

# Или через Scoop
scoop install nodejs
```

#### Примечания для Windows

- Рекомендуется использовать PowerShell вместо CMD

- При проблемах с правами доступа попробуйте запустить от имени администратора

- Некоторые антивирусы могут давать ложные срабатывания — добавьте исключение

#### Проверка установки Node.js

После установки откройте PowerShell или CMD и выполните:

```powershell
node --version
npm --version
```

Если отображаются номера версий — установка прошла успешно!

### Шаг 2: Установка Gemini CLI

Установите Gemini CLI глобально через npm:

```powershell
npm install -g @google/gemini-cli
```

Проверьте установку:

```powershell
gemini --version
```

### Шаг 3: Настройка переменных окружения Gemini CLI

Установите переменные окружения для подключения к сервису:

#### Временная установка через PowerShell (текущая сессия)

Выполните в PowerShell:

```powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-2.5-pro"
```

> Замените `cr_xxxxxxxxxx` на ваш [API-ключ QCode.cc](https://qcode.cc/dashboard). Используйте тот же API-ключ, что и для Claude Code.

#### Постоянная установка через PowerShell (уровень пользователя)

Выполните в PowerShell:

```powershell
# Установка переменных окружения на уровне пользователя (постоянно)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.qcode.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)
```

> После установки необходимо перезапустить окно PowerShell для применения изменений.

### Проверка переменных окружения Gemini CLI

Проверьте в PowerShell:

```powershell
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL
```

</div>

## Часто задаваемые вопросы

### Устаревшая версия Node.js

**Проблема**: Gemini CLI сообщает о несовместимой версии Node.js

**Решение**:

1. Проверьте версию Node.js: `node --version`

2. Официальное требование — Node.js **20.0.0 или выше** (`engines.node >=20.0.0`; на 18 падает сразу после установки)

3. Обновите через nvm: `nvm install --lts && nvm use --lts`

### Переменные окружения не применяются

**Проблема**: после установки переменных окружения подключение не работает

**Решение**:

1. Убедитесь, что вы перезапустили терминал или выполнили команду `source`

2. Проверьте правильность имён переменных (учитывается регистр)

3. Проверьте формат API-ключа (должен начинаться с `cr_`)

### Проблемы с сетевым подключением

**Проблема**: не удаётся подключиться к сервису QCode.cc

**Решение**:

1. Проверьте сетевое соединение

2. Убедитесь, что `GOOGLE_GEMINI_BASE_URL` установлен правильно

3. Попробуйте резервные узлы:
   - Резерв в Азии: `https://asia.qcode.cc/gemini`

## Связанная документация

- [Antigravity CLI](/docs/ide/antigravity) — официальный преемник Gemini CLI
- [Настройка переменных окружения](/docs/getting-started/environment) — конфигурация Claude Code

- [Интеграция с Codex](/docs/ide/codex) — настройка OpenAI Codex CLI

- [Быстрый старт](/docs/getting-started/quick-start) — начало работы с Claude Code